hazo_notify 5.0.1 → 5.3.1

package/dist/lib/jobs/digest.js

@@ -0,0 +1,127 @@
+/**
+ * Digest flush job handler factory.
+ *
+ * Claims all channel_deliveries rows with status='digesting', groups them by
+ * (user_id, channel_id), and fires one `send` call per group. Intended to be
+ * registered with hazo_jobs against `DIGEST_FLUSH_JOB_TYPE`.
+ *
+ * @packageDocumentation
+ */
+import { QueryBuilder } from "hazo_connect/server";
+import { getInboxConnection } from "../inbox/connection.js";
+import { send_template_email } from "../template_manager/template_manager.js";
+/** Stable job type registered with hazo_jobs. */
+export const DIGEST_FLUSH_JOB_TYPE = "hazo_notify.digest_flush";
+/**
+ * Factory that creates a hazo_jobs-compatible handler for digest flush.
+ *
+ * The handler:
+ * 1. Claims all deliveries with status='digesting' up to `batch_size`.
+ * 2. Enriches each row with user_id from hazo_notify_inbox when not already
+ *    present on the claimed row.
+ * 3. Groups rows by (user_id, channel_id).
+ * 4. Fires one `_send` call per group, then marks each row sent/failed.
+ */
+export function createDigestFlushHandler(opts) {
+    const default_batch_size = opts.batch_size ?? 500;
+    return async function digest_flush_handler(job) {
+        const payload = typeof job.payload === "string"
+            ? JSON.parse(job.payload)
+            : (job.payload ?? {});
+        const batch_size = payload.batch_size ?? default_batch_size;
+        // Resolve adapter: injected (tests) or live connection.
+        const adapter = opts._adapter ?? getInboxConnection();
+        // Resolve send function: injected (tests) or real send_template_email.
+        // The `hazo_connect` arg is typed as `unknown` in DigestSendFn so the
+        // handler works with both the real HazoConnectAdapter (production) and test
+        // doubles. The production wrapper casts through `unknown` to satisfy
+        // send_template_email's HazoConnectInstance parameter — both types expose
+        // an equivalent query surface in practice.
+        const send_fn = opts._send ??
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            ((options, hazo_connect) => send_template_email(options, hazo_connect));
+        // --- Step 1: Claim digesting rows ---
+        const claimed_rows = await adapter.claimRows({
+            table: "hazo_notify_channel_deliveries",
+            where: { status: "digesting" },
+            set: {
+                attempt_count: { increment: 1 },
+                updated_at: { $now: true },
+            },
+            returning: ["id", "inbox_id", "channel_id", "payload"],
+            limit: batch_size,
+            orderBy: { column: "created_at", direction: "asc" },
+        });
+        if (claimed_rows.length === 0)
+            return;
+        // --- Step 2: Enrich rows with user_id ---
+        const enriched = await Promise.all(claimed_rows.map(async (row) => {
+            // If the claimed row already carries user_id (e.g. from a mock or a
+            // JOIN-capable adapter), use it directly — no extra query needed.
+            if (row.user_id) {
+                return row;
+            }
+            // Otherwise look up user_id from the originating inbox row.
+            const inbox_rows = (await adapter.query(new QueryBuilder()
+                .from("hazo_notify_inbox")
+                .select("user_id")
+                .where("id", "eq", row.inbox_id), "GET"));
+            return {
+                ...row,
+                user_id: inbox_rows[0]?.user_id ?? "unknown",
+            };
+        }));
+        // --- Step 3: Group by (user_id, channel_id) ---
+        const groups = new Map();
+        for (const row of enriched) {
+            const key = `${row.user_id}::${row.channel_id}`;
+            const group = groups.get(key) ?? [];
+            group.push(row);
+            groups.set(key, group);
+        }
+        // --- Step 4: Send once per group, then mark rows sent/failed ---
+        await Promise.all(Array.from(groups.entries()).map(async ([, rows]) => {
+            const { user_id, channel_id } = rows[0];
+            const row_ids = rows.map((r) => r.id);
+            let send_succeeded = false;
+            try {
+                const recipient = await opts.resolve_recipient(user_id);
+                const row_payloads = rows.map((r) => typeof r.payload === "string"
+                    ? JSON.parse(r.payload)
+                    : (r.payload ?? {}));
+                const variables = {
+                    user_id,
+                    channel_id,
+                    digest_count: String(rows.length),
+                    digest_date: new Date().toISOString().slice(0, 10),
+                    ...opts.template_variables,
+                };
+                const result = await send_fn({
+                    template_name: opts.template_name,
+                    variables,
+                    to: recipient,
+                    scope_id: opts.scope_id ?? null,
+                }, adapter);
+                send_succeeded = result.success;
+            }
+            catch {
+                send_succeeded = false;
+            }
+            // Mark each row in the group as sent or failed.
+            const new_status = send_succeeded ? "sent" : "failed";
+            const finalized_at = new Date().toISOString();
+            await Promise.all(row_ids.map((id) => adapter.claimRows({
+                table: "hazo_notify_channel_deliveries",
+                where: { id },
+                set: {
+                    status: new_status,
+                    finalized_at,
+                    updated_at: { $now: true },
+                },
+                returning: ["id"],
+                limit: 1,
+            })));
+        }));
+    };
+}
+//# sourceMappingURL=digest.js.map

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

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

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

@@ -13,4 +13,6 @@ export { createInboxFlushHandler } from "./handler.js";
 export type { CreateInboxFlushHandlerOptions } from "./handler.js";
 export { submitInboxFlushJobs } from "./submit.js";
 export type { SubmitInboxFlushJobsParams } from "./submit.js";
+export { DIGEST_FLUSH_JOB_TYPE, createDigestFlushHandler, } from "./digest.js";
+export type { DigestFlushPayload, CreateDigestFlushHandlerOptions, } from "./digest.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC9D,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,+BAA+B,GAChC,MAAM,aAAa,CAAC"}

package/dist/lib/jobs/index.js

@@ -10,4 +10,5 @@
 export { INBOX_FLUSH_JOB_TYPE, } from "./types.js";
 export { createInboxFlushHandler } from "./handler.js";
 export { submitInboxFlushJobs } from "./submit.js";
+export { DIGEST_FLUSH_JOB_TYPE, createDigestFlushHandler, } from "./digest.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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;AAEnD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

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

@@ -1 +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"}
+{"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,CAe/B"}

package/dist/lib/jobs/submit.js

@@ -16,6 +16,7 @@ export async function submitInboxFlushJobs(jobs, params) {
             : { channel_id };
         const { jobId } = await jobs.submit({
             type: INBOX_FLUSH_JOB_TYPE,
+            description: `inbox-flush:${channel_id}`,
             payload,
         });
         jobIds.push(jobId);

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

@@ -1 +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"}
+{"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,WAAW,EAAE,eAAe,UAAU,EAAE;YACxC,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

@@ -31,6 +31,7 @@ export type HazoJobHandler<P = unknown, R = unknown> = (job: HazoJob<P>, log?: H
 export interface HazoJobsSubmitter {
     submit(opts: {
         type: string;
+        description?: string;
         payload?: unknown;
         priority?: number;
         maxAttempts?: number;

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

@@ -1 +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"}
+{"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,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,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/lifecycle/default_templates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Default system template manifests for the lifecycle module.
+ *
+ * Consumers call `sync_system_templates(hazo_connect, lifecycleDefaultTemplates)`
+ * at boot to upsert these templates into the database.
+ */
+import type { SystemTemplateManifest } from '../template_manager/types.js';
+export declare const lifecycleDefaultTemplates: SystemTemplateManifest[];
+//# sourceMappingURL=default_templates.d.ts.map

package/dist/lib/lifecycle/default_templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_templates.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/default_templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA8B,MAAM,8BAA8B,CAAC;AA8DvG,eAAO,MAAM,yBAAyB,EAAE,sBAAsB,EA8I7D,CAAC"}

package/dist/lib/lifecycle/default_templates.js

@@ -0,0 +1,196 @@
+/**
+ * Default system template manifests for the lifecycle module.
+ *
+ * Consumers call `sync_system_templates(hazo_connect, lifecycleDefaultTemplates)`
+ * at boot to upsert these templates into the database.
+ */
+// ---------------------------------------------------------------------------
+// Shared HTML/text body templates
+// ---------------------------------------------------------------------------
+const MAIN_HTML = `<!doctype html>
+<html lang="en">
+  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width" /><title>{{headline}}</title></head>
+  <body style="margin:0;background:#f9f9f9;font-family:Arial,sans-serif;color:#1a1a1a;">
+    <table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f9f9f9;padding:32px 16px;">
+      <tr><td align="center">
+        <table role="presentation" width="520" cellpadding="0" cellspacing="0" style="background:#ffffff;border:1px solid #e5e5e5;border-radius:12px;padding:32px;max-width:520px;">
+          <tr><td>
+            <div style="font-size:20px;font-weight:600;color:#333;margin-bottom:16px;">{{app_name}}</div>
+            <h1 style="font-size:22px;line-height:1.25;color:#1a1a1a;font-weight:600;margin:0 0 16px;">{{headline}}</h1>
+            <p style="font-size:16px;line-height:1.6;color:#1a1a1a;margin:0 0 24px;">{{body}}</p>
+            <p style="margin:0 0 24px;"><a href="{{{cta_url}}}" style="display:inline-block;background:#3730a3;color:#ffffff;text-decoration:none;font-weight:600;font-size:15px;padding:12px 22px;border-radius:8px;">{{cta_label}}</a></p>
+            <p style="font-size:14px;line-height:1.6;color:#1a1a1a;margin:0;">{{signoff}}</p>
+          </td></tr>
+        </table>
+        <p style="font-size:12px;line-height:1.5;color:#888;max-width:520px;margin:18px auto 0;text-align:center;">{{footer}}</p>
+        <p style="font-size:12px;line-height:1.5;color:#888;max-width:520px;margin:8px auto 0;text-align:center;">{{{stop_tips_url_html}}}</p>
+      </td></tr>
+    </table>
+  </body>
+</html>`;
+const MAIN_TEXT = `{{headline}}
+
+{{body}}
+
+{{cta_label}}: {{{cta_url}}}
+
+{{signoff}}
+
+{{footer}}
+
+---
+Don't want these tips? Unsubscribe: {{stop_tips_url}}`;
+// ---------------------------------------------------------------------------
+// Shared variable lists
+// ---------------------------------------------------------------------------
+const MAIN_VARIABLES = [
+    { variable_name: 'first_name', variable_description: "Recipient's first name" },
+    { variable_name: 'app_name', variable_description: 'Application name' },
+    { variable_name: 'headline', variable_description: 'Email headline' },
+    { variable_name: 'body', variable_description: 'Email body paragraph' },
+    { variable_name: 'cta_url', variable_description: 'Call-to-action URL' },
+    { variable_name: 'cta_label', variable_description: 'Call-to-action button label' },
+    { variable_name: 'signoff', variable_description: 'Closing salutation' },
+    { variable_name: 'footer', variable_description: 'Footer legal/contact text' },
+    { variable_name: 'stop_tips_url', variable_description: 'Signed URL for opt-out' },
+    { variable_name: 'stop_tips_url_html', variable_description: 'Pre-rendered HTML opt-out link fragment' },
+];
+// ---------------------------------------------------------------------------
+// Template manifests
+// ---------------------------------------------------------------------------
+export const lifecycleDefaultTemplates = [
+    // 1. Welcome
+    {
+        template_name: 'lifecycle-welcome',
+        template_label: 'Welcome',
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: [
+            ...MAIN_VARIABLES,
+            { variable_name: 'subject_a', variable_description: 'A/B subject line variant A' },
+            { variable_name: 'subject_b', variable_description: 'A/B subject line variant B' },
+        ],
+    },
+    // 2. Tree waiting
+    {
+        template_name: 'lifecycle-tree-waiting',
+        template_label: 'Your space is waiting',
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: MAIN_VARIABLES,
+    },
+    // 3. Bring existing tree
+    {
+        template_name: 'lifecycle-bring-existing-tree',
+        template_label: 'Already have a tree elsewhere?',
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: MAIN_VARIABLES,
+    },
+    // 4. Invite family
+    {
+        template_name: 'lifecycle-invite-family',
+        template_label: "Don't keep it to yourself",
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: MAIN_VARIABLES,
+    },
+    // 5. Milestone — map unlocked
+    {
+        template_name: 'lifecycle-milestone-map-unlocked',
+        template_label: 'Your family is on the map',
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: MAIN_VARIABLES,
+    },
+    // 6. Milestone — first photo
+    {
+        template_name: 'lifecycle-milestone-first-photo',
+        template_label: 'First photo is up',
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: MAIN_VARIABLES,
+    },
+    // 7. Milestone — first invite accepted
+    {
+        template_name: 'lifecycle-milestone-first-invite-accepted',
+        template_label: "You've got family with you",
+        category: 'Lifecycle',
+        bodies: {
+            html: MAIN_HTML,
+            text: MAIN_TEXT,
+        },
+        variables: [
+            ...MAIN_VARIABLES,
+            { variable_name: 'invitee_name', variable_description: 'Name of the invited user who joined' },
+        ],
+    },
+    // 8. Footer fragment — stop tips
+    {
+        template_name: 'lifecycle-footer-stop-tips',
+        template_label: 'Stop lifecycle tips (footer fragment)',
+        category: 'Lifecycle',
+        bodies: {
+            html: `<p style="font-size:12px;color:#888;">Don't want these tips? <a href="{{{stop_tips_url}}}">Stop</a>.</p>`,
+            text: `Don't want these tips? Stop: {{stop_tips_url}}`,
+        },
+        variables: [
+            { variable_name: 'stop_tips_url', variable_description: 'Signed URL for opt-out' },
+        ],
+    },
+    // 9. Daily digest
+    {
+        template_name: 'digest_daily',
+        template_label: 'Daily Digest',
+        category: 'System',
+        bodies: {
+            html: `<!doctype html>
+<html lang="en">
+  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width" /><title>Daily Digest</title></head>
+  <body style="margin:0;background:#f9f9f9;font-family:Arial,sans-serif;color:#1a1a1a;">
+    <table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f9f9f9;padding:32px 16px;">
+      <tr><td align="center">
+        <table role="presentation" width="520" cellpadding="0" cellspacing="0" style="background:#ffffff;border:1px solid #e5e5e5;border-radius:12px;padding:32px;max-width:520px;">
+          <tr><td>
+            <h1 style="font-size:22px;line-height:1.25;color:#1a1a1a;font-weight:600;margin:0 0 16px;">Daily Digest</h1>
+            <p style="font-size:15px;line-height:1.6;color:#1a1a1a;margin:0 0 16px;">Hello,</p>
+            <p style="font-size:15px;line-height:1.6;color:#1a1a1a;margin:0 0 24px;">You have <strong>{{digest_count}}</strong> pending notification(s) for <strong>{{channel_id}}</strong> on <strong>{{digest_date}}</strong>.</p>
+            <p style="font-size:14px;line-height:1.6;color:#666;margin:0;">Visit your inbox to review them.</p>
+          </td></tr>
+        </table>
+      </td></tr>
+    </table>
+  </body>
+</html>`,
+            text: `Daily Digest
+
+You have {{digest_count}} pending notification(s) for {{channel_id}} on {{digest_date}}.
+
+Visit your inbox to review them.`,
+        },
+        variables: [
+            { variable_name: 'digest_count', variable_description: 'Number of pending notifications in the digest' },
+            { variable_name: 'channel_id', variable_description: 'Channel identifier (e.g., email, in_app)' },
+            { variable_name: 'digest_date', variable_description: 'Date of the digest (YYYY-MM-DD)' },
+        ],
+    },
+];
+//# sourceMappingURL=default_templates.js.map

package/dist/lib/lifecycle/default_templates.js.map

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

package/dist/lib/lifecycle/dispatch.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Dispatch wrapper for lifecycle email steps.
+ *
+ * Wraps `send_template_email` with lifecycle-specific context. In v1,
+ * locale resolution happens at the template-lookup level via
+ * `get_template_by_name` (which accepts an optional `locale` param).
+ * `send_template_email` does not currently expose a `locale` parameter, so
+ * the `locale` option here is noted for future use — template resolution will
+ * fall back to the default locale until that param is threaded through.
+ *
+ * @packageDocumentation
+ */
+import type { HazoConnectInstance } from '../template_manager/types.js';
+export interface DispatchStepOptions {
+    hazo_connect: HazoConnectInstance;
+    user_id: string;
+    template_name: string;
+    variables: Record<string, string>;
+    to: string;
+    scope_id?: string | null;
+    /**
+     * Locale hint. v1: not yet forwarded to send_template_email (which does not
+     * accept locale). Template resolution defaults to the global locale.
+     * TODO: thread through once send_template_email exposes a locale param.
+     */
+    locale?: string | null;
+    /** Override the template's stored subject line (used for A/B testing). */
+    subject_override?: string | null;
+}
+/**
+ * Dispatch a lifecycle email step.
+ *
+ * Throws if `send_template_email` returns a non-success response so callers
+ * can catch and mark the status row as failed.
+ */
+export declare function dispatchStep(opts: DispatchStepOptions): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/lib/lifecycle/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3E"}

package/dist/lib/lifecycle/dispatch.js

@@ -0,0 +1,32 @@
+/**
+ * Dispatch wrapper for lifecycle email steps.
+ *
+ * Wraps `send_template_email` with lifecycle-specific context. In v1,
+ * locale resolution happens at the template-lookup level via
+ * `get_template_by_name` (which accepts an optional `locale` param).
+ * `send_template_email` does not currently expose a `locale` parameter, so
+ * the `locale` option here is noted for future use — template resolution will
+ * fall back to the default locale until that param is threaded through.
+ *
+ * @packageDocumentation
+ */
+import { send_template_email } from '../template_manager/template_manager.js';
+/**
+ * Dispatch a lifecycle email step.
+ *
+ * Throws if `send_template_email` returns a non-success response so callers
+ * can catch and mark the status row as failed.
+ */
+export async function dispatchStep(opts) {
+    const result = await send_template_email({
+        template_name: opts.template_name,
+        variables: opts.variables,
+        to: opts.to,
+        scope_id: opts.scope_id ?? null,
+        ...(opts.subject_override ? { subject: opts.subject_override } : {}),
+    }, opts.hazo_connect);
+    if (!result.success) {
+        throw new Error(result.error ?? `send_template_email failed for template '${opts.template_name}'`);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/lib/lifecycle/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAoB9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CACtC;QACE,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,EACD,IAAI,CAAC,YAAY,CAClB,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,KAAK,IAAI,4CAA4C,IAAI,CAAC,aAAa,GAAG,CAClF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/lifecycle/events.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `recordEvent` implementation for lifecycle sequences.
+ *
+ * When a product event fires (e.g. "user_added_first_person"), this module
+ * scans all sequences for matching event-triggered steps, loads their status
+ * rows, and dispatches any that are still in `scheduled` state.
+ *
+ * Deduplication contract:
+ * - If the status row is 'sent' → no-op (already dispatched).
+ * - If the status row is not found → no-op (user never started the sequence).
+ * - If the status row is 'skipped' or 'failed' → no-op (terminal state).
+ * - Only 'scheduled' rows trigger dispatch.
+ *
+ * @packageDocumentation
+ */
+import type { LifecycleSchedulerOptions } from './types.js';
+/**
+ * Fire all event-triggered steps whose `event_kind` matches the emitted event.
+ *
+ * Scans every sequence in `opts.sequences` (or only `sequence_id` if supplied)
+ * for steps with `trigger.kind === 'event' && trigger.event_kind === event_kind`.
+ * For each match, loads the status row and dispatches if status is `scheduled`.
+ *
+ * @param opts - Scheduler options (hazo_connect, resolvers, sequences, etc.)
+ * @param get_user_email - Async function that resolves the email address for user_id.
+ * @param params - Event parameters from the caller.
+ */
+export declare function recordEvent(opts: LifecycleSchedulerOptions, get_user_email: (user_id: string) => Promise<string>, params: {
+    user_id: string;
+    event_kind: string;
+    sequence_id?: string;
+    payload?: Record<string, unknown>;
+}): Promise<void>;
+//# sourceMappingURL=events.d.ts.map

package/dist/lib/lifecycle/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,yBAAyB,EAC/B,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACpD,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACA,OAAO,CAAC,IAAI,CAAC,CAgHf"}