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

package/dist/firestore/transactions.js

@@ -1,14 +1,87 @@
-import { targetOf, sandboxDb, tag, } from './state.js';
+import { runSdkWrite } from '../sandbox/internal/sdk-write-activity.js';
+import { beginFirestoreGroupActivity } from './sdk-activity.js';
+import { targetOf, sandboxDb, tag, converterOf, } from './state.js';
+import { applyConverterToDocSnap, tagSnapshotRefs, wrapSandboxDocSnap } from './snapshots.js';
+import { requireDocumentData } from './internal/document-data.js';
 // ─── Transactions + batches ───────────────────────────────────────────
+/** Apply the model converter before the backing adapter captures document data. */
+function convertSetData(ref, data) {
+    const converter = converterOf(ref);
+    const hasConverter = converter !== undefined && converter !== null;
+    let payload = data;
+    if (hasConverter)
+        payload = converter.toFirestore(data);
+    return requireDocumentData(payload);
+}
 export async function runTransaction(db, fn, options) {
     const target = targetOf(db);
     // For sandbox-live, the transaction runs under the auth captured at
     // `runTransaction` start and stays identity-stable until completion.
-    return sandboxDb(target).runTransaction(fn, options);
+    const database = sandboxDb(target);
+    return runSdkWrite(beginFirestoreGroupActivity(target, 'runTransaction'), () => database.runTransaction((backing) => {
+        const transaction = {
+            get: modularTransactionRead(backing.get.bind(backing), database, target),
+            set(ref, data, options) {
+                const payload = convertSetData(ref, data);
+                backing.set(database.doc(ref.path), payload, options);
+                return transaction;
+            },
+            update(ref, data) {
+                backing.update(database.doc(ref.path), data);
+                return transaction;
+            },
+            delete(ref) {
+                backing.delete(database.doc(ref.path));
+                return transaction;
+            },
+        };
+        return fn(transaction);
+    }, options));
+}
+/** Normalize document results without moving reads outside the transaction. */
+function modularTransactionRead(read, database, target) {
+    async function get(reference) {
+        const readsQuery = 'where' in reference;
+        if (readsQuery)
+            return read(reference);
+        const snapshot = await read(database.doc(reference.path));
+        const converter = converterOf(reference);
+        const hasConverter = converter !== undefined && converter !== null;
+        if (hasConverter) {
+            return applyConverterToDocSnap(snapshot, converter, target, 'document');
+        }
+        tagSnapshotRefs(snapshot, target);
+        return wrapSandboxDocSnap(snapshot, target);
+    }
+    return get;
 }
 export function writeBatch(db) {
     const target = targetOf(db);
-    const batch = sandboxDb(target).batch();
+    const database = sandboxDb(target);
+    const backing = database.batch();
+    let writes = 0;
+    let deletes = 0;
+    const batch = {
+        set(ref, data, options) {
+            const payload = convertSetData(ref, data);
+            backing.set(database.doc(ref.path), payload, options);
+            writes++;
+            return batch;
+        },
+        update(ref, data) {
+            backing.update(database.doc(ref.path), data);
+            writes++;
+            return batch;
+        },
+        delete(ref) {
+            backing.delete(database.doc(ref.path));
+            deletes++;
+            return batch;
+        },
+        commit(options) {
+            return runSdkWrite(beginFirestoreGroupActivity(target, 'writeBatch.commit'), () => backing.commit(options), () => ({ documentWrites: writes, documentDeletes: deletes }));
+        },
+    };
     return tag(batch, target);
 }
 //# sourceMappingURL=transactions.js.map

package/dist/firestore/transactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/firestore/transactions.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,QAAQ,EACR,SAAS,EACT,GAAG,GACJ,MAAM,YAAY,CAAC;AAGpB,yEAAyE;AAEzE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAa,EACb,EAAuC,EACvC,OAA4B;IAE5B,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,oEAAoE;IACpE,qEAAqE;IACrE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,cAAc,CACrC,EAA8C,EAC9C,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAa;IACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,KAA0B,EAAE,MAAM,CAAe,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/firestore/transactions.ts"],"names":[],"mappings":"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"}

package/dist/firestore/types.d.ts

@@ -9,7 +9,9 @@
  * Type-only module apart from the `SandboxError` re-export; carries no
  * operation implementations.
  */
-import { SandboxError, type DocumentData, type FieldValueSentinel, type LintResult, type OrderDirection, type WhereFilterOp, type WriteBatch as ChainWriteBatch, type Transaction as ChainTransaction } from 'pyric/sandbox/admin-firestore';
+import { SandboxError, type DocumentData, type FieldValueSentinel, type LintResult, type OrderDirection, type WhereFilterOp, type Query as ChainQuery, type AdminQuerySnapshot } from 'pyric/sandbox/admin-firestore';
+import type { SetOptions } from './writes.js';
+import type { OperationOptions } from './sandbox/admin-compat/types.js';
 import type { AuthState, Sandbox, SandboxContext } from 'pyric/sandbox';
 import type { FirebaseApp } from '../app/types.js';
 import { TARGET_SYMBOL, type Target } from './state.js';
@@ -47,15 +49,21 @@ export type AppFirestore = Firestore & {
 export interface DocumentReference<_T = DocumentData> {
     readonly id: string;
     readonly path: string;
+    withConverter<T, D extends DocumentData = DocumentData>(converter: FirestoreDataConverter<T, D>): DocumentReference<T>;
+    withConverter(converter: null): DocumentReference<DocumentData>;
 }
 /** A reference to a Firestore collection. Backend-opaque. */
-export interface CollectionReference<_T = DocumentData> {
+export interface CollectionReference<_T = DocumentData> extends Query<_T> {
     readonly id: string;
     readonly path: string;
+    withConverter<T, D extends DocumentData = DocumentData>(converter: FirestoreDataConverter<T, D>): CollectionReference<T>;
+    withConverter(converter: null): CollectionReference<DocumentData>;
 }
 /** A Firestore query (a collection ref or one with where/orderBy/limit applied). */
 export interface Query<_T = DocumentData> {
     readonly _isQuery?: true;
+    withConverter<T, D extends DocumentData = DocumentData>(converter: FirestoreDataConverter<T, D>): Query<T>;
+    withConverter(converter: null): Query<DocumentData>;
 }
 export interface SnapshotMetadata {
     readonly fromCache: boolean;
@@ -85,9 +93,22 @@ export interface QuerySnapshot<T = DocumentData> {
     readonly docs: ReadonlyArray<QueryDocumentSnapshot<T>>;
     readonly metadata: SnapshotMetadata;
 }
-export interface WriteBatch extends ChainWriteBatch {
-}
-export interface Transaction extends ChainTransaction {
+export interface WriteBatch {
+    set<T = DocumentData>(ref: DocumentReference<T>, data: T, options?: SetOptions): WriteBatch;
+    update(ref: DocumentReference, data: DocumentData): WriteBatch;
+    delete(ref: DocumentReference): WriteBatch;
+    /** Retains the existing sandbox-only per-commit auth override. */
+    commit(options?: OperationOptions): Promise<void>;
+}
+export interface Transaction {
+    get<T = DocumentData>(ref: DocumentReference<T>): Promise<DocumentSnapshot<T> & {
+        exists(): boolean;
+    }>;
+    /** Existing sandbox query extension; modular Firebase transactions read documents. */
+    get(query: ChainQuery): Promise<AdminQuerySnapshot>;
+    set<T = DocumentData>(ref: DocumentReference<T>, data: T, options?: SetOptions): Transaction;
+    update(ref: DocumentReference, data: DocumentData): Transaction;
+    delete(ref: DocumentReference): Transaction;
 }
 export type Unsubscribe = () => void;
 export declare const CACHE_SIZE_UNLIMITED = -1;

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

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

package/dist/firestore/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,GAQb,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAe,MAAM,YAAY,CAAC;AA+FxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,CAAC;AACvC,MAAM,OAAO,cAAe,SAAQ,KAAK;IACX;IAA5B,YAA4B,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AACD,MAAM,OAAO,SAAS;IACpB,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,aAAa,IAAI,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC;IAC1I,CAAC;CACF;AACD,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,IAAI,IAAI,QAAQ;YAChB,MAAM,IAAI,QAAQ;YAClB,OAAQ,QAAgB,CAAC,IAAI,KAAK,QAAQ;YAC1C,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC;YACrB,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC;YACvB,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC;YACpB,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,CACrB,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,IAAI,IAAI,QAAQ;YAChB,MAAM,IAAI,QAAQ;YAClB,OAAQ,QAAgB,CAAC,IAAI,KAAK,QAAQ;YAC1C,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,CAC7C,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,KAAK;IAChB,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC,CAC7H,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,IAAI,IAAI,QAAQ;YAChB,KAAK,IAAI,QAAQ;YACjB,QAAQ,IAAI,QAAQ;YACpB,OAAQ,QAAgB,CAAC,MAAM,KAAK,UAAU;YAC9C,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,CACtB,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,qBAAwC,SAAQ,gBAAmB;IAC9E,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC;YAC9C,OAAQ,QAAgB,CAAC,IAAI,KAAK,UAAU,CAC7C,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CACZ,QAAQ;YACR,OAAO,QAAQ,KAAK,QAAQ;YAC5B,MAAM,IAAI,QAAQ;YAClB,MAAM,IAAI,QAAQ;YAClB,OAAO,IAAI,QAAQ,CACpB,CAAC;IACJ,CAAC;CACF;AACD,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,QAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;IAClL,CAAC;CACF;AACD,MAAM,OAAO,UAAU;IACrB,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;IAC5J,CAAC;CACF;AACD,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAiB;QAC3C,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,WAAW,IAAI,QAAQ,IAAI,kBAAkB,IAAI,QAAQ,CAAC,CAAC;IACxH,CAAC;CACF;AACD,MAAM,OAAO,sBAAsB;CAAG;AA4BtC,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"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"}

package/dist/firestore/vector-value.d.ts

@@ -0,0 +1,11 @@
+export declare class VectorValue {
+    readonly _values: number[];
+    private constructor();
+    static create(values: number[]): VectorValue;
+    toArray(): number[];
+    isEqual(other: VectorValue): boolean;
+    toJSON(): object;
+    static fromJSON(json: object): VectorValue;
+}
+export declare function vector(values?: number[]): VectorValue;
+//# sourceMappingURL=vector-value.d.ts.map

package/dist/firestore/vector-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-value.d.ts","sourceRoot":"","sources":["../../src/firestore/vector-value.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAA9C,OAAO;IAOP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW;IAQ5C,OAAO,IAAI,MAAM,EAAE;IAInB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IASpC,MAAM,IAAI,MAAM;IAOhB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;CAW3C;AAED,wBAAgB,MAAM,CAAC,MAAM,GAAE,MAAM,EAAO,GAAG,WAAW,CAEzD"}

package/dist/firestore/vector-value.js

@@ -0,0 +1,51 @@
+import { registerQueryValue } from './sandbox/query-value-registry.js';
+export class VectorValue {
+    _values;
+    constructor(_values) {
+        this._values = _values;
+        registerQueryValue(this, Object.freeze({
+            type: 'vector',
+            values: Object.freeze(_values.slice()),
+        }), () => new VectorValue(_values.slice()));
+    }
+    static create(values) {
+        const hasNonNumericComponent = !values.every((value) => typeof value === 'number');
+        if (hasNonNumericComponent) {
+            throw new TypeError('Vector values must be numbers.');
+        }
+        return new VectorValue(values.slice());
+    }
+    toArray() {
+        return this._values.slice();
+    }
+    isEqual(other) {
+        const hasDifferentType = !(other instanceof VectorValue);
+        if (hasDifferentType)
+            return false;
+        const theirs = other._values;
+        return theirs !== undefined
+            && this._values.length === theirs.length
+            && this._values.every((value, index) => value === theirs[index]);
+    }
+    toJSON() {
+        return {
+            type: 'firestore/vectorValue/1.0',
+            vectorValues: this.toArray(),
+        };
+    }
+    static fromJSON(json) {
+        const value = json;
+        const hasUnexpectedMarker = value.type !== 'firestore/vectorValue/1.0';
+        const isInvalidVectorJson = hasUnexpectedMarker
+            || !Array.isArray(value.vectorValues)
+            || !value.vectorValues.every((entry) => typeof entry === 'number');
+        if (isInvalidVectorJson) {
+            throw new TypeError('Invalid VectorValue JSON value.');
+        }
+        return VectorValue.create(value.vectorValues);
+    }
+}
+export function vector(values = []) {
+    return VectorValue.create(values);
+}
+//# sourceMappingURL=vector-value.js.map

package/dist/firestore/vector-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-value.js","sourceRoot":"","sources":["../../src/firestore/vector-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,OAAiB;QAAjB,YAAO,GAAP,OAAO,CAAU;QAC5C,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;SACvC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAgB;QAC5B,MAAM,sBAAsB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QACnF,IAAI,sBAAsB,EAAE,CAAC;YAC3B,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,KAAkB;QACxB,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC,CAAC;QACzD,IAAI,gBAAgB;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,OAAO,MAAM,KAAK,SAAS;eACtB,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;eACrC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,2BAA2B;YACjC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE;SAC7B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,MAAM,KAAK,GAAG,IAAoE,CAAC;QACnF,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,KAAK,2BAA2B,CAAC;QACvE,MAAM,mBAAmB,GAAG,mBAAmB;eAC1C,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;eAClC,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QACrE,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,MAAM,CAAC,SAAmB,EAAE;IAC1C,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/firestore/writes.d.ts

@@ -1,10 +1,3 @@
-/**
- * `pyric/firestore` — document writes.
- *
- * `setDoc` / `updateDoc` / `deleteDoc` / `addDoc` and the modular
- * `SetOptions` shape. Operations route through the sandbox's chainable
- * adapter, running any converter on `setDoc` / `addDoc`.
- */
 import type { DocumentData } from 'pyric/sandbox/admin-firestore';
 import type { DocumentReference, CollectionReference } from './types.js';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/firestore/writes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,+BAA+B,CAAC;AAUvC,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,YAAY,EAC3C,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,YAAY,EAC3C,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA6B/B;AAGD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAE7D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAK1G"}
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/firestore/writes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,+BAA+B,CAAC;AAUvC,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,YAAY,EAC3C,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrE;AAED,wBAAsB,MAAM,CAAC,CAAC,GAAG,YAAY,EAC3C,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA+B/B;AAGD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAE7D;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAK1G"}

package/dist/firestore/writes.js

@@ -1,3 +1,12 @@
+/**
+ * `pyric/firestore` — document writes.
+ *
+ * `setDoc` / `updateDoc` / `deleteDoc` / `addDoc` and the modular
+ * `SetOptions` shape. Operations route through the sandbox's chainable
+ * adapter, running any converter on `setDoc` / `addDoc`.
+ */
+import { runSdkWrite } from '../sandbox/internal/sdk-write-activity.js';
+import { beginFirestoreActivity } from './sdk-activity.js';
 import { targetOf, converterOf, chainDocFor, chainCollFor, tagSandboxRef, buildSandboxShell, } from './state.js';
 import { withFirestoreFirebaseError } from './errors.js';
 import { clientStateFor } from './client-state.js';
@@ -5,11 +14,13 @@ import { boundedActivityIdentity, registerActivityValue, } from './sandbox/activ
 import { copyQueryValueRegistration, registerReferenceQueryValue, } from './sandbox/query-value-registry.js';
 export async function setDoc(ref, data, options) {
     const target = targetOf(ref);
-    const conv = converterOf(ref);
-    const payload = conv
-        ? conv.toFirestore(data)
-        : data;
-    return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).set(payload, options)), ref.path);
+    return runSdkWrite(beginFirestoreActivity(target, ref, 'setDoc', 'operation'), async () => {
+        const conv = converterOf(ref);
+        const payload = conv
+            ? conv.toFirestore(data)
+            : data;
+        return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).set(payload, options)), ref.path);
+    });
 }
 /**
  * `updateDoc` does NOT run the converter. Matches `firebase/firestore`'s
@@ -21,33 +32,39 @@ export async function setDoc(ref, data, options) {
  */
 export async function updateDoc(ref, data) {
     const target = targetOf(ref);
-    return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).update(data)), ref.path);
+    return runSdkWrite(beginFirestoreActivity(target, ref, 'updateDoc', 'operation'), async () => {
+        return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).update(data)), ref.path);
+    });
 }
 export async function deleteDoc(ref) {
     const target = targetOf(ref);
-    return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).delete()), ref.path);
+    return runSdkWrite(beginFirestoreActivity(target, ref, 'deleteDoc', 'operation'), async () => {
+        return clientStateFor(target).runWrite(() => withFirestoreFirebaseError(() => chainDocFor(target, ref).delete()), ref.path);
+    });
 }
 export async function addDoc(coll, data) {
     const target = targetOf(coll);
-    const conv = converterOf(coll);
-    const payload = conv
-        ? conv.toFirestore(data)
-        : data;
-    const ref = await clientStateFor(target).runWrite(async () => {
-        const created = await withFirestoreFirebaseError(() => chainCollFor(target, coll).add(payload));
-        clientStateFor(target).cachePath(created.path);
-        return created;
+    return runSdkWrite(beginFirestoreActivity(target, coll, 'addDoc', 'operation'), async () => {
+        const conv = converterOf(coll);
+        const payload = conv
+            ? conv.toFirestore(data)
+            : data;
+        const ref = await clientStateFor(target).runWrite(async () => {
+            const created = await withFirestoreFirebaseError(() => chainCollFor(target, coll).add(payload));
+            clientStateFor(target).cachePath(created.path);
+            return created;
+        });
+        const absPath = ref.path;
+        const tagged = tagSandboxRef(ref, target, (fresh) => fresh.doc(absPath));
+        registerActivityValue(tagged, boundedActivityIdentity('reference', absPath));
+        registerReferenceQueryValue(tagged, absPath, target, tagged);
+        if (conv) {
+            const shell = buildSandboxShell(tagged, target, conv);
+            copyQueryValueRegistration(tagged, shell);
+            return shell;
+        }
+        return tagged;
     });
-    const absPath = ref.path;
-    const tagged = tagSandboxRef(ref, target, (fresh) => fresh.doc(absPath));
-    registerActivityValue(tagged, boundedActivityIdentity('reference', absPath));
-    registerReferenceQueryValue(tagged, absPath, target, tagged);
-    if (conv) {
-        const shell = buildSandboxShell(tagged, target, conv);
-        copyQueryValueRegistration(tagged, shell);
-        return shell;
-    }
-    return tagged;
 }
 import { writeBatch } from './transactions.js';
 export function ensureFirestoreConfigured(db) {

package/dist/firestore/writes.js.map

@@ -1 +1 @@
-{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/firestore/writes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/firestore/writes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAM3D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AA0B3C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAyB,EACzB,IAAO,EACP,OAAoB;IAEpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,WAAW,CAAC,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI;YAClB,CAAC,CAAE,IAAkC,CAAC,WAAW,CAAC,IAAI,CAAC;YACvD,CAAC,CAAE,IAAgC,CAAC;QACtC,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CACpC,GAAG,EAAE,CAAC,0BAA0B,CAAC,GAAG,EAAE,CACpC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,OAAsC,CAAC,CAC9E,EACD,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAsB,EAAE,IAAkB;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,WAAW,CAAC,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,EAAE;QAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CACpC,GAAG,EAAE,CAAC,0BAA0B,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAC7E,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAsB;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,WAAW,CAAC,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,EAAE;QAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CACpC,GAAG,EAAE,CAAC,0BAA0B,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EACzE,GAAG,CAAC,IAAI,CACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAA4B,EAC5B,IAAO;IAEP,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,WAAW,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI;YAClB,CAAC,CAAE,IAAkC,CAAC,WAAW,CAAC,IAAI,CAAC;YACvD,CAAC,CAAE,IAAgC,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC3D,MAAM,OAAO,GAAG,MAAM,0BAA0B,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAChG,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAI,GAAmC,CAAC,IAAI,CAAC;QAC1D,MAAM,MAAM,GAAG,aAAa,CAC1B,GAAa,EACb,MAAM,EACN,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAsB,CACnD,CAAC;QACF,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,2BAA2B,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,iBAAiB,CAC7B,MAAsC,EACtC,MAAM,EACN,IAAI,CACL,CAAC;YACF,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,KAA6B,CAAC;QACvC,CAAC;QACD,OAAO,MAA8B,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,UAAU,yBAAyB,CAAC,EAAa;IACrD,QAAQ,CAAC,EAAE,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,EAAa,EAAE,MAAyC;IAC5F,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/functions/events.d.ts

@@ -0,0 +1,12 @@
+export declare const FUNCTIONS_EVENT_RECORD: {
+    readonly service: "functions";
+    readonly operations: readonly ["trigger_discovered", "handler_fired", "execution_finished"];
+    readonly target: {
+        readonly name: "ref";
+        readonly description: "The trigger's reference pattern on discovery, and the synthetic event's concrete path once a handler fires.";
+        readonly always: false;
+    };
+};
+/** Every operation the Functions trigger runtime emits. */
+export type FunctionsEventOperation = (typeof FUNCTIONS_EVENT_RECORD)['operations'][number];
+//# sourceMappingURL=events.d.ts.map

package/dist/functions/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/functions/events.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,sBAAsB;;;;;;;;CASI,CAAC;AAExC,2DAA2D;AAC3D,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/functions/events.js

@@ -0,0 +1,10 @@
+export const FUNCTIONS_EVENT_RECORD = {
+    service: 'functions',
+    operations: ['trigger_discovered', 'handler_fired', 'execution_finished'],
+    target: {
+        name: 'ref',
+        description: "The trigger's reference pattern on discovery, and the synthetic event's concrete path once a handler fires.",
+        always: false,
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/functions/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/functions/events.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,CAAC,oBAAoB,EAAE,eAAe,EAAE,oBAAoB,CAAC;IACzE,MAAM,EAAE;QACN,IAAI,EAAE,KAAK;QACX,WAAW,EACT,6GAA6G;QAC/G,MAAM,EAAE,KAAK;KACd;CACoC,CAAC"}

package/dist/messaging/broker/broker.d.ts

@@ -11,30 +11,14 @@
  *     the broker emits onto the sandbox's unified `onEvent` stream —
  *     tracing is a CONSUMER of the stream, never a parallel log.
  *
- * ── The worker-host seam (documented, deliberately NOT wired) ──────────────
- * This broker is the in-process degenerate case (the transport research
- * doc's "pure Node" arm). When `pyric dev`'s SharedWorker host adopts
- * messaging, each public method below becomes one `messaging.*` op in
- * `serve/worker/protocol.ts`'s `OpMessage` union, exactly like `rtdb.set` /
- * `auth.signInEmail`:
- *
- *   send(message, {validateOnly})        → { method: 'messaging.send', message, validateOnly }
- *   getTokenFor(registrationId)          → { method: 'messaging.getToken', registrationId }
- *   deleteTokenFor(registrationId)       → { method: 'messaging.deleteToken', registrationId }
- *   subscribeToTopic(tokens, topic)      → { method: 'messaging.subscribeToTopic', tokens, topic }
- *   unsubscribeFromTopic(tokens, topic)  → { method: 'messaging.unsubscribeFromTopic', tokens, topic }
- *   deliver(spec)                        → { method: 'messaging.deliver', spec }   (test/Studio driver)
- *
- * Client visibility maps onto the host's per-port sessions: each connected
- * tab is one entry in `clients` (`setClientVisibility(portId, state)` on
- * visibilitychange), so the captured routing rule — foreground iff ANY
- * visible same-origin client — falls out of the same state machine that
- * headless tests drive with a single simulated client. Rejections cross the
- * wire as the `BrokerSendError.envelope` value (plain JSON, structured-
- * clone-safe). No `serve/worker` file is touched by this slice.
+ * Hosted and SharedWorker transports use the same broker. Token ownership,
+ * window visibility, and observers are grouped by recipient (installation,
+ * Firebase app, and Service Worker scope). Headless mirrors use one default
+ * recipient; transports supply explicit recipient identities.
  */
 import type { Sandbox } from '../../sandbox/types/service.js';
-import type { AcceptedSend, BrokerMessage, ClientVisibilityState, DeliveryResult, MessagingBrokerConfig, PayloadHandler, TopicManagementOutcome } from './types.js';
+import { type MessagingSnapshot } from './persistence.js';
+import type { AcceptedSend, BrokerMessage, ClientVisibilityState, DeliveryLogEntry, DeliveryStage, DeliveryResult, MessagingBrokerConfig, PayloadHandler, RegisteredToken, TopicManagementOutcome } from './types.js';
 /** Default project id for sandbox-minted message resource names. */
 export declare const DEFAULT_PROJECT_ID = "pyric-sandbox";
 /**
@@ -52,7 +36,7 @@ export declare class MessagingBroker {
     /** registrationId → active token (stability per registration is the captured contract). */
     private readonly registrations;
     /** token → record. Deleted tokens stay, flipped to `unregistered`, so dead sends 404. */
-    private readonly tokens;
+    private readonly tokenRecords;
     /** topic → subscribed tokens. */
     private readonly subscriptions;
     /** Window clients and their visibility — THE routing input (never focus). */
@@ -60,15 +44,22 @@ export declare class MessagingBroker {
     private readonly foregroundHandlers;
     private readonly backgroundHandlers;
     private numericIdCounter;
+    private readonly changeListeners;
     constructor(options?: MessagingBrokerConfig & {
         sandbox?: Sandbox;
     });
+    /** Durable token state only; live browser connections are restored by their clients. */
+    snapshot(): MessagingSnapshot;
+    restore(data: unknown): void;
+    reset(): void;
+    onChange(listener: () => void): () => void;
+    private changed;
     /**
      * Return the registration's token, minting on first call. Stable across
      * calls for the same registration (oracle: `messaging-web-token-stability`);
      * shape class per `mintToken` (oracle: `messaging-web-token-shape`).
      */
-    getTokenFor(registrationId: string): string;
+    getTokenFor(registrationId: string, recipientId?: string): string;
     /**
      * Invalidate the registration's token. Resolves truthy whether or not a
      * token existed (oracle: `messaging-web-deletetoken-unregistered`
@@ -100,6 +91,17 @@ export declare class MessagingBroker {
     private mutateSubscriptions;
     /** Topics an active token is currently subscribed to (routing input). */
     private topicsOf;
+    /**
+     * Every device token the broker knows about, minted or merely subscribed,
+     * and the topics each is subscribed to (the `tokens` service-tool method's
+     * read). A token stays listed after `deleteTokenFor` invalidates it,
+     * reported `unregistered`, the same dead-is-dead-immediately contract
+     * {@link tokenState} already carries. A token this sandbox never minted but
+     * that `subscribeToTopic` accepted anyway is listed `unknown`, because it
+     * is genuinely part of the sandbox's subscription state even though this
+     * sandbox never issued it.
+     */
+    tokens(): RegisteredToken[];
     /**
      * Validate and accept a message — the send plane. Throws
      * {@link BrokerSendError} with the exact captured envelope on every
@@ -118,19 +120,19 @@ export declare class MessagingBroker {
     }): AcceptedSend;
     /** Numeric message-id mint for topic/condition targets (prod shape: long numeric string). */
     private mintNumericId;
-    private matchesAnyRecipient;
+    private matchingRecipients;
     private toPayload;
     /**
      * Record a window client's visibility. Mirrors set this (per tab later,
      * one simulated client in the degenerate case) so headless tests can
      * drive both routes.
      */
-    setClientVisibility(clientId: string, state: ClientVisibilityState): void;
+    setClientVisibility(clientId: string, state: ClientVisibilityState, recipientId?: string): void;
     removeClient(clientId: string): void;
     /** Foreground (`onMessage`) handler. Returns an unsubscribe function. */
-    onForegroundMessage(handler: PayloadHandler): () => void;
+    onForegroundMessage(handler: PayloadHandler, recipientId?: string): () => void;
     /** Background (`onBackgroundMessage`) handler. Returns an unsubscribe function. */
-    onBackgroundMessage(handler: PayloadHandler): () => void;
+    onBackgroundMessage(handler: PayloadHandler, recipientId?: string): () => void;
     /**
      * Inject a delivery directly into the client plane (the mirrors'
      * `sandbox.deliver` driver; later the host's `messaging.deliver` op).
@@ -147,14 +149,25 @@ export declare class MessagingBroker {
         };
         from?: string;
         messageId?: string;
-    }): DeliveryResult;
+    }, recipientId?: string): DeliveryResult;
     /**
      * THE captured routing rule (oracle: `messaging-web-visibility-routing`):
-     * foreground handlers iff ANY window client reports `visible`; otherwise
+     * foreground handlers iff a window of THIS recipient reports `visible`; otherwise
      * background handlers. Visibility, never focus. Routing is exclusive —
      * one route per delivery.
      */
     private route;
+    /**
+     * What was delivered, in delivery order: foreground or background, handled
+     * or not (the `deliveries` service-tool method's read). Folded out of the
+     * sandbox event stream's `message_delivered` events, which are the delivery
+     * history; the broker keeps no second copy. `since` is a clock timestamp
+     * cursor; entries at or after it are returned. A `send` with no matching
+     * recipient never calls {@link route}, so it emits nothing here. Only an
+     * actual routing decision does.
+     */
+    acknowledge(messageId: string, recipientId: string, observerId: string, stage: DeliveryStage): void;
+    deliveries(since?: number): DeliveryLogEntry[];
     /**
      * Land a broker operation on the sandbox's unified event stream.
      * Best-effort, storage-precedent: a throw from the emit path must never

package/dist/messaging/broker/broker.d.ts.map

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