anchordb 0.2.0

package/dist/esm/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/esm/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/esm/core/uuid.js

@@ -0,0 +1,33 @@
+import { bytesToHex } from "./hex.js";
+import { randomBytes } from "./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
+ */
+export function uuidv7() {
+    const now = Date.now();
+    const bytes = 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 = 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`. */
+export function generateClientId() {
+    return `cli_${bytesToHex(randomBytes(8))}`;
+}
+//# sourceMappingURL=uuid.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/core/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,WAAW,CAAC,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,UAAU,CAAC,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,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC"}

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

package/dist/esm/decorators/index.js

@@ -0,0 +1,286 @@
+import { AnchorConfigError } from "../core/errors.js";
+import { ObjectId } from "../core/object-id.js";
+import { Schema } from "../schema/schema.js";
+import { SchemaTypes } from "../schema/types.js";
+/**
+ * Decorator-based schema authoring, identical in shape to `@nestjs/mongoose`.
+ *
+ * The point is a *shared class file*: the same decorated class is imported by the Ionic/Angular app
+ * and by the NestJS backend, so validation rules and index declarations exist once.
+ *
+ * Shipped from a separate entry point (`anchordb/decorators`) so the base SDK never requires
+ * `reflect-metadata` and stays usable from plain JS and React Native.
+ */
+const PROPS = Symbol.for("anchor:schema:props");
+const OPTIONS = Symbol.for("anchor:schema:options");
+const VIRTUALS = Symbol.for("anchor:schema:virtuals");
+const INDEXES = Symbol.for("anchor:schema:indexes");
+/** Reads design:type only when reflect-metadata is actually loaded. */
+function reflectType(target, propertyKey) {
+    const r = Reflect;
+    if (typeof r.getMetadata !== "function")
+        return undefined;
+    try {
+        return r.getMetadata("design:type", target, propertyKey);
+    }
+    catch {
+        return undefined;
+    }
+}
+function ownProps(ctor) {
+    if (!Object.prototype.hasOwnProperty.call(ctor, PROPS)) {
+        // Seed from the parent so a subclass inherits its parent's paths, as Mongoose expects.
+        const inherited = ctor[PROPS];
+        Object.defineProperty(ctor, PROPS, {
+            value: new Map(inherited ? [...inherited] : []),
+            enumerable: false,
+            configurable: true,
+            writable: true,
+        });
+    }
+    return ctor[PROPS];
+}
+/** `@Schema({ timestamps: true })` on the class. */
+export function Schema_(options = {}) {
+    return (target) => {
+        Object.defineProperty(target, OPTIONS, {
+            value: options,
+            enumerable: false,
+            configurable: true,
+            writable: true,
+        });
+    };
+}
+export { Schema_ as Schema };
+/**
+ * `@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 function Prop(arg) {
+    return (target, propertyKey) => {
+        if (typeof propertyKey === "symbol") {
+            throw new AnchorConfigError("@Prop() cannot be applied to a symbol-keyed property.");
+        }
+        const ctor = target.constructor;
+        const props = ownProps(ctor);
+        const record = { key: propertyKey };
+        if (arg !== undefined)
+            record.explicit = arg;
+        const reflected = reflectType(target, propertyKey);
+        if (reflected !== undefined)
+            record.reflected = reflected;
+        props.set(propertyKey, record);
+    };
+}
+/** `@Virtual()` — a computed path, matching @nestjs/mongoose v10. */
+export function Virtual(options) {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        if (!Object.prototype.hasOwnProperty.call(ctor, VIRTUALS)) {
+            Object.defineProperty(ctor, VIRTUALS, {
+                value: [...(ctor[VIRTUALS] ?? [])],
+                enumerable: false,
+                configurable: true,
+                writable: true,
+            });
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(target, propertyKey);
+        const def = { name: String(propertyKey) };
+        if (descriptor?.get)
+            def.getter = function () {
+                return descriptor.get.call(this);
+            };
+        if (descriptor?.set)
+            def.setter = function (value) {
+                descriptor.set.call(this, value);
+            };
+        if (options)
+            def.options = options;
+        ctor[VIRTUALS].push(def);
+    };
+}
+/** Class-level index declaration, mirroring `schema.index()`. */
+export function Index(fields, options = {}) {
+    return (target) => {
+        const ctor = target;
+        if (!Object.prototype.hasOwnProperty.call(ctor, INDEXES)) {
+            Object.defineProperty(ctor, INDEXES, {
+                value: [...(ctor[INDEXES] ?? [])],
+                enumerable: false,
+                configurable: true,
+                writable: true,
+            });
+        }
+        ctor[INDEXES].push({ fields, options });
+    };
+}
+/** Inline nested definition, matching @nestjs/mongoose's `raw()`. */
+export function raw(definition) {
+    return { __raw: definition };
+}
+/**
+ * Map a reflected `design:type` onto a schema type.
+ *
+ * Returns null where inference is genuinely impossible, so the caller can throw with the property
+ * name attached. The ambiguous cases are exactly the ones @nestjs/mongoose also refuses:
+ * `Array` (no element type), `Object` (interfaces, unions, optionals) and arbitrary classes.
+ */
+function inferFromReflected(reflected) {
+    if (reflected === String)
+        return String;
+    if (reflected === Number)
+        return Number;
+    if (reflected === Boolean)
+        return Boolean;
+    if (reflected === Date)
+        return Date;
+    if (reflected === ObjectId)
+        return SchemaTypes.ObjectId;
+    if (reflected === Uint8Array)
+        return SchemaTypes.Buffer;
+    if (reflected === Map)
+        return SchemaTypes.Map;
+    return null;
+}
+function buildDefinition(record, className) {
+    const explicit = record.explicit;
+    if (explicit !== undefined) {
+        // Arrays, constructors and raw() pass straight through; the Schema compiler understands them.
+        if (Array.isArray(explicit))
+            return explicit;
+        if (typeof explicit === "function")
+            return explicit;
+        const opts = explicit;
+        if (opts && typeof opts === "object") {
+            if ("type" in opts || "__raw" in opts)
+                return opts;
+            // Options given without a type: fall back to inference for the type only.
+            const inferred = record.reflected !== undefined ? inferFromReflected(record.reflected) : null;
+            if (inferred === null)
+                throw inferenceError(record, className);
+            return { ...opts, type: inferred };
+        }
+    }
+    const inferred = record.reflected !== undefined ? inferFromReflected(record.reflected) : null;
+    if (inferred === null)
+        throw inferenceError(record, className);
+    return { type: inferred };
+}
+function inferenceError(record, className) {
+    const reflectedName = typeof record.reflected === "function" ? record.reflected.name : String(record.reflected);
+    const reason = record.reflected === undefined
+        ? "no decorator metadata is available (emitDecoratorMetadata is off, or reflect-metadata was not imported)"
+        : reflectedName === "Array"
+            ? "an array's element type cannot be reflected"
+            : reflectedName === "Object"
+                ? "the reflected type is Object, which happens for interfaces, type aliases, unions and optional-with-null properties"
+                : `the reflected type "${reflectedName}" has no schema equivalent`;
+    return new AnchorConfigError(`Cannot determine the schema type for ${className}.${record.key}: ${reason}. ` +
+        `Pass the type explicitly, e.g. @Prop(String), @Prop({ type: String }), @Prop([String]), ` +
+        `or @Prop({ type: SchemaTypes.ObjectId, ref: "Other" }). ` +
+        `AnchorDB will not silently fall back to Mixed, because that would discard casting and ` +
+        `validation for this field and surface as corrupt data much later.`);
+}
+export class SchemaFactory {
+    /** Build an AnchorDB `Schema` from a decorated class. */
+    static createForClass(target) {
+        const { definition, options, indexes } = SchemaFactory.toDefinition(target);
+        const schema = new Schema(definition, options);
+        const ctor = target;
+        for (const virtual of ctor[VIRTUALS] ?? []) {
+            const handle = schema.virtual(virtual.name, virtual.options);
+            if (virtual.getter)
+                handle.get(virtual.getter);
+            if (virtual.setter)
+                handle.set(virtual.setter);
+        }
+        for (const idx of indexes) {
+            schema.index(idx.fields, idx.options);
+        }
+        // Instance methods declared on the class become schema methods, as in @nestjs/mongoose.
+        for (const name of Object.getOwnPropertyNames(target.prototype)) {
+            if (name === "constructor")
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(target.prototype, name);
+            if (descriptor && typeof descriptor.value === "function") {
+                schema.methods[name] = descriptor.value;
+            }
+        }
+        return schema;
+    }
+    /** The raw definition, shared by `createForClass` and the Mongoose emitter. */
+    static toDefinition(target) {
+        const ctor = target;
+        const props = ctor[PROPS];
+        if (!props || props.size === 0) {
+            throw new AnchorConfigError(`Class "${target.name}" has no @Prop() properties. ` +
+                `Did you forget the decorators, or is "emitDecoratorMetadata" disabled without explicit types?`);
+        }
+        const definition = {};
+        for (const record of props.values()) {
+            definition[record.key] = buildDefinition(record, target.name);
+        }
+        return {
+            definition,
+            options: ctor[OPTIONS] ?? {},
+            indexes: ctor[INDEXES] ?? [],
+        };
+    }
+    /**
+     * 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, mongooseModule) {
+        const { definition, options, indexes } = SchemaFactory.toDefinition(target);
+        const mongooseDefinition = toMongooseDefinition(definition);
+        if (!mongooseModule)
+            return { definition: mongooseDefinition, options, indexes };
+        const schema = new mongooseModule.Schema(mongooseDefinition, options);
+        for (const idx of indexes)
+            schema.index(idx.fields, idx.options);
+        return schema;
+    }
+}
+/**
+ * Translate the definition into the form mongoose expects.
+ *
+ * Only two things actually differ: AnchorDB's `ObjectId` class must become
+ * `mongoose.Schema.Types.ObjectId` (handled by callers passing the module, or by leaving the token
+ * for mongoose to resolve), and `__raw` is unwrapped back into a plain nested object.
+ */
+function toMongooseDefinition(definition) {
+    const out = {};
+    for (const [key, value] of Object.entries(definition)) {
+        out[key] = translate(value);
+    }
+    return out;
+}
+function translate(value) {
+    if (Array.isArray(value))
+        return value.map(translate);
+    if (value === SchemaTypes.ObjectId || value === ObjectId)
+        return "ObjectId";
+    if (value === SchemaTypes.Mixed)
+        return "Mixed";
+    if (value === SchemaTypes.Buffer)
+        return "Buffer";
+    if (value && typeof value === "object") {
+        const obj = value;
+        if (obj.__raw)
+            return toMongooseDefinition(obj.__raw);
+        const out = {};
+        for (const [k, v] of Object.entries(obj))
+            out[k] = k === "type" ? translate(v) : v;
+        return out;
+    }
+    return value;
+}
+export { SchemaTypes };
+//# sourceMappingURL=index.js.map

package/dist/esm/decorators/index.js.map

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

package/dist/esm/events/emitter.d.ts

@@ -0,0 +1,16 @@
+/** Minimal typed event emitter — no Node `events` dependency, so it runs unchanged in RN and browsers. */
+export type Listener<T> = (payload: T) => void;
+export declare class TypedEmitter<Events extends Record<string, unknown>> {
+    private listeners;
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): () => void;
+    once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): () => void;
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): void;
+    /**
+     * A throwing listener must never break the emitter — a UI callback crashing would otherwise abort
+     * a sync pass midway and leave the queue in an odd state. Errors are reported and swallowed.
+     */
+    emit<K extends keyof Events>(event: K, payload: Events[K]): void;
+    removeAllListeners(event?: keyof Events): void;
+    listenerCount(event: keyof Events): number;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/esm/events/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../src/events/emitter.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/C,qBAAa,YAAY,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,OAAO,CAAC,SAAS,CAAiD;IAElE,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAU/E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAQjF,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1E;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAahE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI;IAK9C,aAAa,CAAC,KAAK,EAAE,MAAM,MAAM,GAAG,MAAM;CAG3C"}

package/dist/esm/events/emitter.js

@@ -0,0 +1,52 @@
+export class TypedEmitter {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    once(event, listener) {
+        const off = this.on(event, ((payload) => {
+            off();
+            listener(payload);
+        }));
+        return off;
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+    }
+    /**
+     * A throwing listener must never break the emitter — a UI callback crashing would otherwise abort
+     * a sync pass midway and leave the queue in an odd state. Errors are reported and swallowed.
+     */
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set || set.size === 0)
+            return;
+        for (const listener of [...set]) {
+            try {
+                listener(payload);
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.error(`[anchor] listener for "${String(event)}" threw:`, err);
+            }
+        }
+    }
+    removeAllListeners(event) {
+        if (event === undefined)
+            this.listeners.clear();
+        else
+            this.listeners.delete(event);
+    }
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/esm/events/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/events/emitter.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;IAiDpE,CAAC;IA/CC,EAAE,CAAyB,KAAQ,EAAE,QAA6B;QAChE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA2B,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,QAA6B;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,OAAkB,EAAE,EAAE;YACjD,GAAG,EAAE,CAAC;YACN,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC,CAAwB,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAA6B;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAA2B,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,IAAI,CAAyB,KAAQ,EAAE,OAAkB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACF,QAAgC,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,KAAoB;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;;YAC3C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,aAAa,CAAC,KAAmB;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}

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

@@ -0,0 +1,79 @@
+import type { IndexSpec, StoredDoc } from "../storage/types.js";
+/**
+ * Index key extraction — shared by every storage adapter so unique semantics cannot drift between
+ * SQLite, IndexedDB and memory.
+ *
+ * ## The MongoDB / SQL divergence this module exists to close
+ *
+ * SQL treats NULL as *not equal to itself*, so a `UNIQUE` index happily accepts any number of rows
+ * whose indexed column is NULL. I verified this on node:sqlite: inserting two documents that both
+ * omitted the indexed field succeeded.
+ *
+ * MongoDB does the opposite. A missing field is indexed **as null**, and null equals null, so the
+ * second such document is rejected with E11000.
+ *
+ * Left alone this diverges silently: the app accepts data on device, sync pushes it, and the real
+ * database rejects it much later with no obvious cause. So missing values are mapped to an explicit
+ * sentinel that collides with itself, reproducing Mongo's behaviour. `sparse` and partial indexes
+ * are then the documented way to opt back out — exactly as in Mongo.
+ */
+/**
+ * Sentinel for "no value", covering BOTH a missing field and an explicit null.
+ *
+ * They share one encoding on purpose: MongoDB indexes a missing field *as null*, so `{}` and
+ * `{ email: null }` produce the same index entry and collide under a unique index. Separate
+ * sentinels would let one of each coexist on device and then be rejected by the real database on
+ * first sync — a divergence that only surfaces long after the data was written.
+ *
+ * `sparse` still distinguishes them: it skips documents *missing* the field while still indexing
+ * an explicit null. That check lives in extractIndexKeys, not here.
+ */
+export declare const NULL_SENTINEL = " __anchor_null__";
+/**
+ * Separator between components of a compound index key.
+ *
+ * Named rather than written inline as a raw control character: an invisible literal is impossible
+ * to review and trivially diverges between the writer and the reader of a key. Without a separator
+ * at all, ["ab","c"] and ["a","bc"] would encode identically and collide under a unique index.
+ */
+export declare const KEY_SEPARATOR: string;
+/** One extracted key: the encoded string plus the raw values, for error reporting. */
+export interface IndexKey {
+    encoded: string;
+    values: Record<string, unknown>;
+}
+/**
+ * Encode a single value into a component of an index key.
+ *
+ * Type is included in the encoding so that `1` (number) and `"1"` (string) do not collide — Mongo
+ * treats them as different index entries because they are different BSON types.
+ */
+export declare function encodeComponent(value: unknown): string;
+/** Does the document qualify for a partial index? */
+export declare function matchesPartialFilter(doc: StoredDoc, filter: Record<string, unknown> | undefined): boolean;
+/**
+ * Extract every index key a document contributes.
+ *
+ * Returns more than one key only for multikey indexes, where an array field contributes one entry
+ * per element — which is what makes a unique multikey index mean "no two documents share any
+ * element".
+ *
+ * Returns an empty array when the document should not be indexed at all (sparse with the field
+ * absent, or a partial filter that does not match), which is precisely how those options let
+ * multiple documents escape a unique constraint.
+ */
+export declare function extractIndexKeys(doc: StoredDoc, spec: IndexSpec): IndexKey[];
+/** True when any indexed path currently holds an array, so the adapter can pick its strategy. */
+export declare function isMultikeyFor(doc: StoredDoc, spec: IndexSpec): boolean;
+export declare function indexKeyPattern(spec: IndexSpec): Record<string, 1 | -1>;
+/** Mongo's default index name: field_direction joined by underscores, e.g. `email_1`. */
+export declare function defaultIndexName(key: Array<[string, 1 | -1]>): string;
+/**
+ * Encode a lookup key for an index whose every field has an equality constraint.
+ *
+ * Returns null when the constraints do not cover the full key. A partial key cannot be turned into
+ * an exact lookup against the entries table, and guessing with a prefix match could silently drop
+ * rows — so we decline and let the caller fall back to a scan.
+ */
+export declare function encodeLookupKey(spec: IndexSpec, equalities: Map<string, unknown>): string | null;
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/index/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAMD,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAwCzG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,EAAE,CAqC5E;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAEtE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAIvE;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAOhG"}