backend/source/api/base.ts
Fenris Wolf 9d1fd0b55f [int]
2024-10-30 07:20:13 +01:00

87 lines
2.3 KiB
TypeScript

namespace _zeitbild.api
{
/**
* @todo zu plankton auslagern?
*/
type type_stuff = {
version: (null | string);
headers: Record<string, string>;
path_parameters: Record<string, string>;
query_parameters: Record<string, string>;
};
/**
*/
export async function session_from_stuff(
stuff : {headers : Record<string, string>;}
) : Promise<{key : string; value : lib_plankton.session.type_session}>
{
const key : string = (stuff.headers["X-Session-Key"] || stuff.headers["X-Session-Key".toLowerCase()]);
const value : lib_plankton.session.type_session = await lib_plankton.session.get(key);
return {"key": key, "value": value};
}
/**
*/
export const restriction_logged_in : lib_plankton.rest_caldav.type_restriction<any> = (
(stuff) => (
session_from_stuff(stuff)
.then(() => Promise.resolve<boolean>(true))
.catch(() => Promise.resolve<boolean>(false))
)
);
/**
*/
export const restriction_none : lib_plankton.rest_caldav.type_restriction<any> = (
(stuff) => Promise.resolve<boolean>(true)
);
/**
*/
export function register<type_input, type_output>(
rest_subject : lib_plankton.rest_caldav.type_rest,
http_method : lib_plankton.caldav.enum_method,
path : string,
options : {
active ?: ((version : string) => boolean);
restriction ?: (null | lib_plankton.rest_caldav.type_restriction<type_input>);
execution ?: lib_plankton.rest_caldav.type_execution<type_input, type_output>;
title ?: (null | string);
description ?: (null | string);
query_parameters ?: ((version : (null | string)) => Array<
{
name : string;
description : (null | string);
required : boolean;
}
>);
input_schema ?: ((version: (null | string)) => lib_plankton.rest_caldav.type_oas_schema);
output_schema ?: ((version: (null | string)) => lib_plankton.rest_caldav.type_oas_schema);
request_body_mimetype ?: string;
request_body_decode ?: ((http_request_body : Buffer, http_request_header_content_type : (null | string)) => any);
response_body_mimetype ?: string;
response_body_encode ?: ((output : any) => Buffer);
} = {}
) : void
{
options = Object.assign(
{
},
options
);
lib_plankton.rest_caldav.register<type_input, type_output>(
rest_subject,
http_method,
(_zeitbild.conf.get().server.path_base + path),
options
);
}
}