munin/source/targets/email.ts

/*
This file is part of »munin«.

Copyright 2025 'Fenris Wolf' <fenris@folksprak.org>

»munin« 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.

»munin« 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 »munin«. If not, see <http://www.gnu.org/licenses/>.
 */


namespace _munin.targets.email
{
	
	/**
	 */
	export type type_parameters = {
		smtp_host : string;
		smtp_port : int;
		smtp_username : string;
		smtp_password : string;
		sender : string;
		receivers : Array<string>;
		hide_tags : boolean;
		reminders : Array<_munin.type_reminder>;
	};
	
	
	/**
	 */
	async function send(
		parameters : type_parameters,
		labels : _munin.type_labels,
		event : _munin.type_event
	) : Promise<void>
	{
		await lib_plankton.email.send(
			{
				"host": parameters.smtp_host,
				"port": parameters.smtp_port,
				"username": parameters.smtp_username,
				"password": parameters.smtp_password,
			},
			parameters.sender,
			parameters.receivers,
			lib_plankton.string.coin(
				"[{{head}}] {{date}} : {{macro_tags}}{{title}}",
				{
					"head": labels.head,
					"date": lib_plankton.pit.date_format(
						event.begin.date
					),
					"macro_tags": (
						(event.tags === null)
						?
						""
						:
						(event.tags.map(tag => ("{" + tag + "}")).join(" ") + " ")
					),
					"title": event.title,
				}
			),
			lib_plankton.string.coin(
				"{{title_label}} | {{macro_tags}}{{title_value}}\n{{time_label}} | {{time_value}}{{macro_location}}{{macro_description}}",
				{
					"title_label": labels.title.toUpperCase(),
					"macro_tags": (
						(parameters.hide_tags || (event.tags === null))
						?
						""
						:
						(event.tags.map(tag => ("{" + tag + "}")).join(" ") + " ")
					),
					"title_value": event.title,
					"time_label": labels.time.toUpperCase(),
					"time_value": lib_plankton.pit.timespan_format(
						event.begin,
						event.end,
						{
							"adjust_to_ce": true,
						}
					),
					"macro_location": (
						(event.location === null)
						?
						""
						:
						lib_plankton.string.coin(
							"\n{{location_label}} | {{location_value}}",
							{
								"location_label": labels.location.toUpperCase(),
								"location_value": event.location,
							}
						)
					),
					"macro_description": (
						(event.description === null)
						?
						""
						:
						lib_plankton.string.coin(
							"\n\n{{description_value}}",
							{
								"description_value": event.description,
							}
						)
					),
				}
			)
		);
	}
	
	
	/**
	 */
	export function implementation_target(
		parameters : type_parameters
	) : _munin.type_target
	{
		return {
			"reminders": parameters.reminders,
			"show": () => lib_plankton.string.coin(
				"email:{{receivers}}",
				{
					"receivers": parameters.receivers.join(","),
				}
			),
			"send": (labels, event) => send(parameters, labels, event),
		};
	}
	
}