hazo_notify 5.0.1 → 5.3.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/lifecycle/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,3 @@
+export { set_preference, get_preference, list_preferences, delete_preference, batchGetPreferences, } from './storage.js';
+export type { PreferenceMode, PreferenceRow, SetPreferenceInput, GetPreferenceOptions, BatchGetPreferencesOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/preferences/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,YAAY,CAAC"}

package/dist/lib/preferences/index.js

@@ -0,0 +1,3 @@
+// src/lib/preferences/index.ts
+export { set_preference, get_preference, list_preferences, delete_preference, batchGetPreferences, } from './storage.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/preferences/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/lib/preferences/storage.d.ts

@@ -0,0 +1,33 @@
+import type { PreferenceRow, SetPreferenceInput, GetPreferenceOptions, BatchGetPreferencesOptions, PreferenceMode } from './types.js';
+/**
+ * List all preference rows for a user, optionally filtered by scope_id.
+ */
+export declare function list_preferences(opts: {
+    user_id: string;
+    scope_id?: string | null;
+}): Promise<PreferenceRow[]>;
+/**
+ * Upsert a preference row. A second call with the same key updates `mode`.
+ */
+export declare function set_preference(input: SetPreferenceInput): Promise<PreferenceRow>;
+/**
+ * Get the exact preference row for a key. Does NOT perform 5-level resolution.
+ */
+export declare function get_preference(opts: GetPreferenceOptions): Promise<PreferenceRow | null>;
+/**
+ * Delete an exact preference row. Returns true if deleted, false if not found.
+ */
+export declare function delete_preference(opts: GetPreferenceOptions): Promise<boolean>;
+/**
+ * Batch-resolve preference mode for (user × channel) pairs using 5-level resolution.
+ * Returns Map<user_id, Map<channel_id, PreferenceMode>>.
+ *
+ * Resolution priority (lower number wins):
+ *   1. (user, scope, event_type, channel) — exact match
+ *   2. (user, scope, null, channel)       — scoped, any event
+ *   3. (user, null, event_type, channel)  — global scope, specific event
+ *   4. (user, null, null, channel)        — global wildcard
+ *   5. default_mode                       — consumer-supplied fallback
+ */
+export declare function batchGetPreferences(opts: BatchGetPreferencesOptions): Promise<Map<string, Map<string, PreferenceMode>>>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/lib/preferences/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/lib/preferences/storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACf,MAAM,YAAY,CAAC;AAqBpB;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAS3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAuCtF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAU9F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKpF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAuCnD"}

package/dist/lib/preferences/storage.js

@@ -0,0 +1,129 @@
+// src/lib/preferences/storage.ts
+/**
+ * Preference storage layer for hazo_notify.
+ * Uses rawQuery via getInboxConnection() — compatible with both SQLite and Postgres.
+ * @packageDocumentation
+ */
+import { randomUUID } from 'node:crypto';
+import { getInboxConnection } from '../inbox/connection.js';
+const TABLE = 'hazo_notify_preferences';
+function conn() {
+    return getInboxConnection();
+}
+/** Priority index for the 5-level resolution chain (lower = higher priority). */
+function priority(row, scope_id, event_type) {
+    const scope_match = row.scope_id === scope_id;
+    const event_match = row.event_type === event_type;
+    if (scope_match && event_match)
+        return 1;
+    if (scope_match && row.event_type === null)
+        return 2;
+    if (row.scope_id === null && event_match)
+        return 3;
+    if (row.scope_id === null && row.event_type === null)
+        return 4;
+    return 99;
+}
+/**
+ * List all preference rows for a user, optionally filtered by scope_id.
+ */
+export async function list_preferences(opts) {
+    const rows = await conn().rawQuery(`SELECT * FROM ${TABLE} WHERE user_id = ?`, { params: [opts.user_id] });
+    if (opts.scope_id !== undefined) {
+        return rows.filter(r => r.scope_id === opts.scope_id);
+    }
+    return rows;
+}
+/**
+ * Upsert a preference row. A second call with the same key updates `mode`.
+ */
+export async function set_preference(input) {
+    const VALID_MODES = ['on', 'off', 'digest'];
+    if (!VALID_MODES.includes(input.mode)) {
+        throw new Error(`Invalid preference mode '${input.mode}'. Must be one of: ${VALID_MODES.join(', ')}`);
+    }
+    const all = await list_preferences({ user_id: input.user_id });
+    const match = all.find(r => r.scope_id === (input.scope_id ?? null) &&
+        r.event_type === (input.event_type ?? null) &&
+        r.channel_id === input.channel_id);
+    if (match) {
+        const now = new Date().toISOString();
+        await conn().rawQuery(`UPDATE ${TABLE} SET mode = ?, updated_at = ? WHERE id = ?`, { params: [input.mode, now, match.id] });
+        return { ...match, mode: input.mode, updated_at: now };
+    }
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    await conn().rawQuery(`INSERT INTO ${TABLE} (id, user_id, scope_id, event_type, channel_id, mode, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, { params: [id, input.user_id, input.scope_id ?? null, input.event_type ?? null, input.channel_id, input.mode, now, now] });
+    return {
+        id,
+        user_id: input.user_id,
+        scope_id: input.scope_id ?? null,
+        event_type: input.event_type ?? null,
+        channel_id: input.channel_id,
+        mode: input.mode,
+        created_at: now,
+        updated_at: now,
+    };
+}
+/**
+ * Get the exact preference row for a key. Does NOT perform 5-level resolution.
+ */
+export async function get_preference(opts) {
+    const all = await list_preferences({ user_id: opts.user_id });
+    return (all.find(r => r.scope_id === opts.scope_id &&
+        r.event_type === opts.event_type &&
+        r.channel_id === opts.channel_id) ?? null);
+}
+/**
+ * Delete an exact preference row. Returns true if deleted, false if not found.
+ */
+export async function delete_preference(opts) {
+    const row = await get_preference(opts);
+    if (!row)
+        return false;
+    await conn().rawQuery(`DELETE FROM ${TABLE} WHERE id = ?`, { params: [row.id] });
+    return true;
+}
+/**
+ * Batch-resolve preference mode for (user × channel) pairs using 5-level resolution.
+ * Returns Map<user_id, Map<channel_id, PreferenceMode>>.
+ *
+ * Resolution priority (lower number wins):
+ *   1. (user, scope, event_type, channel) — exact match
+ *   2. (user, scope, null, channel)       — scoped, any event
+ *   3. (user, null, event_type, channel)  — global scope, specific event
+ *   4. (user, null, null, channel)        — global wildcard
+ *   5. default_mode                       — consumer-supplied fallback
+ */
+export async function batchGetPreferences(opts) {
+    const { user_ids, scope_id, event_type, channel_ids, default_mode = 'on' } = opts;
+    if (user_ids.length === 0 || channel_ids.length === 0) {
+        return new Map();
+    }
+    // Fetch all rows for these users (preference tables are small — one query per user)
+    const all_rows = [];
+    for (const user_id of user_ids) {
+        const rows = await list_preferences({ user_id });
+        all_rows.push(...rows);
+    }
+    const result = new Map();
+    for (const user_id of user_ids) {
+        const channel_map = new Map();
+        for (const channel_id of channel_ids) {
+            const candidates = all_rows.filter(r => r.user_id === user_id &&
+                r.channel_id === channel_id &&
+                (r.scope_id === scope_id || r.scope_id === null) &&
+                (r.event_type === event_type || r.event_type === null));
+            if (candidates.length === 0) {
+                channel_map.set(channel_id, default_mode);
+                continue;
+            }
+            candidates.sort((a, b) => priority(a, scope_id, event_type) - priority(b, scope_id, event_type));
+            channel_map.set(channel_id, candidates[0].mode);
+        }
+        result.set(user_id, channel_map);
+    }
+    return result;
+}
+//# sourceMappingURL=storage.js.map

package/dist/lib/preferences/storage.js.map

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