anchordb-sync-server 0.2.0

package/dist/esm/adapters/nestjs.js

@@ -0,0 +1,93 @@
+import { handlePull, handlePush, ProtocolError } from "../handlers.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 class AnchorSyncService {
+    constructor(options) {
+        this.options = options;
+    }
+    async push(body, headers = {}) {
+        await this.assertAuthorised(headers);
+        return handlePush(body, this.options);
+    }
+    async pull(body, headers = {}) {
+        await this.assertAuthorised(headers);
+        return handlePull(body, this.options);
+    }
+    health() {
+        return { ok: true, store: this.options.store.name, protocolVersion: 1 };
+    }
+    async assertAuthorised(headers) {
+        if (!this.options.authenticate)
+            return;
+        const identity = await this.options.authenticate(headers);
+        if (!identity)
+            throw new ProtocolError(401, "unauthorized");
+    }
+}
+/** Factory for `useFactory` in a NestJS module. */
+export function createAnchorSyncService(options) {
+    return new AnchorSyncService(options);
+}
+export 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 const NESTJS_CONTROLLER_EXAMPLE = `
+import { Body, Controller, Get, Headers, Module, Post } from "@nestjs/common";
+import {
+  AnchorSyncService,
+  ANCHOR_SYNC_SERVICE,
+  createAnchorSyncService,
+} from "anchordb-sync-server/nestjs";
+import { MemoryStore } from "anchordb-sync-server";
+// import { MongooseStore } from "anchordb-sync-server/mongoose";
+
+@Controller("anchor/v1/sync")
+export class AnchorSyncController {
+  constructor(private readonly sync: AnchorSyncService) {}
+
+  @Post("push")
+  push(@Body() body: unknown, @Headers() headers: Record<string, string>) {
+    return this.sync.push(body, headers);
+  }
+
+  @Post("pull")
+  pull(@Body() body: unknown, @Headers() headers: Record<string, string>) {
+    return this.sync.pull(body, headers);
+  }
+
+  @Get("health")
+  health() {
+    return this.sync.health();
+  }
+}
+
+@Module({
+  controllers: [AnchorSyncController],
+  providers: [
+    {
+      provide: AnchorSyncService,
+      useFactory: () =>
+        createAnchorSyncService({
+          store: new MemoryStore(),
+          // store: new MongooseStore({ mongoose }),
+          uniqueIndexes: [{ collection: "users", field: "email" }],
+        }),
+    },
+  ],
+  exports: [AnchorSyncService],
+})
+export class AnchorSyncModule {}
+`.trim();
+//# sourceMappingURL=nestjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.js","sourceRoot":"","sources":["../../../src/adapters/nestjs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAiB;IAG5B,YAAY,OAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAa,EAAE,UAA8C,EAAE;QACxE,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC,IAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAa,EAAE,UAA8C,EAAE;QACxE,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,UAAU,CAAC,IAAa,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAA2C;QACxE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;YAAE,OAAO;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,UAAU,uBAAuB,CAAC,OAA0B;IAChE,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CxC,CAAC,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { SyncServerOptions } from "../store/types.js";
+/**
+ * Next.js App Router adapter.
+ *
+ * Usage in `app/anchor/v1/[...anchor]/route.ts`:
+ *
+ * ```ts
+ * import { createAnchorRouteHandlers } from "anchordb-sync-server/nextjs";
+ * const handlers = createAnchorRouteHandlers({ store });
+ * export const { POST, GET } = handlers;
+ * ```
+ *
+ * Built on the Web `Request`/`Response` types Next uses, so it needs no Next import at all.
+ */
+export interface NextRouteHandlers {
+    POST(request: Request): Promise<Response>;
+    GET(request: Request): Promise<Response>;
+}
+export declare function createAnchorRouteHandlers(options: SyncServerOptions): NextRouteHandlers;
+//# sourceMappingURL=nextjs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../../src/adapters/nextjs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC1C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAoCvF"}

package/dist/esm/adapters/nextjs.js

@@ -0,0 +1,40 @@
+import { handlePull, handlePush, ProtocolError } from "../handlers.js";
+export function createAnchorRouteHandlers(options) {
+    const json = (body, status = 200) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" } });
+    const authorise = async (request) => {
+        if (!options.authenticate)
+            return true;
+        const headers = {};
+        request.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return Boolean(await options.authenticate(headers));
+    };
+    return {
+        async POST(request) {
+            try {
+                if (!(await authorise(request)))
+                    return json({ error: "unauthorized" }, 401);
+                const url = new URL(request.url);
+                const body = await request.json();
+                if (url.pathname.endsWith("/push"))
+                    return json(await handlePush(body, options));
+                if (url.pathname.endsWith("/pull"))
+                    return json(await handlePull(body, options));
+                return json({ error: `Unknown sync route ${url.pathname}` }, 404);
+            }
+            catch (err) {
+                if (err instanceof ProtocolError)
+                    return json({ error: err.message }, err.status);
+                console.error("[anchor/sync-server]", err);
+                return json({ error: "internal error" }, 500);
+            }
+        },
+        async GET(request) {
+            if (!(await authorise(request)))
+                return json({ error: "unauthorized" }, 401);
+            return json({ ok: true, store: options.store.name, protocolVersion: 1 });
+        },
+    };
+}
+//# sourceMappingURL=nextjs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.js","sourceRoot":"","sources":["../../../src/adapters/nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAqBvE,MAAM,UAAU,yBAAyB,CAAC,OAA0B;IAClE,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,MAAM,GAAG,GAAG,EAAY,EAAE,CACrD,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAElG,MAAM,SAAS,GAAG,KAAK,EAAE,OAAgB,EAAoB,EAAE;QAC7D,IAAI,CAAC,OAAO,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,OAAO,GAAuC,EAAE,CAAC;QACvD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,OAAgB;YACzB,IAAI,CAAC;gBACH,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;gBAE7E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBAElC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAa,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1F,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAa,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1F,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,aAAa;oBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBAClF,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;gBAC3C,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,OAAgB;YACxB,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/handlers.d.ts

@@ -0,0 +1,17 @@
+import { type PullRequest, type PullResponse, type PushRequest, type PushResponse } from "anchordb";
+import type { StoredServerDocument, SyncServerOptions } from "./store/types.js";
+/**
+ * The server half of the sync protocol, as pure functions over a `ServerStore`.
+ *
+ * Express, NestJS and Next.js all delegate here, so there is exactly one implementation of the
+ * rules and the framework adapters are genuinely thin. That matters for the brief's promise that
+ * what the tests verify is what your backend runs.
+ */
+export declare class ProtocolError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare function handlePush(request: PushRequest, options: SyncServerOptions): Promise<PushResponse>;
+export declare function handlePull(request: PullRequest, options: SyncServerOptions): Promise<PullResponse>;
+export type { StoredServerDocument };
+//# sourceMappingURL=handlers.d.ts.map

package/dist/esm/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;;;;;GAMG;AAEH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAqBD,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAexG;AAwGD,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCxG;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/esm/handlers.js

@@ -0,0 +1,162 @@
+import { DUPLICATE_KEY_CODE, PROTOCOL_VERSION, } from "anchordb";
+/**
+ * The server half of the sync protocol, as pure functions over a `ServerStore`.
+ *
+ * Express, NestJS and Next.js all delegate here, so there is exactly one implementation of the
+ * rules and the framework adapters are genuinely thin. That matters for the brief's promise that
+ * what the tests verify is what your backend runs.
+ */
+export class ProtocolError extends Error {
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "ProtocolError";
+    }
+}
+let hlcCounter = 0;
+function serverHlc(now) {
+    hlcCounter = (hlcCounter + 1) % 100_000;
+    return `${String(now).padStart(15, "0")}-${String(hlcCounter).padStart(5, "0")}-server`;
+}
+function validatePush(request) {
+    if (!request || typeof request !== "object")
+        throw new ProtocolError(400, "Request body must be a JSON object");
+    if (request.protocolVersion !== PROTOCOL_VERSION) {
+        throw new ProtocolError(400, `Unsupported protocolVersion ${String(request.protocolVersion)}; this server speaks ${PROTOCOL_VERSION}`);
+    }
+    if (!request.clientId)
+        throw new ProtocolError(400, "clientId is required");
+    if (!Array.isArray(request.changes))
+        throw new ProtocolError(400, "changes must be an array");
+}
+export async function handlePush(request, options) {
+    validatePush(request);
+    const now = options.now ?? (() => Date.now());
+    const results = [];
+    for (const change of request.changes) {
+        results.push(await applyChange(change, request.clientId, options, now()));
+    }
+    return {
+        protocolVersion: PROTOCOL_VERSION,
+        serverTime: new Date(now()).toISOString(),
+        serverHlc: serverHlc(now()),
+        results,
+    };
+}
+async function applyChange(change, clientId, options, now) {
+    const { store } = options;
+    // Idempotency first: a replayed mutation must never be evaluated twice.
+    const memoised = await store.getIdempotent(clientId, change.mutationId);
+    if (memoised)
+        return memoised;
+    const result = await decide(change, options, now);
+    await store.setIdempotent(clientId, change.mutationId, result);
+    return result;
+}
+async function decide(change, options, now) {
+    const { store } = options;
+    if (options.allowedCollections && !options.allowedCollections.includes(change.collection)) {
+        return {
+            mutationId: change.mutationId,
+            status: "rejected",
+            reason: `Collection "${change.collection}" is not accepted by this server`,
+        };
+    }
+    const existing = await store.get(change.collection, change.documentId);
+    const currentVersion = existing?.version ?? 0;
+    // Optimistic concurrency. The client edited a version the server has since moved past, so we
+    // return the server's document and let the CLIENT's configured strategy decide — the server does
+    // not pick a winner, because only the client knows which strategy the developer chose.
+    if (currentVersion !== change.baseVersion) {
+        return {
+            mutationId: change.mutationId,
+            status: "conflict",
+            version: currentVersion,
+            document: existing && !existing.deleted ? existing.document : null,
+            hlc: existing?.hlc ?? "",
+        };
+    }
+    const timestamp = new Date(now).toISOString();
+    if (change.operation === "delete") {
+        if (existing) {
+            await store.put({
+                documentId: change.documentId,
+                collection: change.collection,
+                document: existing.document,
+                version: currentVersion + 1,
+                deleted: true,
+                updatedAt: timestamp,
+                hlc: serverHlc(now),
+            });
+        }
+        return { mutationId: change.mutationId, status: "accepted", version: currentVersion + 1, document: null };
+    }
+    const payload = (change.payload ?? {});
+    for (const index of options.uniqueIndexes ?? []) {
+        if (index.collection !== change.collection)
+            continue;
+        const value = payload[index.field];
+        if (value === undefined || value === null)
+            continue;
+        const clash = await store.findByUniqueField(index.collection, index.field, value, change.documentId);
+        if (clash) {
+            // Two devices created a colliding document while offline; neither could see it locally.
+            // The client treats this as non-retryable and parks the mutation.
+            return {
+                mutationId: change.mutationId,
+                status: "rejected",
+                code: DUPLICATE_KEY_CODE,
+                reason: `E11000 duplicate key error collection: ${change.collection} index: ${index.field}_1 ` +
+                    `dup key: { ${index.field}: "${String(value)}" }`,
+            };
+        }
+    }
+    const hlc = serverHlc(now);
+    const stored = await store.put({
+        documentId: change.documentId,
+        collection: change.collection,
+        document: { ...payload, _id: change.documentId, updatedAt: timestamp },
+        version: currentVersion + 1,
+        deleted: false,
+        updatedAt: timestamp,
+        hlc,
+    });
+    return {
+        mutationId: change.mutationId,
+        status: "accepted",
+        version: stored.version,
+        document: stored.document,
+        hlc,
+    };
+}
+export async function handlePull(request, options) {
+    if (request.protocolVersion !== PROTOCOL_VERSION) {
+        throw new ProtocolError(400, `Unsupported protocolVersion ${String(request.protocolVersion)}; this server speaks ${PROTOCOL_VERSION}`);
+    }
+    const now = options.now ?? (() => Date.now());
+    const after = request.cursor ? Number(request.cursor) : 0;
+    if (Number.isNaN(after))
+        throw new ProtocolError(400, `Malformed cursor "${String(request.cursor)}"`);
+    const limit = Math.min(Math.max(request.limit ?? 100, 1), 1000);
+    const page = await options.store.listChanges(after, limit, request.collections);
+    const changes = page.map((d) => ({
+        collection: d.collection,
+        documentId: d.documentId,
+        document: d.deleted ? null : d.document,
+        version: d.version,
+        deleted: d.deleted,
+        updatedAt: d.updatedAt,
+        hlc: d.hlc,
+    }));
+    const last = page[page.length - 1];
+    const nextCursor = last ? String(last.seq) : (request.cursor ?? null);
+    return {
+        protocolVersion: PROTOCOL_VERSION,
+        serverTime: new Date(now()).toISOString(),
+        serverHlc: serverHlc(now()),
+        changes,
+        nextCursor,
+        hasMore: last ? await options.store.hasMoreAfter(last.seq, request.collections) : false,
+    };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/esm/handlers.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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.
+ */
+export { handlePush, handlePull, ProtocolError } from "./handlers.js";
+export { MemoryStore } from "./store/memory.js";
+export { MongooseStore } from "./store/mongoose.js";
+export type { MongooseStoreOptions } from "./store/mongoose.js";
+export type { ServerStore, StoredServerDocument, SyncServerOptions, UniqueIndexSpec, } from "./store/types.js";
+export { createAnchorRouter } from "./adapters/express.js";
+export { createAnchorRouteHandlers } from "./adapters/nextjs.js";
+export type { NextRouteHandlers } from "./adapters/nextjs.js";
+export { AnchorSyncService, createAnchorSyncService, ANCHOR_SYNC_SERVICE, NESTJS_CONTROLLER_EXAMPLE, } from "./adapters/nestjs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+export { handlePush, handlePull, ProtocolError } from "./handlers.js";
+export { MemoryStore } from "./store/memory.js";
+export { MongooseStore } from "./store/mongoose.js";
+export { createAnchorRouter } from "./adapters/express.js";
+export { createAnchorRouteHandlers } from "./adapters/nextjs.js";
+export { AnchorSyncService, createAnchorSyncService, ANCHOR_SYNC_SERVICE, NESTJS_CONTROLLER_EXAMPLE, } from "./adapters/nestjs.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/esm/package.json

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

package/dist/esm/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/esm/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/esm/store/memory.js

@@ -0,0 +1,61 @@
+/**
+ * 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 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;
+    }
+}
+//# sourceMappingURL=memory.js.map

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

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

package/dist/esm/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/esm/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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"}