anchordb 0.2.0

package/dist/cjs/sync/protocol.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * The Anchor Sync Protocol, version 1.
+ *
+ * Design constraints that shaped this:
+ *
+ *  - **Plain JSON, Mongoose-friendly.** Documents travel with `_id` as a 24-char hex string and
+ *    timestamps as ISO-8601 UTC strings, because Mongoose casts both automatically. A backend can
+ *    hand the payload straight to a model with no field mapping.
+ *  - **Every change gets exactly one verdict.** `accepted | rejected | conflict`. A push that
+ *    silently drops a change is indistinguishable from a lost mutation, so the response is
+ *    positionally complete.
+ *  - **Idempotent by construction.** The server memoises `(clientId, mutationId)`, so a retry after
+ *    a timeout replays the original verdict rather than applying the write twice. This is what
+ *    makes at-least-once delivery safe on a flaky mobile network.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncTransportError = exports.SyncAuthError = exports.PROTOCOL_VERSION = void 0;
+exports.PROTOCOL_VERSION = 1;
+/** Thrown for HTTP 401/403 so the engine can pause rather than discard queued work. */
+class SyncAuthError extends Error {
+    constructor(status, message) {
+        super(message);
+        this.name = "SyncAuthError";
+        this.status = status;
+    }
+}
+exports.SyncAuthError = SyncAuthError;
+/** Thrown for transport failures — retryable, unlike an auth or validation error. */
+class SyncTransportError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.name = "SyncTransportError";
+        this.status = status;
+    }
+}
+exports.SyncTransportError = SyncTransportError;
+//# sourceMappingURL=protocol.js.map

package/dist/cjs/sync/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/sync/protocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEU,QAAA,gBAAgB,GAAG,CAAC,CAAC;AAgHlC,uFAAuF;AACvF,MAAa,aAAc,SAAQ,KAAK;IAGtC,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAG,eAAe,CAAC;QAIvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,sCAOC;AAED,qFAAqF;AACrF,MAAa,kBAAmB,SAAQ,KAAK;IAG3C,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAG,oBAAoB,CAAC;QAI5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,gDAOC"}

package/dist/cjs/sync/queue.d.ts

@@ -0,0 +1,77 @@
+import type { DatabaseAdapter } from "../storage/types.js";
+import type { Mutation, QueuedMutation } from "./protocol.js";
+/**
+ * The durable mutation queue.
+ *
+ * Stored as an ordinary collection through the `DatabaseAdapter`, not in a bespoke table, so every
+ * adapter (SQLite, IndexedDB, memory) gets persistence for free and the queue survives whatever the
+ * storage engine survives.
+ *
+ * Two reliability properties this file is responsible for:
+ *
+ *  - **Nothing is lost to a crash.** Rows are written in the same call that persists the document
+ *    change, before the caller's `await` resolves. If the process dies immediately after a write,
+ *    the mutation is already on disk.
+ *  - **Nothing is stuck after a crash.** A mutation marked `inflight` when the process died is
+ *    indistinguishable from one still in transit, so `recover()` returns them all to `pending` on
+ *    startup. Combined with server-side idempotency on `(clientId, mutationId)`, at-least-once
+ *    delivery becomes effectively-once.
+ */
+export declare const QUEUE_COLLECTION = "__anchor_mutations";
+export declare class MutationQueue {
+    private readonly adapter;
+    private readonly clientId;
+    private seq;
+    private ready;
+    constructor(adapter: DatabaseAdapter, clientId: string);
+    private init;
+    /** Append mutations. Ordering is by `seq`, which is monotonic and persisted. */
+    enqueue(mutations: Array<Omit<Mutation, "mutationId" | "clientId" | "createdAt"> & Partial<Mutation>>): Promise<QueuedMutation[]>;
+    /**
+     * Return `inflight` mutations to `pending`.
+     *
+     * Called on startup. A mutation that was in flight when the process died may or may not have
+     * reached the server — we cannot tell. Re-sending is safe because the server deduplicates on
+     * `(clientId, mutationId)`; *not* re-sending would silently lose the change.
+     */
+    recover(): Promise<number>;
+    /**
+     * Next batch to push, in `seq` order.
+     *
+     * Skips any document that already has an earlier failed mutation: applying a later change to a
+     * document whose earlier change never landed would corrupt it. Per-document ordering is a
+     * correctness requirement, not an optimisation.
+     */
+    take(limit: number, now?: number): Promise<QueuedMutation[]>;
+    markInflight(mutations: QueuedMutation[]): Promise<void>;
+    remove(mutationIds: string[]): Promise<void>;
+    update(mutations: QueuedMutation[]): Promise<void>;
+    /** Exponential backoff with jitter, so a fleet reconnecting at once does not stampede. */
+    scheduleRetry(mutation: QueuedMutation, error: string, baseDelayMs?: number, maxDelayMs?: number): Promise<void>;
+    /** Park a mutation that retrying cannot fix (duplicate key, validation, conflict loop). */
+    markFatal(mutation: QueuedMutation, error: string): Promise<void>;
+    list(filter?: {
+        status?: QueuedMutation["status"];
+        collection?: string;
+    }): Promise<QueuedMutation[]>;
+    get(mutationId: string): Promise<QueuedMutation | null>;
+    counts(): Promise<{
+        pending: number;
+        inflight: number;
+        failed: number;
+        total: number;
+    }>;
+    /** Developer/debug action surfaced by Lens: retry a parked mutation. */
+    retry(mutationId: string): Promise<boolean>;
+    /**
+     * Drop all backoff timers.
+     *
+     * Backoff is right for *automatic* retries — it stops a fleet stampeding a recovering server.
+     * But when the app knows connectivity just returned, or the user explicitly pulled to refresh,
+     * waiting out a timer computed during the outage is pointless and feels broken. This is the
+     * escape hatch for those cases; the engine calls it for user-initiated syncs only.
+     */
+    clearBackoff(): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/cjs/sync/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/sync/queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAGrD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,KAAK,CAA8B;gBAE/B,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM;YAKxC,IAAI;IASlB,gFAAgF;IAC1E,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmCvI;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAShC;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6BhE,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,0FAA0F;IACpF,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,SAAO,EAAE,UAAU,SAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASrH,2FAA2F;IACrF,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE,IAAI,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAYxG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAMvD,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAU7F,wEAAwE;IAClE,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYjD;;;;;;;OAOG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAY/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/cjs/sync/queue.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MutationQueue = exports.QUEUE_COLLECTION = void 0;
+const uuid_ts_1 = require("../core/uuid.js");
+/**
+ * The durable mutation queue.
+ *
+ * Stored as an ordinary collection through the `DatabaseAdapter`, not in a bespoke table, so every
+ * adapter (SQLite, IndexedDB, memory) gets persistence for free and the queue survives whatever the
+ * storage engine survives.
+ *
+ * Two reliability properties this file is responsible for:
+ *
+ *  - **Nothing is lost to a crash.** Rows are written in the same call that persists the document
+ *    change, before the caller's `await` resolves. If the process dies immediately after a write,
+ *    the mutation is already on disk.
+ *  - **Nothing is stuck after a crash.** A mutation marked `inflight` when the process died is
+ *    indistinguishable from one still in transit, so `recover()` returns them all to `pending` on
+ *    startup. Combined with server-side idempotency on `(clientId, mutationId)`, at-least-once
+ *    delivery becomes effectively-once.
+ */
+exports.QUEUE_COLLECTION = "__anchor_mutations";
+const SEQ_STATE_KEY = "anchor:queue:seq";
+class MutationQueue {
+    constructor(adapter, clientId) {
+        this.seq = 0;
+        this.ready = null;
+        this.adapter = adapter;
+        this.clientId = clientId;
+    }
+    async init() {
+        this.ready ??= (async () => {
+            await this.adapter.ensureCollection(exports.QUEUE_COLLECTION);
+            const stored = await this.adapter.getState(SEQ_STATE_KEY);
+            this.seq = stored ? Number(stored) : 0;
+        })();
+        return this.ready;
+    }
+    /** Append mutations. Ordering is by `seq`, which is monotonic and persisted. */
+    async enqueue(mutations) {
+        await this.init();
+        const now = new Date().toISOString();
+        const rows = [];
+        const queued = [];
+        for (const m of mutations) {
+            this.seq += 1;
+            const record = {
+                mutationId: m.mutationId ?? (0, uuid_ts_1.uuidv7)(),
+                collection: m.collection,
+                documentId: m.documentId,
+                operation: m.operation,
+                payload: m.payload ?? null,
+                clientId: m.clientId ?? this.clientId,
+                baseVersion: m.baseVersion ?? 0,
+                hlc: m.hlc,
+                createdAt: m.createdAt ?? now,
+                seq: this.seq,
+                status: "pending",
+                attempts: 0,
+                conflictAttempts: 0,
+                ...(m.resolvedFrom ? { resolvedFrom: m.resolvedFrom } : {}),
+            };
+            queued.push(record);
+            rows.push(toRow(record));
+        }
+        await this.adapter.write(rows.map((row) => ({ type: "insert", collection: exports.QUEUE_COLLECTION, _id: row.doc._id, row })));
+        await this.adapter.setState(SEQ_STATE_KEY, String(this.seq));
+        return queued;
+    }
+    /**
+     * Return `inflight` mutations to `pending`.
+     *
+     * Called on startup. A mutation that was in flight when the process died may or may not have
+     * reached the server — we cannot tell. Re-sending is safe because the server deduplicates on
+     * `(clientId, mutationId)`; *not* re-sending would silently lose the change.
+     */
+    async recover() {
+        await this.init();
+        const inflight = await this.list({ status: "inflight" });
+        if (inflight.length === 0)
+            return 0;
+        for (const m of inflight)
+            m.status = "pending";
+        await this.update(inflight);
+        return inflight.length;
+    }
+    /**
+     * Next batch to push, in `seq` order.
+     *
+     * Skips any document that already has an earlier failed mutation: applying a later change to a
+     * document whose earlier change never landed would corrupt it. Per-document ordering is a
+     * correctness requirement, not an optimisation.
+     */
+    async take(limit, now = Date.now()) {
+        await this.init();
+        const all = (await this.list({})).sort((a, b) => a.seq - b.seq);
+        const blocked = new Set();
+        const batch = [];
+        for (const m of all) {
+            const key = `${m.collection}/${m.documentId}`;
+            if (m.fatal || m.status === "failed") {
+                blocked.add(key);
+                continue;
+            }
+            if (blocked.has(key))
+                continue;
+            if (m.status === "inflight") {
+                blocked.add(key);
+                continue;
+            }
+            if (m.nextAttemptAt && Date.parse(m.nextAttemptAt) > now) {
+                blocked.add(key); // backing off: hold later changes to the same document too
+                continue;
+            }
+            batch.push(m);
+            blocked.add(key); // one in-flight mutation per document at a time
+            if (batch.length >= limit)
+                break;
+        }
+        return batch;
+    }
+    async markInflight(mutations) {
+        for (const m of mutations) {
+            m.status = "inflight";
+            m.attempts += 1;
+        }
+        await this.update(mutations);
+    }
+    async remove(mutationIds) {
+        await this.init();
+        if (mutationIds.length === 0)
+            return;
+        await this.adapter.write(mutationIds.map((id) => ({ type: "hardDelete", collection: exports.QUEUE_COLLECTION, _id: id })));
+    }
+    async update(mutations) {
+        await this.init();
+        if (mutations.length === 0)
+            return;
+        await this.adapter.write(mutations.map((m) => {
+            const row = toRow(m);
+            return { type: "update", collection: exports.QUEUE_COLLECTION, _id: row.doc._id, row };
+        }));
+    }
+    /** Exponential backoff with jitter, so a fleet reconnecting at once does not stampede. */
+    async scheduleRetry(mutation, error, baseDelayMs = 1000, maxDelayMs = 300_000) {
+        const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** Math.min(mutation.attempts, 10));
+        const jitter = Math.random() * exponential * 0.3;
+        mutation.status = "pending";
+        mutation.lastError = error;
+        mutation.nextAttemptAt = new Date(Date.now() + exponential + jitter).toISOString();
+        await this.update([mutation]);
+    }
+    /** Park a mutation that retrying cannot fix (duplicate key, validation, conflict loop). */
+    async markFatal(mutation, error) {
+        mutation.status = "failed";
+        mutation.fatal = true;
+        mutation.lastError = error;
+        await this.update([mutation]);
+    }
+    async list(filter = {}) {
+        await this.init();
+        const out = [];
+        for await (const row of this.adapter.scan(exports.QUEUE_COLLECTION)) {
+            const m = fromRow(row);
+            if (filter.status && m.status !== filter.status)
+                continue;
+            if (filter.collection && m.collection !== filter.collection)
+                continue;
+            out.push(m);
+        }
+        return out.sort((a, b) => a.seq - b.seq);
+    }
+    async get(mutationId) {
+        await this.init();
+        const row = await this.adapter.get(exports.QUEUE_COLLECTION, mutationId);
+        return row ? fromRow(row) : null;
+    }
+    async counts() {
+        const all = await this.list({});
+        return {
+            pending: all.filter((m) => m.status === "pending").length,
+            inflight: all.filter((m) => m.status === "inflight").length,
+            failed: all.filter((m) => m.status === "failed").length,
+            total: all.length,
+        };
+    }
+    /** Developer/debug action surfaced by Lens: retry a parked mutation. */
+    async retry(mutationId) {
+        const m = await this.get(mutationId);
+        if (!m)
+            return false;
+        m.status = "pending";
+        m.fatal = false;
+        m.attempts = 0;
+        delete m.nextAttemptAt;
+        delete m.lastError;
+        await this.update([m]);
+        return true;
+    }
+    /**
+     * Drop all backoff timers.
+     *
+     * Backoff is right for *automatic* retries — it stops a fleet stampeding a recovering server.
+     * But when the app knows connectivity just returned, or the user explicitly pulled to refresh,
+     * waiting out a timer computed during the outage is pointless and feels broken. This is the
+     * escape hatch for those cases; the engine calls it for user-initiated syncs only.
+     */
+    async clearBackoff() {
+        await this.init();
+        const waiting = (await this.list({})).filter((m) => m.nextAttemptAt && !m.fatal);
+        if (waiting.length === 0)
+            return 0;
+        for (const m of waiting) {
+            delete m.nextAttemptAt;
+            m.status = m.status === "failed" ? "failed" : "pending";
+        }
+        await this.update(waiting);
+        return waiting.length;
+    }
+    async clear() {
+        const all = await this.list({});
+        await this.remove(all.map((m) => m.mutationId));
+    }
+}
+exports.MutationQueue = MutationQueue;
+function toRow(m) {
+    return {
+        doc: { ...m, _id: m.mutationId },
+        meta: {
+            version: 0,
+            hlc: m.hlc,
+            dirty: false,
+            // The queue is local bookkeeping and must never itself be synced.
+            deleted: false,
+            createdAt: m.createdAt,
+            updatedAt: new Date().toISOString(),
+        },
+    };
+}
+function fromRow(row) {
+    const { _id, ...rest } = row.doc;
+    void _id;
+    return rest;
+}
+//# sourceMappingURL=queue.js.map

package/dist/cjs/sync/queue.js.map

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

package/dist/cjs/sync/server/memory-server.d.ts

@@ -0,0 +1,65 @@
+import { type PullRequest, type PullResponse, type PushRequest, type PushResponse, type SyncAdapter } from "../protocol.js";
+/**
+ * A complete, correct implementation of the server half of the sync protocol, backed by memory.
+ *
+ * This is the reference: the Express, NestJS and Next.js adapters all delegate to the same logic
+ * over a pluggable store, so what the tests exercise here is what a real backend runs. It is also
+ * the peer the E2E demo syncs against, which is what lets the offline -> conflict -> resolution
+ * lifecycle actually execute rather than be described.
+ *
+ * The four server-side responsibilities:
+ *
+ *  1. **Version counters.** Each document carries a monotonically increasing integer. This is the
+ *     basis of conflict detection: a push whose `baseVersion` no longer matches has been overtaken.
+ *  2. **Authoritative timestamps.** `serverTime` on every response lets clients measure and correct
+ *     their own clock skew instead of trusting the device.
+ *  3. **A global change sequence.** Pull cursors are positions in this sequence, which is what makes
+ *     incremental sync resumable after a partial transfer.
+ *  4. **Idempotency.** `(clientId, mutationId)` verdicts are memoised, so a retry after a timeout
+ *     replays the original result rather than applying the write a second time.
+ */
+export interface ServerDocument {
+    _id: string;
+    collection: string;
+    document: Record<string, unknown>;
+    version: number;
+    deleted: boolean;
+    updatedAt: string;
+    hlc: string;
+    seq: number;
+}
+export interface ServerUniqueIndex {
+    collection: string;
+    field: string;
+}
+export interface MemorySyncServerOptions {
+    /** Unique constraints the server enforces, mirroring a real database's indexes. */
+    uniqueIndexes?: ServerUniqueIndex[];
+    /** Fixed clock for deterministic tests. */
+    now?: () => number;
+}
+export declare class MemorySyncServer implements SyncAdapter {
+    readonly name = "memory-server";
+    private readonly docs;
+    private readonly processed;
+    private readonly uniqueIndexes;
+    private readonly now;
+    private seq;
+    private hlcCounter;
+    /** Test hooks: force failures to exercise the client's reliability paths. */
+    failNextPush: Error | null;
+    failNextPull: Error | null;
+    pushCallCount: number;
+    constructor(options?: MemorySyncServerOptions);
+    push(request: PushRequest): Promise<PushResponse>;
+    pull(request: PullRequest): Promise<PullResponse>;
+    private applyChange;
+    private decide;
+    private nextHlc;
+    /** Simulate another device (or a server-side process) editing a document. */
+    serverEdit(collection: string, documentId: string, changes: Record<string, unknown>): ServerDocument;
+    get(collection: string, documentId: string): ServerDocument | undefined;
+    all(collection?: string): ServerDocument[];
+    reset(): void;
+}
+//# sourceMappingURL=memory-server.d.ts.map

package/dist/cjs/sync/server/memory-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-server.d.ts","sourceRoot":"","sources":["../../../../src/sync/server/memory-server.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EAEjB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,mFAAmF;IACnF,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACpC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,UAAU,CAAK;IAEvB,6EAA6E;IAC7E,YAAY,EAAE,KAAK,GAAG,IAAI,CAAQ;IAClC,YAAY,EAAE,KAAK,GAAG,IAAI,CAAQ;IAClC,aAAa,SAAK;gBAEN,OAAO,GAAE,uBAA4B;IAO3C,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqBjD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCvD,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,MAAM;IAiFd,OAAO,CAAC,OAAO;IAOf,6EAA6E;IAC7E,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;IAkBpG,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIvE,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAI1C,KAAK,IAAI,IAAI;CAMd"}

package/dist/cjs/sync/server/memory-server.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySyncServer = void 0;
+const errors_ts_1 = require("../../core/errors.js");
+const protocol_ts_1 = require("../protocol.js");
+class MemorySyncServer {
+    constructor(options = {}) {
+        this.name = "memory-server";
+        this.docs = new Map();
+        this.processed = new Map();
+        this.seq = 0;
+        this.hlcCounter = 0;
+        /** Test hooks: force failures to exercise the client's reliability paths. */
+        this.failNextPush = null;
+        this.failNextPull = null;
+        this.pushCallCount = 0;
+        this.uniqueIndexes = options.uniqueIndexes ?? [];
+        this.now = options.now ?? (() => Date.now());
+    }
+    // ---- protocol ------------------------------------------------------------
+    async push(request) {
+        this.pushCallCount++;
+        if (this.failNextPush) {
+            const err = this.failNextPush;
+            this.failNextPush = null;
+            throw err;
+        }
+        const results = [];
+        for (const change of request.changes) {
+            results.push(this.applyChange(request.clientId, change));
+        }
+        return {
+            protocolVersion: protocol_ts_1.PROTOCOL_VERSION,
+            serverTime: new Date(this.now()).toISOString(),
+            serverHlc: this.nextHlc("server"),
+            results,
+        };
+    }
+    async pull(request) {
+        if (this.failNextPull) {
+            const err = this.failNextPull;
+            this.failNextPull = null;
+            throw err;
+        }
+        const after = request.cursor ? Number(request.cursor) : 0;
+        const limit = request.limit ?? 100;
+        const ordered = [...this.docs.values()]
+            .filter((d) => d.seq > after)
+            .sort((a, b) => a.seq - b.seq);
+        const page = ordered.slice(0, limit);
+        const changes = page.map((d) => ({
+            collection: d.collection,
+            documentId: d._id,
+            document: d.deleted ? null : d.document,
+            version: d.version,
+            deleted: d.deleted,
+            updatedAt: d.updatedAt,
+            hlc: d.hlc,
+        }));
+        const last = page[page.length - 1];
+        return {
+            protocolVersion: protocol_ts_1.PROTOCOL_VERSION,
+            serverTime: new Date(this.now()).toISOString(),
+            serverHlc: this.nextHlc("server"),
+            changes,
+            nextCursor: last ? String(last.seq) : (request.cursor ?? null),
+            hasMore: ordered.length > page.length,
+        };
+    }
+    // ---- core logic ----------------------------------------------------------
+    applyChange(clientId, change) {
+        // Idempotency: replay the original verdict for a mutation we have already decided.
+        const key = `${clientId}:${change.mutationId}`;
+        const memoised = this.processed.get(key);
+        if (memoised)
+            return memoised;
+        const docKey = `${change.collection}/${change.documentId}`;
+        const existing = this.docs.get(docKey);
+        const result = this.decide(change, existing, docKey);
+        this.processed.set(key, result);
+        return result;
+    }
+    decide(change, existing, docKey) {
+        const currentVersion = existing?.version ?? 0;
+        // Optimistic concurrency: the client edited a version the server has since moved past.
+        if (currentVersion !== change.baseVersion) {
+            return {
+                mutationId: change.mutationId,
+                status: "conflict",
+                version: currentVersion,
+                document: existing && !existing.deleted ? existing.document : null,
+                hlc: existing?.hlc ?? "",
+            };
+        }
+        if (change.operation === "delete") {
+            if (existing) {
+                existing.deleted = true;
+                existing.version += 1;
+                existing.updatedAt = new Date(this.now()).toISOString();
+                existing.seq = ++this.seq;
+                existing.hlc = this.nextHlc("server");
+            }
+            return {
+                mutationId: change.mutationId,
+                status: "accepted",
+                version: existing?.version ?? currentVersion + 1,
+                document: null,
+            };
+        }
+        const payload = (change.payload ?? {});
+        // Unique constraint check — the case two offline devices cannot detect themselves.
+        for (const index of this.uniqueIndexes) {
+            if (index.collection !== change.collection)
+                continue;
+            const value = payload[index.field];
+            if (value === undefined)
+                continue;
+            for (const [otherKey, other] of this.docs) {
+                if (otherKey === docKey || other.deleted)
+                    continue;
+                if (other.collection !== change.collection)
+                    continue;
+                if (other.document[index.field] === value) {
+                    return {
+                        mutationId: change.mutationId,
+                        status: "rejected",
+                        code: errors_ts_1.DUPLICATE_KEY_CODE,
+                        reason: `E11000 duplicate key error collection: ${change.collection} ` +
+                            `index: ${index.field}_1 dup key: { ${index.field}: "${String(value)}" }`,
+                    };
+                }
+            }
+        }
+        const version = currentVersion + 1;
+        const updatedAt = new Date(this.now()).toISOString();
+        const hlc = this.nextHlc("server");
+        const stored = {
+            _id: change.documentId,
+            collection: change.collection,
+            document: { ...payload, _id: change.documentId, updatedAt },
+            version,
+            deleted: false,
+            updatedAt,
+            hlc,
+            seq: ++this.seq,
+        };
+        this.docs.set(docKey, stored);
+        return {
+            mutationId: change.mutationId,
+            status: "accepted",
+            version,
+            document: stored.document,
+            hlc,
+        };
+    }
+    nextHlc(node) {
+        this.hlcCounter += 1;
+        return `${String(this.now()).padStart(15, "0")}-${String(this.hlcCounter).padStart(5, "0")}-${node}`;
+    }
+    // ---- test/demo helpers ---------------------------------------------------
+    /** Simulate another device (or a server-side process) editing a document. */
+    serverEdit(collection, documentId, changes) {
+        const key = `${collection}/${documentId}`;
+        const existing = this.docs.get(key);
+        const updatedAt = new Date(this.now()).toISOString();
+        const next = {
+            _id: documentId,
+            collection,
+            document: { ...(existing?.document ?? { _id: documentId }), ...changes, _id: documentId, updatedAt },
+            version: (existing?.version ?? 0) + 1,
+            deleted: false,
+            updatedAt,
+            hlc: this.nextHlc("server"),
+            seq: ++this.seq,
+        };
+        this.docs.set(key, next);
+        return next;
+    }
+    get(collection, documentId) {
+        return this.docs.get(`${collection}/${documentId}`);
+    }
+    all(collection) {
+        return [...this.docs.values()].filter((d) => !collection || d.collection === collection);
+    }
+    reset() {
+        this.docs.clear();
+        this.processed.clear();
+        this.seq = 0;
+        this.hlcCounter = 0;
+    }
+}
+exports.MemorySyncServer = MemorySyncServer;
+//# sourceMappingURL=memory-server.js.map

package/dist/cjs/sync/server/memory-server.js.map

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