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

package/dist/firestore/persistence.js

@@ -1,6 +1,17 @@
+/**
+ * `pyric/firestore` — offline / persistence / network + cache-init family.
+ *
+ * The honest-mirror surface a real app's init sequence touches: persistence
+ * toggles, network enable/disable, the inert cache/tab-manager/GC config
+ * tokens, `initializeFirestore`, the get-from-server / get-from-cache read
+ * variants, `setLogLevel`, and `onSnapshotsInSync`. Read the section note
+ * below before touching any function.
+ */
+import { readDocument, readQuery } from './reads.js';
+import { beginFirestoreActivity } from './sdk-activity.js';
+import { finishSdkRead } from '../sandbox/internal/sdk-activity.js';
 import { tag, targetForTermination, targetOf } from './state.js';
 import { getFirestore } from './instances.js';
-import { getDoc, getDocs } from './reads.js';
 import { clientStateFor } from './client-state.js';
 /**
  * Enables the persistence lifecycle before first use. As in the browser SDK,
@@ -202,12 +213,12 @@ export function initializeFirestore(app, _settings, _databaseId) {
  * same honest thing.
  *
  */
-export function getDocFromServer(ref) {
-    return getDoc(ref);
+export async function getDocFromServer(ref) {
+    return readDocument(ref, beginFirestoreActivity(targetOf(ref), ref, 'getDocFromServer', 'operation'));
 }
 /** Query-plural form of {@link getDocFromServer}. */
-export function getDocsFromServer(query) {
-    return getDocs(query);
+export async function getDocsFromServer(query) {
+    return readQuery(query, beginFirestoreActivity(targetOf(query), query, 'getDocsFromServer', 'operation'));
 }
 /**
  * Sandbox: delegates to {@link getDoc}. Real Firebase THROWS
@@ -220,13 +231,15 @@ export function getDocsFromServer(query) {
 export function getDocFromCache(ref) {
     const target = targetOf(ref);
     const client = clientStateFor(target);
+    const activity = beginFirestoreActivity(target, ref, 'getDocFromCache', 'operation');
     try {
         client.assertPathCached(ref.path);
     }
     catch (error) {
+        activity.fail();
         return Promise.reject(error);
     }
-    return getDoc(ref).then((snapshot) => {
+    return readDocument(ref, activity).then((snapshot) => {
         Object.defineProperty(snapshot, 'metadata', {
             value: Object.freeze({
                 fromCache: true,
@@ -241,15 +254,16 @@ export function getDocFromCache(ref) {
 export function getDocsFromCache(query) {
     const target = targetOf(query);
     const client = clientStateFor(target);
+    const activity = beginFirestoreActivity(target, query, 'getDocsFromCache', 'operation');
     if (!client.hasCachedQuery(query)) {
-        return Promise.resolve(tag({
+        return Promise.resolve(finishSdkRead(activity, tag({
             size: 0,
             empty: true,
             docs: [],
             metadata: Object.freeze({ fromCache: true, hasPendingWrites: false }),
-        }, target));
+        }, target)));
     }
-    return getDocs(query).then((snapshot) => {
+    return readQuery(query, activity).then((snapshot) => {
         Object.defineProperty(snapshot, 'metadata', {
             value: Object.freeze({
                 fromCache: true,

package/dist/firestore/persistence.js.map

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

package/dist/firestore/plain-object.d.ts

@@ -0,0 +1,3 @@
+/** Objects whose own fields form a document map, without a custom prototype. */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=plain-object.d.ts.map

package/dist/firestore/plain-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-object.d.ts","sourceRoot":"","sources":["../../src/firestore/plain-object.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK9E"}

package/dist/firestore/plain-object.js

@@ -0,0 +1,9 @@
+/** Objects whose own fields form a document map, without a custom prototype. */
+export function isPlainObject(value) {
+    const isNotObject = value === null || typeof value !== 'object';
+    if (isNotObject)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=plain-object.js.map

package/dist/firestore/plain-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-object.js","sourceRoot":"","sources":["../../src/firestore/plain-object.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,WAAW,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;IAChE,IAAI,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/dist/firestore/query-constraints.d.ts.map

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

package/dist/firestore/query-constraints.js

@@ -1,4 +1,5 @@
-import { targetOf, sandboxDb, converterOf, parentRebuild, tagSandboxRef, buildSandboxShell, } from './state.js';
+import { targetOf, sandboxDb, converterOf, parentRebuild, tagSandboxRef, } from './state.js';
+import { attachConverterMethod, convertedView } from './converter-method.js';
 import { toFirestoreFirebaseError } from './errors.js';
 import { captureQueryOperand } from './sandbox/query-operand-equality.js';
 import { rawDocumentSnapshotForCursor } from './snapshots.js';
@@ -34,9 +35,9 @@ export function query(source, ...constraints) {
     catch (error) {
         throw toFirestoreFirebaseError(error);
     }
-    const tagged = tagSandboxRef(q, target, (fresh) => buildAt(fresh));
+    const tagged = attachConverterMethod(tagSandboxRef(q, target, (fresh) => buildAt(fresh)));
     if (conv) {
-        return buildSandboxShell(tagged, target, conv);
+        return convertedView(tagged, conv);
     }
     return tagged;
 }

package/dist/firestore/query-constraints.js.map

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

package/dist/firestore/reads.d.ts

@@ -1,12 +1,14 @@
-/**
- * `pyric/firestore` — document + query reads.
- *
- * `getDoc` / `getDocs`: resolve the chainable ref under current auth, apply
- * any converter, and hand back a snapshot rehydrated to the modular-SDK
- * shape (see `snapshots.ts`).
- */
 import type { DocumentData } from 'pyric/sandbox/admin-firestore';
 import type { DocumentReference, DocumentSnapshot, Query, QuerySnapshot } from './types.js';
+import { type SdkActivityHandle } from '../sandbox/internal/sdk-activity.js';
 export declare function getDoc<T = DocumentData>(ref: DocumentReference<T>): Promise<DocumentSnapshot<T>>;
+/** Keep served aliases on the same backend path while preserving their public name. */
+export declare function readDocumentAs<T = DocumentData>(ref: DocumentReference<T>, method: string): Promise<DocumentSnapshot<T>>;
+/** Shared executor; the public caller supplies its own activity identity. */
+export declare function readDocument<T = DocumentData>(ref: DocumentReference<T>, activity: SdkActivityHandle): Promise<DocumentSnapshot<T>>;
 export declare function getDocs<T = DocumentData>(query: Query<T>): Promise<QuerySnapshot<T>>;
+/** Keep served aliases on the same backend path while preserving their public name. */
+export declare function readQueryAs<T = DocumentData>(query: Query<T>, method: string): Promise<QuerySnapshot<T>>;
+/** Shared executor; the public caller supplies its own activity identity. */
+export declare function readQuery<T = DocumentData>(query: Query<T>, activity: SdkActivityHandle): Promise<QuerySnapshot<T>>;
 //# sourceMappingURL=reads.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../src/firestore/reads.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,+BAA+B,CAAC;AAevC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,EACL,aAAa,EAGd,MAAM,YAAY,CAAC;AAGpB,wBAAsB,MAAM,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAiBtG;AAED,wBAAsB,OAAO,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAuC1F"}
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../src/firestore/reads.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,+BAA+B,CAAC;AAevC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,EACL,aAAa,EAGd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE5F,wBAAgB,MAAM,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAEhG;AAED,uFAAuF;AACvF,wBAAsB,cAAc,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAE9H;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAsBzI;AAED,wBAAgB,OAAO,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAEpF;AAED,uFAAuF;AACvF,wBAAsB,WAAW,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAE9G;AAED,6EAA6E;AAC7E,wBAAsB,SAAS,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA4CzH"}

package/dist/firestore/reads.js

@@ -1,51 +1,89 @@
+/**
+ * `pyric/firestore` — document + query reads.
+ *
+ * `getDoc` / `getDocs`: resolve the chainable ref under current auth, apply
+ * any converter, and hand back a snapshot rehydrated to the modular-SDK
+ * shape (see `snapshots.ts`).
+ */
+import { withFirestoreFirebaseError } from './errors.js';
 import { targetOf, converterOf, tag, chainDocFor, chainQueryFor, } from './state.js';
 import { wrapSandboxDocSnap, applyConverterToDocSnap, tagSnapshotRefs, recordQuerySnapshot, } from './snapshots.js';
 import { clientStateFor } from './client-state.js';
-export async function getDoc(ref) {
+import { beginFirestoreActivity } from './sdk-activity.js';
+import { finishSdkRead } from '../sandbox/internal/sdk-activity.js';
+export function getDoc(ref) {
+    return readDocumentAs(ref, 'getDoc');
+}
+/** Keep served aliases on the same backend path while preserving their public name. */
+export async function readDocumentAs(ref, method) {
+    return readDocument(ref, beginFirestoreActivity(targetOf(ref), ref, method, 'operation'));
+}
+/** Shared executor; the public caller supplies its own activity identity. */
+export async function readDocument(ref, activity) {
     const target = targetOf(ref);
     const client = clientStateFor(target);
     client.markStarted();
-    const conv = converterOf(ref);
-    const snap = await chainDocFor(target, ref).get();
-    client.cachePath(ref.path);
-    if (conv) {
-        return applyConverterToDocSnap(snap, conv, target, 'document');
+    try {
+        const conv = converterOf(ref);
+        const snap = await chainDocFor(target, ref).get();
+        client.cachePath(ref.path);
+        if (conv) {
+            return finishSdkRead(activity, applyConverterToDocSnap(snap, conv, target, 'document'));
+        }
+        tagSnapshotRefs(snap, target);
+        return finishSdkRead(activity, wrapSandboxDocSnap(snap, target));
+    }
+    catch (error) {
+        activity.fail();
+        throw error;
     }
-    tagSnapshotRefs(snap, target);
-    return wrapSandboxDocSnap(snap, target);
 }
-export async function getDocs(query) {
+export function getDocs(query) {
+    return readQueryAs(query, 'getDocs');
+}
+/** Keep served aliases on the same backend path while preserving their public name. */
+export async function readQueryAs(query, method) {
+    return readQuery(query, beginFirestoreActivity(targetOf(query), query, method, 'operation'));
+}
+/** Shared executor; the public caller supplies its own activity identity. */
+export async function readQuery(query, activity) {
     const target = targetOf(query);
     const client = clientStateFor(target);
     client.markStarted();
-    const conv = converterOf(query);
-    const snap = await chainQueryFor(target, query).get();
-    client.cacheQuery(query);
-    if (conv) {
-        const c = conv;
-        const wrappedDocs = snap.docs.map((d) => applyConverterToDocSnap(d, c, target, 'query-child'));
-        const wrapped = tag({
-            size: wrappedDocs.length,
-            empty: wrappedDocs.length === 0,
-            docs: wrappedDocs,
-            metadata: client.querySnapshotMetadata(),
-        }, target);
-        for (const document of wrappedDocs)
-            client.cachePath(document.ref.path);
-        recordQuerySnapshot(wrapped, snap, target, query, 'read');
-        return wrapped;
+    try {
+        const conv = converterOf(query);
+        const snap = await withFirestoreFirebaseError(() => chainQueryFor(target, query).get());
+        client.cacheQuery(query);
+        if (conv) {
+            const c = conv;
+            const wrappedDocs = snap.docs.map((d) => applyConverterToDocSnap(d, c, target, 'query-child'));
+            const wrapped = tag({
+                size: wrappedDocs.length,
+                empty: wrappedDocs.length === 0,
+                docs: wrappedDocs,
+                metadata: client.querySnapshotMetadata(),
+            }, target);
+            for (const document of wrappedDocs)
+                client.cachePath(document.ref.path);
+            recordQuerySnapshot(wrapped, snap, target, query, 'read');
+            return finishSdkRead(activity, wrapped);
+        }
+        tagSnapshotRefs(snap, target);
+        const docs = snap.docs;
+        for (const d of docs) {
+            client.cachePath(d.ref.path);
+            wrapSandboxDocSnap(d, target);
+        }
+        Object.defineProperty(snap, 'metadata', {
+            value: client.querySnapshotMetadata(),
+            configurable: true,
+        });
+        recordQuerySnapshot(snap, snap, target, query, 'read');
+        return finishSdkRead(activity, snap);
     }
-    tagSnapshotRefs(snap, target);
-    const docs = snap.docs;
-    for (const d of docs) {
-        client.cachePath(d.ref.path);
-        wrapSandboxDocSnap(d, target);
+    catch (error) {
+        activity.fail();
+        throw error;
     }
-    Object.defineProperty(snap, 'metadata', {
-        value: client.querySnapshotMetadata(),
-        configurable: true,
-    });
-    recordQuerySnapshot(snap, snap, target, query, 'read');
-    return snap;
 }
 //# sourceMappingURL=reads.js.map

package/dist/firestore/reads.js.map

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

package/dist/firestore/refs.d.ts

@@ -6,7 +6,8 @@
  * a fresh typed view that carries forward through the chain factories.
  */
 import type { DocumentData } from 'pyric/sandbox/admin-firestore';
-import type { Firestore, DocumentReference, CollectionReference, Query, FirestoreDataConverter } from './types.js';
+import { DocumentReference } from './types.js';
+import type { Firestore, CollectionReference, Query, FirestoreDataConverter } from './types.js';
 export declare function doc<T = DocumentData>(parent: Firestore | CollectionReference<T>, ...pathSegments: string[]): DocumentReference<T>;
 /**
  * Cross-collection query — scans every document under every

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

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/firestore/refs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAalE,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,EACL,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAgBpB,wBAAgB,GAAG,CAAC,CAAC,GAAG,YAAY,EAClC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,EAC1C,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,iBAAiB,CAAC,CAAC,CAAC,CAuCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,KAAK,CAQ1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,GAAG,mBAAmB,CA4BhH;AAkCD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,GAAG,EAAE,iBAAiB,CAAC,YAAY,CAAC,EACpC,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAC/B,wBAAgB,aAAa,CAC3B,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAC/B,SAAS,EAAE,IAAI,GACd,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACnC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,GAAG,EAAE,mBAAmB,CAAC,YAAY,CAAC,EACtC,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACjC,wBAAgB,aAAa,CAC3B,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,IAAI,GACd,mBAAmB,CAAC,YAAY,CAAC,CAAC;AACrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,EACtB,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,KAAK,CAAC,QAAQ,CAAC,CAAC;AACnB,wBAAgB,aAAa,CAC3B,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,EACjB,SAAS,EAAE,IAAI,GACd,KAAK,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/firestore/refs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAclE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,KAAK,EACL,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAoCpB,wBAAgB,GAAG,CAAC,CAAC,GAAG,YAAY,EAClC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,EAC1C,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,iBAAiB,CAAC,CAAC,CAAC,CAqCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,KAAK,CAQ1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,GAAG,mBAAmB,CA4BhH;AAiCD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,GAAG,EAAE,iBAAiB,CAAC,YAAY,CAAC,EACpC,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAC/B,wBAAgB,aAAa,CAC3B,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAC/B,SAAS,EAAE,IAAI,GACd,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACnC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,GAAG,EAAE,mBAAmB,CAAC,YAAY,CAAC,EACtC,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACjC,wBAAgB,aAAa,CAC3B,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,IAAI,GACd,mBAAmB,CAAC,YAAY,CAAC,CAAC;AACrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EACjF,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,EACtB,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnD,KAAK,CAAC,QAAQ,CAAC,CAAC;AACnB,wBAAgB,aAAa,CAC3B,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,EACjB,SAAS,EAAE,IAAI,GACd,KAAK,CAAC,YAAY,CAAC,CAAC"}

package/dist/firestore/refs.js

@@ -1,11 +1,23 @@
 import { TARGET_SYMBOL, targetOf, sandboxDb, tagSandboxRef, converterOf, underlyingOf, buildSandboxShell, asChainColl, asChainDoc, } from './state.js';
+import { DocumentReference } from './types.js';
 import { boundedActivityIdentity, registerActivityValue, } from './sandbox/activity-value-registry.js';
-import { registerReferenceQueryValue } from './sandbox/query-value-registry.js';
-import { copyQueryValueRegistration } from './sandbox/query-value-registry.js';
-function registerDocumentValue(ref, path, owner) {
-    registerActivityValue(ref, boundedActivityIdentity('reference', path));
-    registerReferenceQueryValue(ref, path, owner);
-    return ref;
+import { registerReferenceQueryValue, copyQueryValueRegistration, } from './sandbox/query-value-registry.js';
+import { attachConverterMethod, convertedView } from './converter-method.js';
+function registerDocumentValue(ref, path, owner, converter = null) {
+    function convert(converter) {
+        const removesConverter = converter === null;
+        if (removesConverter)
+            return withConverter(reference, null);
+        return withConverter(reference, converter);
+    }
+    // Modular methods must live outside the Admin error-translation proxy.
+    const underlying = underlyingOf(ref);
+    const shell = buildSandboxShell(underlying, owner, converter);
+    const reference = Object.assign(shell, { withConverter: convert });
+    registerActivityValue(reference, boundedActivityIdentity('reference', path));
+    registerReferenceQueryValue(underlying, path, owner);
+    copyQueryValueRegistration(underlying, reference);
+    return reference;
 }
 // ─── Path constructors ────────────────────────────────────────────────
 export function doc(parent, ...pathSegments) {
@@ -16,7 +28,8 @@ export function doc(parent, ...pathSegments) {
     const conv = isHandle ? undefined : converterOf(parent);
     const db = sandboxDb(target);
     if (isHandle) {
-        if (pathSegments.length === 0) {
+        const hasNoPath = pathSegments.length === 0;
+        if (hasNoPath) {
             throw new TypeError('doc(db, path) requires at least one path segment.');
         }
         const path = pathSegments.join('/');
@@ -25,14 +38,17 @@ export function doc(parent, ...pathSegments) {
         return registerDocumentValue(tagged, path, target);
     }
     const coll = asChainColl(underlyingOf(parent));
-    const ref = pathSegments.length === 0
-        ? coll.doc()
-        : coll.doc(pathSegments.join('/'));
+    const createsId = pathSegments.length === 0;
+    let ref;
+    if (createsId)
+        ref = coll.doc();
+    else
+        ref = coll.doc(pathSegments.join('/'));
     const absPath = ref.path;
     const tagged = tagSandboxRef(ref, target, (fresh) => fresh.doc(absPath));
-    if (conv) {
-        const shell = buildSandboxShell(tagged, target, conv);
-        return registerDocumentValue(shell, absPath, target);
+    const hasConverter = conv !== undefined && conv !== null;
+    if (hasConverter) {
+        return registerDocumentValue(tagged, absPath, target, conv);
     }
     return registerDocumentValue(tagged, absPath, target);
 }
@@ -46,7 +62,7 @@ export function doc(parent, ...pathSegments) {
  */
 export function collectionGroup(db, collectionId) {
     const target = targetOf(db);
-    const q = sandboxDb(target).collectionGroup(collectionId);
+    const q = attachConverterMethod(sandboxDb(target).collectionGroup(collectionId));
     return tagSandboxRef(q, target, (fresh) => fresh.collectionGroup(collectionId));
 }
 export function collection(parent, ...pathSegments) {
@@ -61,25 +77,22 @@ export function collection(parent, ...pathSegments) {
     // A parent doc's T describes its own data, not its subcollections'.
     if (isHandle) {
         const path = pathSegments.join('/');
-        const built = sandboxDb(target).collection(path);
+        const built = attachConverterMethod(sandboxDb(target).collection(path));
         return tagSandboxRef(built, target, (fresh) => fresh.collection(path));
     }
     const docRef = asChainDoc(underlyingOf(parent));
     const subPath = pathSegments.join('/');
-    const built = docRef.collection(subPath);
+    const built = attachConverterMethod(docRef.collection(subPath));
     const absPath = built.path;
     return tagSandboxRef(built, target, (fresh) => fresh.collection(absPath));
 }
 export function withConverter(source, converter) {
     const target = targetOf(source);
-    if (converter === null) {
-        // Strip — return the underlying plain ref. Falls back to `source`
-        // itself if it was never wrapped (no-op).
-        return underlyingOf(source);
-    }
     const underlying = underlyingOf(source);
-    const shell = buildSandboxShell(underlying, target, converter);
-    copyQueryValueRegistration(underlying, shell);
-    return shell;
+    const isDocument = underlying instanceof DocumentReference;
+    if (isDocument) {
+        return registerDocumentValue(underlying, underlying.path, target, converter);
+    }
+    return convertedView(source, converter);
 }
 //# sourceMappingURL=refs.js.map

package/dist/firestore/refs.js.map

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

package/dist/firestore/sandbox/activity-query-display.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Display projection of a captured Firestore query operand.
+ *
+ * PURE. `activity-query-value.ts` reduces an operand to a fixed-size digest so
+ * two reads of the same query compare equal without the diagnostic ever
+ * observing user code. A digest cannot be read back, so a surface that shows
+ * the developer the query they wrote needs the operand itself.
+ *
+ * This module projects the CANONICAL snapshot `captureQueryOperand` already
+ * took at construction time, never the caller's object. That snapshot is plain
+ * frozen data — the same lifecycle point at which Firebase parses query values
+ * — so walking it runs no getter and can trip no Proxy trap. The projection is
+ * bounded in string length, entry count, and depth, so an attach event never
+ * retains an unbounded operand tree.
+ *
+ * The output is diagnostic only: nothing reads it back into a query, and no
+ * verdict, delivery, or query identity depends on it.
+ */
+/** One operand as a surface can print it. Tagged so a renderer never has to
+ *  guess whether `12` was a number or a string. */
+export type QueryDisplayValue = {
+    readonly type: 'string';
+    readonly value: string;
+    readonly truncated?: true;
+} | {
+    readonly type: 'number';
+    readonly value: number;
+} | {
+    readonly type: 'boolean';
+    readonly value: boolean;
+} | {
+    readonly type: 'null';
+} | {
+    readonly type: 'reference';
+    readonly path: string;
+} | {
+    readonly type: 'timestamp';
+    readonly iso: string;
+} | {
+    readonly type: 'geoPoint';
+    readonly latitude: number;
+    readonly longitude: number;
+} | {
+    readonly type: 'bytes';
+    readonly length: number;
+} | {
+    readonly type: 'vector';
+    readonly length: number;
+} | {
+    readonly type: 'array';
+    readonly values: readonly QueryDisplayValue[];
+    readonly truncated?: true;
+} | {
+    readonly type: 'map';
+    readonly entries: readonly (readonly [string, QueryDisplayValue])[];
+    readonly truncated?: true;
+} | {
+    readonly type: 'opaque';
+};
+/**
+ * Project one canonical query operand into its display value.
+ *
+ * The argument is the `value` of a `CapturedQueryOperand` — the comparison
+ * snapshot, not the caller's object.
+ */
+export declare function activityDisplayValue(canonical: unknown): QueryDisplayValue;
+//# sourceMappingURL=activity-query-display.d.ts.map

package/dist/firestore/sandbox/activity-query-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-query-display.d.ts","sourceRoot":"","sources":["../../../src/firestore/sandbox/activity-query-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH;mDACmD;AACnD,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IACA,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B,GACC;IACA,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B,GACC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAiFhC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,iBAAiB,CAE1E"}