@voltro/plugin-notifications 0.85.0 → 0.86.0

package/dist/sendNotification.js

@@ -0,0 +1,42 @@
+import { Schema as e } from "effect";
+//#region src/sendNotification.ts
+var t = (e) => {
+	if (typeof e == "object" && e) {
+		let t = e;
+		if (typeof t.userId == "string") return [t.userId];
+		if (Array.isArray(t.userIds)) return t.userIds.filter((e) => typeof e == "string");
+	}
+	throw Error("sendNotification: pass `recipients` — the audience has neither `userId` nor `userIds`");
+}, n = async (n, i, a) => {
+	let o = e.decodeUnknownSync(i.audience)(a.audience), s = e.decodeUnknownSync(i.payload)(a.payload), c = a.recipients ? await a.recipients(o) : t(o), l = [];
+	for (let e of c) {
+		let t = (a.localeFor ? await a.localeFor(e) : null) ?? a.defaultLocale ?? "en", o = await n.send(r(i, s, e, t, a.tenantId));
+		l.push({
+			recipientId: e,
+			locale: t,
+			result: o
+		});
+	}
+	return l;
+}, r = (e, t, n, r, i) => {
+	let a = e.render(t, {
+		locale: r,
+		recipientId: n
+	});
+	return {
+		to: n,
+		category: e.category,
+		title: a.title,
+		body: a.body,
+		data: {
+			...a.data,
+			notification: e.name,
+			...a.image === void 0 ? {} : { image: a.image },
+			...a.actions === void 0 ? {} : { actions: a.actions }
+		},
+		...e.channels === void 0 ? {} : { channels: e.channels },
+		...i === void 0 ? {} : { tenantId: i }
+	};
+};
+//#endregion
+export { t as defaultRecipients, r as sendInputFor, n as sendNotification };

package/dist/service.js

@@ -0,0 +1,212 @@
+import { resolveChannels as e } from "./channels.js";
+import { randomUUID as t } from "node:crypto";
+//#region src/service.ts
+var n = (e) => ({
+	id: "inApp",
+	deliver: async (n) => {
+		await e.addInbox({
+			id: t(),
+			subjectId: n.to,
+			category: n.category,
+			title: n.title,
+			body: n.body,
+			data: n.data ?? {},
+			tenantId: n.tenantId ?? null,
+			createdAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	}
+}), r = (e, t) => {
+	try {
+		let n = new Intl.DateTimeFormat("en-US", {
+			timeZone: t,
+			hour: "2-digit",
+			minute: "2-digit",
+			hour12: !1
+		}).formatToParts(e), r = Number(n.find((e) => e.type === "hour")?.value ?? "0") % 24, i = Number(n.find((e) => e.type === "minute")?.value ?? "0");
+		return r * 60 + i;
+	} catch {
+		return e.getUTCHours() * 60 + e.getUTCMinutes();
+	}
+}, i = (e, t) => {
+	if (e.startMinute === e.endMinute) return !1;
+	let n = r(t, e.tz ?? "UTC");
+	return e.startMinute < e.endMinute ? n >= e.startMinute && n < e.endMinute : n >= e.startMinute || n < e.endMinute;
+}, a = (e, t) => {
+	let n = r(t, e.tz ?? "UTC"), i = e.endMinute - n;
+	return i <= 0 && (i += 1440), new Date(t.getTime() + i * 6e4);
+}, o = (n) => {
+	let r = new Map(n.channels.map((e) => [e.id, e])), o = n.channels.map((e) => e.id), c = n.now ?? (() => (/* @__PURE__ */ new Date()).toISOString()), l = n.digestWindowMs ?? 0, u = async (i) => {
+		let a = await n.store.getPreferences(i.to), s = e(o, i.category, i.channels, a, i.to), l = o.filter((e) => !s.includes(e)), u = [], d = [], f = {
+			to: i.to,
+			category: i.category,
+			title: i.title,
+			body: i.body,
+			...i.data ? { data: i.data } : {},
+			tenantId: i.tenantId ?? null
+		};
+		for (let e of s) {
+			let a = r.get(e);
+			if (!a) continue;
+			if (a.deliverDetailed !== void 0) {
+				try {
+					let r = await a.deliverDetailed(f);
+					for (let a of r) await n.store.recordDelivery({
+						id: t(),
+						to: i.to,
+						category: i.category,
+						channel: e,
+						at: c(),
+						status: a.status,
+						endpoint: a.endpoint,
+						...a.error === void 0 ? {} : { error: a.error },
+						...a.clickToken === void 0 ? {} : { clickToken: a.clickToken }
+					});
+					let o = r.filter((e) => e.status === "failed");
+					r.length === 0 || o.length < r.length ? u.push(e) : d.push({
+						channel: e,
+						error: o[0]?.error ?? "all endpoints failed"
+					});
+				} catch (r) {
+					let a = r instanceof Error ? r.message : String(r);
+					d.push({
+						channel: e,
+						error: a
+					}), await n.store.recordDelivery({
+						id: t(),
+						to: i.to,
+						category: i.category,
+						channel: e,
+						at: c(),
+						status: "failed",
+						error: a
+					});
+				}
+				continue;
+			}
+			let o = {
+				id: t(),
+				to: i.to,
+				category: i.category,
+				channel: e,
+				at: c()
+			};
+			try {
+				await a.deliver(f), u.push(e), await n.store.recordDelivery({
+					...o,
+					status: "sent"
+				});
+			} catch (t) {
+				let r = t instanceof Error ? t.message : String(t);
+				d.push({
+					channel: e,
+					error: r
+				}), await n.store.recordDelivery({
+					...o,
+					status: "failed",
+					error: r
+				});
+			}
+		}
+		return {
+			delivered: u,
+			failed: d,
+			skipped: l
+		};
+	}, d = async (e) => {
+		let r = await n.store.getQuietHours(e.to), o = new Date(c());
+		if (r && i(r, o)) return (r.policy ?? "hold") === "drop" ? {
+			delivered: [],
+			failed: [],
+			skipped: [],
+			held: "quiet-drop"
+		} : (await n.store.enqueueHeld({
+			id: t(),
+			kind: "quiet",
+			subjectId: e.to,
+			send: e,
+			flushAt: a(r, o).toISOString()
+		}), {
+			delivered: [],
+			failed: [],
+			skipped: [],
+			held: "quiet-held"
+		});
+		if (l > 0 && !e.channels) {
+			let r = (await n.store.pendingDigest(e.to))[0]?.flushAt ?? new Date(o.getTime() + l).toISOString();
+			return await n.store.enqueueHeld({
+				id: t(),
+				kind: "digest",
+				subjectId: e.to,
+				send: e,
+				flushAt: r
+			}), {
+				delivered: [],
+				failed: [],
+				skipped: [],
+				held: "digest"
+			};
+		}
+		return u(e);
+	};
+	return {
+		send: d,
+		inbox: (e, t) => n.store.listInbox(e, t),
+		unreadCount: (e) => n.store.unreadCount(e),
+		markRead: (e, t) => n.store.markRead(e, t),
+		markUnread: (e, t) => n.store.markUnread(e, t),
+		markAllRead: (e) => n.store.markAllRead(e),
+		setArchived: (e, t, r) => n.store.setArchived(e, t, r),
+		getPreferences: (e) => n.store.getPreferences(e),
+		setPreference: (e) => n.store.setPreference(e),
+		subscribe: (e, t, r) => n.store.subscribeTopic({
+			topic: e,
+			subjectId: t,
+			tenantId: r ?? null
+		}),
+		unsubscribe: (e, t) => n.store.unsubscribeTopic(e, t),
+		broadcast: async (e, t) => {
+			let r = await n.store.listTopicSubscribers(e), i = [];
+			for (let e of r) i.push(await d({
+				...t,
+				to: e.subjectId,
+				tenantId: t.tenantId ?? e.tenantId ?? null
+			}));
+			return {
+				recipients: r.length,
+				results: i
+			};
+		},
+		setQuietHours: (e) => n.store.setQuietHours(e),
+		clearQuietHours: (e) => n.store.clearQuietHours(e),
+		getQuietHours: (e) => n.store.getQuietHours(e),
+		flushDue: async (e = new Date(c())) => {
+			let t = await n.store.dueHeld(e.toISOString());
+			if (t.length === 0) return 0;
+			for (let e of t.filter((e) => e.kind === "quiet")) await u(e.send);
+			let r = /* @__PURE__ */ new Map();
+			for (let e of t.filter((e) => e.kind === "digest")) {
+				let t = r.get(e.subjectId) ?? [];
+				t.push(e), r.set(e.subjectId, t);
+			}
+			for (let [e, t] of r) await u(s(e, t));
+			return await n.store.clearHeld(t.map((e) => e.id)), t.length;
+		}
+	};
+}, s = (e, t) => {
+	if (t.length === 1) return t[0].send;
+	let n = t.map((e) => ({
+		category: e.send.category,
+		title: e.send.title,
+		body: e.send.body
+	}));
+	return {
+		to: e,
+		category: "digest",
+		title: `${t.length} new notifications`,
+		body: n.map((e) => `• ${e.title}`).join("\n"),
+		data: { items: n },
+		tenantId: t[0].send.tenantId ?? null
+	};
+};
+//#endregion
+export { o as buildNotificationService, n as inAppChannel, i as inQuietHours, r as minuteOfDayInZone, a as quietHoursEnd };

package/dist/store.js

@@ -0,0 +1,303 @@
+import { and as e, eq as t, generateId as n, isNull as r, lte as i } from "@voltro/database";
+//#region src/store.ts
+var a = () => {
+	let e = [], t = /* @__PURE__ */ new Map(), n = [], r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = [], o = (e) => `${e.subjectId}|${e.category}|${e.channel}`, s = (e, t) => `${e}|${t}`;
+	return {
+		addInbox: async (t) => {
+			e.unshift({
+				...t,
+				readAt: null,
+				archivedAt: null,
+				data: t.data ?? {},
+				tenantId: t.tenantId ?? null
+			});
+		},
+		listInbox: async (t, n) => {
+			let r = e.filter((e) => e.subjectId === t);
+			return n?.unreadOnly && (r = r.filter((e) => e.readAt === null)), n?.limit === void 0 ? r : r.slice(0, n.limit);
+		},
+		markRead: async (t, n) => {
+			let r = e.findIndex((e) => e.id === t && e.subjectId === n);
+			return r !== -1 && (e[r] = {
+				...e[r],
+				readAt: (/* @__PURE__ */ new Date(0)).toISOString()
+			}, !0);
+		},
+		markUnread: async (t, n) => {
+			let r = e.findIndex((e) => e.id === t && e.subjectId === n);
+			return r !== -1 && (e[r] = {
+				...e[r],
+				readAt: null
+			}, !0);
+		},
+		markAllRead: async (t) => {
+			let n = 0;
+			for (let r = 0; r < e.length; r++) {
+				let i = e[r];
+				i.subjectId === t && i.readAt === null && (e[r] = {
+					...i,
+					readAt: (/* @__PURE__ */ new Date(0)).toISOString()
+				}, n++);
+			}
+			return n;
+		},
+		setArchived: async (t, n, r) => {
+			let i = e.findIndex((e) => e.id === t && e.subjectId === n);
+			return i !== -1 && (e[i] = {
+				...e[i],
+				archivedAt: r ? (/* @__PURE__ */ new Date(0)).toISOString() : null
+			}, !0);
+		},
+		unreadCount: async (t) => e.filter((e) => e.subjectId === t && e.readAt === null).length,
+		getPreferences: async (e) => [...t.values()].filter((t) => t.subjectId === e),
+		setPreference: async (e) => {
+			t.set(o(e), e);
+		},
+		recordDelivery: async (e) => {
+			n.unshift(e);
+		},
+		listDeliveries: async (e) => e?.limit === void 0 ? [...n] : n.slice(0, e.limit),
+		markClicked: async (e) => {
+			let t = n.findIndex((t) => t.clickToken === e);
+			return t !== -1 && (n[t] = {
+				...n[t],
+				clickedAt: (/* @__PURE__ */ new Date()).toISOString()
+			}, !0);
+		},
+		subscribeTopic: async (e) => {
+			r.set(s(e.topic, e.subjectId), e);
+		},
+		unsubscribeTopic: async (e, t) => {
+			r.delete(s(e, t));
+		},
+		listTopicSubscribers: async (e) => [...r.values()].filter((t) => t.topic === e),
+		getQuietHours: async (e) => i.get(e) ?? null,
+		setQuietHours: async (e) => {
+			i.set(e.subjectId, e);
+		},
+		clearQuietHours: async (e) => {
+			i.delete(e);
+		},
+		enqueueHeld: async (e) => {
+			a.push(e);
+		},
+		pendingDigest: async (e) => a.filter((t) => t.kind === "digest" && t.subjectId === e),
+		dueHeld: async (e) => a.filter((t) => t.flushAt <= e).sort((e, t) => e.flushAt < t.flushAt ? -1 : 1),
+		clearHeld: async (e) => {
+			let t = new Set(e);
+			for (let e = a.length - 1; e >= 0; e--) t.has(a[e].id) && a.splice(e, 1);
+		}
+	};
+}, o = (e) => e instanceof Date ? e.toISOString() : typeof e == "string" ? e : "", s = (a) => {
+	let s = async (e, t, n, r) => await a.query({
+		table: e,
+		predicate: t,
+		order: n,
+		take: r,
+		skip: void 0,
+		projection: void 0
+	}), c = (e) => ({
+		id: String(e.id),
+		subjectId: String(e.subjectId),
+		category: String(e.category),
+		title: String(e.title),
+		body: String(e.body),
+		data: e.data ?? {},
+		readAt: e.readAt == null ? null : o(e.readAt),
+		archivedAt: e.archivedAt == null ? null : o(e.archivedAt),
+		createdAt: o(e.createdAt),
+		tenantId: e.tenantId ?? null
+	}), l = (e) => ({
+		subjectId: String(e.subjectId),
+		category: String(e.category),
+		channel: String(e.channel),
+		enabled: !!e.enabled
+	}), u = (e) => ({
+		id: String(e.id),
+		to: String(e.recipient),
+		category: String(e.category),
+		channel: String(e.channel),
+		status: e.status,
+		at: o(e.at),
+		...e.error == null ? {} : { error: String(e.error) },
+		...e.endpoint == null ? {} : { endpoint: String(e.endpoint) },
+		...e.clickToken == null ? {} : { clickToken: String(e.clickToken) },
+		...e.clickedAt == null ? {} : { clickedAt: o(e.clickedAt) }
+	}), d = (e) => ({
+		topic: String(e.topic),
+		subjectId: String(e.subjectId),
+		tenantId: e.tenantId ?? null
+	}), f = (e) => ({
+		subjectId: String(e.subjectId),
+		startMinute: Number(e.startMinute),
+		endMinute: Number(e.endMinute),
+		tz: String(e.tz ?? "UTC"),
+		policy: e.policy === "drop" ? "drop" : "hold"
+	}), p = (e) => ({
+		id: String(e.id),
+		kind: e.kind === "quiet" ? "quiet" : "digest",
+		subjectId: String(e.subjectId),
+		send: e.send ?? {},
+		flushAt: o(e.flushAt)
+	});
+	return {
+		addInbox: async (e) => {
+			await a.insert("_voltro_notification_inbox", {
+				id: e.id,
+				subjectId: e.subjectId,
+				category: e.category,
+				title: e.title,
+				body: e.body,
+				data: e.data ?? {},
+				readAt: null,
+				archivedAt: null,
+				createdAt: e.createdAt,
+				tenantId: e.tenantId ?? null
+			});
+		},
+		listInbox: async (n, i) => {
+			let a = i?.unreadOnly ? e(t("subjectId", n), r("readAt")) : t("subjectId", n);
+			return (await s("_voltro_notification_inbox", a, [{
+				column: "createdAt",
+				direction: "desc"
+			}], i?.limit)).map(c);
+		},
+		markRead: async (n, r) => (await s("_voltro_notification_inbox", e(t("id", n), t("subjectId", r)), [], 1))[0] ? (await a.update("_voltro_notification_inbox", n, { readAt: (/* @__PURE__ */ new Date()).toISOString() }), !0) : !1,
+		markUnread: async (n, r) => (await s("_voltro_notification_inbox", e(t("id", n), t("subjectId", r)), [], 1))[0] ? (await a.update("_voltro_notification_inbox", n, { readAt: null }), !0) : !1,
+		markAllRead: async (n) => {
+			let i = /* @__PURE__ */ new Date();
+			return a.updateMany("_voltro_notification_inbox", { readAt: i }, { where: e(t("subjectId", n), r("readAt")) });
+		},
+		setArchived: async (n, r, i) => (await s("_voltro_notification_inbox", e(t("id", n), t("subjectId", r)), [], 1))[0] ? (await a.update("_voltro_notification_inbox", n, { archivedAt: i ? (/* @__PURE__ */ new Date()).toISOString() : null }), !0) : !1,
+		unreadCount: async (n) => {
+			let i = await a.query({
+				table: "_voltro_notification_inbox",
+				predicate: e(t("subjectId", n), r("readAt")),
+				order: [],
+				take: void 0,
+				skip: void 0,
+				projection: void 0,
+				aggregations: [{
+					op: "count",
+					alias: "count"
+				}]
+			});
+			return Number(i[0]?.count ?? 0);
+		},
+		getPreferences: async (e) => (await s("_voltro_notification_preferences", t("subjectId", e), [], void 0)).map(l),
+		setPreference: async (e) => {
+			let t = n({
+				kind: "typeid",
+				prefix: "notifpref"
+			}, "_voltro_notification_preferences");
+			await a.upsert("_voltro_notification_preferences", {
+				id: t,
+				subjectId: e.subjectId,
+				category: e.category,
+				channel: e.channel,
+				enabled: e.enabled
+			}, {
+				conflictColumns: [
+					"subjectId",
+					"category",
+					"channel"
+				],
+				update: ["enabled"]
+			});
+		},
+		recordDelivery: async (e) => {
+			await a.insert("_voltro_notification_deliveries", {
+				id: e.id,
+				recipient: e.to,
+				category: e.category,
+				channel: e.channel,
+				status: e.status,
+				error: e.error ?? null,
+				at: e.at,
+				endpoint: e.endpoint ?? null,
+				clickToken: e.clickToken ?? null,
+				clickedAt: e.clickedAt ?? null
+			});
+		},
+		markClicked: async (e) => {
+			let n = await s("_voltro_notification_deliveries", t("clickToken", e), [], 1);
+			return n[0] ? (await a.update("_voltro_notification_deliveries", String(n[0].id), { clickedAt: (/* @__PURE__ */ new Date()).toISOString() }), !0) : !1;
+		},
+		listDeliveries: async (e) => (await s("_voltro_notification_deliveries", void 0, [{
+			column: "at",
+			direction: "desc"
+		}], e?.limit)).map(u),
+		subscribeTopic: async (e) => {
+			let t = n({
+				kind: "typeid",
+				prefix: "notiftsub"
+			}, "_voltro_notification_topic_subscriptions");
+			await a.upsert("_voltro_notification_topic_subscriptions", {
+				id: t,
+				topic: e.topic,
+				subjectId: e.subjectId,
+				tenantId: e.tenantId ?? null
+			}, {
+				conflictColumns: ["topic", "subjectId"],
+				update: ["tenantId"]
+			});
+		},
+		unsubscribeTopic: async (n, r) => {
+			let i = await s("_voltro_notification_topic_subscriptions", e(t("topic", n), t("subjectId", r)), [], 1);
+			i[0] && await a.delete("_voltro_notification_topic_subscriptions", String(i[0].id));
+		},
+		listTopicSubscribers: async (e) => (await s("_voltro_notification_topic_subscriptions", t("topic", e), [], void 0)).map(d),
+		getQuietHours: async (e) => {
+			let n = await s("_voltro_notification_quiet_hours", t("subjectId", e), [], 1);
+			return n[0] ? f(n[0]) : null;
+		},
+		setQuietHours: async (e) => {
+			let t = n({
+				kind: "typeid",
+				prefix: "notifqh"
+			}, "_voltro_notification_quiet_hours");
+			await a.upsert("_voltro_notification_quiet_hours", {
+				id: t,
+				subjectId: e.subjectId,
+				startMinute: e.startMinute,
+				endMinute: e.endMinute,
+				tz: e.tz ?? "UTC",
+				policy: e.policy ?? "hold"
+			}, {
+				conflictColumns: ["subjectId"],
+				update: [
+					"startMinute",
+					"endMinute",
+					"tz",
+					"policy"
+				]
+			});
+		},
+		clearQuietHours: async (e) => {
+			let n = await s("_voltro_notification_quiet_hours", t("subjectId", e), [], 1);
+			n[0] && await a.delete("_voltro_notification_quiet_hours", String(n[0].id));
+		},
+		enqueueHeld: async (e) => {
+			await a.insert("_voltro_notification_held", {
+				id: e.id,
+				kind: e.kind,
+				subjectId: e.subjectId,
+				send: e.send,
+				flushAt: e.flushAt
+			});
+		},
+		pendingDigest: async (n) => (await s("_voltro_notification_held", e(t("kind", "digest"), t("subjectId", n)), [{
+			column: "flushAt",
+			direction: "asc"
+		}], void 0)).map(p),
+		dueHeld: async (e) => (await s("_voltro_notification_held", i("flushAt", e), [{
+			column: "flushAt",
+			direction: "asc"
+		}], void 0)).map(p),
+		clearHeld: async (e) => {
+			for (let t of e) await a.delete("_voltro_notification_held", t);
+		}
+	};
+};
+//#endregion
+export { s as dataStoreNotificationStore, a as memoryNotificationStore };