Feat/notifications alerts (#52)

* feat: notifications backend & creation

* feat: assign notification to backup schedule

* refactor: status dot one component

* chore(notification-details): remove refetchInterval

app/server/modules/notifications/builders/custom.ts

@@ -0,0 +1,5 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildCustomShoutrrrUrl(config: Extract<NotificationConfig, { type: "custom" }>): string {
+	return config.shoutrrrUrl;
+}

app/server/modules/notifications/builders/discord.ts

@@ -0,0 +1,28 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildDiscordShoutrrrUrl(config: Extract<NotificationConfig, { type: "discord" }>): string {
+	const url = new URL(config.webhookUrl);
+	const pathParts = url.pathname.split("/").filter(Boolean);
+
+	if (pathParts.length < 4 || pathParts[0] !== "api" || pathParts[1] !== "webhooks") {
+		throw new Error("Invalid Discord webhook URL format");
+	}
+
+	const [, , webhookId, webhookToken] = pathParts;
+
+	let shoutrrrUrl = `discord://${webhookToken}@${webhookId}`;
+
+	const params = new URLSearchParams();
+	if (config.username) {
+		params.append("username", config.username);
+	}
+	if (config.avatarUrl) {
+		params.append("avatar_url", config.avatarUrl);
+	}
+
+	if (params.toString()) {
+		shoutrrrUrl += `?${params.toString()}`;
+	}
+
+	return shoutrrrUrl;
+}

app/server/modules/notifications/builders/email.ts

@@ -0,0 +1,10 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildEmailShoutrrrUrl(config: Extract<NotificationConfig, { type: "email" }>): string {
+	const protocol = config.useTLS ? "smtps" : "smtp";
+	const auth = `${encodeURIComponent(config.username)}:${encodeURIComponent(config.password)}`;
+	const host = `${config.smtpHost}:${config.smtpPort}`;
+	const toRecipients = config.to.map((email) => encodeURIComponent(email)).join(",");
+
+	return `${protocol}://${auth}@${host}/?from=${encodeURIComponent(config.from)}&to=${toRecipients}`;
+}

app/server/modules/notifications/builders/gotify.ts

@@ -0,0 +1,15 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildGotifyShoutrrrUrl(config: Extract<NotificationConfig, { type: "gotify" }>): string {
+	const url = new URL(config.serverUrl);
+	const hostname = url.hostname;
+	const port = url.port ? `:${url.port}` : "";
+
+	let shoutrrrUrl = `gotify://${hostname}${port}/${config.token}`;
+
+	if (config.priority !== undefined) {
+		shoutrrrUrl += `?priority=${config.priority}`;
+	}
+
+	return shoutrrrUrl;
+}

app/server/modules/notifications/builders/index.ts

@@ -0,0 +1,29 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+import { buildEmailShoutrrrUrl } from "./email";
+import { buildSlackShoutrrrUrl } from "./slack";
+import { buildDiscordShoutrrrUrl } from "./discord";
+import { buildGotifyShoutrrrUrl } from "./gotify";
+import { buildNtfyShoutrrrUrl } from "./ntfy";
+import { buildCustomShoutrrrUrl } from "./custom";
+
+export function buildShoutrrrUrl(config: NotificationConfig): string {
+	switch (config.type) {
+		case "email":
+			return buildEmailShoutrrrUrl(config);
+		case "slack":
+			return buildSlackShoutrrrUrl(config);
+		case "discord":
+			return buildDiscordShoutrrrUrl(config);
+		case "gotify":
+			return buildGotifyShoutrrrUrl(config);
+		case "ntfy":
+			return buildNtfyShoutrrrUrl(config);
+		case "custom":
+			return buildCustomShoutrrrUrl(config);
+		default: {
+			// TypeScript exhaustiveness check
+			const _exhaustive: never = config;
+			throw new Error(`Unsupported notification type: ${(_exhaustive as NotificationConfig).type}`);
+		}
+	}
+}

app/server/modules/notifications/builders/ntfy.ts

@@ -0,0 +1,28 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildNtfyShoutrrrUrl(config: Extract<NotificationConfig, { type: "ntfy" }>): string {
+	let shoutrrrUrl: string;
+
+	if (config.serverUrl) {
+		const url = new URL(config.serverUrl);
+		const hostname = url.hostname;
+		const port = url.port ? `:${url.port}` : "";
+		shoutrrrUrl = `ntfy://${hostname}${port}/${config.topic}`;
+	} else {
+		shoutrrrUrl = `ntfy://ntfy.sh/${config.topic}`;
+	}
+
+	const params = new URLSearchParams();
+	if (config.token) {
+		params.append("token", config.token);
+	}
+	if (config.priority) {
+		params.append("priority", config.priority);
+	}
+
+	if (params.toString()) {
+		shoutrrrUrl += `?${params.toString()}`;
+	}
+
+	return shoutrrrUrl;
+}

app/server/modules/notifications/builders/slack.ts

@@ -0,0 +1,31 @@
+import type { NotificationConfig } from "~/schemas/notifications";
+
+export function buildSlackShoutrrrUrl(config: Extract<NotificationConfig, { type: "slack" }>): string {
+	const url = new URL(config.webhookUrl);
+	const pathParts = url.pathname.split("/").filter(Boolean);
+
+	if (pathParts.length < 4 || pathParts[0] !== "services") {
+		throw new Error("Invalid Slack webhook URL format");
+	}
+
+	const [, tokenA, tokenB, tokenC] = pathParts;
+
+	let shoutrrrUrl = `slack://hook:${tokenA}-${tokenB}-${tokenC}@webhook`;
+
+	const params = new URLSearchParams();
+	if (config.channel) {
+		params.append("channel", config.channel);
+	}
+	if (config.username) {
+		params.append("username", config.username);
+	}
+	if (config.iconEmoji) {
+		params.append("icon", config.iconEmoji);
+	}
+
+	if (params.toString()) {
+		shoutrrrUrl += `?${params.toString()}`;
+	}
+
+	return shoutrrrUrl;
+}