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

package/dist/firestore/sandbox/rules-read-engine.js

@@ -6,22 +6,28 @@ import { buildRulesTestCase } from './rules-test-case.js';
 import { RulesOperationReader } from './rules-operation-reader.js';
 import { RulesListAuthorizer } from './rules-list-authorizer.js';
 import { executeQuery, gatherQueryRows, captureQueryExecutionSpec, captureQueryScope, queryConstraintsForProof, } from './query-execution.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 export class RulesReadEngine {
     events;
     triggerScope;
     rules;
     simulator;
     host;
+    clock;
     operationReader;
     listAuthorizer;
-    constructor(events, triggerScope, rules, simulator, host, eventLog) {
+    constructor(events, triggerScope, rules, simulator, host, eventLog, 
+    /** The sandbox's clock, read for every server-set time this produces.
+     *  Defaults to a private wall clock for a standalone construction. */
+    clock = new SandboxClock()) {
         this.events = events;
         this.triggerScope = triggerScope;
         this.rules = rules;
         this.simulator = simulator;
         this.host = host;
-        this.operationReader = new RulesOperationReader(events, rules, simulator, host, eventLog);
-        this.listAuthorizer = new RulesListAuthorizer(events, rules, simulator, host);
+        this.clock = clock;
+        this.operationReader = new RulesOperationReader(events, rules, simulator, host, eventLog, clock);
+        this.listAuthorizer = new RulesListAuthorizer(events, rules, simulator, host, clock);
     }
     get state() {
         return this.host.state;
@@ -49,7 +55,7 @@ export class RulesReadEngine {
         if (bypassRules) {
             const data = this.state.get(path);
             this.emitRequest({
-                at: Date.now(),
+                at: this.clock.now(),
                 evalMs: 0,
                 method: 'get',
                 path,
@@ -63,10 +69,10 @@ export class RulesReadEngine {
             });
             return { allowed: true, data };
         }
-        const readServerTime = Timestamp.fromMillis(Date.now());
+        const readServerTime = Timestamp.fromMillis(this.clock.now());
         const testCase = buildRulesTestCase(this.state, { method: 'get', path, auth }, readServerTime);
-        // Issue #307 — time the simulate call for listener-origin RequestEvents.
-        const evalAt = Date.now();
+        // Time the simulate call for listener-origin RequestEvents.
+        const evalAt = this.clock.now();
         const evalStart = performance.now();
         const simResult = this.simulator.simulate(this.rules.source, [testCase], {
             getDoc: (path) => this.state.get(path),
@@ -87,10 +93,11 @@ export class RulesReadEngine {
             };
         }
         const result = simResult.data.results[0];
+        const rulesEvidence = this.rules.captureEvidence(result);
         if (result.state === 'UNSUPPORTED') {
             this.emitRequest({
                 at: evalAt, evalMs, method: 'get', path, auth, result: 'unsupported',
-                debugMessages: renderLegacyDebugMessages(result), origin: 'listener',
+                rulesEvidence, debugMessages: renderLegacyDebugMessages(result), origin: 'listener',
                 ...(this.triggerScope.current() ? { triggeredBy: this.triggerScope.current() } : {}),
             });
             throw new SimulatorUnsupportedError(unsupportedMessage('get', path, renderLegacyDebugMessages(result)), 'get', path, renderLegacyDebugMessages(result));
@@ -112,6 +119,7 @@ export class RulesReadEngine {
             result: resultStr,
             debugMessages: renderLegacyDebugMessages(result),
             evaluatedRule: evalRule,
+            rulesEvidence,
             origin: 'listener',
             resourceBefore: { data, exists: isDataNotNull },
         };
@@ -175,8 +183,8 @@ export class RulesReadEngine {
             ? queryConstraintsForProof(execution)
             : {};
         const timing = {
-            requestTime: Timestamp.fromMillis(Date.now()),
-            at: Date.now(),
+            requestTime: Timestamp.fromMillis(this.clock.now()),
+            at: this.clock.now(),
         };
         const triggeredBy = this.triggerScope.current();
         if (bypassRules) {
@@ -190,6 +198,7 @@ export class RulesReadEngine {
                 constraints: structured,
                 bypassRules,
                 ...(constraints?.activityQuery ? { activityQuery: constraints.activityQuery } : {}),
+                execution,
                 origin: 'listener',
                 ...(triggeredBy ? { triggeredBy } : {}),
                 timing,
@@ -203,6 +212,7 @@ export class RulesReadEngine {
             auth,
             constraints: structured,
             ...(constraints?.activityQuery ? { activityQuery: constraints.activityQuery } : {}),
+            execution,
             origin: 'listener',
             ...(triggeredBy ? { triggeredBy } : {}),
             timing,
@@ -262,6 +272,7 @@ export class RulesReadEngine {
             constraints: proof,
             bypassRules,
             ...(activityQuery !== undefined ? { activityQuery } : {}),
+            execution,
             origin: 'user',
         });
         if (!authorization.allowed)

package/dist/firestore/sandbox/rules-read-engine.js.map

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

package/dist/firestore/sandbox/rules-state.d.ts

@@ -15,7 +15,12 @@
  * {@link set}.
  */
 import { type FirestoreRules } from 'pyric/rules/internal';
+import type { TestResult } from 'pyric/rules/internal';
+import type { RulesEvidence } from '../../sandbox/types/rules-evidence.js';
 export declare class RulesState {
+    private version;
+    captureEvidence(result: TestResult, scope?: RulesEvidence['scope']): RulesEvidence;
+    captureQueryEvidence(proof: import('../../sandbox/types/query-proof.js').QueryProofDiagnostic, residual?: RulesEvidence): RulesEvidence;
     private currentSource;
     /**
      * RULES-B11 — parsed-AST cache, keyed on the exact source string.

package/dist/firestore/sandbox/rules-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules-state.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/rules-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAA+D;gBAEtE,aAAa,EAAE,MAAM;IAIjC,2CAA2C;IAC3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,GAAG,IAAI,cAAc,GAAG,IAAI;CAS7B"}
+{"version":3,"file":"rules-state.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/rules-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAQ3E,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAkB;IAEjC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,GAAE,aAAa,CAAC,OAAO,CAAa,GAAG,aAAa;IAI7F,oBAAoB,CAAC,KAAK,EAAE,OAAO,oCAAoC,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,aAAa;IAIvI,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAA+D;gBAEtE,aAAa,EAAE,MAAM;IAIjC,2CAA2C;IAC3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKzB;;;OAGG;IACH,GAAG,IAAI,cAAc,GAAG,IAAI;CAS7B"}

package/dist/firestore/sandbox/rules-state.js

@@ -15,7 +15,21 @@
  * {@link set}.
  */
 import { parseToAST } from 'pyric/rules/internal';
+import { captureRulesEvidence, captureQueryEvidence } from './rules-evidence.js';
+// Diagnostic identity only; rules evaluation also works outside secure contexts.
+function rulesVersion() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function')
+        return crypto.randomUUID();
+    return `rules-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
 export class RulesState {
+    version = rulesVersion();
+    captureEvidence(result, scope = 'request') {
+        return captureRulesEvidence(result, this.version, scope);
+    }
+    captureQueryEvidence(proof, residual) {
+        return captureQueryEvidence(proof, this.version, residual);
+    }
     currentSource;
     /**
      * RULES-B11 — parsed-AST cache, keyed on the exact source string.
@@ -37,6 +51,8 @@ export class RulesState {
      * cached AST warm.
      */
     set(source) {
+        if (this.currentSource !== source)
+            this.version = rulesVersion();
         this.currentSource = source;
     }
     /**

package/dist/firestore/sandbox/rules-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules-state.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/rules-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAuB,MAAM,sBAAsB,CAAC;AAEvE,MAAM,OAAO,UAAU;IACb,aAAa,CAAS;IAE9B;;;;OAIG;IACK,WAAW,GAA0D,IAAI,CAAC;IAElF,YAAY,aAAqB;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,2CAA2C;IAC3C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAc;QAChB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,GAAG;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,GAAG;gBACjB,MAAM,EAAE,IAAI,CAAC,aAAa;gBAC1B,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;aACpC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"rules-state.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/rules-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAuB,MAAM,sBAAsB,CAAC;AAGvE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,iFAAiF;AACjF,SAAS,YAAY;IACnB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IACzG,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,OAAO,UAAU;IACb,OAAO,GAAG,YAAY,EAAE,CAAC;IAEjC,eAAe,CAAC,MAAkB,EAAE,QAAgC,SAAS;QAC3E,OAAO,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,oBAAoB,CAAC,KAAwE,EAAE,QAAwB;QACrH,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAEO,aAAa,CAAS;IAE9B;;;;OAIG;IACK,WAAW,GAA0D,IAAI,CAAC;IAElF,YAAY,aAAqB;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,2CAA2C;IAC3C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAc;QAChB,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM;YAAE,IAAI,CAAC,OAAO,GAAG,YAAY,EAAE,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,GAAG;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,GAAG;gBACjB,MAAM,EAAE,IAAI,CAAC,aAAa;gBAC1B,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;aACpC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;IAC9B,CAAC;CACF"}

package/dist/firestore/sandbox/snapshot-listeners.d.ts

@@ -11,6 +11,7 @@
  * section 4, section 5).
  */
 import type { DocumentData } from './local-state.js';
+import type { ListenerOwnerHint, RecordedListenerOwners } from '../../sandbox/attribution/listener-owners.js';
 import type { Operation } from './local-environment.js';
 import type { QueryExecutionSpec } from './query-execution.js';
 import type { QueryConstraints } from './list-query-proof.js';
@@ -76,9 +77,16 @@ export type SnapshotTarget = {
  * `LocalEnvironment.notifyDocListener` / `notifyQueryListener`. `fromCache`
  * remains constant `false` — the sandbox has no offline cache to serve from.
  */
-export interface SnapshotListenerOptions {
+export interface SnapshotListenerOptions extends RecordedListenerOwners {
     includeMetadataChanges?: boolean;
     source?: 'default' | 'cache';
+    /**
+     * Pyric's own extension, absent from the Firebase Web SDK: who owns this
+     * listener. A name, or the DOM element the listener feeds. Recorded as a
+     * `tag` owner on the `listener_attach` event and nowhere else. It changes
+     * nothing about what the listener delivers.
+     */
+    owner?: ListenerOwnerHint;
 }
 /**
  * Callback shape is a placeholder until Slice 2 introduces the public

package/dist/firestore/sandbox/snapshot-listeners.d.ts.map

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

package/dist/firestore/sandbox/snapshot-listeners.js.map

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

package/dist/firestore/sandbox/transaction-merge.d.ts

@@ -1,35 +1,4 @@
-/**
- * Item 1.3 — Same-path queued-write collapse.
- *
- * `TransactionContext` queues writes append-only (Item 1.2). Before
- * commit, ops at the same path collapse into a single operation so the
- * existing `LocalState.applyBatch` can run rules-eval + apply atomically
- * without per-call divergence.
- *
- * Probe 0.D verified `update + update` merges fields (last-wins per
- * field, earlier-but-non-overlapping fields preserved). The other
- * combinations are extrapolated from Admin SDK semantics:
- *
- *   set    + set        → second `set` wins (overwrite semantics).
- *   set    + update     → `set` with `{ ...set.data, ...update.data }`.
- *   set    + delete     → `delete` wins (the set never observable).
- *   create + update     → `create` with `{ ...create.data, ...update.data }`.
- *   create + set        → `set` wins (set overwrites, semantically a
- *                         fresh create-or-replace).
- *   create + delete     → `delete` wins (final state is gone).
- *   update + update     → ✅ probed: merged data.
- *   update + set        → `set` wins (set replaces entirely).
- *   update + delete     → `delete` wins.
- *   delete + ANYTHING   → THROW. Probe didn't cover; safer to error
- *                         than guess. Decisions Log: "delete + write
- *                         merge unprobed; v1 throws ambiguous".
- *
- * Output is `LocalState.BatchOperation[]` directly — that's what the
- * commit path (Item 2) feeds into `applyBatch`. Same-path entries
- * collapse into one entry; different paths preserve order of first
- * appearance (insertion order in the path map).
- */
-import type { BatchOperation } from './local-state.js';
+import type { BatchOperationInput } from './writes.js';
 import type { QueuedWrite } from './transaction-types.js';
 /**
  * Thrown when the queue contains a `delete` followed by another write
@@ -51,5 +20,5 @@ export declare class AmbiguousPostDeleteWriteError extends Error {
  *   data) and folds in subsequent writes per the table above.
  * - Throws `AmbiguousPostDeleteWriteError` on `delete + anything`.
  */
-export declare function mergeQueuedWrites(writes: readonly QueuedWrite[]): BatchOperation[];
+export declare function mergeQueuedWrites(writes: readonly QueuedWrite[]): BatchOperationInput[];
 //# sourceMappingURL=transaction-merge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction-merge.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAClB,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAW/C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,cAAc,EAAE,CAoBlF"}
+{"version":3,"file":"transaction-merge.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-merge.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAClB,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAW/C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAsBvF"}

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

@@ -1,3 +1,4 @@
+import { applyMerge } from './field-merge.js';
 /**
  * Thrown when the queue contains a `delete` followed by another write
  * at the same path. The combination is unprobed; v1 errors instead of
@@ -32,11 +33,13 @@ export function mergeQueuedWrites(writes) {
     const byPath = new Map();
     for (const w of writes) {
         const prior = byPath.get(w.path);
-        if (prior === undefined) {
+        const isFirstWrite = prior === undefined;
+        if (isFirstWrite) {
             byPath.set(w.path, toBatchOp(w));
             continue;
         }
-        if (prior.method === 'delete') {
+        const followsDelete = prior.method === 'delete';
+        if (followsDelete) {
             throw new AmbiguousPostDeleteWriteError(w.path, w.method);
         }
         byPath.set(w.path, fold(prior, w));
@@ -45,15 +48,21 @@ export function mergeQueuedWrites(writes) {
 }
 /** Convert a single queued write to its initial `BatchOperation` shape. */
 function toBatchOp(w) {
-    if (w.method === 'delete') {
+    const isDelete = w.method === 'delete';
+    if (isDelete) {
         return { method: 'delete', path: w.path };
     }
     // set / create / update all carry data; queue invariant.
-    if (w.data === undefined) {
+    const hasNoData = w.data === undefined;
+    if (hasNoData) {
         throw new Error(`internal: queued ${w.method} on ${w.path} has no data — ` +
             `Transaction class invariant violated`);
     }
-    return { method: w.method, path: w.path, data: w.data };
+    const operation = { method: w.method, path: w.path, data: w.data };
+    const hasMerge = w.merge !== undefined;
+    if (hasMerge)
+        operation.merge = w.merge;
+    return operation;
 }
 /**
  * Fold a new queued write into an existing same-path effective op.
@@ -65,9 +74,12 @@ function fold(prior, next) {
             // Anything-then-delete: final state is gone.
             return { method: 'delete', path: next.path };
         case 'set': {
-            // Anything-then-set: set replaces entirely. The earlier op is
-            // semantically erased (Admin's set is overwrite).
             const data = requireData(next);
+            const mergesFields = next.merge === true;
+            if (mergesFields) {
+                return { ...prior, data: applyMerge(prior.data ?? {}, data) };
+            }
+            // A set without merge replaces the earlier write entirely.
             return { method: 'set', path: next.path, data };
         }
         case 'update': {

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

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

package/dist/firestore/sandbox/transaction-types.d.ts

@@ -9,19 +9,18 @@
  *   - 0.C: `tx.getAll(...paths)` returns snapshots in input order.
  *   - 0.A + 0.J: read-before-write ordering is GLOBAL — any write method
  *     flips a per-tx flag; subsequent reads throw `failed-precondition`.
- *   - 0.D: same-path multi-write merges on commit (last-wins per field).
- *     The merge happens at commit time in `transaction-merge.ts`; the
- *     queue here is append-only.
+ *   - 0.D: same-path writes resolve in queue order at commit. Results
+ *     summarize each path after execution; the queue is append-only.
  *   - 0.G: callback exceptions propagate unchanged. The result types
  *     here only describe the *successful* (or rule-denied) path; thrown
  *     errors don't construct a `TransactionResult`.
- *   - 0.H: no `retries` field. Single-threaded simulator can't trigger
- *     conflicts. Documented as a known limitation.
+ *   - Read conflicts retry the callback up to `maxAttempts`.
  */
 import type { DocumentData } from './local-state.js';
 import type { AgentEvent } from './event-log.js';
 import type { FirestoreSimError } from './errors.js';
 import type { EventProvenance } from '../../sandbox/types/events.js';
+import type { BatchOperationInput, Operation } from './writes.js';
 /**
  * Snapshot shape returned by `tx.get` / `tx.getAll`. Matches the Admin
  * SDK's `DocumentSnapshot` surface narrowly enough for the rules-eval
@@ -47,23 +46,15 @@ export interface CapturedRead {
     data: DocumentData | null;
 }
 /**
- * Internal — a queued write before merge/commit. Carries the original
- * call method so `transaction-merge.ts` can collapse same-path entries
- * with the right semantics (`update + update` merges; `set + update`
- * applies update on top of set; etc.).
+ * Internal — a queued write before commit. Keeps the original method,
+ * data and mask until the shared atomic pipeline resolves it in order.
  */
-export interface QueuedWrite {
-    method: 'set' | 'create' | 'update' | 'delete';
-    path: string;
-    data?: DocumentData;
-}
+export type QueuedWrite = BatchOperationInput;
 /**
  * Caller surface for `Transaction`. Implementation lives in
  * `transaction.ts`; this interface is what callbacks see.
  *
- * `set` is included even though `BatchOperationInput` doesn't expose
- * it — the Admin SDK's transaction does, and the merge layer collapses
- * `set` into the appropriate `BatchOperation` at commit.
+ * The queued writes retain the same intent as batch inputs until commit.
  */
 export interface Transaction {
     /** Admin-mode read; never evaluates rules. */
@@ -71,7 +62,7 @@ export interface Transaction {
     /** Admin-mode batched read; preserves input order. */
     getAll(...paths: string[]): TransactionSnapshot[];
     /** Queue a `set` (overwrite-or-create). Flips writeStarted. */
-    set(path: string, data: DocumentData): void;
+    set(path: string, data: DocumentData, merge?: Operation['merge']): void;
     /** Queue a `create` (fail-on-exists at commit). Flips writeStarted. */
     create(path: string, data: DocumentData): void;
     /** Queue an `update` (fail-if-missing at commit). Flips writeStarted. */
@@ -118,9 +109,8 @@ export interface TransactionOptions {
  * violation) do NOT produce a `TransactionResult` — they propagate.
  *
  * `reads` is included for diagnostic value (production doesn't surface
- * this; we do). `writes` is one entry per *queued* write at the time
- * of commit, post-merge — so two `update` calls to the same path
- * produce one `writes[]` entry, not two.
+ * this; we do). `writes` summarizes each path after execution, so two
+ * `update` calls to the same path produce one `writes[]` entry.
  */
 export interface TransactionResult<R = unknown> {
     /** True iff every queued write passed rules and applied. */

package/dist/firestore/sandbox/transaction-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-types.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,IAAI,YAAY,GAAG,SAAS,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,sDAAsD;IACtD,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAElD,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,uEAAuE;IACvE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,EAAE,CAAC;IACJ,0EAA0E;IAC1E,WAAW,EAAE,CAAC,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,+EACyC,CAAC"}
+{"version":3,"file":"transaction-types.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,IAAI,YAAY,GAAG,SAAS,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,sDAAsD;IACtD,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAElD,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACxE,uEAAuE;IACvE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,EAAE,CAAC;IACJ,0EAA0E;IAC1E,WAAW,EAAE,CAAC,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,+EACyC,CAAC"}

package/dist/firestore/sandbox/transaction-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-types.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-types.ts"],"names":[],"mappings":"AAwJA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,4EAA4E,CAAC"}
+{"version":3,"file":"transaction-types.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-types.ts"],"names":[],"mappings":"AA8IA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,4EAA4E,CAAC"}

package/dist/firestore/sandbox/transaction-write-executor.d.ts

@@ -1,6 +1,6 @@
 import type { Transaction, TransactionOptions, TransactionResult } from './transaction-types.js';
 import { WriteRuntime } from './write-runtime.js';
-/** Adapts transaction callbacks, merge semantics, and results to the atomic pipeline. */
+/** Adapts transaction callbacks, ordered writes, and results to the atomic pipeline. */
 export declare class TransactionWriteExecutor {
     private readonly runtime;
     private readonly pipeline;
@@ -10,6 +10,7 @@ export declare class TransactionWriteExecutor {
     private runAttempt;
     private retryOrThrow;
     private commitTransaction;
+    private summarizeWrites;
     private logAbortedTransaction;
 }
 //# sourceMappingURL=transaction-write-executor.d.ts.map

package/dist/firestore/sandbox/transaction-write-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-write-executor.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-write-executor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,yFAAyF;AACzF,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAElB,OAAO,EAAE,YAAY;IAIlD,WAAW,CAAC,CAAC,EACX,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,WAAW,CAAC,CAAC,EACX,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,CAAC,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC,CAAC,CAAC;IAQvB,OAAO,CAAC,UAAU;IAmDlB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,iBAAiB;IA2JzB,OAAO,CAAC,qBAAqB;CAuB9B"}
+{"version":3,"file":"transaction-write-executor.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/transaction-write-executor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,wFAAwF;AACxF,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAElB,OAAO,EAAE,YAAY;IAIlD,WAAW,CAAC,CAAC,EACX,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACnC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,WAAW,CAAC,CAAC,EACX,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,CAAC,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CAAC,CAAC,CAAC;IAQvB,OAAO,CAAC,UAAU;IAqDlB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,iBAAiB;IA+JzB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,qBAAqB;CA0B9B"}