pyric 0.0.1 → 0.1.0-alpha.7

package/dist/firestore/index.d.ts

@@ -0,0 +1,533 @@
+/**
+ * `pyric/firestore` — modular Web-SDK Firestore adapter for the
+ * Pyric sandbox.
+ *
+ * Mirrors `firebase/firestore`'s tree-shakable free-function shape:
+ * `getDoc`, `setDoc`, `addDoc`, `query`, `where`, `orderBy`, `limit`,
+ * `onSnapshot`, `runTransaction`, etc. All operations route to one of
+ * two backends, picked at init time:
+ *
+ *   - **Sandbox target** — wraps `pyric-admin`'s chainable adapter,
+ *     which sits on `pyric/sandbox`'s `LocalEnvironment`. No
+ *     network. Identity comes from a `SandboxContext`.
+ *   - **Prod target** — wraps `firebase/firestore` against a real
+ *     Firebase project. Identity comes from `firebase/auth`'s
+ *     current user.
+ *
+ * Same call surface across both. Agent code that writes against the
+ * sandbox during iteration runs unmodified against prod at deploy.
+ *
+ * The dual-target machinery lives in two pieces:
+ *   - {@link TARGET_SYMBOL} — hidden brand on every {@link Firestore}
+ *     handle that names the active backend.
+ *   - {@link refToTarget} — WeakMap from refs/queries back to their
+ *     owning target, so chained calls (`query(coll, where(...))`,
+ *     `getDocs(q)`) recover routing without re-tagging at every step.
+ *
+ * Every public function has a `target.kind` switch with explicit
+ * branches — the structure is parallel and grep-friendly.
+ */
+import { Timestamp as ChainTimestamp, FieldValue as ChainFieldValue, SandboxError, type SandboxFirestore, type Query as ChainQuery, type Filter as ChainFilter, type DocumentData, type FieldValueSentinel, type LintResult, type OrderDirection, type Transaction as ChainTransaction, type WhereFilterOp, type WriteBatch as ChainWriteBatch } from 'pyric/sandbox/admin-firestore';
+import type { AuthState, Sandbox, SandboxContext } from 'pyric/sandbox';
+import type { FirebaseApp } from 'firebase/app';
+import * as fb from 'firebase/firestore';
+import { type PyricApp } from 'pyric/app';
+/**
+ * Hidden property on every {@link Firestore} handle. Discriminates
+ * between sandbox and prod backends so free functions can route
+ * without consumer-visible API differences.
+ */
+export declare const TARGET_SYMBOL: unique symbol;
+type SandboxTarget = {
+    kind: 'sandbox';
+    db: SandboxFirestore;
+    sandbox: Sandbox;
+};
+/**
+ * Live-identity sandbox target — built by `getFirestore(sandbox)`.
+ *
+ * Unlike {@link SandboxTarget} (a frozen `SandboxContext` chosen at
+ * `getFirestore(ctx)` time), this variant reads `sandbox.currentUser`
+ * per operation via {@link getDb}. Every op constructs a fresh
+ * `SandboxContext` from the sandbox's *current* `currentUser` and
+ * obtains a chainable handle bound to that ctx.
+ *
+ * Wired into the modular surface so app code that uses both
+ * `pyric/auth` and `pyric/firestore` against the same `Sandbox` sees
+ * live auth-state changes: a `signInAnonymously` / `setUser` call on
+ * the auth side mutates `sandbox.currentUser`, and the next Firestore
+ * op evaluates rules under the new identity.
+ *
+ * `withAuth(null)` is anonymous; `withAuth(state)` is signed-in.
+ */
+type SandboxLiveTarget = {
+    kind: 'sandbox-live';
+    sandbox: Sandbox;
+    getDb: () => SandboxFirestore;
+};
+type ProdTarget = {
+    kind: 'prod';
+    db: fb.Firestore;
+};
+type Target = SandboxTarget | SandboxLiveTarget | ProdTarget;
+/**
+ * Pair of translators between the consumer's app model and the
+ * underlying Firestore representation. Mirrors `firebase/firestore`'s
+ * `FirestoreDataConverter` shape.
+ *
+ *   - `toFirestore(model)` runs on every write (`setDoc`, `addDoc`)
+ *     through a converted ref. Returns the `DocumentData` to send.
+ *   - `fromFirestore(snapshot)` runs on every read (`getDoc`,
+ *     `getDocs`, snapshot listener callback) through a converted ref.
+ *     Receives the raw snapshot, returns the typed model.
+ */
+export interface FirestoreDataConverter<AppModelType, DbModelType extends DocumentData = DocumentData> {
+    toFirestore(modelObject: AppModelType): DbModelType;
+    fromFirestore(snapshot: QueryDocumentSnapshot<DbModelType>): AppModelType;
+}
+/**
+ * Opaque handle returned by {@link getFirestoreSandbox} or
+ * {@link getFirestoreProd}. Carries the target via {@link TARGET_SYMBOL};
+ * never inspected by consumer code.
+ */
+export interface Firestore {
+    readonly [TARGET_SYMBOL]: Target;
+}
+/**
+ * Construct a Firestore handle. Three overloads dispatch by the
+ * input's shape:
+ *
+ *   - `SandboxContext` → sandbox-backed Firestore with a frozen
+ *     identity (the ctx's `auth` chosen at `getFirestore` time). Best
+ *     for runner/test code that names identity explicitly per
+ *     scenario.
+ *   - `Sandbox` → sandbox-backed Firestore that reads
+ *     `sandbox.currentUser` per-call. Best for app code that drives
+ *     identity through `pyric/auth` — every Firestore op evaluates
+ *     rules under whatever user is currently signed in.
+ *   - `FirebaseApp` → prod-backed Firestore (delegates to
+ *     `firebase/firestore`'s `getFirestore(app)`).
+ *
+ * @example
+ * ```ts
+ * // Sandbox, frozen identity (runner / explicit tests).
+ * import { initializeSandbox } from 'pyric/sandbox';
+ * import { getFirestore, doc, setDoc } from 'pyric/firestore';
+ * const sandbox = initializeSandbox();
+ * const db = getFirestore(sandbox.withAuth({ uid: 'alice' }));
+ *
+ * // Sandbox, live identity (app code paired with pyric/auth).
+ * import { initializeSandbox } from 'pyric/sandbox';
+ * import { getAuth, signInAnonymously } from 'pyric/auth';
+ * const sandbox = initializeSandbox();
+ * const auth = getAuth(sandbox);
+ * const db = getFirestore(sandbox); // reads sandbox.currentUser per op
+ * await signInAnonymously(auth);    // subsequent db ops use the new identity
+ *
+ * // Prod.
+ * import { initializeApp } from 'firebase/app';
+ * import { getFirestore } from 'pyric/firestore';
+ * const app = initializeApp(userProjectConfig);
+ * const db = getFirestore(app);
+ * ```
+ */
+export declare function getFirestore(ctx: SandboxContext): Firestore;
+export declare function getFirestore(sandbox: Sandbox): Firestore;
+export declare function getFirestore(app: FirebaseApp): Firestore;
+export declare function getFirestore(app: PyricApp): Firestore;
+/**
+ * A Firestore handle scoped to a specific identity, for multi-user testing.
+ *
+ * `actingAs(sandbox, { uid })` returns a `Firestore` whose ops evaluate security
+ * rules as that user (`request.auth.uid === uid`; custom claims via `token`);
+ * `actingAs(sandbox, null)` is the anonymous (signed-out) path. Multiple
+ * identities over ONE sandbox share the same store, so a write by one is
+ * delivered to another's `onSnapshot`: the basis for multi-user sync testing.
+ *
+ * @example
+ * ```ts
+ * import { initializeSandbox } from 'pyric/sandbox';
+ * import { actingAs, doc, setDoc, onSnapshot } from 'pyric/firestore';
+ * const sandbox = initializeSandbox();
+ * const alice = actingAs(sandbox, { uid: 'alice' });
+ * const bob   = actingAs(sandbox, { uid: 'bob', token: { role: 'member' } });
+ * onSnapshot(doc(bob, 'rooms/r1'), () => {
+ *   // fires when alice writes (same store; rules evaluated as bob)
+ * });
+ * await setDoc(doc(alice, 'rooms/r1'), { owner: 'alice' });
+ * ```
+ *
+ * Thin sugar over `getFirestore(sandbox.withAuth(identity))`; the value is a
+ * named, discoverable seam for multi-user scenarios. See
+ * the design rationale.
+ */
+export declare function actingAs(sandbox: Sandbox, identity: AuthState): Firestore;
+/**
+ * Construct a **rules-bypassing** sandbox Firestore handle — the Pyric
+ * Studio admin lens (Gap #2). Every modular op issued against the returned
+ * handle (`getDoc`/`getDocs`/`setDoc`/`updateDoc`/`deleteDoc`/`addDoc`/
+ * `count`/`writeBatch`/`runTransaction`) SKIPS security-rule evaluation and
+ * is treated as ALLOW, while still going through the same store + emitting
+ * the same events + waking the same listeners. This is the modular sibling
+ * of the path-string `sandbox.admin.*` bypass; it reuses the underlying
+ * `LocalEnvironment` bypass execution path (the `bypassRules` op flag),
+ * not a parallel reimplementation.
+ *
+ * Sandbox-only. There is no prod analog (you cannot bypass deployed
+ * security rules from a client), so this overload set accepts only a
+ * `Sandbox` / `SandboxContext` / sandbox-backed `PyricApp` — never a
+ * `FirebaseApp`. Admin ops are identity-agnostic (rules are off), so the
+ * handle is a FROZEN `sandbox` target: it does not track
+ * `sandbox.currentUser`.
+ *
+ * Intended for Studio's "edit anything as admin" surfaces (F2) and the
+ * serve worker's `{ mode: 'admin' }` auth lens. For rules-applied
+ * impersonation ("act as this user"), use `getFirestore(sandbox.withAuth({
+ * uid }))` instead.
+ *
+ * @example
+ * ```ts
+ * import { initializeSandbox } from 'pyric/sandbox';
+ * import { getAdminFirestore, doc, setDoc } from 'pyric/firestore';
+ * const sandbox = initializeSandbox();
+ * const adminDb = getAdminFirestore(sandbox);
+ * await setDoc(doc(adminDb, 'locked/x'), { a: 1 }); // bypasses rules
+ * ```
+ */
+export declare function getAdminFirestore(sandbox: Sandbox): Firestore;
+export declare function getAdminFirestore(ctx: SandboxContext): Firestore;
+export declare function getAdminFirestore(app: PyricApp): Firestore;
+/** A reference to a Firestore document. Backend-opaque. */
+export interface DocumentReference<_T = DocumentData> {
+    readonly id: string;
+    readonly path: string;
+}
+/** A reference to a Firestore collection. Backend-opaque. */
+export interface CollectionReference<_T = DocumentData> {
+    readonly id: string;
+    readonly path: string;
+}
+/** A Firestore query (a collection ref or one with where/orderBy/limit applied). */
+export interface Query<_T = DocumentData> {
+    readonly _isQuery?: true;
+}
+/** A point-in-time view of one document. */
+export interface DocumentSnapshot<T = DocumentData> {
+    readonly id: string;
+    readonly exists: boolean | (() => boolean);
+    data(): T | undefined;
+}
+/**
+ * `QueryDocumentSnapshot` is a `DocumentSnapshot` known to exist —
+ * `.data()` always returns the typed model, never `undefined`. Yielded
+ * by `QuerySnapshot.docs` and passed to converter `fromFirestore`
+ * callbacks. Mirrors the JS SDK's narrowing.
+ */
+export interface QueryDocumentSnapshot<T = DocumentData> extends DocumentSnapshot<T> {
+    data(): T;
+}
+/** A point-in-time view of a query result. */
+export interface QuerySnapshot<T = DocumentData> {
+    readonly size: number;
+    readonly empty: boolean;
+    readonly docs: ReadonlyArray<QueryDocumentSnapshot<T>>;
+}
+export type WriteBatch = ChainWriteBatch | fb.WriteBatch;
+export type Transaction = ChainTransaction | fb.Transaction;
+export type Unsubscribe = () => void;
+export type { AuthState, Sandbox, SandboxContext, DocumentData, FieldValueSentinel, LintResult, OrderDirection, WhereFilterOp, FirebaseApp, };
+export { SandboxError };
+export { Bytes, GeoPoint, documentId, FieldPath, vector, VectorValue, } from 'firebase/firestore';
+/** True when two `DocumentReference`s point at the same path under
+ *  the same target. */
+export declare function refEqual(a: DocumentReference, b: DocumentReference): boolean;
+/** True when two `Query`s are structurally identical (same source +
+ *  same constraint chain). */
+export declare function queryEqual(a: Query, b: Query): boolean;
+/** True when two `DocumentSnapshot` / `QuerySnapshot` pairs describe
+ *  the same underlying data + path. */
+export declare function snapshotEqual(a: DocumentSnapshot | QuerySnapshot, b: DocumentSnapshot | QuerySnapshot): boolean;
+/**
+ * Point the prod-target Firestore handle at the Firestore emulator.
+ * Must be called BEFORE any operation runs against `db`. No-op on
+ * sandbox-target handles (the sandbox IS a local emulator).
+ *
+ * `options` mirrors `firebase/firestore`'s shape — pass
+ * `{ mockUserToken: '…' }` to bypass auth checks under the emulator,
+ * matching how the JS SDK lets tests skip Firebase Auth.
+ */
+export declare function connectFirestoreEmulator(db: Firestore, host: string, port: number, options?: {
+    mockUserToken?: string | fb.EmulatorMockTokenOptions;
+}): void;
+export declare function doc<T = DocumentData>(parent: Firestore | CollectionReference<T>, ...pathSegments: string[]): DocumentReference<T>;
+/**
+ * Cross-collection query — scans every document under every
+ * collection whose final segment matches `collectionId`. Mirrors
+ * `firebase/firestore`'s `collectionGroup(db, id)` shape.
+ *
+ * Returned `Query` accepts the same `where` / `orderBy` / `limit`
+ * constraints as any other query.
+ */
+export declare function collectionGroup(db: Firestore, collectionId: string): Query;
+export declare function collection(parent: Firestore | DocumentReference, ...pathSegments: string[]): CollectionReference;
+export declare function getDoc<T = DocumentData>(ref: DocumentReference<T>): Promise<DocumentSnapshot<T>>;
+export declare function getDocs<T = DocumentData>(query: Query<T>): Promise<QuerySnapshot<T>>;
+/**
+ * Modular Web-SDK-shaped `SetOptions`. Either flag controls how `data`
+ * combines with the existing document; passing nothing replaces the
+ * existing doc entirely (Firestore default).
+ *
+ *   - `{ merge: true }` — shallow-merge every top-level field in
+ *     `data` into the existing document, preserving fields not in
+ *     `data`. Equivalent to `firebase/firestore`'s `setDoc(ref, data,
+ *     { merge: true })`.
+ *   - `{ mergeFields: [...] }` — project `data` to just the listed
+ *     top-level fields, then merge. Other fields in `data` are
+ *     ignored; other fields in the existing doc are preserved.
+ *
+ * `merge` and `mergeFields` are mutually exclusive; passing both is
+ * a programming error (`mergeFields` wins on the sandbox path,
+ * matching the JS SDK's effective behavior).
+ */
+export interface SetOptions {
+    merge?: boolean;
+    mergeFields?: readonly string[];
+}
+export declare function setDoc<T = DocumentData>(ref: DocumentReference<T>, data: T, options?: SetOptions): Promise<void>;
+/**
+ * `updateDoc` does NOT run the converter. Matches `firebase/firestore`'s
+ * Web SDK shape — partial updates can target any subset of fields, so
+ * a translator built around a full `AppModelType` would be a type-shape
+ * mismatch. Use the underlying `DocumentData` view (`withConverter(ref,
+ * null)`) for typed-and-untyped mixed access if you need both styles
+ * against the same path.
+ */
+export declare function updateDoc(ref: DocumentReference, data: DocumentData): Promise<void>;
+export declare function deleteDoc(ref: DocumentReference): Promise<void>;
+export declare function addDoc<T = DocumentData>(coll: CollectionReference<T>, data: T): Promise<DocumentReference<T>>;
+export declare function withConverter<AppModel, DbModel extends DocumentData = DocumentData>(ref: DocumentReference<DocumentData>, converter: FirestoreDataConverter<AppModel, DbModel>): DocumentReference<AppModel>;
+export declare function withConverter(ref: DocumentReference<unknown>, converter: null): DocumentReference<DocumentData>;
+export declare function withConverter<AppModel, DbModel extends DocumentData = DocumentData>(ref: CollectionReference<DocumentData>, converter: FirestoreDataConverter<AppModel, DbModel>): CollectionReference<AppModel>;
+export declare function withConverter(ref: CollectionReference<unknown>, converter: null): CollectionReference<DocumentData>;
+export declare function withConverter<AppModel, DbModel extends DocumentData = DocumentData>(q: Query<DocumentData>, converter: FirestoreDataConverter<AppModel, DbModel>): Query<AppModel>;
+export declare function withConverter(q: Query<unknown>, converter: null): Query<DocumentData>;
+export interface QueryConstraint {
+    applySandbox(q: ChainQuery): ChainQuery;
+    applyProd(q: fb.Query): fb.Query;
+    /**
+     * Internal — the filter representation for composite-filter
+     * composition. `where()` populates it as a leaf; `or()` / `and()`
+     * combine sub-constraints' filters into a composite tree. Non-filter
+     * constraints (`orderBy`, `limit`) leave it undefined; passing one
+     * to `or()` / `and()` throws.
+     */
+    _sandboxFilter?: ChainFilter;
+    _fbFilter?: fb.QueryFilterConstraint;
+}
+export declare function query<T = DocumentData>(source: CollectionReference<T> | Query<T>, ...constraints: QueryConstraint[]): Query<T>;
+export declare function where(field: string, op: WhereFilterOp, value: unknown): QueryConstraint;
+/**
+ * OR composite — at least one of the inner constraints must match.
+ * Each argument must itself be a filter constraint (`where()`, or
+ * nested `or()` / `and()`); passing `orderBy()` or `limit()` here is
+ * a type error at runtime.
+ *
+ * Mirrors `firebase/firestore`'s `or(...filters)` shape.
+ */
+export declare function or(...filters: QueryConstraint[]): QueryConstraint;
+/**
+ * AND composite. Same shape as `or()` but every inner constraint
+ * must match. Useful inside an `or()` to combine constraints that
+ * would otherwise be at the top level.
+ */
+export declare function and(...filters: QueryConstraint[]): QueryConstraint;
+export declare function orderBy(field: string, direction?: OrderDirection): QueryConstraint;
+export declare function limit(n: number): QueryConstraint;
+/**
+ * Limit the query to the LAST `n` documents in the ordered result.
+ * Requires at least one `orderBy` on the query (production-aligned —
+ * the simulator throws at execute time without one).
+ */
+export declare function limitToLast(n: number): QueryConstraint;
+/**
+ * Start the query at the document whose ordered field values match
+ * the cursor. Inclusive — the document at the cursor IS included in
+ * the result. Two overloads:
+ *
+ *   `startAt(snapshot)` — values come from `snapshot.data()` indexed
+ *     by the query's orderBy fields.
+ *   `startAt(...values)` — explicit positional values (one per
+ *     orderBy clause).
+ */
+export declare function startAt(snapshot: DocumentSnapshot): QueryConstraint;
+export declare function startAt(...values: unknown[]): QueryConstraint;
+/** Same as `startAt`, but EXCLUDES the document at the cursor — the
+ *  result starts at the next ordered position. */
+export declare function startAfter(snapshot: DocumentSnapshot): QueryConstraint;
+export declare function startAfter(...values: unknown[]): QueryConstraint;
+/** End the query at the document whose ordered field values match
+ *  the cursor. Inclusive — the document at the cursor IS included. */
+export declare function endAt(snapshot: DocumentSnapshot): QueryConstraint;
+export declare function endAt(...values: unknown[]): QueryConstraint;
+/** Same as `endAt`, but EXCLUDES the document at the cursor — the
+ *  result ends at the prior ordered position. */
+export declare function endBefore(snapshot: DocumentSnapshot): QueryConstraint;
+export declare function endBefore(...values: unknown[]): QueryConstraint;
+/**
+ * Aggregate-field descriptor returned by `count()` / `sum(field)` /
+ * `average(field)`. Pyric-native; both targets accept it.
+ */
+export type AggregateField = {
+    readonly kind: 'count';
+} | {
+    readonly kind: 'sum';
+    readonly field: string;
+} | {
+    readonly kind: 'average';
+    readonly field: string;
+};
+/** Spec passed to `getAggregateFromServer(query, spec)`. */
+export type AggregateSpec = Record<string, AggregateField>;
+/**
+ * Snapshot returned by `getCountFromServer` /
+ * `getAggregateFromServer`. `.data()` returns the computed numbers
+ * keyed by the spec's aliases (or `{ count: number }` for the
+ * count-only entry point).
+ */
+export interface AggregateQuerySnapshot<T extends Record<string, number | null> = Record<string, number | null>> {
+    data(): T;
+}
+/** Factory: count() aggregate. */
+export declare function count(): AggregateField;
+/** Factory: sum-of-`field` aggregate. */
+export declare function sum(field: string): AggregateField;
+/** Factory: average-of-`field` aggregate. */
+export declare function average(field: string): AggregateField;
+/**
+ * Count documents matching the query. Returns a snapshot whose
+ * `.data()` yields `{ count: N }` — same shape `firebase/firestore`'s
+ * `getCountFromServer` produces.
+ */
+export declare function getCountFromServer(source: Query | CollectionReference): Promise<AggregateQuerySnapshot<{
+    count: number;
+}>>;
+/**
+ * Run a multi-field aggregate against the query. Spec entries are
+ * keyed by caller-chosen aliases; the returned snapshot's `.data()`
+ * uses the same keys.
+ *
+ * Sandbox target dispatches straight into the chainable adapter.
+ * Prod target translates pyric's `AggregateField` shapes into
+ * `firebase/firestore` AggregateField instances (`fb.count()`,
+ * `fb.sum(...)`, `fb.average(...)`) before delegating.
+ */
+export declare function getAggregateFromServer<S extends AggregateSpec>(source: Query | CollectionReference, spec: S): Promise<AggregateQuerySnapshot<{
+    [K in keyof S]: number | null;
+}>>;
+export interface SnapshotListenOptions {
+    includeMetadataChanges?: boolean;
+}
+export interface SnapshotObserver<T> {
+    next?: (snapshot: T) => void;
+    error?: (error: unknown) => void;
+    complete?: () => void;
+}
+export declare function onSnapshot<T extends DocumentReference | Query>(ref: T, observerOrNext: SnapshotObserver<unknown> | ((snap: unknown) => void), errorOrNothing?: ((error: unknown) => void)): Unsubscribe;
+export declare function onSnapshot<T extends DocumentReference | Query>(ref: T, options: SnapshotListenOptions, observerOrNext: SnapshotObserver<unknown> | ((snap: unknown) => void), errorOrNothing?: ((error: unknown) => void)): Unsubscribe;
+export declare function runTransaction<R>(db: Firestore, fn: (tx: Transaction) => Promise<R> | R): Promise<R>;
+export declare function writeBatch(db: Firestore): WriteBatch;
+/**
+ * Sandbox lifecycle operations. Only meaningful against a
+ * sandbox-target `Firestore` (built via `getFirestore(ctx)` with a
+ * `SandboxContext`). Each function throws `SandboxError` when
+ * handed a prod-target handle.
+ *
+ * **Naming note**: the `sandbox` export name conflicts with the
+ * common local variable from `initializeSandbox()` (which also
+ * returns a `Sandbox` typically held as `const sandbox = …`).
+ * When both are in scope, alias the import:
+ *
+ * ```ts
+ * import { sandbox as sandboxOps } from 'pyric/firestore';
+ * import { initializeSandbox } from 'pyric/sandbox';
+ *
+ * const sandbox = initializeSandbox();      // local var
+ * const db = getFirestore(sandbox.withAuth(…));
+ * sandboxOps.setRules(db, RULES);            // SDK ops
+ * ```
+ *
+ * The `sandbox` name was kept because it accurately describes the
+ * surface (sandbox-only lifecycle). The renaming alternatives —
+ * `sbx`, `firestoreSandbox`, `localOps` — all read worse than the
+ * import-time alias.
+ */
+export declare const sandbox: {
+    /** Load a rules source into the underlying `LocalEnvironment`. */
+    setRules(db: Firestore, rules: string): LintResult;
+    /** Bulk-load documents bypassing rules. */
+    seedDocuments(db: Firestore, documents: Record<string, DocumentData>): LintResult;
+    /** Dump every document the underlying `LocalEnvironment` has stored. */
+    snapshotState(db: Firestore): Record<string, DocumentData>;
+    /**
+     * Single-call diagnostic an agent uses to answer "what state is the
+     * sandbox in?" without grepping internal modules. Born out of
+     * CLAUDE_DEBUG_SESSION.md: a real agent took 51 tool calls + 72k
+     * tokens to figure out that the scaffold's rules weren't loaded.
+     *
+     * Returns: current rules source, lint summary, doc count by
+     * collection, recent denials, recent requests. Stable JSON shape —
+     * marshalled over MCP by `sandbox_inspect`.
+     */
+    inspect(db: Firestore, opts?: {
+        recentEventLimit?: number;
+    }): SandboxInspect;
+};
+/**
+ * Shape returned by {@link sandbox.inspect}. Stable JSON-serializable
+ * surface — agents marshal this over MCP.
+ */
+export interface SandboxInspect {
+    rules: {
+        source: string;
+        sizeBytes: number;
+        isEmpty: boolean;
+        lint: {
+            errors: number;
+            warnings: number;
+            info: number;
+            findings: Array<{
+                rule: string;
+                severity: string;
+                message: string;
+            }>;
+        };
+    };
+    documents: {
+        totalCount: number;
+        byCollection: Record<string, number>;
+    };
+    events: {
+        totalCount: number;
+        recentDenials: Array<{
+            path: string;
+            method: string;
+            auth: unknown;
+            debugMessage?: string;
+        }>;
+        recentRequests: Array<{
+            path: string;
+            method: string;
+            result: string;
+            auth: unknown;
+        }>;
+    };
+}
+export { ChainFieldValue as FieldValue, ChainTimestamp as Timestamp };
+export declare function serverTimestamp(): FieldValueSentinel;
+export declare function increment(n: number): FieldValueSentinel;
+export declare function arrayUnion(...values: unknown[]): FieldValueSentinel;
+export declare function arrayRemove(...values: unknown[]): FieldValueSentinel;
+export declare function deleteField(): FieldValueSentinel;
+export { createFirestoreDataTools, createFirestoreInspectTools } from './tools.js';
+export type { FirestoreDataToolDeps, UserAuth, As } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

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

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