anchordb 0.2.0

package/dist/cjs/query/update.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MongoDB update operators.
+ *
+ * Like the filter operators these live in a registry, so the set can grow without editing a switch.
+ * Each operator mutates a *clone*, so a failed update never leaves a half-applied document behind.
+ */
+export type UpdateSpec = Record<string, unknown>;
+export interface UpdateOperatorContext {
+    doc: Record<string, unknown>;
+    path: string;
+    operand: unknown;
+}
+export type UpdateOperatorFn = (ctx: UpdateOperatorContext) => void;
+export declare function registerUpdateOperator(name: string, fn: UpdateOperatorFn): void;
+export declare function listUpdateOperators(): string[];
+export interface ApplyUpdateOptions {
+    /** True when this update is creating the document via upsert. */
+    isInsert?: boolean;
+}
+/**
+ * Apply an update document, returning a new document. The input is never mutated, so a throwing
+ * operator leaves the caller's copy intact.
+ *
+ * A replacement document (no `$` keys) is also accepted, matching Mongoose.
+ */
+export declare function applyUpdate(original: Record<string, unknown>, update: UpdateSpec, opts?: ApplyUpdateOptions): Record<string, unknown>;
+/** Paths an update touches — used to decide which validators to run and what changed. */
+export declare function updatedPaths(update: UpdateSpec): string[];
+export declare function isReplacement(update: UpdateSpec): boolean;
+//# sourceMappingURL=update.d.ts.map

package/dist/cjs/query/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/query/update.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAIpE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAE/E;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AA4ID,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,UAAU,EAClB,IAAI,GAAE,kBAAuB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCzB;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CASzD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD"}

package/dist/cjs/query/update.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUpdateOperator = registerUpdateOperator;
+exports.listUpdateOperators = listUpdateOperators;
+exports.applyUpdate = applyUpdate;
+exports.updatedPaths = updatedPaths;
+exports.isReplacement = isReplacement;
+const errors_ts_1 = require("../core/errors.js");
+const path_ts_1 = require("./path.js");
+const filter_ts_1 = require("./filter.js");
+const updateOperators = new Map();
+function registerUpdateOperator(name, fn) {
+    updateOperators.set(name, fn);
+}
+function listUpdateOperators() {
+    return [...updateOperators.keys()].sort();
+}
+registerUpdateOperator("$set", ({ doc, path, operand }) => (0, path_ts_1.setPath)(doc, path, operand));
+registerUpdateOperator("$unset", ({ doc, path }) => (0, path_ts_1.unsetPath)(doc, path));
+registerUpdateOperator("$inc", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (current !== undefined && typeof current !== "number") {
+        throw new errors_ts_1.AnchorError(`Cannot apply $inc to a value of non-numeric type at path "${path}".`);
+    }
+    (0, path_ts_1.setPath)(doc, path, (typeof current === "number" ? current : 0) + Number(operand));
+});
+registerUpdateOperator("$mul", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (current !== undefined && typeof current !== "number") {
+        throw new errors_ts_1.AnchorError(`Cannot apply $mul to a value of non-numeric type at path "${path}".`);
+    }
+    (0, path_ts_1.setPath)(doc, path, (typeof current === "number" ? current : 0) * Number(operand));
+});
+registerUpdateOperator("$min", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (current === undefined || (0, path_ts_1.compareValues)(operand, current) < 0)
+        (0, path_ts_1.setPath)(doc, path, operand);
+});
+registerUpdateOperator("$max", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (current === undefined || (0, path_ts_1.compareValues)(operand, current) > 0)
+        (0, path_ts_1.setPath)(doc, path, operand);
+});
+registerUpdateOperator("$rename", ({ doc, path, operand }) => {
+    const value = (0, path_ts_1.getPath)(doc, path);
+    if (value === undefined)
+        return;
+    (0, path_ts_1.unsetPath)(doc, path);
+    (0, path_ts_1.setPath)(doc, String(operand), value);
+});
+registerUpdateOperator("$currentDate", ({ doc, path, operand }) => {
+    const asTimestamp = typeof operand === "object" && operand !== null && operand.$type === "timestamp";
+    (0, path_ts_1.setPath)(doc, path, asTimestamp ? Date.now() : new Date().toISOString());
+});
+registerUpdateOperator("$push", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    const array = Array.isArray(current) ? [...current] : [];
+    if (operand !== null && typeof operand === "object" && "$each" in operand) {
+        const spec = operand;
+        const items = spec.$each;
+        if (typeof spec.$position === "number")
+            array.splice(spec.$position, 0, ...items);
+        else
+            array.push(...items);
+        if (spec.$sort !== undefined) {
+            const sort = spec.$sort;
+            if (typeof sort === "number") {
+                array.sort((a, b) => (sort === 1 ? (0, path_ts_1.compareValues)(a, b) : (0, path_ts_1.compareValues)(b, a)));
+            }
+            else if (sort && typeof sort === "object") {
+                const entries = Object.entries(sort);
+                array.sort((a, b) => {
+                    for (const [key, dir] of entries) {
+                        const c = (0, path_ts_1.compareValues)((0, path_ts_1.getPath)(a, key), (0, path_ts_1.getPath)(b, key));
+                        if (c !== 0)
+                            return dir === 1 ? c : -c;
+                    }
+                    return 0;
+                });
+            }
+        }
+        if (typeof spec.$slice === "number") {
+            (0, path_ts_1.setPath)(doc, path, spec.$slice >= 0 ? array.slice(0, spec.$slice) : array.slice(spec.$slice));
+            return;
+        }
+        (0, path_ts_1.setPath)(doc, path, array);
+        return;
+    }
+    array.push(operand);
+    (0, path_ts_1.setPath)(doc, path, array);
+});
+registerUpdateOperator("$addToSet", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    const array = Array.isArray(current) ? [...current] : [];
+    const items = operand !== null && typeof operand === "object" && "$each" in operand
+        ? operand.$each
+        : [operand];
+    for (const item of items) {
+        if (!array.some((el) => (0, path_ts_1.valuesEqual)(el, item)))
+            array.push(item);
+    }
+    (0, path_ts_1.setPath)(doc, path, array);
+});
+registerUpdateOperator("$pull", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (!Array.isArray(current))
+        return;
+    const isCondition = operand !== null &&
+        typeof operand === "object" &&
+        !Array.isArray(operand) &&
+        !(operand instanceof Date);
+    const kept = current.filter((el) => {
+        if (!isCondition)
+            return !(0, path_ts_1.valuesEqual)(el, operand);
+        const condition = operand;
+        const operatorForm = Object.keys(condition).every((k) => k.startsWith("$"));
+        if (operatorForm) {
+            // `{ $pull: { scores: { $gt: 5 } } }` — the condition applies to each element directly.
+            return !(0, filter_ts_1.matchesFilter)({ __v: el }, { __v: condition });
+        }
+        return !(0, filter_ts_1.matchesFilter)(el, condition);
+    });
+    (0, path_ts_1.setPath)(doc, path, kept);
+});
+registerUpdateOperator("$pullAll", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (!Array.isArray(current))
+        return;
+    const remove = operand;
+    (0, path_ts_1.setPath)(doc, path, current.filter((el) => !remove.some((r) => (0, path_ts_1.valuesEqual)(el, r))));
+});
+registerUpdateOperator("$pop", ({ doc, path, operand }) => {
+    const current = (0, path_ts_1.getPath)(doc, path);
+    if (!Array.isArray(current) || current.length === 0)
+        return;
+    const copy = [...current];
+    if (Number(operand) === -1)
+        copy.shift();
+    else
+        copy.pop();
+    (0, path_ts_1.setPath)(doc, path, copy);
+});
+/** `$setOnInsert` only applies on upsert-insert; applyUpdate is told which case it is. */
+registerUpdateOperator("$setOnInsert", () => {
+    /* handled in applyUpdate */
+});
+/**
+ * Apply an update document, returning a new document. The input is never mutated, so a throwing
+ * operator leaves the caller's copy intact.
+ *
+ * A replacement document (no `$` keys) is also accepted, matching Mongoose.
+ */
+function applyUpdate(original, update, opts = {}) {
+    const keys = Object.keys(update);
+    const hasOperators = keys.some((k) => k.startsWith("$"));
+    if (!hasOperators) {
+        // Whole-document replacement, but `_id` is immutable and always survives.
+        const replacement = (0, path_ts_1.deepClone)(update);
+        if (original._id !== undefined)
+            replacement._id = original._id;
+        return replacement;
+    }
+    const doc = (0, path_ts_1.deepClone)(original);
+    for (const [op, payload] of Object.entries(update)) {
+        if (!op.startsWith("$")) {
+            throw new errors_ts_1.AnchorError(`Update documents may not mix operators with plain fields — found "${op}" alongside operators.`);
+        }
+        if (op === "$setOnInsert") {
+            if (!opts.isInsert)
+                continue;
+            for (const [path, operand] of Object.entries(payload)) {
+                if ((0, path_ts_1.getPath)(doc, path) === undefined)
+                    (0, path_ts_1.setPath)(doc, path, operand);
+            }
+            continue;
+        }
+        const fn = updateOperators.get(op);
+        if (!fn) {
+            throw new errors_ts_1.AnchorError(`Unknown update operator "${op}". Supported: ${listUpdateOperators().join(", ")}. ` +
+                `Register your own with registerUpdateOperator().`);
+        }
+        for (const [path, operand] of Object.entries(payload)) {
+            fn({ doc, path, operand });
+        }
+    }
+    return doc;
+}
+/** Paths an update touches — used to decide which validators to run and what changed. */
+function updatedPaths(update) {
+    const keys = Object.keys(update);
+    if (!keys.some((k) => k.startsWith("$")))
+        return keys;
+    const out = new Set();
+    for (const [op, payload] of Object.entries(update)) {
+        if (!op.startsWith("$") || payload === null || typeof payload !== "object")
+            continue;
+        for (const path of Object.keys(payload))
+            out.add(path);
+    }
+    return [...out];
+}
+function isReplacement(update) {
+    return !Object.keys(update).some((k) => k.startsWith("$"));
+}
+//# sourceMappingURL=update.js.map

package/dist/cjs/query/update.js.map

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

package/dist/cjs/reactive/live-query.d.ts

@@ -0,0 +1,41 @@
+import type { AnchorDB } from "../core/anchor-db.js";
+import type { Query } from "../query/builder/query.js";
+/**
+ * The single live-query primitive.
+ *
+ * RxJS observables in `anchordb-angular`, hooks in `anchordb-react`, and the inspector's push events
+ * are all built on this one function. One mechanism means one set of semantics: if a change is
+ * visible to a React hook it is visible to an Angular observable, and neither can drift.
+ *
+ * Re-running the query on change is deliberate rather than patching the cached result in place.
+ * Incremental maintenance would have to reimplement the filter, sort, skip, limit and populate
+ * logic a second time — and any disagreement between the two implementations shows up as a UI that
+ * quietly displays the wrong rows.
+ */
+export interface LiveQueryOptions {
+    /** Collapse bursts of writes into one re-run. */
+    debounceMs?: number;
+    /** Emit the current value immediately on subscribe. */
+    emitInitial?: boolean;
+}
+export interface LiveSubscription {
+    unsubscribe(): void;
+}
+export type LiveObserver<T> = {
+    next: (value: T) => void;
+    error?: (err: unknown) => void;
+};
+/**
+ * Re-run `execute` whenever `collection` changes.
+ *
+ * `collection` may be null to watch every collection, which is what a stats or dashboard view wants.
+ */
+export declare function observeQuery<T>(db: AnchorDB, collection: string | null, execute: () => PromiseLike<T>, observer: LiveObserver<T>, options?: LiveQueryOptions): LiveSubscription;
+/** Live-observe a built query. The chain is re-executed, so sort/skip/limit stay correct. */
+export declare function observe<TResult, TDoc>(db: AnchorDB, collection: string, query: Query<TResult, TDoc>, observer: LiveObserver<TResult>, options?: LiveQueryOptions): LiveSubscription;
+/** Live sync status, for dashboards. Also fires in local-only mode, where it stays "disabled". */
+export declare function observeSyncStatus(db: AnchorDB, observer: LiveObserver<{
+    status: string;
+    pending: number;
+}>): LiveSubscription;
+//# sourceMappingURL=live-query.d.ts.map

package/dist/cjs/reactive/live-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-query.d.ts","sourceRoot":"","sources":["../../../src/reactive/live-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,IAAI,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,QAAQ,EACZ,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,OAAO,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,EAC7B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CA4ClB;AAED,6FAA6F;AAC7F,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,EACnC,EAAE,EAAE,QAAQ,EACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,EAC3B,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,EAC/B,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAElB;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,YAAY,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,gBAAgB,CAyBlB"}

package/dist/cjs/reactive/live-query.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.observeQuery = observeQuery;
+exports.observe = observe;
+exports.observeSyncStatus = observeSyncStatus;
+/**
+ * Re-run `execute` whenever `collection` changes.
+ *
+ * `collection` may be null to watch every collection, which is what a stats or dashboard view wants.
+ */
+function observeQuery(db, collection, execute, observer, options = {}) {
+    const debounceMs = options.debounceMs ?? 0;
+    let timer = null;
+    let closed = false;
+    /** Guards against overlapping runs delivering results out of order. */
+    let generation = 0;
+    const run = async () => {
+        const mine = ++generation;
+        try {
+            const value = await execute();
+            // A slower earlier run must never overwrite a newer result.
+            if (!closed && mine === generation)
+                observer.next(value);
+        }
+        catch (err) {
+            if (!closed)
+                observer.error?.(err);
+        }
+    };
+    const schedule = () => {
+        if (closed)
+            return;
+        if (debounceMs <= 0) {
+            void run();
+            return;
+        }
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            void run();
+        }, debounceMs);
+    };
+    const offChange = db.on("change", (event) => {
+        if (collection === null || event.collection === collection)
+            schedule();
+    });
+    if (options.emitInitial !== false)
+        void run();
+    return {
+        unsubscribe() {
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            offChange();
+        },
+    };
+}
+/** Live-observe a built query. The chain is re-executed, so sort/skip/limit stay correct. */
+function observe(db, collection, query, observer, options = {}) {
+    return observeQuery(db, collection, () => query.exec(), observer, options);
+}
+/** Live sync status, for dashboards. Also fires in local-only mode, where it stays "disabled". */
+function observeSyncStatus(db, observer) {
+    let closed = false;
+    const emit = async () => {
+        if (closed)
+            return;
+        observer.next({ status: db.sync.status(), pending: await db.sync.pending() });
+    };
+    const offs = [
+        db.on("sync:start", () => void emit()),
+        db.on("sync:complete", () => void emit()),
+        db.on("sync:error", () => void emit()),
+        db.on("queue:changed", () => void emit()),
+        db.on("online", () => void emit()),
+        db.on("offline", () => void emit()),
+    ];
+    void emit();
+    return {
+        unsubscribe() {
+            closed = true;
+            for (const off of offs)
+                off();
+        },
+    };
+}
+//# sourceMappingURL=live-query.js.map

package/dist/cjs/reactive/live-query.js.map

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

package/dist/cjs/schema/cast.d.ts

@@ -0,0 +1,38 @@
+import type { Schema } from "./schema.js";
+import type { SchemaPath } from "./types.js";
+/**
+ * Value casting, matching Mongoose's coercion rules.
+ *
+ * Casting is where a lot of quiet incompatibility hides: if AnchorDB stored `"28"` where Mongoose
+ * would store `28`, the same document would compare and sort differently on device than on the
+ * server. So the rules below mirror Mongoose's, including which inputs it *refuses* to coerce.
+ */
+export declare function castValue(value: unknown, def: SchemaPath, path: string): unknown;
+export interface CastDocumentResult {
+    doc: Record<string, unknown>;
+    /** Paths present in the input but absent from the schema. */
+    unknownPaths: string[];
+}
+/**
+ * Cast a whole document against a schema, applying defaults and strict-mode handling.
+ *
+ * `applyDefaults` is off for update payloads: a `$set` must not resurrect defaults for fields the
+ * caller never mentioned.
+ */
+export declare function castDocument(input: Record<string, unknown>, schema: Schema, opts?: {
+    applyDefaults?: boolean;
+    prefix?: string;
+}): CastDocumentResult;
+/**
+ * Cast a query filter's values through the schema.
+ *
+ * This is what makes `User.findById("507f1f77bcf86cd799439011")` work: the string is cast to an
+ * ObjectId so it compares equal to the document's `_id`. Mongoose does exactly this, and without it
+ * every id lookup written the natural way would silently return null — the filter would hold a
+ * string while the document holds an ObjectId, and the two never compare equal.
+ *
+ * Only declared paths are cast. Unknown paths pass through untouched, so a filter on a field the
+ * schema does not describe still behaves like a plain value comparison.
+ */
+export declare function castFilter(filter: Record<string, unknown>, schema: Schema): Record<string, unknown>;
+//# sourceMappingURL=cast.d.ts.map

package/dist/cjs/schema/cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast.d.ts","sourceRoot":"","sources":["../../../src/schema/cast.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;GAMG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA2BhF;AA+GD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,kBAAkB,CA4BpB;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwDnG"}