pyric 0.0.1 → 0.1.0-alpha.8

package/dist/sandbox/firestore/value-resolver.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Write-boundary value resolver — central pass that runs over every value
+ * tree about to enter {@link LocalState}.
+ *
+ * Why this exists:
+ *   The simulator stores plain JS objects but agents seed/write values
+ *   that need normalization before either rules or storage see them:
+ *     - `Date` / `Timestamp` instances must round-trip with the right
+ *       wire type (Item 1).
+ *     - `serverTimestamp()`, `increment()`, `arrayUnion/Remove()`,
+ *       `deleteField()` sentinels must be resolved against prior doc
+ *       state (Item 2).
+ *     - `DocumentReference`, `VectorValue` need wrapper conversion
+ *       (Items 3, 5).
+ *
+ *   Doing each of these in five different write methods is a recipe for
+ *   drift. Item 0 introduces a single chokepoint: every value about to
+ *   land in storage passes through {@link resolveValueTree} first.
+ *
+ * Design — registry of converters:
+ *   Items 1, 2, 3, 5 each register a {@link ValueConverter}. Converters
+ *   inspect a value and either substitute it (returning the replacement)
+ *   or decline (returning {@link KEEP}). The resolver tries converters in
+ *   registration order; if none claim the value, plain objects and arrays
+ *   are walked recursively. Class instances the resolver doesn't recognize
+ *   pass through unchanged.
+ *
+ * Idempotency contract:
+ *   Every converter MUST no-op on its own output. This lets multiple
+ *   layers (LocalEnvironment.execute pre-rules, LocalState.write
+ *   pre-storage) call the resolver without double-applying conversions.
+ *   The Item 0 test contract verifies the empty-registry case is itself
+ *   idempotent.
+ *
+ * Today (Item 0) the registry is empty — the resolver is an identity
+ * walk. Wiring is in place so Items 1+ are pure additions.
+ */
+export type DocumentData = Record<string, unknown>;
+/** Operation that triggered the resolve. Converters can branch on this. */
+export type ResolveMethod = 'seed' | 'create' | 'update' | 'set';
+export interface ResolveContext {
+    /** Doc path being written (e.g., `users/u1`). */
+    path: string;
+    /** Method that triggered the resolve. */
+    method: ResolveMethod;
+    /** Prior doc state at `path`, or `null` if the doc did not exist. */
+    prior: DocumentData | null;
+    /**
+     * Dotted field path inside the doc; empty string for the root map.
+     * Array indices are bracketed: `tags[0]`, `users.profile.name`.
+     * Used by sentinel converters that need to read prior at the right
+     * field (e.g., `increment` reads `prior.<fieldPath>`).
+     */
+    fieldPath: string;
+    /**
+     * Server time for this write, if the caller wants every
+     * `serverTimestamp()` sentinel in the tree to resolve to the SAME
+     * Timestamp instance. `LocalEnvironment.execute` plumbs this in (Item 1)
+     * so `request.resource.data.createdAt == request.time` works
+     * deterministically. Direct `LocalState.write` calls leave it
+     * undefined; sentinel converters fall back to `Timestamp.fromMillis(
+     * Date.now())` per call.
+     *
+     * Type is `unknown` here to keep the resolver core decoupled from
+     * the wrappers package. Converters cast as needed.
+     */
+    serverTime?: unknown;
+}
+/**
+ * Sentinel returned by converters that decline to claim a value. Using a
+ * Symbol rather than `undefined` lets converters legitimately substitute
+ * `undefined` if they ever need to (e.g., `deleteField()` resolution).
+ */
+export declare const KEEP: unique symbol;
+export type Keep = typeof KEEP;
+/**
+ * Sentinel substituted by the deleteField converter (Item 2). The
+ * resolver returns this in place of `{ __type: 'deleteField' }`; the
+ * write layer ({@link partitionDeletes}) then strips these markers
+ * out of the value tree and surfaces the affected top-level keys to
+ * `LocalState` so the existing field is removed from storage.
+ *
+ * Why a symbol rather than another `__type` object: it cannot
+ * accidentally collide with user data, it survives a structuredClone-
+ * free copy intact (the resolver doesn't clone its outputs), and it
+ * makes idempotency trivial — the converter only matches the sentinel
+ * shape, never the marker.
+ */
+export declare const DELETE_MARKER: unique symbol;
+export type DeleteMarker = typeof DELETE_MARKER;
+export interface ValueConverter {
+    /** Name surfaced in diagnostics; must be unique across registrations. */
+    name: string;
+    /**
+     * Inspect a value. Return any value to substitute it (the resolver
+     * does NOT descend into the substituted value — converters own their
+     * output). Return {@link KEEP} to decline; the resolver tries the next
+     * converter, then descends into containers.
+     */
+    convert(value: unknown, ctx: ResolveContext): unknown | Keep;
+}
+/**
+ * Register a converter. Idempotent on `name` — re-registering the same
+ * named converter is a no-op. Item modules register their converters via
+ * {@link registerDefaultConverters} on simulator startup.
+ */
+export declare function registerConverter(c: ValueConverter): void;
+/** For tests only — clears the registry. Production code never calls this. */
+export declare function _clearConvertersForTest(): void;
+/** Snapshot of registered converter names. Diagnostics + test introspection. */
+export declare function listConverters(): string[];
+/**
+ * Resolve a full document tree. Walks each top-level field with the
+ * resolver, returning a new object — never mutates input.
+ */
+export declare function resolveValueTree(data: DocumentData, ctx: Omit<ResolveContext, 'fieldPath'>): DocumentData;
+/**
+ * Resolve a single value. Exported for converter unit tests; production
+ * code should call {@link resolveValueTree}.
+ */
+export declare function resolveValue(value: unknown, ctx: ResolveContext): unknown;
+/**
+ * Plain-object detection: an object literal whose prototype chain is
+ * `Object.prototype` (or null, for `Object.create(null)`). Class
+ * instances like `Date`, `Timestamp`, `DocumentReference` deliberately
+ * fall through to converter-or-identity handling — the resolver should
+ * not silently strip their prototype by walking them as plain maps.
+ */
+export declare function isPlainObject(value: unknown): value is DocumentData;
+/**
+ * Item 2 — split a resolved tree into "values to write" and "fields to
+ * delete" by walking it for {@link DELETE_MARKER} sentinels.
+ *
+ * For top-level keys whose value is `DELETE_MARKER`, the key is removed
+ * from `writes` and added to `deletedKeys`. For nested occurrences, the
+ * marker is stripped from its containing object so it never lands in
+ * storage. Arrays are not a Firestore-idiomatic place for deleteField,
+ * but for safety any nested marker inside an array is dropped (the
+ * array is rebuilt without the deleted element to avoid leaving a
+ * symbol in the wire payload).
+ *
+ * Idempotency: a tree that has already been partitioned contains no
+ * markers, so this is a no-op on its own output. Both
+ * `LocalEnvironment.execute` (for rule visibility) and `LocalState.write`
+ * call this; the second call sees nothing to do.
+ *
+ * Note: this top-level partition backs the `create` / non-merge `set`
+ * paths. The `update` path is handled by `field-merge.applyUpdate`, which
+ * supports dot-path deletes (`{'a.b': deleteField()}` removes the nested
+ * leaf — FS-B5) and rejects a `deleteField()` nested inside a map literal
+ * with `invalid-argument` (FS-B13), rather than silently destroying the
+ * sibling map. `partitionDeletes` itself only sees top-level markers and
+ * strips any nested ones it encounters.
+ */
+export declare function partitionDeletes(data: DocumentData): {
+    writes: DocumentData;
+    deletedKeys: string[];
+};
+export declare function stripMarkers(value: unknown): unknown;
+/**
+ * Register every converter the simulator ships with. Called by
+ * {@link LocalEnvironment} on construction; safe to call multiple times
+ * (each `registerConverter` is idempotent on name). Items 1+ extend this
+ * function as their converters land.
+ *
+ * Converter ordering note: order matters for first-wins claiming. Items
+ * 2-5 must register their sentinel/wrapper converters BEFORE the generic
+ * plain-object descent kicks in — but converters never compete with each
+ * other in practice (they each detect a distinct shape).
+ */
+export declare function registerDefaultConverters(): void;
+//# sourceMappingURL=value-resolver.d.ts.map

package/dist/sandbox/firestore/value-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-resolver.d.ts","sourceRoot":"","sources":["../../../src/sandbox/firestore/value-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAcH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,qEAAqE;IACrE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,OAAO,MAAsC,CAAC;AACjE,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC;AAE/B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,MAA+C,CAAC;AACnF,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,GAAG,IAAI,CAAC;CAC9D;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAGzD;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GACrC,YAAY,CAMd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAuBzE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAInE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,GACjB;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAWjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAsBhD"}

package/dist/sandbox/firestore/value-resolver.js

@@ -0,0 +1,221 @@
+/**
+ * Write-boundary value resolver — central pass that runs over every value
+ * tree about to enter {@link LocalState}.
+ *
+ * Why this exists:
+ *   The simulator stores plain JS objects but agents seed/write values
+ *   that need normalization before either rules or storage see them:
+ *     - `Date` / `Timestamp` instances must round-trip with the right
+ *       wire type (Item 1).
+ *     - `serverTimestamp()`, `increment()`, `arrayUnion/Remove()`,
+ *       `deleteField()` sentinels must be resolved against prior doc
+ *       state (Item 2).
+ *     - `DocumentReference`, `VectorValue` need wrapper conversion
+ *       (Items 3, 5).
+ *
+ *   Doing each of these in five different write methods is a recipe for
+ *   drift. Item 0 introduces a single chokepoint: every value about to
+ *   land in storage passes through {@link resolveValueTree} first.
+ *
+ * Design — registry of converters:
+ *   Items 1, 2, 3, 5 each register a {@link ValueConverter}. Converters
+ *   inspect a value and either substitute it (returning the replacement)
+ *   or decline (returning {@link KEEP}). The resolver tries converters in
+ *   registration order; if none claim the value, plain objects and arrays
+ *   are walked recursively. Class instances the resolver doesn't recognize
+ *   pass through unchanged.
+ *
+ * Idempotency contract:
+ *   Every converter MUST no-op on its own output. This lets multiple
+ *   layers (LocalEnvironment.execute pre-rules, LocalState.write
+ *   pre-storage) call the resolver without double-applying conversions.
+ *   The Item 0 test contract verifies the empty-registry case is itself
+ *   idempotent.
+ *
+ * Today (Item 0) the registry is empty — the resolver is an identity
+ * walk. Wiring is in place so Items 1+ are pure additions.
+ */
+import { dateConverter, serverTimestampConverter } from './converters/timestamp.js';
+import { userTimestampConverter } from './converters/user-timestamp.js';
+import { incrementConverter, arrayUnionConverter, arrayRemoveConverter, deleteFieldConverter, } from './converters/fieldvalue.js';
+import { documentReferenceConverter } from './converters/reference.js';
+import { vectorValueConverter } from './converters/vector.js';
+import { bytesConverter, geoPointConverter } from './converters/bytes-geopoint.js';
+/**
+ * Sentinel returned by converters that decline to claim a value. Using a
+ * Symbol rather than `undefined` lets converters legitimately substitute
+ * `undefined` if they ever need to (e.g., `deleteField()` resolution).
+ */
+export const KEEP = Symbol('value-resolver:KEEP');
+/**
+ * Sentinel substituted by the deleteField converter (Item 2). The
+ * resolver returns this in place of `{ __type: 'deleteField' }`; the
+ * write layer ({@link partitionDeletes}) then strips these markers
+ * out of the value tree and surfaces the affected top-level keys to
+ * `LocalState` so the existing field is removed from storage.
+ *
+ * Why a symbol rather than another `__type` object: it cannot
+ * accidentally collide with user data, it survives a structuredClone-
+ * free copy intact (the resolver doesn't clone its outputs), and it
+ * makes idempotency trivial — the converter only matches the sentinel
+ * shape, never the marker.
+ */
+export const DELETE_MARKER = Symbol('value-resolver:DELETE_MARKER');
+const converters = [];
+/**
+ * Register a converter. Idempotent on `name` — re-registering the same
+ * named converter is a no-op. Item modules register their converters via
+ * {@link registerDefaultConverters} on simulator startup.
+ */
+export function registerConverter(c) {
+    if (converters.some((existing) => existing.name === c.name))
+        return;
+    converters.push(c);
+}
+/** For tests only — clears the registry. Production code never calls this. */
+export function _clearConvertersForTest() {
+    converters.length = 0;
+}
+/** Snapshot of registered converter names. Diagnostics + test introspection. */
+export function listConverters() {
+    return converters.map((c) => c.name);
+}
+/**
+ * Resolve a full document tree. Walks each top-level field with the
+ * resolver, returning a new object — never mutates input.
+ */
+export function resolveValueTree(data, ctx) {
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        out[key] = resolveValue(value, { ...ctx, fieldPath: key });
+    }
+    return out;
+}
+/**
+ * Resolve a single value. Exported for converter unit tests; production
+ * code should call {@link resolveValueTree}.
+ */
+export function resolveValue(value, ctx) {
+    // First pass: offer the value to every converter in registration order.
+    for (const c of converters) {
+        const replaced = c.convert(value, ctx);
+        if (replaced !== KEEP)
+            return replaced;
+    }
+    // No converter claimed it. Descend into containers; pass through everything else.
+    if (Array.isArray(value)) {
+        return value.map((v, i) => resolveValue(v, { ...ctx, fieldPath: `${ctx.fieldPath}[${i}]` }));
+    }
+    if (isPlainObject(value)) {
+        const inner = {};
+        for (const [k, v] of Object.entries(value)) {
+            const childPath = ctx.fieldPath ? `${ctx.fieldPath}.${k}` : k;
+            inner[k] = resolveValue(v, { ...ctx, fieldPath: childPath });
+        }
+        return inner;
+    }
+    // Primitives, Dates, class instances, functions, etc. — identity.
+    return value;
+}
+/**
+ * Plain-object detection: an object literal whose prototype chain is
+ * `Object.prototype` (or null, for `Object.create(null)`). Class
+ * instances like `Date`, `Timestamp`, `DocumentReference` deliberately
+ * fall through to converter-or-identity handling — the resolver should
+ * not silently strip their prototype by walking them as plain maps.
+ */
+export function isPlainObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Item 2 — split a resolved tree into "values to write" and "fields to
+ * delete" by walking it for {@link DELETE_MARKER} sentinels.
+ *
+ * For top-level keys whose value is `DELETE_MARKER`, the key is removed
+ * from `writes` and added to `deletedKeys`. For nested occurrences, the
+ * marker is stripped from its containing object so it never lands in
+ * storage. Arrays are not a Firestore-idiomatic place for deleteField,
+ * but for safety any nested marker inside an array is dropped (the
+ * array is rebuilt without the deleted element to avoid leaving a
+ * symbol in the wire payload).
+ *
+ * Idempotency: a tree that has already been partitioned contains no
+ * markers, so this is a no-op on its own output. Both
+ * `LocalEnvironment.execute` (for rule visibility) and `LocalState.write`
+ * call this; the second call sees nothing to do.
+ *
+ * Note: this top-level partition backs the `create` / non-merge `set`
+ * paths. The `update` path is handled by `field-merge.applyUpdate`, which
+ * supports dot-path deletes (`{'a.b': deleteField()}` removes the nested
+ * leaf — FS-B5) and rejects a `deleteField()` nested inside a map literal
+ * with `invalid-argument` (FS-B13), rather than silently destroying the
+ * sibling map. `partitionDeletes` itself only sees top-level markers and
+ * strips any nested ones it encounters.
+ */
+export function partitionDeletes(data) {
+    const writes = {};
+    const deletedKeys = [];
+    for (const [key, value] of Object.entries(data)) {
+        if (value === DELETE_MARKER) {
+            deletedKeys.push(key);
+            continue;
+        }
+        writes[key] = stripMarkers(value);
+    }
+    return { writes, deletedKeys };
+}
+export function stripMarkers(value) {
+    if (value === DELETE_MARKER)
+        return undefined;
+    if (Array.isArray(value)) {
+        return value.filter((v) => v !== DELETE_MARKER).map(stripMarkers);
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (v === DELETE_MARKER)
+                continue;
+            out[k] = stripMarkers(v);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Register every converter the simulator ships with. Called by
+ * {@link LocalEnvironment} on construction; safe to call multiple times
+ * (each `registerConverter` is idempotent on name). Items 1+ extend this
+ * function as their converters land.
+ *
+ * Converter ordering note: order matters for first-wins claiming. Items
+ * 2-5 must register their sentinel/wrapper converters BEFORE the generic
+ * plain-object descent kicks in — but converters never compete with each
+ * other in practice (they each detect a distinct shape).
+ */
+export function registerDefaultConverters() {
+    // Item 1: Date → Timestamp + serverTimestamp sentinel resolution.
+    registerConverter(dateConverter);
+    registerConverter(serverTimestampConverter);
+    // FS-B4: a user-written compat / firebase Timestamp → rules-internal
+    // Timestamp, so it passes `is timestamp` and shares storage shape with
+    // serverTimestamp()/Date-resolved timestamps (unified comparability).
+    registerConverter(userTimestampConverter);
+    // Item 2: FieldValue sentinels (increment, arrayUnion/Remove, deleteField).
+    registerConverter(incrementConverter);
+    registerConverter(arrayUnionConverter);
+    registerConverter(arrayRemoveConverter);
+    registerConverter(deleteFieldConverter);
+    // Item 3: admin SDK DocumentReference → Reference wrapper.
+    registerConverter(documentReferenceConverter);
+    // Item 5: admin SDK VectorValue → Vector wrapper.
+    registerConverter(vectorValueConverter);
+    // Item 6: firebase/firestore Bytes + GeoPoint → rules-wrapper Bytes/LatLng.
+    // Lets `Bytes` / `GeoPoint` written via the modular SDK round-trip
+    // through the sandbox as proper instances (closes #109 + #110).
+    registerConverter(bytesConverter);
+    registerConverter(geoPointConverter);
+}
+//# sourceMappingURL=value-resolver.js.map

package/dist/sandbox/firestore/value-resolver.js.map

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

package/dist/sandbox/firestore/wire-encoder.d.ts

@@ -0,0 +1,14 @@
+type WireValue = Record<string, any>;
+/**
+ * Encode a plain value into a single Firestore wire-format value.
+ * Throws on unsupported shapes (BigInt, Date, etc.) to surface gaps
+ * rather than silently producing wrong types.
+ */
+export declare function encodeValue(v: unknown): WireValue;
+/**
+ * Encode a full DocumentData record into the `_fieldsProto` shape.
+ * Each top-level key becomes a wire value at the same key.
+ */
+export declare function encodeFieldsProto(data: Record<string, unknown>): Record<string, WireValue>;
+export {};
+//# sourceMappingURL=wire-encoder.d.ts.map

package/dist/sandbox/firestore/wire-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-encoder.d.ts","sourceRoot":"","sources":["../../../src/sandbox/firestore/wire-encoder.ts"],"names":[],"mappings":"AAmCA,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAiFjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAM1F"}

package/dist/sandbox/firestore/wire-encoder.js

@@ -0,0 +1,130 @@
+/**
+ * Wire-format encoder — synthesizes Firestore `_fieldsProto` from plain
+ * JavaScript values stored in {@link LocalState}.
+ *
+ * Background: `firestore_discover_paths` reads document type information
+ * from `DocumentSnapshot._fieldsProto` (Phase 0.A lock — fail loud if
+ * absent, never silently fall back to `data()`). The local simulator
+ * stores plain objects, so to drive the same crawler against the
+ * simulator we round-trip plain values into the wire shape that
+ * `wire.ts` consumes.
+ *
+ * Type mapping (plain JS → wire discriminator):
+ *   - `null`                → `{ nullValue: null }`
+ *   - `boolean`             → `{ booleanValue }`
+ *   - integer `number`      → `{ integerValue: String(n) }` (matches admin SDK's int64 encoding)
+ *   - non-integer `number`  → `{ doubleValue }`
+ *   - `string`              → `{ stringValue }`
+ *   - `Date`                → `{ timestampValue: { seconds, nanos } }` (Item 1)
+ *   - `Timestamp` wrapper   → `{ timestampValue: { seconds, nanos } }` (Item 1)
+ *   - `Reference` wrapper   → `{ referenceValue: 'projects/.../documents/<path>' }` (Item 3)
+ *   - `Array`               → `{ arrayValue: { values } }`
+ *   - plain object          → `{ mapValue: { fields } }`
+ *
+ * Limitations:
+ *   - `Buffer`, `GeoPoint`, BigInt and vector sentinels are NOT encoded —
+ *     agents seeding the simulator for discover_paths testing should stick
+ *     to the supported shapes.
+ *     If extended later, follow the discriminator forms in
+ *     {@link ../discover/wire.ts} verbatim.
+ */
+import { Timestamp } from 'pyric/rules';
+import { Reference, referenceToResourceName } from 'pyric/rules';
+import { Vector } from 'pyric/rules';
+/**
+ * Encode a plain value into a single Firestore wire-format value.
+ * Throws on unsupported shapes (BigInt, Date, etc.) to surface gaps
+ * rather than silently producing wrong types.
+ */
+export function encodeValue(v) {
+    if (v === null || v === undefined) {
+        // Firestore distinguishes "field absent" from "field null"; LocalState
+        // stores `undefined` only when explicitly set, which is rare. Treat
+        // both as `nullValue` for encoding — the merge layer will see a
+        // legitimate scalar:null observation.
+        return { nullValue: null };
+    }
+    if (typeof v === 'boolean') {
+        return { booleanValue: v };
+    }
+    if (typeof v === 'number') {
+        if (Number.isInteger(v)) {
+            // admin SDK encodes int64 as a string in `integerValue` for safe-int
+            // preservation. Mirror that contract so wire.ts's downstream parser
+            // (Number(raw)) lands on the same value.
+            return { integerValue: String(v) };
+        }
+        return { doubleValue: v };
+    }
+    if (typeof v === 'string') {
+        return { stringValue: v };
+    }
+    // Item 1 — Timestamp wrappers and raw Dates both encode as
+    // `timestampValue: { seconds, nanos }`. The Timestamp check must come
+    // BEFORE the generic object-walk below; otherwise a Timestamp's plain
+    // `seconds`/`nanos` fields would be re-encoded as a `mapValue`,
+    // erasing the timestamp type for downstream wire decoders. Date
+    // similarly must be claimed before the `typeof v === 'object'` branch.
+    if (v instanceof Timestamp) {
+        return { timestampValue: { seconds: v.seconds, nanos: v.nanos } };
+    }
+    if (v instanceof Date) {
+        const ts = Timestamp.fromMillis(v.getTime());
+        return { timestampValue: { seconds: ts.seconds, nanos: ts.nanos } };
+    }
+    // Item 3 — Reference wrapper rides out as `referenceValue`. The field
+    // value is the fully-qualified resource name; discover/wire.ts strips
+    // the `projects/.../documents/` prefix back to the relative collection
+    // path so the schema reports `kind:'reference', targetCollection:'users'`.
+    // Must be claimed BEFORE the generic object-walk below (Reference is
+    // an instance, not a plain map).
+    if (v instanceof Reference) {
+        return { referenceValue: referenceToResourceName(v) };
+    }
+    // Item 5 — Vector encodes as the sentinel map shape live Firestore
+    // uses for its embedding type. discover/wire.ts detects this exact
+    // shape (`__type__: '__vector__'` + `value: <arrayValue>`) and reports
+    // `kind: 'vector', dimension: N`. Must be claimed BEFORE the generic
+    // object-walk below — Vector is a class instance, not a plain map,
+    // but skipping past this branch would still emit the wrong shape via
+    // the generic descent (no `__type__` field exists on the wrapper).
+    if (v instanceof Vector) {
+        return {
+            mapValue: {
+                fields: {
+                    __type__: { stringValue: '__vector__' },
+                    value: {
+                        arrayValue: {
+                            values: v.value.map((n) => ({ doubleValue: n })),
+                        },
+                    },
+                },
+            },
+        };
+    }
+    if (Array.isArray(v)) {
+        return { arrayValue: { values: v.map((e) => encodeValue(e)) } };
+    }
+    if (typeof v === 'object') {
+        const fields = {};
+        for (const [k, sub] of Object.entries(v)) {
+            fields[k] = encodeValue(sub);
+        }
+        return { mapValue: { fields } };
+    }
+    throw new Error(`wire-encoder: unsupported value type ${typeof v} (value=${String(v)}). ` +
+        `LocalState's discover_paths adapter only supports JSON-shaped data ` +
+        `(null, boolean, number, string, array, plain object).`);
+}
+/**
+ * Encode a full DocumentData record into the `_fieldsProto` shape.
+ * Each top-level key becomes a wire value at the same key.
+ */
+export function encodeFieldsProto(data) {
+    const proto = {};
+    for (const [k, v] of Object.entries(data)) {
+        proto[k] = encodeValue(v);
+    }
+    return proto;
+}
+//# sourceMappingURL=wire-encoder.js.map

package/dist/sandbox/firestore/wire-encoder.js.map

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

package/dist/sandbox/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `pyric/sandbox` — sandbox host (foundation). Provides the
+ * `Sandbox` type, the `SandboxContext` identity handle, the
+ * `initializeSandbox` factory, and the `SandboxError` family.
+ *
+ * Service handles live in sibling packages (`pyric-admin` for the
+ * Admin-SDK-shaped chainable Firestore adapter, future
+ * `pyric/firestore` for the modular Web SDK adapter,
+ * `pyric/auth`/`pyric/database`/`pyric/storage` later) and consume
+ * `SandboxContext` from here.
+ *
+ * Adapter packages also reach into `pyric/sandbox/internal` for the
+ * non-public protocol (`getInternalEnv`, etc.). See
+ * the design rationale and
+ * the design rationale for the design rationale.
+ */
+import type { Sandbox, SandboxConfig } from './types.js';
+export type { AuthLens, AuthState, DenialContext, DenialEvent, EventActor, EventProvenance, EventService, ListenerLifecycleEvent, PersistableService, RequestEvent, Sandbox, SandboxConfig, SandboxContext, SandboxCommitEvent, SandboxErrorCode, SandboxEvent, SandboxListenerEvent, SandboxOperationEvent, SandboxRuntimeErrorEvent, SandboxSnapshot, ServiceMutationEvent, SessionBoundaryEvent, SnapshotDeliveryEvent, SnapshotErrorEvent, SnapshotSuppressedEvent, WriteSandboxEvent, } from './types.js';
+export { SandboxError } from './types.js';
+export { SandboxContextImpl } from './sandbox-context.js';
+export { REMOTE_SANDBOX, REMOTE_SANDBOX_FACTORY, isRemoteSandbox } from './remote.js';
+export type { RemoteSandbox, RemoteSandboxChannel, RemoteSandboxFactory, RemoteSandboxFactoryOptions, } from './remote.js';
+export { replay } from './replay/index.js';
+export type { Divergence, ReplayOptions, ReplayResult } from './replay/index.js';
+export { apply, discard, diff, fork, promote } from './branches/index.js';
+export type { Branch, DiffTarget } from './branches/index.js';
+export type { PersistenceBackend, PersistenceController, SandboxPersistenceOptions, WebStorageLike, } from './persistence/index.js';
+export { attachPersistence, createIndexedDBBackend, createMemoryBackend, recordBackendOverBlob, serializeToBuckets, deserializeFromBuckets, bundleRecords, parseBundle, PersistenceSchemaError, rehydrateDocValue, } from './persistence/index.js';
+export type { BroadcastChannelLike, TabSyncOptions } from './tab-sync/index.js';
+export { attachTabSync } from './tab-sync/index.js';
+/**
+ * Create a sandbox.
+ *
+ * Identity is **not** part of init — call `sandbox.withAuth(...)` to
+ * derive a {@link SandboxContext} for service operations. Service-
+ * specific configuration (rules, seed data) happens through service
+ * handles — for example, `getFirestore(ctx).setRules(...)`.
+ *
+ * @example
+ * ```ts
+ * import { initializeSandbox } from 'pyric/sandbox';
+ * import { getFirestore } from 'pyric-admin/firestore';
+ *
+ * const sandbox = initializeSandbox();
+ * const dbAlice = getFirestore(sandbox.withAuth({ uid: 'alice' }));
+ * const dbAnon  = getFirestore(sandbox.withAuth(null));
+ * ```
+ */
+export declare function initializeSandbox(_config?: SandboxConfig): Sandbox;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD,YAAY,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAK9D,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAKtE"}