backend/source/repositories/user.ts

/*
This file is part of »zeitbild«.

Copyright 2025 'kcf' <fenris@folksprak.org>

»zeitbild« is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

»zeitbild« is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with »zeitbild«. If not, see <http://www.gnu.org/licenses/>.
 */


namespace _zeitbild.repository.user
{
	
	/**
	 */
	type type_row = {
		name : string;
		email_address : (null | string);
		dav_token : (null | string);
	};
	
	
	/**
	 */
	type type_preview = {
		name : string;
	};
	
	
	/**
	 */
	var _store : (
		null
		|
		lib_plankton.storage.type_store<
			_zeitbild.type_user_id,
			/*type_row*/Record<string, any>,
			{},
			lib_plankton.storage.type_sql_table_autokey_search_term,
			/*type_preview*/Record<string, any>
		>
	) = null;
	
	
	/**
	 */
	function get_store(
	)
	: lib_plankton.storage.type_store<
		_zeitbild.type_user_id,
		/*type_row*/Record<string, any>,
		{},
		lib_plankton.storage.type_sql_table_autokey_search_term,
		/*type_preview*/Record<string, any>
	>
	{
		if (_store === null)
		{
			_store = lib_plankton.storage.sql_table_autokey_store(
				{
					"database_implementation": _zeitbild.database.get_implementation(),
					"table_name": "users",
					"key_name": "id",
				}
			);
		}
		else
		{
			// do nothing
		}	
		return _store;
	}
	
	
	/**
	 */
	function encode(
		user_object : _zeitbild.type_user_object
	)
	: type_row
	{
		return {
			"name": user_object.name,
			"email_address": user_object.email_address,
			"dav_token": user_object.dav_token,
		};
	}
	
	
	/**
	 */
	function decode(
		row : type_row
	)
	: _zeitbild.type_user_object
	{
		return {
			"name": row.name,
			"email_address": row.email_address,
			"dav_token": row.dav_token,
		};
	}
	
	
	/**
	 */
	export async function list(
	)
	: Promise<
		Array<
			{
				id : _zeitbild.type_user_id;
				name : string;
			}
		>
	>
	{
		const hits : Array<{key : int; preview : /*type_preview*/Record<string, any>;}> = await get_store().search({"expression": "TRUE", "arguments": {}});
		return Promise.resolve(
			hits
			.map(
				(hit) => ({
					"id": hit.key,
					"name": hit.preview.name,
				})
			)
		);
	}
	
	
	/**
	 */
	export async function read(
		user_id : _zeitbild.type_user_id
	)
	: Promise<_zeitbild.type_user_object>
	{
		const row : type_row = ((await get_store().read(user_id)) as type_row);
		const user_object : _zeitbild.type_user_object = decode(row);
		return Promise.resolve<_zeitbild.type_user_object>(user_object);
	}
	
	
	/**
	 */
	export async function create(
		user_object : _zeitbild.type_user_object
	)
	: Promise<_zeitbild.type_user_id>
	{
		const row : type_row = encode(user_object);
		const user_id : _zeitbild.type_user_id = await get_store().create(row);
		return Promise.resolve<_zeitbild.type_user_id>(user_id);
	}
	
	
	/**
	 */
	export async function update(
		user_id : _zeitbild.type_user_id,
		user_object : _zeitbild.type_user_object
	)
	: Promise<void>
	{
		const row : type_row = encode(user_object);
		await get_store().update(user_id, row);
		return Promise.resolve<void>(undefined);
	}
	
	
	/**
	 */
	export async function identify(
		name : string
	)
	: Promise<_zeitbild.type_user_id>
	{
		const hits : Array<{key : _zeitbild.type_user_id; preview : /*type_preview*/Record<string, any>;}> = await get_store().search(
			{
				"expression": "(name = $name)",
				"arguments": {
					"name": name,
				}
			}
		);
		if (hits.length <= 0)
		{
			return Promise.reject<_zeitbild.type_user_id>(new Error("not found"));
		}
		else
		{
			return Promise.resolve<_zeitbild.type_user_id>(hits[0].key);
		}
	}
	
}