anchordb 0.2.0

package/dist/cjs/core/object-id.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectId = void 0;
+const hex_ts_1 = require("./hex.js");
+const random_ts_1 = require("./random.js");
+/**
+ * A real MongoDB ObjectId — not a lookalike.
+ *
+ * Layout is exactly the BSON spec, which is what makes documents portable to a real database
+ * without translation:
+ *
+ *   bytes 0-3   4-byte big-endian seconds since the Unix epoch
+ *   bytes 4-8   5-byte value random per process
+ *   bytes 9-11  3-byte big-endian counter, randomly seeded
+ *
+ * Two consequences we rely on elsewhere:
+ *
+ *  - Because the timestamp leads and is big-endian, the lowercase hex form sorts in the same order
+ *    as the raw bytes. So `_id` can be the SQLite TEXT primary key and still give creation-ordered
+ *    scans and cheap cursor pagination, with no separate sort column.
+ *  - The per-process random block is what keeps two devices generating ids offline from colliding,
+ *    which is why `random.ts` refuses to run without a real CSPRNG.
+ */
+const PROCESS_RANDOM = (0, random_ts_1.randomBytes)(5);
+const COUNTER_MAX = 0xffffff;
+let counter = (0, random_ts_1.randomInt)(COUNTER_MAX + 1);
+function nextCounter() {
+    counter = (counter + 1) % (COUNTER_MAX + 1); // wraps at 2^24, as the spec requires
+    return counter;
+}
+/**
+ * A note on numbers: bson (and therefore Mongoose) rejects `new ObjectId(1234)` outright with
+ * "Argument passed in does not match the accepted types". AnchorDB rejects it too, rather than
+ * offering a friendlier overload, because a convenience that exists only here is exactly the kind
+ * of drift that stops code porting cleanly. Build from a time with `createFromTime()`.
+ */
+class ObjectId {
+    constructor(value) {
+        /** Marks the value for BSON/Mongoose consumers that brand-check instead of instanceof. */
+        this._bsontype = "ObjectId";
+        this.cachedHex = null;
+        if (value === undefined || value === null) {
+            this.bytes = ObjectId.generate();
+            return;
+        }
+        if (value instanceof ObjectId) {
+            this.bytes = value.bytes.slice();
+            return;
+        }
+        if (typeof value === "string") {
+            const parsed = (0, hex_ts_1.hexToBytes)(value, 12);
+            if (!parsed) {
+                throw new TypeError(`Argument passed in must be a string of 12 bytes or a string of 24 hex characters, got "${value}"`);
+            }
+            this.bytes = parsed;
+            return;
+        }
+        if (value instanceof Uint8Array) {
+            if (value.length !== 12) {
+                throw new TypeError(`Argument passed in must be 12 bytes, got ${value.length}`);
+            }
+            this.bytes = value.slice();
+            return;
+        }
+        if (typeof value.toHexString === "function") {
+            // Accepts a foreign ObjectId (e.g. from the official `bson` package) without importing it.
+            const parsed = (0, hex_ts_1.hexToBytes)(value.toHexString(), 12);
+            if (parsed) {
+                this.bytes = parsed;
+                return;
+            }
+        }
+        throw new TypeError("Argument passed in does not match the accepted types");
+    }
+    /** Raw 12 bytes. Copied, so callers cannot mutate an id in place. */
+    get id() {
+        return this.bytes.slice();
+    }
+    toHexString() {
+        this.cachedHex ??= (0, hex_ts_1.bytesToHex)(this.bytes);
+        return this.cachedHex;
+    }
+    toString() {
+        return this.toHexString();
+    }
+    /** Serialises to the plain hex string, matching Mongoose — not to `{ $oid }`. */
+    toJSON() {
+        return this.toHexString();
+    }
+    /** Second-precision creation time. Useful, but never the canonical `createdAt`. */
+    getTimestamp() {
+        const seconds = (this.bytes[0] << 24) | (this.bytes[1] << 16) | (this.bytes[2] << 8) | this.bytes[3];
+        return new Date((seconds >>> 0) * 1000);
+    }
+    equals(other) {
+        if (other === null || other === undefined)
+            return false;
+        if (other instanceof ObjectId)
+            return this.toHexString() === other.toHexString();
+        if (typeof other === "string")
+            return this.toHexString() === other.toLowerCase();
+        if (other instanceof Uint8Array) {
+            if (other.length !== 12)
+                return false;
+            return this.toHexString() === (0, hex_ts_1.bytesToHex)(other);
+        }
+        if (typeof other.toHexString === "function")
+            return this.toHexString() === other.toHexString().toLowerCase();
+        return false;
+    }
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return `new ObjectId("${this.toHexString()}")`;
+    }
+    inspect() {
+        return `new ObjectId("${this.toHexString()}")`;
+    }
+    /** Raw 12-byte generator. `time` is seconds since the epoch; defaults to now. */
+    static generate(time) {
+        const seconds = Math.floor(time ?? Date.now() / 1000);
+        const out = new Uint8Array(12);
+        out[0] = (seconds >> 24) & 0xff;
+        out[1] = (seconds >> 16) & 0xff;
+        out[2] = (seconds >> 8) & 0xff;
+        out[3] = seconds & 0xff;
+        out.set(PROCESS_RANDOM, 4);
+        const c = nextCounter();
+        out[9] = (c >> 16) & 0xff;
+        out[10] = (c >> 8) & 0xff;
+        out[11] = c & 0xff;
+        return out;
+    }
+    static createFromHexString(hex) {
+        return new ObjectId(hex);
+    }
+    static createFromTime(seconds) {
+        const bytes = new Uint8Array(12);
+        bytes[0] = (seconds >> 24) & 0xff;
+        bytes[1] = (seconds >> 16) & 0xff;
+        bytes[2] = (seconds >> 8) & 0xff;
+        bytes[3] = seconds & 0xff;
+        return new ObjectId(bytes);
+    }
+    /**
+     * Mirrors the driver's `isValid`: accepts a 24-char hex string, 12 raw bytes, an ObjectId, or
+     * anything exposing `toHexString()`. Notably it does *not* accept arbitrary 12-char strings.
+     */
+    static isValid(value) {
+        if (value === null || value === undefined)
+            return false;
+        if (value instanceof ObjectId)
+            return true;
+        if (typeof value === "string")
+            return (0, hex_ts_1.hexToBytes)(value, 12) !== null;
+        if (value instanceof Uint8Array)
+            return value.length === 12;
+        if (typeof value.toHexString === "function") {
+            return (0, hex_ts_1.hexToBytes)(value.toHexString(), 12) !== null;
+        }
+        return false;
+    }
+    /** Test seam so counter-rollover behaviour can be exercised deterministically. */
+    static __setCounter(value) {
+        counter = value % (COUNTER_MAX + 1);
+    }
+}
+exports.ObjectId = ObjectId;
+//# sourceMappingURL=object-id.js.map

package/dist/cjs/core/object-id.js.map

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

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

@@ -0,0 +1,6 @@
+/** Test seam, and the escape hatch for exotic runtimes. Pass `null` to restore platform crypto. */
+export declare function setRandomBytesSource(fn: ((size: number) => Uint8Array) | null): void;
+export declare function randomBytes(size: number): Uint8Array;
+/** Uniform integer in [0, maxExclusive). Used to seed the ObjectId counter. */
+export declare function randomInt(maxExclusive: number): number;
+//# sourceMappingURL=random.d.ts.map

package/dist/cjs/core/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../../src/core/random.ts"],"names":[],"mappings":"AAYA,mGAAmG;AACnG,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI,CAEpF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAepD;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAItD"}

package/dist/cjs/core/random.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRandomBytesSource = setRandomBytesSource;
+exports.randomBytes = randomBytes;
+exports.randomInt = randomInt;
+const errors_ts_1 = require("./errors.js");
+/**
+ * Cryptographically secure random bytes.
+ *
+ * ObjectId collision resistance depends on this being a real CSPRNG, so there is deliberately no
+ * `Math.random()` fallback: on a platform without one we throw a message that names the fix. A
+ * silent downgrade would raise collision risk across devices in exactly the offline, multi-device
+ * scenario AnchorDB exists to serve, and would do so invisibly.
+ */
+let override = null;
+/** Test seam, and the escape hatch for exotic runtimes. Pass `null` to restore platform crypto. */
+function setRandomBytesSource(fn) {
+    override = fn;
+}
+function randomBytes(size) {
+    if (override)
+        return override(size);
+    const out = new Uint8Array(size);
+    const c = globalThis.crypto;
+    if (c && typeof c.getRandomValues === "function") {
+        c.getRandomValues(out);
+        return out;
+    }
+    throw new errors_ts_1.AnchorConfigError("No cryptographically secure random source is available (globalThis.crypto.getRandomValues is missing). " +
+        "On React Native, install and import `react-native-get-random-values` at the top of your entry file. " +
+        "AnchorDB refuses to fall back to Math.random() because ObjectId uniqueness depends on real entropy.");
+}
+/** Uniform integer in [0, maxExclusive). Used to seed the ObjectId counter. */
+function randomInt(maxExclusive) {
+    const bytes = randomBytes(4);
+    const value = ((bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]) >>> 0;
+    return value % maxExclusive;
+}
+//# sourceMappingURL=random.js.map

package/dist/cjs/core/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../src/core/random.ts"],"names":[],"mappings":";;AAaA,oDAEC;AAED,kCAeC;AAGD,8BAIC;AAvCD,2CAAgD;AAEhD;;;;;;;GAOG;AACH,IAAI,QAAQ,GAA0C,IAAI,CAAC;AAE3D,mGAAmG;AACnG,SAAgB,oBAAoB,CAAC,EAAyC;IAC5E,QAAQ,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,GAAuB,UAAU,CAAC,MAAM,CAAC;IAChD,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjD,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,IAAI,6BAAiB,CACzB,yGAAyG;QACvG,sGAAsG;QACtG,qGAAqG,CACxG,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAgB,SAAS,CAAC,YAAoB;IAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC;IAC3F,OAAO,KAAK,GAAG,YAAY,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,96 @@
+import type { HybridLogicalClock } from "./hlc.js";
+import type { TimeService } from "../timestamps/index.js";
+import type { TypedEmitter } from "../events/emitter.js";
+import type { DatabaseAdapter, WriteOp } from "../storage/types.js";
+import type { Model } from "../model/model.js";
+/** Events the SDK emits. Local events fire in both modes; sync events only in synced mode. */
+export interface AnchorEvents extends Record<string, unknown> {
+    change: {
+        collection: string;
+        modelName: string;
+        operation: "insert" | "update" | "replace" | "delete";
+        documentId: string;
+        document: Record<string, unknown> | null;
+    };
+    "queue:changed": {
+        pending: number;
+        failed: number;
+    };
+    online: {
+        at: string;
+    };
+    offline: {
+        at: string;
+    };
+    "sync:start": {
+        pending: number;
+    };
+    "sync:progress": {
+        pushed: number;
+        pulled: number;
+    };
+    "sync:complete": {
+        pushed: number;
+        pulled: number;
+        conflicts: number;
+        durationMs: number;
+    };
+    "sync:error": {
+        error: Error;
+        phase: "push" | "pull";
+    };
+    conflict: {
+        collection: string;
+        documentId: string;
+        strategy: string;
+        winner: "local" | "remote" | "merged";
+        local: Record<string, unknown>;
+        remote: Record<string, unknown>;
+        base?: Record<string, unknown>;
+        resolved: Record<string, unknown>;
+    };
+    "conflict:unresolvable": {
+        collection: string;
+        documentId: string;
+        attempts: number;
+    };
+    "duplicate-key": {
+        collection: string;
+        documentId: string;
+        index: string;
+        keyValue: Record<string, unknown>;
+    };
+    "auth:expired": {
+        at: string;
+    };
+}
+/**
+ * The shared services a Model needs, passed as one object so Model never reaches back into AnchorDB.
+ *
+ * `syncEnabled` is the single flag that distinguishes the two modes. It is read at write time rather
+ * than branching into a different code path, which is what keeps local-only and synced behaviour
+ * identical everywhere except where they genuinely must differ (queueing and tombstones).
+ */
+export interface AnchorRuntime {
+    readonly adapter: DatabaseAdapter;
+    readonly time: TimeService;
+    readonly clock: HybridLogicalClock;
+    readonly events: TypedEmitter<AnchorEvents>;
+    readonly syncEnabled: boolean;
+    readonly clientId: string;
+    readonly onMissingRef: "null" | "keep-id" | "throw";
+    getModel(name: string): Model;
+    /** Resolve a storage collection name to its model, if one is registered. Used by $lookup. */
+    getModelByCollection?(collection: string): Model | undefined;
+    /**
+     * Resolves once the adapter is open.
+     *
+     * AnchorDB opens lazily so construction never does I/O, which means every Model operation must
+     * await this first. MemoryAdapter tolerates being used unopened; a SQLite adapter does not, so
+     * without this the file-backed path fails while the in-memory tests pass.
+     */
+    ready(): Promise<void>;
+    /** No-op in local-only mode; the sync engine installs the real implementation. */
+    recordMutations(collection: string, ops: WriteOp[]): Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/cjs/core/runtime.d.ts.map

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

package/dist/cjs/core/runtime.js

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

package/dist/cjs/core/runtime.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * UUIDv7 — time-ordered, used for mutation ids.
+ *
+ * Time-ordering matters here: the mutation queue is replayed in creation order, and a sortable id
+ * means the queue's natural primary-key order is already the correct apply order.
+ *
+ *   48 bits  big-endian milliseconds
+ *    4 bits  version (7)
+ *   12 bits  random
+ *    2 bits  variant (0b10)
+ *   62 bits  random
+ */
+export declare function uuidv7(): string;
+/** Short, human-readable client identity, e.g. `cli_a3f9c2d1`. */
+export declare function generateClientId(): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/cjs/core/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/core/uuid.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAgB/B;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/cjs/core/uuid.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidv7 = uuidv7;
+exports.generateClientId = generateClientId;
+const hex_ts_1 = require("./hex.js");
+const random_ts_1 = require("./random.js");
+/**
+ * UUIDv7 — time-ordered, used for mutation ids.
+ *
+ * Time-ordering matters here: the mutation queue is replayed in creation order, and a sortable id
+ * means the queue's natural primary-key order is already the correct apply order.
+ *
+ *   48 bits  big-endian milliseconds
+ *    4 bits  version (7)
+ *   12 bits  random
+ *    2 bits  variant (0b10)
+ *   62 bits  random
+ */
+function uuidv7() {
+    const now = Date.now();
+    const bytes = (0, random_ts_1.randomBytes)(16);
+    bytes[0] = (now / 2 ** 40) & 0xff;
+    bytes[1] = (now / 2 ** 32) & 0xff;
+    bytes[2] = (now / 2 ** 24) & 0xff;
+    bytes[3] = (now / 2 ** 16) & 0xff;
+    bytes[4] = (now / 2 ** 8) & 0xff;
+    bytes[5] = now & 0xff;
+    bytes[6] = (bytes[6] & 0x0f) | 0x70; // version 7
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10
+    const hex = (0, hex_ts_1.bytesToHex)(bytes);
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/** Short, human-readable client identity, e.g. `cli_a3f9c2d1`. */
+function generateClientId() {
+    return `cli_${(0, hex_ts_1.bytesToHex)((0, random_ts_1.randomBytes)(8))}`;
+}
+//# sourceMappingURL=uuid.js.map

package/dist/cjs/core/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/core/uuid.ts"],"names":[],"mappings":";;AAeA,wBAgBC;AAGD,4CAEC;AApCD,qCAAsC;AACtC,2CAA0C;AAE1C;;;;;;;;;;;GAWG;AACH,SAAgB,MAAM;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,IAAA,uBAAW,EAAC,EAAE,CAAC,CAAC;IAE9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IAEtB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,YAAY;IAClD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;IAEnD,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,kEAAkE;AAClE,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,IAAA,mBAAU,EAAC,IAAA,uBAAW,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/cjs/decorators/index.d.ts

@@ -0,0 +1,48 @@
+import { Schema } from "../schema/schema.js";
+import { SchemaTypes, type SchemaOptions, type SchemaTypeOptions, type VirtualDefinition } from "../schema/types.js";
+/** `@Schema({ timestamps: true })` on the class. */
+export declare function Schema_(options?: SchemaOptions): ClassDecorator;
+export { Schema_ as Schema };
+export type PropArg = SchemaTypeOptions | unknown[] | (new (...args: never[]) => unknown) | undefined;
+/**
+ * `@Prop()`, accepting every form `@nestjs/mongoose` accepts:
+ *
+ *   @Prop()                         infer from design:type
+ *   @Prop(String)                   explicit type
+ *   @Prop({ type: String, ... })    explicit type plus options
+ *   @Prop([String])                 array of type
+ *   @Prop(raw({ ... }))             inline nested definition
+ */
+export declare function Prop(arg?: PropArg): PropertyDecorator;
+/** `@Virtual()` — a computed path, matching @nestjs/mongoose v10. */
+export declare function Virtual(options?: VirtualDefinition["options"]): PropertyDecorator;
+/** Class-level index declaration, mirroring `schema.index()`. */
+export declare function Index(fields: Record<string, 1 | -1>, options?: Record<string, unknown>): ClassDecorator;
+/** Inline nested definition, matching @nestjs/mongoose's `raw()`. */
+export declare function raw(definition: Record<string, unknown>): SchemaTypeOptions;
+export interface MongooseDefinition {
+    definition: Record<string, unknown>;
+    options: SchemaOptions;
+    indexes: Array<{
+        fields: Record<string, 1 | -1>;
+        options: Record<string, unknown>;
+    }>;
+}
+export declare class SchemaFactory {
+    /** Build an AnchorDB `Schema` from a decorated class. */
+    static createForClass<T>(target: new (...args: never[]) => T): Schema<T>;
+    /** The raw definition, shared by `createForClass` and the Mongoose emitter. */
+    static toDefinition(target: new (...args: never[]) => unknown): MongooseDefinition;
+    /**
+     * Emit the twin Mongoose schema for the backend.
+     *
+     * Called without arguments it returns the plain definition/options objects, so it works without
+     * mongoose installed. Pass the mongoose module to get a real `mongoose.Schema` back.
+     */
+    static toMongooseSchema(target: new (...args: never[]) => unknown, mongooseModule?: {
+        Schema: new (def: unknown, opts?: unknown) => unknown;
+    }): unknown;
+}
+export { SchemaTypes };
+export type { SchemaOptions, SchemaTypeOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA+DrH,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,OAAO,GAAE,aAAkB,GAAG,cAAc,CASnE;AACD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC;AAE7B,MAAM,MAAM,OAAO,GAAG,iBAAiB,GAAG,OAAO,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;AAEtG;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAarD;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,iBAAiB,CAsBjF;AAED,iEAAiE;AACjE,wBAAgB,KAAK,CACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,cAAc,CAahB;AAED,qEAAqE;AACrE,wBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAE1E;AAiED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,qBAAa,aAAa;IACxB,yDAAyD;IACzD,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IA0BxE,+EAA+E;IAC/E,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,kBAAkB;IAsBlF;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CACrB,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACzC,cAAc,CAAC,EAAE;QAAE,MAAM,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;KAAE,GACzE,OAAO;CAYX;AAgCD,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC"}