hazo_notify 3.0.0 → 4.0.2

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,21 @@
+import type { UpsertInboxRowInput, UpsertInboxRowResult, UpsertDeliveryInput, UpsertDeliveryResult, ClaimedDelivery } from "./dialects/types.js";
+import type { InboxRow } from "./types.js";
+export declare function upsertInboxRow(i: UpsertInboxRowInput): Promise<UpsertInboxRowResult>;
+export declare function upsertDelivery(i: UpsertDeliveryInput): Promise<UpsertDeliveryResult>;
+export declare function claimDueDeliveries(channel_id: string, batch_size: number): Promise<ClaimedDelivery[]>;
+export declare function markDeliverySent(id: string, message_id: string): Promise<void>;
+export declare function markDeliveryFailed(id: string, error: string): Promise<void>;
+export declare function rescheduleDelivery(id: string, flush_after: string, error: string): Promise<void>;
+export declare function closeStaleBatches(window_ms: number): Promise<number>;
+export declare function purgeReadInbox(older_than: string): Promise<number>;
+export declare function purgeFinalizedDeliveries(older_than: string): Promise<number>;
+export interface ListOptions {
+    limit?: number;
+    cursor?: string;
+    surface?: "in_app" | "banner";
+}
+export declare function listUnreadForUser(user_id: string, scope_id: string, opts?: ListOptions): Promise<InboxRow[]>;
+export declare function unreadCount(user_id: string, scope_id: string): Promise<number>;
+export declare function markRead(id: string, user_id: string): Promise<boolean>;
+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,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,wBAAsB,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAG1F;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAG1F;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAG3G;AAED,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAGpE;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAGjE;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,iBAGtF;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlF;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,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBrB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpF;AAED,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5E;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF"}

package/dist/lib/inbox/storage.js

@@ -0,0 +1,94 @@
+import { getInboxConnection } from "./connection.js";
+import { pickDialect } from "./dialects/index.js";
+function d() {
+    const conn = getInboxConnection();
+    return { conn, dialect: pickDialect(conn) };
+}
+export async function upsertInboxRow(i) {
+    const { conn, dialect } = d();
+    return dialect.upsertInboxRow(conn, i);
+}
+export async function upsertDelivery(i) {
+    const { conn, dialect } = d();
+    return dialect.upsertDelivery(conn, i);
+}
+export async function claimDueDeliveries(channel_id, batch_size) {
+    const { conn, dialect } = d();
+    return dialect.claimDueDeliveries(conn, channel_id, batch_size);
+}
+export async function markDeliverySent(id, message_id) {
+    const { conn, dialect } = d();
+    return dialect.markDeliverySent(conn, id, message_id);
+}
+export async function markDeliveryFailed(id, error) {
+    const { conn, dialect } = d();
+    return dialect.markDeliveryFailed(conn, id, error);
+}
+export async function rescheduleDelivery(id, flush_after, error) {
+    const { conn, dialect } = d();
+    return dialect.rescheduleDelivery(conn, id, flush_after, error);
+}
+export async function closeStaleBatches(window_ms) {
+    const { conn, dialect } = d();
+    return dialect.closeStaleBatches(conn, window_ms);
+}
+export async function purgeReadInbox(older_than) {
+    const { conn, dialect } = d();
+    return dialect.purgeReadInbox(conn, older_than);
+}
+export async function purgeFinalizedDeliveries(older_than) {
+    const { conn, dialect } = d();
+    return dialect.purgeFinalizedDeliveries(conn, older_than);
+}
+export async function listUnreadForUser(user_id, scope_id, opts = {}) {
+    const conn = getInboxConnection();
+    const limit = Math.min(opts.limit ?? 20, 100);
+    const isSqlite = conn.type === "sqlite";
+    const ph = (n) => (isSqlite ? "?" : `$${n}`);
+    const where = [`user_id = ${ph(1)}`, `scope_id = ${ph(2)}`, "read_at IS NULL"];
+    const params = [user_id, scope_id];
+    let i = 3;
+    if (opts.cursor) {
+        where.push(`created_at < ${ph(i)}`);
+        params.push(opts.cursor);
+        i++;
+    }
+    if (opts.surface) {
+        where.push(isSqlite
+            ? `json_extract(surfaces, '$.${opts.surface}') = 1`
+            : `(surfaces->>'${opts.surface}')::boolean = true`);
+    }
+    params.push(limit);
+    return await conn.raw(`SELECT * FROM hazo_notify_inbox WHERE ${where.join(" AND ")}
+     ORDER BY created_at DESC LIMIT ${ph(i)}`, params);
+}
+export async function unreadCount(user_id, scope_id) {
+    const conn = getInboxConnection();
+    const isSqlite = conn.type === "sqlite";
+    const rows = await conn.raw(`SELECT count(*) AS n FROM hazo_notify_inbox
+      WHERE user_id = ${isSqlite ? "?" : "$1"} AND scope_id = ${isSqlite ? "?" : "$2"} AND read_at IS NULL`, [user_id, scope_id]);
+    return Number(rows[0]?.n ?? 0);
+}
+export async function markRead(id, user_id) {
+    const conn = getInboxConnection();
+    const isSqlite = conn.type === "sqlite";
+    const sql = isSqlite
+        ? `UPDATE hazo_notify_inbox SET read_at=datetime('now')
+        WHERE id=? AND user_id=? AND read_at IS NULL RETURNING id`
+        : `UPDATE hazo_notify_inbox SET read_at=now()
+        WHERE id=$1 AND user_id=$2 AND read_at IS NULL RETURNING id`;
+    const rows = await conn.raw(sql, [id, user_id]);
+    return rows.length > 0;
+}
+export async function markAllRead(user_id, scope_id) {
+    const conn = getInboxConnection();
+    const isSqlite = conn.type === "sqlite";
+    const sql = isSqlite
+        ? `UPDATE hazo_notify_inbox SET read_at=datetime('now')
+        WHERE user_id=? AND scope_id=? AND read_at IS NULL RETURNING id`
+        : `UPDATE hazo_notify_inbox SET read_at=now()
+        WHERE user_id=$1 AND scope_id=$2 AND read_at IS NULL RETURNING id`;
+    const rows = await conn.raw(sql, [user_id, scope_id]);
+    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,57 @@
+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[];
+}
+//# 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":"AAAA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,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,oBAAoB,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"flush.js","sourceRoot":"","sources":["../../../../src/lib/inbox/worker/flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkB/C,MAAM,UAAU,GAAkB;IAChC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,IAAkB;IAElB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,iBAAiB,CAAC,CAAC;IAEhF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAE/E,IAAI,IAAI,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,KAAK,EAAE,GAAmB,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACrF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBAC1D,MAAM,EAAE,CAAC;gBACT,OAAO;YACT,CAAC;YAED,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE;gBACtD,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO;aAC7C,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB;gBACxC,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAgB,EAAE;gBACtD,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,aAAa,EAAE,GAAG,CAAC,aAAa;gBAChC,SAAS;gBACT,eAAe;gBACf,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,MAAM,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;gBACjE,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YAED,8DAA8D;YAC9D,uFAAuF;YACvF,IAAI,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACpF,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC9F,MAAM,kBAAkB,CACtB,GAAG,CAAC,WAAW,EACf,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,EAC1C,MAAM,CAAC,KAAK,IAAI,WAAW,CAC5B,CAAC;gBACF,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,MAAM,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;YACzE,MAAM,EAAE,CAAC;QACX,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,iGAAiG;YACjG,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAChE,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACvE,MAAM,kBAAkB,CACtB,GAAG,CAAC,WAAW,EACf,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,EAC1C,GAAG,CACJ,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;gBAC/C,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,2EAA2E;IAC3E,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,IAAI;gBAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}