backend/source/api/actions/member_summon.ts

/*
Espe | Ein schlichtes Werkzeug zur Mitglieder-Verwaltung | Backend
Copyright (C) 2024 Christian Fraß

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

This program 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 General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see 
<https://www.gnu.org/licenses/>. 
 */

namespace _espe.api
{
	
	/**
	 */
	export function register_member_summon(
		rest_subject : lib_plankton.rest.type_rest
	) : void
	{
		lib_plankton.rest.register<
			{
				url_template : string;
			},
			(
				null
				|
				string
			)
		>(
			rest_subject,
			lib_plankton.http.enum_method.post,
			_espe.conf.get().server.path_base + "/member/summon/:id",
			{
				"description": "sendet an ein Mitglied eine E-Mail mit Aufforderung zur Registrierung",
				"restriction": restriction_logged_in,
				"execution": async ({"path_parameters": path_parameters, "input": input}) => {
					if (input === null) {
						return Promise.reject(new Error("impossible"));
					}
					else {
						const member_id : _espe.type.member_id = parseInt(path_parameters["id"]);
						const url : (null | string) = await _espe.service.member.summon(member_id, input.url_template);
						
						return (
							(url === null)
							? Promise.resolve({
								"status_code": 409,
								"data": null,
							})
							: Promise.resolve({
								"status_code": 200,
								"data": url,
							})
						);
					}
				}
			}
		);
	}
	
}