hazo_notify 5.0.1 → 5.3.1

package/dist/lib/lifecycle/events.js

@@ -0,0 +1,118 @@
+/**
+ * `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 { createHash } from 'node:crypto';
+import { evaluateConditions } from './resolver.js';
+import { dispatchStep } from './dispatch.js';
+import { findEventStepRow, updateStatusRow } from './status.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 async function recordEvent(opts, get_user_email, params) {
+    const { user_id, event_kind } = params;
+    // Determine which sequence IDs to scan.
+    const sequence_ids = params.sequence_id
+        ? [params.sequence_id]
+        : Object.keys(opts.sequences);
+    for (const seq_id of sequence_ids) {
+        const steps = opts.sequences[seq_id];
+        if (!steps)
+            continue;
+        for (const step of steps) {
+            // Only process event-triggered steps matching the event_kind.
+            if (step.trigger.kind !== 'event' ||
+                step.trigger.event_kind !== event_kind) {
+                continue;
+            }
+            // Load the status row for this (app_id, user_id, sequence_id, step_id).
+            const row = await findEventStepRow(opts.hazo_connect, opts.app_id, user_id, seq_id, step.id);
+            if (!row) {
+                // User never started this sequence — no-op.
+                continue;
+            }
+            if (row.status === 'sent') {
+                // Already dispatched — dedupe.
+                continue;
+            }
+            if (row.status !== 'scheduled') {
+                // Skipped or failed — don't re-trigger.
+                continue;
+            }
+            // Opt-out check.
+            if (opts.is_opted_out) {
+                const opted_out = await opts.is_opted_out(user_id);
+                if (opted_out) {
+                    await updateStatusRow(opts.hazo_connect, row.id, {
+                        status: 'skipped',
+                        skip_reason: 'opted_out',
+                        attempt_count: row.attempt_count + 1,
+                    });
+                    continue;
+                }
+            }
+            // Evaluate conditions.
+            const condition_result = await evaluateConditions(step.conditions, opts.resolvers, user_id);
+            if (!condition_result.pass) {
+                await updateStatusRow(opts.hazo_connect, row.id, {
+                    status: 'skipped',
+                    skip_reason: `condition_failed:${condition_result.reason ?? 'unknown'}`,
+                    attempt_count: row.attempt_count + 1,
+                });
+                continue;
+            }
+            // Resolve recipient, extra variables, and dispatch.
+            const to = await get_user_email(user_id);
+            const raw_vars = opts.get_variables
+                ? await opts.get_variables(user_id, step.id)
+                : {};
+            let subject_override;
+            let ab_variant;
+            const { subject_a, subject_b, ...extra_vars } = raw_vars;
+            if (subject_a && subject_b) {
+                const hash_byte = createHash('sha256')
+                    .update(user_id + step.template)
+                    .digest()[0];
+                ab_variant = (hash_byte & 1) === 0 ? 'a' : 'b';
+                subject_override = ab_variant === 'a' ? subject_a : subject_b;
+            }
+            await dispatchStep({
+                hazo_connect: opts.hazo_connect,
+                user_id,
+                template_name: step.template,
+                variables: extra_vars,
+                to,
+                locale: opts.default_locale ?? null,
+                subject_override,
+            });
+            await updateStatusRow(opts.hazo_connect, row.id, {
+                status: 'sent',
+                sent_at: new Date().toISOString(),
+                attempt_count: row.attempt_count + 1,
+                ...(ab_variant
+                    ? { dispatch_meta: { ab_variant, subject: subject_override } }
+                    : {}),
+            });
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAA+B,EAC/B,cAAoD,EACpD,MAKC;IAED,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAEvC,wCAAwC;IACxC,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW;QACrC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,8DAA8D;YAC9D,IACE,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;gBAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,UAAU,EACtC,CAAC;gBACD,SAAS;YACX,CAAC;YAED,wEAAwE;YACxE,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAChC,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,EACX,OAAO,EACP,MAAM,EACN,IAAI,CAAC,EAAE,CACR,CAAC;YAEF,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,4CAA4C;gBAC5C,SAAS;YACX,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,+BAA+B;gBAC/B,SAAS;YACX,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC/B,wCAAwC;gBACxC,SAAS;YACX,CAAC;YAED,iBAAiB;YACjB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,EAAE;wBAC/C,MAAM,EAAE,SAAS;wBACjB,WAAW,EAAE,WAAW;wBACxB,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC;qBACrC,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,MAAM,gBAAgB,GAAG,MAAM,kBAAkB,CAC/C,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,EACd,OAAO,CACR,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;gBAC3B,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,EAAE;oBAC/C,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,oBAAoB,gBAAgB,CAAC,MAAM,IAAI,SAAS,EAAE;oBACvE,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC;iBACrC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,oDAAoD;YACpD,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa;gBACjC,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC5C,CAAC,CAAC,EAAE,CAAC;YAEP,IAAI,gBAAoC,CAAC;YACzC,IAAI,UAAiC,CAAC;YACtC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,QAAkC,CAAC;YACnF,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;qBACnC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;qBAC/B,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;gBACf,UAAU,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC/C,gBAAgB,GAAG,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,CAAC;YAED,MAAM,YAAY,CAAC;gBACjB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO;gBACP,aAAa,EAAE,IAAI,CAAC,QAAQ;gBAC5B,SAAS,EAAE,UAAU;gBACrB,EAAE;gBACF,MAAM,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;gBACnC,gBAAgB;aACjB,CAAC,CAAC;YAEH,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACjC,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC;gBACpC,GAAG,CAAC,UAAU;oBACZ,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE;oBAC9D,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * hazo_jobs handler for `hazo_notify:lifecycle_step` jobs.
+ *
+ * Each time-triggered lifecycle step is deferred via hazo_jobs. When the job
+ * fires, this handler re-evaluates conditions and either dispatches the email
+ * or marks the row as skipped/failed.
+ *
+ * @packageDocumentation
+ */
+import type { HazoJobHandler, LifecycleSchedulerOptions, LifecycleStepPayload } from './types.js';
+/**
+ * Factory that produces the hazo_jobs handler for `lifecycle_step` jobs.
+ *
+ * Handler flow:
+ * 1. Load status row — guard on status !== 'scheduled' (idempotency).
+ * 2. Increment attempt_count.
+ * 3. Check opt-out via opts.is_opted_out (if provided).
+ * 4. Evaluate ConditionNode graph via evaluateConditions.
+ * 5. If pass: dispatch via dispatchStep, mark 'sent'.
+ * 6. If fail: mark 'skipped' with reason.
+ * 7. On exception: if attempts exhausted, mark 'failed'; else leave 'scheduled'
+ *    so hazo_jobs retries.
+ *
+ * @param opts - Same options passed to `createLifecycleScheduler`.
+ * @param get_user_email - Async function that resolves an email address for a
+ *   given user_id. Required to know where to send the step email.
+ */
+export declare function createLifecycleStepHandler(opts: LifecycleSchedulerOptions, get_user_email: (user_id: string) => Promise<string>): HazoJobHandler<LifecycleStepPayload>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/lib/lifecycle/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAGV,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,yBAAyB,EAC/B,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACnD,cAAc,CAAC,oBAAoB,CAAC,CA2ItC"}

package/dist/lib/lifecycle/handler.js

@@ -0,0 +1,145 @@
+/**
+ * hazo_jobs handler for `hazo_notify:lifecycle_step` jobs.
+ *
+ * Each time-triggered lifecycle step is deferred via hazo_jobs. When the job
+ * fires, this handler re-evaluates conditions and either dispatches the email
+ * or marks the row as skipped/failed.
+ *
+ * @packageDocumentation
+ */
+import { createHash } from 'node:crypto';
+import { evaluateConditions } from './resolver.js';
+import { dispatchStep } from './dispatch.js';
+import { loadStatusRow, updateStatusRow } from './status.js';
+/**
+ * Factory that produces the hazo_jobs handler for `lifecycle_step` jobs.
+ *
+ * Handler flow:
+ * 1. Load status row — guard on status !== 'scheduled' (idempotency).
+ * 2. Increment attempt_count.
+ * 3. Check opt-out via opts.is_opted_out (if provided).
+ * 4. Evaluate ConditionNode graph via evaluateConditions.
+ * 5. If pass: dispatch via dispatchStep, mark 'sent'.
+ * 6. If fail: mark 'skipped' with reason.
+ * 7. On exception: if attempts exhausted, mark 'failed'; else leave 'scheduled'
+ *    so hazo_jobs retries.
+ *
+ * @param opts - Same options passed to `createLifecycleScheduler`.
+ * @param get_user_email - Async function that resolves an email address for a
+ *   given user_id. Required to know where to send the step email.
+ */
+export function createLifecycleStepHandler(opts, get_user_email) {
+    const max_attempts = opts.max_attempts ?? 3;
+    return async function lifecycle_step_handler(job, log) {
+        // hazo_jobs (SQLite backend) may deliver payload as a JSON string.
+        const payload = typeof job.payload === 'string'
+            ? JSON.parse(job.payload)
+            : job.payload;
+        const { status_row_id, user_id, sequence_id, step_id } = payload;
+        log?.info?.(`[lifecycle] step start row=${status_row_id} user=${user_id} seq=${sequence_id} step=${step_id}`);
+        // 1. Load the status row.
+        const row = await loadStatusRow(opts.hazo_connect, status_row_id);
+        // 2. Guard: already processed or gone.
+        if (!row || row.status !== 'scheduled') {
+            log?.info?.(`[lifecycle] step skip (already handled) row=${status_row_id} status=${row?.status ?? 'not_found'}`);
+            return;
+        }
+        // 3. Increment attempt counter.
+        const attempt_count = row.attempt_count + 1;
+        try {
+            // 4. Opt-out check.
+            if (opts.is_opted_out) {
+                const opted_out = await opts.is_opted_out(user_id);
+                if (opted_out) {
+                    await updateStatusRow(opts.hazo_connect, status_row_id, {
+                        status: 'skipped',
+                        skip_reason: 'opted_out',
+                        attempt_count,
+                    });
+                    log?.info?.(`[lifecycle] step skipped (opted_out) row=${status_row_id}`);
+                    return;
+                }
+            }
+            // 5. Locate the step definition.
+            const sequence = opts.sequences[sequence_id];
+            if (!sequence) {
+                throw new Error(`sequence_not_found:${sequence_id}`);
+            }
+            const step = sequence.find((s) => s.id === step_id);
+            if (!step) {
+                throw new Error(`step_not_found:${sequence_id}/${step_id}`);
+            }
+            // 6. Evaluate conditions.
+            const condition_result = await evaluateConditions(step.conditions, opts.resolvers, user_id);
+            if (!condition_result.pass) {
+                const skip_reason = `condition_failed:${condition_result.reason ?? 'unknown'}`;
+                await updateStatusRow(opts.hazo_connect, status_row_id, {
+                    status: 'skipped',
+                    skip_reason,
+                    attempt_count,
+                });
+                log?.info?.(`[lifecycle] step skipped row=${status_row_id} reason=${skip_reason}`);
+                return;
+            }
+            // 7. Resolve recipient email address.
+            const to = await get_user_email(user_id);
+            // 8. Resolve extra template variables (e.g. opt-out link, A/B subjects).
+            const raw_vars = opts.get_variables
+                ? await opts.get_variables(user_id, step_id)
+                : {};
+            // 8a. A/B subject selection: if both subject_a and subject_b are provided,
+            //     pick one deterministically by hashing user_id + template_name.
+            //     Remove both from template variables so they don't appear in the body.
+            let subject_override;
+            let ab_variant;
+            const { subject_a, subject_b, ...extra_vars } = raw_vars;
+            if (subject_a && subject_b) {
+                const hash_byte = createHash('sha256')
+                    .update(user_id + step.template)
+                    .digest()[0];
+                ab_variant = (hash_byte & 1) === 0 ? 'a' : 'b';
+                subject_override = ab_variant === 'a' ? subject_a : subject_b;
+            }
+            // 9. Dispatch the email.
+            await dispatchStep({
+                hazo_connect: opts.hazo_connect,
+                user_id,
+                template_name: step.template,
+                variables: extra_vars,
+                to,
+                locale: opts.default_locale ?? null,
+                subject_override,
+            });
+            // 10. Mark as sent (include dispatch_meta for A/B tracking).
+            await updateStatusRow(opts.hazo_connect, status_row_id, {
+                status: 'sent',
+                sent_at: new Date().toISOString(),
+                attempt_count,
+                ...(ab_variant
+                    ? { dispatch_meta: { ab_variant, subject: subject_override } }
+                    : {}),
+            });
+            log?.info?.(`[lifecycle] step sent row=${status_row_id} template=${step.template}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log?.error?.(`[lifecycle] step error row=${status_row_id} err=${msg}`);
+            if (attempt_count >= max_attempts) {
+                await updateStatusRow(opts.hazo_connect, status_row_id, {
+                    status: 'failed',
+                    failure_message: msg,
+                    attempt_count,
+                });
+                log?.error?.(`[lifecycle] step failed permanently row=${status_row_id}`);
+            }
+            else {
+                // Leave status as 'scheduled' so hazo_jobs retries the job.
+                await updateStatusRow(opts.hazo_connect, status_row_id, {
+                    attempt_count,
+                    failure_message: msg,
+                });
+            }
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * hazo_notify/lifecycle — public API surface.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import {
+ *   createLifecycleScheduler,
+ *   registerLifecycleHandlers,
+ * } from 'hazo_notify/lifecycle';
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createLifecycleScheduler, LIFECYCLE_STEP_JOB_TYPE } from './scheduler.js';
+export { registerLifecycleHandlers } from './register.js';
+export { evaluateConditions } from './resolver.js';
+export { insertStatusRow, loadStatusRow, updateStatusRow, queryStatusRows, findEventStepRow, } from './status.js';
+export { dispatchStep } from './dispatch.js';
+export type { LifecycleTrigger, Condition, ConditionNode, LifecycleStep, LifecycleStatusRow, LifecycleSchedulerOptions, LifecycleScheduler, LifecycleStepPayload, HazoJobsSubmitter, } from './types.js';
+export type { HazoConnectInstance, HazoJob, HazoJobLogger, HazoJobHandler, } from './types.js';
+export { lifecycleDefaultTemplates } from './default_templates.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AAE7C,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/lifecycle/index.js

@@ -0,0 +1,21 @@
+/**
+ * hazo_notify/lifecycle — public API surface.
+ *
+ * Usage:
+ *
+ * ```ts
+ * import {
+ *   createLifecycleScheduler,
+ *   registerLifecycleHandlers,
+ * } from 'hazo_notify/lifecycle';
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createLifecycleScheduler, LIFECYCLE_STEP_JOB_TYPE } from './scheduler.js';
+export { registerLifecycleHandlers } from './register.js';
+export { evaluateConditions } from './resolver.js';
+export { insertStatusRow, loadStatusRow, updateStatusRow, queryStatusRows, findEventStepRow, } from './status.js';
+export { dispatchStep } from './dispatch.js';
+export { lifecycleDefaultTemplates } from './default_templates.js';
+//# sourceMappingURL=index.js.map

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"}