hazo_notify 3.1.0 → 5.0.0

package/dist/lib/inbox/dialects/sqlite.js

@@ -0,0 +1,120 @@
+// src/lib/inbox/dialects/sqlite.ts
+// SQLite uses ? params (not $1), no jsonb cast, app-supplied UUIDs,
+// and SELECT ... RETURNING (3.35+).
+//
+// Concurrent claim: SQLite is single-writer; a BEGIN IMMEDIATE transaction
+// serialises the claim+update step. SKIP LOCKED is not needed.
+//
+// Insert-vs-update detection:
+//   `rowid = last_insert_rowid()` is unreliable for ON CONFLICT DO UPDATE —
+//   SQLite sets last_insert_rowid() to the existing row's rowid on conflict,
+//   so the expression is always 1 (true). Instead:
+//   - inbox rows: check `aggregate_count = 1` (1 means freshly inserted)
+//   - deliveries: check `id = ?` with the candidate new_id (true on fresh insert)
+//
+// Datetime format:
+//   The dispatcher stores flush_after as a JS ISO 8601 string ("2026-05-16T13:00:00.000Z").
+//   SQLite's datetime('now') returns "2026-05-16 13:00:00" (space-separated, no ms/Z).
+//   Comparing them lexicographically always treats ISO as "greater", so `<= datetime('now')`
+//   is never true. Use strftime('%Y-%m-%dT%H:%M:%SZ','now') to match ISO format.
+import { randomUUID } from "crypto";
+export const SqliteDialect = {
+    async upsertInboxRow(conn, i) {
+        // Try INSERT; on conflict UPDATE; detect which path ran via aggregate_count.
+        // aggregate_count = 1 means freshly inserted (default value); > 1 means aggregated.
+        // (rowid = last_insert_rowid() is unreliable for ON CONFLICT DO UPDATE — see file header.)
+        const new_id = randomUUID();
+        const rows = await conn.raw(`INSERT INTO hazo_notify_inbox (
+         id, scope_id, user_id, event_type, subject_id, batch_key,
+         in_app_text, deep_link, payload, surfaces, batch_closed_at
+       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT (batch_key) WHERE batch_closed_at IS NULL DO UPDATE SET
+         aggregate_count = aggregate_count + 1,
+         in_app_text     = excluded.in_app_text,
+         payload         = excluded.payload,
+         updated_at      = datetime('now')
+       RETURNING id, aggregate_count`, [
+            new_id, i.scope_id, i.user_id, i.event_type, i.subject_id, i.batch_key,
+            i.in_app_text, i.deep_link,
+            JSON.stringify(i.payload), JSON.stringify(i.surfaces),
+            i.batch_closed_at,
+        ]);
+        return { id: rows[0].id, inserted: rows[0].aggregate_count === 1 };
+    },
+    async upsertDelivery(conn, i) {
+        // Detect insert-vs-update by comparing the returned id against the candidate new_id.
+        // On a fresh INSERT the returned id == new_id; on conflict the existing id is returned.
+        // (rowid = last_insert_rowid() is unreliable for ON CONFLICT DO UPDATE — see file header.)
+        const new_id = randomUUID();
+        const rows = await conn.raw(`INSERT INTO hazo_notify_channel_deliveries (
+         id, inbox_id, channel_id, payload, flush_after
+       ) VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT (inbox_id, channel_id) DO UPDATE SET
+         payload     = excluded.payload,
+         flush_after = CASE WHEN attempt_count = 0 THEN excluded.flush_after ELSE flush_after END,
+         updated_at  = datetime('now')
+       RETURNING id, attempt_count`, [new_id, i.inbox_id, i.channel_id, JSON.stringify(i.payload), i.flush_after]);
+        return {
+            id: rows[0].id,
+            inserted: rows[0].id === new_id,
+            attempt_in_flight: rows[0].attempt_count > 0,
+        };
+    },
+    async claimDueDeliveries(conn, channel_id, batch_size) {
+        // Two-step under BEGIN IMMEDIATE: select candidate ids, then UPDATE+RETURNING.
+        //
+        // flush_after is stored as ISO 8601 ("2026-05-16T13:00:00.000Z").
+        // SQLite's datetime('now') returns "2026-05-16 13:00:00" (space-separated, no Z).
+        // These are lexicographically incompatible, so we use strftime('%Y-%m-%dT%H:%M:%SZ','now')
+        // to match the ISO format stored in flush_after. See file header for full explanation.
+        return await conn.raw(`WITH claimed AS (
+         SELECT id FROM hazo_notify_channel_deliveries
+          WHERE channel_id = ? AND status = 'pending'
+            AND flush_after <= strftime('%Y-%m-%dT%H:%M:%SZ', 'now')
+          ORDER BY flush_after ASC LIMIT ?
+       )
+       UPDATE hazo_notify_channel_deliveries
+          SET attempt_count = attempt_count + 1, updated_at = datetime('now')
+        WHERE id IN (SELECT id FROM claimed)
+       RETURNING
+         id AS delivery_id, inbox_id, channel_id, payload, attempt_count,
+         (SELECT user_id FROM hazo_notify_inbox WHERE id = inbox_id) AS user_id,
+         (SELECT scope_id FROM hazo_notify_inbox WHERE id = inbox_id) AS scope_id`, [channel_id, batch_size]);
+    },
+    async markDeliverySent(conn, id, message_id) {
+        await conn.raw(`UPDATE hazo_notify_channel_deliveries
+          SET status='sent', message_id=?, finalized_at=datetime('now'), updated_at=datetime('now')
+        WHERE id=?`, [message_id, id]);
+    },
+    async markDeliveryFailed(conn, id, error) {
+        await conn.raw(`UPDATE hazo_notify_channel_deliveries
+          SET status='failed', last_error=?, finalized_at=datetime('now'), updated_at=datetime('now')
+        WHERE id=?`, [error.slice(0, 1000), id]);
+    },
+    async rescheduleDelivery(conn, id, flush_after, error) {
+        await conn.raw(`UPDATE hazo_notify_channel_deliveries
+          SET flush_after=?, last_error=?, updated_at=datetime('now')
+        WHERE id=?`, [flush_after, error.slice(0, 1000), id]);
+    },
+    async closeStaleBatches(conn, window_ms) {
+        const rows = await conn.raw(`UPDATE hazo_notify_inbox
+          SET batch_closed_at = datetime('now')
+        WHERE batch_closed_at IS NULL
+          AND datetime(created_at, '+' || ? || ' seconds') < datetime('now')
+        RETURNING id`, [Math.floor(window_ms / 1000)]);
+        return rows.length;
+    },
+    async purgeReadInbox(conn, older_than) {
+        const rows = await conn.raw(`DELETE FROM hazo_notify_inbox
+        WHERE read_at IS NOT NULL AND read_at < ?
+        RETURNING id`, [older_than]);
+        return rows.length;
+    },
+    async purgeFinalizedDeliveries(conn, older_than) {
+        const rows = await conn.raw(`DELETE FROM hazo_notify_channel_deliveries
+        WHERE finalized_at IS NOT NULL AND finalized_at < ?
+        RETURNING id`, [older_than]);
+        return rows.length;
+    },
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/lib/inbox/dialects/sqlite.js.map

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

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

@@ -0,0 +1,53 @@
+import type { HazoConnectInstance } from "../../template_manager/types.js";
+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: {
+        in_app: boolean;
+        banner: boolean;
+    };
+    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;
+}
+export interface InboxDialect {
+    upsertInboxRow(conn: HazoConnectInstance, input: UpsertInboxRowInput): Promise<UpsertInboxRowResult>;
+    upsertDelivery(conn: HazoConnectInstance, input: UpsertDeliveryInput): Promise<UpsertDeliveryResult>;
+    claimDueDeliveries(conn: HazoConnectInstance, channel_id: string, batch_size: number): Promise<ClaimedDelivery[]>;
+    markDeliverySent(conn: HazoConnectInstance, delivery_id: string, message_id: string): Promise<void>;
+    markDeliveryFailed(conn: HazoConnectInstance, delivery_id: string, error: string): Promise<void>;
+    rescheduleDelivery(conn: HazoConnectInstance, delivery_id: string, flush_after: string, error: string): Promise<void>;
+    closeStaleBatches(conn: HazoConnectInstance, window_ms: number): Promise<number>;
+    purgeReadInbox(conn: HazoConnectInstance, older_than: string): Promise<number>;
+    purgeFinalizedDeliveries(conn: HazoConnectInstance, older_than: string): Promise<number>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/inbox/dialects/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrG,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAClH,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtH,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1F"}

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

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

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

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

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

@@ -0,0 +1,9 @@
+export { initInbox } from "./connection.js";
+export type { InitInboxOptions } from "./connection.js";
+export type { InboxRow, DeliveryRow, NotificationSurfaces, DispatchInput, DispatchResult, } from "./types.js";
+export { listUnreadForUser, unreadCount, markRead, markAllRead, } from "./storage.js";
+export { startInboxWorker } from "./worker/start.js";
+export type { StartInboxWorkerOptions, WorkerHandle } from "./worker/start.js";
+export { flushChannelOnce } from "./worker/flush.js";
+export type { FlushOptions, FlushResult } from "./worker/flush.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/inbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACV,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAC3C,aAAa,EAAE,cAAc,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GACtD,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lib/inbox/index.js

@@ -0,0 +1,6 @@
+// src/lib/inbox/index.ts — replacement
+export { initInbox } from "./connection.js";
+export { listUnreadForUser, unreadCount, markRead, markAllRead, } from "./storage.js";
+export { startInboxWorker } from "./worker/start.js";
+export { flushChannelOnce } from "./worker/flush.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/inbox/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,OAAO,EACL,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GACtD,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,142 @@
+import type { UpsertInboxRowInput, UpsertInboxRowResult, UpsertDeliveryInput, UpsertDeliveryResult, ClaimedDelivery, InboxRow } from "./types.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 declare function upsertInboxRow(i: UpsertInboxRowInput): Promise<UpsertInboxRowResult>;
+/**
+ * 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 declare function upsertDelivery(i: UpsertDeliveryInput): Promise<UpsertDeliveryResult>;
+export declare function claimDueDeliveries(channel_id: string, batch_size: number): Promise<ClaimedDelivery[]>;
+/**
+ * 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 declare function markDeliverySent(id: string, message_id: string): Promise<void>;
+/**
+ * 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 declare function markDeliveryFailed(id: string, error: string): Promise<void>;
+/**
+ * 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 declare function rescheduleDelivery(id: string, flush_after: string, error: string): Promise<void>;
+/**
+ * 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 declare function closeStaleBatches(window_ms: number): Promise<number>;
+/**
+ * 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 declare function purgeReadInbox(older_than: string): Promise<number>;
+/**
+ * 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 declare function purgeFinalizedDeliveries(older_than: string): Promise<number>;
+export interface ListOptions {
+    limit?: number;
+    cursor?: string;
+    surface?: "in_app" | "banner";
+}
+/**
+ * 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 declare function listUnreadForUser(user_id: string, scope_id: string, opts?: ListOptions): Promise<InboxRow[]>;
+/**
+ * Task 2.12b — unreadCount via QueryBuilder
+ *
+ * Counts unread inbox rows for the given user/scope.
+ * QueryBuilder 'is' with null → IS NULL.
+ */
+export declare function unreadCount(user_id: string, scope_id: string): Promise<number>;
+/**
+ * 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 declare function markRead(id: string, user_id: string): Promise<boolean>;
+/**
+ * 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 declare function markAllRead(user_id: string, scope_id: string): Promise<number>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/lib/inbox/storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0C1F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2C1F;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwD3G;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxE;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlF;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAarB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF"}