@xemahq/ui-kernel 0.6.1 → 0.8.0

package/dist/offline/outbox.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Outbox = void 0;
+const id_1 = require("./id");
+const online_controller_1 = require("./online-controller");
+const storage_1 = require("./storage");
+const types_1 = require("./types");
+function statusOf(err) {
+    if (!err || typeof err !== 'object') {
+        return undefined;
+    }
+    const e = err;
+    if (typeof e.status === 'number') {
+        return e.status;
+    }
+    if (e.response && typeof e.response.status === 'number') {
+        return e.response.status;
+    }
+    return undefined;
+}
+function defaultIsRetriable(err) {
+    if ((0, online_controller_1.isNetworkUnavailableError)(err)) {
+        return true;
+    }
+    const status = statusOf(err);
+    if (status === undefined) {
+        return true;
+    }
+    return status >= 500 || status === 429 || status === 408;
+}
+class Outbox {
+    storage;
+    online;
+    maxAttempts;
+    baseBackoffMs;
+    maxBackoffMs;
+    isRetriable;
+    now;
+    scheduler;
+    executors = new Map();
+    listeners = new Set();
+    cache = [];
+    snapshot = {
+        entries: [],
+        pendingCount: 0,
+        failedCount: 0,
+        draining: false,
+        online: true,
+    };
+    draining = false;
+    drainRequested = false;
+    retryScheduled = false;
+    drainPromise = null;
+    unsubscribeOnline = null;
+    constructor(opts = {}) {
+        this.storage = opts.storage ?? (0, storage_1.createDefaultOutboxStorage)();
+        this.online = opts.online ?? new online_controller_1.OnlineController();
+        this.maxAttempts = opts.maxAttempts ?? 5;
+        this.baseBackoffMs = opts.baseBackoffMs ?? 1000;
+        this.maxBackoffMs = opts.maxBackoffMs ?? 60_000;
+        this.isRetriable = opts.isRetriable ?? defaultIsRetriable;
+        this.now = opts.now ?? (() => Date.now());
+        this.scheduler =
+            opts.scheduler ?? ((fn, ms) => void setTimeout(fn, ms));
+    }
+    registerExecutor(kind, executor) {
+        this.executors.set(kind, executor);
+        void this.drain();
+    }
+    hasExecutor(kind) {
+        return this.executors.has(kind);
+    }
+    async start() {
+        this.online.start();
+        this.unsubscribeOnline?.();
+        this.unsubscribeOnline = this.online.subscribe((online) => {
+            if (online) {
+                void this.drain();
+            }
+            else {
+                this.notify();
+            }
+        });
+        await this.hydrate();
+        void this.drain();
+    }
+    stop() {
+        this.online.stop();
+        this.unsubscribeOnline?.();
+        this.unsubscribeOnline = null;
+    }
+    isOnline() {
+        return this.online.isOnline();
+    }
+    async enqueue(kind, payload, opts = {}) {
+        const ts = this.now();
+        const entry = {
+            id: (0, id_1.newId)(),
+            kind,
+            payload,
+            idempotencyKey: opts.idempotencyKey ?? (0, id_1.newId)(),
+            status: types_1.OutboxEntryStatus.Pending,
+            attempts: 0,
+            createdAt: ts,
+            updatedAt: ts,
+            ...(opts.label !== undefined ? { label: opts.label } : {}),
+        };
+        await this.storage.put(entry);
+        await this.refresh();
+        void this.drain();
+        return entry;
+    }
+    async retry(id) {
+        const entry = this.cache.find((e) => e.id === id);
+        if (!entry) {
+            return;
+        }
+        await this.storage.put({
+            ...entry,
+            status: types_1.OutboxEntryStatus.Pending,
+            attempts: 0,
+            updatedAt: this.now(),
+        });
+        await this.refresh();
+        void this.drain();
+    }
+    async discard(id) {
+        await this.storage.delete(id);
+        await this.refresh();
+    }
+    async clear() {
+        await this.storage.clear();
+        await this.refresh();
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot);
+        return () => this.listeners.delete(listener);
+    }
+    async drain() {
+        if (!this.online.isOnline()) {
+            return;
+        }
+        if (this.drainPromise) {
+            this.drainRequested = true;
+            return this.drainPromise;
+        }
+        this.drainPromise = this.runDrain();
+        try {
+            await this.drainPromise;
+        }
+        finally {
+            this.drainPromise = null;
+        }
+    }
+    async runDrain() {
+        this.draining = true;
+        this.notify();
+        try {
+            do {
+                this.drainRequested = false;
+                await this.drainOnce();
+            } while (this.drainRequested && this.online.isOnline());
+        }
+        finally {
+            this.draining = false;
+            this.notify();
+        }
+    }
+    async hydrate() {
+        const stored = await this.storage.getAll();
+        for (const entry of stored) {
+            if (entry.status === types_1.OutboxEntryStatus.Inflight) {
+                entry.status = types_1.OutboxEntryStatus.Pending;
+                await this.storage.put(entry);
+            }
+        }
+        await this.refresh();
+    }
+    async drainOnce() {
+        const entries = await this.storage.getAll();
+        for (const entry of entries) {
+            if (!this.online.isOnline()) {
+                break;
+            }
+            if (entry.status === types_1.OutboxEntryStatus.Failed) {
+                continue;
+            }
+            const executor = this.executors.get(entry.kind);
+            if (!executor) {
+                continue;
+            }
+            const attempt = entry.attempts + 1;
+            await this.write({ ...entry, status: types_1.OutboxEntryStatus.Inflight, attempts: attempt });
+            try {
+                await executor(entry.payload, {
+                    idempotencyKey: entry.idempotencyKey,
+                    attempt,
+                    entryId: entry.id,
+                });
+                await this.storage.delete(entry.id);
+                await this.refresh();
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if ((0, online_controller_1.isNetworkUnavailableError)(err)) {
+                    await this.write({ ...entry, status: types_1.OutboxEntryStatus.Pending, attempts: entry.attempts, lastError: message });
+                    this.scheduleRetry(entry.attempts + 1);
+                    break;
+                }
+                if (this.isRetriable(err) && attempt < this.maxAttempts) {
+                    await this.write({ ...entry, status: types_1.OutboxEntryStatus.Retrying, attempts: attempt, lastError: message });
+                    this.scheduleRetry(attempt);
+                }
+                else {
+                    await this.write({ ...entry, status: types_1.OutboxEntryStatus.Failed, attempts: attempt, lastError: message });
+                }
+            }
+        }
+    }
+    scheduleRetry(attempt) {
+        if (this.retryScheduled) {
+            return;
+        }
+        this.retryScheduled = true;
+        const delay = Math.min(this.maxBackoffMs, this.baseBackoffMs * 2 ** Math.max(0, attempt - 1));
+        this.scheduler(() => {
+            this.retryScheduled = false;
+            void this.drain();
+        }, delay);
+    }
+    async write(entry) {
+        await this.storage.put({ ...entry, updatedAt: this.now() });
+        await this.refresh();
+    }
+    async refresh() {
+        this.cache = await this.storage.getAll();
+        this.notify();
+    }
+    notify() {
+        this.snapshot = {
+            entries: this.cache,
+            pendingCount: this.cache.filter((e) => e.status !== types_1.OutboxEntryStatus.Failed).length,
+            failedCount: this.cache.filter((e) => e.status === types_1.OutboxEntryStatus.Failed).length,
+            draining: this.draining,
+            online: this.online.isOnline(),
+        };
+        for (const l of this.listeners) {
+            l(this.snapshot);
+        }
+    }
+}
+exports.Outbox = Outbox;
+//# sourceMappingURL=outbox.js.map

package/dist/offline/outbox.js.map

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

package/dist/offline/react.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import { Outbox, type OutboxOptions } from './outbox';
+import type { OutboxSnapshot } from './types';
+export interface OutboxProviderProps {
+    outbox?: Outbox;
+    options?: OutboxOptions;
+    children: ReactNode;
+}
+export declare function OutboxProvider({ outbox, options, children }: OutboxProviderProps): JSX.Element;
+export declare function useOutbox(): Outbox;
+export declare function useOutboxSnapshot(outbox?: Outbox): OutboxSnapshot;
+export declare function useOnlineStatus(outbox?: Outbox): boolean;
+//# sourceMappingURL=react.d.ts.map

package/dist/offline/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/offline/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,mBAAmB;IAElC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAID,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAY9F;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAQjE;AAGD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/offline/react.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxProvider = OutboxProvider;
+exports.useOutbox = useOutbox;
+exports.useOutboxSnapshot = useOutboxSnapshot;
+exports.useOnlineStatus = useOnlineStatus;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const outbox_1 = require("./outbox");
+const OutboxContext = (0, react_1.createContext)(null);
+function OutboxProvider({ outbox, options, children }) {
+    const optionsRef = (0, react_1.useRef)(options);
+    const instance = (0, react_1.useMemo)(() => outbox ?? new outbox_1.Outbox(optionsRef.current), [outbox]);
+    (0, react_1.useEffect)(() => {
+        void instance.start();
+        return () => instance.stop();
+    }, [instance]);
+    return (0, jsx_runtime_1.jsx)(OutboxContext.Provider, { value: instance, children: children });
+}
+function useOutbox() {
+    const ctx = (0, react_1.useContext)(OutboxContext);
+    if (!ctx) {
+        throw new Error('useOutbox must be used within an <OutboxProvider>.');
+    }
+    return ctx;
+}
+function resolveOutbox(explicit, ctx) {
+    const instance = explicit ?? ctx;
+    if (!instance) {
+        throw new Error('An <OutboxProvider> or an explicit outbox is required.');
+    }
+    return instance;
+}
+function useOutboxSnapshot(outbox) {
+    const ctx = (0, react_1.useContext)(OutboxContext);
+    const instance = resolveOutbox(outbox, ctx);
+    return (0, react_1.useSyncExternalStore)((cb) => instance.subscribe(cb), () => instance.getSnapshot(), () => instance.getSnapshot());
+}
+function useOnlineStatus(outbox) {
+    return useOutboxSnapshot(outbox).online;
+}
+//# sourceMappingURL=react.js.map

package/dist/offline/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/offline/react.tsx"],"names":[],"mappings":";;AAyBA,wCAYC;AAED,8BAMC;AAYD,8CAQC;AAGD,0CAEC;;AAtED,iCAQe;AAEf,qCAAsD;AAItD,MAAM,aAAa,GAAG,IAAA,qBAAa,EAAgB,IAAI,CAAC,CAAC;AAWzD,SAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAuB;IAG/E,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,MAAM,IAAI,IAAI,eAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO,uBAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAA0B,CAAC;AACtF,CAAC;AAED,SAAgB,SAAS;IACvB,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,aAAa,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,QAA4B,EAAE,GAAkB;IACrE,MAAM,QAAQ,GAAG,QAAQ,IAAI,GAAG,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAID,SAAgB,iBAAiB,CAAC,MAAe;IAC/C,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,aAAa,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,IAAA,4BAAoB,EACzB,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,EAC9B,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,EAC5B,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,CAC7B,CAAC;AACJ,CAAC;AAGD,SAAgB,eAAe,CAAC,MAAe;IAC7C,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC"}

package/dist/offline/storage.d.ts

@@ -0,0 +1,22 @@
+import type { OutboxEntry, OutboxStorage } from './types';
+export declare class InMemoryOutboxStorage implements OutboxStorage {
+    private readonly map;
+    getAll(): Promise<OutboxEntry[]>;
+    put(entry: OutboxEntry): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare class IndexedDbOutboxStorage implements OutboxStorage {
+    private readonly dbName;
+    private readonly storeName;
+    private dbPromise;
+    constructor(dbName?: string, storeName?: string);
+    private open;
+    private tx;
+    getAll(): Promise<OutboxEntry[]>;
+    put(entry: OutboxEntry): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare function createDefaultOutboxStorage(): OutboxStorage;
+//# sourceMappingURL=storage.d.ts.map

package/dist/offline/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/offline/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1D,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkC;IAEhD,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIhC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAMD,qBAAa,sBAAuB,YAAW,aAAa;IAIxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,SAAS,CAAqC;gBAGnC,MAAM,SAAwB,EAC9B,SAAS,SAAY;IAGxC,OAAO,CAAC,IAAI;YAkBE,EAAE;IAwBV,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKhC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAID,wBAAgB,0BAA0B,IAAI,aAAa,CAS1D"}

package/dist/offline/storage.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDbOutboxStorage = exports.InMemoryOutboxStorage = void 0;
+exports.createDefaultOutboxStorage = createDefaultOutboxStorage;
+class InMemoryOutboxStorage {
+    map = new Map();
+    async getAll() {
+        return [...this.map.values()].sort((a, b) => a.createdAt - b.createdAt);
+    }
+    async put(entry) {
+        this.map.set(entry.id, { ...entry });
+    }
+    async delete(id) {
+        this.map.delete(id);
+    }
+    async clear() {
+        this.map.clear();
+    }
+}
+exports.InMemoryOutboxStorage = InMemoryOutboxStorage;
+const DB_VERSION = 1;
+class IndexedDbOutboxStorage {
+    dbName;
+    storeName;
+    dbPromise = null;
+    constructor(dbName = 'xema-offline-outbox', storeName = 'entries') {
+        this.dbName = dbName;
+        this.storeName = storeName;
+    }
+    open() {
+        if (this.dbPromise) {
+            return this.dbPromise;
+        }
+        this.dbPromise = new Promise((resolve, reject) => {
+            const req = indexedDB.open(this.dbName, DB_VERSION);
+            req.onupgradeneeded = () => {
+                const db = req.result;
+                if (!db.objectStoreNames.contains(this.storeName)) {
+                    db.createObjectStore(this.storeName, { keyPath: 'id' });
+                }
+            };
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error ?? new Error('indexedDB open failed'));
+        });
+        return this.dbPromise;
+    }
+    async tx(mode, run) {
+        const db = await this.open();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(this.storeName, mode);
+            const store = transaction.objectStore(this.storeName);
+            let request;
+            try {
+                request = run(store);
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            transaction.onabort = () => reject(transaction.error ?? new Error('indexedDB tx aborted'));
+            transaction.oncomplete = () => resolve(request ? request.result : undefined);
+            transaction.onerror = () => reject(transaction.error ?? new Error('indexedDB tx error'));
+        });
+    }
+    async getAll() {
+        const all = (await this.tx('readonly', (s) => s.getAll())) ?? [];
+        return all.sort((a, b) => a.createdAt - b.createdAt);
+    }
+    async put(entry) {
+        await this.tx('readwrite', (s) => s.put(entry));
+    }
+    async delete(id) {
+        await this.tx('readwrite', (s) => s.delete(id));
+    }
+    async clear() {
+        await this.tx('readwrite', (s) => s.clear());
+    }
+}
+exports.IndexedDbOutboxStorage = IndexedDbOutboxStorage;
+function createDefaultOutboxStorage() {
+    if (typeof indexedDB !== 'undefined') {
+        try {
+            return new IndexedDbOutboxStorage();
+        }
+        catch {
+        }
+    }
+    return new InMemoryOutboxStorage();
+}
+//# sourceMappingURL=storage.js.map

package/dist/offline/storage.js.map

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

package/dist/offline/types.d.ts

@@ -0,0 +1,38 @@
+export declare enum OutboxEntryStatus {
+    Pending = "pending",
+    Inflight = "inflight",
+    Retrying = "retrying",
+    Failed = "failed"
+}
+export interface OutboxEntry<TPayload = unknown> {
+    id: string;
+    kind: string;
+    payload: TPayload;
+    idempotencyKey: string;
+    status: OutboxEntryStatus;
+    attempts: number;
+    createdAt: number;
+    updatedAt: number;
+    lastError?: string;
+    label?: string;
+}
+export interface OutboxStorage {
+    getAll(): Promise<OutboxEntry[]>;
+    put(entry: OutboxEntry): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface OutboxExecuteContext {
+    idempotencyKey: string;
+    attempt: number;
+    entryId: string;
+}
+export type OutboxExecutor<TPayload = unknown> = (payload: TPayload, ctx: OutboxExecuteContext) => Promise<void>;
+export interface OutboxSnapshot {
+    entries: OutboxEntry[];
+    pendingCount: number;
+    failedCount: number;
+    draining: boolean;
+    online: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/offline/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/offline/types.ts"],"names":[],"mappings":"AAWA,oBAAY,iBAAiB;IAE3B,OAAO,YAAY;IAEnB,QAAQ,aAAa;IAErB,QAAQ,aAAa;IAErB,MAAM,WAAW;CAClB;AAID,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAE7C,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;IAElB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,aAAa;IAC5B,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,oBAAoB;IAEnC,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,MAAM,cAAc,CAAC,QAAQ,GAAG,OAAO,IAAI,CAC/C,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,oBAAoB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAGnB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,OAAO,CAAC;IAElB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/offline/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxEntryStatus = void 0;
+var OutboxEntryStatus;
+(function (OutboxEntryStatus) {
+    OutboxEntryStatus["Pending"] = "pending";
+    OutboxEntryStatus["Inflight"] = "inflight";
+    OutboxEntryStatus["Retrying"] = "retrying";
+    OutboxEntryStatus["Failed"] = "failed";
+})(OutboxEntryStatus || (exports.OutboxEntryStatus = OutboxEntryStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/offline/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/offline/types.ts"],"names":[],"mappings":";;;AAWA,IAAY,iBASX;AATD,WAAY,iBAAiB;IAE3B,wCAAmB,CAAA;IAEnB,0CAAqB,CAAA;IAErB,0CAAqB,CAAA;IAErB,sCAAiB,CAAA;AACnB,CAAC,EATW,iBAAiB,iCAAjB,iBAAiB,QAS5B"}

package/dist/ui/branding/app-branding-provider.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { BrandingConfig } from '@xemahq/kernel-contracts/app-runtime';
+import type { BrandingConfig } from '@xemahq/kernel-contracts/app-platform';
 export declare const APP_PRIMARY_COLOR_VAR = "--app-primary-color";
 export interface AppBrandingContextValue {
     readonly displayName: string;

package/dist/ui/branding/app-branding-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-branding-provider.d.ts","sourceRoot":"","sources":["../../../src/ui/branding/app-branding-provider.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAW3E,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAG3D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAWD,wBAAgB,cAAc,IAAI,uBAAuB,CAQxD;AAED,MAAM,WAAW,wBAAwB;IAEvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAMlC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAgDD,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,cAAc,EACd,SAAS,EACT,QAAQ,GACT,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CAmB/C"}
+{"version":3,"file":"app-branding-provider.d.ts","sourceRoot":"","sources":["../../../src/ui/branding/app-branding-provider.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAW5E,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAG3D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAWD,wBAAgB,cAAc,IAAI,uBAAuB,CAQxD;AAED,MAAM,WAAW,wBAAwB;IAEvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAMlC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAElD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAgDD,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,cAAc,EACd,SAAS,EACT,QAAQ,GACT,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,CAmB/C"}

package/dist/ui/capture/document-preview.d.ts

@@ -0,0 +1,12 @@
+import { type CaptureFieldSpec, type CaptureSchema, type CaptureSection, type CaptureValues } from './field-spec';
+export interface DocumentPreviewProps {
+    readonly fields?: readonly CaptureFieldSpec[];
+    readonly sections?: readonly CaptureSection[];
+    readonly schema?: CaptureSchema;
+    readonly values: CaptureValues;
+    readonly title?: string;
+    readonly emptyText?: string;
+    readonly className?: string;
+}
+export declare function DocumentPreview({ fields, sections, schema, values, title, emptyText, className }: DocumentPreviewProps): import("react").JSX.Element;
+//# sourceMappingURL=document-preview.d.ts.map

package/dist/ui/capture/document-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-preview.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/document-preview.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAc,MAAM,cAAc,CAAC;AAGhJ,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAe,EAAE,SAAS,EAAE,EAAE,oBAAoB,+BAmB5H"}

package/dist/ui/capture/document-preview.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentPreview = DocumentPreview;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cn_1 = require("../cn");
+const field_spec_1 = require("./field-spec");
+const value_format_1 = require("./value-format");
+function DocumentPreview({ fields, sections, schema, values, title, emptyText = '—', className }) {
+    const resolved = (0, field_spec_1.toSections)(sections ?? (fields ? fields : schema) ?? []);
+    return ((0, jsx_runtime_1.jsxs)("article", { className: (0, cn_1.cn)('rounded-xl border border-border bg-card p-5 text-card-foreground shadow-sm sm:p-6', className), children: [title ? (0, jsx_runtime_1.jsx)("h2", { className: "mb-4 text-title font-semibold tracking-tight text-ink", children: title }) : null, (0, jsx_runtime_1.jsx)("div", { className: "space-y-6", children: resolved.map((section) => ((0, jsx_runtime_1.jsxs)("section", { children: [section.title ? (0, jsx_runtime_1.jsx)("h3", { className: "mb-2 border-b border-rule pb-1 text-caption font-semibold uppercase tracking-wider text-ink-3", children: section.title }) : null, (0, jsx_runtime_1.jsx)("dl", { className: "grid grid-cols-1 gap-x-6 gap-y-3 sm:grid-cols-[minmax(8rem,12rem)_1fr]", children: section.fields.map((field) => ((0, jsx_runtime_1.jsx)(FieldRow, { field: field, value: values[field.key], emptyText: emptyText }, field.key))) })] }, section.key))) })] }));
+}
+function FieldRow({ field, value, emptyText }) {
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("dt", { className: "text-body-1 font-medium text-ink-3 sm:text-right", children: field.label }), (0, jsx_runtime_1.jsx)("dd", { className: "min-w-0 text-body-1 text-ink", children: renderValue(field, value, emptyText) })] }));
+}
+function renderValue(field, value, emptyText) {
+    if (field.type === field_spec_1.CaptureFieldType.Object) {
+        const record = (value && typeof value === 'object' && !Array.isArray(value) ? value : null);
+        if (!record)
+            return (0, jsx_runtime_1.jsx)("span", { className: "text-ink-3", children: emptyText });
+        return ((0, jsx_runtime_1.jsx)("dl", { className: "space-y-1 rounded-md border border-rule bg-paper-elev/40 p-2", children: (field.fields ?? []).map((child) => ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-wrap gap-2", children: [(0, jsx_runtime_1.jsxs)("dt", { className: "text-caption font-medium text-ink-3", children: [child.label, ":"] }), (0, jsx_runtime_1.jsx)("dd", { className: "text-caption text-ink", children: renderValue(child, record[child.key], emptyText) })] }, child.key))) }));
+    }
+    if (field.type === field_spec_1.CaptureFieldType.List) {
+        const items = (Array.isArray(value) ? value : []);
+        if (items.length === 0)
+            return (0, jsx_runtime_1.jsx)("span", { className: "text-ink-3", children: emptyText });
+        return ((0, jsx_runtime_1.jsx)("ol", { className: "space-y-2", children: items.map((item, index) => ((0, jsx_runtime_1.jsxs)("li", { className: "rounded-md border border-rule bg-paper-elev/40 p-2", children: [(0, jsx_runtime_1.jsxs)("p", { className: "mb-1 text-caption font-medium text-ink-3", children: [field.label, " #", index + 1] }), (0, jsx_runtime_1.jsx)("dl", { className: "space-y-1", children: (field.fields ?? []).map((child) => ((0, jsx_runtime_1.jsxs)("div", { className: "flex flex-wrap gap-2", children: [(0, jsx_runtime_1.jsxs)("dt", { className: "text-caption font-medium text-ink-3", children: [child.label, ":"] }), (0, jsx_runtime_1.jsx)("dd", { className: "text-caption text-ink", children: renderValue(child, item[child.key], emptyText) })] }, child.key))) })] }, index))) }));
+    }
+    const text = (0, value_format_1.formatScalar)(field, value, emptyText);
+    return (0, jsx_runtime_1.jsx)("span", { className: (0, cn_1.cn)(text === emptyText && 'text-ink-3'), children: text });
+}
+//# sourceMappingURL=document-preview.js.map

package/dist/ui/capture/document-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-preview.js","sourceRoot":"","sources":["../../../src/ui/capture/document-preview.tsx"],"names":[],"mappings":"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"}

package/dist/ui/capture/field-spec-to-zod.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+import { type CaptureFieldSpec, type CaptureSchema, type CaptureSection } from './field-spec';
+export declare function isEmptyValue(value: unknown): boolean;
+export declare function fieldSpecToZod(schema: CaptureSchema | readonly CaptureFieldSpec[] | readonly CaptureSection[]): z.ZodObject<z.ZodRawShape>;
+//# sourceMappingURL=field-spec-to-zod.d.ts.map

package/dist/ui/capture/field-spec-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-spec-to-zod.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/field-spec-to-zod.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAe,MAAM,cAAc,CAAC;AAG7H,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAoFD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,GAAG,SAAS,gBAAgB,EAAE,GAAG,SAAS,cAAc,EAAE,GAC9E,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAE5B"}