pyric 0.0.1 → 0.1.0-alpha.8

package/dist/sandbox/firestore/admin-compat/doc-ref.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `DocumentRefImpl` — Admin-SDK-compat `DocumentReference` backed by
+ * `LocalEnvironment`.
+ *
+ * Ported from bench's `pilot/src/firestore-wrapper.ts:213-270`. The
+ * behavioral nuance worth a comment is `set()`: the simulator's
+ * evaluator wants distinct `'create'` / `'update'` rule clauses (no
+ * `allow set:` syntax). So `set()` peeks at `getDocument(path)`,
+ * dispatches to `create` if absent / `update` if present.
+ *
+ * Differences from the bench source:
+ *   - Plain `Error` throws → `FirestoreCompatError` with the typed
+ *     `FirestoreErrorCode` from the SDK's `OperationResult.error`.
+ *     Falls back to `'permission-denied'` if the simulator returned a
+ *     denial without a structured error (defense-in-depth — slice-1
+ *     review locked that every denial carries `error`, but the
+ *     fallback keeps the wrapper honest if that invariant ever slips).
+ *   - The `update`-as-partial vs Firestore-`set`-as-replace divergence
+ *     is documented (and locked) at the design-doc level — see
+ *     the design rationale.
+ */
+import type { LocalEnvironment } from 'pyric/sandbox/internal';
+import { type AuthContext, type CollectionReference, type DocumentData, type DocumentReference, type DocumentSnapshot, type OperationOptions, type SetOptions } from './types.js';
+export declare class DocumentRefImpl implements DocumentReference {
+    private readonly env;
+    private readonly auth;
+    private readonly bypassRules;
+    readonly id: string;
+    readonly path: string;
+    constructor(env: LocalEnvironment, auth: AuthContext, path: string, bypassRules?: boolean);
+    get parent(): CollectionReference;
+    collection(name: string): CollectionReference;
+    get(opts?: OperationOptions): Promise<DocumentSnapshot>;
+    set(data: DocumentData, options?: SetOptions): Promise<void>;
+    update(data: DocumentData, opts?: OperationOptions): Promise<void>;
+    delete(opts?: OperationOptions): Promise<void>;
+}
+//# sourceMappingURL=doc-ref.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-ref.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/doc-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAsBpB,qBAAa,eAAgB,YAAW,iBAAiB;IAKrD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAIrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAT9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGH,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EAClC,IAAI,EAAE,MAAM,EAGK,WAAW,GAAE,OAAe;IAM/C,IAAI,MAAM,IAAI,mBAAmB,CAOhC;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAIvC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBvD,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD5D,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,MAAM,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CASrD"}

package/dist/sandbox/firestore/admin-compat/doc-ref.js

@@ -0,0 +1,154 @@
+/**
+ * `DocumentRefImpl` — Admin-SDK-compat `DocumentReference` backed by
+ * `LocalEnvironment`.
+ *
+ * Ported from bench's `pilot/src/firestore-wrapper.ts:213-270`. The
+ * behavioral nuance worth a comment is `set()`: the simulator's
+ * evaluator wants distinct `'create'` / `'update'` rule clauses (no
+ * `allow set:` syntax). So `set()` peeks at `getDocument(path)`,
+ * dispatches to `create` if absent / `update` if present.
+ *
+ * Differences from the bench source:
+ *   - Plain `Error` throws → `FirestoreCompatError` with the typed
+ *     `FirestoreErrorCode` from the SDK's `OperationResult.error`.
+ *     Falls back to `'permission-denied'` if the simulator returned a
+ *     denial without a structured error (defense-in-depth — slice-1
+ *     review locked that every denial carries `error`, but the
+ *     fallback keeps the wrapper honest if that invariant ever slips).
+ *   - The `update`-as-partial vs Firestore-`set`-as-replace divergence
+ *     is documented (and locked) at the design-doc level — see
+ *     the design rationale.
+ */
+import { makeError } from 'pyric/sandbox/internal';
+import { lastSegment, parentCollectionPath } from './paths.js';
+import { makeDocSnapshot } from './snapshots.js';
+import { CollectionRefImpl } from './query.js';
+import { FirestoreCompatError, } from './types.js';
+/**
+ * Convert a denied `OperationResult` into a typed throwable. Prefers
+ * the result's structured error; falls back to `'permission-denied'`
+ * with a stitched-together message from `debugMessages`.
+ */
+function throwFromDenial(result, contextLabel) {
+    if (result.error) {
+        throw new FirestoreCompatError(result.error);
+    }
+    const msg = result.debugMessages.length > 0
+        ? result.debugMessages.join('; ')
+        : '(no debug message)';
+    throw new FirestoreCompatError(makeError('permission-denied', `${contextLabel}: ${msg}`));
+}
+export class DocumentRefImpl {
+    env;
+    auth;
+    bypassRules;
+    id;
+    path;
+    constructor(env, auth, path, 
+    // Studio admin lens (Gap #2) — stamped onto every Operation this ref
+    // issues. Inherited by child collection refs. Default false.
+    bypassRules = false) {
+        this.env = env;
+        this.auth = auth;
+        this.bypassRules = bypassRules;
+        this.path = path;
+        this.id = lastSegment(path);
+    }
+    get parent() {
+        return new CollectionRefImpl(this.env, this.auth, parentCollectionPath(this.path), this.bypassRules);
+    }
+    collection(name) {
+        return new CollectionRefImpl(this.env, this.auth, `${this.path}/${name}`, this.bypassRules);
+    }
+    async get(opts) {
+        const result = this.env.execute({
+            method: 'get',
+            path: this.path,
+            auth: opts?.auth !== undefined ? opts.auth : this.auth,
+            bypassRules: this.bypassRules,
+        });
+        if (!result.allowed)
+            throwFromDenial(result, 'get denied');
+        // execute() returns `data: undefined` for "denied" and `data: null`
+        // for "doc absent (rule allowed)". makeDocSnapshot treats both as
+        // "not exists", which matches Admin SDK's `snap.exists === false`
+        // for a get of a missing doc.
+        const data = result.data === undefined || result.data === null
+            ? undefined
+            : result.data;
+        return makeDocSnapshot(this, data);
+    }
+    async set(data, options) {
+        // Three branches — each rides on the same execute() pipeline but
+        // chooses a different combination of (rule clause, storage mode):
+        //
+        //   - default: rule clause picked by execute() (create / update),
+        //     storage REPLACES via the `'set'` method. Matches Firestore
+        //     `set(data)` semantics.
+        //   - { merge: true }: shallow-merge every top-level field via the
+        //     `'update'` rule clause + storage update (which merges).
+        //     Falls back to `'create'` when the doc is absent.
+        //   - { mergeFields: [...] }: project `data` to just the listed
+        //     top-level fields, then dispatch the same way as merge:true.
+        const auth = options?.auth !== undefined ? options.auth : this.auth;
+        if (options?.mergeFields !== undefined) {
+            // FS-B6: pass the full data + the field-path mask to the merge
+            // engine. It deep-merges only the listed (dot-separated) paths into
+            // the existing doc — dropping the old shallow top-level projection.
+            const mergeFields = options.mergeFields.map((f) => String(f));
+            const existing = this.env.getDocument(this.path);
+            const method = existing === null ? 'create' : 'update';
+            const result = this.env.execute({
+                method, path: this.path, data, auth, merge: { mergeFields },
+                bypassRules: this.bypassRules,
+            });
+            if (!result.allowed)
+                throwFromDenial(result, `set denied (as ${method})`);
+            return;
+        }
+        if (options?.merge === true) {
+            // FS-B6: deep-merge nested maps into the existing doc instead of the
+            // old shallow top-level spread.
+            const existing = this.env.getDocument(this.path);
+            const method = existing === null ? 'create' : 'update';
+            const result = this.env.execute({
+                method, path: this.path, data, auth, merge: true,
+                bypassRules: this.bypassRules,
+            });
+            if (!result.allowed)
+                throwFromDenial(result, `set denied (as ${method})`);
+            return;
+        }
+        // Default — replace semantics. The simulator's `'set'` method
+        // translates to `create` / `update` for rules eval but routes to
+        // `state.set` (replace) for storage.
+        const result = this.env.execute({
+            method: 'set', path: this.path, data, auth,
+            bypassRules: this.bypassRules,
+        });
+        if (!result.allowed)
+            throwFromDenial(result, 'set denied');
+    }
+    async update(data, opts) {
+        const result = this.env.execute({
+            method: 'update',
+            path: this.path,
+            data,
+            auth: opts?.auth !== undefined ? opts.auth : this.auth,
+            bypassRules: this.bypassRules,
+        });
+        if (!result.allowed)
+            throwFromDenial(result, 'update denied');
+    }
+    async delete(opts) {
+        const result = this.env.execute({
+            method: 'delete',
+            path: this.path,
+            auth: opts?.auth !== undefined ? opts.auth : this.auth,
+            bypassRules: this.bypassRules,
+        });
+        if (!result.allowed)
+            throwFromDenial(result, 'delete denied');
+    }
+}
+//# sourceMappingURL=doc-ref.js.map

package/dist/sandbox/firestore/admin-compat/doc-ref.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * `FirestoreImpl` — top-level Admin-SDK-compat handle backed by a
+ * `LocalEnvironment`.
+ *
+ * Path-shape validation lives at the input boundary so a typo'd path
+ * surfaces as `'invalid-argument'` rather than a downstream
+ * `'unimplemented'`/`'permission-denied'` blur. Slice 4 wires the
+ * remaining method bodies (batch, runTransaction).
+ *
+ * `runTransaction` carries two locked translations:
+ *
+ *   - **Divergence #4-A:** the simulator throws `ReadAfterWriteError`
+ *     (a plain `Error` subclass carrying `.simError`) when a tx reads
+ *     after writing. Translate the throw into a typed
+ *     `FirestoreCompatError { code: 'failed-precondition' }` so
+ *     callers can `if (e.code === 'failed-precondition')` without
+ *     instanceof-checking against an SDK-internal class.
+ *
+ *   - **Divergence #4-B:** the simulator's `transaction()` returns
+ *     `TransactionResult.allowed === false` (with a typed `error`)
+ *     when a queued write fails at commit (e.g., `tx.create` on an
+ *     existing doc). Surface the typed error directly so the
+ *     `'already-exists'` code reaches the caller.
+ *
+ * The `await` on the env.transaction call is load-bearing: bench
+ * wrapper line 195 documents that without it, an async callback
+ * leaves `result` as a Promise object whose `.allowed` is undefined,
+ * which we'd then misread as a denial.
+ *
+ * See the design rationale for slice contracts.
+ */
+import type { LocalEnvironment } from 'pyric/sandbox/internal';
+import { type AuthContext, type CollectionReference, type DocumentReference, type Firestore, type OperationOptions, type Query, type Transaction, type WriteBatch } from './types.js';
+export declare class FirestoreImpl implements Firestore {
+    private readonly env;
+    private readonly auth;
+    private readonly bypassRules;
+    constructor(env: LocalEnvironment, auth: AuthContext, bypassRules?: boolean);
+    collection(path: string): CollectionReference;
+    doc(path: string): DocumentReference;
+    collectionGroup(collectionId: string): Query;
+    batch(): WriteBatch;
+    runTransaction<R>(fn: (tx: Transaction) => Promise<R> | R, opts?: OperationOptions): Promise<R>;
+}
+//# sourceMappingURL=firestore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/firestore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAc,YAAW,SAAS;IAE3C,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAKrB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBANX,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,WAAW,EAKjB,WAAW,GAAE,OAAe;IAG/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB;IAY7C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAYpC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK;IAc5C,KAAK,IAAI,UAAU;IAIb,cAAc,CAAC,CAAC,EACpB,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACvC,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,CAAC,CAAC;CA0Cd"}

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

@@ -0,0 +1,114 @@
+/**
+ * `FirestoreImpl` — top-level Admin-SDK-compat handle backed by a
+ * `LocalEnvironment`.
+ *
+ * Path-shape validation lives at the input boundary so a typo'd path
+ * surfaces as `'invalid-argument'` rather than a downstream
+ * `'unimplemented'`/`'permission-denied'` blur. Slice 4 wires the
+ * remaining method bodies (batch, runTransaction).
+ *
+ * `runTransaction` carries two locked translations:
+ *
+ *   - **Divergence #4-A:** the simulator throws `ReadAfterWriteError`
+ *     (a plain `Error` subclass carrying `.simError`) when a tx reads
+ *     after writing. Translate the throw into a typed
+ *     `FirestoreCompatError { code: 'failed-precondition' }` so
+ *     callers can `if (e.code === 'failed-precondition')` without
+ *     instanceof-checking against an SDK-internal class.
+ *
+ *   - **Divergence #4-B:** the simulator's `transaction()` returns
+ *     `TransactionResult.allowed === false` (with a typed `error`)
+ *     when a queued write fails at commit (e.g., `tx.create` on an
+ *     existing doc). Surface the typed error directly so the
+ *     `'already-exists'` code reaches the caller.
+ *
+ * The `await` on the env.transaction call is load-bearing: bench
+ * wrapper line 195 documents that without it, an async callback
+ * leaves `result` as a Promise object whose `.allowed` is undefined,
+ * which we'd then misread as a denial.
+ *
+ * See the design rationale for slice contracts.
+ */
+import { makeError } from 'pyric/sandbox/internal';
+import { ReadAfterWriteError } from 'pyric/sandbox/internal';
+import { isCollectionPath, isDocumentPath } from './paths.js';
+import { CollectionGroupQueryImpl, CollectionRefImpl } from './query.js';
+import { DocumentRefImpl } from './doc-ref.js';
+import { WriteBatchImpl } from './batch.js';
+import { TransactionImpl } from './transaction.js';
+import { FirestoreCompatError, } from './types.js';
+export class FirestoreImpl {
+    env;
+    auth;
+    bypassRules;
+    constructor(env, auth, 
+    // Studio admin lens (Gap #2): when true, every op produced by this
+    // handle (and the refs/batch/tx it spawns) carries `bypassRules`, so
+    // the LocalEnvironment skips rule evaluation. Threaded down to each
+    // child impl alongside `auth`. Default false → rules enforced.
+    bypassRules = false) {
+        this.env = env;
+        this.auth = auth;
+        this.bypassRules = bypassRules;
+    }
+    collection(path) {
+        if (!isCollectionPath(path)) {
+            throw new FirestoreCompatError(makeError('invalid-argument', `collection path must have an odd number of segments: ${path}`));
+        }
+        return new CollectionRefImpl(this.env, this.auth, path, this.bypassRules);
+    }
+    doc(path) {
+        if (!isDocumentPath(path)) {
+            throw new FirestoreCompatError(makeError('invalid-argument', `document path must have an even number of segments: ${path}`));
+        }
+        return new DocumentRefImpl(this.env, this.auth, path, this.bypassRules);
+    }
+    collectionGroup(collectionId) {
+        if (collectionId.length === 0 || collectionId.includes('/')) {
+            throw new FirestoreCompatError(makeError('invalid-argument', `collection group id must be a single non-empty segment with no '/': ${collectionId}`));
+        }
+        return new CollectionGroupQueryImpl(this.env, this.auth, collectionId, [], [], undefined, false, undefined, undefined, this.bypassRules);
+    }
+    batch() {
+        return new WriteBatchImpl(this.env, this.auth, this.bypassRules);
+    }
+    async runTransaction(fn, opts) {
+        let result;
+        try {
+            // The await is load-bearing: see header for the bench-line-195
+            // note. Sync-callback path collapses through the same await with
+            // no functional difference.
+            result = await this.env.transaction((simTx) => {
+                const tx = new TransactionImpl(simTx);
+                return fn(tx);
+            }, {
+                auth: opts?.auth !== undefined ? opts.auth : this.auth,
+                bypassRules: this.bypassRules,
+            });
+        }
+        catch (e) {
+            // Divergence #4-A: ReadAfterWriteError → typed
+            // 'failed-precondition'. Other throws (callback throws, sentinel
+            // resolution errors that escape to here) propagate untouched —
+            // they aren't wrapper-translatable.
+            if (e instanceof ReadAfterWriteError) {
+                throw new FirestoreCompatError(e.simError);
+            }
+            throw e;
+        }
+        if (!result.allowed) {
+            // Divergence #4-B (and the broader denial case): the simulator
+            // attaches a typed `error` to any non-allowed result. Surface
+            // it directly so codes like 'already-exists' reach the caller.
+            if (result.error) {
+                throw new FirestoreCompatError(result.error);
+            }
+            // Defensive — should be unreachable under Item 6 invariant.
+            const denied = result.writes.find((w) => !w.allowed);
+            const msg = denied?.debugMessages.join('; ') ?? 'transaction denied at commit';
+            throw new FirestoreCompatError(makeError('permission-denied', `transaction failed: ${msg}`));
+        }
+        return result.returnValue;
+    }
+}
+//# sourceMappingURL=firestore.js.map

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

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

package/dist/sandbox/firestore/admin-compat/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Admin-SDK-compat Firestore wrapper for `LocalEnvironment`.
+ *
+ * Lets agent code written against the firebase-admin Firestore surface
+ * run unchanged against the SDK's local simulator. Design rationale +
+ * locked divergences live in the design rationale;
+ * implementation slicing in the design rationale.
+ *
+ * Slice 1: shipped public types + a stub `createCompatFirestore`.
+ * Slice 2 (this commit): real `FirestoreImpl` with path-shape validation
+ * on `collection`/`doc`. The collection/doc/batch/runTransaction bodies
+ * still throw `'unimplemented'` until slices 3 + 4 land — but the class
+ * shape is final and the path-validation errors users hit first are
+ * already typed correctly (`invalid-argument`, not `unimplemented`).
+ */
+import type { LocalEnvironment } from 'pyric/sandbox/internal';
+import { type AuthContext, type Firestore } from './types.js';
+export { FirestoreCompatError, FieldValue, Timestamp, } from './types.js';
+export type { AggregateField, AggregateQuerySnapshot, AggregateSpec, Filter, AuthContext, CollectionReference, DocumentData, DocumentReference, DocumentSnapshot, FieldValueSentinel, Firestore, FirestoreErrorCode, FirestoreEvalRequest, FirestoreEvalResource, FirestoreSimError, OperationOptions, OrderDirection, Query, QueryDocumentSnapshot, QuerySnapshot, SetOptions, Transaction, WhereFilterOp, WriteBatch, } from './types.js';
+export interface CreateCompatFirestoreOptions {
+    /**
+     * Default auth context applied to every operation. Per-op overrides
+     * land in slice 3 (constructor-default + per-op override pattern from
+     * divergence #6).
+     */
+    auth?: AuthContext;
+    /**
+     * Studio admin lens (Pyric Studio Gap #2). When `true`, the returned
+     * handle's operations BYPASS security rules — every read/write is
+     * treated as ALLOW (the modular-shaped equivalent of `sandbox.admin.*`).
+     * Storage preconditions and the event/listener path are unchanged; only
+     * rule evaluation is skipped. Default `false` → rules enforced under
+     * `auth`. Used by `getAdminFirestore` (see `pyric-admin` and
+     * `pyric/firestore`).
+     */
+    bypassRules?: boolean;
+}
+/**
+ * Construct an Admin-SDK-compat Firestore handle backed by a
+ * `LocalEnvironment`. Slice 2 returns a real `FirestoreImpl` with
+ * working path-shape validation; the per-method bodies still throw
+ * `'unimplemented'` until slices 3 + 4 land.
+ */
+export declare function createCompatFirestore(env: LocalEnvironment, opts?: CreateCompatFirestoreOptions): Firestore;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,MAAM,EACN,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,KAAK,EACL,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,CAAC,EAAE,4BAA4B,GAClC,SAAS,CAEX"}

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

@@ -0,0 +1,27 @@
+/**
+ * Admin-SDK-compat Firestore wrapper for `LocalEnvironment`.
+ *
+ * Lets agent code written against the firebase-admin Firestore surface
+ * run unchanged against the SDK's local simulator. Design rationale +
+ * locked divergences live in the design rationale;
+ * implementation slicing in the design rationale.
+ *
+ * Slice 1: shipped public types + a stub `createCompatFirestore`.
+ * Slice 2 (this commit): real `FirestoreImpl` with path-shape validation
+ * on `collection`/`doc`. The collection/doc/batch/runTransaction bodies
+ * still throw `'unimplemented'` until slices 3 + 4 land — but the class
+ * shape is final and the path-validation errors users hit first are
+ * already typed correctly (`invalid-argument`, not `unimplemented`).
+ */
+import { FirestoreImpl } from './firestore.js';
+export { FirestoreCompatError, FieldValue, Timestamp, } from './types.js';
+/**
+ * Construct an Admin-SDK-compat Firestore handle backed by a
+ * `LocalEnvironment`. Slice 2 returns a real `FirestoreImpl` with
+ * working path-shape validation; the per-method bodies still throw
+ * `'unimplemented'` until slices 3 + 4 land.
+ */
+export function createCompatFirestore(env, opts) {
+    return new FirestoreImpl(env, opts?.auth ?? null, opts?.bypassRules ?? false);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM/C,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAgDpB;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAqB,EACrB,IAAmC;IAEnC,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/sandbox/firestore/admin-compat/paths.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Path helpers for the Admin-SDK-compat Firestore wrapper.
+ *
+ * Ported verbatim from bench's `pilot/src/firestore-wrapper.ts`
+ * (see the design rationale slice 2). Centralized
+ * here so `doc-ref.ts`, `query.ts`, and `firestore.ts` share one
+ * canonical segment-shape understanding — Admin SDK's even-segments-=-doc
+ * /odd-segments-=-collection convention is enforced at the wrapper's
+ * input boundary, before anything reaches `LocalEnvironment`.
+ */
+/**
+ * Split a Firestore path into segments, dropping leading/trailing
+ * slashes. Empty input yields `['']` (downstream callers treat that as
+ * an invalid path via the *Path predicates).
+ */
+export declare function pathSegments(path: string): string[];
+/**
+ * True iff `path` has an even, non-zero segment count — Admin SDK's
+ * shape rule for document paths (`collection/doc[/sub/doc]*`).
+ */
+export declare function isDocumentPath(path: string): boolean;
+/**
+ * True iff `path` has an odd segment count — Admin SDK's shape rule
+ * for collection paths (`collection[/doc/sub]*`).
+ */
+export declare function isCollectionPath(path: string): boolean;
+/**
+ * Last segment of `path`. Used to derive `DocumentReference.id` /
+ * `CollectionReference.id` from full paths.
+ */
+export declare function lastSegment(path: string): string;
+/**
+ * Drop the trailing segment of a document path to get the collection
+ * that contains it. Used by `DocumentReference.parent`.
+ */
+export declare function parentCollectionPath(docPath: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5D"}

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

@@ -0,0 +1,49 @@
+/**
+ * Path helpers for the Admin-SDK-compat Firestore wrapper.
+ *
+ * Ported verbatim from bench's `pilot/src/firestore-wrapper.ts`
+ * (see the design rationale slice 2). Centralized
+ * here so `doc-ref.ts`, `query.ts`, and `firestore.ts` share one
+ * canonical segment-shape understanding — Admin SDK's even-segments-=-doc
+ * /odd-segments-=-collection convention is enforced at the wrapper's
+ * input boundary, before anything reaches `LocalEnvironment`.
+ */
+/**
+ * Split a Firestore path into segments, dropping leading/trailing
+ * slashes. Empty input yields `['']` (downstream callers treat that as
+ * an invalid path via the *Path predicates).
+ */
+export function pathSegments(path) {
+    return path.replace(/^\/+|\/+$/g, '').split('/');
+}
+/**
+ * True iff `path` has an even, non-zero segment count — Admin SDK's
+ * shape rule for document paths (`collection/doc[/sub/doc]*`).
+ */
+export function isDocumentPath(path) {
+    return pathSegments(path).length % 2 === 0 && pathSegments(path).length > 0;
+}
+/**
+ * True iff `path` has an odd segment count — Admin SDK's shape rule
+ * for collection paths (`collection[/doc/sub]*`).
+ */
+export function isCollectionPath(path) {
+    return pathSegments(path).length % 2 === 1;
+}
+/**
+ * Last segment of `path`. Used to derive `DocumentReference.id` /
+ * `CollectionReference.id` from full paths.
+ */
+export function lastSegment(path) {
+    const segs = pathSegments(path);
+    return segs[segs.length - 1] ?? '';
+}
+/**
+ * Drop the trailing segment of a document path to get the collection
+ * that contains it. Used by `DocumentReference.parent`.
+ */
+export function parentCollectionPath(docPath) {
+    const segs = pathSegments(docPath);
+    return segs.slice(0, -1).join('/');
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/sandbox/firestore/admin-compat/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC"}