pyric 0.0.1 → 0.1.0-alpha.8

package/dist/sandbox/firestore/admin-compat/types.d.ts.map

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

package/dist/sandbox/firestore/admin-compat/types.js

@@ -0,0 +1,127 @@
+/**
+ * Public types for the Admin-SDK-compat Firestore wrapper.
+ *
+ * Mirrors the firebase-admin Firestore surface, scoped to what an agent
+ * running code under `LocalEnvironment` actually exercises. Listener
+ * semantics, offline persistence, bundles, and named queries are
+ * deliberately omitted — methods that touch them throw
+ * `FirestoreCompatError { code: 'unimplemented' }` rather than return
+ * silent no-ops (see design rationale, the
+ * "deliberately incomplete" agreement).
+ *
+ * Public-API `unknown` policy: every `unknown` here sits at a real
+ * Firestore "stores arbitrary data" boundary (`DocumentData` values,
+ * where-clause values, FieldValue construction) — matching the Admin
+ * SDK's own type-shape decisions. Zero `: any`.
+ */
+export class FieldValue {
+    static serverTimestamp() {
+        return { __type: 'serverTimestamp' };
+    }
+    static increment(n) {
+        return { __type: 'increment', value: n };
+    }
+    static arrayUnion(...values) {
+        return { __type: 'arrayUnion', values };
+    }
+    static arrayRemove(...values) {
+        return { __type: 'arrayRemove', values };
+    }
+    static delete() {
+        return { __type: 'deleteField' };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Timestamp — Admin SDK shape (`seconds` + `nanoseconds`). Distinct from
+// the rules-internal Timestamp at `simulator/wrappers/timestamp.ts` which
+// uses `nanos` and carries evaluator hooks (binaryOp/callMethod). Both
+// round-trip through the same `__type:'timestamp'` discriminator on the
+// wire; the compat class is the user-facing surface.
+// ─────────────────────────────────────────────────────────────────────────
+export class Timestamp {
+    seconds;
+    nanoseconds;
+    constructor(seconds, nanoseconds) {
+        this.seconds = seconds;
+        this.nanoseconds = nanoseconds;
+    }
+    static now() {
+        return Timestamp.fromMillis(Date.now());
+    }
+    static fromDate(d) {
+        return Timestamp.fromMillis(d.getTime());
+    }
+    static fromMillis(ms) {
+        // FS-B12 — derive nanoseconds as `floor((ms - seconds*1000) * 1e6)` so
+        // the value is ALWAYS non-negative (matching `fb.Timestamp.fromMillis`).
+        // The old `(ms % 1000) * 1e6` produced negative nanos for negative
+        // millis, so `fromMillis(-500)` round-tripped to -1500 via toMillis().
+        const seconds = Math.floor(ms / 1000);
+        const nanoseconds = Math.floor((ms - seconds * 1000) * 1_000_000);
+        return new Timestamp(seconds, nanoseconds);
+    }
+    toDate() {
+        return new Date(this.toMillis());
+    }
+    toMillis() {
+        // FS-B12 — `nanoseconds / 1e6` (matching `fb.Timestamp.toMillis`), not
+        // `floor(nanoseconds / 1e6)`; the floor dropped sub-millisecond nanos
+        // and broke the negative-millis round-trip.
+        return this.seconds * 1000 + this.nanoseconds / 1_000_000;
+    }
+    /** FS-B12 — value equality, mirroring `fb.Timestamp.isEqual`. */
+    isEqual(other) {
+        return other.seconds === this.seconds && other.nanoseconds === this.nanoseconds;
+    }
+    /** FS-B12 — textual form, mirroring `fb.Timestamp.toString`. */
+    toString() {
+        return `Timestamp(seconds=${this.seconds}, nanoseconds=${this.nanoseconds})`;
+    }
+    /** FS-B12 — JSON form, mirroring `fb.Timestamp.toJSON`. */
+    toJSON() {
+        return {
+            type: 'firestore/timestamp/1.0',
+            seconds: this.seconds,
+            nanoseconds: this.nanoseconds,
+        };
+    }
+    /**
+     * FS-B12 — primitive coercion for `<`/`<=`/`>=`/`>` comparisons, mirroring
+     * `fb.Timestamp.valueOf`: a zero-padded `<seconds>.<nanoseconds>` string
+     * (seconds offset by MIN_SECONDS so it stays non-negative and lexically
+     * ordered).
+     */
+    valueOf() {
+        const MIN_SECONDS = -62_135_596_800;
+        const adjustedSeconds = this.seconds - MIN_SECONDS;
+        const formattedSeconds = String(adjustedSeconds).padStart(12, '0');
+        const formattedNanoseconds = String(this.nanoseconds).padStart(9, '0');
+        return `${formattedSeconds}.${formattedNanoseconds}`;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────
+// FirestoreCompatError — throwable Error subclass that carries the
+// SDK's typed `FirestoreErrorCode` on `.code`. Real Admin SDK throws a
+// `FirestoreError extends Error` with the same shape, so consumer code
+// patterns like `try {} catch (e) { if (e.code === 'already-exists') }`
+// work unchanged against this wrapper.
+// ─────────────────────────────────────────────────────────────────────────
+export class FirestoreCompatError extends Error {
+    code;
+    /**
+     * The structured `FirestoreSimError` this throw was built from. Kept
+     * as a back-channel so downstream wrappers (`pyric/sandbox`) can
+     * read the eval-time `request`/`resource` context without re-parsing
+     * the message string. Production Admin SDK has no equivalent — this
+     * field is sandbox-only and intentionally not surfaced on `Error`'s
+     * own enumeration unless a caller reaches for it explicitly.
+     */
+    simError;
+    constructor(err) {
+        super(err.message);
+        this.name = 'FirestoreError';
+        this.code = err.code;
+        this.simError = err;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/sandbox/firestore/admin-compat/types.js.map

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

package/dist/sandbox/firestore/admin-compat/value-order.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Canonical Firestore value comparator (FS-B3).
+ *
+ * Firestore orders heterogeneous field values by a fixed *type order*
+ * first, then within a type. The old query comparator ignored this and
+ * fell back to `String(a).localeCompare(String(b))`, which mis-ordered
+ * everything that wasn't same-typed scalars and mishandled NaN. This
+ * module mirrors `clones/firebase-js-sdk/packages/firestore/src/model/
+ * type_order.ts` + `model/values.ts` (`valueCompare`) for the plain-JS
+ * value shapes the sandbox stores.
+ *
+ * Type order (ascending):
+ *   null < boolean < number < timestamp < string < bytes < reference
+ *   < geopoint < array < map
+ *
+ * The sandbox stores values as plain JS rather than the wire `Value`
+ * proto, so each type is detected structurally:
+ *   - number: `typeof === 'number'` or `'bigint'` (NaN sorts smallest
+ *     among numbers, matching `compareNumbers`).
+ *   - timestamp: an object with numeric `seconds` + (`nanos` |
+ *     `nanoseconds`) — covers both the rules `Timestamp` ({seconds,nanos})
+ *     and the admin-compat `Timestamp` ({seconds,nanoseconds}).
+ *   - bytes: an object with a `Uint8Array` `data` field (rules `Bytes`).
+ *   - geopoint: an object with numeric `latitude` + `longitude`.
+ *   - reference: an object with a string `path` (a doc ref) — but NOT a
+ *     timestamp/geopoint/bytes (checked first).
+ *   - array: `Array.isArray`.
+ *   - map: any other plain object.
+ */
+export declare const enum TypeRank {
+    Null = 0,
+    Boolean = 1,
+    Number = 2,
+    Timestamp = 3,
+    String = 4,
+    Bytes = 5,
+    Reference = 6,
+    GeoPoint = 7,
+    Array = 8,
+    Map = 9
+}
+/** Rank a value into the canonical Firestore type order. */
+export declare function typeOrderRank(v: unknown): TypeRank;
+/**
+ * Compare two Firestore field values by canonical type order, then
+ * within-type. Returns <0, 0, >0. Mirrors upstream `valueCompare`.
+ */
+export declare function compareValues(a: unknown, b: unknown): number;
+//# sourceMappingURL=value-order.d.ts.map

package/dist/sandbox/firestore/admin-compat/value-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-order.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/value-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,0BAAkB,QAAQ;IACxB,IAAI,IAAI;IACR,OAAO,IAAI;IACX,MAAM,IAAI;IACV,SAAS,IAAI;IACb,MAAM,IAAI;IACV,KAAK,IAAI;IACT,SAAS,IAAI;IACb,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,GAAG,IAAI;CACR;AA2BD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAkBlD;AA0BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAoE5D"}

package/dist/sandbox/firestore/admin-compat/value-order.js

@@ -0,0 +1,172 @@
+/**
+ * Canonical Firestore value comparator (FS-B3).
+ *
+ * Firestore orders heterogeneous field values by a fixed *type order*
+ * first, then within a type. The old query comparator ignored this and
+ * fell back to `String(a).localeCompare(String(b))`, which mis-ordered
+ * everything that wasn't same-typed scalars and mishandled NaN. This
+ * module mirrors `clones/firebase-js-sdk/packages/firestore/src/model/
+ * type_order.ts` + `model/values.ts` (`valueCompare`) for the plain-JS
+ * value shapes the sandbox stores.
+ *
+ * Type order (ascending):
+ *   null < boolean < number < timestamp < string < bytes < reference
+ *   < geopoint < array < map
+ *
+ * The sandbox stores values as plain JS rather than the wire `Value`
+ * proto, so each type is detected structurally:
+ *   - number: `typeof === 'number'` or `'bigint'` (NaN sorts smallest
+ *     among numbers, matching `compareNumbers`).
+ *   - timestamp: an object with numeric `seconds` + (`nanos` |
+ *     `nanoseconds`) — covers both the rules `Timestamp` ({seconds,nanos})
+ *     and the admin-compat `Timestamp` ({seconds,nanoseconds}).
+ *   - bytes: an object with a `Uint8Array` `data` field (rules `Bytes`).
+ *   - geopoint: an object with numeric `latitude` + `longitude`.
+ *   - reference: an object with a string `path` (a doc ref) — but NOT a
+ *     timestamp/geopoint/bytes (checked first).
+ *   - array: `Array.isArray`.
+ *   - map: any other plain object.
+ */
+function isTimestampLike(v) {
+    return (typeof v.seconds === 'number' &&
+        (typeof v.nanos === 'number' || typeof v.nanoseconds === 'number'));
+}
+function isGeoPointLike(v) {
+    return typeof v.latitude === 'number' && typeof v.longitude === 'number';
+}
+function isBytesLike(v) {
+    return v.data instanceof Uint8Array;
+}
+function isReferenceLike(v) {
+    return typeof v.path === 'string';
+}
+/** Rank a value into the canonical Firestore type order. */
+export function typeOrderRank(v) {
+    if (v === null || v === undefined)
+        return 0 /* TypeRank.Null */;
+    const t = typeof v;
+    if (t === 'boolean')
+        return 1 /* TypeRank.Boolean */;
+    if (t === 'number' || t === 'bigint')
+        return 2 /* TypeRank.Number */;
+    if (t === 'string')
+        return 4 /* TypeRank.String */;
+    if (Array.isArray(v))
+        return 8 /* TypeRank.Array */;
+    if (t === 'object') {
+        const o = v;
+        if (isTimestampLike(o))
+            return 3 /* TypeRank.Timestamp */;
+        if (isBytesLike(o))
+            return 5 /* TypeRank.Bytes */;
+        if (isGeoPointLike(o))
+            return 7 /* TypeRank.GeoPoint */;
+        if (isReferenceLike(o))
+            return 6 /* TypeRank.Reference */;
+        return 9 /* TypeRank.Map */;
+    }
+    // Unknown (symbol/function) — treat as map-rank so it sorts last and
+    // never throws. Should not occur for stored Firestore data.
+    return 9 /* TypeRank.Map */;
+}
+function timestampMillisParts(v) {
+    const nanos = typeof v.nanos === 'number' ? v.nanos : (v.nanoseconds ?? 0);
+    return [v.seconds, nanos];
+}
+function compareNumbers(a, b) {
+    // NaN sorts as the smallest number (matches `compareNumbers` in
+    // values.ts: NaN < any non-NaN, NaN === NaN).
+    const aNaN = Number.isNaN(a);
+    const bNaN = Number.isNaN(b);
+    if (aNaN && bNaN)
+        return 0;
+    if (aNaN)
+        return -1;
+    if (bNaN)
+        return 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function compareStrings(a, b) {
+    // Firestore compares strings by UTF-8 byte order. For the BMP-only
+    // corpus the sandbox exercises, JS's `<`/`>` (UTF-16 code-unit order)
+    // agrees with UTF-8 byte order; surrogate-pair edge cases are an
+    // accepted approximation (documented divergence).
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * Compare two Firestore field values by canonical type order, then
+ * within-type. Returns <0, 0, >0. Mirrors upstream `valueCompare`.
+ */
+export function compareValues(a, b) {
+    const ra = typeOrderRank(a);
+    const rb = typeOrderRank(b);
+    if (ra !== rb)
+        return ra < rb ? -1 : 1;
+    switch (ra) {
+        case 0 /* TypeRank.Null */:
+            return 0;
+        case 1 /* TypeRank.Boolean */:
+            return (a === b) ? 0 : (a ? 1 : -1);
+        case 2 /* TypeRank.Number */:
+            return compareNumbers(Number(a), Number(b));
+        case 3 /* TypeRank.Timestamp */: {
+            const [as, an] = timestampMillisParts(a);
+            const [bs, bn] = timestampMillisParts(b);
+            if (as !== bs)
+                return as < bs ? -1 : 1;
+            return an < bn ? -1 : an > bn ? 1 : 0;
+        }
+        case 4 /* TypeRank.String */:
+            return compareStrings(a, b);
+        case 5 /* TypeRank.Bytes */: {
+            const ab = a.data;
+            const bb = b.data;
+            const n = Math.min(ab.length, bb.length);
+            for (let i = 0; i < n; i++) {
+                if (ab[i] !== bb[i])
+                    return ab[i] < bb[i] ? -1 : 1;
+            }
+            return ab.length < bb.length ? -1 : ab.length > bb.length ? 1 : 0;
+        }
+        case 6 /* TypeRank.Reference */:
+            return compareStrings(a.path, b.path);
+        case 7 /* TypeRank.GeoPoint */: {
+            const ag = a;
+            const bg = b;
+            if (ag.latitude !== bg.latitude)
+                return ag.latitude < bg.latitude ? -1 : 1;
+            return ag.longitude < bg.longitude ? -1 : ag.longitude > bg.longitude ? 1 : 0;
+        }
+        case 8 /* TypeRank.Array */: {
+            const aa = a;
+            const ba = b;
+            const n = Math.min(aa.length, ba.length);
+            for (let i = 0; i < n; i++) {
+                const cmp = compareValues(aa[i], ba[i]);
+                if (cmp !== 0)
+                    return cmp;
+            }
+            return aa.length < ba.length ? -1 : aa.length > ba.length ? 1 : 0;
+        }
+        case 9 /* TypeRank.Map */: {
+            // Maps compare by sorted key, then value, then length — matching
+            // upstream `compareMaps`.
+            const am = a;
+            const bm = b;
+            const aKeys = Object.keys(am).sort();
+            const bKeys = Object.keys(bm).sort();
+            const n = Math.min(aKeys.length, bKeys.length);
+            for (let i = 0; i < n; i++) {
+                if (aKeys[i] !== bKeys[i])
+                    return aKeys[i] < bKeys[i] ? -1 : 1;
+                const cmp = compareValues(am[aKeys[i]], bm[bKeys[i]]);
+                if (cmp !== 0)
+                    return cmp;
+            }
+            return aKeys.length < bKeys.length ? -1 : aKeys.length > bKeys.length ? 1 : 0;
+        }
+        default:
+            return 0;
+    }
+}
+//# sourceMappingURL=value-order.js.map

package/dist/sandbox/firestore/admin-compat/value-order.js.map

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

package/dist/sandbox/firestore/auto-id.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Item 7 — Firestore-compatible auto document ID generator.
+ *
+ * Production Firestore mints 20-character document IDs from the
+ * alphabet `[A-Za-z0-9]` (62 characters, ~119 bits of entropy). The
+ * sim-side generator matches that exact shape so any test that
+ * captures an auto-id and asserts on its format gets the same answer
+ * a live `addDoc()` call would.
+ *
+ * Uses the Web Crypto `getRandomValues` surface for entropy — exposed
+ * on `globalThis.crypto` in Node 19+ and every browser. Each generated
+ * character consumes one random byte, mod 62. The mod-bias is tiny at
+ * 62/256 ≈ 24% and matches what the JS Firestore SDK does internally —
+ * kept identical so a test's collision probability is comparable
+ * across local and prod runs. Web Crypto keeps this module browser-
+ * safe (no `node:crypto` import).
+ */
+export declare const FIRESTORE_AUTO_ID_LENGTH = 20;
+export declare const FIRESTORE_AUTO_ID_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+/**
+ * Generate a single 20-character Firestore auto ID. Backed by
+ * cryptographically-strong randomness so 1000-sample collision tests
+ * succeed even under heavy parallelism in the test runner.
+ */
+export declare function generateAutoId(): string;
+//# sourceMappingURL=auto-id.d.ts.map

package/dist/sandbox/firestore/auto-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-id.d.ts","sourceRoot":"","sources":["../../../src/sandbox/firestore/auto-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,eAAO,MAAM,wBAAwB,KAAY,CAAC;AAClD,eAAO,MAAM,0BAA0B,mEAAW,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC"}

package/dist/sandbox/firestore/auto-id.js

@@ -0,0 +1,36 @@
+/**
+ * Item 7 — Firestore-compatible auto document ID generator.
+ *
+ * Production Firestore mints 20-character document IDs from the
+ * alphabet `[A-Za-z0-9]` (62 characters, ~119 bits of entropy). The
+ * sim-side generator matches that exact shape so any test that
+ * captures an auto-id and asserts on its format gets the same answer
+ * a live `addDoc()` call would.
+ *
+ * Uses the Web Crypto `getRandomValues` surface for entropy — exposed
+ * on `globalThis.crypto` in Node 19+ and every browser. Each generated
+ * character consumes one random byte, mod 62. The mod-bias is tiny at
+ * 62/256 ≈ 24% and matches what the JS Firestore SDK does internally —
+ * kept identical so a test's collision probability is comparable
+ * across local and prod runs. Web Crypto keeps this module browser-
+ * safe (no `node:crypto` import).
+ */
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+const ID_LENGTH = 20;
+export const FIRESTORE_AUTO_ID_LENGTH = ID_LENGTH;
+export const FIRESTORE_AUTO_ID_ALPHABET = ALPHABET;
+/**
+ * Generate a single 20-character Firestore auto ID. Backed by
+ * cryptographically-strong randomness so 1000-sample collision tests
+ * succeed even under heavy parallelism in the test runner.
+ */
+export function generateAutoId() {
+    const bytes = new Uint8Array(ID_LENGTH);
+    globalThis.crypto.getRandomValues(bytes);
+    let out = '';
+    for (let i = 0; i < ID_LENGTH; i++) {
+        out += ALPHABET[bytes[i] % ALPHABET.length];
+    }
+    return out;
+}
+//# sourceMappingURL=auto-id.js.map

package/dist/sandbox/firestore/auto-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-id.js","sourceRoot":"","sources":["../../../src/sandbox/firestore/auto-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,QAAQ,GACZ,gEAAgE,CAAC;AAEnE,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAClD,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IACxC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/sandbox/firestore/converters/bytes-geopoint.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Bytes + GeoPoint write-boundary converters.
+ *
+ * Wraps `firebase/firestore` `Bytes` and `GeoPoint` instances into our
+ * {@link Bytes} / {@link LatLng} wrappers at the write boundary.
+ *
+ * Without these converters, a `Bytes` / `GeoPoint` instance passed via
+ * `setDoc({ b: Bytes.fromBase64String(...), g: new GeoPoint(...) })`
+ * would land in `LocalState` as the `firebase/firestore` class instance.
+ * Two problems with that:
+ *
+ *   1. Rules evaluator detects these types via `instanceof
+ *      `pyric/rules`.Bytes` / `instanceof LatLng` — a
+ *      `fb.Bytes` instance fails both checks, so `data.b is bytes`
+ *      returns false.
+ *   2. The admin-compat read-path walker in `snapshots.ts` walks any
+ *      `typeof === 'object'` value via `Object.entries`, which on a
+ *      `fb.Bytes` instance enumerates private fields like `_byteString`
+ *      and emits a plain object. Round-trip is lost — consumer code
+ *      that wrote a `Bytes` reads back `{ _byteString: '...' }` instead
+ *      of a `Bytes` instance.
+ *
+ * Detection strategy — duck typing on the firebase/firestore SDK shape:
+ *
+ *   `Bytes`:
+ *     - method `toBase64()` returning string
+ *     - method `toUint8Array()` returning Uint8Array
+ *     - method `isEqual` (function)
+ *
+ *   `GeoPoint`:
+ *     - `latitude` and `longitude` getters returning number
+ *     - method `isEqual` (function)
+ *
+ * We deliberately don't `instanceof fb.Bytes` / `instanceof fb.GeoPoint`
+ * because:
+ *   1. The simulator package shouldn't take a hard dependency on
+ *      `firebase/firestore` (it's a consumer concern), and
+ *   2. Multiple `firebase` copies in a workspace would defeat
+ *      `instanceof`.
+ *
+ * Idempotency: each converter rejects its own output (our
+ * `pyric/rules` wrapper) by `instanceof` check, so a second
+ * resolver pass is a no-op.
+ */
+import { type ValueConverter } from '../value-resolver.js';
+export declare const bytesConverter: ValueConverter;
+export declare const geoPointConverter: ValueConverter;
+//# sourceMappingURL=bytes-geopoint.d.ts.map

package/dist/sandbox/firestore/converters/bytes-geopoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-geopoint.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/converters/bytes-geopoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAyCjE,eAAO,MAAM,cAAc,EAAE,cAM5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAM/B,CAAC"}

package/dist/sandbox/firestore/converters/bytes-geopoint.js

@@ -0,0 +1,85 @@
+/**
+ * Bytes + GeoPoint write-boundary converters.
+ *
+ * Wraps `firebase/firestore` `Bytes` and `GeoPoint` instances into our
+ * {@link Bytes} / {@link LatLng} wrappers at the write boundary.
+ *
+ * Without these converters, a `Bytes` / `GeoPoint` instance passed via
+ * `setDoc({ b: Bytes.fromBase64String(...), g: new GeoPoint(...) })`
+ * would land in `LocalState` as the `firebase/firestore` class instance.
+ * Two problems with that:
+ *
+ *   1. Rules evaluator detects these types via `instanceof
+ *      `pyric/rules`.Bytes` / `instanceof LatLng` — a
+ *      `fb.Bytes` instance fails both checks, so `data.b is bytes`
+ *      returns false.
+ *   2. The admin-compat read-path walker in `snapshots.ts` walks any
+ *      `typeof === 'object'` value via `Object.entries`, which on a
+ *      `fb.Bytes` instance enumerates private fields like `_byteString`
+ *      and emits a plain object. Round-trip is lost — consumer code
+ *      that wrote a `Bytes` reads back `{ _byteString: '...' }` instead
+ *      of a `Bytes` instance.
+ *
+ * Detection strategy — duck typing on the firebase/firestore SDK shape:
+ *
+ *   `Bytes`:
+ *     - method `toBase64()` returning string
+ *     - method `toUint8Array()` returning Uint8Array
+ *     - method `isEqual` (function)
+ *
+ *   `GeoPoint`:
+ *     - `latitude` and `longitude` getters returning number
+ *     - method `isEqual` (function)
+ *
+ * We deliberately don't `instanceof fb.Bytes` / `instanceof fb.GeoPoint`
+ * because:
+ *   1. The simulator package shouldn't take a hard dependency on
+ *      `firebase/firestore` (it's a consumer concern), and
+ *   2. Multiple `firebase` copies in a workspace would defeat
+ *      `instanceof`.
+ *
+ * Idempotency: each converter rejects its own output (our
+ * `pyric/rules` wrapper) by `instanceof` check, so a second
+ * resolver pass is a no-op.
+ */
+import { KEEP } from '../value-resolver.js';
+import { Bytes as RulesBytes, LatLng } from 'pyric/rules';
+function isFbBytes(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    // Must NOT be our own wrapper — already converted.
+    if (v instanceof RulesBytes)
+        return false;
+    const o = v;
+    return (typeof o.toBase64 === 'function' &&
+        typeof o.toUint8Array === 'function' &&
+        typeof o.isEqual === 'function');
+}
+function isFbGeoPoint(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    // Must NOT be our own wrapper — already converted.
+    if (v instanceof LatLng)
+        return false;
+    const o = v;
+    return (typeof o.latitude === 'number' &&
+        typeof o.longitude === 'number' &&
+        typeof o.isEqual === 'function');
+}
+export const bytesConverter = {
+    name: 'fb-bytes-to-rules-bytes',
+    convert(value) {
+        if (!isFbBytes(value))
+            return KEEP;
+        return new RulesBytes(value.toUint8Array());
+    },
+};
+export const geoPointConverter = {
+    name: 'fb-geopoint-to-rules-latlng',
+    convert(value) {
+        if (!isFbGeoPoint(value))
+            return KEEP;
+        return new LatLng(value.latitude, value.longitude);
+    },
+};
+//# sourceMappingURL=bytes-geopoint.js.map

package/dist/sandbox/firestore/converters/bytes-geopoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes-geopoint.js","sourceRoot":"","sources":["../../../../src/sandbox/firestore/converters/bytes-geopoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAAE,IAAI,EAAuB,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAS1D,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,mDAAmD;IACnD,IAAI,CAAC,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,UAAU;QAChC,OAAO,CAAC,CAAC,YAAY,KAAK,UAAU;QACpC,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAChC,CAAC;AACJ,CAAC;AASD,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,mDAAmD;IACnD,IAAI,CAAC,YAAY,MAAM;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,yBAAyB;IAC/B,OAAO,CAAC,KAAK;QACX,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,6BAA6B;IACnC,OAAO,CAAC,KAAK;QACX,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF,CAAC"}