anchordb-sync-server 0.2.0

package/dist/cjs/index.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NESTJS_CONTROLLER_EXAMPLE = exports.ANCHOR_SYNC_SERVICE = exports.createAnchorSyncService = exports.AnchorSyncService = exports.createAnchorRouteHandlers = exports.createAnchorRouter = exports.MongooseStore = exports.MemoryStore = exports.ProtocolError = exports.handlePull = exports.handlePush = void 0;
+/**
+ * anchordb-sync-server — the server half of the Anchor sync protocol.
+ *
+ * The protocol lives in `handlers.ts` as pure functions over a `ServerStore`. Express, NestJS and
+ * Next.js adapters are thin translations of those, and all three are held to one conformance suite.
+ */
+var handlers_ts_1 = require("./handlers.js");
+Object.defineProperty(exports, "handlePush", { enumerable: true, get: function () { return handlers_ts_1.handlePush; } });
+Object.defineProperty(exports, "handlePull", { enumerable: true, get: function () { return handlers_ts_1.handlePull; } });
+Object.defineProperty(exports, "ProtocolError", { enumerable: true, get: function () { return handlers_ts_1.ProtocolError; } });
+var memory_ts_1 = require("./store/memory.js");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return memory_ts_1.MemoryStore; } });
+var mongoose_ts_1 = require("./store/mongoose.js");
+Object.defineProperty(exports, "MongooseStore", { enumerable: true, get: function () { return mongoose_ts_1.MongooseStore; } });
+var express_ts_1 = require("./adapters/express.js");
+Object.defineProperty(exports, "createAnchorRouter", { enumerable: true, get: function () { return express_ts_1.createAnchorRouter; } });
+var nextjs_ts_1 = require("./adapters/nextjs.js");
+Object.defineProperty(exports, "createAnchorRouteHandlers", { enumerable: true, get: function () { return nextjs_ts_1.createAnchorRouteHandlers; } });
+var nestjs_ts_1 = require("./adapters/nestjs.js");
+Object.defineProperty(exports, "AnchorSyncService", { enumerable: true, get: function () { return nestjs_ts_1.AnchorSyncService; } });
+Object.defineProperty(exports, "createAnchorSyncService", { enumerable: true, get: function () { return nestjs_ts_1.createAnchorSyncService; } });
+Object.defineProperty(exports, "ANCHOR_SYNC_SERVICE", { enumerable: true, get: function () { return nestjs_ts_1.ANCHOR_SYNC_SERVICE; } });
+Object.defineProperty(exports, "NESTJS_CONTROLLER_EXAMPLE", { enumerable: true, get: function () { return nestjs_ts_1.NESTJS_CONTROLLER_EXAMPLE; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6CAAsE;AAA7D,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,4GAAA,aAAa,OAAA;AAC9C,+CAAgD;AAAvC,wGAAA,WAAW,OAAA;AACpB,mDAAoD;AAA3C,4GAAA,aAAa,OAAA;AAQtB,oDAA2D;AAAlD,gHAAA,kBAAkB,OAAA;AAC3B,kDAAiE;AAAxD,sHAAA,yBAAyB,OAAA;AAElC,kDAK8B;AAJ5B,8GAAA,iBAAiB,OAAA;AACjB,oHAAA,uBAAuB,OAAA;AACvB,gHAAA,mBAAmB,OAAA;AACnB,sHAAA,yBAAyB,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/store/memory.d.ts

@@ -0,0 +1,25 @@
+import type { ChangeResult } from "anchordb";
+import type { ServerStore, StoredServerDocument } from "./types.js";
+/**
+ * In-memory store — the default, so a backend runs with no database installed.
+ *
+ * This is the reference implementation of the `ServerStore` contract; `MongooseStore` is held to
+ * the same conformance suite. Suitable for development, tests and the demos, not for production.
+ */
+export declare class MemoryStore implements ServerStore {
+    readonly name = "memory";
+    private readonly docs;
+    private readonly idempotency;
+    private seq;
+    private key;
+    get(collection: string, documentId: string): Promise<StoredServerDocument | null>;
+    put(doc: Omit<StoredServerDocument, "seq">): Promise<StoredServerDocument>;
+    listChanges(afterSeq: number, limit: number, collections?: string[]): Promise<StoredServerDocument[]>;
+    hasMoreAfter(seq: number, collections?: string[]): Promise<boolean>;
+    getIdempotent(clientId: string, mutationId: string): Promise<ChangeResult | null>;
+    setIdempotent(clientId: string, mutationId: string, result: ChangeResult): Promise<void>;
+    findByUniqueField(collection: string, field: string, value: unknown, exceptDocumentId: string): Promise<StoredServerDocument | null>;
+    all(collection?: string): StoredServerDocument[];
+    reset(): void;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cjs/store/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/store/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,GAAG;IAIL,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAIjF,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAM1E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOrG,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIjF,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAUvC,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAIhD,KAAK,IAAI,IAAI;CAKd"}

package/dist/cjs/store/memory.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+/**
+ * In-memory store — the default, so a backend runs with no database installed.
+ *
+ * This is the reference implementation of the `ServerStore` contract; `MongooseStore` is held to
+ * the same conformance suite. Suitable for development, tests and the demos, not for production.
+ */
+class MemoryStore {
+    constructor() {
+        this.name = "memory";
+        this.docs = new Map();
+        this.idempotency = new Map();
+        this.seq = 0;
+    }
+    key(collection, documentId) {
+        return `${collection}/${documentId}`;
+    }
+    async get(collection, documentId) {
+        return this.docs.get(this.key(collection, documentId)) ?? null;
+    }
+    async put(doc) {
+        const stored = { ...doc, seq: ++this.seq };
+        this.docs.set(this.key(doc.collection, doc.documentId), stored);
+        return stored;
+    }
+    async listChanges(afterSeq, limit, collections) {
+        return [...this.docs.values()]
+            .filter((d) => d.seq > afterSeq && (!collections || collections.includes(d.collection)))
+            .sort((a, b) => a.seq - b.seq)
+            .slice(0, limit);
+    }
+    async hasMoreAfter(seq, collections) {
+        return [...this.docs.values()].some((d) => d.seq > seq && (!collections || collections.includes(d.collection)));
+    }
+    async getIdempotent(clientId, mutationId) {
+        return this.idempotency.get(`${clientId}:${mutationId}`) ?? null;
+    }
+    async setIdempotent(clientId, mutationId, result) {
+        this.idempotency.set(`${clientId}:${mutationId}`, result);
+    }
+    async findByUniqueField(collection, field, value, exceptDocumentId) {
+        for (const doc of this.docs.values()) {
+            if (doc.collection !== collection || doc.deleted)
+                continue;
+            if (doc.documentId === exceptDocumentId)
+                continue;
+            if (doc.document[field] === value)
+                return doc;
+        }
+        return null;
+    }
+    // ---- helpers for tests and demos ----
+    all(collection) {
+        return [...this.docs.values()].filter((d) => !collection || d.collection === collection);
+    }
+    reset() {
+        this.docs.clear();
+        this.idempotency.clear();
+        this.seq = 0;
+    }
+}
+exports.MemoryStore = MemoryStore;
+//# sourceMappingURL=memory.js.map

package/dist/cjs/store/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/store/memory.ts"],"names":[],"mappings":";;;AAGA;;;;;GAKG;AACH,MAAa,WAAW;IAAxB;QACW,SAAI,GAAG,QAAQ,CAAC;QACR,SAAI,GAAG,IAAI,GAAG,EAAgC,CAAC;QAC/C,gBAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;QACvD,QAAG,GAAG,CAAC,CAAC;IA6DlB,CAAC;IA3DS,GAAG,CAAC,UAAkB,EAAE,UAAkB;QAChD,OAAO,GAAG,UAAU,IAAI,UAAU,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,UAAkB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAsC;QAC9C,MAAM,MAAM,GAAyB,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,KAAa,EAAE,WAAsB;QACvE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;aACvF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;aAC7B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,WAAsB;QACpD,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,UAAkB;QACtD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,UAAkB,EAAE,MAAoB;QAC5E,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,UAAkB,EAClB,KAAa,EACb,KAAc,EACd,gBAAwB;QAExB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,UAAU,KAAK,UAAU,IAAI,GAAG,CAAC,OAAO;gBAAE,SAAS;YAC3D,IAAI,GAAG,CAAC,UAAU,KAAK,gBAAgB;gBAAE,SAAS;YAClD,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK;gBAAE,OAAO,GAAG,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,GAAG,CAAC,UAAmB;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACf,CAAC;CACF;AAjED,kCAiEC"}

package/dist/cjs/store/mongoose.d.ts

@@ -0,0 +1,90 @@
+import type { ChangeResult } from "anchordb";
+import type { ServerStore, StoredServerDocument } from "./types.js";
+/**
+ * MongoDB store, driven through Mongoose.
+ *
+ * `mongoose` is a *peer* dependency and is passed in rather than imported, for two reasons: the
+ * package must install cleanly for people using MemoryStore, and a backend must use its own single
+ * mongoose instance (two copies in one process is a well-known source of "MissingSchemaError" and
+ * duplicate connection bugs).
+ *
+ * ## The schemas
+ *
+ * `anchorSchemas()` returns plain definition objects rather than constructed schemas, so a backend
+ * can extend them, add its own indexes, or point them at different collection names. They are the
+ * shape the sync protocol needs; your *domain* collections keep whatever schema you already have.
+ */
+export interface MongooseLike {
+    Schema: new (definition: unknown, options?: unknown) => unknown;
+    model: (name: string, schema?: unknown, collection?: string) => MongooseModel;
+    models: Record<string, MongooseModel | undefined>;
+}
+export interface MongooseModel {
+    findOne(filter: unknown): {
+        lean(): {
+            exec(): Promise<Record<string, unknown> | null>;
+        };
+    };
+    find(filter: unknown): {
+        sort(spec: unknown): {
+            limit(n: number): {
+                lean(): {
+                    exec(): Promise<Array<Record<string, unknown>>>;
+                };
+            };
+            lean(): {
+                exec(): Promise<Array<Record<string, unknown>>>;
+            };
+        };
+    };
+    findOneAndUpdate(filter: unknown, update: unknown, options: unknown): {
+        lean(): {
+            exec(): Promise<unknown>;
+        };
+    };
+    countDocuments(filter: unknown): {
+        exec(): Promise<number>;
+    };
+    create(doc: unknown): Promise<unknown>;
+}
+/**
+ * Schema definitions for the two collections the protocol needs.
+ *
+ * Timestamps are `Date`, which Mongoose casts from the ISO-8601 UTC strings the client sends — one
+ * of the reasons the wire format uses strings rather than a custom encoding.
+ */
+export declare function anchorSchemas(): {
+    document: Record<string, unknown>;
+    idempotency: Record<string, unknown>;
+};
+export interface MongooseStoreOptions {
+    mongoose: MongooseLike;
+    documentModelName?: string;
+    idempotencyModelName?: string;
+    /** Collection names, if you want them to differ from the model names. */
+    documentCollection?: string;
+    idempotencyCollection?: string;
+}
+export declare class MongooseStore implements ServerStore {
+    readonly name = "mongoose";
+    private readonly documents;
+    private readonly idempotency;
+    private readonly counters;
+    constructor(options: MongooseStoreOptions);
+    get(collection: string, documentId: string): Promise<StoredServerDocument | null>;
+    /**
+     * Allocate the next sequence number atomically.
+     *
+     * `findOneAndUpdate` with `$inc` is a single atomic operation in MongoDB, so two concurrent
+     * pushes cannot receive the same seq. Reading-then-writing a counter would race, and duplicate
+     * sequence numbers would make pull cursors skip changes.
+     */
+    private nextSeq;
+    put(doc: Omit<StoredServerDocument, "seq">): Promise<StoredServerDocument>;
+    listChanges(afterSeq: number, limit: number, collections?: string[]): Promise<StoredServerDocument[]>;
+    hasMoreAfter(seq: number, collections?: string[]): Promise<boolean>;
+    getIdempotent(clientId: string, mutationId: string): Promise<ChangeResult | null>;
+    setIdempotent(clientId: string, mutationId: string, result: ChangeResult): Promise<void>;
+    findByUniqueField(collection: string, field: string, value: unknown, exceptDocumentId: string): Promise<StoredServerDocument | null>;
+}
+//# sourceMappingURL=mongoose.d.ts.map

package/dist/cjs/store/mongoose.d.ts.map

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

package/dist/cjs/store/mongoose.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseStore = void 0;
+exports.anchorSchemas = anchorSchemas;
+/**
+ * Schema definitions for the two collections the protocol needs.
+ *
+ * Timestamps are `Date`, which Mongoose casts from the ISO-8601 UTC strings the client sends — one
+ * of the reasons the wire format uses strings rather than a custom encoding.
+ */
+function anchorSchemas() {
+    return {
+        document: {
+            documentId: { type: String, required: true, index: true },
+            collection: { type: String, required: true, index: true },
+            document: { type: Object, default: {} },
+            version: { type: Number, required: true, default: 0 },
+            deleted: { type: Boolean, default: false },
+            updatedAt: { type: Date, required: true },
+            hlc: { type: String, default: "" },
+            // Monotonic global sequence. Indexed because every pull is a range scan over it.
+            seq: { type: Number, required: true, index: true },
+        },
+        idempotency: {
+            clientId: { type: String, required: true },
+            mutationId: { type: String, required: true },
+            result: { type: Object, required: true },
+            createdAt: { type: Date, default: Date.now, expires: "30d" },
+        },
+    };
+}
+class MongooseStore {
+    constructor(options) {
+        this.name = "mongoose";
+        const { mongoose } = options;
+        const schemas = anchorSchemas();
+        const docName = options.documentModelName ?? "AnchorDocument";
+        const idemName = options.idempotencyModelName ?? "AnchorIdempotency";
+        const counterName = "AnchorCounter";
+        // Reuse an already-registered model rather than re-registering, which Mongoose treats as an
+        // error (OverwriteModelError) and which is easy to trigger under hot reload.
+        this.documents =
+            mongoose.models[docName] ??
+                mongoose.model(docName, new mongoose.Schema(schemas.document, { versionKey: false }), options.documentCollection);
+        this.idempotency =
+            mongoose.models[idemName] ??
+                mongoose.model(idemName, new mongoose.Schema(schemas.idempotency, { versionKey: false }), options.idempotencyCollection);
+        this.counters =
+            mongoose.models[counterName] ??
+                mongoose.model(counterName, new mongoose.Schema({ _id: String, value: { type: Number, default: 0 } }, { versionKey: false }));
+    }
+    async get(collection, documentId) {
+        const found = await this.documents.findOne({ collection, documentId }).lean().exec();
+        return found ? toStored(found) : null;
+    }
+    /**
+     * Allocate the next sequence number atomically.
+     *
+     * `findOneAndUpdate` with `$inc` is a single atomic operation in MongoDB, so two concurrent
+     * pushes cannot receive the same seq. Reading-then-writing a counter would race, and duplicate
+     * sequence numbers would make pull cursors skip changes.
+     */
+    async nextSeq() {
+        const doc = (await this.counters
+            .findOneAndUpdate({ _id: "seq" }, { $inc: { value: 1 } }, { upsert: true, new: true })
+            .lean()
+            .exec());
+        return doc?.value ?? 1;
+    }
+    async put(doc) {
+        const seq = await this.nextSeq();
+        const stored = { ...doc, seq };
+        await this.documents
+            .findOneAndUpdate({ collection: doc.collection, documentId: doc.documentId }, { $set: { ...stored, updatedAt: new Date(doc.updatedAt) } }, { upsert: true, new: true })
+            .lean()
+            .exec();
+        return stored;
+    }
+    async listChanges(afterSeq, limit, collections) {
+        const filter = { seq: { $gt: afterSeq } };
+        if (collections?.length)
+            filter.collection = { $in: collections };
+        const rows = await this.documents.find(filter).sort({ seq: 1 }).limit(limit).lean().exec();
+        return rows.map(toStored);
+    }
+    async hasMoreAfter(seq, collections) {
+        const filter = { seq: { $gt: seq } };
+        if (collections?.length)
+            filter.collection = { $in: collections };
+        return (await this.documents.countDocuments(filter).exec()) > 0;
+    }
+    async getIdempotent(clientId, mutationId) {
+        const found = (await this.idempotency.findOne({ clientId, mutationId }).lean().exec());
+        return found?.result ?? null;
+    }
+    async setIdempotent(clientId, mutationId, result) {
+        await this.idempotency
+            .findOneAndUpdate({ clientId, mutationId }, { $set: { result } }, { upsert: true, new: true })
+            .lean()
+            .exec();
+    }
+    async findByUniqueField(collection, field, value, exceptDocumentId) {
+        const found = await this.documents
+            .findOne({
+            collection,
+            deleted: false,
+            documentId: { $ne: exceptDocumentId },
+            [`document.${field}`]: value,
+        })
+            .lean()
+            .exec();
+        return found ? toStored(found) : null;
+    }
+}
+exports.MongooseStore = MongooseStore;
+function toStored(row) {
+    const updatedAt = row.updatedAt;
+    return {
+        documentId: String(row.documentId),
+        collection: String(row.collection),
+        document: (row.document ?? {}),
+        version: Number(row.version ?? 0),
+        deleted: Boolean(row.deleted),
+        updatedAt: updatedAt instanceof Date ? updatedAt.toISOString() : String(updatedAt),
+        hlc: String(row.hlc ?? ""),
+        seq: Number(row.seq ?? 0),
+    };
+}
+//# sourceMappingURL=mongoose.js.map

package/dist/cjs/store/mongoose.js.map

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

package/dist/cjs/store/types.d.ts

@@ -0,0 +1,62 @@
+import type { ChangeResult } from "anchordb";
+/**
+ * The storage contract the sync protocol needs from a backend.
+ *
+ * Kept deliberately small — five reads and two writes — so implementing it against a new database
+ * is a short afternoon rather than a port. The protocol semantics (version checks, conflict
+ * verdicts, idempotency) live in `handlers.ts` and are identical for every store, which is what
+ * makes the conformance suite meaningful: MemoryStore and MongooseStore are held to the same tests.
+ */
+export interface StoredServerDocument {
+    documentId: string;
+    collection: string;
+    document: Record<string, unknown>;
+    /** Monotonic per document. The basis of optimistic concurrency. */
+    version: number;
+    deleted: boolean;
+    updatedAt: string;
+    hlc: string;
+    /** Position in the global change sequence — what pull cursors point at. */
+    seq: number;
+}
+export interface UniqueIndexSpec {
+    collection: string;
+    field: string;
+}
+export interface ServerStore {
+    readonly name: string;
+    get(collection: string, documentId: string): Promise<StoredServerDocument | null>;
+    /** Persist a document and assign it the next global sequence number. */
+    put(doc: Omit<StoredServerDocument, "seq">): Promise<StoredServerDocument>;
+    /** Documents whose seq is greater than `afterSeq`, ascending, at most `limit`. */
+    listChanges(afterSeq: number, limit: number, collections?: string[]): Promise<StoredServerDocument[]>;
+    /** True when more changes remain beyond the returned page. */
+    hasMoreAfter(seq: number, collections?: string[]): Promise<boolean>;
+    /**
+     * Look up a memoised verdict.
+     *
+     * This is what makes retries safe: a client that times out and re-sends must receive the original
+     * decision, not have the write applied a second time.
+     */
+    getIdempotent(clientId: string, mutationId: string): Promise<ChangeResult | null>;
+    setIdempotent(clientId: string, mutationId: string, result: ChangeResult): Promise<void>;
+    /**
+     * Find a document that already holds `value` in `field`, excluding `exceptDocumentId`.
+     *
+     * Unique constraints are checked here rather than in the handler because a real database can do
+     * it with an index; scanning in the handler would be correct but O(n) per push.
+     */
+    findByUniqueField(collection: string, field: string, value: unknown, exceptDocumentId: string): Promise<StoredServerDocument | null>;
+}
+export interface SyncServerOptions {
+    store: ServerStore;
+    /** Unique constraints to enforce, mirroring the indexes declared in the client schema. */
+    uniqueIndexes?: UniqueIndexSpec[];
+    /** Injectable for deterministic tests. */
+    now?: () => number;
+    /** Reject collections not in this list, if provided. */
+    allowedCollections?: string[];
+    /** Resolve the tenant/user this request belongs to. Return null to reject. */
+    authenticate?: (headers: Record<string, string | undefined>) => Promise<string | null> | string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/store/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAElF,wEAAwE;IACxE,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE3E,kFAAkF;IAClF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEtG,8DAA8D;IAC9D,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAClF,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF;;;;;OAKG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,eAAe,EAAE,CAAC;IAClC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CACxG"}

package/dist/cjs/store/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/store/types.js.map

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

package/dist/esm/adapters/express.d.ts

@@ -0,0 +1,33 @@
+import type { SyncServerOptions } from "../store/types.js";
+/**
+ * Express adapter — a thin translation layer, nothing more.
+ *
+ * All protocol semantics live in `handlers.ts`, so this file only maps HTTP to those calls and
+ * back. Typed structurally rather than against `express` types so the package installs without
+ * express present.
+ */
+interface Req {
+    body: unknown;
+    headers: Record<string, string | undefined>;
+}
+interface Res {
+    status(code: number): Res;
+    json(body: unknown): unknown;
+}
+type Next = (err?: unknown) => void;
+type Handler = (req: Req, res: Res, next: Next) => void | Promise<void>;
+interface RouterLike {
+    post(path: string, handler: Handler): unknown;
+    get(path: string, handler: Handler): unknown;
+}
+export interface ExpressRouterFactory {
+    (): RouterLike;
+}
+/**
+ * `app.use("/anchor/v1", createAnchorRouter(express.Router, { store }))`
+ *
+ * The Router factory is injected rather than imported so this module never requires express itself.
+ */
+export declare function createAnchorRouter(routerFactory: ExpressRouterFactory, options: SyncServerOptions): RouterLike;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/esm/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/adapters/express.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;GAMG;AAEH,UAAU,GAAG;IACX,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C;AACD,UAAU,GAAG;IACX,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AACD,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AACpC,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,UAAU,UAAU;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,UAAU,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA+B9G"}

package/dist/esm/adapters/express.js

@@ -0,0 +1,37 @@
+import { handlePull, handlePush, ProtocolError } from "../handlers.js";
+/**
+ * `app.use("/anchor/v1", createAnchorRouter(express.Router, { store }))`
+ *
+ * The Router factory is injected rather than imported so this module never requires express itself.
+ */
+export function createAnchorRouter(routerFactory, options) {
+    const router = routerFactory();
+    const guard = (handler) => {
+        return async (req, res) => {
+            try {
+                if (options.authenticate) {
+                    const identity = await options.authenticate(req.headers);
+                    if (!identity) {
+                        res.status(401).json({ error: "unauthorized" });
+                        return;
+                    }
+                }
+                res.status(200).json(await handler(req));
+            }
+            catch (err) {
+                if (err instanceof ProtocolError) {
+                    res.status(err.status).json({ error: err.message });
+                    return;
+                }
+                // Never leak an internal error message to a client; log it server-side instead.
+                console.error("[anchor/sync-server]", err);
+                res.status(500).json({ error: "internal error" });
+            }
+        };
+    };
+    router.post("/sync/push", guard((req) => handlePush(req.body, options)));
+    router.post("/sync/pull", guard((req) => handlePull(req.body, options)));
+    router.get("/sync/health", guard(async () => ({ ok: true, store: options.store.name, protocolVersion: 1 })));
+    return router;
+}
+//# sourceMappingURL=express.js.map

package/dist/esm/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/adapters/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA+BvE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAmC,EAAE,OAA0B;IAChG,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,CAAC,OAAuC,EAAW,EAAE;QACjE,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACzD,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;wBAChD,OAAO;oBACT,CAAC;gBACH,CAAC;gBACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;oBACjC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBACpD,OAAO;gBACT,CAAC;gBACD,gFAAgF;gBAChF,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;gBAC3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7G,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/adapters/nestjs.d.ts

@@ -0,0 +1,34 @@
+import type { SyncServerOptions } from "../store/types.js";
+/**
+ * NestJS adapter.
+ *
+ * NestJS is not imported here — decorators and DI tokens are supplied by the consuming app, so this
+ * package installs cleanly for people using Express or Next.js. What we export is:
+ *
+ *  - `AnchorSyncService`, a plain class the app registers as a provider, and
+ *  - a documented controller you paste into your project (see `NESTJS_CONTROLLER_EXAMPLE`).
+ *
+ * The alternative — importing `@nestjs/common` to decorate a controller in the library — would make
+ * NestJS a hard dependency of everyone, and would bake in route paths the app cannot change.
+ */
+export declare class AnchorSyncService {
+    private readonly options;
+    constructor(options: SyncServerOptions);
+    push(body: unknown, headers?: Record<string, string | undefined>): Promise<unknown>;
+    pull(body: unknown, headers?: Record<string, string | undefined>): Promise<unknown>;
+    health(): {
+        ok: true;
+        store: string;
+        protocolVersion: number;
+    };
+    private assertAuthorised;
+}
+/** Factory for `useFactory` in a NestJS module. */
+export declare function createAnchorSyncService(options: SyncServerOptions): AnchorSyncService;
+export declare const ANCHOR_SYNC_SERVICE = "ANCHOR_SYNC_SERVICE";
+/**
+ * Copy this controller and module into your NestJS app. It is exported as a string rather than as
+ * live code precisely so that `@nestjs/common` stays out of this package's dependency graph.
+ */
+export declare const NESTJS_CONTROLLER_EXAMPLE: string;
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/esm/adapters/nestjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../../../src/adapters/nestjs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,iBAAiB;IAIhC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvF,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7F,MAAM,IAAI;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;YAIhD,gBAAgB;CAK/B;AAED,mDAAmD;AACnD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAErF;AAED,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QA8C9B,CAAC"}