hazo_notify 3.1.0 → 5.0.0

package/dist/lib/inbox/worker/flush.js.map

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

package/dist/lib/inbox/worker/render.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Template body renderer for channel adapters (worker side).
+ *
+ * Called by the worker before handing a row to an adapter. Pre-renders
+ * template bodies so adapters receive `ctx.rendered_bodies` already
+ * populated — adapters never import template_manager themselves.
+ *
+ * @packageDocumentation
+ */
+import type { ChannelAdapter } from "../../channels/types.js";
+/**
+ * Render template bodies for a claimed delivery row.
+ *
+ * Returns an object keyed by body key (subset of adapter.capabilities.template_body_keys).
+ * Returns an empty object when the payload has no template_name (caller used pre-rendered bodies).
+ *
+ * @throws Error when template_name is specified but not found.
+ */
+export declare function renderForChannel(adapter: ChannelAdapter, row: {
+    scope_id: string;
+    payload: Record<string, unknown>;
+}): Promise<Record<string, string>>;
+//# sourceMappingURL=render.d.ts.map

package/dist/lib/inbox/worker/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAmB9D;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA2BjC"}

package/dist/lib/inbox/worker/render.js

@@ -0,0 +1,58 @@
+/**
+ * Template body renderer for channel adapters (worker side).
+ *
+ * Called by the worker before handing a row to an adapter. Pre-renders
+ * template bodies so adapters receive `ctx.rendered_bodies` already
+ * populated — adapters never import template_manager themselves.
+ *
+ * @packageDocumentation
+ */
+import { QueryBuilder } from "hazo_connect/server";
+import { get_template_by_name } from "../../template_manager/db/index.js";
+import { render_handlebars_string } from "../../template_manager/engine/index.js";
+import { getInboxConnection } from "../connection.js";
+// Bridge inbox's HazoConnectAdapter to template_manager's HazoConnectInstance facade.
+// template_manager only calls .query()/.list() on this; other facade methods are unused
+// in this path. The HazoConnectInstance contract is preserved as an internal facade
+// for template_manager (see template_manager/types.ts JSDoc).
+function asTemplateManagerInstance(adapter) {
+    return {
+        query: () => new QueryBuilder(),
+        list: async (qb) => (await adapter.query(qb, "GET")),
+        findById: async () => { throw new Error("asTemplateManagerInstance: findById not implemented"); },
+        findBy: async () => { throw new Error("asTemplateManagerInstance: findBy not implemented"); },
+        insert: async () => { throw new Error("asTemplateManagerInstance: insert not implemented"); },
+        updateById: async () => { throw new Error("asTemplateManagerInstance: updateById not implemented"); },
+        deleteById: async () => { throw new Error("asTemplateManagerInstance: deleteById not implemented"); },
+    };
+}
+/**
+ * Render template bodies for a claimed delivery row.
+ *
+ * Returns an object keyed by body key (subset of adapter.capabilities.template_body_keys).
+ * Returns an empty object when the payload has no template_name (caller used pre-rendered bodies).
+ *
+ * @throws Error when template_name is specified but not found.
+ */
+export async function renderForChannel(adapter, row) {
+    const payload = row.payload;
+    if (!payload.template_name)
+        return {};
+    const conn = asTemplateManagerInstance(getInboxConnection());
+    const scope_chain = row.scope_id ? [row.scope_id] : [];
+    const result = await get_template_by_name(conn, scope_chain, payload.template_name);
+    const template = result.data;
+    if (!template)
+        throw new Error(`template not found: ${payload.template_name}`);
+    const tpl_bodies = template.bodies ?? {};
+    const vars = (payload.template_vars ?? {});
+    const bodies = {};
+    for (const key of adapter.capabilities.template_body_keys) {
+        const source = tpl_bodies[key];
+        if (typeof source === "string" && source.length > 0) {
+            bodies[key] = render_handlebars_string(source, vars);
+        }
+    }
+    return bodies;
+}
+//# sourceMappingURL=render.js.map

package/dist/lib/inbox/worker/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAItD,sFAAsF;AACtF,wFAAwF;AACxF,oFAAoF;AACpF,8DAA8D;AAC9D,SAAS,yBAAyB,CAAC,OAA2B;IAC5D,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAyD;QACtF,IAAI,EAAE,KAAK,EAAK,EAAW,EAAE,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,EAAkB,EAAE,KAAK,CAAC,CAAQ;QACvF,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC,CAAC;QACjG,MAAM,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC;QAC7F,MAAM,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC;QAC7F,UAAU,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC,CAAC;QACrG,UAAU,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,GAA2D;IAE3D,MAAM,OAAO,GAAG,GAAG,CAAC,OAGnB,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,aAAa;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,IAAI,GAAG,yBAAyB,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEpF,MAAM,QAAQ,GAAI,MAA+C,CAAC,IAAI,CAAC;IACvE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE/E,MAAM,UAAU,GAAI,QAAgD,CAAC,MAAM,IAAI,EAAE,CAAC;IAClF,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAA4B,CAAC;IACtE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,MAAM,EAAE,IAA8B,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/inbox/worker/start.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Boot-time inbox worker. Spawns one sub-worker timer per registered channel,
+ * a batch-close sweep timer, and a cleanup sweep timer.
+ *
+ * @packageDocumentation
+ */
+import { type FlushResult } from "./flush.js";
+import type { ChannelLogger, ScopeBranding } from "../../channels/types.js";
+export interface StartInboxWorkerOptions {
+    resolveRecipient: (user_id: string, scope_id: string, channel_id: string) => Promise<string | null>;
+    resolveScopeBranding?: (scope_id: string) => Promise<ScopeBranding | null>;
+    channel_overrides?: Record<string, {
+        interval_ms?: number;
+        batch_size?: number;
+        concurrency?: number;
+    }>;
+    default_batch_window_ms?: number;
+    batch_close_sweep_ms?: number;
+    cleanup_interval_ms?: number;
+    read_inbox_retention_ms?: number;
+    failed_delivery_retention_ms?: number;
+    logger?: ChannelLogger;
+}
+export interface WorkerHandle {
+    stop(): Promise<void>;
+    tickOnce(channel_id: string): Promise<FlushResult>;
+}
+export declare function startInboxWorker(opts: StartInboxWorkerOptions): WorkerHandle;
+//# sourceMappingURL=start.d.ts.map

package/dist/lib/inbox/worker/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAa5E,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpG,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,YAAY,CAsF5E"}

package/dist/lib/inbox/worker/start.js

@@ -0,0 +1,100 @@
+/**
+ * Boot-time inbox worker. Spawns one sub-worker timer per registered channel,
+ * a batch-close sweep timer, and a cleanup sweep timer.
+ *
+ * @packageDocumentation
+ */
+import { flushChannelOnce } from "./flush.js";
+import { runBatchCloseSweep, runCleanupSweep } from "./cleanup.js";
+import { getRegisteredChannels } from "../../channels/registry.js";
+const DEFAULTS = {
+    interval_ms: 30000,
+    batch_size: 50,
+    concurrency: 1,
+    batch_close_sweep_ms: 60000,
+    cleanup_interval_ms: 3600000,
+    read_inbox_retention_ms: 30 * 24 * 60 * 60 * 1000,
+    failed_delivery_retention_ms: 30 * 24 * 60 * 60 * 1000,
+    default_batch_window_ms: 5 * 60000,
+};
+export function startInboxWorker(opts) {
+    const log = opts.logger ?? console;
+    const channels = getRegisteredChannels();
+    if (channels.length === 0) {
+        log.error("inbox.worker_started_with_no_channels");
+    }
+    const timers = [];
+    const inflight = new Set();
+    let stopped = false;
+    // Per-channel sub-workers
+    for (const ch of channels) {
+        const o = opts.channel_overrides?.[ch.capabilities.channel_id] ?? {};
+        const interval_ms = o.interval_ms ?? DEFAULTS.interval_ms;
+        const batch_size = o.batch_size ?? DEFAULTS.batch_size;
+        const concurrency = o.concurrency ?? DEFAULTS.concurrency;
+        let polling = false;
+        const timer = setInterval(() => {
+            if (stopped || polling)
+                return;
+            polling = true;
+            const p = flushChannelOnce(ch.capabilities.channel_id, {
+                batchSize: batch_size,
+                concurrency,
+                resolveRecipient: opts.resolveRecipient,
+                resolveScopeBranding: opts.resolveScopeBranding,
+                logger: log,
+            })
+                .then(r => {
+                if (r.processed > 0) {
+                    log.info("inbox.flush", { channel: ch.capabilities.channel_id, ...r });
+                }
+            })
+                .catch(e => log.error("inbox.flush_unhandled", {
+                channel: ch.capabilities.channel_id,
+                error: e instanceof Error ? e.message : String(e),
+            }))
+                .finally(() => { polling = false; });
+            inflight.add(p);
+            p.finally(() => inflight.delete(p));
+        }, interval_ms);
+        timers.push(timer);
+    }
+    // Batch-close sweep
+    const window_ms = opts.default_batch_window_ms ?? DEFAULTS.default_batch_window_ms;
+    timers.push(setInterval(() => {
+        if (stopped)
+            return;
+        const p = runBatchCloseSweep(window_ms, log);
+        inflight.add(p);
+        p.finally(() => inflight.delete(p));
+    }, opts.batch_close_sweep_ms ?? DEFAULTS.batch_close_sweep_ms));
+    // Cleanup sweep
+    timers.push(setInterval(() => {
+        if (stopped)
+            return;
+        const p = runCleanupSweep(opts.read_inbox_retention_ms ?? DEFAULTS.read_inbox_retention_ms, opts.failed_delivery_retention_ms ?? DEFAULTS.failed_delivery_retention_ms, log);
+        inflight.add(p);
+        p.finally(() => inflight.delete(p));
+    }, opts.cleanup_interval_ms ?? DEFAULTS.cleanup_interval_ms));
+    log.info("inbox.worker_started", {
+        channels: channels.map(c => c.capabilities.channel_id),
+    });
+    return {
+        async stop() {
+            stopped = true;
+            timers.forEach(t => clearInterval(t));
+            await Promise.all([...inflight]);
+            log.info("inbox.worker_stopped");
+        },
+        async tickOnce(channel_id) {
+            return flushChannelOnce(channel_id, {
+                batchSize: 100,
+                concurrency: 1,
+                resolveRecipient: opts.resolveRecipient,
+                resolveScopeBranding: opts.resolveScopeBranding,
+                logger: log,
+            });
+        },
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/lib/inbox/worker/start.js.map

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

package/dist/lib/index.d.ts

@@ -1,7 +1,2 @@
-/**
- * Main library exports
- * Entry point for the hazo_notify library
- */
-export * from './emailer/index.js';
-export * from './template_manager/index.js';
+export * from "./template_manager/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAGA,cAAc,6BAA6B,CAAC"}

package/dist/lib/index.js

@@ -1,7 +1,5 @@
-/**
- * Main library exports
- * Entry point for the hazo_notify library
- */
-export * from './emailer/index.js';
-export * from './template_manager/index.js';
+// src/lib/index.ts — v4.0.0
+// send_email() is removed. Use dispatch() or instantiate EmailChannel directly.
+// Template manager re-exports are kept for the existing subpath.
+export * from "./template_manager/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,gFAAgF;AAChF,iEAAiE;AACjE,cAAc,6BAA6B,CAAC"}

package/dist/lib/jobs/handler.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Inbox flush job handler factory.
+ *
+ * Wraps `flushChannelOnce` in a hazo_jobs-compatible handler. The consuming
+ * app registers this handler against `INBOX_FLUSH_JOB_TYPE` when constructing
+ * their hazo_jobs worker process.
+ *
+ * @packageDocumentation
+ */
+import type { FlushOptions, FlushResult } from "../inbox/worker/flush.js";
+import type { HazoJobHandler, InboxFlushJobPayload } from "./types.js";
+export interface CreateInboxFlushHandlerOptions {
+    /** Resolves the channel-specific recipient address for a (user, scope, channel). */
+    resolveRecipient: FlushOptions["resolveRecipient"];
+    /** Optional scope branding resolver (used by email envelope wrapping). */
+    resolveScopeBranding?: FlushOptions["resolveScopeBranding"];
+    /** Default batch size when the payload omits one. Defaults to 50. */
+    batch_size?: number;
+    /** Concurrency inside one flush tick. Defaults to 4. */
+    concurrency?: number;
+    /** Optional logger forwarded to the channel adapter. */
+    logger?: FlushOptions["logger"];
+}
+export declare function createInboxFlushHandler(opts: CreateInboxFlushHandlerOptions): HazoJobHandler<InboxFlushJobPayload, FlushResult>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/lib/jobs/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/lib/jobs/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,8BAA8B;IAC7C,oFAAoF;IACpF,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACnD,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAC5D,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,8BAA8B,GACnC,cAAc,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAiCnD"}

package/dist/lib/jobs/handler.js

@@ -0,0 +1,36 @@
+/**
+ * Inbox flush job handler factory.
+ *
+ * Wraps `flushChannelOnce` in a hazo_jobs-compatible handler. The consuming
+ * app registers this handler against `INBOX_FLUSH_JOB_TYPE` when constructing
+ * their hazo_jobs worker process.
+ *
+ * @packageDocumentation
+ */
+import { flushChannelOnce } from "../inbox/worker/flush.js";
+export function createInboxFlushHandler(opts) {
+    const default_batch_size = opts.batch_size ?? 50;
+    const concurrency = opts.concurrency ?? 4;
+    return async function inbox_flush_handler(job, log) {
+        // SQLite-backed hazo_jobs stores payload as a JSON string and does not
+        // currently deserialize it before invoking handlers. Parse defensively so
+        // the handler works on both SQLite (string payload) and Postgres (JSONB
+        // object payload).
+        const payload = typeof job.payload === "string"
+            ? JSON.parse(job.payload)
+            : job.payload;
+        const channel_id = payload.channel_id;
+        const batchSize = payload.batch_size ?? default_batch_size;
+        log?.info?.(`[hazo_notify] inbox_flush start channel=${channel_id} batchSize=${batchSize}`);
+        const result = await flushChannelOnce(channel_id, {
+            batchSize,
+            concurrency,
+            resolveRecipient: opts.resolveRecipient,
+            resolveScopeBranding: opts.resolveScopeBranding,
+            logger: opts.logger,
+        });
+        log?.info?.(`[hazo_notify] inbox_flush done channel=${channel_id} processed=${result.processed} sent=${result.sent} failed=${result.failed} retried=${result.retried}`);
+        return result;
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/lib/jobs/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/lib/jobs/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D,MAAM,UAAU,uBAAuB,CACrC,IAAoC;IAEpC,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAE1C,OAAO,KAAK,UAAU,mBAAmB,CAAC,GAAG,EAAE,GAAG;QAChD,uEAAuE;QACvE,0EAA0E;QAC1E,wEAAwE;QACxE,mBAAmB;QACnB,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC7B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAA0B;YACnD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QAClB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC;QAE3D,GAAG,EAAE,IAAI,EAAE,CACT,2CAA2C,UAAU,cAAc,SAAS,EAAE,CAC/E,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE;YAChD,SAAS;YACT,WAAW;YACX,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAEH,GAAG,EAAE,IAAI,EAAE,CACT,0CAA0C,UAAU,cAAc,MAAM,CAAC,SAAS,SAAS,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,OAAO,EAAE,CAC3J,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/jobs/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * hazo_notify/jobs — hazo_jobs integration surface.
+ *
+ * Consumers register `createInboxFlushHandler(...)` with their hazo_jobs
+ * worker for job type `INBOX_FLUSH_JOB_TYPE`, then call
+ * `submitInboxFlushJobs(jobsClient, ...)` to enqueue work.
+ *
+ * @packageDocumentation
+ */
+export { INBOX_FLUSH_JOB_TYPE, } from "./types.js";
+export type { InboxFlushJobPayload, HazoJob, HazoJobLogger, HazoJobHandler, HazoJobsSubmitter, } from "./types.js";
+export { createInboxFlushHandler } from "./handler.js";
+export type { CreateInboxFlushHandlerOptions } from "./handler.js";
+export { submitInboxFlushJobs } from "./submit.js";
+export type { SubmitInboxFlushJobsParams } from "./submit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,oBAAoB,EACpB,OAAO,EACP,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/jobs/index.js

@@ -0,0 +1,13 @@
+/**
+ * hazo_notify/jobs — hazo_jobs integration surface.
+ *
+ * Consumers register `createInboxFlushHandler(...)` with their hazo_jobs
+ * worker for job type `INBOX_FLUSH_JOB_TYPE`, then call
+ * `submitInboxFlushJobs(jobsClient, ...)` to enqueue work.
+ *
+ * @packageDocumentation
+ */
+export { INBOX_FLUSH_JOB_TYPE, } from "./types.js";
+export { createInboxFlushHandler } from "./handler.js";
+export { submitInboxFlushJobs } from "./submit.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/jobs/submit.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Helper to enqueue inbox-flush jobs.
+ *
+ * Consumers call this immediately after `dispatch(...)` so a flush job is
+ * queued for every enabled channel. The worker process — registered with
+ * `createInboxFlushHandler` — picks the jobs up.
+ *
+ * @packageDocumentation
+ */
+import type { HazoJobsSubmitter } from "./types.js";
+export interface SubmitInboxFlushJobsParams {
+    /** Channel ids to flush (e.g. ["email", "telegram"]). */
+    channels: string[];
+    /** Optional batch size hint forwarded to the handler. */
+    batch_size?: number;
+}
+export declare function submitInboxFlushJobs(jobs: HazoJobsSubmitter, params: SubmitInboxFlushJobsParams): Promise<{
+    jobIds: string[];
+}>;
+//# sourceMappingURL=submit.d.ts.map

package/dist/lib/jobs/submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../src/lib/jobs/submit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAc/B"}

package/dist/lib/jobs/submit.js

@@ -0,0 +1,25 @@
+/**
+ * Helper to enqueue inbox-flush jobs.
+ *
+ * Consumers call this immediately after `dispatch(...)` so a flush job is
+ * queued for every enabled channel. The worker process — registered with
+ * `createInboxFlushHandler` — picks the jobs up.
+ *
+ * @packageDocumentation
+ */
+import { INBOX_FLUSH_JOB_TYPE } from "./types.js";
+export async function submitInboxFlushJobs(jobs, params) {
+    const jobIds = [];
+    for (const channel_id of params.channels) {
+        const payload = params.batch_size != null
+            ? { channel_id, batch_size: params.batch_size }
+            : { channel_id };
+        const { jobId } = await jobs.submit({
+            type: INBOX_FLUSH_JOB_TYPE,
+            payload,
+        });
+        jobIds.push(jobId);
+    }
+    return { jobIds };
+}
+//# sourceMappingURL=submit.js.map

package/dist/lib/jobs/submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../../src/lib/jobs/submit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAalD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAuB,EACvB,MAAkC;IAElC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,OAAO,GACX,MAAM,CAAC,UAAU,IAAI,IAAI;YACvB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YAC/C,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACrB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC;YAClC,IAAI,EAAE,oBAAoB;YAC1B,OAAO;SACR,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/lib/jobs/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * hazo_jobs integration types.
+ *
+ * Job types and structural interfaces for `hazo_jobs` compatibility. Declared
+ * locally so the package does not require a runtime `import` of `hazo_jobs`
+ * (which is an optional peer dep).
+ *
+ * @packageDocumentation
+ */
+/** Stable job type registered with hazo_jobs. */
+export declare const INBOX_FLUSH_JOB_TYPE = "hazo_notify.inbox_flush";
+/** Payload shape submitted by `submitInboxFlushJobs`. */
+export interface InboxFlushJobPayload {
+    channel_id: string;
+    batch_size?: number;
+}
+/** Minimal hazo_jobs `Job` shape the handler receives. */
+export interface HazoJob<P = unknown> {
+    id: string;
+    payload: P;
+}
+/** Minimal hazo_jobs `Logger` shape (optional second arg to handlers). */
+export interface HazoJobLogger {
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+}
+/** Structural match for hazo_jobs `JobHandler<P, R>`. */
+export type HazoJobHandler<P = unknown, R = unknown> = (job: HazoJob<P>, log?: HazoJobLogger) => Promise<R>;
+/** Structural subset of hazo_jobs `JobsClient.submit`. */
+export interface HazoJobsSubmitter {
+    submit(opts: {
+        type: string;
+        payload?: unknown;
+        priority?: number;
+        maxAttempts?: number;
+        expiresInSec?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/jobs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/jobs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAE9D,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0DAA0D;AAC1D,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtC;AAED,yDAAyD;AACzD,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CACrD,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,GAAG,CAAC,EAAE,aAAa,KAChB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,IAAI,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChC"}

package/dist/lib/jobs/types.js

@@ -0,0 +1,12 @@
+/**
+ * hazo_jobs integration types.
+ *
+ * Job types and structural interfaces for `hazo_jobs` compatibility. Declared
+ * locally so the package does not require a runtime `import` of `hazo_jobs`
+ * (which is an optional peer dep).
+ *
+ * @packageDocumentation
+ */
+/** Stable job type registered with hazo_jobs. */
+export const INBOX_FLUSH_JOB_TYPE = "hazo_notify.inbox_flush";
+//# sourceMappingURL=types.js.map

package/dist/lib/jobs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/jobs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC"}

package/dist/lib/template_manager/db/template_repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template_repository.d.ts","sourceRoot":"","sources":["../../../../src/lib/template_manager/db/template_repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAarB;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CA8DrD;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CAoErD;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA4CnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAgFnD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAuFnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA8GnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CA8C7C"}
+{"version":3,"file":"template_repository.d.ts","sourceRoot":"","sources":["../../../../src/lib/template_manager/db/template_repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAYrB;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,mBAAmB,EACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CA8DrD;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,EAAE,CAAC,CAAC,CAoErD;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA4CnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAgFnD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CA+EnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAgGnD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CA8C7C"}

package/dist/lib/template_manager/db/template_repository.js

@@ -5,7 +5,7 @@
  * Uses scope_id (null = global) for hierarchical template resolution.
  */
 import { TABLE_TEMPLATES, TABLE_TEMPLATE_CATEGORY, ERROR_MESSAGES, } from '../config/constants.js';
-import { validate_template_name, validate_uuid, validate_template_html_size, validate_template_text_size, } from '../utils/validation.js';
+import { validate_template_name, validate_uuid, validate_template_bodies_size, } from '../utils/validation.js';
 /**
  * List all templates visible for a given scope (scoped rows + global rows).
  * When scope_id is provided, scoped rows override global rows with the same
@@ -314,18 +314,12 @@ export async function create_template(hazo_connect, data) {
                 message: 'Invalid category ID format',
             };
         }
-        if (!validate_template_html_size(data.template_html)) {
+        const bodies_check = validate_template_bodies_size(data.bodies);
+        if (!bodies_check.ok) {
             return {
                 success: false,
                 error: ERROR_MESSAGES.TEMPLATE_HTML_TOO_LARGE,
-                message: ERROR_MESSAGES.TEMPLATE_HTML_TOO_LARGE,
-            };
-        }
-        if (!validate_template_text_size(data.template_text)) {
-            return {
-                success: false,
-                error: ERROR_MESSAGES.TEMPLATE_TEXT_TOO_LARGE,
-                message: ERROR_MESSAGES.TEMPLATE_TEXT_TOO_LARGE,
+                message: `Template body "${bodies_check.offending_key}" exceeds size limit`,
             };
         }
         // Check that the category exists
@@ -342,8 +336,7 @@ export async function create_template(hazo_connect, data) {
             template_category_id: data.template_category_id,
             template_variables: data.template_variables || [],
             template_name: data.template_name.trim(),
-            template_html: data.template_html,
-            template_text: data.template_text,
+            bodies: data.bodies,
             is_modified: false,
         });
         return {
@@ -409,21 +402,15 @@ export async function update_template(hazo_connect, id, data) {
                 message: 'Invalid category ID format',
             };
         }
-        if (data.template_html !== undefined &&
-            !validate_template_html_size(data.template_html)) {
-            return {
-                success: false,
-                error: ERROR_MESSAGES.TEMPLATE_HTML_TOO_LARGE,
-                message: ERROR_MESSAGES.TEMPLATE_HTML_TOO_LARGE,
-            };
-        }
-        if (data.template_text !== undefined &&
-            !validate_template_text_size(data.template_text)) {
-            return {
-                success: false,
-                error: ERROR_MESSAGES.TEMPLATE_TEXT_TOO_LARGE,
-                message: ERROR_MESSAGES.TEMPLATE_TEXT_TOO_LARGE,
-            };
+        if (data.bodies !== undefined) {
+            const bodies_check = validate_template_bodies_size(data.bodies);
+            if (!bodies_check.ok) {
+                return {
+                    success: false,
+                    error: ERROR_MESSAGES.TEMPLATE_HTML_TOO_LARGE,
+                    message: `Template body "${bodies_check.offending_key}" exceeds size limit`,
+                };
+            }
         }
         const patch = {
             changed_at: new Date().toISOString(),
@@ -434,10 +421,8 @@ export async function update_template(hazo_connect, id, data) {
             patch.template_category_id = data.template_category_id;
         if (data.template_variables !== undefined)
             patch.template_variables = data.template_variables;
-        if (data.template_html !== undefined)
-            patch.template_html = data.template_html;
-        if (data.template_text !== undefined)
-            patch.template_text = data.template_text;
+        if (data.bodies !== undefined)
+            patch.bodies = data.bodies;
         if (data.is_modified !== undefined)
             patch.is_modified = data.is_modified;
         const template = await hazo_connect.updateById(TABLE_TEMPLATES, id, patch);