@digimuza/system-core 0.2.0 → 0.3.0-rc.1

package/dist/notifications/api.js

@@ -0,0 +1,384 @@
+// Notifications (DIG-74): the per-transaction notifier, `notify` for modules,
+// and the Convex functions of `defineNotifications`.
+//
+// Access: notifications are the user's own data, guarded like the profile
+// (`getMyProfile`): a human session plus `profile:own:read` (reads) or
+// `profile:own:update` (changes). Every active user holds both through the
+// protected, implicit Profile role, so no catalog migration is needed; API keys
+// get FORBIDDEN (human-only permissions); suspended users get FORBIDDEN.
+import { internalActionGeneric, internalMutationGeneric, makeFunctionReference, mutationGeneric, queryGeneric } from "convex/server";
+import { v } from "convex/values";
+import { isModuleEnabled, isSuperActor, requireHuman, usersWithPermission } from "../core/access.js";
+import { recordAudit } from "../core/audit.js";
+import { notFound, validation } from "../core/errors.js";
+import { P } from "../core/system-modules.js";
+import { toConvexError } from "../convex/functions.js";
+import { NOTIFICATION_MARK_ALL_BATCH, NOTIFICATION_PARAMS_MAX, NOTIFICATION_UNREAD_CAP, NOTIFICATIONS_AUDIT, NOTIFY_MAX_RECIPIENTS, } from "./contract.js";
+const DEFAULT_LOCALE = "lt";
+const SAFE_HREF = /^\/(?!\/)[^\s\\]*$/;
+const db = (ctx) => ctx.db;
+/** Created by `notificationsHook`; pass it to `defineConvexSystem({ notifications })`. */
+export class NotificationsInstall {
+    functionsModule;
+    email;
+    defaultLocale;
+    extraTypes;
+    cache = new WeakMap();
+    constructor(options = {}) {
+        this.functionsModule = options.functionsModule ?? "notifications";
+        this.email = options.email ?? true;
+        this.defaultLocale = options.defaultLocale ?? DEFAULT_LOCALE;
+        this.extraTypes = options.types ?? [];
+    }
+    /** All notification types of the system: module manifests + `types`. Throws on unknown modules or collisions. */
+    typesOf(catalog) {
+        let map = this.cache.get(catalog);
+        if (map)
+            return map;
+        const out = new Map(catalog.notificationTypes);
+        for (const t of this.extraTypes) {
+            if (!catalog.modules.has(t.moduleId))
+                throw new Error(`notificationsHook: type ${t.id} belongs to unknown module ${t.moduleId}`);
+            if (out.has(t.id))
+                throw new Error(`notificationsHook: duplicate notification type ${t.id}`);
+            out.set(t.id, t);
+        }
+        map = out;
+        this.cache.set(catalog, map);
+        return map;
+    }
+    deliverRef() {
+        return makeFunctionReference(`${this.functionsModule}:_deliverNotificationEmail`);
+    }
+    bind(ctx, sys) {
+        return new BoundNotifier(this, ctx, sys);
+    }
+}
+class BoundNotifier {
+    install;
+    ctx;
+    sys;
+    constructor(install, ctx, sys) {
+        this.install = install;
+        this.ctx = ctx;
+        this.sys = sys;
+    }
+    notify(request) {
+        return send(this.ctx, this.sys, this.install, request);
+    }
+}
+/**
+ * The system hook that installs notifications:
+ *
+ *   defineConvexSystem({ modules, notifications: notificationsHook() })
+ *
+ * Every mutation's SystemContext then carries a notifier, so core services
+ * (role assignment) and modules (finance) notify through `notifyIfInstalled`.
+ */
+export function notificationsHook(options = {}) {
+    return new NotificationsInstall(options);
+}
+// --- Sending -----------------------------------------------------------------------------------
+const isPlainObject = (x) => Object.prototype.toString.call(x) === "[object Object]";
+function fail(sys, e) {
+    e.operationId ??= sys.operationId;
+    throw e;
+}
+/** The acting human (an agent acts for its owner). */
+const actingUserId = (actor) => (!actor || actor === "system" ? null : actor.kind === "user" ? actor.userId : actor.ownerId);
+async function recipients(sys, request) {
+    const to = request.to;
+    if ("userIds" in to) {
+        const ids = [...new Set(to.userIds)];
+        if (ids.length > NOTIFY_MAX_RECIPIENTS)
+            fail(sys, validation("too_many_recipients", ["to"]));
+        const out = [];
+        for (const id of ids) {
+            const user = await sys.store.get("users", id);
+            if (user?.status === "active")
+                out.push(id);
+        }
+        return out;
+    }
+    if (!sys.def.catalog.permissions.has(to.permission))
+        fail(sys, validation("unknown_permission", ["to"]));
+    const exclude = request.includeActor ? null : actingUserId(request.actor);
+    const { userIds, truncated } = await usersWithPermission(sys, to.permission, NOTIFY_MAX_RECIPIENTS + 1);
+    const out = userIds.filter((id) => id !== exclude).slice(0, NOTIFY_MAX_RECIPIENTS);
+    if (truncated || userIds.filter((id) => id !== exclude).length > NOTIFY_MAX_RECIPIENTS) {
+        sys.logger.warn("notify_recipients_capped", { type: request.type, max: NOTIFY_MAX_RECIPIENTS });
+    }
+    return out;
+}
+async function preference(ctx, userId, type) {
+    return db(ctx)
+        .query("notificationPreferences")
+        .withIndex("by_user_type", (q) => q.eq("userId", userId).eq("type", type))
+        .unique();
+}
+/**
+ * Validates, resolves recipients, applies each recipient's preferences, inserts
+ * rows and schedules emails. Returns the number of recipients notified.
+ */
+async function send(ctx, sys, install, request) {
+    const type = install.typesOf(sys.def.catalog).get(request.type);
+    if (!type)
+        fail(sys, validation("unknown_notification_type", ["type"]));
+    if (!isPlainObject(request.params))
+        fail(sys, validation("invalid_params", ["params"]));
+    let json;
+    try {
+        json = JSON.stringify(request.params);
+    }
+    catch {
+        fail(sys, validation("invalid_params", ["params"]));
+    }
+    if (json.length > NOTIFICATION_PARAMS_MAX)
+        fail(sys, validation("params_too_large", ["params"]));
+    const params = JSON.parse(json);
+    if (request.href !== undefined && (request.href.length > 500 || !SAFE_HREF.test(request.href)))
+        fail(sys, validation("invalid_href", ["href"]));
+    const writer = db(ctx);
+    if (typeof writer.insert !== "function")
+        throw new Error("notify must run inside a mutation");
+    let userIds = await recipients(sys, request);
+    // A disabled module's notifications reach only those who can still use it (an effective Super).
+    if (!isModuleEnabled(sys, await sys.store.get("modules", type.moduleId))) {
+        const supers = [];
+        for (const id of userIds)
+            if (await isSuperActor(sys, { kind: "user", userId: id }))
+                supers.push(id);
+        userIds = supers;
+    }
+    const scheduler = ctx.scheduler;
+    const now = sys.now();
+    let count = 0;
+    for (const userId of userIds) {
+        const pref = await preference(ctx, userId, type.id);
+        const inApp = pref?.inApp ?? type.defaultChannels.inApp;
+        const email = pref?.email ?? type.defaultChannels.email;
+        if (!inApp && !email)
+            continue;
+        const emailStatus = !email ? "none" : install.email && scheduler ? "pending" : "skipped";
+        const row = { userId, type: type.id, params, inApp, createdAt: now, emailStatus, operationId: sys.operationId };
+        if (request.href !== undefined)
+            row.href = request.href;
+        const id = await db(ctx).insert("notifications", row);
+        if (emailStatus === "pending")
+            await scheduler.runAfter(0, install.deliverRef(), { notificationId: id });
+        count++;
+    }
+    sys.logger.info("notifications_sent", { type: type.id, count });
+    return count;
+}
+/**
+ * Sends a notification from any mutation of a module:
+ *
+ *   await notify(ctx, sys, { to: { permission: "crm:lead:assign" }, type: "crm.lead_assigned", params: { name }, href: "/app/crm", actor })
+ *
+ * `to.permission` → active users holding it now (via `decide`; module state and
+ * role view apply), without the acting user unless `includeActor`. At most
+ * NOTIFY_MAX_RECIPIENTS. Each recipient's preferences apply; emails are scheduled
+ * only for those with email on. Returns the count; 0 when notifications are not
+ * installed. Throws VALIDATION for an unknown type, bad params or href.
+ * (Core services and package modules use the swallowing `notifyIfInstalled`.)
+ */
+export async function notify(ctx, sys, request) {
+    const notifier = sys.notifier;
+    if (!(notifier instanceof BoundNotifier))
+        return 0;
+    return send(ctx, sys, notifier.install, request);
+}
+const PAGE_DEFAULT = 20;
+const PAGE_MAX = 100;
+const actorArgs = { apiKey: v.optional(v.string()), operationId: v.optional(v.string()) };
+/**
+ * The notifications Convex functions, bound to the app's system (which must have
+ * `notifications: notificationsHook()`):
+ *
+ *   // convex/notifications.ts
+ *   export const { listNotifications, …, _deliverNotificationEmail, _claimNotificationEmail, _recordNotificationEmail } =
+ *     defineNotifications(system, { renderEmail, deliverEmail }).functions
+ */
+export function defineNotifications(system, options = {}) {
+    const install = system.notifications;
+    if (!(install instanceof NotificationsInstall)) {
+        throw new Error("defineNotifications: install the hook first: defineConvexSystem({ notifications: notificationsHook() })");
+    }
+    const types = install.typesOf(system.definition.catalog);
+    const ref = (name) => makeFunctionReference(`${install.functionsModule}:${name}`);
+    const canEmail = !!options.renderEmail && !!options.deliverEmail;
+    /** Own data, like the profile: human session + profile:own:read / profile:own:update. */
+    async function guard(ctx, a, permission) {
+        const { sys, actor } = await system.requirePermission(ctx, permission, { apiKey: a.apiKey, operationId: a.operationId });
+        try {
+            return { sys, actor: requireHuman(sys, actor) };
+        }
+        catch (e) {
+            throw toConvexError(e, sys.operationId);
+        }
+    }
+    const moduleOf = (type) => types.get(type)?.moduleId ?? type.split(".", 1)[0];
+    const view = (n) => ({
+        id: n._id,
+        type: n.type,
+        moduleId: moduleOf(n.type),
+        params: n.params,
+        href: n.href ?? null,
+        readAt: n.readAt ?? null,
+        createdAt: n.createdAt,
+        emailStatus: n.emailStatus,
+    });
+    /** Types whose module the actor can use now (an effective Super sees disabled modules too). */
+    async function visibleTypes(sys, actor) {
+        const isSuper = await isSuperActor(sys, actor);
+        const out = [];
+        for (const t of types.values()) {
+            if (isSuper || isModuleEnabled(sys, await sys.store.get("modules", t.moduleId)))
+                out.push(t);
+        }
+        return out.sort((a, b) => a.moduleId.localeCompare(b.moduleId) || a.id.localeCompare(b.id));
+    }
+    const prefView = (t, pref) => ({
+        type: t.id,
+        moduleId: t.moduleId,
+        description: t.description ?? null,
+        params: [...(t.params ?? [])],
+        defaultChannels: { inApp: t.defaultChannels.inApp, email: t.defaultChannels.email },
+        inApp: pref?.inApp ?? t.defaultChannels.inApp,
+        email: pref?.email ?? t.defaultChannels.email,
+        customized: !!pref,
+    });
+    const unread = (ctx, userId) => db(ctx)
+        .query("notifications")
+        .withIndex("by_user_unread", (q) => q.eq("userId", userId).eq("inApp", true).eq("readAt", undefined));
+    const functions = {
+        // --- Public ------------------------------------------------------------------------------
+        listNotifications: queryGeneric({
+            args: { ...actorArgs, cursor: v.optional(v.union(v.string(), v.null())), limit: v.optional(v.number()), unreadOnly: v.optional(v.boolean()) },
+            handler: async (ctx, a) => {
+                const { actor } = await guard(ctx, a, P.profileRead);
+                const numItems = Math.min(Math.max(1, Math.floor(a.limit ?? PAGE_DEFAULT)), PAGE_MAX);
+                const q = a.unreadOnly ? unread(ctx, actor.userId) : db(ctx).query("notifications").withIndex("by_user", (q) => q.eq("userId", actor.userId).eq("inApp", true));
+                const res = await q.order("desc").paginate({ cursor: a.cursor ?? null, numItems });
+                return { items: res.page.map(view), cursor: res.isDone ? null : res.continueCursor, done: res.isDone };
+            },
+        }),
+        unreadNotificationCount: queryGeneric({
+            args: { ...actorArgs },
+            handler: async (ctx, a) => {
+                const { actor } = await guard(ctx, a, P.profileRead);
+                return (await unread(ctx, actor.userId).take(NOTIFICATION_UNREAD_CAP)).length;
+            },
+        }),
+        markNotificationRead: mutationGeneric({
+            args: { ...actorArgs, notificationId: v.id("notifications") },
+            handler: async (ctx, a) => {
+                const { sys, actor } = await guard(ctx, a, P.profileUpdate);
+                const row = await db(ctx).get("notifications", a.notificationId);
+                // Someone else's notification and a missing one look the same.
+                if (!row || row.userId !== actor.userId)
+                    throw toConvexError(notFound("notification_not_found"), sys.operationId);
+                if (row.readAt !== undefined)
+                    return { read: false };
+                await db(ctx).patch("notifications", row._id, { readAt: sys.now() });
+                return { read: true };
+            },
+        }),
+        markAllNotificationsRead: mutationGeneric({
+            args: { ...actorArgs },
+            handler: async (ctx, a) => {
+                const { sys, actor } = await guard(ctx, a, P.profileUpdate);
+                const rows = await unread(ctx, actor.userId).take(NOTIFICATION_MARK_ALL_BATCH + 1);
+                const batch = rows.slice(0, NOTIFICATION_MARK_ALL_BATCH);
+                const now = sys.now();
+                for (const r of batch)
+                    await db(ctx).patch("notifications", r._id, { readAt: now });
+                return { marked: batch.length, done: rows.length <= NOTIFICATION_MARK_ALL_BATCH };
+            },
+        }),
+        getNotificationPreferences: queryGeneric({
+            args: { ...actorArgs },
+            handler: async (ctx, a) => {
+                const { sys, actor } = await guard(ctx, a, P.profileRead);
+                const out = [];
+                for (const t of await visibleTypes(sys, actor))
+                    out.push(prefView(t, await preference(ctx, actor.userId, t.id)));
+                return out;
+            },
+        }),
+        setNotificationPreference: mutationGeneric({
+            args: { ...actorArgs, type: v.string(), inApp: v.boolean(), email: v.boolean() },
+            handler: async (ctx, a) => {
+                const { sys, actor } = await guard(ctx, a, P.profileUpdate);
+                const type = (await visibleTypes(sys, actor)).find((t) => t.id === a.type);
+                if (!type)
+                    throw toConvexError(validation("unknown_notification_type", ["type"]), sys.operationId);
+                const existing = await preference(ctx, actor.userId, type.id);
+                const now = sys.now();
+                if (existing)
+                    await db(ctx).patch("notificationPreferences", existing._id, { inApp: a.inApp, email: a.email, updatedAt: now });
+                else
+                    await db(ctx).insert("notificationPreferences", { userId: actor.userId, type: type.id, inApp: a.inApp, email: a.email, updatedAt: now });
+                await recordAudit(sys, actor, {
+                    action: NOTIFICATIONS_AUDIT.preferenceUpdate,
+                    targetType: "notification_type",
+                    targetId: type.id,
+                    changes: { inApp: a.inApp, email: a.email },
+                });
+                return prefView(type, { _id: existing?._id ?? "", userId: actor.userId, type: type.id, inApp: a.inApp, email: a.email, updatedAt: now });
+            },
+        }),
+        // --- Internal (email delivery) -------------------------------------------------------------
+        /** Scheduled by `notify` for each row with email `pending`. Never throws. */
+        _deliverNotificationEmail: internalActionGeneric({
+            args: { notificationId: v.id("notifications") },
+            handler: async (ctx, a) => {
+                const job = (await ctx.runMutation(ref("_claimNotificationEmail"), { notificationId: a.notificationId }));
+                if (!job)
+                    return "skipped";
+                let ok = false;
+                try {
+                    const email = await options.renderEmail(job.type, job.params, job.locale, { href: job.href, notificationId: a.notificationId });
+                    if (!email || typeof email.subject !== "string" || typeof email.text !== "string")
+                        throw new Error("renderEmail returned no subject/text");
+                    const res = await options.deliverEmail({ to: job.to, subject: email.subject, text: email.text, type: job.type, notificationId: a.notificationId, operationId: job.operationId });
+                    ok = res !== false;
+                }
+                catch (error) {
+                    // The adapter's error may contain the address: log only its name.
+                    system.definition.logger.warn("notification_email_failed", { notificationId: a.notificationId, type: job.type, errorName: error instanceof Error ? error.name : "unknown" });
+                }
+                await ctx.runMutation(ref("_recordNotificationEmail"), { notificationId: a.notificationId, ok });
+                return ok ? "sent" : "failed";
+            },
+        }),
+        /** → the email job, or null (and `skipped`) when there is nothing to send. */
+        _claimNotificationEmail: internalMutationGeneric({
+            args: { notificationId: v.id("notifications") },
+            handler: async (ctx, a) => {
+                const row = await db(ctx).get("notifications", a.notificationId);
+                if (!row || row.emailStatus !== "pending")
+                    return null;
+                const { sys } = await system.context(ctx, { operationId: row.operationId });
+                const user = await sys.store.get("users", row.userId);
+                if (!canEmail || !types.has(row.type) || !user || user.status !== "active" || !user.emailVerified) {
+                    await db(ctx).patch("notifications", row._id, { emailStatus: "skipped" });
+                    return null;
+                }
+                return { to: user.email, locale: user.locale ?? install.defaultLocale, type: row.type, params: row.params, href: row.href ?? null, operationId: row.operationId };
+            },
+        }),
+        _recordNotificationEmail: internalMutationGeneric({
+            args: { notificationId: v.id("notifications"), ok: v.boolean() },
+            handler: async (ctx, a) => {
+                const row = await db(ctx).get("notifications", a.notificationId);
+                if (row?.emailStatus === "pending")
+                    await db(ctx).patch("notifications", row._id, { emailStatus: a.ok ? "sent" : "failed" });
+                return null;
+            },
+        }),
+    };
+    return { functions, types };
+}
+//# sourceMappingURL=api.js.map

package/dist/notifications/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/notifications/api.ts"],"names":[],"mappings":"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"}

package/dist/notifications/contract.d.ts

@@ -0,0 +1,132 @@
+import { type GenericId, type Infer } from "convex/values";
+import type { NotificationParams } from "../core/notify.js";
+export declare const emailStatus: import("convex/values").VUnion<"failed" | "none" | "pending" | "sent" | "skipped", [import("convex/values").VLiteral<"none", "required">, import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"sent", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"skipped", "required">], "required", never>;
+/** Spread into the app schema next to `systemTables`. */
+export declare const notificationTables: {
+    notifications: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        createdAt: number;
+        emailStatus: "failed" | "none" | "pending" | "sent" | "skipped";
+        href?: string | undefined;
+        inApp: boolean;
+        operationId: string;
+        params: any;
+        readAt?: number | undefined;
+        type: string;
+        userId: string;
+    }, {
+        /** system-core user key of the recipient. Only they can see it. */
+        userId: import("convex/values").VString<string, "required">;
+        /** Notification type id, e.g. `finance.invoice_awaiting_approval`. */
+        type: import("convex/values").VString<string, "required">;
+        /** JSON params; the app renders the text (LT/EN) from them. */
+        params: import("convex/values").VAny<any, "required", string>;
+        /** App-relative link. */
+        href: import("convex/values").VString<string | undefined, "optional">;
+        /** False for email-only rows (the user turned the in-app channel off): never listed. */
+        inApp: import("convex/values").VBoolean<boolean, "required">;
+        readAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        createdAt: import("convex/values").VFloat64<number, "required">;
+        /** none: email off · pending: scheduled · sent · failed · skipped: no adapter, no verified address. */
+        emailStatus: import("convex/values").VUnion<"failed" | "none" | "pending" | "sent" | "skipped", [import("convex/values").VLiteral<"none", "required">, import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"sent", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"skipped", "required">], "required", never>;
+        /** Operation that caused it (the business mutation's). */
+        operationId: import("convex/values").VString<string, "required">;
+    }, "required", "createdAt" | "emailStatus" | "href" | "inApp" | "operationId" | "params" | "readAt" | "type" | "userId" | `params.${string}`>, {
+        by_user: ["userId", "inApp", "createdAt", "_creationTime"];
+        by_user_unread: ["userId", "inApp", "readAt", "_creationTime"];
+    }, {}, {}>;
+    notificationPreferences: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        email: boolean;
+        inApp: boolean;
+        type: string;
+        updatedAt: number;
+        userId: string;
+    }, {
+        userId: import("convex/values").VString<string, "required">;
+        type: import("convex/values").VString<string, "required">;
+        inApp: import("convex/values").VBoolean<boolean, "required">;
+        email: import("convex/values").VBoolean<boolean, "required">;
+        updatedAt: import("convex/values").VFloat64<number, "required">;
+    }, "required", "email" | "inApp" | "type" | "updatedAt" | "userId">, {
+        by_user_type: ["userId", "type", "_creationTime"];
+    }, {}, {}>;
+};
+export type EmailStatus = Infer<typeof emailStatus>;
+export type NotificationId = GenericId<"notifications">;
+export interface NotificationView {
+    id: NotificationId;
+    type: string;
+    /** Owning module of the type (`finance`, `roles`, …). */
+    moduleId: string;
+    params: NotificationParams;
+    href: string | null;
+    readAt: number | null;
+    createdAt: number;
+    emailStatus: EmailStatus;
+}
+export interface NotificationPreferenceView {
+    type: string;
+    moduleId: string;
+    /** Fallback text; the app translates by `type`. */
+    description: string | null;
+    /** Param names the type carries. */
+    params: string[];
+    defaultChannels: {
+        inApp: boolean;
+        email: boolean;
+    };
+    /** Effective channels (the user's preference, else the defaults). */
+    inApp: boolean;
+    email: boolean;
+    /** The user has set a preference for this type. */
+    customized: boolean;
+}
+export interface RenderedEmail {
+    subject: string;
+    text: string;
+}
+/**
+ * Renders a notification email in the recipient's locale (profile locale, else
+ * the default, `lt`). Build absolute links from `href` with the app's SITE_URL.
+ */
+export type RenderNotificationEmail = (type: string, params: NotificationParams, locale: string, context: {
+    href: string | null;
+    notificationId: string;
+}) => RenderedEmail | Promise<RenderedEmail>;
+export interface NotificationEmailMessage {
+    /** Verified address of the recipient. Never logged by core. */
+    to: string;
+    subject: string;
+    text: string;
+    type: string;
+    notificationId: string;
+    /** Stable per notification: use it as an idempotency key with the provider. */
+    operationId: string;
+}
+/** Sends one email. Throw (or return false) on failure: the row becomes `failed`. */
+export type DeliverNotificationEmail = (message: NotificationEmailMessage) => Promise<void | boolean>;
+/** What `_claimNotificationEmail` hands the delivery action. */
+export interface NotificationEmailJob {
+    to: string;
+    locale: string;
+    type: string;
+    params: NotificationParams;
+    href: string | null;
+    operationId: string;
+}
+/** Most recipients of one `notify` call. Explicit `userIds` above it are VALIDATION. */
+export declare const NOTIFY_MAX_RECIPIENTS = 100;
+/** `unreadNotificationCount` stops counting here (show "99+"). */
+export declare const NOTIFICATION_UNREAD_CAP = 100;
+/** Rows one `markAllNotificationsRead` call marks; call again while `done` is false. */
+export declare const NOTIFICATION_MARK_ALL_BATCH = 200;
+/** Serialized params size limit (characters of JSON). */
+export declare const NOTIFICATION_PARAMS_MAX = 4000;
+/** Public functions in `functionsModule` (default convex/notifications.ts). */
+export declare const NOTIFICATIONS_PUBLIC_FUNCTIONS: readonly ["listNotifications", "unreadNotificationCount", "markNotificationRead", "markAllNotificationsRead", "getNotificationPreferences", "setNotificationPreference"];
+/** Internal functions in `functionsModule` (email delivery). */
+export declare const NOTIFICATIONS_INTERNAL_FUNCTIONS: readonly ["_deliverNotificationEmail", "_claimNotificationEmail", "_recordNotificationEmail"];
+/** Audit action of a preference change. */
+export declare const NOTIFICATIONS_AUDIT: {
+    readonly preferenceUpdate: "profile.notification_preference.update";
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/notifications/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/notifications/contract.ts"],"names":[],"mappings":"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"}

package/dist/notifications/contract.js

@@ -0,0 +1,59 @@
+// Shared contract of `@digimuza/system-core/notifications` (DIG-74): tables,
+// views, adapters and function names. No server-only imports: safe in Convex's
+// default runtime and in the browser (types).
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+export const emailStatus = v.union(v.literal("none"), v.literal("pending"), v.literal("sent"), v.literal("failed"), v.literal("skipped"));
+/** Spread into the app schema next to `systemTables`. */
+export const notificationTables = {
+    notifications: defineTable({
+        /** system-core user key of the recipient. Only they can see it. */
+        userId: v.string(),
+        /** Notification type id, e.g. `finance.invoice_awaiting_approval`. */
+        type: v.string(),
+        /** JSON params; the app renders the text (LT/EN) from them. */
+        params: v.any(),
+        /** App-relative link. */
+        href: v.optional(v.string()),
+        /** False for email-only rows (the user turned the in-app channel off): never listed. */
+        inApp: v.boolean(),
+        readAt: v.optional(v.number()),
+        createdAt: v.number(),
+        /** none: email off · pending: scheduled · sent · failed · skipped: no adapter, no verified address. */
+        emailStatus,
+        /** Operation that caused it (the business mutation's). */
+        operationId: v.string(),
+    })
+        .index("by_user", ["userId", "inApp", "createdAt"])
+        .index("by_user_unread", ["userId", "inApp", "readAt"]),
+    notificationPreferences: defineTable({
+        userId: v.string(),
+        type: v.string(),
+        inApp: v.boolean(),
+        email: v.boolean(),
+        updatedAt: v.number(),
+    }).index("by_user_type", ["userId", "type"]),
+};
+// --- Limits & function names ---------------------------------------------------------------
+/** Most recipients of one `notify` call. Explicit `userIds` above it are VALIDATION. */
+export const NOTIFY_MAX_RECIPIENTS = 100;
+/** `unreadNotificationCount` stops counting here (show "99+"). */
+export const NOTIFICATION_UNREAD_CAP = 100;
+/** Rows one `markAllNotificationsRead` call marks; call again while `done` is false. */
+export const NOTIFICATION_MARK_ALL_BATCH = 200;
+/** Serialized params size limit (characters of JSON). */
+export const NOTIFICATION_PARAMS_MAX = 4000;
+/** Public functions in `functionsModule` (default convex/notifications.ts). */
+export const NOTIFICATIONS_PUBLIC_FUNCTIONS = [
+    "listNotifications", // ({ cursor?, limit?, unreadOnly? }) → { items: NotificationView[], cursor, done }
+    "unreadNotificationCount", // () → number (≤ NOTIFICATION_UNREAD_CAP)
+    "markNotificationRead", // ({ notificationId }) → { read } (NOT_FOUND unless own)
+    "markAllNotificationsRead", // () → { marked, done }
+    "getNotificationPreferences", // () → NotificationPreferenceView[]
+    "setNotificationPreference", // ({ type, inApp, email }) → NotificationPreferenceView
+];
+/** Internal functions in `functionsModule` (email delivery). */
+export const NOTIFICATIONS_INTERNAL_FUNCTIONS = ["_deliverNotificationEmail", "_claimNotificationEmail", "_recordNotificationEmail"];
+/** Audit action of a preference change. */
+export const NOTIFICATIONS_AUDIT = { preferenceUpdate: "profile.notification_preference.update" };
+//# sourceMappingURL=contract.js.map

package/dist/notifications/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/notifications/contract.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,CAAC,EAA8B,MAAM,eAAe,CAAA;AAG7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AAEzI,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,WAAW,CAAC;QACzB,mEAAmE;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,sEAAsE;QACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,+DAA+D;QAC/D,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;QACf,yBAAyB;QACzB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5B,wFAAwF;QACxF,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,uGAAuG;QACvG,WAAW;QACX,0DAA0D;QAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC;SACC,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;SAClD,KAAK,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEzD,uBAAuB,EAAE,WAAW,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAA;AA6ED,8FAA8F;AAE9F,wFAAwF;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;AACxC,kEAAkE;AAClE,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,wFAAwF;AACxF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAA;AAC9C,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAE3C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,mBAAmB,EAAE,mFAAmF;IACxG,yBAAyB,EAAE,0CAA0C;IACrE,sBAAsB,EAAE,yDAAyD;IACjF,0BAA0B,EAAE,wBAAwB;IACpD,4BAA4B,EAAE,oCAAoC;IAClE,2BAA2B,EAAE,wDAAwD;CAC7E,CAAA;AAEV,gEAAgE;AAChE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,2BAA2B,EAAE,yBAAyB,EAAE,0BAA0B,CAAU,CAAA;AAE7I,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,gBAAgB,EAAE,wCAAwC,EAAW,CAAA"}

package/dist/notifications/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./contract.js";
+export { defineNotifications, notificationsHook, notify, NotificationsInstall, type NotificationsHookOptions, type NotificationsOptions, type NotificationsSystem } from "./api.js";
+export { defineNotificationType, NOTIFICATION_TYPE_ID, type NotificationTypeDefinition } from "../core/catalog.js";
+export { notifyIfInstalled, type Notifier, type NotifyRequest, type NotifyTarget, type NotificationParams } from "../core/notify.js";
+export { CORE_NOTIFICATION_TYPES } from "../core/system-modules.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,EAAE,oBAAoB,EAAE,KAAK,wBAAwB,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnL,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAClH,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACpI,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA"}