@wopr-network/platform-core 1.28.0 → 1.30.0

package/dist/email/index.js

@@ -10,7 +10,10 @@
  */
 export { BillingEmailService } from "./billing-emails.js";
 export { EmailClient, getEmailClient, resetEmailClient, setEmailClient } from "./client.js";
+export { DEFAULT_TEMPLATES } from "./default-templates.js";
 export { DrizzleBillingEmailRepository } from "./drizzle-billing-email-repository.js";
+export { DrizzleNotificationTemplateRepository } from "./drizzle-notification-template-repository.js";
+export { HandlebarsRenderer } from "./handlebars-renderer.js";
 export { DrizzleNotificationPreferencesStore } from "./notification-preferences-store.js";
 export { DrizzleNotificationQueueStore } from "./notification-queue-store.js";
 export { NotificationService } from "./notification-service.js";

package/dist/email/notification-preferences-store.js

@@ -11,6 +11,7 @@ const DEFAULTS = {
     agent_status_changes: false,
     account_role_changes: true,
     account_team_invites: true,
+    fleet_updates: true,
 };
 export class DrizzleNotificationPreferencesStore {
     db;
@@ -34,6 +35,7 @@ export class DrizzleNotificationPreferencesStore {
             agent_status_changes: row.agentStatusChanges,
             account_role_changes: row.accountRoleChanges,
             account_team_invites: row.accountTeamInvites,
+            fleet_updates: row.fleetUpdates,
         };
     }
     /** Update preferences for a tenant. Upserts — creates row if missing. */
@@ -53,6 +55,8 @@ export class DrizzleNotificationPreferencesStore {
             values.accountRoleChanges = prefs.account_role_changes;
         if (prefs.account_team_invites !== undefined)
             values.accountTeamInvites = prefs.account_team_invites;
+        if (prefs.fleet_updates !== undefined)
+            values.fleetUpdates = prefs.fleet_updates;
         // Get existing row to merge with defaults
         const existing = await this.db
             .select()
@@ -73,6 +77,7 @@ export class DrizzleNotificationPreferencesStore {
                 agentStatusChanges: DEFAULTS.agent_status_changes,
                 accountRoleChanges: DEFAULTS.account_role_changes,
                 accountTeamInvites: DEFAULTS.account_team_invites,
+                fleetUpdates: DEFAULTS.fleet_updates,
                 updatedAt: Math.floor(Date.now() / 1000),
                 ...values,
             };

package/dist/email/notification-preferences-store.test.js

@@ -28,6 +28,7 @@ describe("DrizzleNotificationPreferencesStore", () => {
                 agent_status_changes: false,
                 account_role_changes: true,
                 account_team_invites: true,
+                fleet_updates: true,
             });
         });
         it("returns stored values when row exists", async () => {

package/dist/email/notification-repository-types.d.ts

@@ -20,6 +20,7 @@ export interface NotificationPrefs {
     agent_status_changes: boolean;
     account_role_changes: boolean;
     account_team_invites: boolean;
+    fleet_updates: boolean;
 }
 export type NotificationEmailType = "low_balance" | "grace_entered" | "suspended" | "receipt" | "welcome" | "reactivated";
 export interface NotificationInput {
@@ -48,6 +49,35 @@ export interface NotificationRow {
     /** Unix epoch ms */
     sentAt: number | null;
 }
+/** Row shape returned by the template repository. */
+export interface NotificationTemplateRow {
+    id: string;
+    name: string;
+    description: string | null;
+    subject: string;
+    htmlBody: string;
+    textBody: string;
+    active: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Repository contract for notification templates. */
+export interface INotificationTemplateRepository {
+    getByName(name: string): Promise<NotificationTemplateRow | null>;
+    list(): Promise<NotificationTemplateRow[]>;
+    upsert(name: string, template: Omit<NotificationTemplateRow, "id" | "name" | "createdAt" | "updatedAt">): Promise<void>;
+    /**
+     * Seed default templates — INSERT OR IGNORE so admin edits are not overwritten.
+     * @returns number of templates inserted (not already present).
+     */
+    seed(templates: Array<{
+        name: string;
+        description: string;
+        subject: string;
+        htmlBody: string;
+        textBody: string;
+    }>): Promise<number>;
+}
 /** Repository interface for notification preferences. */
 export interface INotificationPreferencesRepository {
     get(tenantId: string): Promise<NotificationPrefs>;

package/dist/email/notification-service.d.ts

@@ -37,5 +37,7 @@ export declare class NotificationService {
     notifyAccountDeletionRequested(tenantId: string, email: string, deleteAfterDate: string): void;
     notifyAccountDeletionCancelled(tenantId: string, email: string): void;
     notifyAccountDeletionCompleted(tenantId: string, email: string): void;
+    notifyFleetUpdateAvailable(tenantId: string, email: string, version: string, changelogDate: string, changelogSummary: string): void;
+    notifyFleetUpdateComplete(tenantId: string, email: string, version: string, succeeded: number, failed: number): void;
     sendCustomEmail(tenantId: string, email: string, subject: string, bodyText: string): void;
 }

package/dist/email/notification-service.js

@@ -188,6 +188,28 @@ export class NotificationService {
         this.queue.enqueue(tenantId, "account-deletion-completed", { email });
     }
     // ---------------------------------------------------------------------------
+    // Fleet Updates
+    // ---------------------------------------------------------------------------
+    notifyFleetUpdateAvailable(tenantId, email, version, changelogDate, changelogSummary) {
+        this.queue.enqueue(tenantId, "fleet-update-available", {
+            email,
+            version,
+            changelogDate,
+            changelogSummary,
+            fleetUrl: `${this.appBaseUrl}/fleet`,
+        });
+    }
+    notifyFleetUpdateComplete(tenantId, email, version, succeeded, failed) {
+        this.queue.enqueue(tenantId, "fleet-update-complete", {
+            email,
+            version,
+            succeeded,
+            failed,
+            total: succeeded + failed,
+            fleetUrl: `${this.appBaseUrl}/fleet`,
+        });
+    }
+    // ---------------------------------------------------------------------------
     // Admin custom email
     // ---------------------------------------------------------------------------
     sendCustomEmail(tenantId, email, subject, bodyText) {

package/dist/email/notification-template-repository.d.ts

@@ -0,0 +1,7 @@
+/**
+ * INotificationTemplateRepository — interface for DB-driven email templates.
+ *
+ * Types live in notification-repository-types.ts; this file re-exports them
+ * so existing imports continue to work.
+ */
+export type { INotificationTemplateRepository, NotificationTemplateRow } from "./notification-repository-types.js";

package/dist/email/notification-template-repository.js

@@ -0,0 +1,7 @@
+/**
+ * INotificationTemplateRepository — interface for DB-driven email templates.
+ *
+ * Types live in notification-repository-types.ts; this file re-exports them
+ * so existing imports continue to work.
+ */
+export {};

package/dist/email/notification-templates.d.ts

@@ -7,7 +7,7 @@
  * Export: renderNotificationTemplate(template, data) → TemplateResult
  */
 import type { TemplateResult } from "./templates.js";
-export type NotificationTemplateName = "credits-depleted" | "grace-period-start" | "grace-period-warning" | "auto-suspended" | "auto-topup-success" | "auto-topup-failed" | "crypto-payment-confirmed" | "admin-suspended" | "admin-reactivated" | "credits-granted" | "role-changed" | "team-invite" | "agent-created" | "channel-connected" | "channel-disconnected" | "agent-suspended" | "custom" | "account-deletion-requested" | "account-deletion-cancelled" | "account-deletion-completed" | "dividend-weekly-digest" | "affiliate-credit-match" | "spend-alert" | "low-balance" | "credit-purchase-receipt" | "welcome" | "password-reset";
+export type NotificationTemplateName = "credits-depleted" | "grace-period-start" | "grace-period-warning" | "auto-suspended" | "auto-topup-success" | "auto-topup-failed" | "crypto-payment-confirmed" | "admin-suspended" | "admin-reactivated" | "credits-granted" | "role-changed" | "team-invite" | "agent-created" | "channel-connected" | "channel-disconnected" | "agent-suspended" | "custom" | "account-deletion-requested" | "account-deletion-cancelled" | "account-deletion-completed" | "dividend-weekly-digest" | "affiliate-credit-match" | "spend-alert" | "fleet-update-available" | "fleet-update-complete" | "low-balance" | "credit-purchase-receipt" | "welcome" | "password-reset";
 export type TemplateName = NotificationTemplateName;
 /**
  * Render a notification template by name.

package/dist/email/notification-templates.js

@@ -520,6 +520,58 @@ export function renderNotificationTemplate(template, data) {
             return accountDeletionCancelledTemplate(data);
         case "account-deletion-completed":
             return accountDeletionCompletedTemplate(data);
+        case "fleet-update-available": {
+            const version = escapeHtml(data.version || "");
+            const changelogDate = escapeHtml(data.changelogDate || "");
+            const changelogSummary = escapeHtml(data.changelogSummary || "");
+            const fleetUrl = data.fleetUrl || "";
+            const faParts = [
+                heading(`Fleet Update Available: ${version}`),
+                paragraph(`<p>A new version <strong>${version}</strong> is available for your fleet.</p>` +
+                    (changelogDate ? `<p style="color: #718096; font-size: 14px;">Released: ${changelogDate}</p>` : "") +
+                    (changelogSummary
+                        ? `<div style="background: #f7fafc; border-left: 4px solid #2563eb; padding: 12px 16px; margin: 16px 0; color: #4a5568; font-size: 14px; line-height: 22px;">${changelogSummary}</div>`
+                        : "")),
+            ];
+            if (fleetUrl)
+                faParts.push(button(fleetUrl, "View Fleet Dashboard"));
+            faParts.push(footer("Review the changelog and update when ready."));
+            return {
+                subject: `Fleet update available: ${data.version}`,
+                html: wrapHtml("Fleet Update Available", faParts.join("\n")),
+                text: `Fleet Update Available: ${data.version}\n\nA new version ${data.version} is available for your fleet.\n${changelogDate ? `Released: ${data.changelogDate}\n` : ""}${changelogSummary ? `Changelog: ${data.changelogSummary}\n` : ""}${fleetUrl ? `\nFleet dashboard: ${fleetUrl}\n` : ""}${copyright()}`,
+            };
+        }
+        case "fleet-update-complete": {
+            const fcVersion = escapeHtml(data.version || "");
+            const succeeded = Number(data.succeeded) || 0;
+            const failed = Number(data.failed) || 0;
+            const total = succeeded + failed;
+            const fleetUrl2 = data.fleetUrl || "";
+            const statusText = failed === 0 ? "all instances healthy" : `${failed} instance(s) failed`;
+            const fcParts = [
+                heading(`Fleet Updated to ${fcVersion}`),
+                paragraph(`<p>Your fleet update to <strong>${fcVersion}</strong> has completed.</p>` +
+                    `<table style="width: 100%; border-collapse: collapse; margin: 16px 0;">` +
+                    `<tr><td style="padding: 8px 0; color: #4a5568;">Succeeded</td><td style="padding: 8px 0; text-align: right; font-weight: 600; color: #22c55e;">${succeeded}</td></tr>` +
+                    `<tr><td style="padding: 8px 0; color: #4a5568;">Failed</td><td style="padding: 8px 0; text-align: right; font-weight: 600; color: ${failed > 0 ? "#dc2626" : "#22c55e"};">${failed}</td></tr>` +
+                    `<tr style="border-top: 2px solid #e2e8f0;"><td style="padding: 12px 0; color: #4a5568; font-weight: 600;">Total</td><td style="padding: 12px 0; text-align: right; font-weight: 700; color: #1a1a1a;">${total}</td></tr>` +
+                    `</table>` +
+                    (failed > 0
+                        ? `<p style="color: #dc2626;">Some instances failed to update. Check the fleet dashboard for details.</p>`
+                        : "")),
+            ];
+            if (fleetUrl2)
+                fcParts.push(button(fleetUrl2, "View Fleet Dashboard"));
+            fcParts.push(footer(failed === 0
+                ? "All instances are running the latest version."
+                : "Review failed instances and retry if needed."));
+            return {
+                subject: `Fleet updated to ${data.version} \u2014 ${statusText}`,
+                html: wrapHtml("Fleet Update Complete", fcParts.join("\n")),
+                text: `Fleet Updated to ${data.version}\n\nSucceeded: ${succeeded}\nFailed: ${failed}\nTotal: ${total}\n${failed > 0 ? "\nSome instances failed to update.\n" : ""}${fleetUrl2 ? `\nFleet dashboard: ${fleetUrl2}\n` : ""}${copyright()}`,
+            };
+        }
         case "low-balance":
             return {
                 subject: "Your WOPR credits are running low",

package/dist/email/notification-worker.d.ts

@@ -5,18 +5,21 @@
  * Do NOT put the interval inside this class.
  */
 import type { EmailClient } from "./client.js";
+import type { HandlebarsRenderer } from "./handlebars-renderer.js";
 import type { INotificationPreferencesRepository, INotificationQueueRepository } from "./notification-repository-types.js";
 export interface NotificationWorkerConfig {
     queue: INotificationQueueRepository;
     emailClient: EmailClient;
     preferences: INotificationPreferencesRepository;
     batchSize?: number;
+    handlebarsRenderer?: HandlebarsRenderer;
 }
 export declare class NotificationWorker {
     private readonly queue;
     private readonly emailClient;
     private readonly preferences;
     private readonly batchSize;
+    private readonly handlebarsRenderer;
     constructor(config: NotificationWorkerConfig);
     /** Process one batch of pending notifications. Returns count of processed items. */
     processBatch(): Promise<number>;

package/dist/email/notification-worker.js

@@ -35,17 +35,21 @@ const PREF_MAP = {
     "dividend-weekly-digest": "billing_receipts",
     "role-changed": "account_role_changes",
     "team-invite": "account_team_invites",
+    "fleet-update-available": "fleet_updates",
+    "fleet-update-complete": "fleet_updates",
 };
 export class NotificationWorker {
     queue;
     emailClient;
     preferences;
     batchSize;
+    handlebarsRenderer;
     constructor(config) {
         this.queue = config.queue;
         this.emailClient = config.emailClient;
         this.preferences = config.preferences;
         this.batchSize = config.batchSize ?? 10;
+        this.handlebarsRenderer = config.handlebarsRenderer;
     }
     /** Process one batch of pending notifications. Returns count of processed items. */
     async processBatch() {
@@ -74,8 +78,14 @@ export class NotificationWorker {
                         continue;
                     }
                 }
-                // Render the template
-                const rendered = renderNotificationTemplate(notif.template, data);
+                // Try DB-driven Handlebars first, fall back to code templates
+                let rendered = null;
+                if (this.handlebarsRenderer) {
+                    rendered = await this.handlebarsRenderer.render(notif.template, data);
+                }
+                if (!rendered) {
+                    rendered = renderNotificationTemplate(notif.template, data);
+                }
                 // Send via email client
                 await this.emailClient.send({
                     to: email,

package/dist/fleet/fleet-notification-listener.d.ts

@@ -0,0 +1,13 @@
+import type { INotificationPreferencesRepository } from "../email/notification-repository-types.js";
+import type { NotificationService } from "../email/notification-service.js";
+import type { FleetEventEmitter } from "./fleet-event-emitter.js";
+export interface FleetNotificationListenerDeps {
+    eventEmitter: FleetEventEmitter;
+    notificationService: NotificationService;
+    preferences: INotificationPreferencesRepository;
+    /** Resolve tenant ID to owner email. Return null if no email found. */
+    resolveEmail: (tenantId: string) => Promise<string | null>;
+    /** Debounce window in ms before sending summary email. Default 60_000. */
+    debounceMs?: number;
+}
+export declare function initFleetNotificationListener(deps: FleetNotificationListenerDeps): () => void;

package/dist/fleet/fleet-notification-listener.js

@@ -0,0 +1,65 @@
+import { logger } from "../config/logger.js";
+export function initFleetNotificationListener(deps) {
+    const { eventEmitter, notificationService, preferences, resolveEmail } = deps;
+    const debounceMs = deps.debounceMs ?? 60_000;
+    const pending = new Map();
+    async function flush(tenantId) {
+        const rollout = pending.get(tenantId);
+        if (!rollout)
+            return;
+        pending.delete(tenantId);
+        try {
+            const prefs = await preferences.get(tenantId);
+            if (!prefs.fleet_updates)
+                return;
+            const email = await resolveEmail(tenantId);
+            if (!email) {
+                logger.warn("Fleet notification skipped: no email for tenant", { tenantId });
+                return;
+            }
+            // TODO: Surface actual target version from RolloutOrchestrator context.
+            // BotFleetEvent doesn't carry version info; "latest" is a placeholder.
+            notificationService.notifyFleetUpdateComplete(tenantId, email, "latest", rollout.succeeded, rollout.failed);
+        }
+        catch (err) {
+            logger.error("Fleet notification flush error", { err, tenantId });
+        }
+    }
+    const unsubscribe = eventEmitter.subscribe((event) => {
+        if (!("tenantId" in event))
+            return;
+        const botEvent = event;
+        if (botEvent.type !== "bot.updated" && botEvent.type !== "bot.update_failed")
+            return;
+        let rollout = pending.get(botEvent.tenantId);
+        if (!rollout) {
+            rollout = {
+                tenantId: botEvent.tenantId,
+                succeeded: 0,
+                failed: 0,
+                timer: setTimeout(() => flush(botEvent.tenantId), debounceMs),
+            };
+            pending.set(botEvent.tenantId, rollout);
+        }
+        else {
+            // Reset timer on each new event (sliding window)
+            clearTimeout(rollout.timer);
+            rollout.timer = setTimeout(() => flush(botEvent.tenantId), debounceMs);
+        }
+        if (botEvent.type === "bot.updated") {
+            rollout.succeeded++;
+        }
+        else {
+            rollout.failed++;
+        }
+    });
+    return () => {
+        unsubscribe();
+        // Flush all pending on shutdown
+        for (const [tenantId, rollout] of pending) {
+            clearTimeout(rollout.timer);
+            void flush(tenantId);
+        }
+        pending.clear();
+    };
+}

package/dist/fleet/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./drizzle-tenant-update-config-repository.js";
+export type { FleetNotificationListenerDeps } from "./fleet-notification-listener.js";
+export { initFleetNotificationListener } from "./fleet-notification-listener.js";
 export * from "./init-fleet-updater.js";
 export * from "./repository-types.js";
 export * from "./rollout-orchestrator.js";

package/dist/fleet/index.js

@@ -1,4 +1,5 @@
 export * from "./drizzle-tenant-update-config-repository.js";
+export { initFleetNotificationListener } from "./fleet-notification-listener.js";
 export * from "./init-fleet-updater.js";
 export * from "./repository-types.js";
 export * from "./rollout-orchestrator.js";

package/dist/trpc/index.d.ts

@@ -1,2 +1,3 @@
 export { createFleetUpdateConfigRouter } from "./fleet-update-config-router.js";
 export { adminProcedure, createCallerFactory, orgAdminProcedure, orgMemberProcedure, protectedProcedure, publicProcedure, router, setTrpcOrgMemberRepo, type TRPCContext, tenantProcedure, } from "./init.js";
+export { createNotificationTemplateRouter } from "./notification-template-router.js";

package/dist/trpc/index.js

@@ -1,2 +1,3 @@
 export { createFleetUpdateConfigRouter } from "./fleet-update-config-router.js";
 export { adminProcedure, createCallerFactory, orgAdminProcedure, orgMemberProcedure, protectedProcedure, publicProcedure, router, setTrpcOrgMemberRepo, tenantProcedure, } from "./init.js";
+export { createNotificationTemplateRouter } from "./notification-template-router.js";

package/dist/trpc/notification-template-router.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Admin tRPC router for managing DB-driven notification templates.
+ *
+ * All procedures require platform_admin role via adminProcedure.
+ */
+import type { INotificationTemplateRepository } from "../email/notification-template-repository.js";
+export declare function createNotificationTemplateRouter(getRepo: () => INotificationTemplateRepository): import("@trpc/server").TRPCBuiltRouter<{
+    ctx: import("./init.js").TRPCContext;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    listTemplates: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: import("../email/notification-repository-types.js").NotificationTemplateRow[];
+        meta: object;
+    }>;
+    getTemplate: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            name: string;
+        };
+        output: import("../email/notification-repository-types.js").NotificationTemplateRow | null;
+        meta: object;
+    }>;
+    updateTemplate: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            name: string;
+            subject?: string | undefined;
+            htmlBody?: string | undefined;
+            textBody?: string | undefined;
+            description?: string | undefined;
+            active?: boolean | undefined;
+        };
+        output: void;
+        meta: object;
+    }>;
+    previewTemplate: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            subject: string;
+            htmlBody: string;
+            textBody: string;
+            data: Record<string, unknown>;
+        };
+        output: {
+            subject: string;
+            html: string;
+            text: string;
+        };
+        meta: object;
+    }>;
+    seedDefaults: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            inserted: number;
+            total: number;
+        };
+        meta: object;
+    }>;
+}>>;

package/dist/trpc/notification-template-router.js

@@ -0,0 +1,81 @@
+/**
+ * Admin tRPC router for managing DB-driven notification templates.
+ *
+ * All procedures require platform_admin role via adminProcedure.
+ */
+import { TRPCError } from "@trpc/server";
+import Handlebars from "handlebars";
+import { z } from "zod";
+import { logger } from "../config/logger.js";
+import { DEFAULT_TEMPLATES } from "../email/default-templates.js";
+import { adminProcedure, router } from "./init.js";
+export function createNotificationTemplateRouter(getRepo) {
+    return router({
+        listTemplates: adminProcedure.query(async () => {
+            const repo = getRepo();
+            return repo.list();
+        }),
+        getTemplate: adminProcedure.input(z.object({ name: z.string() })).query(async ({ input }) => {
+            const repo = getRepo();
+            return repo.getByName(input.name);
+        }),
+        updateTemplate: adminProcedure
+            .input(z.object({
+            name: z.string(),
+            subject: z.string().optional(),
+            htmlBody: z.string().optional(),
+            textBody: z.string().optional(),
+            description: z.string().optional(),
+            active: z.boolean().optional(),
+        }))
+            .mutation(async ({ input }) => {
+            const repo = getRepo();
+            const existing = await repo.getByName(input.name);
+            if (!existing) {
+                throw new TRPCError({ code: "NOT_FOUND", message: `Template "${input.name}" not found` });
+            }
+            await repo.upsert(input.name, {
+                subject: input.subject ?? existing.subject,
+                htmlBody: input.htmlBody ?? existing.htmlBody,
+                textBody: input.textBody ?? existing.textBody,
+                description: input.description ?? existing.description,
+                active: input.active ?? existing.active,
+            });
+            logger.info("Notification template updated", {
+                action: "notification_template.update",
+                templateName: input.name,
+            });
+        }),
+        previewTemplate: adminProcedure
+            .input(z.object({
+            subject: z.string(),
+            htmlBody: z.string(),
+            textBody: z.string(),
+            data: z.record(z.string(), z.unknown()),
+        }))
+            .mutation(({ input }) => {
+            try {
+                const subject = Handlebars.compile(input.subject)(input.data);
+                const html = Handlebars.compile(input.htmlBody)(input.data);
+                const text = Handlebars.compile(input.textBody)(input.data);
+                return { subject, html, text };
+            }
+            catch (err) {
+                throw new TRPCError({
+                    code: "BAD_REQUEST",
+                    message: `Template render error: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }),
+        seedDefaults: adminProcedure.mutation(async () => {
+            const repo = getRepo();
+            const inserted = await repo.seed(DEFAULT_TEMPLATES);
+            logger.info("Notification template defaults seeded", {
+                action: "notification_template.seed",
+                inserted,
+                total: DEFAULT_TEMPLATES.length,
+            });
+            return { inserted, total: DEFAULT_TEMPLATES.length };
+        }),
+    });
+}

package/drizzle/migrations/0011_notification_templates.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS "notification_templates" (
+	"id" text PRIMARY KEY NOT NULL,
+	"name" text NOT NULL,
+	"description" text,
+	"subject" text NOT NULL,
+	"html_body" text NOT NULL,
+	"text_body" text NOT NULL,
+	"active" boolean DEFAULT true NOT NULL,
+	"created_at" bigint DEFAULT (extract(epoch from now()))::bigint NOT NULL,
+	"updated_at" bigint DEFAULT (extract(epoch from now()))::bigint NOT NULL,
+	CONSTRAINT "notification_templates_name_unique" UNIQUE("name")
+);
+--> statement-breakpoint
+ALTER TABLE "notification_preferences" ADD COLUMN "fleet_updates" boolean DEFAULT true NOT NULL;

package/drizzle/migrations/meta/_journal.json

@@ -78,6 +78,13 @@
       "when": 1742486400000,
       "tag": "0010_oracle_address",
       "breakpoints": true
+    },
+    {
+      "idx": 11,
+      "version": "7",
+      "when": 1742572800000,
+      "tag": "0011_notification_templates",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -132,6 +132,7 @@
     "@scure/base": "^2.0.0",
     "@scure/bip32": "^2.0.1",
     "@scure/bip39": "^2.0.1",
+    "handlebars": "^4.7.8",
     "js-yaml": "^4.1.1",
     "viem": "^2.47.4",
     "yaml": "^2.8.2"

package/src/db/schema/index.ts

@@ -34,6 +34,7 @@ export * from "./node-transitions.js";
 export * from "./nodes.js";
 export * from "./notification-preferences.js";
 export * from "./notification-queue.js";
+export * from "./notification-templates.js";
 export * from "./oauth-states.js";
 export * from "./onboarding-scripts.js";
 export * from "./onboarding-sessions.js";

package/src/db/schema/notification-preferences.ts

@@ -15,5 +15,6 @@ export const notificationPreferences = pgTable("notification_preferences", {
   agentStatusChanges: boolean("agent_status_changes").notNull().default(false),
   accountRoleChanges: boolean("account_role_changes").notNull().default(true),
   accountTeamInvites: boolean("account_team_invites").notNull().default(true),
+  fleetUpdates: boolean("fleet_updates").notNull().default(true),
   updatedAt: bigint("updated_at", { mode: "number" }).notNull().default(sql`(extract(epoch from now()))::bigint`),
 });

package/src/db/schema/notification-templates.ts

@@ -0,0 +1,19 @@
+import { sql } from "drizzle-orm";
+import { bigint, boolean, pgTable, text } from "drizzle-orm/pg-core";
+
+/**
+ * DB-driven email templates with Handlebars syntax.
+ * Each row stores a named template (subject + HTML + text bodies).
+ * Admins can edit these at runtime without code deploys.
+ */
+export const notificationTemplates = pgTable("notification_templates", {
+  id: text("id").primaryKey(),
+  name: text("name").notNull().unique(),
+  description: text("description"),
+  subject: text("subject").notNull(),
+  htmlBody: text("html_body").notNull(),
+  textBody: text("text_body").notNull(),
+  active: boolean("active").notNull().default(true),
+  createdAt: bigint("created_at", { mode: "number" }).notNull().default(sql`(extract(epoch from now()))::bigint`),
+  updatedAt: bigint("updated_at", { mode: "number" }).notNull().default(sql`(extract(epoch from now()))::bigint`),
+});