backend/source/api/actions/user_dav_token.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.api
{
	
	/**
	 */
	export function register_user_dav_token(
		rest_subject : lib_plankton.rest_http.type_rest
	) : void
	{
		register<
			// string,
			null,
			null
		>(
			rest_subject,
			lib_plankton.http.enum_method.patch,
			"/user_dav_token",
			{
				"description": "setzt/überschreibt den DAV-Token eines Nutzers",
				/*
				"input_schema": () => ({
					"nullable": false,
					"type": "string"
				}),
				 */
				"input_schema": () => ({
					"nullable": true,
				}),
				"output_schema": () => ({
					"nullable": true
				}),
				"restriction": restriction_logged_in,
				"execution": async (stuff) => {
					const session : {key : string; value : lib_plankton.session.type_session;} = await session_from_stuff(stuff);
					const user_id : _zeitbild.type_user_id = await _zeitbild.service.user.identify(session.value.name);
					// TODO: outsource to user service?
					const user_object : _zeitbild.type_user_object = await _zeitbild.service.user.get(user_id);
					// user_object.dav_token = stuff.input;
					user_object.dav_token = lib_plankton.random.generate_string({"length": 12});
					await _zeitbild.service.user.change(user_id, user_object);
					return Promise.resolve(
						{
							"status_code": 200,
							"data": null,
						}
					);
				}
			}
		);
	}
	
}