@gonvex/client 0.1.24 → 0.1.26

package/dist/outbox.js

@@ -0,0 +1,324 @@
+/**
+ * A durable, totally ordered mutation queue.
+ *
+ * The auto-incremented id is the enqueue order and is never reused while the
+ * database exists. `nextReady` may skip unrelated writes, but it never skips a
+ * lower-id write touching the same entity. An inflight entry remains a causal
+ * barrier until it is acknowledged, and `loadAll` recovers abandoned inflight
+ * work after a crash by returning it to pending.
+ *
+ * IndexedDB is an optimization for durability, not a prerequisite for the
+ * optimistic mutation path. Disabled or failed storage permanently degrades
+ * this instance to the same queue semantics in memory for the current session.
+ */
+export class DexieMutationOutbox {
+    databaseName;
+    indexedDB;
+    keyRange;
+    listeners = new Set();
+    memoryEntries = new Map();
+    database;
+    databasePromise;
+    memoryOnly;
+    nextMemoryId = 1;
+    constructor(options = {}) {
+        this.databaseName = options.databaseName ?? "gonvex-outbox";
+        this.indexedDB = options.indexedDB;
+        this.keyRange = options.IDBKeyRange;
+        this.memoryOnly = options.enabled === false
+            || !(options.indexedDB ?? globalThis.indexedDB)
+            || !(options.IDBKeyRange ?? globalThis.IDBKeyRange);
+    }
+    async enqueue(mutation) {
+        const createdAt = Date.now();
+        const entry = {
+            path: mutation.path,
+            args: cloneValue(mutation.args),
+            idempotencyKey: mutation.idempotencyKey ?? createIdempotencyKey(),
+            entityKeys: [...(mutation.entityKeys ?? [])],
+            patches: mutation.patches?.map(clonePatch),
+            createdAt,
+            attempts: 0,
+            nextAttemptAt: createdAt,
+            state: "pending",
+        };
+        if (this.memoryOnly)
+            return this.enqueueInMemory(entry);
+        try {
+            const database = await this.open();
+            const id = await database.entries.add(entry);
+            const stored = { ...entry, id };
+            this.remember(stored);
+            this.notify();
+            return cloneEntry(stored);
+        }
+        catch {
+            this.degradeToMemory();
+            return this.enqueueInMemory(entry);
+        }
+    }
+    async loadAll() {
+        if (this.memoryOnly)
+            return this.loadAllFromMemory();
+        try {
+            const database = await this.open();
+            let changed = false;
+            let entries = [];
+            await database.transaction("rw", database.entries, async () => {
+                entries = await database.entries.orderBy("id").toArray();
+                entries = entries.map((entry) => {
+                    if (entry.state !== "inflight")
+                        return entry;
+                    changed = true;
+                    return { ...entry, state: "pending" };
+                });
+                if (changed)
+                    await database.entries.bulkPut(entries);
+            });
+            this.replaceMemoryEntries(entries);
+            if (changed)
+                this.notify();
+            return entries.map(cloneEntry);
+        }
+        catch {
+            this.degradeToMemory();
+            return this.loadAllFromMemory();
+        }
+    }
+    async nextReady(now) {
+        if (this.memoryOnly)
+            return cloneOptionalEntry(firstReady(this.sortedMemoryEntries(), now));
+        try {
+            const database = await this.open();
+            const entries = await database.entries.orderBy("id").toArray();
+            this.replaceMemoryEntries(entries);
+            return cloneOptionalEntry(firstReady(entries, now));
+        }
+        catch {
+            this.degradeToMemory();
+            return cloneOptionalEntry(firstReady(this.sortedMemoryEntries(), now));
+        }
+    }
+    async markInflight(id) {
+        if (this.memoryOnly) {
+            this.markInflightInMemory(id);
+            return;
+        }
+        try {
+            const database = await this.open();
+            const entry = await database.entries.get(id);
+            if (!entry || entry.state === "inflight")
+                return;
+            const updated = { ...entry, state: "inflight" };
+            await database.entries.put(updated);
+            this.remember(updated);
+            this.notify();
+        }
+        catch {
+            this.degradeToMemory();
+            this.markInflightInMemory(id);
+        }
+    }
+    async ack(id) {
+        if (this.memoryOnly) {
+            this.ackInMemory(id);
+            return;
+        }
+        try {
+            const database = await this.open();
+            const entry = await database.entries.get(id);
+            if (!entry)
+                return;
+            await database.entries.delete(id);
+            this.memoryEntries.delete(id);
+            this.notify();
+        }
+        catch {
+            this.degradeToMemory();
+            this.ackInMemory(id);
+        }
+    }
+    async fail(id, error) {
+        if (this.memoryOnly) {
+            this.failInMemory(id, error);
+            return;
+        }
+        try {
+            const database = await this.open();
+            const entry = await database.entries.get(id);
+            if (!entry)
+                return;
+            const updated = failedEntry(entry, error, Date.now());
+            await database.entries.put(updated);
+            this.remember(updated);
+            this.notify();
+        }
+        catch {
+            this.degradeToMemory();
+            this.failInMemory(id, error);
+        }
+    }
+    async count() {
+        if (this.memoryOnly)
+            return this.memoryEntries.size;
+        try {
+            return await (await this.open()).entries.count();
+        }
+        catch {
+            this.degradeToMemory();
+            return this.memoryEntries.size;
+        }
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    enqueueInMemory(entry) {
+        const stored = { ...entry, id: this.nextMemoryId++ };
+        this.remember(stored);
+        this.notify();
+        return cloneEntry(stored);
+    }
+    loadAllFromMemory() {
+        let changed = false;
+        for (const [id, entry] of this.memoryEntries) {
+            if (entry.state !== "inflight")
+                continue;
+            this.memoryEntries.set(id, { ...entry, state: "pending" });
+            changed = true;
+        }
+        if (changed)
+            this.notify();
+        return this.sortedMemoryEntries().map(cloneEntry);
+    }
+    markInflightInMemory(id) {
+        const entry = this.memoryEntries.get(id);
+        if (!entry || entry.state === "inflight")
+            return;
+        this.memoryEntries.set(id, { ...entry, state: "inflight" });
+        this.notify();
+    }
+    ackInMemory(id) {
+        if (!this.memoryEntries.delete(id))
+            return;
+        this.notify();
+    }
+    failInMemory(id, error) {
+        const entry = this.memoryEntries.get(id);
+        if (!entry)
+            return;
+        this.memoryEntries.set(id, failedEntry(entry, error, Date.now()));
+        this.notify();
+    }
+    sortedMemoryEntries() {
+        return [...this.memoryEntries.values()].sort((left, right) => left.id - right.id);
+    }
+    remember(entry) {
+        this.memoryEntries.set(entry.id, cloneEntry(entry));
+        this.nextMemoryId = Math.max(this.nextMemoryId, entry.id + 1);
+    }
+    replaceMemoryEntries(entries) {
+        this.memoryEntries.clear();
+        for (const entry of entries)
+            this.remember(entry);
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch {
+                // A subscriber must not be able to break mutation delivery.
+            }
+        }
+    }
+    degradeToMemory() {
+        this.memoryOnly = true;
+        this.database?.close();
+        this.database = undefined;
+        this.databasePromise = undefined;
+    }
+    async open() {
+        if (!this.databasePromise) {
+            this.databasePromise = this.createDatabase().catch((error) => {
+                this.databasePromise = undefined;
+                throw error;
+            });
+        }
+        return this.databasePromise;
+    }
+    async createDatabase() {
+        const indexedDBValue = this.indexedDB ?? globalThis.indexedDB;
+        const keyRangeValue = this.keyRange ?? globalThis.IDBKeyRange;
+        if (!indexedDBValue || !keyRangeValue)
+            throw new Error("indexeddb-unavailable");
+        const { Dexie } = await import("dexie");
+        const database = new Dexie(this.databaseName, {
+            indexedDB: indexedDBValue,
+            IDBKeyRange: keyRangeValue,
+        });
+        database.version(1).stores({
+            entries: "++id, state, nextAttemptAt",
+        });
+        database.on("versionchange", () => database.close());
+        await database.open();
+        this.database = database;
+        return database;
+    }
+}
+export function createMutationOutbox(options = {}) {
+    return new DexieMutationOutbox(options);
+}
+function firstReady(entries, now) {
+    const blockedEntityKeys = new Set();
+    for (const entry of entries) {
+        if (entry.state === "pending"
+            && entry.nextAttemptAt <= now
+            && !entry.entityKeys.some((key) => blockedEntityKeys.has(key))) {
+            return entry;
+        }
+        for (const key of entry.entityKeys)
+            blockedEntityKeys.add(key);
+    }
+    return undefined;
+}
+function failedEntry(entry, error, now) {
+    const attempts = entry.attempts + 1;
+    return {
+        ...entry,
+        attempts,
+        state: "pending",
+        nextAttemptAt: now + Math.min(30_000, 1_000 * (2 ** attempts)),
+        lastError: error,
+    };
+}
+function createIdempotencyKey() {
+    if (globalThis.crypto?.randomUUID)
+        return globalThis.crypto.randomUUID();
+    return `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function cloneEntry(entry) {
+    return {
+        ...entry,
+        args: cloneValue(entry.args),
+        entityKeys: [...entry.entityKeys],
+        patches: entry.patches?.map(clonePatch),
+    };
+}
+function cloneOptionalEntry(entry) {
+    return entry ? cloneEntry(entry) : undefined;
+}
+function cloneValue(value) {
+    try {
+        return globalThis.structuredClone(value);
+    }
+    catch {
+        return value;
+    }
+}
+function clonePatch(patch) {
+    if (patch.op === "delete")
+        return { ...patch };
+    return { ...patch, fields: cloneValue(patch.fields) };
+}
+//# sourceMappingURL=outbox.js.map

package/dist/outbox.js.map

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

package/dist/signals.d.ts

@@ -0,0 +1,20 @@
+/** A writable reactive value. Reads use explicit `.value` access; no proxies. */
+export interface Signal<T> extends ReadonlySignal<T> {
+    value: T;
+}
+/** The read-only surface shared by computed values and writable signals. */
+export interface ReadonlySignal<T> {
+    readonly value: T;
+    /** Read the current value without making it a dependency of the active observer. */
+    peek(): T;
+    /** Listen for value changes. The returned function removes the listener. */
+    subscribe(fn: (value: T) => void): () => void;
+}
+/** Create a writable reactive value. */
+export declare function signal<T>(initial: T): Signal<T>;
+/** Create a lazy, cached value whose dependencies are discovered automatically. */
+export declare function computed<T>(fn: () => T): ReadonlySignal<T>;
+/** Run a callback now and again whenever one of the values it reads changes. */
+export declare function effect(fn: () => void): () => void;
+/** Coalesce subscriber callbacks and effect runs until the outermost batch ends. */
+export declare function batch(fn: () => void): void;

package/dist/signals.js

@@ -0,0 +1,259 @@
+/*
+ * Dependency collection uses a stack rather than a single global variable. A
+ * stack is important for computed chains: evaluating one computed may evaluate
+ * another, and reads must attach to the innermost evaluation in progress.
+ */
+const evaluationStack = [];
+let batchDepth = 0;
+let isFlushing = false;
+const pendingNotifications = new Set();
+const pendingEffects = new Set();
+/*
+ * A self-updating effect is allowed and is deferred until its current run has
+ * completed. To turn accidental `effect(() => count.value++)` loops into a
+ * useful error instead of locking the process, one effect may run at most this
+ * many times in a single synchronous flush.
+ */
+const MAX_EFFECT_RUNS_PER_FLUSH = 100;
+function track(dependency) {
+    const observer = evaluationStack[evaluationStack.length - 1];
+    if (observer === undefined || observer.disposed || observer.dependencies.has(dependency))
+        return;
+    observer.dependencies.add(dependency);
+    dependency.dependents.add(observer);
+}
+function detach(observer) {
+    for (const dependency of observer.dependencies)
+        dependency.dependents.delete(observer);
+    observer.dependencies.clear();
+}
+function queueNotification(node) {
+    pendingNotifications.add(node);
+}
+function queueEffect(observer) {
+    if (!observer.disposed)
+        pendingEffects.add(observer);
+}
+/** Flush synchronously unless a batch or reactive evaluation is still active. */
+function flushIfReady() {
+    if (batchDepth === 0 && evaluationStack.length === 0 && !isFlushing)
+        flush();
+}
+function flush() {
+    if (isFlushing)
+        return;
+    isFlushing = true;
+    const effectRuns = new Map();
+    try {
+        // Subscribers run before effects. Either kind of callback may enqueue more
+        // work, so alternate until both insertion-ordered sets are empty.
+        while (pendingNotifications.size > 0 || pendingEffects.size > 0) {
+            if (pendingNotifications.size > 0) {
+                const notifications = Array.from(pendingNotifications);
+                pendingNotifications.clear();
+                for (const node of notifications)
+                    node.notifySubscribers();
+            }
+            if (pendingEffects.size > 0) {
+                const effects = Array.from(pendingEffects);
+                pendingEffects.clear();
+                for (const observer of effects) {
+                    if (observer.disposed)
+                        continue;
+                    const runs = (effectRuns.get(observer) ?? 0) + 1;
+                    effectRuns.set(observer, runs);
+                    if (runs > MAX_EFFECT_RUNS_PER_FLUSH) {
+                        pendingEffects.clear();
+                        throw new Error(`Effect exceeded ${MAX_EFFECT_RUNS_PER_FLUSH} synchronous re-runs`);
+                    }
+                    observer.run();
+                }
+            }
+        }
+    }
+    finally {
+        isFlushing = false;
+    }
+}
+class SignalNode {
+    current;
+    dependents = new Set();
+    subscribers = new Set();
+    constructor(current) {
+        this.current = current;
+    }
+    get value() {
+        track(this);
+        return this.current;
+    }
+    set value(next) {
+        if (Object.is(this.current, next))
+            return;
+        this.current = next;
+        // Invalidate the graph immediately. This keeps reads made inside a batch
+        // fresh, while actual callbacks remain coalesced until the batch ends.
+        for (const observer of Array.from(this.dependents))
+            observer.invalidate();
+        if (this.subscribers.size > 0)
+            queueNotification(this);
+        flushIfReady();
+    }
+    peek() {
+        return this.current;
+    }
+    subscribe(fn) {
+        this.subscribers.add(fn);
+        return () => {
+            this.subscribers.delete(fn);
+        };
+    }
+    notifySubscribers() {
+        // Checking membership makes disposal during an earlier callback effective
+        // immediately, even though iteration itself uses a stable snapshot.
+        for (const fn of Array.from(this.subscribers)) {
+            if (this.subscribers.has(fn))
+                fn(this.current);
+        }
+    }
+}
+class ComputedNode {
+    compute;
+    dependents = new Set();
+    dependencies = new Set();
+    disposed = false;
+    dirty = true;
+    evaluating = false;
+    initialized = false;
+    cached;
+    /*
+     * Each subscriber keeps its own last-seen value. This avoids reporting a
+     * change to a subscriber added midway through a batch, while still letting
+     * computed values stay lazy when nobody reads or subscribes to them.
+     */
+    subscribers = new Map();
+    constructor(compute) {
+        this.compute = compute;
+    }
+    get value() {
+        track(this);
+        return this.recompute();
+    }
+    peek() {
+        return this.recompute();
+    }
+    subscribe(fn) {
+        this.subscribers.set(fn, this.peek());
+        return () => {
+            this.subscribers.delete(fn);
+        };
+    }
+    invalidate() {
+        if (this.dirty)
+            return;
+        this.dirty = true;
+        // Propagating dirtiness (without recomputing) is what makes the graph
+        // pull-based and also lets the effect queue deduplicate diamond paths.
+        for (const observer of Array.from(this.dependents))
+            observer.invalidate();
+        if (this.subscribers.size > 0)
+            queueNotification(this);
+    }
+    notifySubscribers() {
+        const next = this.peek();
+        for (const [fn, previous] of Array.from(this.subscribers)) {
+            if (!this.subscribers.has(fn) || Object.is(previous, next))
+                continue;
+            this.subscribers.set(fn, next);
+            fn(next);
+        }
+    }
+    recompute() {
+        if (!this.dirty && this.initialized)
+            return this.cached;
+        if (this.evaluating)
+            throw new Error("Circular computed dependency");
+        detach(this);
+        this.evaluating = true;
+        // Clearing dirty before evaluation allows a write made during `compute` to
+        // invalidate this node again, leaving it dirty for the following read.
+        this.dirty = false;
+        evaluationStack.push(this);
+        try {
+            this.cached = this.compute();
+            this.initialized = true;
+            return this.cached;
+        }
+        catch (error) {
+            // Failed computations are retried on the next read.
+            this.dirty = true;
+            throw error;
+        }
+        finally {
+            evaluationStack.pop();
+            this.evaluating = false;
+            flushIfReady();
+        }
+    }
+}
+class EffectObserver {
+    callback;
+    dependencies = new Set();
+    disposed = false;
+    running = false;
+    constructor(callback) {
+        this.callback = callback;
+    }
+    invalidate() {
+        // If the callback writes one of its own dependencies, Set insertion queues
+        // exactly one follow-up run after the current invocation returns.
+        queueEffect(this);
+    }
+    run() {
+        if (this.disposed || this.running)
+            return;
+        detach(this);
+        this.running = true;
+        evaluationStack.push(this);
+        try {
+            this.callback();
+        }
+        finally {
+            evaluationStack.pop();
+            this.running = false;
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        pendingEffects.delete(this);
+        detach(this);
+    }
+}
+/** Create a writable reactive value. */
+export function signal(initial) {
+    return new SignalNode(initial);
+}
+/** Create a lazy, cached value whose dependencies are discovered automatically. */
+export function computed(fn) {
+    return new ComputedNode(fn);
+}
+/** Run a callback now and again whenever one of the values it reads changes. */
+export function effect(fn) {
+    const observer = new EffectObserver(fn);
+    observer.run();
+    flushIfReady();
+    return () => observer.dispose();
+}
+/** Coalesce subscriber callbacks and effect runs until the outermost batch ends. */
+export function batch(fn) {
+    batchDepth += 1;
+    try {
+        fn();
+    }
+    finally {
+        batchDepth -= 1;
+        flushIfReady();
+    }
+}
+//# sourceMappingURL=signals.js.map

package/dist/signals.js.map

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

package/dist/sync-store.d.ts

@@ -14,6 +14,8 @@ export type StoredSyncCollection = {
     cursor: SyncCursor;
     keyField: string;
     mode?: "eager" | "progressive";
+    /** Whether the server budget-cut the materialized collection. */
+    truncated?: boolean;
     orderBy?: string;
     orderDirection?: "asc" | "desc";
     maxRows?: number;
@@ -33,6 +35,8 @@ export type SyncStore = {
     applyDelta(scope: string, path: string, args: JsonValue, value: {
         cursor: SyncCursor;
         keyField: string;
+        mode?: "eager" | "progressive";
+        truncated?: boolean;
         orderBy?: string;
         orderDirection?: "asc" | "desc";
         upserts: JsonValue[];
@@ -63,6 +67,7 @@ export declare class DexieSyncStore implements SyncStore {
         cursor: SyncCursor;
         keyField: string;
         mode?: "eager" | "progressive";
+        truncated?: boolean;
         orderBy?: string;
         orderDirection?: "asc" | "desc";
         upserts: JsonValue[];