@wopr-network/platform-core 1.27.1 → 1.29.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/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/0010_oracle_address.sql

@@ -0,0 +1,11 @@
+ALTER TABLE "payment_methods" ADD COLUMN "oracle_address" text;
+--> statement-breakpoint
+ALTER TABLE "payment_methods" ADD COLUMN "xpub" text;
+--> statement-breakpoint
+UPDATE "payment_methods" SET "oracle_address" = '0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70' WHERE "id" = 'ETH:base';
+--> statement-breakpoint
+UPDATE "payment_methods" SET "oracle_address" = '0x64c911996D3c6aC71f9b455B1E8E7266BcbD848F' WHERE "id" = 'BTC:mainnet';
+--> statement-breakpoint
+UPDATE "payment_methods" SET "xpub" = 'xpub6DSVkV7mgEZrnBEmZEq412Cx9sYYZtFvGSb6W9bRDDSikYdpmUiJoNeuechuir63ZjdHQuWBLwchQQnh2GD6DJP6bPKUa1bey1X6XvH9jvM' WHERE "chain" = 'base';
+--> statement-breakpoint
+UPDATE "payment_methods" SET "xpub" = 'xpub6BuGg4sQuvoA7q545ZoStxU7QP24qmZNMo39FxRjLwbBCQ77sjsHGcpxeNVboGZQNdbeANHVK1GJx7ECMfjohkpLqoGLVP9SCQM4bR1F5vh' WHERE "chain" = 'bitcoin';

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

@@ -71,6 +71,20 @@
       "when": 1742400000000,
       "tag": "0009_tenant_update_configs",
       "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "7",
+      "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.27.1",
+  "version": "1.29.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/billing/crypto/charge-store.ts

@@ -1,4 +1,4 @@
-import { eq, sql } from "drizzle-orm";
+import { and, eq, isNotNull, isNull, sql } from "drizzle-orm";
 import type { PlatformDb } from "../../db/index.js";
 import { cryptoCharges } from "../../db/schema/crypto.js";
 import type { CryptoPaymentState } from "./types.js";
@@ -43,6 +43,8 @@ export interface ICryptoChargeRepository {
   createStablecoinCharge(input: CryptoDepositChargeInput): Promise<void>;
   getByDepositAddress(address: string): Promise<CryptoChargeRecord | null>;
   getNextDerivationIndex(): Promise<number>;
+  /** List deposit addresses with pending (uncredited) charges, grouped by chain. */
+  listActiveDepositAddresses(): Promise<{ chain: string; address: string }[]>;
 }
 
 /**
@@ -154,6 +156,17 @@ export class DrizzleCryptoChargeRepository implements ICryptoChargeRepository {
     return this.toRecord(row);
   }
 
+  /** List deposit addresses with pending (uncredited) charges. */
+  async listActiveDepositAddresses(): Promise<{ chain: string; address: string }[]> {
+    const rows = await this.db
+      .select({ chain: cryptoCharges.chain, address: cryptoCharges.depositAddress })
+      .from(cryptoCharges)
+      .where(
+        and(isNull(cryptoCharges.creditedAt), isNotNull(cryptoCharges.depositAddress), isNotNull(cryptoCharges.chain)),
+      );
+    return rows.filter((r): r is { chain: string; address: string } => r.chain !== null && r.address !== null);
+  }
+
   /** Get the next available HD derivation index (max + 1, or 0 if empty). */
   async getNextDerivationIndex(): Promise<number> {
     const result = await this.db

package/src/billing/crypto/payment-method-store.ts

@@ -13,6 +13,8 @@ export interface PaymentMethodRecord {
   enabled: boolean;
   displayOrder: number;
   rpcUrl: string | null;
+  oracleAddress: string | null;
+  xpub: string | null;
   confirmations: number;
 }
 
@@ -76,6 +78,8 @@ export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
         enabled: method.enabled,
         displayOrder: method.displayOrder,
         rpcUrl: method.rpcUrl,
+        oracleAddress: method.oracleAddress,
+        xpub: method.xpub,
         confirmations: method.confirmations,
       })
       .onConflictDoUpdate({
@@ -90,6 +94,8 @@ export class DrizzlePaymentMethodStore implements IPaymentMethodStore {
           enabled: method.enabled,
           displayOrder: method.displayOrder,
           rpcUrl: method.rpcUrl,
+          oracleAddress: method.oracleAddress,
+          xpub: method.xpub,
           confirmations: method.confirmations,
         },
       });
@@ -112,6 +118,8 @@ function toRecord(row: typeof paymentMethods.$inferSelect): PaymentMethodRecord
     enabled: row.enabled,
     displayOrder: row.displayOrder,
     rpcUrl: row.rpcUrl,
+    oracleAddress: row.oracleAddress,
+    xpub: row.xpub,
     confirmations: row.confirmations,
   };
 }

package/src/db/schema/crypto.ts

@@ -61,7 +61,9 @@ export const paymentMethods = pgTable("payment_methods", {
   displayName: text("display_name").notNull(),
   enabled: boolean("enabled").notNull().default(true),
   displayOrder: integer("display_order").notNull().default(0),
-  rpcUrl: text("rpc_url"), // override per-chain RPC (null = use default)
+  rpcUrl: text("rpc_url"), // chain node RPC endpoint
+  oracleAddress: text("oracle_address"), // Chainlink feed address for price (null = 1:1 stablecoin)
+  xpub: text("xpub"), // HD wallet extended public key for deposit address derivation
   confirmations: integer("confirmations").notNull().default(1),
   createdAt: text("created_at").notNull().default(sql`(now())`),
 });

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`),
+});