hazo_notify 5.0.0 → 5.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAsB7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * `registerLifecycleHandlers` — wires the lifecycle step handler into a
+ * hazo_jobs scheduler instance.
+ *
+ * Call this once at worker startup, before the scheduler begins consuming jobs.
+ * Re-registering the same type is idempotent (hazo_jobs replaces the handler).
+ *
+ * Example:
+ * ```ts
+ * import { createLifecycleScheduler, registerLifecycleHandlers } from 'hazo_notify/lifecycle';
+ *
+ * const lifecycle = createLifecycleScheduler(opts, getUserEmail);
+ * registerLifecycleHandlers(lifecycle, jobsScheduler);
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { LifecycleScheduler, HazoJobHandler, LifecycleStepPayload } from './types.js';
+/**
+ * Register the lifecycle step handler with a hazo_jobs-compatible scheduler.
+ *
+ * @param lifecycle - The `LifecycleScheduler` returned by `createLifecycleScheduler`.
+ * @param jobsScheduler - Any object with a `register(type, handler)` method
+ *   (structural match for hazo_jobs `Scheduler`).
+ */
+export declare function registerLifecycleHandlers(lifecycle: LifecycleScheduler, jobsScheduler: {
+    register(type: string, handler: HazoJobHandler<LifecycleStepPayload>): void;
+}): void;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,aAAa,EAAE;IACb,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAC5C,IAAI,CAAC;CACT,GACA,IAAI,CAKN"}

package/dist/lib/lifecycle/register.js

@@ -0,0 +1,29 @@
+/**
+ * `registerLifecycleHandlers` — wires the lifecycle step handler into a
+ * hazo_jobs scheduler instance.
+ *
+ * Call this once at worker startup, before the scheduler begins consuming jobs.
+ * Re-registering the same type is idempotent (hazo_jobs replaces the handler).
+ *
+ * Example:
+ * ```ts
+ * import { createLifecycleScheduler, registerLifecycleHandlers } from 'hazo_notify/lifecycle';
+ *
+ * const lifecycle = createLifecycleScheduler(opts, getUserEmail);
+ * registerLifecycleHandlers(lifecycle, jobsScheduler);
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { LIFECYCLE_STEP_JOB_TYPE } from './scheduler.js';
+/**
+ * Register the lifecycle step handler with a hazo_jobs-compatible scheduler.
+ *
+ * @param lifecycle - The `LifecycleScheduler` returned by `createLifecycleScheduler`.
+ * @param jobsScheduler - Any object with a `register(type, handler)` method
+ *   (structural match for hazo_jobs `Scheduler`).
+ */
+export function registerLifecycleHandlers(lifecycle, jobsScheduler) {
+    jobsScheduler.register(LIFECYCLE_STEP_JOB_TYPE, lifecycle.__jobHandler);
+}
+//# sourceMappingURL=register.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAA6B,EAC7B,aAKC;IAED,aAAa,CAAC,QAAQ,CACpB,uBAAuB,EACvB,SAAS,CAAC,YAAY,CACvB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Condition evaluation engine for lifecycle steps.
+ *
+ * Evaluates a `ConditionNode` graph against the named resolvers supplied at
+ * scheduler construction time. The top-level `evaluateConditions` function
+ * treats the array as an implicit AND — all nodes must pass.
+ *
+ * @packageDocumentation
+ */
+import type { ConditionNode, LifecycleSchedulerOptions } from './types.js';
+type Resolvers = LifecycleSchedulerOptions['resolvers'];
+/**
+ * Evaluate a list of top-level condition nodes as an implicit AND.
+ *
+ * @returns `{ pass: true }` when all conditions pass, or `{ pass: false, reason }`.
+ */
+export declare function evaluateConditions(conditions: ConditionNode[], resolvers: Resolvers, user_id: string): Promise<{
+    pass: boolean;
+    reason?: string;
+}>;
+export {};
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,aAAa,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEtF,KAAK,SAAS,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;AAMxD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,aAAa,EAAE,EAC3B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7C"}

package/dist/lib/lifecycle/resolver.js

@@ -0,0 +1,105 @@
+/**
+ * Condition evaluation engine for lifecycle steps.
+ *
+ * Evaluates a `ConditionNode` graph against the named resolvers supplied at
+ * scheduler construction time. The top-level `evaluateConditions` function
+ * treats the array as an implicit AND — all nodes must pass.
+ *
+ * @packageDocumentation
+ */
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * Evaluate a list of top-level condition nodes as an implicit AND.
+ *
+ * @returns `{ pass: true }` when all conditions pass, or `{ pass: false, reason }`.
+ */
+export async function evaluateConditions(conditions, resolvers, user_id) {
+    for (const node of conditions) {
+        const result = await evaluateNode(node, resolvers, user_id);
+        if (!result.pass) {
+            return result;
+        }
+    }
+    return { pass: true };
+}
+// ============================================================
+// Internal helpers
+// ============================================================
+async function evaluateNode(node, resolvers, user_id) {
+    if ('kind' in node) {
+        switch (node.kind) {
+            case 'and': {
+                for (const child of node.conditions) {
+                    const r = await evaluateNode(child, resolvers, user_id);
+                    if (!r.pass)
+                        return r;
+                }
+                return { pass: true };
+            }
+            case 'or': {
+                let last_reason;
+                for (const child of node.conditions) {
+                    const r = await evaluateNode(child, resolvers, user_id);
+                    if (r.pass)
+                        return { pass: true };
+                    last_reason = r.reason;
+                }
+                return { pass: false, reason: last_reason ?? 'or_all_failed' };
+            }
+            case 'not': {
+                const r = await evaluateNode(node.condition, resolvers, user_id);
+                return r.pass
+                    ? { pass: false, reason: 'not_condition_passed' }
+                    : { pass: true };
+            }
+        }
+    }
+    // Leaf condition
+    return evaluateLeaf(node, resolvers, user_id);
+}
+async function evaluateLeaf(condition, resolvers, user_id) {
+    const resolver = resolvers[condition.resolver];
+    if (!resolver) {
+        return {
+            pass: false,
+            reason: `unknown_resolver:${condition.resolver}`,
+        };
+    }
+    let actual;
+    try {
+        actual = await resolver(user_id, condition.args);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { pass: false, reason: `resolver_error:${condition.resolver}:${msg}` };
+    }
+    const pass = compare(actual, condition.op, condition.value);
+    if (!pass) {
+        return {
+            pass: false,
+            reason: `condition_failed:${condition.resolver}:${condition.op}:${String(actual)}!=${String(condition.value)}`,
+        };
+    }
+    return { pass: true };
+}
+/**
+ * Compare `actual` to `expected` using the given operator.
+ * Works on numbers and booleans; falls back to strict equality for other types.
+ */
+function compare(actual, op, expected) {
+    switch (op) {
+        case 'eq':
+            return actual === expected;
+        case 'lt':
+            return actual < expected;
+        case 'lte':
+            return actual <= expected;
+        case 'gt':
+            return actual > expected;
+        case 'gte':
+            return actual >= expected;
+    }
+}
+//# sourceMappingURL=resolver.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * `createLifecycleScheduler` factory.
+ *
+ * Returns a `LifecycleScheduler` that manages the full lifecycle of a
+ * multi-step email sequence per user: starting sequences, recording events,
+ * and reading status.
+ *
+ * @packageDocumentation
+ */
+import type { LifecycleScheduler, LifecycleSchedulerOptions } from './types.js';
+/**
+ * Job type string registered with hazo_jobs for deferred lifecycle steps.
+ * Re-exported from `hazo_notify/lifecycle` for consumer use.
+ */
+export declare const LIFECYCLE_STEP_JOB_TYPE = "hazo_notify:lifecycle_step";
+/**
+ * Create a lifecycle scheduler.
+ *
+ * The returned `LifecycleScheduler` should be created once at application
+ * startup and reused across requests. Callers must supply a `get_user_email`
+ * function so the scheduler can resolve recipient addresses at dispatch time.
+ *
+ * @param opts - Scheduler configuration.
+ * @param get_user_email - Async resolver from user_id to email address.
+ */
+export declare function createLifecycleScheduler(opts: LifecycleSchedulerOptions, get_user_email: (user_id: string) => Promise<string>): LifecycleScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAcpE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,yBAAyB,EAC/B,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACnD,kBAAkB,CAmGpB"}

package/dist/lib/lifecycle/scheduler.js

@@ -0,0 +1,108 @@
+/**
+ * `createLifecycleScheduler` factory.
+ *
+ * Returns a `LifecycleScheduler` that manages the full lifecycle of a
+ * multi-step email sequence per user: starting sequences, recording events,
+ * and reading status.
+ *
+ * @packageDocumentation
+ */
+import { insertStatusRow, queryStatusRows } from './status.js';
+import { recordEvent as _recordEvent } from './events.js';
+import { createLifecycleStepHandler } from './handler.js';
+/**
+ * Job type string registered with hazo_jobs for deferred lifecycle steps.
+ * Re-exported from `hazo_notify/lifecycle` for consumer use.
+ */
+export const LIFECYCLE_STEP_JOB_TYPE = 'hazo_notify:lifecycle_step';
+/**
+ * Detect UNIQUE / duplicate-key violation errors from Postgres (PostgREST),
+ * SQLite (better-sqlite3), and generic RDBMS drivers.
+ *
+ * PostgREST returns HTTP 409 with "duplicate key" in the message body.
+ * better-sqlite3 throws "UNIQUE constraint failed".
+ */
+function is_unique_violation(err) {
+    const msg = err instanceof Error ? err.message.toLowerCase() : String(err).toLowerCase();
+    return msg.includes('unique') || msg.includes('duplicate');
+}
+/**
+ * Create a lifecycle scheduler.
+ *
+ * The returned `LifecycleScheduler` should be created once at application
+ * startup and reused across requests. Callers must supply a `get_user_email`
+ * function so the scheduler can resolve recipient addresses at dispatch time.
+ *
+ * @param opts - Scheduler configuration.
+ * @param get_user_email - Async resolver from user_id to email address.
+ */
+export function createLifecycleScheduler(opts, get_user_email) {
+    const job_handler = createLifecycleStepHandler(opts, get_user_email);
+    async function start({ user_id, sequence_id, }) {
+        const steps = opts.sequences[sequence_id];
+        if (!steps) {
+            throw new Error(`[lifecycle] sequence not found: '${sequence_id}'`);
+        }
+        const now = new Date();
+        for (const step of steps) {
+            // 1. Insert status row (idempotent — skip on unique violation).
+            let inserted_row;
+            try {
+                inserted_row = await insertStatusRow(opts.hazo_connect, {
+                    app_id: opts.app_id,
+                    user_id,
+                    sequence_id,
+                    step_id: step.id,
+                    status: 'scheduled',
+                    sent_at: null,
+                    skip_reason: null,
+                    job_id: null,
+                    failure_message: null,
+                });
+            }
+            catch (err) {
+                if (is_unique_violation(err)) {
+                    // Already started — idempotent no-op for this step.
+                    continue;
+                }
+                throw err;
+            }
+            // 2. For time-triggered steps, submit a deferred job.
+            if (step.trigger.kind === 'time') {
+                const run_at = new Date(now.getTime() + step.trigger.offset_seconds * 1000).toISOString();
+                const { jobId } = await opts.jobs.submit({
+                    type: LIFECYCLE_STEP_JOB_TYPE,
+                    payload: {
+                        status_row_id: inserted_row.id,
+                        app_id: opts.app_id,
+                        user_id,
+                        sequence_id,
+                        step_id: step.id,
+                    },
+                    runAt: run_at,
+                });
+                // Persist job_id on the status row so it can be correlated later.
+                try {
+                    await opts.hazo_connect.updateById('hazo_notify_lifecycle_status', inserted_row.id, { job_id: jobId });
+                }
+                catch {
+                    // Non-fatal: the job was still submitted. job_id is cosmetic.
+                }
+            }
+            // Event-triggered steps: no job submitted — they fire via recordEvent().
+        }
+    }
+    async function recordEventPublic(params) {
+        return _recordEvent(opts, get_user_email, params);
+    }
+    async function getStatus({ user_id, sequence_id, }) {
+        return queryStatusRows(opts.hazo_connect, opts.app_id, user_id, sequence_id);
+    }
+    return {
+        start,
+        recordEvent: recordEventPublic,
+        getStatus,
+        __jobHandler: job_handler,
+    };
+}
+//# sourceMappingURL=scheduler.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * CRUD helpers for the `hazo_notify_lifecycle_status` table.
+ *
+ * All functions accept a `HazoConnectInstance` so they work against any
+ * conforming adapter (PostgREST, direct Postgres, SQLite test doubles, etc.).
+ *
+ * @packageDocumentation
+ */
+import type { HazoConnectInstance } from '../template_manager/types.js';
+import type { LifecycleStatusRow } from './types.js';
+/**
+ * Insert a new lifecycle status row.
+ *
+ * The caller must NOT supply `id`, `scheduled_at`, `attempt_count`, or
+ * `dispatch_meta` — those are set by the DB default or left as NULL.
+ */
+export declare function insertStatusRow(hazo_connect: HazoConnectInstance, row: Omit<LifecycleStatusRow, 'id' | 'scheduled_at' | 'attempt_count' | 'dispatch_meta'>): Promise<LifecycleStatusRow>;
+/**
+ * Load a single status row by primary key.
+ * Returns `null` if not found.
+ */
+export declare function loadStatusRow(hazo_connect: HazoConnectInstance, id: string): Promise<LifecycleStatusRow | null>;
+/**
+ * Partial update a status row by primary key.
+ * The `patch` may include any subset of `LifecycleStatusRow` fields.
+ */
+export declare function updateStatusRow(hazo_connect: HazoConnectInstance, id: string, patch: Partial<LifecycleStatusRow>): Promise<void>;
+/**
+ * Query status rows for a (app_id, user_id) pair, optionally filtered to one
+ * sequence. Returns rows ordered by `scheduled_at` ascending.
+ */
+export declare function queryStatusRows(hazo_connect: HazoConnectInstance, app_id: string, user_id: string, sequence_id?: string): Promise<LifecycleStatusRow[]>;
+/**
+ * Find a single status row for a specific (app_id, user_id, sequence_id, step_id).
+ * Used by `recordEvent` to locate event-triggered steps.
+ * Returns `null` if not found.
+ */
+export declare function findEventStepRow(hazo_connect: HazoConnectInstance, app_id: string, user_id: string, sequence_id: string, step_id: string): Promise<LifecycleStatusRow | null>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC,GACvF,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAe/B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAapC"}

package/dist/lib/lifecycle/status.js

@@ -0,0 +1,67 @@
+/**
+ * CRUD helpers for the `hazo_notify_lifecycle_status` table.
+ *
+ * All functions accept a `HazoConnectInstance` so they work against any
+ * conforming adapter (PostgREST, direct Postgres, SQLite test doubles, etc.).
+ *
+ * @packageDocumentation
+ */
+const TABLE = 'hazo_notify_lifecycle_status';
+/**
+ * Insert a new lifecycle status row.
+ *
+ * The caller must NOT supply `id`, `scheduled_at`, `attempt_count`, or
+ * `dispatch_meta` — those are set by the DB default or left as NULL.
+ */
+export async function insertStatusRow(hazo_connect, row) {
+    return hazo_connect.insert(TABLE, row);
+}
+/**
+ * Load a single status row by primary key.
+ * Returns `null` if not found.
+ */
+export async function loadStatusRow(hazo_connect, id) {
+    return hazo_connect.findById(TABLE, id);
+}
+/**
+ * Partial update a status row by primary key.
+ * The `patch` may include any subset of `LifecycleStatusRow` fields.
+ */
+export async function updateStatusRow(hazo_connect, id, patch) {
+    await hazo_connect.updateById(TABLE, id, patch);
+}
+/**
+ * Query status rows for a (app_id, user_id) pair, optionally filtered to one
+ * sequence. Returns rows ordered by `scheduled_at` ascending.
+ */
+export async function queryStatusRows(hazo_connect, app_id, user_id, sequence_id) {
+    let q = hazo_connect
+        .query()
+        .from(TABLE)
+        .select('*')
+        .where('app_id', 'eq', app_id)
+        .where('user_id', 'eq', user_id);
+    if (sequence_id !== undefined) {
+        q = q.where('sequence_id', 'eq', sequence_id);
+    }
+    q = q.order('scheduled_at', 'asc');
+    return hazo_connect.list(q);
+}
+/**
+ * Find a single status row for a specific (app_id, user_id, sequence_id, step_id).
+ * Used by `recordEvent` to locate event-triggered steps.
+ * Returns `null` if not found.
+ */
+export async function findEventStepRow(hazo_connect, app_id, user_id, sequence_id, step_id) {
+    const rows = await hazo_connect.list(hazo_connect
+        .query()
+        .from(TABLE)
+        .select('*')
+        .where('app_id', 'eq', app_id)
+        .where('user_id', 'eq', user_id)
+        .where('sequence_id', 'eq', sequence_id)
+        .where('step_id', 'eq', step_id)
+        .limit(1));
+    return rows[0] ?? null;
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,KAAK,GAAG,8BAA8B,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAiC,EACjC,GAAwF;IAExF,OAAO,YAAY,CAAC,MAAM,CAAqB,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,YAAiC,EACjC,EAAU;IAEV,OAAO,YAAY,CAAC,QAAQ,CAAqB,KAAK,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAiC,EACjC,EAAU,EACV,KAAkC;IAElC,MAAM,YAAY,CAAC,UAAU,CAAqB,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAiC,EACjC,MAAc,EACd,OAAe,EACf,WAAoB;IAEpB,IAAI,CAAC,GAAG,YAAY;SACjB,KAAK,EAAE;SACP,IAAI,CAAC,KAAK,CAAC;SACX,MAAM,CAAC,GAAG,CAAC;SACX,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC;SAC7B,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAEnC,OAAO,YAAY,CAAC,IAAI,CAAqB,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAiC,EACjC,MAAc,EACd,OAAe,EACf,WAAmB,EACnB,OAAe;IAEf,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAClC,YAAY;SACT,KAAK,EAAE;SACP,IAAI,CAAC,KAAK,CAAC;SACX,MAAM,CAAC,GAAG,CAAC;SACX,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC;SAC7B,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC;SAC/B,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC;SACvC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC;SAC/B,KAAK,CAAC,CAAC,CAAC,CACZ,CAAC;IACF,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,165 @@
+/**
+ * Type definitions for the hazo_notify lifecycle scheduler.
+ *
+ * Lifecycle sequences define time-triggered and event-triggered email steps
+ * with conditional dispatch logic. The scheduler manages status tracking and
+ * deferred job submission via hazo_jobs (optional peer dep).
+ *
+ * @packageDocumentation
+ */
+import type { HazoConnectInstance } from '../template_manager/types.js';
+import type { HazoJob, HazoJobLogger, HazoJobHandler } from '../jobs/types.js';
+export type { HazoConnectInstance, HazoJob, HazoJobLogger, HazoJobHandler };
+/**
+ * Structural subset of hazo_jobs `JobsClient.submit` extended with `runAt`
+ * for deferred scheduling. Declared locally so the lifecycle module does not
+ * import from `hazo_jobs` at runtime (optional peer dep).
+ */
+export interface HazoJobsSubmitter {
+    submit(opts: {
+        type: string;
+        payload?: unknown;
+        priority?: number;
+        maxAttempts?: number;
+        expiresInSec?: number;
+        /** ISO 8601 string for deferred execution. */
+        runAt?: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
+/** A time-based trigger fires after `offset_seconds` from sequence start. */
+export type LifecycleTrigger = {
+    kind: 'time';
+    offset_seconds: number;
+} | {
+    kind: 'event';
+    event_kind: string;
+};
+/**
+ * A leaf condition node. The `resolver` key names a function in
+ * `LifecycleSchedulerOptions.resolvers` that computes the current value
+ * for `user_id`. The result is compared against `value` using `op`.
+ */
+export interface Condition {
+    resolver: string;
+    op: 'eq' | 'lt' | 'lte' | 'gt' | 'gte';
+    value: unknown;
+    args?: Record<string, unknown>;
+}
+/** A composite condition node (boolean operators) or a leaf `Condition`. */
+export type ConditionNode = Condition | {
+    kind: 'and';
+    conditions: ConditionNode[];
+} | {
+    kind: 'or';
+    conditions: ConditionNode[];
+} | {
+    kind: 'not';
+    condition: ConditionNode;
+};
+/** A single step within a lifecycle sequence. */
+export interface LifecycleStep {
+    id: string;
+    trigger: LifecycleTrigger;
+    /** Template name to render and send when this step dispatches. */
+    template: string;
+    /**
+     * Top-level conditions evaluated as an implicit AND. All must pass for the
+     * step to dispatch. An empty array means "always dispatch".
+     */
+    conditions: ConditionNode[];
+}
+export interface LifecycleStatusRow {
+    id: string;
+    app_id: string;
+    user_id: string;
+    sequence_id: string;
+    step_id: string;
+    status: 'scheduled' | 'sent' | 'skipped' | 'failed';
+    scheduled_at: string;
+    sent_at: string | null;
+    skip_reason: string | null;
+    job_id: string | null;
+    failure_message: string | null;
+    attempt_count: number;
+    dispatch_meta: Record<string, unknown> | null;
+}
+export interface LifecycleSchedulerOptions {
+    /** DB adapter (from hazo_notify/template_manager). */
+    hazo_connect: HazoConnectInstance;
+    /**
+     * Structural hazo_jobs submitter. Must support `runAt` for deferred steps.
+     * Declared locally — no runtime `hazo_jobs` import.
+     */
+    jobs: HazoJobsSubmitter;
+    /** Application identifier stored on every status row. */
+    app_id: string;
+    /** Default locale for template resolution (v1: English only). */
+    default_locale?: string;
+    /**
+     * Named resolver functions. Each resolver receives a `user_id` and optional
+     * `args`, and returns the current value for that dimension (number, boolean,
+     * string, etc.). Used by the condition evaluator.
+     */
+    resolvers: Record<string, (user_id: string, args?: Record<string, unknown>) => Promise<unknown>>;
+    /**
+     * Optional opt-out check. When provided, the handler calls this before
+     * dispatching; if it returns `true`, the step is skipped with
+     * `skip_reason='opted_out'`.
+     */
+    is_opted_out?: (user_id: string) => Promise<boolean>;
+    /** Sequence definitions keyed by sequence_id. */
+    sequences: Record<string, LifecycleStep[]>;
+    /**
+     * Max job attempts before a step row is marked `failed`.
+     * Defaults to 3.
+     */
+    max_attempts?: number;
+    /**
+     * Optional per-user variable resolver. Called at dispatch time to supply
+     * extra template variables (e.g. personalised opt-out links). The returned
+     * object is merged with the base `variables` map; caller-supplied keys win.
+     */
+    get_variables?: (user_id: string, step_id: string) => Promise<Record<string, string>>;
+}
+export interface LifecycleScheduler {
+    /**
+     * Begin a sequence for a user. Inserts one status row per step and submits
+     * deferred jobs for time-triggered steps. Idempotent — duplicate calls for
+     * the same (user_id, sequence_id) are no-ops (unique constraint handling).
+     */
+    start(opts: {
+        user_id: string;
+        sequence_id: string;
+    }): Promise<void>;
+    /**
+     * Fire event-triggered steps. Scans all sequences for steps whose trigger
+     * matches `event_kind`, then dispatches any that are in `scheduled` state.
+     */
+    recordEvent(opts: {
+        user_id: string;
+        event_kind: string;
+        payload?: Record<string, unknown>;
+    }): Promise<void>;
+    /** Read status rows for a user, optionally filtered to one sequence. */
+    getStatus(opts: {
+        user_id: string;
+        sequence_id?: string;
+    }): Promise<LifecycleStatusRow[]>;
+    /**
+     * Internal hazo_jobs handler exposed so `registerLifecycleHandlers` can wire
+     * it in without reaching into scheduler internals. Not intended for direct
+     * consumer use.
+     */
+    __jobHandler: HazoJobHandler<LifecycleStepPayload>;
+}
+/** Payload submitted when a time-triggered lifecycle step is deferred. */
+export interface LifecycleStepPayload {
+    status_row_id: string;
+    app_id: string;
+    user_id: string;
+    sequence_id: string;
+    step_id: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/lifecycle/types.js

@@ -0,0 +1,11 @@
+/**
+ * Type definitions for the hazo_notify lifecycle scheduler.
+ *
+ * Lifecycle sequences define time-triggered and event-triggered email steps
+ * with conditional dispatch logic. The scheduler manages status tracking and
+ * deferred job submission via hazo_jobs (optional peer dep).
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map