pyric 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/firestore/sandbox/converters/user-timestamp.js

@@ -1,45 +1,11 @@
 /**
- * User-Timestamp write-boundary converter (FS-B4).
+ * Normalize SDK and decoded Timestamp values at the Firestore write boundary.
+ * Firestore stores microsecond precision; rules must inspect that same value
+ * before deciding whether a write is allowed. Preserve the caller's object.
  *
- * Unifies Timestamp storage. The simulator stores resolved timestamps as
- * rules-internal {@link Timestamp} (`pyric/rules`, `{seconds, nanos}`,
- * carrying evaluator hooks). The `serverTimestamp()` sentinel and `Date`
- * inputs already resolve to that internal class (see `timestamp.ts`). But
- * a timestamp the user *writes directly* — via the modular SDK's
- * `Timestamp` (the admin-compat `{seconds, nanoseconds}` class re-exported
- * as `Timestamp` from `pyric/firestore`) or a raw `firebase/firestore`
- * `Timestamp` — has no converter, so it lands in storage as the compat
- * class instance. Two problems with that split storage:
- *
- *   1. The rules evaluator detects timestamps via `value instanceof
- *      RulesValue && typeName === 'timestamp'`. A compat `Timestamp` is
- *      neither, so `data.createdAt is timestamp` returns false — a user
- *      `Timestamp` is rejected by the very `is timestamp` rule that a
- *      `serverTimestamp()` write passes.
- *   2. Range filters / cursors / `orderBy` compare against stored values.
- *      The FS-B3 comparator was taught both timestamp shapes, so ordering
- *      mostly works — but the read-path translator only rewrites the
- *      internal class to compat shape, so a user-written compat Timestamp
- *      never gets the `nanos`→`nanoseconds` normalization round-trip and
- *      `serverTimestamp()`-written and user-written timestamps live as two
- *      different classes in the same collection. Normalizing both to the
- *      internal class at the write boundary collapses the split.
- *
- * Detection strategy — duck typing on the compat / `firebase/firestore`
- * Timestamp shape, exactly like {@link bytesConverter} /
- * {@link geoPointConverter}:
- *   - numeric `seconds`
- *   - numeric `nanoseconds`  (the compat / fb field name — distinct from
- *     the internal class's `nanos`, which is how we reject our own output)
- *   - method `toMillis`
- *
- * We deliberately don't `instanceof fb.Timestamp` — the simulator package
- * must not take a hard dependency on `firebase/firestore`, and multiple
- * `firebase` copies in a workspace would defeat `instanceof` anyway.
- *
- * Idempotency: the internal {@link Timestamp} has `nanos`, not
- * `nanoseconds`, and `value instanceof RulesTimestamp` short-circuits
- * first — so a second resolver pass over our own output is a no-op.
+ * Decoded rules wrappers already at storage precision are left alone, making
+ * repeated write preparation idempotent. The SDK shape is recognized without
+ * a Firebase dependency, including instances from a separately installed SDK.
  */
 import { KEEP } from '../value-resolver.js';
 import { Timestamp as RulesTimestamp } from 'pyric/rules/internal';
@@ -57,9 +23,20 @@ function isUserTimestamp(v) {
 export const userTimestampConverter = {
     name: 'user-timestamp-to-rules-timestamp',
     convert(value) {
-        if (!isUserTimestamp(value))
-            return KEEP;
-        return new RulesTimestamp(value.seconds, value.nanoseconds);
+        const isRulesTimestamp = value instanceof RulesTimestamp;
+        if (isRulesTimestamp) {
+            const nanoseconds = Math.floor(value.nanos / 1_000) * 1_000;
+            const hasMicrosecondPrecision = nanoseconds === value.nanos;
+            if (hasMicrosecondPrecision)
+                return KEEP;
+            return new RulesTimestamp(value.seconds, nanoseconds);
+        }
+        const isSdkTimestamp = isUserTimestamp(value);
+        if (isSdkTimestamp) {
+            const nanoseconds = Math.floor(value.nanoseconds / 1_000) * 1_000;
+            return new RulesTimestamp(value.seconds, nanoseconds);
+        }
+        return KEEP;
     },
 };
 //# sourceMappingURL=user-timestamp.js.map

package/dist/firestore/sandbox/converters/user-timestamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-timestamp.js","sourceRoot":"","sources":["../../../../src/firestore/sandbox/converters/user-timestamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,EAAE,IAAI,EAAuB,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AASnE,SAAS,eAAe,CAAC,CAAU;IACjC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,+DAA+D;IAC/D,IAAI,CAAC,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,mCAAmC;IACzC,OAAO,CAAC,KAAK;QACX,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC"}
+{"version":3,"file":"user-timestamp.js","sourceRoot":"","sources":["../../../../src/firestore/sandbox/converters/user-timestamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAuB,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AASnE,SAAS,eAAe,CAAC,CAAU;IACjC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,+DAA+D;IAC/D,IAAI,CAAC,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,mCAAmC;IACzC,OAAO,CAAC,KAAK;QACX,MAAM,gBAAgB,GAAG,KAAK,YAAY,cAAc,CAAC;QACzD,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YAC5D,MAAM,uBAAuB,GAAG,WAAW,KAAK,KAAK,CAAC,KAAK,CAAC;YAC5D,IAAI,uBAAuB;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YAClE,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/firestore/sandbox/document-copy.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentData } from './document-store.js';
+/** Copy document inputs, validating Dates without resolving write transforms. */
+export declare function cloneDoc(data: DocumentData): DocumentData;
+//# sourceMappingURL=document-copy.d.ts.map

package/dist/firestore/sandbox/document-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-copy.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/document-copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAMzD"}

package/dist/firestore/sandbox/document-copy.js

@@ -0,0 +1,28 @@
+import { isPlainObject } from './value-resolver.js';
+import { Timestamp } from '../timestamp.js';
+import { registeredReferenceQueryValuePath } from './query-value-registry.js';
+/** Copy document inputs, validating Dates without resolving write transforms. */
+export function cloneDoc(data) {
+    const copy = {};
+    for (const [field, value] of Object.entries(data)) {
+        copy[field] = cloneValue(value);
+    }
+    return copy;
+}
+function cloneValue(value) {
+    const isDate = value instanceof Date;
+    if (isDate)
+        return Timestamp.fromDate(value).toDate();
+    const isArray = Array.isArray(value);
+    if (isArray)
+        return value.map(cloneValue);
+    const isMap = isPlainObject(value);
+    if (isMap) {
+        const isReference = registeredReferenceQueryValuePath(value) !== undefined;
+        if (isReference)
+            return value;
+        return cloneDoc(value);
+    }
+    return value;
+}
+//# sourceMappingURL=document-copy.js.map

package/dist/firestore/sandbox/document-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-copy.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/document-copy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAE9E,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,IAAkB;IACzC,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC;IACrC,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,OAAO;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,WAAW,GAAG,iCAAiC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;QAC3E,IAAI,WAAW;YAAE,OAAO,KAAK,CAAC;QAC9B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/firestore/sandbox/document-store.d.ts

@@ -0,0 +1,99 @@
+/** Contracts shared by Firestore document stores and atomic state application. */
+export type DocumentData = Record<string, unknown>;
+/** One row from a {@link DocStore} scan/list. */
+export interface DocEntry {
+    path: string;
+    data: DocumentData;
+    /** Synthesized parent of deeper descendants (no stored doc of its own). */
+    phantom?: true;
+}
+/** Options for {@link DocStore.scan}. */
+export interface ScanOptions {
+    /** Only direct children of the prefix (a collection scan), not all descendants. */
+    directOnly?: boolean;
+    /** Synthesize phantom-parent entries for paths whose parent has no stored doc. */
+    phantoms?: boolean;
+    /** Project each emitted doc's data down to only these top-level fields (others
+     *  omitted), so callers can skip large fields like vectors. Phantoms stay `{}`. */
+    projection?: readonly string[];
+}
+/**
+ * The store seam over the document keyspace. Everything that touches documents
+ * (queries, listeners, the worker, branches, writes, undo) goes through this
+ * contract rather than a raw Map, so the backing store can be swapped (a CoW
+ * overlay for branches, chunked persistence) without touching the callers.
+ * `scan` is the single read-iteration primitive; `list` builds on it.
+ * Synchronous by design: the rules simulator consumes pre-resolved reads, so the
+ * read path cannot go async.
+ */
+export interface DocStore {
+    get(path: string): DocumentData | null;
+    /** Monotonic local write version used for optimistic transaction checks. */
+    version(path: string): number;
+    /** Latest version allocated anywhere in this store. */
+    currentVersion(): number;
+    exists(path: string): boolean;
+    scan(prefix: string, opts?: ScanOptions): DocEntry[];
+    list(collection: string): DocEntry[];
+    listRootCollections(): string[];
+    listSubcollections(docPath: string): string[];
+    snapshot(): Record<string, DocumentData>;
+    size(): number;
+    create(path: string, data: DocumentData): CreateResult;
+    update(path: string, data: DocumentData): UpdateResult;
+    set(path: string, data: DocumentData): SetResult;
+    setMerge(path: string, data: DocumentData, mergeFields?: readonly string[]): SetResult;
+    delete(path: string): DeleteResult;
+    applyBatch(operations: BatchOperation[]): BatchResult;
+    restore(snapshot: Record<string, DocumentData>): void;
+    restorePaths(priorDocs: Record<string, DocumentData | null>): void;
+}
+/**
+ * The raw key->doc backing under {@link LocalState}: the subset of `Map` the
+ * store uses. A plain `Map` satisfies it (the default); branches inject an
+ * `OverlayBacking` for copy-on-write over an immutable base, so the store's
+ * read/write/merge logic is reused unchanged over either backing.
+ */
+export interface DocBacking {
+    get(path: string): DocumentData | undefined;
+    set(path: string, data: DocumentData): void;
+    has(path: string): boolean;
+    delete(path: string): boolean;
+    clear(): void;
+    keys(): IterableIterator<string>;
+    readonly size: number;
+    [Symbol.iterator](): IterableIterator<[string, DocumentData]>;
+}
+export interface CreateResult {
+    success: boolean;
+    error?: string;
+}
+export interface UpdateResult {
+    success: boolean;
+    error?: string;
+    priorData?: DocumentData;
+}
+export interface SetResult {
+    success: true;
+    priorData: DocumentData | null;
+    created: boolean;
+}
+export interface DeleteResult {
+    success: boolean;
+    error?: string;
+    priorData?: DocumentData;
+}
+export interface BatchOperation {
+    method: 'create' | 'update' | 'set' | 'delete';
+    path: string;
+    data?: DocumentData;
+}
+export interface BatchResult {
+    success: boolean;
+    errors?: {
+        index: number;
+        error: string;
+    }[];
+    priorStates?: Map<string, DocumentData | null>;
+}
+//# sourceMappingURL=document-store.d.ts.map

package/dist/firestore/sandbox/document-store.d.ts.map

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

package/dist/firestore/sandbox/document-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-store.js.map

package/dist/firestore/sandbox/document-store.js.map

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

package/dist/firestore/sandbox/errors.d.ts

@@ -23,6 +23,7 @@
  * `unauthenticated`) are reserved so adding their wiring later is a
  * pure callsite change, no error-set churn.
  */
+import type { QueryProofDiagnostic } from '../../sandbox/types/query-proof.js';
 export declare const FIRESTORE_ERROR_CODES: readonly ["permission-denied", "not-found", "already-exists", "failed-precondition", "aborted", "invalid-argument", "unauthenticated", "unimplemented"];
 export type FirestoreErrorCode = typeof FIRESTORE_ERROR_CODES[number];
 /**
@@ -54,6 +55,7 @@ export interface FirestoreEvalResource {
     exists: boolean;
 }
 export interface FirestoreSimError {
+    queryProof?: QueryProofDiagnostic;
     code: FirestoreErrorCode;
     message: string;
     /**
@@ -104,7 +106,7 @@ export interface QueryDenialDescriptor {
     readonly where?: readonly {
         readonly field: string;
         readonly op: string;
-        readonly value: string | number | boolean | null;
+        readonly value: string | number | boolean | null | readonly (string | number | boolean | null)[];
     }[];
     readonly limit?: number | null;
     readonly offset?: number | null;
@@ -117,6 +119,7 @@ export interface QueryDenialDescriptor {
  * of an opaque "denied by rules".
  */
 export declare function makeError(code: FirestoreErrorCode, message: string, extras?: {
+    queryProof?: QueryProofDiagnostic;
     request?: FirestoreEvalRequest;
     resource?: FirestoreEvalResource;
     remediation?: string;

package/dist/firestore/sandbox/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,qBAAqB,yJAcxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;KAClD,EAAE,CAAC;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IACP,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,GACA,iBAAiB,CA0BnB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/errors.ts"],"names":[],"mappings":"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"}

package/dist/firestore/sandbox/errors.js

@@ -1,28 +1,3 @@
-/**
- * Item 6 — typed error codes for `LocalEnvironment` results.
- *
- * The simulator previously surfaced denials as `allowed: false` plus an
- * unstructured `debugMessages: string[]`. Agents had to grep the string
- * to tell "rule denied" apart from "doc didn't exist" apart from "the
- * sentinel was rejected", which is exactly the affordance Firestore's
- * `FirestoreError.code` gives them in production.
- *
- * The codes here are the canonical set the firebase-admin SDK throws
- * (a subset of gRPC status names). They're string-literal values so
- * downstream consumers can switch on them without importing an enum.
- *
- * Mapping the simulator emits today (Item 6 first cut):
- *   - rule denied                       → 'permission-denied'
- *   - update of missing doc             → 'not-found'
- *   - create of existing doc            → 'already-exists'
- *   - sentinel-resolution failure       → 'invalid-argument'
- *     (admin SDK also throws this for malformed FieldValue use; see
- *      the increment converter's "prior is not numeric" path)
- *
- * Codes defined-but-unused today (`failed-precondition`,
- * `unauthenticated`) are reserved so adding their wiring later is a
- * pure callsite change, no error-set churn.
- */
 export const FIRESTORE_ERROR_CODES = [
     'permission-denied',
     'not-found',
@@ -48,6 +23,8 @@ export function makeError(code, message, extras) {
     const out = { code, message };
     const hasExtras = extras !== undefined;
     if (hasExtras) {
+        if (extras.queryProof !== undefined)
+            out.queryProof = extras.queryProof;
         const hasRequest = extras.request !== undefined;
         if (hasRequest) {
             out.request = extras.request;

package/dist/firestore/sandbox/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,WAAW;IACX,gBAAgB;IAChB,qBAAqB;IACrB,SAAS;IACT,kBAAkB;IAClB,iBAAiB;IACjB,mEAAmE;IACnE,sEAAsE;IACtE,sEAAsE;IACtE,iEAAiE;IACjE,uEAAuE;IACvE,eAAe;CACP,CAAC;AA0FX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,IAAwB,EACxB,OAAe,EACf,MAaC;IAED,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC;IACvC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,UAAU,GAAG,MAAO,CAAC,OAAO,KAAK,SAAS,CAAC;QACjD,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,OAAO,GAAG,MAAO,CAAC,OAAO,CAAC;QAChC,CAAC;QACD,MAAM,WAAW,GAAG,MAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;QACnD,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,CAAC,QAAQ,GAAG,MAAO,CAAC,QAAQ,CAAC;QAClC,CAAC;QACD,MAAM,cAAc,GAAG,MAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACzD,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,CAAC,WAAW,GAAG,MAAO,CAAC,WAAW,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAO,CAAC,KAAK,KAAK,SAAS,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,GAAG,MAAO,CAAC,KAAK,CAAC;QAC5B,CAAC;QACD,MAAM,OAAO,GAAG,MAAO,CAAC,IAAI,KAAK,SAAS,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,GAAG,CAAC,IAAI,GAAG,MAAO,CAAC,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/errors.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,WAAW;IACX,gBAAgB;IAChB,qBAAqB;IACrB,SAAS;IACT,kBAAkB;IAClB,iBAAiB;IACjB,mEAAmE;IACnE,sEAAsE;IACtE,sEAAsE;IACtE,iEAAiE;IACjE,uEAAuE;IACvE,eAAe;CACP,CAAC;AA2FX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,IAAwB,EACxB,OAAe,EACf,MAcC;IAED,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC;IACvC,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,MAAO,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,MAAO,CAAC,UAAU,CAAC;QAC1E,MAAM,UAAU,GAAG,MAAO,CAAC,OAAO,KAAK,SAAS,CAAC;QACjD,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,OAAO,GAAG,MAAO,CAAC,OAAO,CAAC;QAChC,CAAC;QACD,MAAM,WAAW,GAAG,MAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;QACnD,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,CAAC,QAAQ,GAAG,MAAO,CAAC,QAAQ,CAAC;QAClC,CAAC;QACD,MAAM,cAAc,GAAG,MAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACzD,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,CAAC,WAAW,GAAG,MAAO,CAAC,WAAW,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,MAAO,CAAC,KAAK,KAAK,SAAS,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,GAAG,MAAO,CAAC,KAAK,CAAC;QAC5B,CAAC;QACD,MAAM,OAAO,GAAG,MAAO,CAAC,IAAI,KAAK,SAAS,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,GAAG,CAAC,IAAI,GAAG,MAAO,CAAC,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/firestore/sandbox/event-log.d.ts

@@ -1,10 +1,12 @@
 /**
- * Event Log — append-only audit trail for the local environment.
+ * Event Log — bounded audit and undo history for the local environment.
  *
- * Every operation (allowed or denied) is recorded. Undo is implemented
+ * Operations (allowed or denied) are retained within count and byte limits. Undo is implemented
  * via state snapshots — no need to replay events.
  */
 import type { DocumentData } from './local-state.js';
+import { type EventHistoryLimits } from '../../sandbox/internal/history-retention.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 export interface AgentEvent {
     id: number;
     timestamp: string;
@@ -67,13 +69,25 @@ export interface AgentEvent {
     /** Debug messages from rules evaluation */
     debugMessages: string[];
 }
+export interface EventLogRetention {
+    retainedEvents: number;
+    retainedBytes: number;
+    omittedCount: number;
+}
 export declare class EventLog {
+    private readonly clock;
+    private readonly limits;
     private events;
     private nextId;
     private undoneEvents;
+    private readonly eventBytes;
+    private retainedBytes;
+    private omittedCount;
+    /** @param clock The sandbox clock every appended entry is stamped from. */
+    constructor(clock?: SandboxClock, limits?: EventHistoryLimits);
     /** Append an event. Clears redo stack unless preserveRedo is true. */
     append(event: Omit<AgentEvent, 'id' | 'timestamp'>, preserveRedo?: boolean): AgentEvent;
-    /** Get all events. */
+    /** Get retained events in their original order. */
     getEvents(): AgentEvent[];
     /** Get write events only (create, update, delete, set — not reads). */
     getWriteEvents(): AgentEvent[];
@@ -91,7 +105,11 @@ export declare class EventLog {
     popLastWrite(): AgentEvent | null;
     /** Get the last undone event (for redo). */
     popLastUndo(): AgentEvent | null;
-    /** Total event count. */
+    /** Shared accounting for the visible log and redo stack. */
+    getRetention(): EventLogRetention;
+    private release;
+    private prune;
+    /** Visible event count; undone events remain accounted in getRetention(). */
     size(): number;
     /** Clear all events. */
     clear(): void;

package/dist/firestore/sandbox/event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/event-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC3D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAoB;IAExC,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,YAAY,UAAQ,GAAG,UAAU;IAWrF,sBAAsB;IACtB,SAAS,IAAI,UAAU,EAAE;IAIzB,uEAAuE;IACvE,cAAc,IAAI,UAAU,EAAE;IAI9B,2CAA2C;IAC3C,cAAc,IAAI,UAAU,GAAG,IAAI;IAKnC;;;;;;;;OAQG;IACH,YAAY,IAAI,UAAU,GAAG,IAAI;IAajC,4CAA4C;IAC5C,WAAW,IAAI,UAAU,GAAG,IAAI;IAIhC,yBAAyB;IACzB,IAAI,IAAI,MAAM;IAId,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAKd"}
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/event-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEpG,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,YAAY,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC3D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,QAAQ;IAUjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IAEzB,2EAA2E;gBAExD,KAAK,GAAE,YAAiC,EACxC,MAAM,GAAE,kBAA+C;IAG1E,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,CAAC,EAAE,YAAY,UAAQ,GAAG,UAAU;IAkBrF,mDAAmD;IACnD,SAAS,IAAI,UAAU,EAAE;IAIzB,uEAAuE;IACvE,cAAc,IAAI,UAAU,EAAE;IAI9B,2CAA2C;IAC3C,cAAc,IAAI,UAAU,GAAG,IAAI;IAKnC;;;;;;;;OAQG;IACH,YAAY,IAAI,UAAU,GAAG,IAAI;IAajC,4CAA4C;IAC5C,WAAW,IAAI,UAAU,GAAG,IAAI;IAOhC,4DAA4D;IAC5D,YAAY,IAAI,iBAAiB;IAQjC,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,KAAK;IAgBb,6EAA6E;IAC7E,IAAI,IAAI,MAAM;IAId,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAQd"}

package/dist/firestore/sandbox/event-log.js

@@ -1,20 +1,40 @@
+import { encodedBytes } from '../../sandbox/internal/history-retention.js';
+import { OBSERVATION_HISTORY_LIMITS } from '../../sandbox/internal/observation-history.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 export class EventLog {
+    clock;
+    limits;
     events = [];
     nextId = 1;
     undoneEvents = [];
+    eventBytes = new Map();
+    retainedBytes = 0;
+    omittedCount = 0;
+    /** @param clock The sandbox clock every appended entry is stamped from. */
+    constructor(clock = new SandboxClock(), limits = OBSERVATION_HISTORY_LIMITS) {
+        this.clock = clock;
+        this.limits = limits;
+    }
     /** Append an event. Clears redo stack unless preserveRedo is true. */
     append(event, preserveRedo = false) {
         const full = {
             ...event,
             id: this.nextId++,
-            timestamp: new Date().toISOString(),
+            timestamp: new Date(this.clock.now()).toISOString(),
         };
-        this.events.push(full);
-        if (!preserveRedo)
+        if (!preserveRedo) {
+            for (const undone of this.undoneEvents)
+                this.release(undone);
             this.undoneEvents = [];
+        }
+        this.events.push(full);
+        const bytes = encodedBytes(full) + 1;
+        this.eventBytes.set(full.id, bytes);
+        this.retainedBytes += bytes;
+        this.prune();
         return full;
     }
-    /** Get all events. */
+    /** Get retained events in their original order. */
     getEvents() {
         return [...this.events];
     }
@@ -51,9 +71,46 @@ export class EventLog {
     }
     /** Get the last undone event (for redo). */
     popLastUndo() {
-        return this.undoneEvents.pop() ?? null;
+        const event = this.undoneEvents.pop();
+        if (!event)
+            return null;
+        this.release(event);
+        return event;
+    }
+    /** Shared accounting for the visible log and redo stack. */
+    getRetention() {
+        return {
+            retainedEvents: this.eventBytes.size,
+            retainedBytes: this.retainedBytes,
+            omittedCount: this.omittedCount,
+        };
+    }
+    release(event) {
+        this.retainedBytes -= this.eventBytes.get(event.id) ?? 0;
+        this.eventBytes.delete(event.id);
+        // An unserializable event has infinite estimated size; removing the final
+        // retained entry must reset accounting rather than leave Infinity - Infinity.
+        const isEmpty = this.eventBytes.size === 0;
+        if (isEmpty)
+            this.retainedBytes = 0;
+    }
+    prune() {
+        const exceedsBudget = () => this.eventBytes.size > this.limits.maxEvents
+            || this.retainedBytes > this.limits.maxBytes;
+        while (exceedsBudget()) {
+            // Accounting preserves append order even when undo/redo reorders stacks.
+            const oldestId = this.eventBytes.keys().next().value;
+            const oldestIsUndone = this.events[0]?.id !== oldestId;
+            const entries = oldestIsUndone ? this.undoneEvents : this.events;
+            const index = oldestIsUndone ? entries.findIndex(event => event.id === oldestId) : 0;
+            const [omitted] = entries.splice(index, 1);
+            if (!omitted)
+                break;
+            this.release(omitted);
+            this.omittedCount++;
+        }
     }
-    /** Total event count. */
+    /** Visible event count; undone events remain accounted in getRetention(). */
     size() {
         return this.events.length;
     }
@@ -62,6 +119,9 @@ export class EventLog {
         this.events = [];
         this.undoneEvents = [];
         this.nextId = 1;
+        this.eventBytes.clear();
+        this.retainedBytes = 0;
+        this.omittedCount = 0;
     }
 }
 //# sourceMappingURL=event-log.js.map

package/dist/firestore/sandbox/event-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/event-log.ts"],"names":[],"mappings":"AA8DA,MAAM,OAAO,QAAQ;IACX,MAAM,GAAiB,EAAE,CAAC;IAC1B,MAAM,GAAG,CAAC,CAAC;IACX,YAAY,GAAiB,EAAE,CAAC;IAExC,sEAAsE;IACtE,MAAM,CAAC,KAA2C,EAAE,YAAY,GAAG,KAAK;QACtE,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY;YAAE,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB;IACtB,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACzF,CAAC;IAED,2CAA2C;IAC3C,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY;QACV,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,CAAC,OAAO;gBAAE,SAAS;YACxB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1B,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,yBAAyB;IACzB,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,wBAAwB;IACxB,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/event-log.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAA2B,MAAM,6CAA6C,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA8DtD,MAAM,OAAO,QAAQ;IAUA;IACA;IAVX,MAAM,GAAiB,EAAE,CAAC;IAC1B,MAAM,GAAG,CAAC,CAAC;IACX,YAAY,GAAiB,EAAE,CAAC;IACvB,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,aAAa,GAAG,CAAC,CAAC;IAClB,YAAY,GAAG,CAAC,CAAC;IAEzB,2EAA2E;IAC3E,YACmB,QAAsB,IAAI,YAAY,EAAE,EACxC,SAA6B,0BAA0B;QADvD,UAAK,GAAL,KAAK,CAAmC;QACxC,WAAM,GAAN,MAAM,CAAiD;IACvE,CAAC;IAEJ,sEAAsE;IACtE,MAAM,CAAC,KAA2C,EAAE,YAAY,GAAG,KAAK;QACtE,MAAM,IAAI,GAAe;YACvB,GAAG,KAAK;YACR,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACjB,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;SACpD,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7D,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,uEAAuE;IACvE,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACzF,CAAC;IAED,2CAA2C;IAC3C,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY;QACV,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,CAAC,OAAO;gBAAE,SAAS;YACxB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC3D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1B,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,WAAW;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4DAA4D;IAC5D,YAAY;QACV,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YACpC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,KAAiB;QAC/B,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjC,0EAA0E;QAC1E,8EAA8E;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;QAC3C,IAAI,OAAO;YAAE,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK;QACX,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS;eACnE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC/C,OAAO,aAAa,EAAE,EAAE,CAAC;YACvB,yEAAyE;YACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACrD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,QAAQ,CAAC;YACvD,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACjE,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO;gBAAE,MAAM;YACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,wBAAwB;IACxB,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/firestore/sandbox/field-merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-merge.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/field-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AA0E7B;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,GACrB,YAAY,CAcd;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAYD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAMtE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,YAAY,CAoBd"}
+{"version":3,"file":"field-merge.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/field-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AA4D7B;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,GACrB,YAAY,CAcd;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAYD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAMtE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,YAAY,CAyBd"}

package/dist/firestore/sandbox/field-merge.js

@@ -31,6 +31,8 @@
  * through the value-resolver (sentinels resolved, deleteField → marker).
  */
 import { DELETE_MARKER, isPlainObject, stripMarkers, } from './value-resolver.js';
+import { FirebaseError } from '../../sandbox/internal/firebase-error.js';
+import { cloneDoc } from './document-copy.js';
 /** Split a dot-separated FieldPath string into segments. */
 function splitPath(key) {
     return key.split('.');
@@ -52,22 +54,6 @@ function assertSafeSegment(seg) {
             'and constructor are reserved and cannot appear in a field path.');
     }
 }
-/** Deep clone a plain document tree, leaving class instances by reference
- *  (Timestamp, Bytes, etc. are immutable wrappers — safe to share). */
-function cloneDoc(data) {
-    const out = {};
-    for (const [k, v] of Object.entries(data)) {
-        out[k] = cloneValue(v);
-    }
-    return out;
-}
-function cloneValue(v) {
-    if (Array.isArray(v))
-        return v.map(cloneValue);
-    if (isPlainObject(v))
-        return cloneDoc(v);
-    return v;
-}
 /**
  * Navigate to the parent map of `segments`, creating (or replacing
  * non-map intermediates with) plain maps along the way, then set or
@@ -164,14 +150,18 @@ export function assertNoNestedDeleteField(resolved) {
 export function applyMerge(existing, resolved, mergeFields) {
     const out = cloneDoc(existing);
     const mask = [];
-    if (mergeFields !== undefined) {
+    const hasFieldMask = mergeFields !== undefined;
+    if (hasFieldMask) {
         // Restrict to the listed field paths. Each is a dot-separated path
-        // into `resolved`; read the value at that path (skip absent ones).
+        // into `resolved` and must be present in the supplied data.
         for (const field of mergeFields) {
             const segments = splitPath(field);
             const value = readPath(resolved, segments);
-            if (value !== ABSENT)
-                mask.push({ segments, value });
+            const isMissing = value === ABSENT;
+            if (isMissing) {
+                throw new FirebaseError('invalid-argument', `Field '${field}' is specified in your field mask but missing from your input data.`);
+            }
+            mask.push({ segments, value });
         }
     }
     else {

package/dist/firestore/sandbox/field-merge.js.map

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

package/dist/firestore/sandbox/history-controls.d.ts

@@ -35,7 +35,7 @@ export declare class HistoryControls {
     /** Redo the last undone operation. Re-applies the write directly
      *  without going through execute() (which would clear the redo stack). */
     redo(): OperationResult | null;
-    /** Get all events. */
+    /** Get retained events in their original order. */
     getEvents(): AgentEvent[];
     /** Get event count. */
     getEventCount(): number;

package/dist/firestore/sandbox/history-controls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-controls.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/history-controls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;qEACqE;AACrE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QACtD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;KACpE,CAAC;IACF,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAC7E,UAAU,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GACnD,iBAAiB,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,WAAW;IAGpC;+EAC2E;IAC3E,IAAI,IAAI,UAAU,GAAG,IAAI;IASzB;8EAC0E;IAC1E,IAAI,IAAI,eAAe,GAAG,IAAI;IAqC9B,sBAAsB;IACtB,SAAS,IAAI,UAAU,EAAE;IAIzB,uBAAuB;IACvB,aAAa,IAAI,MAAM;CAGxB"}
+{"version":3,"file":"history-controls.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/history-controls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;qEACqE;AACrE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC;QACtD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;KACpE,CAAC;IACF,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAC7E,UAAU,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GACnD,iBAAiB,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,WAAW;IAGpC;+EAC2E;IAC3E,IAAI,IAAI,UAAU,GAAG,IAAI;IASzB;8EAC0E;IAC1E,IAAI,IAAI,eAAe,GAAG,IAAI;IAqC9B,mDAAmD;IACnD,SAAS,IAAI,UAAU,EAAE;IAIzB,uBAAuB;IACvB,aAAa,IAAI,MAAM;CAGxB"}