anchordb 0.2.0

package/dist/cjs/conflict/strategies.js.map

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

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

@@ -0,0 +1,38 @@
+/** Conflict resolution types. The strategies themselves land in the sync milestone. */
+export type ConflictStrategyName = "last-write-wins" | "server-wins" | "client-wins" | "field-level" | "custom";
+export interface ConflictContext<T = Record<string, unknown>> {
+    local: T;
+    remote: T;
+    base?: T;
+    collection: string;
+    documentId: string;
+    localHlc: string;
+    remoteHlc: string;
+    localVersion?: number;
+    remoteVersion: number;
+    localTimestamp?: number;
+    remoteTimestamp?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface Resolution<T = Record<string, unknown>> {
+    winner: "local" | "remote" | "merged";
+    document: T;
+    /**
+     * Whether the resolved document must be pushed back to the server.
+     *
+     * False whenever the result is the server document unchanged — pushing that back would echo
+     * between client and server forever.
+     */
+    pushBack: boolean;
+    /** Field-level only: paths both sides edited, surfaced for events and the Lens conflict viewer. */
+    conflictedPaths?: string[];
+}
+export type ConflictResolver<T = Record<string, unknown>> = (context: ConflictContext<T>) => Promise<T | Resolution<T>> | T | Resolution<T>;
+export type FieldPolicy = "lww" | "server" | "client";
+export interface ConflictResolutionConfig<T = Record<string, unknown>> {
+    strategy?: ConflictStrategyName;
+    resolver?: ConflictResolver<T>;
+    fieldPolicy?: FieldPolicy | ((path: string, ctx: ConflictContext<T>) => FieldPolicy);
+    arrayStrategy?: "atomic" | "union-by-id";
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/conflict/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,aAAa,GACb,aAAa,GACb,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC;IACZ;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC1D,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC;IACrF,aAAa,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CAC1C"}

package/dist/cjs/conflict/types.js

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

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

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

package/dist/cjs/core/anchor-db.d.ts

@@ -0,0 +1,154 @@
+import { HybridLogicalClock } from "./hlc.js";
+import { TypedEmitter } from "../events/emitter.js";
+import { TimeService } from "../timestamps/index.js";
+import { Schema } from "../schema/schema.js";
+import { Model } from "../model/model.js";
+import { type ModelConstructor } from "../model/document.js";
+import type { AdapterStats, DatabaseAdapter, WriteOp } from "../storage/types.js";
+import type { AnchorEvents } from "./runtime.js";
+import type { ConflictResolutionConfig } from "../conflict/types.js";
+export type SyncStatus = "disabled" | "idle" | "syncing" | "offline" | "error" | "paused";
+export interface SyncConfig {
+    endpoint: string;
+    token?: string;
+    auth?: {
+        token?: string;
+        getToken?: () => string | Promise<string>;
+    };
+    conflictResolution?: ConflictResolutionConfig;
+    /** Automatically drain the queue when connectivity returns. */
+    autoSync?: boolean;
+    intervalMs?: number;
+    batchSize?: number;
+    maxConflictAttempts?: number;
+}
+export interface InspectorConfig {
+    enabled: boolean;
+    relayUrl?: string;
+    authentication?: {
+        mode: "temporary-token";
+        ttlSeconds?: number;
+    };
+    allowInProduction?: boolean;
+}
+export interface AnchorDBConfig {
+    name: string;
+    adapter?: DatabaseAdapter;
+    /** §26.3 — on by default. */
+    timestamps?: boolean;
+    timezone?: {
+        server?: string;
+    };
+    /** Omit entirely for a purely local database. */
+    sync?: SyncConfig;
+    inspector?: InspectorConfig;
+    /** What populate does when a referenced document is not present locally. */
+    onMissingRef?: "null" | "keep-id" | "throw";
+    clientId?: string;
+}
+/**
+ * AnchorDB — MongoDB + Mongoose for mobile apps.
+ *
+ * ## Two modes, one API
+ *
+ * Passing no `sync` block yields a **purely local database**: no mutation queue is created, no
+ * network code is instantiated, deletes are hard deletes rather than tombstones, and documents
+ * carry no sync metadata. That is not a degraded mode — it is the default, and an app with no
+ * backend never pays for machinery it does not use.
+ *
+ * Adding a `sync` block later changes no application code. Existing documents are adopted on first
+ * sync (seeded dirty at version 0) so nothing has to be rewritten or re-imported.
+ */
+export declare class AnchorDB {
+    readonly name: string;
+    readonly time: TimeService;
+    readonly config: AnchorDBConfig;
+    private readonly emitter;
+    private readonly models;
+    private readonly constructors;
+    private readonly clockInstance;
+    private readonly adapterInstance;
+    private clientIdValue;
+    private openPromise;
+    private closed;
+    /** Installed by the sync engine when sync is configured. */
+    private mutationRecorder;
+    private syncStatusValue;
+    constructor(config: AnchorDBConfig);
+    /** True when a `sync` block was supplied. */
+    get syncEnabled(): boolean;
+    get clientId(): string;
+    get adapter(): DatabaseAdapter;
+    /** Exposed for the sync engine, which must stamp and advance the same clock the models use. */
+    get clock(): HybridLogicalClock;
+    /** Opened lazily on first use, so construction never does I/O. */
+    open(): Promise<void>;
+    close(): Promise<void>;
+    /** Mirrors `mongoose.model()`. Calling it again with the same name returns the existing model. */
+    model<T extends Record<string, unknown> = Record<string, unknown>>(name: string, schema?: Schema, options?: {
+        collection?: string;
+    }): ModelConstructor<T>;
+    /**
+     * Schema-less access, matching the driver's `db.collection("users")`. Useful for scratch work and
+     * for Lens, which must browse collections whose schema it does not have.
+     */
+    collection<T extends Record<string, unknown> = Record<string, unknown>>(name: string): ModelConstructor<T>;
+    /**
+     * The model registered for a storage collection, if any.
+     *
+     * Interop needs it: storage holds ObjectIds and Dates as strings, so an export has to consult the
+     * schema to restore their real types before encoding. Without this an export would emit bare
+     * strings and mongoimport would store String instead of ObjectId/Date.
+     */
+    modelForCollection(collection: string): Model | undefined;
+    modelNames(): string[];
+    listCollections(): Promise<string[]>;
+    stats(): Promise<AdapterStats & {
+        name: string;
+        syncEnabled: boolean;
+    }>;
+    /** Deletes all local data. Lens exposes this as an explicit developer action. */
+    destroy(): Promise<void>;
+    on<K extends keyof AnchorEvents>(event: K, listener: (payload: AnchorEvents[K]) => void): () => void;
+    off<K extends keyof AnchorEvents>(event: K, listener: (payload: AnchorEvents[K]) => void): void;
+    once<K extends keyof AnchorEvents>(event: K, listener: (payload: AnchorEvents[K]) => void): () => void;
+    get events(): TypedEmitter<AnchorEvents>;
+    /**
+     * Always present, even with no backend, so UI bound to sync state does not have to branch. In
+     * local-only mode `status()` reports "disabled" and the actions are explicit no-ops rather than
+     * throwing — a dashboard that renders sync state should degrade, not crash.
+     */
+    readonly sync: {
+        status: () => SyncStatus;
+        isEnabled: () => boolean;
+        now: () => Promise<{
+            pushed: number;
+            pulled: number;
+            conflicts: number;
+        } | null>;
+        pending: () => Promise<number>;
+    };
+    private syncRunner;
+    private pendingCounter;
+    /** Used by the sync engine to install itself without AnchorDB importing it. */
+    _attachSync(hooks: {
+        recordMutations: (collection: string, ops: WriteOp[]) => Promise<void>;
+        run: () => Promise<{
+            pushed: number;
+            pulled: number;
+            conflicts: number;
+        }>;
+        pending: () => Promise<number>;
+        setStatus: (fn: (status: SyncStatus) => void) => void;
+    }): void;
+    private runtimeCache;
+    private runtime;
+    /**
+     * The inspector exposes application data, so enabling it in production requires an explicit,
+     * separate acknowledgement — a config typo must never open a database over the network.
+     */
+    private assertInspectorSafe;
+}
+/** Alias matching the brief's original naming. */
+export declare const LocalDB: typeof AnchorDB;
+//# sourceMappingURL=anchor-db.d.ts.map

package/dist/cjs/core/anchor-db.d.ts.map

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

package/dist/cjs/core/anchor-db.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalDB = exports.AnchorDB = void 0;
+const errors_ts_1 = require("./errors.js");
+const hlc_ts_1 = require("./hlc.js");
+const uuid_ts_1 = require("./uuid.js");
+const emitter_ts_1 = require("../events/emitter.js");
+const index_ts_1 = require("../timestamps/index.js");
+const timezone_ts_1 = require("../timestamps/timezone.js");
+const schema_ts_1 = require("../schema/schema.js");
+const model_ts_1 = require("../model/model.js");
+const document_ts_1 = require("../model/document.js");
+const memory_ts_1 = require("../storage/adapters/memory.js");
+/**
+ * AnchorDB — MongoDB + Mongoose for mobile apps.
+ *
+ * ## Two modes, one API
+ *
+ * Passing no `sync` block yields a **purely local database**: no mutation queue is created, no
+ * network code is instantiated, deletes are hard deletes rather than tombstones, and documents
+ * carry no sync metadata. That is not a degraded mode — it is the default, and an app with no
+ * backend never pays for machinery it does not use.
+ *
+ * Adding a `sync` block later changes no application code. Existing documents are adopted on first
+ * sync (seeded dirty at version 0) so nothing has to be rewritten or re-imported.
+ */
+class AnchorDB {
+    constructor(config) {
+        this.emitter = new emitter_ts_1.TypedEmitter();
+        this.models = new Map();
+        this.constructors = new Map();
+        this.openPromise = null;
+        this.closed = false;
+        /** Installed by the sync engine when sync is configured. */
+        this.mutationRecorder = null;
+        // ---- sync facade ---------------------------------------------------------
+        /**
+         * Always present, even with no backend, so UI bound to sync state does not have to branch. In
+         * local-only mode `status()` reports "disabled" and the actions are explicit no-ops rather than
+         * throwing — a dashboard that renders sync state should degrade, not crash.
+         */
+        this.sync = {
+            status: () => this.syncStatusValue,
+            isEnabled: () => this.syncEnabled,
+            now: async () => {
+                if (!this.syncEnabled)
+                    return null;
+                if (!this.syncRunner) {
+                    throw new errors_ts_1.AnchorConfigError("Sync is configured but the sync engine has not been attached. Import and call attachSync(db).");
+                }
+                return this.syncRunner();
+            },
+            pending: async () => (this.pendingCounter ? this.pendingCounter() : 0),
+        };
+        this.syncRunner = null;
+        this.pendingCounter = null;
+        // ---- internals -----------------------------------------------------------
+        this.runtimeCache = null;
+        if (!config.name || typeof config.name !== "string") {
+            throw new errors_ts_1.AnchorConfigError("AnchorDB requires a `name`, e.g. new AnchorDB({ name: \"my-app\" }).");
+        }
+        this.config = config;
+        this.name = config.name;
+        // Validated at construction so a typo fails immediately rather than silently rendering wrong
+        // times for the life of the app (§26.10).
+        if (config.timezone?.server)
+            (0, timezone_ts_1.assertValidTimeZone)(config.timezone.server, "timezone.server");
+        this.time = new index_ts_1.TimeService(config.timezone?.server ? { serverTimeZone: config.timezone.server } : {});
+        this.clientIdValue = config.clientId ?? (0, uuid_ts_1.generateClientId)();
+        this.clockInstance = new hlc_ts_1.HybridLogicalClock({ node: this.clientIdValue, now: () => this.time.nowMs() });
+        this.adapterInstance = config.adapter ?? new memory_ts_1.MemoryAdapter(config.name);
+        this.syncStatusValue = config.sync ? "idle" : "disabled";
+        if (config.inspector?.enabled)
+            this.assertInspectorSafe(config.inspector);
+    }
+    /** True when a `sync` block was supplied. */
+    get syncEnabled() {
+        return this.config.sync !== undefined;
+    }
+    get clientId() {
+        return this.clientIdValue;
+    }
+    get adapter() {
+        return this.adapterInstance;
+    }
+    /** Exposed for the sync engine, which must stamp and advance the same clock the models use. */
+    get clock() {
+        return this.clockInstance;
+    }
+    /** Opened lazily on first use, so construction never does I/O. */
+    async open() {
+        this.openPromise ??= (async () => {
+            await this.adapterInstance.open();
+            const storedClientId = await this.adapterInstance.getState("anchor:clientId");
+            if (storedClientId) {
+                // Adopt the persisted identity, and correct the clock with it: the clock was built in the
+                // constructor with a freshly generated id, before storage could be consulted.
+                this.clientIdValue = storedClientId;
+                this.clockInstance.setNode(storedClientId);
+            }
+            else {
+                await this.adapterInstance.setState("anchor:clientId", this.clientIdValue);
+            }
+            // Restoring the clock keeps ordering monotonic across an app restart.
+            const storedClock = await this.adapterInstance.getState("anchor:hlc");
+            if (storedClock)
+                this.clockInstance.restore(storedClock);
+        })();
+        return this.openPromise;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        if (this.openPromise) {
+            await this.openPromise;
+            await this.adapterInstance.setState("anchor:hlc", encodeClock(this.clockInstance));
+            await this.adapterInstance.close();
+        }
+        this.closed = true;
+    }
+    /** Mirrors `mongoose.model()`. Calling it again with the same name returns the existing model. */
+    model(name, schema, options) {
+        const existing = this.constructors.get(name);
+        if (existing) {
+            if (schema && existing.schema !== schema) {
+                throw new errors_ts_1.AnchorConfigError(`Model "${name}" is already registered with a different schema. ` +
+                    `Call db.model("${name}") without a schema to retrieve it.`);
+            }
+            return existing;
+        }
+        if (!schema) {
+            throw new errors_ts_1.AnchorConfigError(`Model "${name}" has not been registered. Pass a schema: db.model("${name}", schema).`);
+        }
+        const model = new model_ts_1.Model(name, schema, this.runtime(), options);
+        const ctor = (0, document_ts_1.createModelConstructor)(model);
+        // Queries return Documents unless .lean(); the factory closes the loop without Model
+        // importing Document (which would be circular).
+        model._setDocumentFactory((doc) => ctor.hydrate(doc));
+        this.models.set(name, model);
+        this.constructors.set(name, ctor);
+        return ctor;
+    }
+    /**
+     * Schema-less access, matching the driver's `db.collection("users")`. Useful for scratch work and
+     * for Lens, which must browse collections whose schema it does not have.
+     */
+    collection(name) {
+        const key = `__collection__${name}`;
+        const existing = this.constructors.get(key);
+        if (existing)
+            return existing;
+        const schema = new schema_ts_1.Schema({}, { strict: false, timestamps: this.config.timestamps ?? true });
+        const model = new model_ts_1.Model(key, schema, this.runtime(), { collection: name });
+        const ctor = (0, document_ts_1.createModelConstructor)(model);
+        model._setDocumentFactory((doc) => ctor.hydrate(doc));
+        this.models.set(key, model);
+        this.constructors.set(key, ctor);
+        return ctor;
+    }
+    /**
+     * The model registered for a storage collection, if any.
+     *
+     * Interop needs it: storage holds ObjectIds and Dates as strings, so an export has to consult the
+     * schema to restore their real types before encoding. Without this an export would emit bare
+     * strings and mongoimport would store String instead of ObjectId/Date.
+     */
+    modelForCollection(collection) {
+        for (const model of this.models.values()) {
+            if (model.collectionName === collection)
+                return model;
+        }
+        return undefined;
+    }
+    modelNames() {
+        return [...this.models.keys()].filter((n) => !n.startsWith("__collection__"));
+    }
+    async listCollections() {
+        await this.open();
+        return this.adapterInstance.listCollections();
+    }
+    async stats() {
+        await this.open();
+        const stats = await this.adapterInstance.stats();
+        return { ...stats, name: this.name, syncEnabled: this.syncEnabled };
+    }
+    /** Deletes all local data. Lens exposes this as an explicit developer action. */
+    async destroy() {
+        await this.open();
+        await this.adapterInstance.destroy();
+    }
+    // ---- events --------------------------------------------------------------
+    on(event, listener) {
+        return this.emitter.on(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    once(event, listener) {
+        return this.emitter.once(event, listener);
+    }
+    get events() {
+        return this.emitter;
+    }
+    /** Used by the sync engine to install itself without AnchorDB importing it. */
+    _attachSync(hooks) {
+        this.mutationRecorder = hooks.recordMutations;
+        this.syncRunner = hooks.run;
+        this.pendingCounter = hooks.pending;
+        hooks.setStatus((status) => {
+            this.syncStatusValue = status;
+        });
+    }
+    runtime() {
+        this.runtimeCache ??= {
+            adapter: this.adapterInstance,
+            time: this.time,
+            clock: this.clockInstance,
+            events: this.emitter,
+            get syncEnabled() {
+                return false;
+            },
+            clientId: this.clientIdValue, // replaced below by a live getter
+            onMissingRef: this.config.onMissingRef ?? "null",
+            ready: () => this.open(),
+            getModelByCollection: (collection) => this.modelForCollection(collection),
+            getModel: (name) => {
+                const model = this.models.get(name);
+                if (!model) {
+                    throw new errors_ts_1.AnchorConfigError(`Model "${name}" is referenced by a populate() but has not been registered on this database.`);
+                }
+                return model;
+            },
+            recordMutations: async (collection, ops) => {
+                if (this.mutationRecorder)
+                    await this.mutationRecorder(collection, ops);
+            },
+        };
+        // Both must be live getters. `syncEnabled` because the sync engine may attach after models are
+        // created; `clientId` because open() may replace it with the persisted identity.
+        Object.defineProperty(this.runtimeCache, "syncEnabled", {
+            get: () => this.syncEnabled,
+            configurable: true,
+        });
+        Object.defineProperty(this.runtimeCache, "clientId", {
+            get: () => this.clientIdValue,
+            configurable: true,
+        });
+        return this.runtimeCache;
+    }
+    /**
+     * The inspector exposes application data, so enabling it in production requires an explicit,
+     * separate acknowledgement — a config typo must never open a database over the network.
+     */
+    assertInspectorSafe(inspector) {
+        const env = globalThis.process?.env?.NODE_ENV ?? "development";
+        if (env === "production" && !inspector.allowInProduction) {
+            throw new errors_ts_1.AnchorConfigError("The Anchor Inspector is enabled while NODE_ENV=production. It exposes your local database to " +
+                "Anchor Lens and must not ship in a release build. If this is deliberate (an internal build, " +
+                "say), set inspector.allowInProduction: true to acknowledge it.");
+        }
+        // eslint-disable-next-line no-console
+        console.warn(`[anchor] Inspector ENABLED for database "${this.name}". Your local data is reachable by Anchor Lens. ` +
+            `Disable it before shipping.`);
+    }
+}
+exports.AnchorDB = AnchorDB;
+function encodeClock(clock) {
+    const peek = clock.peek();
+    return `${String(peek.wall).padStart(15, "0")}-${String(peek.counter).padStart(5, "0")}-${peek.node}`;
+}
+/** Alias matching the brief's original naming. */
+exports.LocalDB = AnchorDB;
+//# sourceMappingURL=anchor-db.js.map

package/dist/cjs/core/anchor-db.js.map

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

package/dist/cjs/core/errors.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Mongoose-shaped error hierarchy.
+ *
+ * Principle 1 (zero re-learning) applies to failures as much as to successes: code that already
+ * does `if (err.code === 11000)` or reads `err.errors[path].kind` on the backend must work
+ * unchanged here. Every class below mirrors the name, message format and enumerable properties
+ * Mongoose produces.
+ */
+/** Base class for every error AnchorDB raises. Mirrors Mongoose's `MongooseError`. */
+export declare class AnchorError extends Error {
+    readonly name: string;
+    constructor(message: string);
+}
+/** Configuration rejected at construction time (bad timezone, unknown adapter, ...). */
+export declare class AnchorConfigError extends AnchorError {
+    readonly name = "AnchorConfigError";
+}
+/**
+ * A single failed validator on one path. Mongoose calls this `ValidatorError` and nests instances
+ * inside `ValidationError.errors`.
+ */
+export declare class ValidatorError extends AnchorError {
+    readonly name = "ValidatorError";
+    readonly path: string;
+    readonly value: unknown;
+    /** Which validator failed: `required`, `min`, `enum`, `user defined`, ... */
+    readonly kind: string;
+    readonly properties: Record<string, unknown>;
+    constructor(opts: {
+        path: string;
+        value: unknown;
+        kind: string;
+        message: string;
+        [k: string]: unknown;
+    });
+}
+/**
+ * Failure converting a value to its declared type. Message format matches Mongoose so that
+ * log-scraping and error reporting behave identically.
+ */
+export declare class CastError extends AnchorError {
+    readonly name = "CastError";
+    readonly stringValue: string;
+    readonly kind: string;
+    readonly value: unknown;
+    readonly path: string;
+    readonly valueType: string;
+    constructor(kind: string, value: unknown, path: string, reason?: string);
+}
+/** Aggregate of every path that failed validation for one document. */
+export declare class ValidationError extends AnchorError {
+    readonly name = "ValidationError";
+    readonly errors: Record<string, ValidatorError | CastError>;
+    constructor(modelName?: string);
+    readonly modelName: string | undefined;
+    addError(path: string, error: ValidatorError | CastError): void;
+    get isEmpty(): boolean;
+    private buildMessage;
+}
+/** Raised by `orFail()` and by Lens edits targeting a document that vanished. */
+export declare class DocumentNotFoundError extends AnchorError {
+    readonly name = "DocumentNotFoundError";
+    readonly filter: unknown;
+    constructor(filter: unknown, modelName?: string);
+}
+/** Writing a path not present in the schema while `strict: "throw"` is set. */
+export declare class StrictModeError extends AnchorError {
+    readonly name = "StrictModeError";
+    readonly path: string;
+    constructor(path: string);
+}
+/**
+ * Server-style write error. A unique index violation surfaces as one of these with `code: 11000`,
+ * exactly like the MongoDB driver, so `err.code === 11000` branches port over untouched.
+ */
+export declare class MongoServerError extends AnchorError {
+    readonly name = "MongoServerError";
+    readonly code: number;
+    readonly keyPattern: Record<string, 1 | -1> | undefined;
+    readonly keyValue: Record<string, unknown> | undefined;
+    readonly index: string | undefined;
+    constructor(opts: {
+        message: string;
+        code: number;
+        keyPattern?: Record<string, 1 | -1>;
+        keyValue?: Record<string, unknown>;
+        index?: string;
+    });
+}
+export declare const DUPLICATE_KEY_CODE = 11000;
+/**
+ * Build the duplicate-key error MongoDB produces. The message is reproduced literally — including
+ * the `E11000 duplicate key error collection:` prefix — because real code greps for it.
+ */
+export declare function duplicateKeyError(opts: {
+    dbName: string;
+    collection: string;
+    index: string;
+    keyPattern: Record<string, 1 | -1>;
+    keyValue: Record<string, unknown>;
+}): MongoServerError;
+/** Reported by `insertMany({ ordered: false })` after every insert has been attempted. */
+export declare class BulkWriteError extends AnchorError {
+    readonly name = "MongoBulkWriteError";
+    readonly code = 11000;
+    readonly writeErrors: Array<{
+        index: number;
+        code: number;
+        errmsg: string;
+        err: Error;
+    }>;
+    readonly insertedCount: number;
+    readonly insertedIds: Record<number, unknown>;
+    constructor(opts: {
+        writeErrors: Array<{
+            index: number;
+            code: number;
+            errmsg: string;
+            err: Error;
+        }>;
+        insertedCount: number;
+        insertedIds: Record<number, unknown>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map