@zeroback/client 0.0.1

package/dist/Backoff.d.ts

@@ -0,0 +1,10 @@
+export declare class Backoff {
+    private attempt;
+    private maxAttempts;
+    private baseMs;
+    private maxMs;
+    next(): number;
+    reset(): void;
+    shouldRetry(): boolean;
+}
+//# sourceMappingURL=Backoff.d.ts.map

package/dist/Backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backoff.d.ts","sourceRoot":"","sources":["../src/Backoff.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,KAAK,CAAS;IAEtB,IAAI,IAAI,MAAM;IASd,KAAK,IAAI,IAAI;IAIb,WAAW,IAAI,OAAO;CAGvB"}

package/dist/Backoff.js

@@ -0,0 +1,18 @@
+export class Backoff {
+    attempt = 0;
+    maxAttempts = 10;
+    baseMs = 100;
+    maxMs = 10000;
+    next() {
+        const delay = Math.min(this.baseMs * Math.pow(2, this.attempt) * (0.5 + Math.random()), this.maxMs);
+        this.attempt++;
+        return Math.floor(delay);
+    }
+    reset() {
+        this.attempt = 0;
+    }
+    shouldRetry() {
+        return this.attempt < this.maxAttempts;
+    }
+}
+//# sourceMappingURL=Backoff.js.map

package/dist/Backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backoff.js","sourceRoot":"","sources":["../src/Backoff.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAO;IACV,OAAO,GAAG,CAAC,CAAC;IACZ,WAAW,GAAG,EAAE,CAAC;IACjB,MAAM,GAAG,GAAG,CAAC;IACb,KAAK,GAAG,KAAK,CAAC;IAEtB,IAAI;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAC/D,IAAI,CAAC,KAAK,CACX,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;IACzC,CAAC;CACF"}

package/dist/ConvexClient.d.ts

@@ -0,0 +1,57 @@
+import { QueryStore } from "./QueryStore";
+import type { LocalStore, QueryKey } from "./QueryStore";
+import type { PersistenceAdapter } from "./persistence/PersistenceAdapter.js";
+export type ConnectionState = "connecting" | "connected" | "disconnected";
+export interface ConvexClientOptions {
+    persistence?: boolean | PersistenceAdapter;
+    maxCacheAge?: number;
+    schemaVersion?: string;
+}
+export declare class ConvexClient {
+    private ws;
+    private subscriptions;
+    private pendingRequests;
+    private url;
+    private backoff;
+    private isConnecting;
+    private messageQueue;
+    private closed;
+    private _connectionState;
+    private connectionListeners;
+    /** Centralized query result cache with optimistic update support. */
+    readonly queryStore: QueryStore;
+    /** Sequential mutation queue — ensures mutations execute one at a time in order. */
+    private mutationQueue;
+    private persistedMutationQueue;
+    private options;
+    constructor(url: string, options?: ConvexClientOptions);
+    /**
+     * Initialize the client with persistence.
+     * Hydrates cached data from IndexedDB, connects the WebSocket, and replays
+     * any persisted offline mutations. Only needed when persistence is enabled.
+     */
+    init(): Promise<void>;
+    private replayPersistedMutations;
+    hasServerResult(key: QueryKey): boolean;
+    get connectionState(): ConnectionState;
+    onConnectionChange(listener: (state: ConnectionState) => void): () => void;
+    private setConnectionState;
+    private connect;
+    private scheduleReconnect;
+    /** Re-subscribe all active subscriptions after reconnect or server reset. */
+    private resubscribeAll;
+    private flushMessageQueue;
+    private send;
+    subscribe(fnName: string, args: unknown, callback?: (data: unknown) => void): () => void;
+    /** Subscribe to changes for a specific query key in the centralized store. */
+    watchQuery(key: QueryKey, listener: () => void): () => void;
+    /** Get the current (merged base + optimistic) result for a query key. */
+    getQueryResult(key: QueryKey): unknown | undefined;
+    mutation(fnName: string, args: unknown, opts?: {
+        optimisticUpdate?: (store: LocalStore) => void;
+    }): Promise<unknown>;
+    action(fnName: string, args: unknown): Promise<unknown>;
+    private handleMessage;
+    close(): void;
+}
+//# sourceMappingURL=ConvexClient.d.ts.map

package/dist/ConvexClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConvexClient.d.ts","sourceRoot":"","sources":["../src/ConvexClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAGlB;IACL,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,mBAAmB,CAA+C;IAE1E,qEAAqE;IACrE,QAAQ,CAAC,UAAU,aAAoB;IAEvC,oFAAoF;IACpF,OAAO,CAAC,aAAa,CAAoC;IAEzD,OAAO,CAAC,sBAAsB,CAA8B;IAC5D,OAAO,CAAC,OAAO,CAAsB;gBAEzB,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAqBtD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMb,wBAAwB;IAatC,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO;IAIvC,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,kBAAkB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAK1E,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,OAAO;IA6Cf,OAAO,CAAC,iBAAiB;IAczB,6EAA6E;IAC7E,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,IAAI;IAQZ,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IASxF,8EAA8E;IAC9E,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3D,yEAAyE;IACzE,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS;IAIlD,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;KAAE,GACxD,OAAO,CAAC,OAAO,CAAC;IAoCb,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7D,OAAO,CAAC,aAAa;IAsDrB,KAAK,IAAI,IAAI;CAMd"}

package/dist/ConvexClient.js

@@ -0,0 +1,267 @@
+import { SubscriptionRegistry } from "./SubscriptionRegistry";
+import { Backoff } from "./Backoff";
+import { QueryStore } from "./QueryStore";
+import { IDBPersistence } from "./persistence/IDBPersistence.js";
+import { MutationQueue } from "./persistence/MutationQueue.js";
+export class ConvexClient {
+    ws = null;
+    subscriptions;
+    pendingRequests = new Map();
+    url;
+    backoff = new Backoff();
+    isConnecting = false;
+    messageQueue = [];
+    closed = false;
+    _connectionState = "disconnected";
+    connectionListeners = new Set();
+    /** Centralized query result cache with optimistic update support. */
+    queryStore = new QueryStore();
+    /** Sequential mutation queue — ensures mutations execute one at a time in order. */
+    mutationQueue = Promise.resolve();
+    persistedMutationQueue = null;
+    options;
+    constructor(url, options) {
+        this.url = url;
+        this.options = options ?? {};
+        this.subscriptions = new SubscriptionRegistry();
+        if (this.options.persistence) {
+            const adapter = typeof this.options.persistence === "object"
+                ? this.options.persistence
+                : new IDBPersistence(url, {
+                    maxCacheAge: this.options.maxCacheAge,
+                    schemaVersion: this.options.schemaVersion,
+                });
+            this.queryStore.setPersistence(adapter);
+            this.persistedMutationQueue = new MutationQueue(url);
+            // When persistence is enabled, defer connect() to init()
+        }
+        else {
+            this.connect();
+        }
+    }
+    /**
+     * Initialize the client with persistence.
+     * Hydrates cached data from IndexedDB, connects the WebSocket, and replays
+     * any persisted offline mutations. Only needed when persistence is enabled.
+     */
+    async init() {
+        await this.queryStore.hydrate();
+        this.connect();
+        await this.replayPersistedMutations();
+    }
+    async replayPersistedMutations() {
+        if (!this.persistedMutationQueue)
+            return;
+        const pending = await this.persistedMutationQueue.getAll();
+        for (const m of pending) {
+            try {
+                await this.mutation(m.fnName, m.args);
+            }
+            catch {
+                // Mutation failed on replay — discard it
+            }
+            await this.persistedMutationQueue.remove(m.id);
+        }
+    }
+    hasServerResult(key) {
+        return this.queryStore.hasServerConfirmation(key);
+    }
+    get connectionState() {
+        return this._connectionState;
+    }
+    onConnectionChange(listener) {
+        this.connectionListeners.add(listener);
+        return () => this.connectionListeners.delete(listener);
+    }
+    setConnectionState(state) {
+        if (this._connectionState === state)
+            return;
+        this._connectionState = state;
+        for (const listener of this.connectionListeners) {
+            listener(state);
+        }
+    }
+    connect() {
+        if (this.closed || this.isConnecting || (this.ws?.readyState === WebSocket.OPEN)) {
+            return;
+        }
+        this.isConnecting = true;
+        this.setConnectionState("connecting");
+        try {
+            this.ws = new WebSocket(this.url);
+        }
+        catch {
+            this.isConnecting = false;
+            this.setConnectionState("disconnected");
+            this.scheduleReconnect();
+            return;
+        }
+        this.ws.onopen = () => {
+            this.isConnecting = false;
+            this.backoff.reset();
+            this.setConnectionState("connected");
+            this.resubscribeAll();
+            this.flushMessageQueue();
+        };
+        this.ws.onmessage = (event) => {
+            try {
+                const msg = JSON.parse(event.data);
+                this.handleMessage(msg);
+            }
+            catch {
+                // Ignore unparseable messages
+            }
+        };
+        this.ws.onclose = () => {
+            this.isConnecting = false;
+            this.setConnectionState("disconnected");
+            if (!this.closed)
+                this.scheduleReconnect();
+        };
+        this.ws.onerror = () => {
+            this.isConnecting = false;
+        };
+    }
+    scheduleReconnect() {
+        if (this.closed || !this.backoff.shouldRetry()) {
+            // Reject all pending requests on permanent disconnect
+            for (const [id, pending] of this.pendingRequests) {
+                pending.reject(new Error("Connection lost"));
+                this.pendingRequests.delete(id);
+            }
+            return;
+        }
+        const delay = this.backoff.next();
+        setTimeout(() => this.connect(), delay);
+    }
+    /** Re-subscribe all active subscriptions after reconnect or server reset. */
+    resubscribeAll() {
+        for (const sub of this.subscriptions.getAll()) {
+            this.send({ type: "query", id: sub.id, fn: sub.fnName, args: sub.args });
+        }
+    }
+    flushMessageQueue() {
+        while (this.messageQueue.length > 0) {
+            const msg = this.messageQueue.shift();
+            this.send(msg);
+        }
+    }
+    send(msg) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(msg));
+        }
+        else {
+            this.messageQueue.push(msg);
+        }
+    }
+    subscribe(fnName, args, callback) {
+        const subId = this.subscriptions.add(fnName, args, callback ?? (() => { }));
+        this.send({ type: "query", id: subId, fn: fnName, args });
+        return () => {
+            this.subscriptions.remove(subId);
+            this.send({ type: "unsubscribe", id: subId });
+        };
+    }
+    /** Subscribe to changes for a specific query key in the centralized store. */
+    watchQuery(key, listener) {
+        return this.queryStore.subscribe(key, listener);
+    }
+    /** Get the current (merged base + optimistic) result for a query key. */
+    getQueryResult(key) {
+        return this.queryStore.getResult(key);
+    }
+    mutation(fnName, args, opts) {
+        const id = crypto.randomUUID();
+        // Apply optimistic update immediately (before waiting in queue)
+        if (opts?.optimisticUpdate) {
+            this.queryStore.addLayer(id, opts.optimisticUpdate);
+        }
+        // Persist mutation for offline replay (fire-and-forget)
+        if (this.persistedMutationQueue) {
+            this.persistedMutationQueue.add({ id, fnName, args, timestamp: Date.now() }).catch(() => { });
+        }
+        // Chain onto the mutation queue so mutations execute sequentially
+        const result = this.mutationQueue.then(async () => {
+            try {
+                const res = await new Promise((resolve, reject) => {
+                    this.pendingRequests.set(id, { resolve, reject });
+                    this.send({ type: "mutation", id, fn: fnName, args });
+                });
+                // Mutation succeeded — remove from persisted queue
+                this.persistedMutationQueue?.remove(id).catch(() => { });
+                return res;
+            }
+            finally {
+                if (opts?.optimisticUpdate) {
+                    this.queryStore.removeLayer(id);
+                }
+            }
+        });
+        // Update the queue — always resolve so subsequent mutations aren't blocked by failures
+        this.mutationQueue = result.then(() => { }, () => { });
+        return result;
+    }
+    async action(fnName, args) {
+        const id = crypto.randomUUID();
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            this.send({ type: "action", id, fn: fnName, args });
+        });
+    }
+    handleMessage(msg) {
+        switch (msg.type) {
+            case "result":
+            case "update": {
+                // Update centralized store
+                const sub = this.subscriptions.get(msg.id);
+                if (sub) {
+                    const key = QueryStore.makeKey(sub.fnName, sub.args);
+                    this.queryStore.setServerResult(key, msg.result);
+                }
+                // Also call subscription callback (for usePaginatedQuery and direct subscribers)
+                this.subscriptions.notify(msg.id, msg.result);
+                break;
+            }
+            case "updates":
+                for (const item of msg.items) {
+                    const sub = this.subscriptions.get(item.id);
+                    if (sub) {
+                        const key = QueryStore.makeKey(sub.fnName, sub.args);
+                        this.queryStore.setServerResult(key, item.result);
+                    }
+                    this.subscriptions.notify(item.id, item.result);
+                }
+                break;
+            case "mutationResult":
+            case "actionResult": {
+                const pending = this.pendingRequests.get(msg.id);
+                if (pending) {
+                    pending.resolve(msg.result);
+                    this.pendingRequests.delete(msg.id);
+                }
+                break;
+            }
+            case "error":
+                if (msg.id) {
+                    const pending = this.pendingRequests.get(msg.id);
+                    if (pending) {
+                        pending.reject(new Error(msg.message));
+                        this.pendingRequests.delete(msg.id);
+                    }
+                }
+                break;
+            case "reset":
+                // Server lost subscription state (e.g. hibernation wake) — re-subscribe
+                this.queryStore.clearServerConfirmations();
+                this.resubscribeAll();
+                break;
+        }
+    }
+    close() {
+        this.closed = true;
+        this.ws?.close();
+        this.ws = null;
+        this.setConnectionState("disconnected");
+    }
+}
+//# sourceMappingURL=ConvexClient.js.map

package/dist/ConvexClient.js.map

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

package/dist/Protocol.d.ts

@@ -0,0 +1,50 @@
+export type ClientMessage = {
+    type: "query";
+    id: string;
+    fn: string;
+    args: unknown;
+} | {
+    type: "mutation";
+    id: string;
+    fn: string;
+    args: unknown;
+} | {
+    type: "action";
+    id: string;
+    fn: string;
+    args: unknown;
+} | {
+    type: "unsubscribe";
+    id: string;
+};
+export type ServerMessage = {
+    type: "result";
+    id: string;
+    result: unknown;
+} | {
+    type: "update";
+    id: string;
+    result: unknown;
+} | {
+    type: "updates";
+    items: {
+        id: string;
+        result: unknown;
+    }[];
+} | {
+    type: "mutationResult";
+    id: string;
+    result: unknown;
+} | {
+    type: "actionResult";
+    id: string;
+    result: unknown;
+} | {
+    type: "error";
+    id?: string;
+    code: string;
+    message: string;
+} | {
+    type: "reset";
+};
+//# sourceMappingURL=Protocol.d.ts.map

package/dist/Protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Protocol.d.ts","sourceRoot":"","sources":["../src/Protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/Protocol.js

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

package/dist/Protocol.js.map

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

package/dist/QueryStore.d.ts

@@ -0,0 +1,31 @@
+import type { PersistenceAdapter } from "./persistence/PersistenceAdapter.js";
+export type QueryKey = string;
+export interface LocalStore {
+    getQuery(ref: {
+        _name: string;
+    } | string, args?: unknown): unknown | undefined;
+    setQuery(ref: {
+        _name: string;
+    } | string, args: unknown, value: unknown): void;
+}
+export declare class QueryStore {
+    private baseCache;
+    private mergedCache;
+    private layers;
+    private listeners;
+    private persistence;
+    private serverConfirmed;
+    static makeKey(fnName: string, args: unknown): string;
+    private static resolveName;
+    setPersistence(adapter: PersistenceAdapter): void;
+    hydrate(): Promise<void>;
+    setServerResult(key: QueryKey, result: unknown): void;
+    hasServerConfirmation(key: QueryKey): boolean;
+    clearServerConfirmations(): void;
+    addLayer(mutationId: string, updateFn: (store: LocalStore) => void): void;
+    removeLayer(mutationId: string): void;
+    getResult(key: QueryKey): unknown | undefined;
+    subscribe(key: QueryKey, listener: () => void): () => void;
+    private recomputeAndNotify;
+}
+//# sourceMappingURL=QueryStore.d.ts.map

package/dist/QueryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryStore.d.ts","sourceRoot":"","sources":["../src/QueryStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,qCAAqC,CAAC;AAE3F,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/E,QAAQ,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAChF;AAOD,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,eAAe,CAAuB;IAE9C,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM;IAIrD,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAI3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAOrD,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO;IAI7C,wBAAwB,IAAI,IAAI;IAIhC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAyBzE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAYrC,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS;IAI7C,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAa1D,OAAO,CAAC,kBAAkB;CA4B3B"}

package/dist/QueryStore.js

@@ -0,0 +1,111 @@
+export class QueryStore {
+    baseCache = new Map();
+    mergedCache = new Map();
+    layers = [];
+    listeners = new Map();
+    persistence = null;
+    serverConfirmed = new Set();
+    static makeKey(fnName, args) {
+        return fnName + "|" + JSON.stringify(args ?? {});
+    }
+    static resolveName(ref) {
+        return typeof ref === "string" ? ref : ref._name;
+    }
+    setPersistence(adapter) {
+        this.persistence = adapter;
+    }
+    async hydrate() {
+        if (!this.persistence)
+            return;
+        const entries = await this.persistence.getAll();
+        for (const [key, entry] of entries) {
+            this.baseCache.set(key, entry.result);
+            this.recomputeAndNotify(key);
+        }
+    }
+    setServerResult(key, result) {
+        this.baseCache.set(key, result);
+        this.serverConfirmed.add(key);
+        this.recomputeAndNotify(key);
+        this.persistence?.set(key, { result, timestamp: Date.now() }).catch(() => { });
+    }
+    hasServerConfirmation(key) {
+        return this.serverConfirmed.has(key);
+    }
+    clearServerConfirmations() {
+        this.serverConfirmed.clear();
+    }
+    addLayer(mutationId, updateFn) {
+        const changes = new Map();
+        const localStore = {
+            getQuery: (ref, args) => {
+                const key = QueryStore.makeKey(QueryStore.resolveName(ref), args);
+                return this.mergedCache.get(key);
+            },
+            setQuery: (ref, args, value) => {
+                const key = QueryStore.makeKey(QueryStore.resolveName(ref), args);
+                changes.set(key, value);
+            },
+        };
+        updateFn(localStore);
+        if (changes.size === 0)
+            return;
+        this.layers.push({ id: mutationId, changes });
+        for (const key of changes.keys()) {
+            this.recomputeAndNotify(key);
+        }
+    }
+    removeLayer(mutationId) {
+        const idx = this.layers.findIndex((l) => l.id === mutationId);
+        if (idx === -1)
+            return;
+        const affectedKeys = new Set(this.layers[idx].changes.keys());
+        this.layers.splice(idx, 1);
+        for (const key of affectedKeys) {
+            this.recomputeAndNotify(key);
+        }
+    }
+    getResult(key) {
+        return this.mergedCache.get(key);
+    }
+    subscribe(key, listener) {
+        let set = this.listeners.get(key);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(key, set);
+        }
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0)
+                this.listeners.delete(key);
+        };
+    }
+    recomputeAndNotify(key) {
+        let result = this.baseCache.get(key);
+        for (const layer of this.layers) {
+            if (layer.changes.has(key)) {
+                result = layer.changes.get(key);
+            }
+        }
+        const prev = this.mergedCache.get(key);
+        // Same reference — no change
+        if (prev === result)
+            return;
+        // Deep equality check to avoid unnecessary re-renders
+        try {
+            if (JSON.stringify(prev) === JSON.stringify(result))
+                return;
+        }
+        catch {
+            // stringify fails — treat as different
+        }
+        this.mergedCache.set(key, result);
+        const listeners = this.listeners.get(key);
+        if (listeners) {
+            for (const fn of listeners)
+                fn();
+        }
+    }
+}
+//# sourceMappingURL=QueryStore.js.map

package/dist/QueryStore.js.map

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

package/dist/SubscriptionRegistry.d.ts

@@ -0,0 +1,15 @@
+export interface SubscriptionEntry {
+    id: string;
+    fnName: string;
+    args: unknown;
+    callback: (data: unknown) => void;
+}
+export declare class SubscriptionRegistry {
+    private subs;
+    add(fnName: string, args: unknown, callback: (data: unknown) => void): string;
+    get(id: string): SubscriptionEntry | undefined;
+    remove(id: string): void;
+    notify(id: string, data: unknown): void;
+    getAll(): SubscriptionEntry[];
+}
+//# sourceMappingURL=SubscriptionRegistry.d.ts.map

package/dist/SubscriptionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionRegistry.d.ts","sourceRoot":"","sources":["../src/SubscriptionRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAwC;IAEpD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM;IAM7E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAOvC,MAAM,IAAI,iBAAiB,EAAE;CAG9B"}

package/dist/SubscriptionRegistry.js

@@ -0,0 +1,24 @@
+export class SubscriptionRegistry {
+    subs = new Map();
+    add(fnName, args, callback) {
+        const id = crypto.randomUUID();
+        this.subs.set(id, { id, fnName, args, callback });
+        return id;
+    }
+    get(id) {
+        return this.subs.get(id);
+    }
+    remove(id) {
+        this.subs.delete(id);
+    }
+    notify(id, data) {
+        const sub = this.subs.get(id);
+        if (sub) {
+            sub.callback(data);
+        }
+    }
+    getAll() {
+        return Array.from(this.subs.values());
+    }
+}
+//# sourceMappingURL=SubscriptionRegistry.js.map

package/dist/SubscriptionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionRegistry.js","sourceRoot":"","sources":["../src/SubscriptionRegistry.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,oBAAoB;IACvB,IAAI,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEpD,GAAG,CAAC,MAAc,EAAE,IAAa,EAAE,QAAiC;QAClE,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,IAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}