@pyric/cli 0.1.0-alpha.14 → 0.1.0-alpha.16

package/dist/serve/{docs-ui → site-ui}/docs/pyric-cli-serve-worker-reference-api.md

@@ -1,5 +1,113 @@
 <!-- Generated from published package declarations via TypeDoc. Rendered by the api-reference content loader. -->
 
+## Classes
+
+<a id="rtdbondisconnect"></a>
+
+### RtdbOnDisconnect
+
+#### Constructors
+
+<a id="constructor"></a>
+
+##### Constructor
+
+```ts
+new RtdbOnDisconnect(_repo: RtdbRefHandle, _path?: string): RtdbOnDisconnect;
+```
+
+###### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `_repo` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `_path?` | `string` |
+
+###### Returns
+
+[`RtdbOnDisconnect`](#rtdbondisconnect)
+
+#### Methods
+
+<a id="cancel"></a>
+
+##### cancel()
+
+```ts
+cancel(): Promise<void>;
+```
+
+###### Returns
+
+`Promise`\<`void`\>
+
+<a id="remove"></a>
+
+##### remove()
+
+```ts
+remove(): Promise<void>;
+```
+
+###### Returns
+
+`Promise`\<`void`\>
+
+<a id="set"></a>
+
+##### set()
+
+```ts
+set(value: unknown): Promise<void>;
+```
+
+###### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `value` | `unknown` |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+<a id="setwithpriority"></a>
+
+##### setWithPriority()
+
+```ts
+setWithPriority(value: unknown, priority: string | number): Promise<void>;
+```
+
+###### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `value` | `unknown` |
+| `priority` | `string` \| `number` |
+
+###### Returns
+
+`Promise`\<`void`\>
+
+<a id="update"></a>
+
+##### update()
+
+```ts
+update(values: Record<string, unknown>): Promise<void>;
+```
+
+###### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `values` | `Record`\<`string`, `unknown`\> |
+
+###### Returns
+
+`Promise`\<`void`\>
+
 ## Interfaces
 
 <a id="clientauth"></a>
@@ -36,25 +144,6 @@ Opaque client-side Firestore handle. Holds the MessagePort to the worker.
 
 ### ClientDocSnapshot
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type | Description |
@@ -109,25 +198,6 @@ Worker-backed Storage handle (carries the shared `MessagePort`).
 
 ### ClientQuerySnapshot
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type |
@@ -142,25 +212,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ### ClientRtdb
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type |
@@ -248,7 +299,7 @@ get(ref: DocRefHandle): Promise<ClientDocSnapshot>;
 
 `Promise`\<[`ClientDocSnapshot`](#clientdocsnapshot)\>
 
-<a id="set"></a>
+<a id="set-2"></a>
 
 ##### set()
 
@@ -276,7 +327,7 @@ set(
 
 `void`
 
-<a id="update"></a>
+<a id="update-2"></a>
 
 ##### update()
 
@@ -419,7 +470,7 @@ delete(ref: DocRefHandle): ClientWriteBatch;
 
 [`ClientWriteBatch`](#clientwritebatch)
 
-<a id="set-2"></a>
+<a id="set-4"></a>
 
 ##### set()
 
@@ -447,7 +498,7 @@ set(
 
 [`ClientWriteBatch`](#clientwritebatch)
 
-<a id="update-2"></a>
+<a id="update-4"></a>
 
 ##### update()
 
@@ -485,6 +536,18 @@ Client-side collection reference.
 
 ***
 
+<a id="disconnectclientoptions"></a>
+
+### DisconnectClientOptions
+
+#### Properties
+
+| Property | Type | Description |
+| :------ | :------ | :------ |
+| <a id="acktimeoutms"></a> `ackTimeoutMs?` | `number` | Bound version-skew and worker-crash cases where no disconnect reply arrives. |
+
+***
+
 <a id="docrefhandle"></a>
 
 ### DocRefHandle
@@ -506,25 +569,6 @@ Client-side document reference — carries a DocRef descriptor + port.
 
 ### PresenceSession
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type | Description |
@@ -564,6 +608,41 @@ Authoritative presence snapshot owned by the SharedWorker host.
 
 ***
 
+<a id="pyricruntimemanifest"></a>
+
+### PyricRuntimeManifest
+
+Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+
+This barrel exports ONLY the leaf client + the wire-protocol types — the
+pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
+connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
+does NOT re-export `host.ts`/`entry.ts`:
+  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
+    the backend) — node/engine-heavy, never wanted in a page bundle.
+  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+
+`client.ts` imports only the value codec
+(`pyric/firestore/internal/value-codec`, a leaf internal seam)
+and type-only `pyric/sandbox` (erased at build), so this entry stays free of
+the ~10 MB rules/sandbox engine — safe to import from any browser app.
+
+Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
+`import { getFirestore, subscribeEvents, setLens } from
+'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+
+#### Properties
+
+| Property | Type | Description |
+| :------ | :------ | :------ |
+| <a id="studiourl"></a> `studioUrl` | `string` | - |
+| <a id="worker"></a> `worker` | \{ `name`: `string`; `servedEpoch`: `string`; `url`: `string`; \} | - |
+| `worker.name` | `string` | - |
+| `worker.servedEpoch` | `string` | Content epoch served by the current dev server; null in in-page mode. |
+| `worker.url` | `string` | - |
+
+***
+
 <a id="queryhandle"></a>
 
 ### QueryHandle
@@ -606,30 +685,12 @@ and bridges it here; the worker seeds it + `restoreSession`s it (no password
 
 ### RtdbDataSnapshot
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type |
 | :------ | :------ | :------ |
 | <a id="key"></a> `key` | `readonly` | `string` |
+| <a id="priority"></a> `priority` | `readonly` | `string` \| `number` |
 | <a id="ref-1"></a> `ref` | `readonly` | [`RtdbRefHandle`](#rtdbrefhandle) |
 | <a id="size-1"></a> `size` | `readonly` | `number` |
 
@@ -755,25 +816,6 @@ val(): unknown;
 
 ### RtdbRefHandle
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Properties
 
 | Property | Modifier | Type |
@@ -786,25 +828,55 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 #### Methods
 
-<a id="tostring"></a>
+<a id="isequal"></a>
 
-##### toString()
+##### isEqual()
 
 ```ts
-toString(): string;
+isEqual(other: RtdbRefHandle): boolean;
 ```
 
-###### Returns
+###### Parameters
 
-`string`
+| Parameter | Type |
+| :------ | :------ |
+| `other` | [`RtdbRefHandle`](#rtdbrefhandle) |
 
-***
+###### Returns
 
-<a id="serializedidtokenresult"></a>
+`boolean`
 
-### SerializedIdTokenResult
+<a id="tojson-2"></a>
 
-Wire form of `getIdTokenResult()`.
+##### toJSON()
+
+```ts
+toJSON(): string;
+```
+
+###### Returns
+
+`string`
+
+<a id="tostring"></a>
+
+##### toString()
+
+```ts
+toString(): string;
+```
+
+###### Returns
+
+`string`
+
+***
+
+<a id="serializedidtokenresult"></a>
+
+### SerializedIdTokenResult
+
+Wire form of `getIdTokenResult()`.
 
 #### Properties
 
@@ -861,6 +933,38 @@ Wire form of a `UserCredential` returned by the sign-in/create ops.
 | <a id="providerid-4"></a> `providerId` | `readonly` | `string` |
 | <a id="user-1"></a> `user` | `readonly` | [`SerializedUser`](#serializeduser) |
 
+***
+
+<a id="workerreplacement"></a>
+
+### WorkerReplacement
+
+#### Methods
+
+<a id="dispose"></a>
+
+##### dispose()
+
+```ts
+dispose(): void;
+```
+
+###### Returns
+
+`void`
+
+<a id="request"></a>
+
+##### request()
+
+```ts
+request(): Promise<void>;
+```
+
+###### Returns
+
+`Promise`\<`void`\>
+
 ## Type Aliases
 
 <a id="anyhandle"></a>
@@ -945,25 +1049,6 @@ const browserLocalPersistence: {
 };
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Type Declaration
 
 <a id="type"></a>
@@ -986,25 +1071,6 @@ const browserSessionPersistence: {
 };
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Type Declaration
 
 <a id="type-1"></a>
@@ -1064,6 +1130,57 @@ const PRESENCE_STALE_MS: 90000 = 90000;
 Lease TTL. Sized to tolerate one delayed background-tab heartbeat under
 typical timer throttling (~1/min) without falsely evicting a live page.
 
+***
+
+<a id="pyric_worker_generation_key"></a>
+
+### PYRIC\_WORKER\_GENERATION\_KEY
+
+```ts
+const PYRIC_WORKER_GENERATION_KEY: "pyric:worker-generation" = "pyric:worker-generation";
+```
+
+***
+
+<a id="pyric_worker_name"></a>
+
+### PYRIC\_WORKER\_NAME
+
+```ts
+const PYRIC_WORKER_NAME: "pyric-shared-worker" = "pyric-shared-worker";
+```
+
+Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+
+This barrel exports ONLY the leaf client + the wire-protocol types — the
+pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
+connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
+does NOT re-export `host.ts`/`entry.ts`:
+  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
+    the backend) — node/engine-heavy, never wanted in a page bundle.
+  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+
+`client.ts` imports only the value codec
+(`pyric/firestore/internal/value-codec`, a leaf internal seam)
+and type-only `pyric/sandbox` (erased at build), so this entry stays free of
+the ~10 MB rules/sandbox engine — safe to import from any browser app.
+
+Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
+`import { getFirestore, subscribeEvents, setLens } from
+'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+
+***
+
+<a id="pyric_worker_url"></a>
+
+### PYRIC\_WORKER\_URL
+
+```ts
+const PYRIC_WORKER_URL: "/__pyric/sdk/worker.js" = "/__pyric/sdk/worker.js";
+```
+
+Stable routes and identity used by the served runtime and its UI.
+
 ## Functions
 
 <a id="acceptprovidercredential"></a>
@@ -1103,25 +1220,6 @@ read right after the await reflects the new user.
 function addDoc(coll: CollRefHandle, data: Record<string, unknown>): Promise<DocRefHandle>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1143,25 +1241,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminClearUsers(auth: ClientAuth): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1182,25 +1261,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminCreateUser(auth: ClientAuth, request: CreateUserRequest): Promise<AuthUserRecord>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1222,25 +1282,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminDeleteDocument(db: ClientDb, path: string): Promise<boolean>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1262,25 +1303,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminDeleteRtdbValue(db: ClientDb | ClientRtdb, path: string): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1302,25 +1324,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminDeleteUser(auth: ClientAuth, uid: string): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1342,26 +1345,7 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminGetDocument(db: ClientDb, path: string): Promise<Record<string, unknown>>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
-#### Parameters
+#### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
@@ -1386,25 +1370,6 @@ function adminListDocuments(db: ClientDb, path: string): Promise<{
 }[]>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1430,25 +1395,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function adminReadRtdbState(db: ClientDb | ClientRtdb): Promise<unknown>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1472,25 +1418,6 @@ function adminReadState(db: ClientDb, opts?: {
 }): Promise<Record<string, unknown>>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1517,25 +1444,6 @@ function adminSetDocument(
 data: unknown): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1561,25 +1469,6 @@ function adminSetRtdbValue(
 value: unknown): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1606,14 +1495,7 @@ function adminSubscribeRtdbValue(
    error?: (err: unknown) => void): Unsubscribe;
 ```
 
-Subscribe to the raw value at an RTDB path with the ADMIN lens (Pyric Studio
-data viewer). Rides the same `{service:'rtdb'}` value-subscription channel as
-`rtdbOnValue`, but pins `actAs: {mode:'admin'}` per-sub instead of following
-the module default lens, so Studio's viewer stays admin (PRINCIPLES M3) while
-the page's own listeners keep their session semantics.
-
-`next` receives the plain JSON value at `path` (`null` when absent) on
-subscribe and again after every write that changes the subtree.
+Subscribe with an explicit admin lens so Studio stays rules-independent.
 
 #### Parameters
 
@@ -1641,25 +1523,6 @@ function adminUpdateRtdbValue(
 values: Record<string, unknown>): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1685,25 +1548,6 @@ function adminUpdateUser(
 request: UpdateUserRequest): Promise<AuthUserRecord>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1748,25 +1592,6 @@ AND composite filter — every operand must match. See [or](#or).
 function arrayRemove(...values: unknown[]): SentinelMarker;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1787,25 +1612,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function arrayUnion(...values: unknown[]): SentinelMarker;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -1984,25 +1790,6 @@ function createUserWithEmailAndPassword(
 password: string): Promise<ClientUserCredential>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2017,32 +1804,35 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="deletedoc"></a>
+<a id="createworkerreplacement"></a>
 
-### deleteDoc()
+### createWorkerReplacement()
 
 ```ts
-function deleteDoc(ref: DocRefHandle): Promise<void>;
+function createWorkerReplacement(options: WorkerReplacementOptions): WorkerReplacement;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+Coordinate one reload per page after the old SharedWorker announces retirement.
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+#### Parameters
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+| Parameter | Type |
+| :------ | :------ |
+| `options` | `WorkerReplacementOptions` |
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+#### Returns
+
+[`WorkerReplacement`](#workerreplacement)
+
+***
+
+<a id="deletedoc"></a>
+
+### deleteDoc()
+
+```ts
+function deleteDoc(ref: DocRefHandle): Promise<void>;
+```
 
 #### Parameters
 
@@ -2064,25 +1854,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function deleteField(): SentinelMarker;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Returns
 
 `SentinelMarker`
@@ -2135,15 +1906,36 @@ Phase 3: delete a named branch.
 
 ***
 
-<a id="doc"></a>
+<a id="disconnectclient"></a>
 
-### doc()
+### disconnectClient()
 
 ```ts
-function doc(parent: ClientDb | CollRefHandle, ...pathSegments: string[]): DocRefHandle;
+function disconnectClient(db: ClientDb, options?: DisconnectClientOptions): Promise<void>;
 ```
 
-Build a document reference. Mirrors `pyric/firestore`'s `doc(db, path)`.
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `db` | [`ClientDb`](#clientdb) |
+| `options?` | [`DisconnectClientOptions`](#disconnectclientoptions) |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+<a id="doc"></a>
+
+### doc()
+
+```ts
+function doc(parent: ClientDb | CollRefHandle, ...pathSegments: string[]): DocRefHandle;
+```
+
+Build a document reference. Mirrors `pyric/firestore`'s `doc(db, path)`.
 
 WHY CLIENT-SIDE: Firebase's `doc()` is synchronous and path-only — it
 needs no data from the sandbox. We build a descriptor object here and
@@ -2170,25 +1962,6 @@ include the port so execution calls can route to the worker.
 function endAt(...values: unknown[]): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2209,25 +1982,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function endBefore(...values: unknown[]): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2297,25 +2051,6 @@ it to a file and [importWorkerState](#importworkerstate) it into another instanc
 function getActiveRules(db: ClientDb | ClientRtdb, service?: "firestore" | "database"): Promise<unknown>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2455,25 +2190,6 @@ function getCountFromServer(source: CollRefHandle | QueryHandle): Promise<{
 }>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2498,25 +2214,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function getDoc(ref: DocRefHandle): Promise<ClientDocSnapshot>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2537,25 +2234,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function getDocs(source: CollRefHandle | QueryHandle): Promise<ClientQuerySnapshot>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2601,25 +2279,6 @@ function getFirestore(
    options?: SharedWorkerConnectionOptions): ClientDb;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2729,25 +2388,6 @@ function getProviderConfig(auth: ClientAuth): Promise<{
 }[]>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2771,25 +2411,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function getRulesStatus(db: ClientDb | ClientRtdb, service?: "firestore" | "database"): Promise<unknown>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2936,25 +2557,6 @@ Phase 2 (clobber): replace this sandbox's ENTIRE state with `bundle`.
 function increment(n: number): SentinelMarker;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -2975,25 +2577,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function limit(n: number): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -3014,25 +2597,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function limitToLast(n: number): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -3130,26 +2694,7 @@ Enumerate subcollection ids under a document path (Pyric Studio data browse).
 function listUsers(auth: ClientAuth): Promise<AuthUserRecord[]>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
-#### Parameters
+#### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
@@ -3286,6 +2831,34 @@ to deregister the listener on the worker side.
 
 ***
 
+<a id="onworkerruntimereload"></a>
+
+### onWorkerRuntimeReload()
+
+```ts
+function onWorkerRuntimeReload(listener: (epoch: string) => void): () => void;
+```
+
+Observe the worker's all-pages reload signal.
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `listener` | (`epoch`: `string`) => `void` |
+
+#### Returns
+
+```ts
+(): void;
+```
+
+##### Returns
+
+`void`
+
+***
+
 <a id="or"></a>
 
 ### or()
@@ -3318,35 +2891,93 @@ filters (`where()`, or nested `or()`/`and()`). Mirrors `pyric/firestore`'s
 function orderBy(field: string, direction?: "asc" | "desc"): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `field` | `string` |
+| `direction?` | `"asc"` \| `"desc"` |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`QueryConstraintHandle`
+
+***
+
+<a id="ownclientuntilpagehide"></a>
+
+### ownClientUntilPagehide()
+
+```ts
+function ownClientUntilPagehide(
+   client: ClientDb,
+   events?: PagehideEvents,
+   disconnectClientImpl?: Disconnect): {
+  disconnect: Promise<void>;
+  dispose: void;
+};
+```
+
+Own a worker port until its page permanently leaves.
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `field` | `string` |
-| `direction?` | `"asc"` \| `"desc"` |
+| `client` | [`ClientDb`](#clientdb) |
+| `events?` | `PagehideEvents` |
+| `disconnectClientImpl?` | `Disconnect` |
 
 #### Returns
 
-`QueryConstraintHandle`
+```ts
+{
+  disconnect: Promise<void>;
+  dispose: void;
+}
+```
+
+##### disconnect()
+
+```ts
+disconnect(): Promise<void>;
+```
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### dispose()
+
+```ts
+dispose(): void;
+```
+
+###### Returns
+
+`void`
+
+***
+
+<a id="preflightworkerepochstorage"></a>
+
+### preflightWorkerEpochStorage()
+
+```ts
+function preflightWorkerEpochStorage(storage: EpochStorage): void;
+```
+
+Prove origin storage works without publishing a successor generation.
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `storage` | `EpochStorage` |
+
+#### Returns
+
+`void`
 
 ***
 
@@ -3374,6 +3005,28 @@ Mirrors `pyric/firestore`'s `query(source, ...constraints)`.
 
 ***
 
+<a id="readpyricruntimemanifest"></a>
+
+### readPyricRuntimeManifest()
+
+```ts
+function readPyricRuntimeManifest(documentLike?: RuntimeDocument): PyricRuntimeManifest;
+```
+
+Read the server-stamped worker epoch before application code starts.
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `documentLike?` | `RuntimeDocument` |
+
+#### Returns
+
+[`PyricRuntimeManifest`](#pyricruntimemanifest)
+
+***
+
 <a id="ref-2"></a>
 
 ### ref()
@@ -3467,6 +3120,29 @@ history batches aren't coalescible, so it needs bounded backpressure first
 
 ***
 
+<a id="rememberworkerepoch"></a>
+
+### rememberWorkerEpoch()
+
+```ts
+function rememberWorkerEpoch(epoch: string, storage: EpochStorage): void;
+```
+
+Persist the generation boundary before a page reloads.
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `epoch` | `string` |
+| `storage` | `EpochStorage` |
+
+#### Returns
+
+`void`
+
+***
+
 <a id="resetall"></a>
 
 ### resetAll()
@@ -3497,32 +3173,43 @@ counterpart of calling `sandbox.resetAll()` on an in-process sandbox.
 
 ***
 
-<a id="rtdbchild"></a>
+<a id="retireworkerruntime"></a>
 
-### rtdbChild()
+### retireWorkerRuntime()
 
 ```ts
-function rtdbChild(parent: RtdbRefHandle, path: string): RtdbRefHandle;
+function retireWorkerRuntime(
+   db: ClientDb,
+   targetEpoch: string,
+   options?: {
+  timeoutMs?: number;
+}): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+Ask the current SharedWorker to drain accepted work and retire.
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+#### Parameters
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+| Parameter | Type |
+| :------ | :------ |
+| `db` | [`ClientDb`](#clientdb) |
+| `targetEpoch` | `string` |
+| `options?` | \{ `timeoutMs?`: `number`; \} |
+| `options.timeoutMs?` | `number` |
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+<a id="rtdbchild"></a>
+
+### rtdbChild()
+
+```ts
+function rtdbChild(parent: RtdbRefHandle, path: string): RtdbRefHandle;
+```
 
 #### Parameters
 
@@ -3545,25 +3232,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function rtdbConnectDatabaseEmulator(): void;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Returns
 
 `void`
@@ -3575,33 +3243,14 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 ### rtdbGet()
 
 ```ts
-function rtdbGet(r: RtdbRefHandle): Promise<RtdbDataSnapshot>;
+function rtdbGet(target: RtdbTarget): Promise<RtdbDataSnapshot>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `target` | `RtdbTarget` |
 
 #### Returns
 
@@ -3617,25 +3266,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function rtdbGetDatabase(source?: string | ClientDb | URL, name?: string): ClientRtdb;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -3649,43 +3279,39 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="rtdboff"></a>
+<a id="rtdbgooffline"></a>
 
-### rtdbOff()
+### rtdbGoOffline()
 
 ```ts
-function rtdbOff(
-   _r: RtdbRefHandle,
-   _eventType?: unknown,
-   _callback?: unknown): void;
+function rtdbGoOffline(db: ClientRtdb): void;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `db` | [`ClientRtdb`](#clientrtdb) |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`void`
+
+***
+
+<a id="rtdbgoonline"></a>
+
+### rtdbGoOnline()
+
+```ts
+function rtdbGoOnline(db: ClientRtdb): void;
+```
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `_r` | [`RtdbRefHandle`](#rtdbrefhandle) |
-| `_eventType?` | `unknown` |
-| `_callback?` | `unknown` |
+| `db` | [`ClientRtdb`](#clientrtdb) |
 
 #### Returns
 
@@ -3693,43 +3319,53 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="rtdbonvalue"></a>
+<a id="rtdboff"></a>
 
-### rtdbOnValue()
+### rtdbOff()
 
 ```ts
-function rtdbOnValue(
-   r: RtdbRefHandle,
-   next: (snap: RtdbDataSnapshot) => void,
-   error?: (err: unknown) => void): Unsubscribe;
+function rtdbOff(
+   target: RtdbTarget,
+   eventType?: RtdbEventType,
+   callback?: object): void;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `target` | `RtdbTarget` |
+| `eventType?` | `RtdbEventType` |
+| `callback?` | `object` |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`void`
+
+***
+
+<a id="rtdbonchildadded"></a>
+
+### rtdbOnChildAdded()
+
+```ts
+function rtdbOnChildAdded(
+   target: RtdbTarget,
+   next: ChildCallback,
+   cancel?: CancelOrOptions,
+   options?: ListenOptions,
+   identity?: object): Unsubscribe;
+```
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
-| `next` | (`snap`: [`RtdbDataSnapshot`](#rtdbdatasnapshot)) => `void` |
-| `error?` | (`err`: `unknown`) => `void` |
+| `target` | `RtdbTarget` |
+| `next` | `ChildCallback` |
+| `cancel?` | `CancelOrOptions` |
+| `options?` | `ListenOptions` |
+| `identity?` | `object` |
 
 #### Returns
 
@@ -3737,38 +3373,162 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="rtdbpush"></a>
+<a id="rtdbonchildchanged"></a>
 
-### rtdbPush()
+### rtdbOnChildChanged()
 
 ```ts
-function rtdbPush(r: RtdbRefHandle, value?: unknown): RtdbRefHandle & PromiseLike<RtdbRefHandle>;
+function rtdbOnChildChanged(
+   target: RtdbTarget,
+   next: ChildCallback,
+   cancel?: CancelOrOptions,
+   options?: ListenOptions,
+   identity?: object): Unsubscribe;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `target` | `RtdbTarget` |
+| `next` | `ChildCallback` |
+| `cancel?` | `CancelOrOptions` |
+| `options?` | `ListenOptions` |
+| `identity?` | `object` |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+[`Unsubscribe`](#unsubscribe)
+
+***
+
+<a id="rtdbonchildmoved"></a>
+
+### rtdbOnChildMoved()
+
+```ts
+function rtdbOnChildMoved(
+   target: RtdbTarget,
+   next: ChildCallback,
+   cancel?: CancelOrOptions,
+   options?: ListenOptions,
+   identity?: object): Unsubscribe;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `target` | `RtdbTarget` |
+| `next` | `ChildCallback` |
+| `cancel?` | `CancelOrOptions` |
+| `options?` | `ListenOptions` |
+| `identity?` | `object` |
+
+#### Returns
+
+[`Unsubscribe`](#unsubscribe)
+
+***
+
+<a id="rtdbonchildremoved"></a>
+
+### rtdbOnChildRemoved()
+
+```ts
+function rtdbOnChildRemoved(
+   target: RtdbTarget,
+   next: ChildCallback,
+   cancel?: CancelOrOptions,
+   options?: ListenOptions,
+   identity?: object): Unsubscribe;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `target` | `RtdbTarget` |
+| `next` | `ChildCallback` |
+| `cancel?` | `CancelOrOptions` |
+| `options?` | `ListenOptions` |
+| `identity?` | `object` |
+
+#### Returns
+
+[`Unsubscribe`](#unsubscribe)
+
+***
+
+<a id="rtdbondisconnect-1"></a>
+
+### rtdbOnDisconnect()
+
+```ts
+function rtdbOnDisconnect(ref: RtdbRefHandle): RtdbOnDisconnect;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
+
+#### Returns
+
+[`RtdbOnDisconnect`](#rtdbondisconnect)
+
+***
+
+<a id="rtdbonvalue"></a>
+
+### rtdbOnValue()
+
+```ts
+function rtdbOnValue(
+   target: RtdbTarget,
+   next: (snap: RtdbDataSnapshot) => void,
+   cancelCallbackOrOptions?:
+  | (err: unknown) => void
+  | {
+  onlyOnce?: boolean;
+},
+   options?: {
+  onlyOnce?: boolean;
+},
+   registryCallback?: object): Unsubscribe;
+```
+
+#### Parameters
+
+| Parameter | Type |
+| :------ | :------ |
+| `target` | `RtdbTarget` |
+| `next` | (`snap`: [`RtdbDataSnapshot`](#rtdbdatasnapshot)) => `void` |
+| `cancelCallbackOrOptions?` | \| (`err`: `unknown`) => `void` \| \{ `onlyOnce?`: `boolean`; \} |
+| `options?` | \{ `onlyOnce?`: `boolean`; \} |
+| `options.onlyOnce?` | `boolean` |
+| `registryCallback?` | `object` |
+
+#### Returns
+
+[`Unsubscribe`](#unsubscribe)
+
+***
+
+<a id="rtdbpush"></a>
+
+### rtdbPush()
+
+```ts
+function rtdbPush(ref: RtdbRefHandle, value?: unknown): RtdbRefHandle & PromiseLike<RtdbRefHandle>;
+```
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
 | `value?` | `unknown` |
 
 #### Returns
@@ -3785,25 +3545,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function rtdbRef(db: ClientRtdb, path?: string): RtdbRefHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -3822,37 +3563,49 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 ### rtdbRemove()
 
 ```ts
-function rtdbRemove(r: RtdbRefHandle): Promise<void>;
+function rtdbRemove(ref: RtdbRefHandle): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`Promise`\<`void`\>
+
+***
+
+<a id="rtdbruntransaction"></a>
+
+### rtdbRunTransaction()
+
+```ts
+function rtdbRunTransaction<T>(
+   ref: RtdbRefHandle,
+   transactionUpdate: (current: T) => T,
+options?: RtdbTransactionOptions): Promise<RtdbTransactionResult>;
+```
+
+#### Type Parameters
+
+| Type Parameter |
+| :------ |
+| `T` |
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `transactionUpdate` | (`current`: `T`) => `T` |
+| `options?` | `RtdbTransactionOptions` |
 
 #### Returns
 
-`Promise`\<`void`\>
+`Promise`\<`RtdbTransactionResult`\>
 
 ***
 
@@ -3865,24 +3618,7 @@ function rtdbServerTimestamp(): {
 };
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+RTDB environment controls and server-value construction for served apps.
 
 #### Returns
 
@@ -3898,34 +3634,36 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 ### rtdbSet()
 
 ```ts
-function rtdbSet(r: RtdbRefHandle, value: unknown): Promise<void>;
+function rtdbSet(ref: RtdbRefHandle, value: unknown): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `value` | `unknown` |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`Promise`\<`void`\>
+
+***
+
+<a id="rtdbsetpriority"></a>
+
+### rtdbSetPriority()
+
+```ts
+function rtdbSetPriority(ref: RtdbRefHandle, priority: string | number): Promise<void>;
+```
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
-| `value` | `unknown` |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `priority` | `string` \| `number` |
 
 #### Returns
 
@@ -3933,38 +3671,44 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="rtdbupdate"></a>
+<a id="rtdbsetwithpriority"></a>
 
-### rtdbUpdate()
+### rtdbSetWithPriority()
 
 ```ts
-function rtdbUpdate(r: RtdbRefHandle, values: Record<string, unknown>): Promise<void>;
+function rtdbSetWithPriority(
+   ref: RtdbRefHandle,
+   value: unknown,
+priority: string | number): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+#### Parameters
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+| Parameter | Type |
+| :------ | :------ |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `value` | `unknown` |
+| `priority` | `string` \| `number` |
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Returns
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+`Promise`\<`void`\>
+
+***
+
+<a id="rtdbupdate"></a>
+
+### rtdbUpdate()
+
+```ts
+function rtdbUpdate(ref: RtdbRefHandle, values: Record<string, unknown>): Promise<void>;
+```
 
 #### Parameters
 
 | Parameter | Type |
 | :------ | :------ |
-| `r` | [`RtdbRefHandle`](#rtdbrefhandle) |
+| `ref` | [`RtdbRefHandle`](#rtdbrefhandle) |
 | `values` | `Record`\<`string`, `unknown`\> |
 
 #### Returns
@@ -4047,32 +3791,13 @@ Phase 3: save the live sandbox as a named branch (a saved state bundle).
 
 ***
 
-<a id="servertimestamp"></a>
-
-### serverTimestamp()
-
-```ts
-function serverTimestamp(): SentinelMarker;
-```
-
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+<a id="servertimestamp"></a>
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+### serverTimestamp()
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+```ts
+function serverTimestamp(): SentinelMarker;
+```
 
 #### Returns
 
@@ -4091,25 +3816,6 @@ function setDatabaseRules(db: ClientDb | ClientRtdb, source: unknown): Promise<{
 }>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4140,25 +3846,6 @@ function setDoc(
 }): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4187,25 +3874,6 @@ function setFirestoreRules(db: ClientDb, source: string): Promise<{
 }>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4311,25 +3979,6 @@ function setProviderConfig(
 enabled: boolean): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4381,25 +4030,6 @@ if the new rules deny them.
 function signInAnonymously(auth: ClientAuth): Promise<ClientUserCredential>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4423,25 +4053,6 @@ function signInWithEmailAndPassword(
 password: string): Promise<ClientUserCredential>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4464,25 +4075,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function signOut(auth: ClientAuth): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4503,25 +4095,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function startAfter(...values: unknown[]): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4542,25 +4115,6 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 function startAt(...values: unknown[]): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4703,25 +4257,6 @@ Phase 3 (clobber): switch the live sandbox to a named branch's state.
 function updateDoc(ref: DocRefHandle, data: Record<string, unknown>): Promise<void>;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4780,25 +4315,6 @@ function where(
    value: unknown): QueryConstraintHandle;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
-
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
-
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
-
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
-
 #### Parameters
 
 | Parameter | Type |
@@ -4813,32 +4329,42 @@ Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
 
 ***
 
-<a id="writebatch"></a>
+<a id="workernameforepoch"></a>
 
-### writeBatch()
+### workerNameForEpoch()
 
 ```ts
-function writeBatch(db: ClientDb): ClientWriteBatch;
+function workerNameForEpoch(servedEpoch: string, storage: EpochStorage): string;
 ```
 
-Browser-safe SharedWorker CLIENT surface (Pyric Studio data plane).
+Select the origin's active worker generation.
 
-This barrel exports ONLY the leaf client + the wire-protocol types — the
-pieces a browser app (the served page, or Pyric Studio's Vite app) imports to
-connect to the `pyric-shared-worker` over its `MessagePort`. It deliberately
-does NOT re-export `host.ts`/`entry.ts`:
-  - `host.ts` imports the full `pyric/firestore` + `pyric/auth` engine (it IS
-    the backend) — node/engine-heavy, never wanted in a page bundle.
-  - `entry.ts` references `SharedWorkerGlobalScope` and is esbuild-only.
+A browser that predates generation-aware workers has no stored epoch but may
+still have the legacy `pyric-shared-worker` alive. Seed the first served
+epoch before connecting so a new client never attaches to that incompatible
+worker. Later releases keep using the stored generation until replacement
+is explicitly committed.
 
-`client.ts` imports only the value codec
-(`pyric/firestore/internal/value-codec`, a leaf internal seam)
-and type-only `pyric/sandbox` (erased at build), so this entry stays free of
-the ~10 MB rules/sandbox engine — safe to import from any browser app.
+#### Parameters
 
-Exposed by `@pyric/cli`'s `./serve/worker` package export so Studio can
-`import { getFirestore, subscribeEvents, setLens } from
-'@pyric/cli/serve/worker'` and reach the live SharedWorker backend.
+| Parameter | Type |
+| :------ | :------ |
+| `servedEpoch` | `string` |
+| `storage` | `EpochStorage` |
+
+#### Returns
+
+`string`
+
+***
+
+<a id="writebatch"></a>
+
+### writeBatch()
+
+```ts
+function writeBatch(db: ClientDb): ClientWriteBatch;
+```
 
 #### Parameters