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

package/dist/firestore/sandbox/write-engine.js

@@ -8,13 +8,17 @@ import { walkForSentinels } from './sentinel-capture.js';
 import { WriteRuntime } from './write-runtime.js';
 import { BatchWriteExecutor } from './batch-write-executor.js';
 import { TransactionWriteExecutor } from './transaction-write-executor.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 /** Rules-aware Firestore write policy behind the stable LocalEnvironment facade. */
 export class WriteEngine {
     runtime;
     batches;
     transactions;
-    constructor(host, rules, simulator, eventLog, events, triggerScope) {
-        this.runtime = new WriteRuntime(host, rules, simulator, eventLog, events, triggerScope);
+    constructor(host, rules, simulator, eventLog, events, triggerScope, 
+    /** 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.runtime = new WriteRuntime(host, rules, simulator, eventLog, events, triggerScope, clock);
         this.batches = new BatchWriteExecutor(this.runtime);
         this.transactions = new TransactionWriteExecutor(this.runtime);
     }
@@ -64,9 +68,9 @@ export class WriteEngine {
         // `request.time`) must see field-equal values, otherwise rules like
         // `data.createdAt == request.time` flake on sub-millisecond drift.
         // Replay engine: `operation.requestTime` (when provided) overrides
-        // Date.now() so the rule eval re-evaluates against the captured
-        // wall-clock instant, eliminating time-drift on replay.
-        const serverTime = pinnedRequestTime ?? Timestamp.fromMillis(Date.now());
+        // the sandbox clock so the rule eval re-evaluates against the captured
+        // instant, eliminating time-drift on replay.
+        const serverTime = pinnedRequestTime ?? Timestamp.fromMillis(this.runtime.clock.now());
         // Resolve the write payload BEFORE rule evaluation so rules see the
         // same shape storage will see (Item 0: write-boundary value-resolve).
         // LocalState will resolve again in applyWrite — converters are
@@ -106,7 +110,7 @@ export class WriteEngine {
             // engine but the user's op still produced a denial. evalMs is 0
             // because no simulate call happened.
             this.runtime.emitRequest({
-                at: Date.now(), evalMs: 0, method, path, auth, result: 'deny',
+                at: this.runtime.clock.now(), evalMs: 0, method, path, auth, result: 'deny',
                 debugMessages: [`FieldValue resolve error: ${msg}`],
                 ...(resolvedData ? { resourceData: resolvedData } : data ? { resourceData: data } : {}),
                 resourceBefore: { data: snapshot[path] ?? null, exists: (snapshot[path] ?? null) !== null },
@@ -125,7 +129,7 @@ export class WriteEngine {
         }
         const testCase = this.runtime.buildTestCase({ ...operation, data: resolvedData }, serverTime);
         // Issue #307 — time the simulate call for RequestEvent.evalMs.
-        const evalAt = Date.now();
+        const evalAt = this.runtime.clock.now();
         const evalStart = performance.now();
         const simResult = this.runtime.runSimulate([testCase], bypassRules);
         const evalMs = performance.now() - evalStart;
@@ -154,9 +158,11 @@ export class WriteEngine {
             };
         }
         const result = simResult.data.results[0];
+        const rulesEvidence = this.runtime.captureEvidence(result);
         if (result.state === 'UNSUPPORTED') {
             this.runtime.emitRequest({
                 at: evalAt, evalMs, method, path, auth, result: 'unsupported',
+                rulesEvidence,
                 debugMessages: renderLegacyDebugMessages(result),
                 ...(data ? { resourceData: data } : {}),
                 resourceBefore: { data: snapshot[path] ?? null, exists: (snapshot[path] ?? null) !== null },
@@ -257,6 +263,7 @@ export class WriteEngine {
             result: isAllowed ? 'allow' : 'deny',
             debugMessages: renderLegacyDebugMessages(result),
             evaluatedRule: projectEvaluatedRule(result),
+            rulesEvidence,
             ...(data ? { resourceData: data } : {}),
             resourceBefore: { data: priorDoc, exists: priorDoc !== null },
             ...(method !== 'delete'

package/dist/firestore/sandbox/write-engine.js.map

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

package/dist/firestore/sandbox/write-runtime.d.ts

@@ -1,4 +1,4 @@
-import type { DocStore, DocumentData } from './local-state.js';
+import type { BatchOperation, DocStore, DocumentData } from './local-state.js';
 import type { SimulateFirestoreRulesHandler, TestCase, TestFirestoreRulesResult, Timestamp } from 'pyric/rules/internal';
 import type { RulesState } from './rules-state.js';
 import type { EventLog } from './event-log.js';
@@ -9,6 +9,7 @@ import type { Operation } from './writes.js';
 import type { EventProvenance } from '../../sandbox/types/events.js';
 import { type EmitRequestInput } from './request-events.js';
 import type { SentinelHit } from './sentinel-capture.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 export interface WriteRuntimeHost {
     readonly state: DocStore;
     notifyListenersForPaths(paths: Set<string>): void;
@@ -21,7 +22,13 @@ export declare class WriteRuntime {
     readonly eventLog: EventLog;
     private readonly events;
     private readonly triggerScope;
-    constructor(host: WriteRuntimeHost, rules: RulesState, simulator: SimulateFirestoreRulesHandler, eventLog: EventLog, events: FirestoreEventBus, triggerScope: TriggerScope);
+    /** The sandbox's clock, read for every server-set time this produces.
+     *  Defaults to a private wall clock for a standalone construction. */
+    readonly clock: SandboxClock;
+    constructor(host: WriteRuntimeHost, rules: RulesState, simulator: SimulateFirestoreRulesHandler, eventLog: EventLog, events: FirestoreEventBus, triggerScope: TriggerScope, 
+    /** The sandbox's clock, read for every server-set time this produces.
+     *  Defaults to a private wall clock for a standalone construction. */
+    clock?: SandboxClock);
     get state(): DocStore;
     emitDenial(error: FirestoreSimError): void;
     emitRequest(input: EmitRequestInput): void;
@@ -43,12 +50,13 @@ export declare class WriteRuntime {
         provenance?: EventProvenance;
     }): void;
     capturePriors(paths: readonly string[]): Record<string, DocumentData | null>;
+    captureEvidence(result: import('pyric/rules/internal').TestResult): import("../../sandbox/types/rules-evidence.js").RulesEvidence;
     runSimulate(testCases: TestCase[], bypassRules: boolean | undefined, batchProjection?: Map<string, DocumentData | null>): TestFirestoreRulesResult;
-    private isReadOnlyMethod;
     private resolvePriorDocumentState;
     private computeProjectedUpdate;
     private computeProjectedOverwrite;
-    buildBatchProjection(testCases: TestCase[]): Map<string, DocumentData | null>;
+    /** Project write intent before the rules vocabulary reduces set to create/update. */
+    buildBatchProjection(operations: BatchOperation[], projection?: Map<string, DocumentData | null>): Map<string, DocumentData | null>;
     buildTestCase(operation: Operation, serverTime?: Timestamp): TestCase;
     notify(method: string, path: string, touched: Set<string>): void;
 }

package/dist/firestore/sandbox/write-runtime.d.ts.map

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

package/dist/firestore/sandbox/write-runtime.js

@@ -1,8 +1,9 @@
-import { applyMerge } from './field-merge.js';
+import { applyMerge, applyUpdate } from './field-merge.js';
 import { buildRequestEvent, nextRequestEventId } from './request-events.js';
 import { buildRulesTestCase } from './rules-test-case.js';
 import { simulateRules } from './rules-simulator.js';
-import { registerDefaultConverters } from './value-resolver.js';
+import { partitionDeletes, registerDefaultConverters } from './value-resolver.js';
+import { SandboxClock } from '../../sandbox/clock.js';
 registerDefaultConverters();
 /** Shared rules, event, state, and notification policy for atomic write executors. */
 export class WriteRuntime {
@@ -12,13 +13,18 @@ export class WriteRuntime {
     eventLog;
     events;
     triggerScope;
-    constructor(host, rules, simulator, eventLog, events, triggerScope) {
+    clock;
+    constructor(host, rules, simulator, eventLog, events, triggerScope, 
+    /** 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.host = host;
         this.rules = rules;
         this.simulator = simulator;
         this.eventLog = eventLog;
         this.events = events;
         this.triggerScope = triggerScope;
+        this.clock = clock;
     }
     get state() {
         return this.host.state;
@@ -27,89 +33,117 @@ export class WriteRuntime {
         this.events.denial.emit(error);
     }
     emitRequest(input) {
-        if (!this.events.request.hasSubscribers)
+        const hasNoSubscribers = !this.events.request.hasSubscribers;
+        if (hasNoSubscribers)
             return;
         this.events.request.emit(buildRequestEvent(input));
     }
     emitWrite(input) {
-        if (!this.events.write.hasSubscribers)
+        const hasNoSubscribers = !this.events.write.hasSubscribers;
+        if (hasNoSubscribers)
             return;
-        this.events.write.emit({
+        const event = {
             kind: 'write',
             id: nextRequestEventId().replace(/^req-/, 'wr-'),
-            at: Date.now(),
+            at: this.clock.now(),
             method: input.method,
             path: input.path,
-            auth: input.auth
-                ? { uid: input.auth.uid, ...(input.auth.token ? { token: input.auth.token } : {}) }
-                : null,
-            ...(input.data !== undefined ? { data: input.data } : {}),
+            auth: null,
             priorState: input.priorState,
             nextState: input.nextState,
-            ...(input.groupId !== undefined ? { groupId: input.groupId } : {}),
-            ...(input.groupKind !== undefined ? { groupKind: input.groupKind } : {}),
-            ...(input.sentinels && input.sentinels.length > 0 ? { sentinels: input.sentinels } : {}),
-            ...(input.autoId !== undefined ? { autoId: input.autoId } : {}),
             requestTime: { seconds: input.requestTime.seconds, nanoseconds: input.requestTime.nanos },
-            ...(input.detail !== undefined ? { detail: input.detail } : {}),
-            ...(input.provenance ?? {}),
-        });
+        };
+        const { auth } = input;
+        const hasAuth = auth !== null;
+        if (hasAuth) {
+            event.auth = { uid: auth.uid };
+            const hasToken = Boolean(auth.token);
+            if (hasToken)
+                event.auth.token = auth.token;
+        }
+        const hasData = input.data !== undefined;
+        if (hasData)
+            event.data = input.data;
+        const hasGroupId = input.groupId !== undefined;
+        if (hasGroupId)
+            event.groupId = input.groupId;
+        const hasGroupKind = input.groupKind !== undefined;
+        if (hasGroupKind)
+            event.groupKind = input.groupKind;
+        const hasSentinels = input.sentinels !== undefined && input.sentinels.length > 0;
+        if (hasSentinels)
+            event.sentinels = input.sentinels;
+        const hasAutoId = input.autoId !== undefined;
+        if (hasAutoId)
+            event.autoId = input.autoId;
+        const hasDetail = input.detail !== undefined;
+        if (hasDetail)
+            event.detail = input.detail;
+        this.events.write.emit({ ...event, ...input.provenance });
     }
     capturePriors(paths) {
         const priors = {};
         for (const path of paths) {
             const prior = this.state.get(path);
-            priors[path] = prior ? { ...prior } : null;
+            const documentExists = prior !== null;
+            priors[path] = documentExists ? { ...prior } : null;
         }
         return priors;
     }
+    captureEvidence(result) {
+        return this.rules.captureEvidence(result);
+    }
     runSimulate(testCases, bypassRules, batchProjection) {
         return simulateRules(this.state, this.rules, this.simulator, testCases, bypassRules, batchProjection);
     }
-    isReadOnlyMethod(method) {
-        return method === 'get' || method === 'list';
-    }
     resolvePriorDocumentState(path, projection, databaseState) {
-        if (projection.has(path)) {
+        const hasProjection = projection.has(path);
+        if (hasProjection) {
             const projectedState = projection.get(path);
             return projectedState ?? null;
         }
-        if (databaseState.exists(path)) {
+        const documentExists = databaseState.exists(path);
+        if (documentExists) {
             const existingDatabaseState = databaseState.get(path);
             return existingDatabaseState ?? null;
         }
         return null;
     }
     computeProjectedUpdate(priorState, incomingData) {
-        if (priorState === null) {
+        const documentMissing = priorState === null;
+        if (documentMissing) {
             return null;
         }
         const effectiveIncomingData = incomingData ?? {};
-        return applyMerge(priorState, effectiveIncomingData);
+        return applyUpdate(priorState, effectiveIncomingData);
     }
     computeProjectedOverwrite(priorState, incomingData) {
         const baseState = priorState ?? {};
         const effectiveIncomingData = incomingData ?? {};
         return applyMerge(baseState, effectiveIncomingData);
     }
-    buildBatchProjection(testCases) {
-        const projection = new Map();
-        for (const testCase of testCases) {
-            if (this.isReadOnlyMethod(testCase.method)) {
+    /** Project write intent before the rules vocabulary reduces set to create/update. */
+    buildBatchProjection(operations, projection = new Map()) {
+        for (const operation of operations) {
+            const isReplacement = operation.method === 'set';
+            if (isReplacement) {
+                projection.set(operation.path, partitionDeletes(operation.data ?? {}).writes);
                 continue;
             }
-            if (testCase.method === 'delete') {
-                projection.set(testCase.path, null);
+            const isDelete = operation.method === 'delete';
+            if (isDelete) {
+                projection.set(operation.path, null);
                 continue;
             }
-            const priorState = this.resolvePriorDocumentState(testCase.path, projection, this.state);
-            if (testCase.method === 'update') {
-                const updatedDocument = this.computeProjectedUpdate(priorState, testCase.data);
-                projection.set(testCase.path, updatedDocument);
+            const priorState = this.resolvePriorDocumentState(operation.path, projection, this.state);
+            const isUpdate = operation.method === 'update';
+            if (isUpdate) {
+                const updatedDocument = this.computeProjectedUpdate(priorState, operation.data);
+                projection.set(operation.path, updatedDocument);
             }
             else {
-                const overwrittenDocument = this.computeProjectedOverwrite(priorState, testCase.data);
-                projection.set(testCase.path, overwrittenDocument);
+                const overwrittenDocument = this.computeProjectedOverwrite(priorState, operation.data);
+                projection.set(operation.path, overwrittenDocument);
             }
         }
         return projection;

package/dist/firestore/sandbox/write-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-runtime.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/write-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAc9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAyB,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,yBAAyB,EAAE,CAAC;AAO5B,sFAAsF;AACtF,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IACR;IACQ;IACA;IANnB,YACmB,IAAsB,EACtB,KAAiB,EACjB,SAAwC,EAChD,QAAkB,EACV,MAAyB,EACzB,YAA0B;QAL1B,SAAI,GAAJ,IAAI,CAAkB;QACtB,UAAK,GAAL,KAAK,CAAY;QACjB,cAAS,GAAT,SAAS,CAA+B;QAChD,aAAQ,GAAR,QAAQ,CAAU;QACV,WAAM,GAAN,MAAM,CAAmB;QACzB,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAEJ,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,KAAwB;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,KAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,KAcT;QACC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc;YAAE,OAAO;QAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,kBAAkB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;YAChD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBACd,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBACnF,CAAC,CAAC,IAAI;YACR,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;YACzF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,KAAwB;QACpC,MAAM,MAAM,GAAwC,EAAE,CAAC;QACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CACT,SAAqB,EACrB,WAAgC,EAChC,eAAkD;QAElD,OAAO,aAAa,CAClB,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,SAAS,EACT,WAAW,EACX,eAAe,CAChB,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,MAAc;QACrC,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC;IAC/C,CAAC;IAEO,yBAAyB,CAC/B,IAAY,EACZ,UAA4C,EAC5C,aAAuB;QAEvB,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,cAAc,IAAI,IAAI,CAAC;QAChC,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,qBAAqB,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO,qBAAqB,IAAI,IAAI,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,sBAAsB,CAC5B,UAA+B,EAC/B,YAAsC;QAEtC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,qBAAqB,GAAG,YAAY,IAAI,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IACvD,CAAC;IAEO,yBAAyB,CAC/B,UAA+B,EAC/B,YAAsC;QAEtC,MAAM,SAAS,GAAG,UAAU,IAAI,EAAE,CAAC;QACnC,MAAM,qBAAqB,GAAG,YAAY,IAAI,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACtD,CAAC;IAED,oBAAoB,CAAC,SAAqB;QACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3C,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzF,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC/E,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,mBAAmB,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACtF,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,SAAoB,EAAE,UAAsB;QACxD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,IAAY,EAAE,OAAoB;QACvD,IAAI,CAAC,YAAY,CAAC,GAAG,CACnB,EAAE,MAAM,EAAE,IAAI,EAAE,EAChB,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CACjD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"write-runtime.js","sourceRoot":"","sources":["../../../src/firestore/sandbox/write-runtime.ts"],"names":[],"mappings":"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"}

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

@@ -75,9 +75,11 @@ export interface OperationResult {
     error?: FirestoreSimError;
 }
 export interface BatchOperationInput {
-    method: 'create' | 'update' | 'delete';
+    /** `set` replaces data; its create/update rule is selected at commit. */
+    method: 'create' | 'update' | 'set' | 'delete';
     path: string;
     data?: DocumentData;
+    merge?: Operation['merge'];
 }
 export interface BatchResult {
     allowed: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/writes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChE,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,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;oDAIgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;yDAIqD;IACrD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;;;2EAKuE;IACvE,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACrD;;;;;;;;;;8DAU0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG;IAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG;IACvC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,iEAAiE;QACjE,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,EAAE,CAAC;IACJ,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B"}
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/writes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAChE,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,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;oDAIgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;yDAIqD;IACrD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;;;2EAKuE;IACvE,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IACrD;;;;;;;;;;8DAU0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG;IAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG;IACvC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,iEAAiE;QACjE,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC3B,EAAE,CAAC;IACJ,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B"}

package/dist/firestore/sdk-activity.d.ts

@@ -0,0 +1,8 @@
+import { type SdkActivityRecord, type SdkActivityHandle } from '../sandbox/internal/sdk-activity.js';
+import { type ListenerAttribution } from '../sandbox/attribution/listener-owners.js';
+import { type Target } from './state.js';
+/** One public invocation, independent of backend reads and listener reauthorization. */
+export declare function beginFirestoreActivity(target: Target, ref: object, method: string, kind: SdkActivityRecord['kind'], attribution?: ListenerAttribution): SdkActivityHandle;
+/** Batch/transaction identity is the app database, not an arbitrary first document. */
+export declare function beginFirestoreGroupActivity(target: Target, method: string): SdkActivityHandle;
+//# sourceMappingURL=sdk-activity.d.ts.map

package/dist/firestore/sdk-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-activity.d.ts","sourceRoot":"","sources":["../../src/firestore/sdk-activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAClH,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAC3G,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAGvD,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,WAAW,CAAC,EAAE,mBAAmB,GAChC,iBAAiB,CAYnB;AAED,uFAAuF;AACvF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAG7F"}

package/dist/firestore/sdk-activity.js

@@ -0,0 +1,23 @@
+import { sdkActivity } from '../sandbox/internal/sdk-activity.js';
+import { listenerAttachOwners } from '../sandbox/attribution/listener-owners.js';
+import { underlyingOf } from './state.js';
+/** One public invocation, independent of backend reads and listener reauthorization. */
+export function beginFirestoreActivity(target, ref, method, kind, attribution) {
+    const raw = underlyingOf(ref);
+    const source = typeof raw.sdkActivitySource === 'function'
+        ? raw.sdkActivitySource()
+        : { service: 'firestore', target: raw.path, key: `doc:${raw.path}` };
+    return sdkActivity.begin({
+        app: target.activityApp ?? target,
+        source,
+        method,
+        kind,
+        owners: listenerAttachOwners(attribution?.owner, attribution?.owners),
+    });
+}
+/** Batch/transaction identity is the app database, not an arbitrary first document. */
+export function beginFirestoreGroupActivity(target, method) {
+    return sdkActivity.begin({ app: target.activityApp ?? target, method, kind: 'operation',
+        source: { service: 'firestore', target: '/', key: 'database' } });
+}
+//# sourceMappingURL=sdk-activity.js.map

package/dist/firestore/sdk-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-activity.js","sourceRoot":"","sources":["../../src/firestore/sdk-activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,qCAAqC,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAA4B,MAAM,2CAA2C,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAGvD,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,GAAW,EACX,MAAc,EACd,IAA+B,EAC/B,WAAiC;IAEjC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAkC,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU;QACxD,CAAC,CAAC,GAAG,CAAC,iBAAiB,EAAE;QACzB,CAAC,CAAC,EAAE,OAAO,EAAE,WAAoB,EAAE,MAAM,EAAE,GAAG,CAAC,IAAK,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IACjF,OAAO,WAAW,CAAC,KAAK,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM;QACjC,MAAM;QACN,MAAM;QACN,IAAI;QACJ,MAAM,EAAE,oBAAoB,CAAC,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC;KACtE,CAAC,CAAC;AACL,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CAAC,MAAc,EAAE,MAAc;IACxE,OAAO,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW;QACrF,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/firestore/snapshots.d.ts

@@ -28,12 +28,28 @@ export declare function recordQuerySnapshot(snapshot: object, rawSnapshot: objec
  * Other surface (id / ref / exists) passes through unchanged so
  * `tagSnapshotRefs` still operates on the original snap object.
  */
-export declare function wrapSandboxDocSnap<T>(snap: object, target?: Target): DocumentSnapshot<T>;
+export declare function wrapSandboxDocSnap<T>(snap: object, target?: Target): DocumentSnapshot<T> & {
+    exists(): boolean;
+};
 /**
  * Wrap a plain sandbox `DocumentSnapshot` so `.data()` runs the
  * converter's `fromFirestore`. Identity / `exists` pass through.
  */
-export declare function applyConverterToDocSnap<AppModel>(snap: ChainDocSnap, conv: FirestoreDataConverter<AppModel>, target: Target, kind: 'document' | 'query-child'): DocumentSnapshot<AppModel>;
+export declare function applyConverterToDocSnap<AppModel>(snap: ChainDocSnap, conv: FirestoreDataConverter<AppModel>, target: Target, kind: 'document' | 'query-child'): DocumentSnapshot<AppModel> & {
+    exists(): boolean;
+};
+/**
+ * Run a converter over a snapshot a listener is about to deliver, in place.
+ *
+ * The sandbox builds one snapshot object per document and hands that same
+ * object to both `docs` and `docChanges()`, so converting the object covers
+ * both views. `data()` is re-read through the converter and `ref` gains the
+ * converter, matching what the read path returns.
+ *
+ * Call after {@link wrapSandboxDocSnap}: the captured accessor already yields
+ * finalized values, which is what `fromFirestore` expects to receive.
+ */
+export declare function applyConverterToDeliveredSnap(snapshot: object, conv: FirestoreDataConverter<unknown>, target: Target, kind: 'document' | 'query-child'): void;
 /**
  * Walk a snapshot and tag every ref-shaped field in `refToTarget`,
  * AND normalize `.exists` to method form so consumer code targeting

package/dist/firestore/snapshots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/firestore/snapshots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,IAAI,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAEzG,OAAO,EAQL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AASpB,OAAO,KAAK,EACV,gBAAgB,EAEhB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAYpB;;;4EAG4E;AAC5E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAG3E;AAsDD,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAczE;AAgED;wEACwE;AACxE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,UAAU,GAC1B,IAAI,CAoCN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAkBxF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAC9C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,aAAa,GAC/B,gBAAgB,CAAC,QAAQ,CAAC,CAqC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAsCtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,EAAE,MAAM,GACb,IAAI,CAyBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;CACpC,GAAG,IAAI,CAiBP"}
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/firestore/snapshots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,IAAI,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAEzG,OAAO,EASL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAWpB,OAAO,KAAK,EACV,gBAAgB,EAEhB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAYpB;;;4EAG4E;AAC5E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAG3E;AAsDD,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAczE;AAgED;wEACwE;AACxE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,UAAU,GAC1B,IAAI,CAoCN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,IAAI,OAAO,CAAA;CAAE,CA6BhH;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAC9C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,aAAa,GAC/B,gBAAgB,CAAC,QAAQ,CAAC,GAAG;IAAE,MAAM,IAAI,OAAO,CAAA;CAAE,CAsCpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC,EACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,aAAa,GAC/B,IAAI,CAiCN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAsCtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,EAAE,MAAM,GACb,IAAI,CAyBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE;IACnC,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;CACpC,GAAG,IAAI,CAiBP"}