anchordb 0.2.0

package/dist/esm/index/keys.js

@@ -0,0 +1,198 @@
+import { getPath, hasPath, compareValues } from "../query/path.js";
+import { ObjectId } from "../core/object-id.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 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 const KEY_SEPARATOR = String.fromCharCode(1);
+/**
+ * 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 function encodeComponent(value) {
+    if (value === undefined || value === null)
+        return NULL_SENTINEL;
+    if (typeof value === "string")
+        return `s:${value}`;
+    if (typeof value === "number")
+        return `n:${value}`;
+    if (typeof value === "boolean")
+        return `b:${value}`;
+    if (value instanceof Date)
+        return `d:${value.getTime()}`;
+    if (value instanceof ObjectId)
+        return `o:${value.toHexString()}`;
+    if (value instanceof Uint8Array)
+        return `x:${Array.from(value).join(",")}`;
+    if (Array.isArray(value))
+        return `a:${JSON.stringify(value)}`;
+    return `j:${JSON.stringify(value)}`;
+}
+function isMissing(doc, path) {
+    return !hasPath(doc, path) || getPath(doc, path) === undefined;
+}
+/** Does the document qualify for a partial index? */
+export function matchesPartialFilter(doc, filter) {
+    if (!filter)
+        return true;
+    for (const [path, condition] of Object.entries(filter)) {
+        const value = getPath(doc, path);
+        if (condition !== null && typeof condition === "object" && !Array.isArray(condition) && !(condition instanceof Date)) {
+            for (const [op, operand] of Object.entries(condition)) {
+                switch (op) {
+                    case "$eq":
+                        if (compareValues(value, operand) !== 0)
+                            return false;
+                        break;
+                    case "$ne":
+                        if (compareValues(value, operand) === 0)
+                            return false;
+                        break;
+                    case "$gt":
+                        if (!(compareValues(value, operand) > 0))
+                            return false;
+                        break;
+                    case "$gte":
+                        if (!(compareValues(value, operand) >= 0))
+                            return false;
+                        break;
+                    case "$lt":
+                        if (!(compareValues(value, operand) < 0))
+                            return false;
+                        break;
+                    case "$lte":
+                        if (!(compareValues(value, operand) <= 0))
+                            return false;
+                        break;
+                    case "$exists":
+                        if (hasPath(doc, path) !== Boolean(operand))
+                            return false;
+                        break;
+                    case "$in":
+                        if (!operand.some((o) => compareValues(value, o) === 0))
+                            return false;
+                        break;
+                    default:
+                        return false;
+                }
+            }
+        }
+        else if (compareValues(value, condition) !== 0) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 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 function extractIndexKeys(doc, spec) {
+    if (!matchesPartialFilter(doc, spec.partialFilterExpression))
+        return [];
+    const paths = spec.key.map(([path]) => path);
+    // Sparse skips documents missing *every* indexed field, matching Mongo's compound-sparse rule.
+    if (spec.sparse && paths.every((p) => isMissing(doc, p)))
+        return [];
+    // Cartesian product across paths, expanding arrays into separate entries (multikey).
+    let combos = [[]];
+    for (const path of paths) {
+        const raw = getPath(doc, path);
+        const values = Array.isArray(raw) ? (raw.length === 0 ? [undefined] : raw) : [raw];
+        const next = [];
+        for (const combo of combos) {
+            for (const value of values) {
+                next.push([...combo, { path, value }]);
+            }
+        }
+        combos = next;
+    }
+    // De-duplicate: a document with ["a","a"] must contribute one entry, not two, or it would
+    // collide with itself and be rejected by its own unique index.
+    const seen = new Set();
+    const out = [];
+    for (const combo of combos) {
+        const encoded = combo.map((c) => encodeComponent(c.value)).join(KEY_SEPARATOR);
+        if (seen.has(encoded))
+            continue;
+        seen.add(encoded);
+        const values = {};
+        for (const c of combo)
+            values[c.path] = c.value === undefined ? null : c.value;
+        out.push({ encoded, values });
+    }
+    return out;
+}
+/** True when any indexed path currently holds an array, so the adapter can pick its strategy. */
+export function isMultikeyFor(doc, spec) {
+    return spec.key.some(([path]) => Array.isArray(getPath(doc, path)));
+}
+export function indexKeyPattern(spec) {
+    const out = {};
+    for (const [path, dir] of spec.key)
+        out[path] = dir;
+    return out;
+}
+/** Mongo's default index name: field_direction joined by underscores, e.g. `email_1`. */
+export function defaultIndexName(key) {
+    return key.map(([path, dir]) => `${path}_${dir}`).join("_");
+}
+/**
+ * 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 function encodeLookupKey(spec, equalities) {
+    const parts = [];
+    for (const [path] of spec.key) {
+        if (!equalities.has(path))
+            return null;
+        parts.push(encodeComponent(equalities.get(path)));
+    }
+    return parts.join(KEY_SEPARATOR);
+}
+//# sourceMappingURL=keys.js.map

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

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

package/dist/esm/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * anchordb — MongoDB + Mongoose, for mobile apps.
+ *
+ * Local-first by default. Sync is opt-in: construct without a `sync` block and you get a purely
+ * local database with no queue, no network code and no sync metadata.
+ */
+export { AnchorDB, LocalDB } from "./core/anchor-db.js";
+export type { AnchorDBConfig, InspectorConfig, SyncConfig, SyncStatus, } from "./core/anchor-db.js";
+export { Schema } from "./schema/schema.js";
+export { SchemaTypes } from "./schema/types.js";
+export type { SchemaOptions, SchemaTypeOptions, ValidatorFn, ValidatorSpec, } from "./schema/types.js";
+export { castDocument, castValue } from "./schema/cast.js";
+export { validateDocument } from "./schema/validate.js";
+export { Model } from "./model/model.js";
+export type { DeleteResult, UpdateOptions, UpdateResult } from "./model/model.js";
+export { Query } from "./query/builder/query.js";
+export type { ExplainResult, PopulateSpec } from "./query/builder/query.js";
+export { ObjectId } from "./core/object-id.js";
+export { uuidv7, generateClientId } from "./core/uuid.js";
+export { HybridLogicalClock, compareHlc, compareHlcStamps, decodeHlc, encodeHlc } from "./core/hlc.js";
+export type { Hlc } from "./core/hlc.js";
+export { AnchorError, AnchorConfigError, BulkWriteError, CastError, DocumentNotFoundError, DUPLICATE_KEY_CODE, MongoServerError, StrictModeError, ValidationError, ValidatorError, duplicateKeyError, } from "./core/errors.js";
+export { TimeService } from "./timestamps/index.js";
+export { assertValidTimeZone, detectDeviceTimeZone, formatInTimeZone, isValidTimeZone, parseZonedTimeToUtc, toUtcIso, zonedTimeToUtc, } from "./timestamps/timezone.js";
+export { TypedEmitter } from "./events/emitter.js";
+export type { AnchorEvents, AnchorRuntime } from "./core/runtime.js";
+export { MemoryAdapter } from "./storage/adapters/memory.js";
+export type { AdapterStats, DatabaseAdapter, IndexSpec, StoragePlan, StorageResult, StoredDoc, StoredMeta, StoredRow, WriteOp, } from "./storage/types.js";
+export { matchesFilter, extractConstraints, registerQueryOperator, listQueryOperators, } from "./query/filter.js";
+export type { Filter } from "./query/filter.js";
+export { applyUpdate, registerUpdateOperator, listUpdateOperators, updatedPaths, } from "./query/update.js";
+export type { UpdateSpec } from "./query/update.js";
+export { compareValues, deepClone, flattenPaths, getPath, hasPath, setPath, unsetPath, valuesEqual, } from "./query/path.js";
+export { extractIndexKeys, defaultIndexName, NULL_SENTINEL } from "./index/keys.js";
+export type { ConflictContext, ConflictResolutionConfig, ConflictResolver, ConflictStrategyName, FieldPolicy, Resolution, } from "./conflict/types.js";
+export { attachSync } from "./sync/attach.js";
+export type { AttachSyncOptions, AttachedSync } from "./sync/attach.js";
+export { MutationQueue, QUEUE_COLLECTION } from "./sync/queue.js";
+export { SyncEngine, SHADOW_COLLECTION } from "./sync/engine.js";
+export type { SyncEngineOptions, SyncRunResult, SyncStatusValue } from "./sync/engine.js";
+export { RestSyncAdapter } from "./sync/adapters/rest.js";
+export type { RestSyncAdapterOptions } from "./sync/adapters/rest.js";
+export { MemorySyncServer } from "./sync/server/memory-server.js";
+export type { ServerDocument, MemorySyncServerOptions } from "./sync/server/memory-server.js";
+export { PROTOCOL_VERSION, SyncAuthError, SyncTransportError, } from "./sync/protocol.js";
+export type { ChangeResult, ChangeStatus, Mutation, MutationOperation, PullRequest, PullResponse, PushRequest, PushResponse, QueuedMutation, RemoteChange, SyncAdapter, } from "./sync/protocol.js";
+export { ClientWinsStrategy, ConflictStrategyRegistry, CustomStrategy, FieldLevelStrategy, LastWriteWinsStrategy, ServerWinsStrategy, } from "./conflict/strategies.js";
+export type { ConflictStrategyHandler } from "./conflict/strategies.js";
+export { toEJSON, fromEJSON, stringifyEJSON, parseEJSON } from "./interop/ejson.js";
+export type { EJsonMode, EJsonOptions } from "./interop/ejson.js";
+export { detectImportFormat, exportCollection, exportDatabase, importCollection, importDatabase, mongoimportCommand, } from "./interop/export-import.js";
+export { csvHeaders, fromCsv, inferCsvValue, looksLikeCsv, parseCsvRows, toCsv } from "./interop/csv.js";
+export type { CollectionExport, DatabaseExport, ExportFormat, ExportOptions, ImportOptions, ImportResult, } from "./interop/export-import.js";
+export { runPipeline, validatePipeline, planPushdown } from "./query/aggregation/pipeline.js";
+export type { AggregateExplain, AggregateOptions, AggregationSource, PipelineStage, Pushdown, } from "./query/aggregation/pipeline.js";
+export { evaluate as evaluateExpression, registerExpressionOperator, listExpressionOperators, isPortableOperator, MISSING, } from "./query/aggregation/expressions.js";
+export { StorageAggregationSource } from "./query/aggregation/source.js";
+export type { BulkWriteOperation } from "./model/model.js";
+export { AnchorDocument, createModelConstructor } from "./model/document.js";
+export type { ModelConstructor, ToObjectOptions } from "./model/document.js";
+export { castFilter } from "./schema/cast.js";
+export { InspectorAgent, InspectorRequestError } from "./inspector/agent.js";
+export type { InspectorAgentOptions } from "./inspector/agent.js";
+export { InspectorClient, InspectorClientError } from "./inspector/client.js";
+export type { InspectorClientOptions } from "./inspector/client.js";
+export { InspectorAuth, hmacSha256, timingSafeEqual } from "./inspector/auth.js";
+export type { InspectorAuthOptions, PairingInfo, Session } from "./inspector/auth.js";
+export { createInProcessTransportPair } from "./inspector/transports/in-process.js";
+export { WebSocketTransport } from "./inspector/transports/websocket.js";
+export type { WebSocketLike, WebSocketTransportOptions } from "./inspector/transports/websocket.js";
+export { INSPECTOR_PROTOCOL_VERSION, makeRequest, makeResponse, makeError, makeEvent, isRequest, isResponse, isEvent, } from "./inspector/protocol.js";
+export { BRIDGE_PROTOCOL_VERSION, BridgeError, MongoBridgeClient, bridgeUrl, bridgeUrlFromRelay, redactMongoUri, } from "./inspector/bridge.js";
+export type { BridgeConnectResult, BridgeErrorCode, BridgeOp, BridgeReadResult, BridgeRequest, BridgeResponse, BridgeWriteMode, BridgeWriteResult, MongoBridgeClientOptions, MongoCollectionInfo, } from "./inspector/bridge.js";
+export type { BulkWriteSummary, CollectionSummary, ConflictRecord, ConnectResult, DocumentPage, InspectorCapability, InspectorError, InspectorErrorCode, InspectorEvent, InspectorEventName, InspectorMessage, InspectorMethod, InspectorRequest, InspectorResponse, InspectorStats, InspectorTransport, } from "./inspector/protocol.js";
+export { observe, observeQuery, observeSyncStatus } from "./reactive/live-query.js";
+export type { LiveObserver, LiveQueryOptions, LiveSubscription } from "./reactive/live-query.js";
+export { SqlAdapterBase } from "./storage/adapters/sql-base.js";
+export type { SqlDriver } from "./storage/adapters/sql-base.js";
+export { IndexedDbAdapter } from "./storage/adapters/indexeddb.js";
+export type { IndexedDbAdapterOptions } from "./storage/adapters/indexeddb.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/index.js

@@ -0,0 +1,59 @@
+/**
+ * anchordb — MongoDB + Mongoose, for mobile apps.
+ *
+ * Local-first by default. Sync is opt-in: construct without a `sync` block and you get a purely
+ * local database with no queue, no network code and no sync metadata.
+ */
+export { AnchorDB, LocalDB } from "./core/anchor-db.js";
+export { Schema } from "./schema/schema.js";
+export { SchemaTypes } from "./schema/types.js";
+export { castDocument, castValue } from "./schema/cast.js";
+export { validateDocument } from "./schema/validate.js";
+export { Model } from "./model/model.js";
+export { Query } from "./query/builder/query.js";
+export { ObjectId } from "./core/object-id.js";
+export { uuidv7, generateClientId } from "./core/uuid.js";
+export { HybridLogicalClock, compareHlc, compareHlcStamps, decodeHlc, encodeHlc } from "./core/hlc.js";
+export { AnchorError, AnchorConfigError, BulkWriteError, CastError, DocumentNotFoundError, DUPLICATE_KEY_CODE, MongoServerError, StrictModeError, ValidationError, ValidatorError, duplicateKeyError, } from "./core/errors.js";
+export { TimeService } from "./timestamps/index.js";
+export { assertValidTimeZone, detectDeviceTimeZone, formatInTimeZone, isValidTimeZone, parseZonedTimeToUtc, toUtcIso, zonedTimeToUtc, } from "./timestamps/timezone.js";
+export { TypedEmitter } from "./events/emitter.js";
+export { MemoryAdapter } from "./storage/adapters/memory.js";
+export { matchesFilter, extractConstraints, registerQueryOperator, listQueryOperators, } from "./query/filter.js";
+export { applyUpdate, registerUpdateOperator, listUpdateOperators, updatedPaths, } from "./query/update.js";
+export { compareValues, deepClone, flattenPaths, getPath, hasPath, setPath, unsetPath, valuesEqual, } from "./query/path.js";
+export { extractIndexKeys, defaultIndexName, NULL_SENTINEL } from "./index/keys.js";
+// ---- sync (optional; tree-shaken away when unused) --------------------------
+export { attachSync } from "./sync/attach.js";
+export { MutationQueue, QUEUE_COLLECTION } from "./sync/queue.js";
+export { SyncEngine, SHADOW_COLLECTION } from "./sync/engine.js";
+export { RestSyncAdapter } from "./sync/adapters/rest.js";
+export { MemorySyncServer } from "./sync/server/memory-server.js";
+export { PROTOCOL_VERSION, SyncAuthError, SyncTransportError, } from "./sync/protocol.js";
+// ---- conflict strategies ----------------------------------------------------
+export { ClientWinsStrategy, ConflictStrategyRegistry, CustomStrategy, FieldLevelStrategy, LastWriteWinsStrategy, ServerWinsStrategy, } from "./conflict/strategies.js";
+// ---- interop: MongoDB Extended JSON, export/import ---------------------------
+export { toEJSON, fromEJSON, stringifyEJSON, parseEJSON } from "./interop/ejson.js";
+export { detectImportFormat, exportCollection, exportDatabase, importCollection, importDatabase, mongoimportCommand, } from "./interop/export-import.js";
+export { csvHeaders, fromCsv, inferCsvValue, looksLikeCsv, parseCsvRows, toCsv } from "./interop/csv.js";
+// ---- aggregation -------------------------------------------------------------
+export { runPipeline, validatePipeline, planPushdown } from "./query/aggregation/pipeline.js";
+export { evaluate as evaluateExpression, registerExpressionOperator, listExpressionOperators, isPortableOperator, MISSING, } from "./query/aggregation/expressions.js";
+export { StorageAggregationSource } from "./query/aggregation/source.js";
+// ---- documents ---------------------------------------------------------------
+export { AnchorDocument, createModelConstructor } from "./model/document.js";
+export { castFilter } from "./schema/cast.js";
+// ---- inspector (optional; disabled by default) -------------------------------
+export { InspectorAgent, InspectorRequestError } from "./inspector/agent.js";
+export { InspectorClient, InspectorClientError } from "./inspector/client.js";
+export { InspectorAuth, hmacSha256, timingSafeEqual } from "./inspector/auth.js";
+export { createInProcessTransportPair } from "./inspector/transports/in-process.js";
+export { WebSocketTransport } from "./inspector/transports/websocket.js";
+export { INSPECTOR_PROTOCOL_VERSION, makeRequest, makeResponse, makeError, makeEvent, isRequest, isResponse, isEvent, } from "./inspector/protocol.js";
+export { BRIDGE_PROTOCOL_VERSION, BridgeError, MongoBridgeClient, bridgeUrl, bridgeUrlFromRelay, redactMongoUri, } from "./inspector/bridge.js";
+// ---- reactive primitives (shared by the React and Angular bindings) -----------
+export { observe, observeQuery, observeSyncStatus } from "./reactive/live-query.js";
+// ---- storage adapters (subpath imports keep platform code out of other bundles) -----
+export { SqlAdapterBase } from "./storage/adapters/sql-base.js";
+export { IndexedDbAdapter } from "./storage/adapters/indexeddb.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQxD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOhD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGvG,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAa7D,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,SAAS,EACT,YAAY,EACZ,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWpF,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAe5B,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAUzG,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAQ9F,OAAO,EACL,QAAQ,IAAI,kBAAkB,EAC9B,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,GACR,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,iFAAiF;AACjF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,iFAAiF;AACjF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,GACR,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAgC/B,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGpF,wFAAwF;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/esm/inspector/agent.d.ts

@@ -0,0 +1,75 @@
+import type { AnchorDB } from "../core/anchor-db.js";
+import { InspectorAuth, type InspectorAuthOptions, type PairingInfo } from "./auth.js";
+import { type InspectorCapability, type InspectorTransport } from "./protocol.js";
+export interface InspectorAgentOptions {
+    auth?: InspectorAuthOptions;
+    /** Refuse every mutating method. Useful when inspecting something you must not disturb. */
+    readOnly?: boolean;
+    platform?: string;
+    anchorVersion?: string;
+    /** Conflicts to retain for the Lens conflict viewer. */
+    conflictHistory?: number;
+}
+export declare class InspectorAgent {
+    readonly auth: InspectorAuth;
+    private readonly db;
+    private readonly opts;
+    private readonly transports;
+    private readonly authenticated;
+    private readonly subscribed;
+    private readonly conflicts;
+    private detach;
+    private lastSyncAt;
+    constructor(db: AnchorDB, options?: InspectorAgentOptions);
+    /** Begin a pairing window; the result is what a QR code encodes. */
+    startPairing(): PairingInfo;
+    capabilities(): InspectorCapability[];
+    /** Attach a transport. Multiple may be attached at once (§45). */
+    attach(transport: InspectorTransport): () => void;
+    close(): Promise<void>;
+    private handle;
+    private toErrorResponse;
+    private dispatch;
+    private connect;
+    private authenticate;
+    /** The challenge a client signs. Exposed so a transport can hand it over during pairing. */
+    challenge(): string | null;
+    private model;
+    private getCollections;
+    private getStats;
+    private getIndexes;
+    /** Paged, always. The cap is enforced here, not trusted from the client (§34). */
+    private getDocuments;
+    private getDocument;
+    private insertDocument;
+    private updateDocument;
+    private deleteDocument;
+    /**
+     * Bulk update (Compass's "Update" on the collection toolbar).
+     *
+     * Routed through `Model.updateMany`, so every matching document gets the same validation,
+     * timestamps, change events and queued mutations as an app write — and the whole thing is one
+     * pass over an index rather than N round trips from the inspector.
+     */
+    private updateMany;
+    /** Bulk delete (Compass's "Delete"). Same reasoning as {@link updateMany}. */
+    private deleteMany;
+    private getSyncStatus;
+    private readQueue;
+    private getMutations;
+    private retryMutation;
+    /**
+     * Manual conflict resolution from Lens.
+     *
+     * Deliberately routed through `updateDocument` rather than written straight to storage: the
+     * developer's decision becomes an ordinary mutation that syncs like any other (§41). Bypassing
+     * the queue would let Lens create state the server never learns about.
+     */
+    private resolveConflict;
+    private wireEvents;
+}
+export declare class InspectorRequestError extends Error {
+    readonly code: "unauthenticated" | "unauthorized" | "bad_request" | "not_found" | "unsupported_method";
+    constructor(code: InspectorRequestError["code"], message: string);
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/esm/inspector/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/inspector/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAWL,KAAK,mBAAmB,EAIxB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAsBvB,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAqB;gBAE3B,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,qBAA0B;IAO7D,oEAAoE;IACpE,YAAY,IAAI,WAAW;IAI3B,YAAY,IAAI,mBAAmB,EAAE;IAgBrC,kEAAkE;IAClE,MAAM,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAY3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,MAAM;IAuBpB,OAAO,CAAC,eAAe;YAeT,QAAQ;IA4FtB,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,YAAY;IAmBpB,4FAA4F;IAC5F,SAAS,IAAI,MAAM,GAAG,IAAI;IAM1B,OAAO,CAAC,KAAK;YAYC,cAAc;YAgBd,QAAQ;YAkBR,UAAU;IAIxB,kFAAkF;YACpE,YAAY;YAgBZ,WAAW;YAMX,cAAc;YAKd,cAAc;YAYd,cAAc;IAI5B;;;;;;OAMG;YACW,UAAU;IA2BxB,8EAA8E;YAChE,UAAU;YAaV,aAAa;YAgBb,SAAS;YAMT,YAAY;YAMZ,aAAa;IAW3B;;;;;;OAMG;YACW,eAAe;IAU7B,OAAO,CAAC,UAAU;CAmCnB;AA+BD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,oBAAoB,CAAC;gBAC3F,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAKjE"}