hazo_notify 3.1.0 → 5.0.0

package/dist/lib/inbox/storage.js

@@ -0,0 +1,345 @@
+import { QueryBuilder, createCrudService } from "hazo_connect/server";
+import { getInboxConnection } from "./connection.js";
+/**
+ * Upsert an inbox row using a claim-first strategy:
+ *
+ * 1. Try to increment an existing open batch that matches `batch_key` and
+ *    `batch_closed_at`. This preserves the increment-on-conflict semantics of
+ *    the original Postgres `ON CONFLICT (batch_key) WHERE batch_closed_at IS NULL`
+ *    partial-index upsert.
+ * 2. If no open batch found, insert a fresh row.
+ *
+ * Race-condition trade-off: if two workers concurrently find no open batch and
+ * both insert, both succeed (no unique index guards the SQLite/adapter path).
+ * The original Postgres SQL used a partial unique index for true atomicity.
+ * For Hazodocs (single-worker), this race window is acceptable; adding retry
+ * logic would require error-code parsing not available in hazo_connect.
+ *
+ * SQLite NULL caveat: the clause-builder emits `col = ?` which SQLite's `=`
+ * operator does not use to match NULL (needs IS NULL). In production (Postgres),
+ * the behaviour is correct because Postgres's `=` also doesn't match NULL — the
+ * partial index `WHERE batch_closed_at IS NULL` handles the constraint there.
+ * In SQLite-backed tests use empty string instead of null for batch_closed_at.
+ */
+export async function upsertInboxRow(i) {
+    const adapter = getInboxConnection();
+    // Try to increment an existing open batch first.
+    const claimed = await adapter.claimRows({
+        table: "hazo_notify_inbox",
+        where: { batch_key: i.batch_key, batch_closed_at: i.batch_closed_at ?? "" },
+        set: {
+            aggregate_count: { increment: 1 },
+            in_app_text: i.in_app_text,
+            payload: JSON.stringify(i.payload),
+            updated_at: { $now: true },
+        },
+        returning: ["id"],
+        limit: 1,
+    });
+    if (claimed.length > 0) {
+        return { id: claimed[0].id, inserted: false };
+    }
+    // No open batch — insert a new row.
+    const rows = await adapter.query(new QueryBuilder()
+        .from("hazo_notify_inbox")
+        .returning("id"), "POST", {
+        scope_id: i.scope_id,
+        user_id: i.user_id,
+        event_type: i.event_type,
+        subject_id: i.subject_id,
+        batch_key: i.batch_key,
+        in_app_text: i.in_app_text,
+        deep_link: i.deep_link,
+        payload: JSON.stringify(i.payload),
+        surfaces: JSON.stringify(i.surfaces),
+        batch_closed_at: i.batch_closed_at,
+    });
+    return { id: rows[0].id, inserted: true };
+}
+/**
+ * Upsert a channel delivery row using a two-claim strategy that preserves the
+ * original Postgres CASE-WHEN semantic for `flush_after`:
+ *
+ * 1. Claim an **existing fresh row** (attempt_count = 0) — update both `payload`
+ *    and `flush_after` (the delivery hasn't been tried yet, so rescheduling is safe).
+ * 2. Claim an **existing in-flight row** (attempt_count > 0) — update `payload`
+ *    only; preserve `flush_after` to avoid resetting an active retry schedule.
+ * 3. If neither claim succeeds, no row exists — insert a new one.
+ *
+ * The two claims are mutually exclusive so at most one succeeds per call.
+ */
+export async function upsertDelivery(i) {
+    const adapter = getInboxConnection();
+    // Step 1: claim a fresh (not-yet-attempted) row — update payload + flush_after.
+    const claimedFresh = await adapter.claimRows({
+        table: "hazo_notify_channel_deliveries",
+        where: { inbox_id: i.inbox_id, channel_id: i.channel_id, attempt_count: 0 },
+        set: { payload: JSON.stringify(i.payload), flush_after: i.flush_after, updated_at: { $now: true } },
+        returning: ["id"],
+        limit: 1,
+    });
+    if (claimedFresh.length > 0) {
+        return { id: claimedFresh[0].id, inserted: false, attempt_in_flight: false };
+    }
+    // Step 2: claim an in-flight row (attempt_count > 0) — update payload only,
+    // preserve flush_after so the retry schedule is not reset.
+    const claimedInFlight = await adapter.claimRows({
+        table: "hazo_notify_channel_deliveries",
+        where: { inbox_id: i.inbox_id, channel_id: i.channel_id, attempt_count: { gt: 0 } },
+        set: { payload: JSON.stringify(i.payload), updated_at: { $now: true } },
+        returning: ["id"],
+        limit: 1,
+    });
+    if (claimedInFlight.length > 0) {
+        return { id: claimedInFlight[0].id, inserted: false, attempt_in_flight: true };
+    }
+    // Step 3: no existing row — insert a new delivery.
+    const rows = await adapter.query(new QueryBuilder()
+        .from("hazo_notify_channel_deliveries")
+        .returning("id"), "POST", {
+        inbox_id: i.inbox_id,
+        channel_id: i.channel_id,
+        payload: JSON.stringify(i.payload),
+        flush_after: i.flush_after,
+    });
+    return { id: rows[0].id, inserted: true, attempt_in_flight: false };
+}
+export async function claimDueDeliveries(channel_id, batch_size) {
+    const adapter = getInboxConnection();
+    // THE KEY CHANGE (Task 2.6): delegates to adapter.claimRows instead of a
+    // dialect-bound raw SQL query (SELECT … FOR UPDATE SKIP LOCKED on Postgres).
+    // Strong atomicity on PgAdapter; CAS-optimistic on PostgrestAdapter;
+    // serialised transaction on SqliteAdapter.  All adapters are supported.
+    const claimed = await adapter.claimRows({
+        table: "hazo_notify_channel_deliveries",
+        where: {
+            channel_id,
+            status: "pending",
+            flush_after: { lte: { $now: true } },
+        },
+        set: {
+            attempt_count: { increment: 1 },
+            updated_at: { $now: true },
+        },
+        returning: ["id", "inbox_id", "channel_id", "payload", "attempt_count"],
+        limit: batch_size,
+        orderBy: { column: "flush_after", direction: "asc" },
+    });
+    // Enrich each claimed row with user_id + scope_id from the originating inbox
+    // row.  N+1 is acceptable: batch sizes are small (~10) and per-call latency
+    // dominates.  Map `id` → `delivery_id` to match the ClaimedDelivery contract
+    // that callers (flush worker) expect.
+    return Promise.all(claimed.map(async (r) => {
+        const inboxRows = await adapter.query(new QueryBuilder()
+            .from("hazo_notify_inbox")
+            .select("user_id, scope_id")
+            .where("id", "eq", r.inbox_id), "GET");
+        const payload = typeof r.payload === "string"
+            ? JSON.parse(r.payload)
+            : r.payload;
+        return {
+            delivery_id: r.id,
+            inbox_id: r.inbox_id,
+            channel_id: r.channel_id,
+            payload,
+            attempt_count: r.attempt_count,
+            user_id: inboxRows[0]?.user_id ?? "",
+            scope_id: inboxRows[0]?.scope_id ?? "",
+        };
+    }));
+}
+/**
+ * Task 2.7 — markDeliverySent via CrudService.updateById
+ *
+ * Sets status=sent, records the provider message_id, and stamps finalized_at.
+ * updateById returns T[] — ignored here (fire-and-forget).
+ */
+export async function markDeliverySent(id, message_id) {
+    const adapter = getInboxConnection();
+    const crud = createCrudService(adapter, "hazo_notify_channel_deliveries");
+    await crud.updateById(id, {
+        status: "sent",
+        message_id,
+        finalized_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    });
+}
+/**
+ * Task 2.8 — markDeliveryFailed via CrudService.updateById
+ *
+ * Sets status=failed, stores the error (truncated to 1000 chars), and stamps finalized_at.
+ * updateById returns T[] — ignored here (fire-and-forget).
+ */
+export async function markDeliveryFailed(id, error) {
+    const adapter = getInboxConnection();
+    const crud = createCrudService(adapter, "hazo_notify_channel_deliveries");
+    await crud.updateById(id, {
+        status: "failed",
+        last_error: error.slice(0, 1000),
+        finalized_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    });
+}
+/**
+ * Task 2.9 — rescheduleDelivery via CrudService.updateById
+ *
+ * Updates flush_after and last_error for the next retry. Status stays 'pending'.
+ * updateById returns T[] — ignored here (fire-and-forget).
+ */
+export async function rescheduleDelivery(id, flush_after, error) {
+    const adapter = getInboxConnection();
+    const crud = createCrudService(adapter, "hazo_notify_channel_deliveries");
+    await crud.updateById(id, {
+        flush_after,
+        last_error: error,
+        updated_at: new Date().toISOString(),
+    });
+}
+/**
+ * Task 2.10 — closeStaleBatches via adapter.claimRows
+ *
+ * Closes inbox rows whose batch_closed_at is empty string (open) and whose
+ * created_at is older than (now - window_ms).
+ *
+ * NULL caveat: SQLite's claimRows WHERE emits `col = ?` which does not match
+ * SQL NULL. Empty string '' is used as the sentinel for "open batch" in both
+ * SQLite tests and production (see upsertInboxRow). In production (Postgres),
+ * rows inserted via this adapter path use '' not NULL, so the '' sentinel is
+ * consistent end-to-end.
+ *
+ * Returns the number of batches closed.
+ */
+export async function closeStaleBatches(window_ms) {
+    const adapter = getInboxConnection();
+    const cutoff = new Date(Date.now() - window_ms).toISOString();
+    const rows = await adapter.claimRows({
+        table: "hazo_notify_inbox",
+        where: { batch_closed_at: "", created_at: { lte: cutoff } },
+        set: { batch_closed_at: { $now: true } },
+        returning: ["id"],
+        limit: 10000,
+    });
+    return rows.length;
+}
+/**
+ * Task 2.11a — purgeReadInbox via QueryBuilder DELETE
+ *
+ * Deletes inbox rows that have been read and whose read_at is older than
+ * `older_than`. Returns the number of rows deleted.
+ *
+ * QueryBuilder 'neq' with null → IS NOT NULL (via translateWhereCondition).
+ * QueryBuilder 'lt' → read_at < older_than.
+ */
+export async function purgeReadInbox(older_than) {
+    const adapter = getInboxConnection();
+    const builder = new QueryBuilder()
+        .from("hazo_notify_inbox")
+        .where("read_at", "neq", null)
+        .where("read_at", "lt", older_than);
+    const rows = await adapter.query(builder, "DELETE");
+    return rows.length;
+}
+/**
+ * Task 2.11b — purgeFinalizedDeliveries via QueryBuilder DELETE
+ *
+ * Deletes delivery rows that have been finalized (sent or failed) and whose
+ * finalized_at is older than `older_than`. Returns the number of rows deleted.
+ */
+export async function purgeFinalizedDeliveries(older_than) {
+    const adapter = getInboxConnection();
+    const builder = new QueryBuilder()
+        .from("hazo_notify_channel_deliveries")
+        .where("finalized_at", "neq", null)
+        .where("finalized_at", "lt", older_than);
+    const rows = await adapter.query(builder, "DELETE");
+    return rows.length;
+}
+/**
+ * Task 2.12a — listUnreadForUser via QueryBuilder
+ *
+ * Returns unread inbox rows for the given user/scope, ordered by created_at
+ * descending with optional cursor (created_at < cursor) and limit.
+ *
+ * Surface filtering (in_app / banner) requires dialect-specific JSONB or
+ * json_extract access. Rather than branching on adapter type at this layer,
+ * callers filter in-memory when surface filtering is needed. This keeps the
+ * storage layer adapter-agnostic.
+ *
+ * QueryBuilder 'is' with null → IS NULL (via translateWhereCondition).
+ */
+export async function listUnreadForUser(user_id, scope_id, opts = {}) {
+    const adapter = getInboxConnection();
+    let builder = new QueryBuilder()
+        .from("hazo_notify_inbox")
+        .where("user_id", "eq", user_id)
+        .where("scope_id", "eq", scope_id)
+        .where("read_at", "is", null)
+        .order("created_at", "desc")
+        .limit(Math.min(opts.limit ?? 20, 100));
+    if (opts.cursor) {
+        builder = builder.where("created_at", "lt", opts.cursor);
+    }
+    return await adapter.query(builder, "GET");
+}
+/**
+ * Task 2.12b — unreadCount via QueryBuilder
+ *
+ * Counts unread inbox rows for the given user/scope.
+ * QueryBuilder 'is' with null → IS NULL.
+ */
+export async function unreadCount(user_id, scope_id) {
+    const adapter = getInboxConnection();
+    const builder = new QueryBuilder()
+        .from("hazo_notify_inbox")
+        .where("user_id", "eq", user_id)
+        .where("scope_id", "eq", scope_id)
+        .where("read_at", "is", null);
+    const rows = await adapter.query(builder, "GET");
+    return rows.length;
+}
+/**
+ * Task 2.13a — markRead via claimRows (idempotent)
+ *
+ * Sets read_at = now() for the given inbox row, scoped by user_id to prevent
+ * cross-user reads.
+ *
+ * Idempotency trade-off: the `read_at: null` condition is omitted from the
+ * claimRows WHERE because the clause-builder emits `col = ?` which SQLite's
+ * `=` operator does not use to match NULL. Dropping the condition makes the
+ * operation idempotent — re-marking an already-read row re-sets read_at = now(),
+ * which is harmless for UI-driven calls.
+ */
+export async function markRead(id, user_id) {
+    const adapter = getInboxConnection();
+    const rows = await adapter.claimRows({
+        table: "hazo_notify_inbox",
+        where: { id, user_id },
+        set: { read_at: { $now: true } },
+        returning: ["id"],
+        limit: 1,
+    });
+    return rows.length > 0;
+}
+/**
+ * Task 2.13b — markAllRead via claimRows (idempotent)
+ *
+ * Sets read_at = now() for every inbox row belonging to the given user/scope.
+ *
+ * Idempotency trade-off: same as markRead — the `read_at: null` condition is
+ * omitted to avoid the SQLite NULL-matching issue. Already-read rows will have
+ * their read_at re-stamped, which is acceptable for bulk UI acknowledgment.
+ *
+ * Returns the count of rows updated (includes any already-read rows).
+ */
+export async function markAllRead(user_id, scope_id) {
+    const adapter = getInboxConnection();
+    const rows = await adapter.claimRows({
+        table: "hazo_notify_inbox",
+        where: { user_id, scope_id },
+        set: { read_at: { $now: true } },
+        returning: ["id"],
+        limit: 10000,
+    });
+    return rows.length;
+}
+//# sourceMappingURL=storage.js.map

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

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

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

@@ -0,0 +1,94 @@
+export interface NotificationSurfaces {
+    in_app: boolean;
+    banner: boolean;
+}
+export interface InboxRow {
+    id: string;
+    scope_id: string;
+    user_id: string;
+    event_type: string;
+    subject_id: string | null;
+    batch_key: string;
+    in_app_text: string;
+    deep_link: string;
+    payload: Record<string, unknown>;
+    surfaces: NotificationSurfaces;
+    aggregate_count: number;
+    batch_closed_at: string | null;
+    read_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface DeliveryRow {
+    id: string;
+    inbox_id: string;
+    channel_id: string;
+    payload: Record<string, unknown>;
+    status: "pending" | "sent" | "failed";
+    flush_after: string;
+    attempt_count: number;
+    message_id: string | null;
+    last_error: string | null;
+    finalized_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface DispatchInput {
+    event_type: string;
+    subject_id: string | null;
+    scope_id: string;
+    recipient_user_ids: string[];
+    in_app_text: string;
+    deep_link: string;
+    surfaces: NotificationSurfaces;
+    channels: Partial<Record<string, boolean>>;
+    channel_payloads?: Record<string, Record<string, unknown>>;
+    payload?: Record<string, unknown>;
+    batch_window_ms?: number;
+}
+export interface DispatchResult {
+    inbox_rows_upserted: number;
+    inbox_rows_inserted: number;
+    inbox_rows_aggregated: number;
+    deliveries_created: number;
+    deliveries_refreshed: number;
+    channels_dispatched: string[];
+}
+export interface UpsertInboxRowInput {
+    scope_id: string;
+    user_id: string;
+    event_type: string;
+    subject_id: string | null;
+    batch_key: string;
+    in_app_text: string;
+    deep_link: string;
+    payload: Record<string, unknown>;
+    surfaces: NotificationSurfaces;
+    batch_closed_at: string | null;
+}
+export interface UpsertInboxRowResult {
+    id: string;
+    inserted: boolean;
+}
+export interface UpsertDeliveryInput {
+    inbox_id: string;
+    channel_id: string;
+    payload: Record<string, unknown>;
+    flush_after: string;
+}
+export interface UpsertDeliveryResult {
+    id: string;
+    inserted: boolean;
+    /** True if the worker has already started attempts on this row. */
+    attempt_in_flight: boolean;
+}
+export interface ClaimedDelivery {
+    delivery_id: string;
+    inbox_id: string;
+    channel_id: string;
+    payload: Record<string, unknown>;
+    attempt_count: number;
+    user_id: string;
+    scope_id: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/lib/inbox/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Sweep functions for the inbox worker:
+ *  - runBatchCloseSweep  — closes batches whose window has elapsed
+ *  - runCleanupSweep     — purges read inbox rows + finalized deliveries past retention
+ *
+ * @packageDocumentation
+ */
+import type { ChannelLogger } from "../../channels/types.js";
+export declare function runBatchCloseSweep(window_ms: number, logger: ChannelLogger): Promise<number>;
+export declare function runCleanupSweep(read_inbox_retention_ms: number, failed_delivery_retention_ms: number, logger: ChannelLogger): Promise<{
+    inbox_purged: number;
+    deliveries_purged: number;
+}>;
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CASlG;AAED,wBAAsB,eAAe,CACnC,uBAAuB,EAAE,MAAM,EAC/B,4BAA4B,EAAE,MAAM,EACpC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9D"}

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

@@ -0,0 +1,37 @@
+/**
+ * Sweep functions for the inbox worker:
+ *  - runBatchCloseSweep  — closes batches whose window has elapsed
+ *  - runCleanupSweep     — purges read inbox rows + finalized deliveries past retention
+ *
+ * @packageDocumentation
+ */
+import { closeStaleBatches, purgeReadInbox, purgeFinalizedDeliveries, } from "../storage.js";
+export async function runBatchCloseSweep(window_ms, logger) {
+    try {
+        const n = await closeStaleBatches(window_ms);
+        if (n > 0)
+            logger.info("inbox.batch_close_sweep", { closed: n });
+        return n;
+    }
+    catch (e) {
+        logger.error("inbox.batch_close_sweep_failed", { error: e instanceof Error ? e.message : String(e) });
+        return 0;
+    }
+}
+export async function runCleanupSweep(read_inbox_retention_ms, failed_delivery_retention_ms, logger) {
+    try {
+        const inbox_cutoff = new Date(Date.now() - read_inbox_retention_ms).toISOString();
+        const del_cutoff = new Date(Date.now() - failed_delivery_retention_ms).toISOString();
+        const inbox_purged = await purgeReadInbox(inbox_cutoff);
+        const deliveries_purged = await purgeFinalizedDeliveries(del_cutoff);
+        if (inbox_purged + deliveries_purged > 0) {
+            logger.info("inbox.cleanup_sweep", { inbox_purged, deliveries_purged });
+        }
+        return { inbox_purged, deliveries_purged };
+    }
+    catch (e) {
+        logger.error("inbox.cleanup_sweep_failed", { error: e instanceof Error ? e.message : String(e) });
+        return { inbox_purged: 0, deliveries_purged: 0 };
+    }
+}
+//# sourceMappingURL=cleanup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EAAE,cAAc,EAAE,wBAAwB,GAC5D,MAAM,eAAe,CAAC;AAGvB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAqB;IAC/E,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtG,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,uBAA+B,EAC/B,4BAAoC,EACpC,MAAqB;IAErB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,uBAAuB,CAAC,CAAC,WAAW,EAAE,CAAC;QAClF,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,4BAA4B,CAAC,CAAC,WAAW,EAAE,CAAC;QACrF,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QACxD,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,YAAY,GAAG,iBAAiB,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClG,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Generic per-channel flush worker tick.
+ *
+ * Replaces the v3 email-only `flushOnce` with `flushChannelOnce(channel_id, opts)`,
+ * which works for any registered channel adapter. Retry policy is read from
+ * `adapter.capabilities.retry`; `attempt_count` is already incremented at claim
+ * (spec §7.2), so the retry condition is `attempt_count < max_attempts`.
+ *
+ * @packageDocumentation
+ */
+import type { ChannelLogger, ScopeBranding } from "../../channels/types.js";
+export interface FlushOptions {
+    batchSize: number;
+    concurrency: number;
+    resolveRecipient: (user_id: string, scope_id: string, channel_id: string) => Promise<string | null>;
+    resolveScopeBranding?: (scope_id: string) => Promise<ScopeBranding | null>;
+    logger?: ChannelLogger;
+}
+export interface FlushResult {
+    processed: number;
+    sent: number;
+    failed: number;
+    retried: number;
+}
+/**
+ * Process one batch of deliveries due for the given channel.
+ * Per-row errors are captured on the row rather than aborting the batch.
+ * Concurrency is bounded by `opts.concurrency`.
+ */
+export declare function flushChannelOnce(channel_id: string, opts: FlushOptions): Promise<FlushResult>;
+//# sourceMappingURL=flush.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flush.d.ts","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpG,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAyFtB"}

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

@@ -0,0 +1,97 @@
+/**
+ * Generic per-channel flush worker tick.
+ *
+ * Replaces the v3 email-only `flushOnce` with `flushChannelOnce(channel_id, opts)`,
+ * which works for any registered channel adapter. Retry policy is read from
+ * `adapter.capabilities.retry`; `attempt_count` is already incremented at claim
+ * (spec §7.2), so the retry condition is `attempt_count < max_attempts`.
+ *
+ * @packageDocumentation
+ */
+import { getChannel } from "../../channels/registry.js";
+import { claimDueDeliveries, markDeliverySent, markDeliveryFailed, rescheduleDelivery, } from "../storage.js";
+import { renderForChannel } from "./render.js";
+const noopLogger = {
+    info: () => { },
+    error: () => { },
+};
+/**
+ * Process one batch of deliveries due for the given channel.
+ * Per-row errors are captured on the row rather than aborting the batch.
+ * Concurrency is bounded by `opts.concurrency`.
+ */
+export async function flushChannelOnce(channel_id, opts) {
+    const adapter = getChannel(channel_id);
+    if (!adapter)
+        throw new Error(`flushChannelOnce: ${channel_id} not registered`);
+    const logger = opts.logger ?? noopLogger;
+    const rows = await claimDueDeliveries(channel_id, opts.batchSize);
+    if (rows.length === 0)
+        return { processed: 0, sent: 0, failed: 0, retried: 0 };
+    let sent = 0, failed = 0, retried = 0;
+    const runOne = async (row) => {
+        try {
+            const recipient = await opts.resolveRecipient(row.user_id, row.scope_id, channel_id);
+            if (!recipient) {
+                await markDeliveryFailed(row.delivery_id, "no_recipient");
+                failed++;
+                return;
+            }
+            const rendered_bodies = await renderForChannel(adapter, {
+                scope_id: row.scope_id, payload: row.payload,
+            });
+            const branding = opts.resolveScopeBranding
+                ? await opts.resolveScopeBranding(row.scope_id)
+                : null;
+            const result = await adapter.send(row.payload, {
+                inbox_id: row.inbox_id,
+                scope_id: row.scope_id,
+                user_id: row.user_id,
+                attempt_count: row.attempt_count,
+                recipient,
+                rendered_bodies,
+                branding,
+                logger,
+            });
+            if (result.ok) {
+                await markDeliverySent(row.delivery_id, result.message_id ?? "");
+                sent++;
+                return;
+            }
+            // attempt_count was already incremented at claim (spec §7.2).
+            // First attempt has attempt_count = 1, so `1 < max_attempts` means retry is available.
+            if (result.retryable && row.attempt_count < adapter.capabilities.retry.max_attempts) {
+                const delay = adapter.capabilities.retry.backoff_ms(row.attempt_count, result.retry_after_ms);
+                await rescheduleDelivery(row.delivery_id, new Date(Date.now() + delay).toISOString(), result.error ?? "transient");
+                retried++;
+                return;
+            }
+            await markDeliveryFailed(row.delivery_id, result.error ?? "send_failed");
+            failed++;
+        }
+        catch (e) {
+            // Uncaught adapter exceptions are conservatively treated as retryable up to the cap (spec §7.2).
+            const err = e instanceof Error ? e.message : String(e);
+            if (row.attempt_count < adapter.capabilities.retry.max_attempts) {
+                const delay = adapter.capabilities.retry.backoff_ms(row.attempt_count);
+                await rescheduleDelivery(row.delivery_id, new Date(Date.now() + delay).toISOString(), err);
+                retried++;
+            }
+            else {
+                await markDeliveryFailed(row.delivery_id, err);
+                failed++;
+            }
+        }
+    };
+    // Bounded concurrency: spin up `concurrency` workers that drain the queue.
+    const queue = [...rows];
+    await Promise.all(Array.from({ length: Math.max(1, opts.concurrency) }, async () => {
+        while (queue.length > 0) {
+            const next = queue.shift();
+            if (next)
+                await runOne(next);
+        }
+    }));
+    return { processed: rows.length, sent, failed, retried };
+}
+//# sourceMappingURL=flush.js.map