npm - @pyric/cli - Versions diffs - 0.1.0-alpha.10 → 0.1.0-alpha.11 - Mend

@pyric/cli 0.1.0-alpha.10 → 0.1.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (304) hide show

package/dist/serve/docs-ui/docs/pyric-cli-serve-worker-reference-api/index.html CHANGED Viewed

@@ -1,6 +1,7 @@
-<!DOCTYPE html><html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>API reference: @pyric/cli/serve/worker · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/cli/serve/worker."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet"><link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.DPUwShm2.css"></head> <body>  <header class="studio__bar"> <div class="studio__bar-inner"> <a class="studio__brand" href="/__pyric/ui/" aria-label="Pyric Studio">Pyric</a> <nav class="studio__nav" aria-label="Studio tabs"> <a class="studio__nav-tab" href="/__pyric/ui/"> Home </a><a class="studio__nav-tab" href="/__pyric/ui/firestore"> Firestore </a><a class="studio__nav-tab" href="/__pyric/ui/auth"> Auth </a><a class="studio__nav-tab" href="/__pyric/ui/rtdb"> RTDB </a><a class="studio__nav-tab" href="/__pyric/ui/storage"> Storage </a><a class="studio__nav-tab" href="/__pyric/ui/traffic"> Traffic </a><a class="studio__nav-tab" href="/__pyric/ui/settings"> Settings </a><a class="studio__nav-tab" href="/__pyric/ui/docs" aria-current="page"> Docs </a> </nav> </div> </header> <div class="docs-shell">  <details class="docs-nav-drawer"> <summary>Navigate</summary> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div> <script type="module">let i=null;function d(t){return i||(i=fetch(t).then(e=>e.json())),i}function l(t,e){return t.title.toLowerCase().includes(e)||t.excerpt.toLowerCase().includes(e)?!0:t.headings.some(r=>r.text.toLowerCase().includes(e))}function u(t,e,r){if(e.innerHTML="",t.length===0){e.hidden=!1;{const n=document.createElement("li");n.className="docs-search-empty",n.textContent="No matches",e.appendChild(n)}return}e.hidden=!1;for(const n of t.slice(0,8)){const s=document.createElement("li"),c=document.createElement("a");c.href=n.path;const o=document.createElement("span");o.className="docs-search-result-title",o.textContent=n.title;const a=document.createElement("span");a.className="docs-search-result-meta",a.textContent=[n.group,n.section].filter(Boolean).join(" / "),c.append(o,a),s.appendChild(c),e.appendChild(s)}}document.querySelectorAll(".docs-search").forEach(t=>{const e=t.dataset.indexUrl,r=t.querySelector(".docs-search-input"),n=t.querySelector(".docs-search-results");r.addEventListener("input",async()=>{const s=r.value.trim().toLowerCase();if(!s){n.hidden=!0,n.innerHTML="";return}const{pages:c}=await d(e);r.value.trim().toLowerCase()===s&&u(c.filter(o=>l(o,s)),n)}),r.addEventListener("focus",()=>{d(e),n.childElementCount>0&&(n.hidden=!1)}),r.addEventListener("keydown",s=>{s.key==="Escape"&&(r.value="",n.hidden=!0,n.innerHTML="",r.blur())}),r.addEventListener("blur",()=>{window.setTimeout(()=>{n.hidden=!0},150)})});document.addEventListener("keydown",t=>{if(!(t.metaKey||t.ctrlKey)||t.key.toLowerCase()!=="k")return;const e=[...document.querySelectorAll(".docs-search-input")].find(r=>r.offsetParent!==null);e&&(t.preventDefault(),e.focus(),e.select())});</script> <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/"> Overview </a><details class="docs-nav-group"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/"> Trust </a><details class="docs-nav-group"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/" aria-current="page"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> </details> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div>  <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/" id="nav-group-overview"> Overview </a><details class="docs-nav-group" id="nav-group-get-started"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-build"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-secure-debug"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-observe-shape"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-test"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-work-with-an-agent"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/" id="nav-group-trust"> Trust </a><details class="docs-nav-group" id="nav-group-conformance"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" id="nav-group-reference" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/" aria-current="page"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> <main class="doc-main"> <nav class="docs-breadcrumbs" aria-label="Breadcrumb"> <ol> <li>  <a href="/__pyric/ui/docs/api-reference/">API reference</a> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span>@pyric/cli</span> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span aria-current="page">@pyric/cli/serve/worker</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/cli/serve/worker</code></h1> <p class="api-reference-meta"> 144 published symbols from <code>@pyric/cli</code> </p> <p class="api-reference-source">
+<!DOCTYPE html><html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>API reference: @pyric/cli/serve/worker · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/cli/serve/worker."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet"><link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.CXh9yTP1.css">
+<link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.DUci-duz.css"></head> <body>  <header class="studio__bar"> <div class="studio__bar-inner"> <a class="studio__brand" href="/__pyric/ui/" aria-label="Pyric Studio">Pyric</a> <nav class="studio__nav" aria-label="Studio tabs"> <a class="studio__nav-tab" href="/__pyric/ui/"> Home </a><a class="studio__nav-tab" href="/__pyric/ui/firestore"> Firestore </a><a class="studio__nav-tab" href="/__pyric/ui/auth"> Auth </a><a class="studio__nav-tab" href="/__pyric/ui/rtdb"> RTDB </a><a class="studio__nav-tab" href="/__pyric/ui/storage"> Storage </a><a class="studio__nav-tab" href="/__pyric/ui/traffic"> Traffic </a><a class="studio__nav-tab" href="/__pyric/ui/settings"> Settings </a><a class="studio__nav-tab" href="/__pyric/ui/docs" aria-current="page"> Docs </a> </nav> </div> </header> <div class="docs-shell">  <details class="docs-nav-drawer"> <summary>Navigate</summary> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div> <script type="module">let i=null;function d(t){return i||(i=fetch(t).then(e=>e.json())),i}function l(t,e){return t.title.toLowerCase().includes(e)||t.excerpt.toLowerCase().includes(e)?!0:t.headings.some(r=>r.text.toLowerCase().includes(e))}function u(t,e,r){if(e.innerHTML="",t.length===0){e.hidden=!1;{const n=document.createElement("li");n.className="docs-search-empty",n.textContent="No matches",e.appendChild(n)}return}e.hidden=!1;for(const n of t.slice(0,8)){const s=document.createElement("li"),c=document.createElement("a");c.href=n.path;const o=document.createElement("span");o.className="docs-search-result-title",o.textContent=n.title;const a=document.createElement("span");a.className="docs-search-result-meta",a.textContent=[n.group,n.section].filter(Boolean).join(" / "),c.append(o,a),s.appendChild(c),e.appendChild(s)}}document.querySelectorAll(".docs-search").forEach(t=>{const e=t.dataset.indexUrl,r=t.querySelector(".docs-search-input"),n=t.querySelector(".docs-search-results");r.addEventListener("input",async()=>{const s=r.value.trim().toLowerCase();if(!s){n.hidden=!0,n.innerHTML="";return}const{pages:c}=await d(e);r.value.trim().toLowerCase()===s&&u(c.filter(o=>l(o,s)),n)}),r.addEventListener("focus",()=>{d(e),n.childElementCount>0&&(n.hidden=!1)}),r.addEventListener("keydown",s=>{s.key==="Escape"&&(r.value="",n.hidden=!0,n.innerHTML="",r.blur())}),r.addEventListener("blur",()=>{window.setTimeout(()=>{n.hidden=!0},150)})});document.addEventListener("keydown",t=>{if(!(t.metaKey||t.ctrlKey)||t.key.toLowerCase()!=="k")return;const e=[...document.querySelectorAll(".docs-search-input")].find(r=>r.offsetParent!==null);e&&(t.preventDefault(),e.focus(),e.select())});</script> <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/"> Overview </a><details class="docs-nav-group"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/"> Trust </a><details class="docs-nav-group"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-docs-reference-api/"> @pyric/cli/conformance/docs </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/" aria-current="page"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> </details> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div>  <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/" id="nav-group-overview"> Overview </a><details class="docs-nav-group" id="nav-group-get-started"> <summary>Get started</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/get-started/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/get-started/how-the-swap-works/"> How the swap works </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-build"> <summary>Build</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/build/authentication/"> Authentication </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-firestore/"> Cloud Firestore </a> </li><li> <a href="/__pyric/ui/docs/build/realtime-database/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-storage/"> Cloud Storage </a> </li><li> <a href="/__pyric/ui/docs/build/cloud-messaging/"> Cloud Messaging </a> </li><li> <a href="/__pyric/ui/docs/build/ai-logic/"> AI Logic </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-secure-debug"> <summary>Secure &amp; debug</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/secure/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/secure/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/secure/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/secure/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/secure/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/secure/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/secure/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/secure/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-observe-shape"> <summary>Observe &amp; shape</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/observe/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/observe/shape-your-data/"> Seed, snapshot, replay </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-test"> <summary>Ship &amp; test</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/ship/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-work-with-an-agent"> <summary>Work with an agent</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/agent/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/agent/work-with-an-agent/"> Use the MCP tools </a> </li><li> <a href="/__pyric/ui/docs/agent/watch-and-review/"> Watch in Pyric Studio </a> </li> </ul> </div> </div> </details><a class="docs-nav-toplink" href="/__pyric/ui/docs/trust/versioning-and-compatibility/" id="nav-group-trust"> Trust </a><details class="docs-nav-group" id="nav-group-conformance"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/conformance-scores/"> Public API coverage </a> </li><li> <a href="/__pyric/ui/docs/trust/how-we-know-it-matches-firebase/"> How we know it matches Firebase </a> </li><li> <a href="/__pyric/ui/docs/app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/functions-rtdb-compat/"> Functions · RTDB </a> </li><li> <a href="/__pyric/ui/docs/rules-compat/"> Rules </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" id="nav-group-reference" open> <summary>Reference</summary> <div class="docs-nav-group-body docs-nav-group-body--reference"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/api-reference/"> API reference </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-app-reference-api/"> pyric/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-reference-api/"> pyric/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-reference-api/"> pyric/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-reference-api/"> pyric/ai </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-scripting-reference-api/"> pyric/ai/scripting </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-reference-api/"> pyric/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-reference-api/"> pyric/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-reference-api/"> pyric/messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-sw-reference-api/"> pyric/messaging/sw </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-reference-api/"> pyric/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-values-reference-api/"> pyric/firestore-values </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-reference-api/"> pyric/sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-firestore-reference-api/"> pyric/sandbox/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox-database-reference-api/"> pyric/sandbox/database </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">pyric-admin</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-admin-app-reference-api/"> pyric-admin/app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore-reference-api/"> pyric-admin/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth-reference-api/"> pyric-admin/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database-reference-api/"> pyric-admin/database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage-reference-api/"> pyric-admin/storage </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">create-pyric</h2> <ul> <li> <a href="/__pyric/ui/docs/create-pyric-reference-api/"> create-pyric </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/cli</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-credentials-node-reference-api/"> @pyric/cli/credentials/node </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-verify-reference-api/"> @pyric/cli/verify </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-reference-api/"> @pyric/cli/conformance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-browser-reference-api/"> @pyric/cli/conformance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-conformance-docs-reference-api/"> @pyric/cli/conformance/docs </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-reference-api/"> @pyric/cli/assurance </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-assurance-browser-reference-api/"> @pyric/cli/assurance/browser </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-reference-api/"> @pyric/cli/bridge </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-bridge-client-reference-api/"> @pyric/cli/bridge/client </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-discover-reference-api/"> @pyric/cli/discover </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-vite-reference-api/"> @pyric/cli/vite </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-serve-worker-reference-api/" aria-current="page"> @pyric/cli/serve/worker </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-remote-reference-api/"> @pyric/cli/remote </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-register-reference-api/"> @pyric/cli/register </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading">@pyric/ui</h2> <ul> <li> <a href="/__pyric/ui/docs/pyric-ui-auth-reference-api/"> @pyric/ui/auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-auth-hooks-reference-api/"> @pyric/ui/auth/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-primitives-reference-api/"> @pyric/ui/primitives </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-reference-api/"> @pyric/ui/firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-firestore-hooks-reference-api/"> @pyric/ui/firestore/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rtdb-reference-api/"> @pyric/ui/rtdb </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-reference-api/"> @pyric/ui/storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-storage-hooks-reference-api/"> @pyric/ui/storage/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-reference-api/"> @pyric/ui/traffic </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-traffic-hooks-reference-api/"> @pyric/ui/traffic/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-reference-api/"> @pyric/ui/events </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-events-hooks-reference-api/"> @pyric/ui/events/hooks </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-agents-reference-api/"> @pyric/ui/agents </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-reference-api/"> @pyric/ui/rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-ui-rules-hooks-reference-api/"> @pyric/ui/rules/hooks </a> </li> </ul> </div> </div> </details> </nav> <main class="doc-main"> <nav class="docs-breadcrumbs" aria-label="Breadcrumb"> <ol> <li>  <a href="/__pyric/ui/docs/api-reference/">API reference</a> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span>@pyric/cli</span> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span aria-current="page">@pyric/cli/serve/worker</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/cli/serve/worker</code></h1> <p class="api-reference-meta"> 145 published symbols from <code>@pyric/cli</code> </p> <p class="api-reference-source">
 Generated from the TypeScript declarations shipped at this import path.
-</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Do not edit by hand; run bun run docs:api:generate. -->
+</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Rendered by the api-reference content loader. -->
 <h2 id="interfaces">Interfaces</h2>
 <p><a id="clientauth"></a></p>
 <h3 id="clientauth">ClientAuth</h3>
@@ -523,7 +524,7 @@ that RPC back to the worker. Mirrors <code>firebase/auth</code>’s <code>User</
-<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="operationtype"></a> <code>operationType</code></td><td align="left"><code>"signIn"</code> | <code>"reauthenticate"</code> | <code>"link"</code></td></tr><tr><td align="left"><a id="providerid-1"></a> <code>providerId</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="user"></a> <code>user</code></td><td align="left"><a href="#clientuser"><code>ClientUser</code></a></td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="operationtype"></a> <code>operationType</code></td><td align="left"><code>"signIn"</code> | <code>"link"</code> | <code>"reauthenticate"</code></td></tr><tr><td align="left"><a id="providerid-1"></a> <code>providerId</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="user"></a> <code>user</code></td><td align="left"><a href="#clientuser"><code>ClientUser</code></a></td></tr></tbody></table></div>
 <hr>
 <p><a id="clientwritebatch"></a></p>
 <h3 id="clientwritebatch">ClientWriteBatch</h3>
@@ -1173,7 +1174,7 @@ worker (the worker holds the one real user).</p>
-<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="operationtype-1"></a> <code>operationType</code></td><td align="left"><code>readonly</code></td><td align="left"><code>"signIn"</code> | <code>"reauthenticate"</code> | <code>"link"</code></td></tr><tr><td align="left"><a id="providerid-4"></a> <code>providerId</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="user-1"></a> <code>user</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#serializeduser"><code>SerializedUser</code></a></td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="operationtype-1"></a> <code>operationType</code></td><td align="left"><code>readonly</code></td><td align="left"><code>"signIn"</code> | <code>"link"</code> | <code>"reauthenticate"</code></td></tr><tr><td align="left"><a id="providerid-4"></a> <code>providerId</code></td><td align="left"><code>readonly</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="user-1"></a> <code>user</code></td><td align="left"><code>readonly</code></td><td align="left"><a href="#serializeduser"><code>SerializedUser</code></a></td></tr></tbody></table></div>
 <h2 id="type-aliases">Type Aliases</h2>
 <p><a id="anyhandle"></a></p>
 <h3 id="anyhandle">AnyHandle</h3>
@@ -1426,9 +1427,9 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>request</code></td><td align="left"><code>CreateUserRequest</code></td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>request</code></td><td align="left"><a href="/docs/pyric-auth-reference-api/#createuserrequest"><code>CreateUserRequest</code></a></td></tr></tbody></table></div>
 <h4 id="returns-26">Returns</h4>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>></p>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>></p>
 <hr>
 <p><a id="admindeletedocument"></a></p>
 <h3 id="admindeletedocument">adminDeleteDocument()</h3>
@@ -1953,9 +1954,9 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>uid</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>request</code></td><td align="left"><code>UpdateUserRequest</code></td></tr></tbody></table></div>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>uid</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>request</code></td><td align="left"><a href="/docs/pyric-auth-reference-api/#updateuserrequest"><code>UpdateUserRequest</code></a></td></tr></tbody></table></div>
 <h4 id="returns-38">Returns</h4>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>></p>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>></p>
 <hr>
 <p><a id="and"></a></p>
 <h3 id="and">and()</h3>
@@ -2495,7 +2496,7 @@ subscription. Useful for a late, snapshot-only consumer.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr></tbody></table></div>
 <h4 id="returns-56">Returns</h4>
-<p><code>Promise</code>&#x3C;readonly <code>SandboxEvent</code>[]></p>
+<p><code>Promise</code>&#x3C;readonly <a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>[]></p>
 <hr>
 <p><a id="exportworkerstate"></a></p>
 <h3 id="exportworkerstate">exportWorkerState()</h3>
@@ -2912,10 +2913,10 @@ but returns a <code>ClientDb</code> backed by a <code>MessagePort</code> instead
 <hr>
 <p><a id="getlens"></a></p>
 <h3 id="getlens">getLens()</h3>
-<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> getLens</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> getLens</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">AuthLens</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>The active default lens (read-only view), for Studio UI to reflect state.</p>
 <h4 id="returns-70">Returns</h4>
-<p><code>any</code></p>
+<p><a href="/docs/pyric-sandbox-reference-api/#authlens-2"><code>AuthLens</code></a></p>
 <hr>
 <p><a id="getmetadata"></a></p>
 <h3 id="getmetadata">getMetadata()</h3>
@@ -2937,7 +2938,7 @@ but returns a <code>ClientDb</code> backed by a <code>MessagePort</code> instead
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>reference</code></td><td align="left"><a href="#clientstoragereference"><code>ClientStorageReference</code></a></td></tr></tbody></table></div>
 <h4 id="returns-71">Returns</h4>
-<p><code>Promise</code>&#x3C;<code>FullMetadata</code>></p>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-storage-reference-api/#fullmetadata"><code>FullMetadata</code></a>></p>
 <hr>
 <p><a id="getproviderconfig"></a></p>
 <h3 id="getproviderconfig">getProviderConfig()</h3>
@@ -3043,7 +3044,7 @@ attempting user, on a throwaway branch (no live mutation).</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr></tbody></table></div>
 <h4 id="returns-74">Returns</h4>
-<p><code>Promise</code>&#x3C;<code>SandboxSnapshot</code>></p>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-sandbox-reference-api/#sandboxsnapshot"><code>SandboxSnapshot</code></a>></p>
 <hr>
 <p><a id="getstorage"></a></p>
 <h3 id="getstorage">getStorage()</h3>
@@ -3370,7 +3371,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr></tbody></table></div>
 <h4 id="returns-85">Returns</h4>
-<p><code>Promise</code>&#x3C;<code>AuthUserRecord</code>[]></p>
+<p><code>Promise</code>&#x3C;<a href="/docs/pyric-auth-reference-api/#authuserrecord"><code>AuthUserRecord</code></a>[]></p>
 <hr>
 <p><a id="listworkerbranches"></a></p>
 <h3 id="listworkerbranches">listWorkerBranches()</h3>
@@ -3690,6 +3691,36 @@ history batches aren’t coalescible, so it needs bounded backpressure first
 <h5 id="returns-97">Returns</h5>
 <p><code>void</code></p>
 <hr>
+<p><a id="resetall"></a></p>
+<h3 id="resetall">resetAll()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> resetAll</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientDb</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
+<span class="line"><span style="color:#E06C75">  errors</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">[];</span></span>
+<span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
+<p>Sandbox-owned full reset (issue #359): <code>sandbox.resetAll()</code> on the worker.
+Clears the Firestore env, the signed-in session, and EVERY registered
+persistable service — auth users, the RTDB tree, storage objects. Resolves
+once the worker acks (all services finished clearing). This is the served
+counterpart of calling <code>sandbox.resetAll()</code> on an in-process sandbox.</p>
+<h4 id="parameters-82">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr></tbody></table></div>
+<h4 id="returns-98">Returns</h4>
+<p><code>Promise</code>&#x3C;{
+<code>errors</code>: <code>string</code>[];
+}></p>
+<hr>
 <p><a id="rtdbchild"></a></p>
 <h3 id="rtdbchild">rtdbChild()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> rtdbChild</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">parent</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbRefHandle</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbRefHandle</span><span style="color:#ABB2BF">;</span></span></code></pre>
@@ -3708,7 +3739,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-82">Parameters</h4>
+<h4 id="parameters-83">Parameters</h4>
 <div class="table-scroll">
@@ -3727,7 +3758,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>parent</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-98">Returns</h4>
+<h4 id="returns-99">Returns</h4>
 <p><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></p>
 <hr>
 <p><a id="rtdbconnectdatabaseemulator"></a></p>
@@ -3748,7 +3779,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="returns-99">Returns</h4>
+<h4 id="returns-100">Returns</h4>
 <p><code>void</code></p>
 <hr>
 <p><a id="rtdbget"></a></p>
@@ -3769,7 +3800,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-83">Parameters</h4>
+<h4 id="parameters-84">Parameters</h4>
 <div class="table-scroll">
@@ -3784,7 +3815,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr></tbody></table></div>
-<h4 id="returns-100">Returns</h4>
+<h4 id="returns-101">Returns</h4>
 <p><code>Promise</code>&#x3C;<a href="#rtdbdatasnapshot"><code>RtdbDataSnapshot</code></a>></p>
 <hr>
 <p><a id="rtdbgetdatabase"></a></p>
@@ -3805,7 +3836,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-84">Parameters</h4>
+<h4 id="parameters-85">Parameters</h4>
 <div class="table-scroll">
@@ -3824,7 +3855,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>source?</code></td><td align="left"><code>string</code> | <a href="#clientdb"><code>ClientDb</code></a> | <code>URL</code></td></tr><tr><td align="left"><code>name?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-101">Returns</h4>
+<h4 id="returns-102">Returns</h4>
 <p><a href="#clientrtdb"><code>ClientRtdb</code></a></p>
 <hr>
 <p><a id="rtdboff"></a></p>
@@ -3848,7 +3879,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-85">Parameters</h4>
+<h4 id="parameters-86">Parameters</h4>
 <div class="table-scroll">
@@ -3871,7 +3902,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>_r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>_eventType?</code></td><td align="left"><code>unknown</code></td></tr><tr><td align="left"><code>_callback?</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h4 id="returns-102">Returns</h4>
+<h4 id="returns-103">Returns</h4>
 <p><code>void</code></p>
 <hr>
 <p><a id="rtdbonvalue"></a></p>
@@ -3895,7 +3926,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-86">Parameters</h4>
+<h4 id="parameters-87">Parameters</h4>
 <div class="table-scroll">
@@ -3918,7 +3949,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>next</code></td><td align="left">(<code>snap</code>: <a href="#rtdbdatasnapshot"><code>RtdbDataSnapshot</code></a>) => <code>void</code></td></tr><tr><td align="left"><code>error?</code></td><td align="left">(<code>err</code>: <code>unknown</code>) => <code>void</code></td></tr></tbody></table></div>
-<h4 id="returns-103">Returns</h4>
+<h4 id="returns-104">Returns</h4>
 <p><a href="#unsubscribe"><code>Unsubscribe</code></a></p>
 <hr>
 <p><a id="rtdbpush"></a></p>
@@ -3939,7 +3970,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-87">Parameters</h4>
+<h4 id="parameters-88">Parameters</h4>
 <div class="table-scroll">
@@ -3958,7 +3989,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>value?</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h4 id="returns-104">Returns</h4>
+<h4 id="returns-105">Returns</h4>
 <p><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a> &#x26; <code>PromiseLike</code>&#x3C;<a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a>></p>
 <hr>
 <p><a id="rtdbref"></a></p>
@@ -3979,7 +4010,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-88">Parameters</h4>
+<h4 id="parameters-89">Parameters</h4>
 <div class="table-scroll">
@@ -3998,7 +4029,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientrtdb"><code>ClientRtdb</code></a></td></tr><tr><td align="left"><code>path?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-105">Returns</h4>
+<h4 id="returns-106">Returns</h4>
 <p><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></p>
 <hr>
 <p><a id="rtdbremove"></a></p>
@@ -4019,7 +4050,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-89">Parameters</h4>
+<h4 id="parameters-90">Parameters</h4>
 <div class="table-scroll">
@@ -4034,7 +4065,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr></tbody></table></div>
-<h4 id="returns-106">Returns</h4>
+<h4 id="returns-107">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="rtdbservertimestamp"></a></p>
@@ -4056,7 +4087,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="returns-107">Returns</h4>
+<h4 id="returns-108">Returns</h4>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
 <span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
 <hr>
@@ -4078,7 +4109,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-90">Parameters</h4>
+<h4 id="parameters-91">Parameters</h4>
 <div class="table-scroll">
@@ -4097,7 +4128,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h4 id="returns-108">Returns</h4>
+<h4 id="returns-109">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="rtdbupdate"></a></p>
@@ -4118,7 +4149,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-91">Parameters</h4>
+<h4 id="parameters-92">Parameters</h4>
 <div class="table-scroll">
@@ -4137,7 +4168,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>r</code></td><td align="left"><a href="#rtdbrefhandle"><code>RtdbRefHandle</code></a></td></tr><tr><td align="left"><code>values</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
-<h4 id="returns-109">Returns</h4>
+<h4 id="returns-110">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="runtransaction"></a></p>
@@ -4177,7 +4208,7 @@ on conflict rather than surfacing the error immediately.</p>
 <table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>R</code></td></tr></tbody></table></div>
-<h4 id="parameters-92">Parameters</h4>
+<h4 id="parameters-93">Parameters</h4>
 <div class="table-scroll">
@@ -4196,14 +4227,14 @@ on conflict rather than surfacing the error immediately.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>updateFn</code></td><td align="left">(<code>txn</code>: <a href="#clienttransaction"><code>ClientTransaction</code></a>) => <code>R</code> | <code>Promise</code>&#x3C;<code>R</code>></td></tr></tbody></table></div>
-<h4 id="returns-110">Returns</h4>
+<h4 id="returns-111">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>R</code>></p>
 <hr>
 <p><a id="saveworkerbranch"></a></p>
 <h3 id="saveworkerbranch">saveWorkerBranch()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> saveWorkerBranch</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientDb</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">name</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">>;</span></span></code></pre>
 <p>Phase 3: save the live sandbox as a named branch (a saved state bundle).</p>
-<h4 id="parameters-93">Parameters</h4>
+<h4 id="parameters-94">Parameters</h4>
 <div class="table-scroll">
@@ -4222,7 +4253,7 @@ on conflict rather than surfacing the error immediately.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>name</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-111">Returns</h4>
+<h4 id="returns-112">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="servertimestamp"></a></p>
@@ -4243,7 +4274,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="returns-112">Returns</h4>
+<h4 id="returns-113">Returns</h4>
 <p><code>SentinelMarker</code></p>
 <hr>
 <p><a id="setdatabaserules"></a></p>
@@ -4267,7 +4298,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-94">Parameters</h4>
+<h4 id="parameters-95">Parameters</h4>
 <div class="table-scroll">
@@ -4286,7 +4317,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a> | <a href="#clientrtdb"><code>ClientRtdb</code></a></td></tr><tr><td align="left"><code>source</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h4 id="returns-113">Returns</h4>
+<h4 id="returns-114">Returns</h4>
 <p><code>Promise</code>&#x3C;{
 <code>messages</code>: <code>unknown</code>[];
 <code>ok</code>: <code>boolean</code>;
@@ -4316,7 +4347,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-95">Parameters</h4>
+<h4 id="parameters-96">Parameters</h4>
 <div class="table-scroll">
@@ -4347,7 +4378,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>ref</code></td><td align="left"><a href="#docrefhandle"><code>DocRefHandle</code></a></td></tr><tr><td align="left"><code>data</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr><tr><td align="left"><code>options?</code></td><td align="left">{ <code>merge?</code>: <code>boolean</code>; <code>mergeFields?</code>: <code>string</code>[]; }</td></tr><tr><td align="left"><code>options.merge?</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><code>options.mergeFields?</code></td><td align="left"><code>string</code>[]</td></tr></tbody></table></div>
-<h4 id="returns-114">Returns</h4>
+<h4 id="returns-115">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="setfirestorerules"></a></p>
@@ -4372,7 +4403,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-96">Parameters</h4>
+<h4 id="parameters-97">Parameters</h4>
 <div class="table-scroll">
@@ -4391,7 +4422,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>source</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-115">Returns</h4>
+<h4 id="returns-116">Returns</h4>
 <p><code>Promise</code>&#x3C;{
 <code>messages</code>: <code>unknown</code>[];
 <code>ok</code>: <code>boolean</code>;
@@ -4400,7 +4431,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <hr>
 <p><a id="setlens"></a></p>
 <h3 id="setlens">setLens()</h3>
-<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> setLens</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">lens</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> setLens</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">lens</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthLens</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Set the default auth lens applied to subsequent Firestore DATA ops from this
 client (Pyric Studio). Pass <code>{ mode: 'as', uid }</code> to read/write AS a user
 (rules apply), <code>{ mode: 'admin' }</code> for the admin lens, or
@@ -4408,7 +4439,7 @@ client (Pyric Studio). Pass <code>{ mode: 'as', uid }</code> to read/write AS a
 <p>The lens is process-wide for this client module (one served page = one
 worker port), mirroring how Studio drives a single active identity at a time.
 Auth ops are unaffected — they always operate the real session.</p>
-<h4 id="parameters-97">Parameters</h4>
+<h4 id="parameters-98">Parameters</h4>
 <div class="table-scroll">
@@ -4422,15 +4453,15 @@ Auth ops are unaffected — they always operate the real session.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>lens</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
-<h4 id="returns-116">Returns</h4>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>lens</code></td><td align="left"><a href="/docs/pyric-sandbox-reference-api/#authlens-2"><code>AuthLens</code></a></td></tr></tbody></table></div>
+<h4 id="returns-117">Returns</h4>
 <p><code>void</code></p>
 <hr>
 <p><a id="setopissuer"></a></p>
 <h3 id="setopissuer">setOpIssuer()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> setOpIssuer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">source</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"studio"</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Declare who issues the ops this client module constructs. See _opIssuer.</p>
-<h4 id="parameters-98">Parameters</h4>
+<h4 id="parameters-99">Parameters</h4>
 <div class="table-scroll">
@@ -4445,7 +4476,7 @@ Auth ops are unaffected — they always operate the real session.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>source</code></td><td align="left"><code>"studio"</code></td></tr></tbody></table></div>
-<h4 id="returns-117">Returns</h4>
+<h4 id="returns-118">Returns</h4>
 <p><code>void</code></p>
 <hr>
 <p><a id="setpersistence"></a></p>
@@ -4455,7 +4486,7 @@ Auth ops are unaffected — they always operate the real session.</p>
 effective persistence is CLIENT-side (#754): the entry adapter mirrors the
 mode into the page’s SessionStore, which decides where — or whether — this
 tab’s session uid is stored for reload restore.</p>
-<h4 id="parameters-99">Parameters</h4>
+<h4 id="parameters-100">Parameters</h4>
 <div class="table-scroll">
@@ -4474,7 +4505,7 @@ tab’s session uid is stored for reload restore.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>persistence</code></td><td align="left"><code>ClientPersistence</code></td></tr></tbody></table></div>
-<h4 id="returns-118">Returns</h4>
+<h4 id="returns-119">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="setproviderconfig"></a></p>
@@ -4498,7 +4529,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-100">Parameters</h4>
+<h4 id="parameters-101">Parameters</h4>
 <div class="table-scroll">
@@ -4521,7 +4552,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>providerId</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>enabled</code></td><td align="left"><code>boolean</code></td></tr></tbody></table></div>
-<h4 id="returns-119">Returns</h4>
+<h4 id="returns-120">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="setrules"></a></p>
@@ -4532,7 +4563,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Deploy new rules to the worker’s sandbox. Active onSnapshot listeners
 that were allowed by the old rules may start receiving error callbacks
 if the new rules deny them.</p>
-<h4 id="parameters-101">Parameters</h4>
+<h4 id="parameters-102">Parameters</h4>
 <div class="table-scroll">
@@ -4551,7 +4582,7 @@ if the new rules deny them.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>source</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-120">Returns</h4>
+<h4 id="returns-121">Returns</h4>
 <p><code>Promise</code>&#x3C;{
 <code>warnings</code>: <code>unknown</code>[];
 }></p>
@@ -4574,7 +4605,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-102">Parameters</h4>
+<h4 id="parameters-103">Parameters</h4>
 <div class="table-scroll">
@@ -4589,7 +4620,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr></tbody></table></div>
-<h4 id="returns-121">Returns</h4>
+<h4 id="returns-122">Returns</h4>
 <p><code>Promise</code>&#x3C;<a href="#clientusercredential"><code>ClientUserCredential</code></a>></p>
 <hr>
 <p><a id="signinwithemailandpassword"></a></p>
@@ -4613,7 +4644,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-103">Parameters</h4>
+<h4 id="parameters-104">Parameters</h4>
 <div class="table-scroll">
@@ -4636,7 +4667,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr><tr><td align="left"><code>email</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>password</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-122">Returns</h4>
+<h4 id="returns-123">Returns</h4>
 <p><code>Promise</code>&#x3C;<a href="#clientusercredential"><code>ClientUserCredential</code></a>></p>
 <hr>
 <p><a id="signout"></a></p>
@@ -4657,7 +4688,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-104">Parameters</h4>
+<h4 id="parameters-105">Parameters</h4>
 <div class="table-scroll">
@@ -4672,7 +4703,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>auth</code></td><td align="left"><a href="#clientauth"><code>ClientAuth</code></a></td></tr></tbody></table></div>
-<h4 id="returns-123">Returns</h4>
+<h4 id="returns-124">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="startafter"></a></p>
@@ -4693,7 +4724,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-105">Parameters</h4>
+<h4 id="parameters-106">Parameters</h4>
 <div class="table-scroll">
@@ -4708,7 +4739,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left">…<code>values</code></td><td align="left"><code>unknown</code>[]</td></tr></tbody></table></div>
-<h4 id="returns-124">Returns</h4>
+<h4 id="returns-125">Returns</h4>
 <p><code>QueryConstraintHandle</code></p>
 <hr>
 <p><a id="startat"></a></p>
@@ -4729,7 +4760,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-106">Parameters</h4>
+<h4 id="parameters-107">Parameters</h4>
 <div class="table-scroll">
@@ -4744,7 +4775,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left">…<code>values</code></td><td align="left"><code>unknown</code>[]</td></tr></tbody></table></div>
-<h4 id="returns-125">Returns</h4>
+<h4 id="returns-126">Returns</h4>
 <p><code>QueryConstraintHandle</code></p>
 <hr>
 <p><a id="startpresence"></a></p>
@@ -4752,7 +4783,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> startPresence</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">opts</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">StartPresenceOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">PresenceSession</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Register this page with the worker and keep the lease alive until
 <a href="#stop">PresenceSession.stop</a> or <code>pagehide</code>.</p>
-<h4 id="parameters-107">Parameters</h4>
+<h4 id="parameters-108">Parameters</h4>
 <div class="table-scroll">
@@ -4767,7 +4798,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>opts</code></td><td align="left"><code>StartPresenceOptions</code></td></tr></tbody></table></div>
-<h4 id="returns-126">Returns</h4>
+<h4 id="returns-127">Returns</h4>
 <p><a href="#presencesession"><code>PresenceSession</code></a></p>
 <hr>
 <p><a id="subscribeevents"></a></p>
@@ -4780,7 +4811,7 @@ event. Returns an unsubscribe that deregisters on the worker.</p>
 <p>This is the live counterpart to <code>sandbox.onEvent</code> + an initial <code>history()</code>
 fold, collapsed into one subscription so a late subscriber never misses the
 backlog.</p>
-<h4 id="parameters-108">Parameters</h4>
+<h4 id="parameters-109">Parameters</h4>
 <div class="table-scroll">
@@ -4798,8 +4829,8 @@ backlog.</p>
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>callback</code></td><td align="left">(<code>events</code>: readonly <code>SandboxEvent</code>[]) => <code>void</code></td></tr></tbody></table></div>
-<h4 id="returns-127">Returns</h4>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>callback</code></td><td align="left">(<code>events</code>: readonly <a href="/docs/pyric-sandbox-reference-api/#sandboxevent"><code>SandboxEvent</code></a>[]) => <code>void</code></td></tr></tbody></table></div>
+<h4 id="returns-128">Returns</h4>
 <p><a href="#unsubscribe"><code>Unsubscribe</code></a></p>
 <hr>
 <p><a id="subscribepresence"></a></p>
@@ -4807,7 +4838,7 @@ backlog.</p>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> subscribePresence</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientDb</span><span style="color:#ABB2BF">, </span><span style="color:#61AFEF">callback</span><span style="color:#ABB2BF">: (</span><span style="color:#E06C75;font-style:italic">snapshot</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PresenceSnapshot</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> void</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Unsubscribe</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Subscribe to the worker’s authoritative presence snapshot. The callback
 fires immediately with the current snapshot, then on every change.</p>
-<h4 id="parameters-109">Parameters</h4>
+<h4 id="parameters-110">Parameters</h4>
 <div class="table-scroll">
@@ -4826,14 +4857,14 @@ fires immediately with the current snapshot, then on every change.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>callback</code></td><td align="left">(<code>snapshot</code>: <a href="#presencesnapshot"><code>PresenceSnapshot</code></a>) => <code>void</code></td></tr></tbody></table></div>
-<h4 id="returns-128">Returns</h4>
+<h4 id="returns-129">Returns</h4>
 <p><a href="#unsubscribe"><code>Unsubscribe</code></a></p>
 <hr>
 <p><a id="sum"></a></p>
 <h3 id="sum">sum()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> sum</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">field</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">AggregateFieldDescriptor</span><span style="color:#ABB2BF">;</span></span></code></pre>
 <p>Factory: sum-of-<code>field</code> aggregate. Mirrors <code>pyric/firestore</code>’s <code>sum()</code>.</p>
-<h4 id="parameters-110">Parameters</h4>
+<h4 id="parameters-111">Parameters</h4>
 <div class="table-scroll">
@@ -4848,14 +4879,14 @@ fires immediately with the current snapshot, then on every change.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>field</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-129">Returns</h4>
+<h4 id="returns-130">Returns</h4>
 <p><code>AggregateFieldDescriptor</code></p>
 <hr>
 <p><a id="switchworkerbranch"></a></p>
 <h3 id="switchworkerbranch">switchWorkerBranch()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> switchWorkerBranch</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">db</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientDb</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">name</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">void</span><span style="color:#ABB2BF">>;</span></span></code></pre>
 <p>Phase 3 (clobber): switch the live sandbox to a named branch’s state.</p>
-<h4 id="parameters-111">Parameters</h4>
+<h4 id="parameters-112">Parameters</h4>
 <div class="table-scroll">
@@ -4874,7 +4905,7 @@ fires immediately with the current snapshot, then on every change.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr><tr><td align="left"><code>name</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
-<h4 id="returns-130">Returns</h4>
+<h4 id="returns-131">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="updatedoc"></a></p>
@@ -4895,7 +4926,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-112">Parameters</h4>
+<h4 id="parameters-113">Parameters</h4>
 <div class="table-scroll">
@@ -4914,21 +4945,21 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>ref</code></td><td align="left"><a href="#docrefhandle"><code>DocRefHandle</code></a></td></tr><tr><td align="left"><code>data</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
-<h4 id="returns-131">Returns</h4>
+<h4 id="returns-132">Returns</h4>
 <p><code>Promise</code>&#x3C;<code>void</code>></p>
 <hr>
 <p><a id="uploadbytes"></a></p>
 <h3 id="uploadbytes">uploadBytes()</h3>
 <pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> uploadBytes</span><span style="color:#ABB2BF">(</span></span>
 <span class="line"><span style="color:#E06C75;font-style:italic">   reference</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientStorageReference</span><span style="color:#ABB2BF">,</span></span>
-<span class="line"><span style="color:#E06C75;font-style:italic">   data</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Blob</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">ArrayBuffer</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">Uint8Array</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">ArrayBufferLike</span><span style="color:#ABB2BF">>,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   data</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ArrayBuffer</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">Uint8Array</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">ArrayBufferLike</span><span style="color:#ABB2BF">> | </span><span style="color:#E5C07B">Blob</span><span style="color:#ABB2BF">,</span></span>
 <span class="line"><span style="color:#E06C75;font-style:italic">   metadata</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientSettableMetadata</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#ABB2BF">&#x3C;{</span></span>
 <span class="line"><span style="color:#E06C75">  metadata</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FullMetadata</span><span style="color:#ABB2BF">;</span></span>
 <span class="line"><span style="color:#E06C75">  ref</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClientStorageReference</span><span style="color:#ABB2BF">;</span></span>
 <span class="line"><span style="color:#ABB2BF">}>;</span></span></code></pre>
 <p>Upload bytes at the reference’s path (replaces existing content).
 Mirrors <code>pyric/storage</code>’s <code>uploadBytes</code> result shape.</p>
-<h4 id="parameters-113">Parameters</h4>
+<h4 id="parameters-114">Parameters</h4>
 <div class="table-scroll">
@@ -4950,10 +4981,10 @@ Mirrors <code>pyric/storage</code>’s <code>uploadBytes</code> result shape.</p
-<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>reference</code></td><td align="left"><a href="#clientstoragereference"><code>ClientStorageReference</code></a></td></tr><tr><td align="left"><code>data</code></td><td align="left"><code>Blob</code> | <code>ArrayBuffer</code> | <code>Uint8Array</code>&#x3C;<code>ArrayBufferLike</code>></td></tr><tr><td align="left"><code>metadata?</code></td><td align="left"><a href="#clientsettablemetadata"><code>ClientSettableMetadata</code></a></td></tr></tbody></table></div>
-<h4 id="returns-132">Returns</h4>
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>reference</code></td><td align="left"><a href="#clientstoragereference"><code>ClientStorageReference</code></a></td></tr><tr><td align="left"><code>data</code></td><td align="left"><code>ArrayBuffer</code> | <code>Uint8Array</code>&#x3C;<code>ArrayBufferLike</code>> | <code>Blob</code></td></tr><tr><td align="left"><code>metadata?</code></td><td align="left"><a href="#clientsettablemetadata"><code>ClientSettableMetadata</code></a></td></tr></tbody></table></div>
+<h4 id="returns-133">Returns</h4>
 <p><code>Promise</code>&#x3C;{
-<code>metadata</code>: <code>FullMetadata</code>;
+<code>metadata</code>: <a href="/docs/pyric-storage-reference-api/#fullmetadata"><code>FullMetadata</code></a>;
 <code>ref</code>: <a href="#clientstoragereference"><code>ClientStorageReference</code></a>;
 }></p>
 <hr>
@@ -4978,7 +5009,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-114">Parameters</h4>
+<h4 id="parameters-115">Parameters</h4>
 <div class="table-scroll">
@@ -5001,7 +5032,7 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>field</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>op</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
-<h4 id="returns-133">Returns</h4>
+<h4 id="returns-134">Returns</h4>
 <p><code>QueryConstraintHandle</code></p>
 <hr>
 <p><a id="writebatch"></a></p>
@@ -5022,7 +5053,7 @@ and type-only <code>pyric/sandbox</code> (erased at build), so this entry stays
 the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <p>Exposed by <code>@pyric/cli</code>’s <code>./serve/worker</code> package export so Studio can
 <code>import { getFirestore, subscribeEvents, setLens } from '@pyric/cli/serve/worker'</code> and reach the live SharedWorker backend.</p>
-<h4 id="parameters-115">Parameters</h4>
+<h4 id="parameters-116">Parameters</h4>
 <div class="table-scroll">
@@ -5037,5 +5068,5 @@ the ~10 MB rules/sandbox engine — safe to import from any browser app.</p>
 <table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>db</code></td><td align="left"><a href="#clientdb"><code>ClientDb</code></a></td></tr></tbody></table></div>
-<h4 id="returns-134">Returns</h4>
-<p><a href="#clientwritebatch"><code>ClientWriteBatch</code></a></p>  </article> </main> <aside class="doc-toc api-symbols" aria-label="API symbols"> <h2 class="doc-toc-heading">Symbols</h2> <input class="api-symbol-filter" type="search" placeholder="Filter symbols" aria-label="Filter API symbols" data-api-symbol-filter> <div class="api-symbol-groups" data-api-symbol-groups> <section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="clientauth"> <a href="#clientauth">ClientAuth</a> </li><li data-api-symbol="clientdb"> <a href="#clientdb">ClientDb</a> </li><li data-api-symbol="clientdocsnapshot"> <a href="#clientdocsnapshot">ClientDocSnapshot</a> </li><li data-api-symbol="clientfirebasestorage"> <a href="#clientfirebasestorage">ClientFirebaseStorage</a> </li><li data-api-symbol="clientquerysnapshot"> <a href="#clientquerysnapshot">ClientQuerySnapshot</a> </li><li data-api-symbol="clientrtdb"> <a href="#clientrtdb">ClientRtdb</a> </li><li data-api-symbol="clientsettablemetadata"> <a href="#clientsettablemetadata">ClientSettableMetadata</a> </li><li data-api-symbol="clientstoragereference"> <a href="#clientstoragereference">ClientStorageReference</a> </li><li data-api-symbol="clienttransaction"> <a href="#clienttransaction">ClientTransaction</a> </li><li data-api-symbol="clientuser"> <a href="#clientuser">ClientUser</a> </li><li data-api-symbol="clientusercredential"> <a href="#clientusercredential">ClientUserCredential</a> </li><li data-api-symbol="clientwritebatch"> <a href="#clientwritebatch">ClientWriteBatch</a> </li><li data-api-symbol="collrefhandle"> <a href="#collrefhandle">CollRefHandle</a> </li><li data-api-symbol="docrefhandle"> <a href="#docrefhandle">DocRefHandle</a> </li><li data-api-symbol="presencesession"> <a href="#presencesession">PresenceSession</a> </li><li data-api-symbol="presencesnapshot"> <a href="#presencesnapshot">PresenceSnapshot</a> </li><li data-api-symbol="queryhandle"> <a href="#queryhandle">QueryHandle</a> </li><li data-api-symbol="resolvedidentity"> <a href="#resolvedidentity">ResolvedIdentity</a> </li><li data-api-symbol="rtdbdatasnapshot"> <a href="#rtdbdatasnapshot">RtdbDataSnapshot</a> </li><li data-api-symbol="rtdbrefhandle"> <a href="#rtdbrefhandle">RtdbRefHandle</a> </li><li data-api-symbol="serializedidtokenresult"> <a href="#serializedidtokenresult">SerializedIdTokenResult</a> </li><li data-api-symbol="serializeduser"> <a href="#serializeduser">SerializedUser</a> </li><li data-api-symbol="serializedusercredential"> <a href="#serializedusercredential">SerializedUserCredential</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#type-aliases"> Type Aliases </a> <ul> <li data-api-symbol="anyhandle"> <a href="#anyhandle">AnyHandle</a> </li><li data-api-symbol="authpersistencemode"> <a href="#authpersistencemode">AuthPersistenceMode</a> </li><li data-api-symbol="presenceclientkind"> <a href="#presenceclientkind">PresenceClientKind</a> </li><li data-api-symbol="presencevisibility"> <a href="#presencevisibility">PresenceVisibility</a> </li><li data-api-symbol="unsubscribe()"> <a href="#unsubscribe">Unsubscribe()</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#variables"> Variables </a> <ul> <li data-api-symbol="browserlocalpersistence"> <a href="#browserlocalpersistence">browserLocalPersistence</a> </li><li data-api-symbol="browsersessionpersistence"> <a href="#browsersessionpersistence">browserSessionPersistence</a> </li><li data-api-symbol="inmemorypersistence"> <a href="#inmemorypersistence">inMemoryPersistence</a> </li><li data-api-symbol="presence_heartbeat_interval_ms"> <a href="#presence_heartbeat_interval_ms">PRESENCE_HEARTBEAT_INTERVAL_MS</a> </li><li data-api-symbol="presence_stale_ms"> <a href="#presence_stale_ms">PRESENCE_STALE_MS</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#functions"> Functions </a> <ul> <li data-api-symbol="acceptprovidercredential()"> <a href="#acceptprovidercredential">acceptProviderCredential()</a> </li><li data-api-symbol="adddoc()"> <a href="#adddoc">addDoc()</a> </li><li data-api-symbol="adminclearusers()"> <a href="#adminclearusers">adminClearUsers()</a> </li><li data-api-symbol="admincreateuser()"> <a href="#admincreateuser">adminCreateUser()</a> </li><li data-api-symbol="admindeletedocument()"> <a href="#admindeletedocument">adminDeleteDocument()</a> </li><li data-api-symbol="admindeletertdbvalue()"> <a href="#admindeletertdbvalue">adminDeleteRtdbValue()</a> </li><li data-api-symbol="admindeleteuser()"> <a href="#admindeleteuser">adminDeleteUser()</a> </li><li data-api-symbol="admingetdocument()"> <a href="#admingetdocument">adminGetDocument()</a> </li><li data-api-symbol="adminlistdocuments()"> <a href="#adminlistdocuments">adminListDocuments()</a> </li><li data-api-symbol="adminreadrtdbstate()"> <a href="#adminreadrtdbstate">adminReadRtdbState()</a> </li><li data-api-symbol="adminreadstate()"> <a href="#adminreadstate">adminReadState()</a> </li><li data-api-symbol="adminsetdocument()"> <a href="#adminsetdocument">adminSetDocument()</a> </li><li data-api-symbol="adminsetrtdbvalue()"> <a href="#adminsetrtdbvalue">adminSetRtdbValue()</a> </li><li data-api-symbol="adminsubscribertdbvalue()"> <a href="#adminsubscribertdbvalue">adminSubscribeRtdbValue()</a> </li><li data-api-symbol="adminupdatertdbvalue()"> <a href="#adminupdatertdbvalue">adminUpdateRtdbValue()</a> </li><li data-api-symbol="adminupdateuser()"> <a href="#adminupdateuser">adminUpdateUser()</a> </li><li data-api-symbol="and()"> <a href="#and">and()</a> </li><li data-api-symbol="arrayremove()"> <a href="#arrayremove">arrayRemove()</a> </li><li data-api-symbol="arrayunion()"> <a href="#arrayunion">arrayUnion()</a> </li><li data-api-symbol="average()"> <a href="#average">average()</a> </li><li data-api-symbol="calltool()"> <a href="#calltool">callTool()</a> </li><li data-api-symbol="collection()"> <a href="#collection">collection()</a> </li><li data-api-symbol="collectiongroup()"> <a href="#collectiongroup">collectionGroup()</a> </li><li data-api-symbol="connectauthemulator()"> <a href="#connectauthemulator">connectAuthEmulator()</a> </li><li data-api-symbol="count()"> <a href="#count">count()</a> </li><li data-api-symbol="createuserwithemailandpassword()"> <a href="#createuserwithemailandpassword">createUserWithEmailAndPassword()</a> </li><li data-api-symbol="deletedoc()"> <a href="#deletedoc">deleteDoc()</a> </li><li data-api-symbol="deletefield()"> <a href="#deletefield">deleteField()</a> </li><li data-api-symbol="deleteobject()"> <a href="#deleteobject">deleteObject()</a> </li><li data-api-symbol="deleteworkerbranch()"> <a href="#deleteworkerbranch">deleteWorkerBranch()</a> </li><li data-api-symbol="doc()"> <a href="#doc">doc()</a> </li><li data-api-symbol="endat()"> <a href="#endat">endAt()</a> </li><li data-api-symbol="endbefore()"> <a href="#endbefore">endBefore()</a> </li><li data-api-symbol="eventhistory()"> <a href="#eventhistory">eventHistory()</a> </li><li data-api-symbol="exportworkerstate()"> <a href="#exportworkerstate">exportWorkerState()</a> </li><li data-api-symbol="getactiverules()"> <a href="#getactiverules">getActiveRules()</a> </li><li data-api-symbol="getaggregatefromserver()"> <a href="#getaggregatefromserver">getAggregateFromServer()</a> </li><li data-api-symbol="getauth()"> <a href="#getauth">getAuth()</a> </li><li data-api-symbol="getblob()"> <a href="#getblob">getBlob()</a> </li><li data-api-symbol="getbytes()"> <a href="#getbytes">getBytes()</a> </li><li data-api-symbol="getcountfromserver()"> <a href="#getcountfromserver">getCountFromServer()</a> </li><li data-api-symbol="getdoc()"> <a href="#getdoc">getDoc()</a> </li><li data-api-symbol="getdocs()"> <a href="#getdocs">getDocs()</a> </li><li data-api-symbol="getdownloadurl()"> <a href="#getdownloadurl">getDownloadURL()</a> </li><li data-api-symbol="getfirestore()"> <a href="#getfirestore">getFirestore()</a> </li><li data-api-symbol="getidtoken()"> <a href="#getidtoken-1">getIdToken()</a> </li><li data-api-symbol="getidtokenresult()"> <a href="#getidtokenresult-1">getIdTokenResult()</a> </li><li data-api-symbol="getlens()"> <a href="#getlens">getLens()</a> </li><li data-api-symbol="getmetadata()"> <a href="#getmetadata">getMetadata()</a> </li><li data-api-symbol="getproviderconfig()"> <a href="#getproviderconfig">getProviderConfig()</a> </li><li data-api-symbol="getrulesstatus()"> <a href="#getrulesstatus">getRulesStatus()</a> </li><li data-api-symbol="getsnapshot()"> <a href="#getsnapshot">getSnapshot()</a> </li><li data-api-symbol="getstorage()"> <a href="#getstorage">getStorage()</a> </li><li data-api-symbol="getworkerinstanceid()"> <a href="#getworkerinstanceid">getWorkerInstanceId()</a> </li><li data-api-symbol="getworkerversion()"> <a href="#getworkerversion">getWorkerVersion()</a> </li><li data-api-symbol="importworkerstate()"> <a href="#importworkerstate">importWorkerState()</a> </li><li data-api-symbol="increment()"> <a href="#increment">increment()</a> </li><li data-api-symbol="limit()"> <a href="#limit">limit()</a> </li><li data-api-symbol="limittolast()"> <a href="#limittolast">limitToLast()</a> </li><li data-api-symbol="listall()"> <a href="#listall">listAll()</a> </li><li data-api-symbol="listrootcollections()"> <a href="#listrootcollections">listRootCollections()</a> </li><li data-api-symbol="listsubcollections()"> <a href="#listsubcollections">listSubcollections()</a> </li><li data-api-symbol="listusers()"> <a href="#listusers">listUsers()</a> </li><li data-api-symbol="listworkerbranches()"> <a href="#listworkerbranches">listWorkerBranches()</a> </li><li data-api-symbol="mintpresenceclientid()"> <a href="#mintpresenceclientid">mintPresenceClientId()</a> </li><li data-api-symbol="onauthstatechanged()"> <a href="#onauthstatechanged">onAuthStateChanged()</a> </li><li data-api-symbol="onidtokenchanged()"> <a href="#onidtokenchanged">onIdTokenChanged()</a> </li><li data-api-symbol="onsnapshot()"> <a href="#onsnapshot">onSnapshot()</a> </li><li data-api-symbol="or()"> <a href="#or">or()</a> </li><li data-api-symbol="orderby()"> <a href="#orderby">orderBy()</a> </li><li data-api-symbol="query()"> <a href="#query">query()</a> </li><li data-api-symbol="ref()"> <a href="#ref">ref()</a> </li><li data-api-symbol="relayworkerop()"> <a href="#relayworkerop">relayWorkerOp()</a> </li><li data-api-symbol="relayworkersub()"> <a href="#relayworkersub">relayWorkerSub()</a> </li><li data-api-symbol="rtdbchild()"> <a href="#rtdbchild">rtdbChild()</a> </li><li data-api-symbol="rtdbconnectdatabaseemulator()"> <a href="#rtdbconnectdatabaseemulator">rtdbConnectDatabaseEmulator()</a> </li><li data-api-symbol="rtdbget()"> <a href="#rtdbget">rtdbGet()</a> </li><li data-api-symbol="rtdbgetdatabase()"> <a href="#rtdbgetdatabase">rtdbGetDatabase()</a> </li><li data-api-symbol="rtdboff()"> <a href="#rtdboff">rtdbOff()</a> </li><li data-api-symbol="rtdbonvalue()"> <a href="#rtdbonvalue">rtdbOnValue()</a> </li><li data-api-symbol="rtdbpush()"> <a href="#rtdbpush">rtdbPush()</a> </li><li data-api-symbol="rtdbref()"> <a href="#rtdbref">rtdbRef()</a> </li><li data-api-symbol="rtdbremove()"> <a href="#rtdbremove">rtdbRemove()</a> </li><li data-api-symbol="rtdbservertimestamp()"> <a href="#rtdbservertimestamp">rtdbServerTimestamp()</a> </li><li data-api-symbol="rtdbset()"> <a href="#rtdbset">rtdbSet()</a> </li><li data-api-symbol="rtdbupdate()"> <a href="#rtdbupdate">rtdbUpdate()</a> </li><li data-api-symbol="runtransaction()"> <a href="#runtransaction">runTransaction()</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#multi-tab-correctness--read-set-validation--retry"> MULTI-TAB CORRECTNESS — READ-SET VALIDATION + RETRY </a> <ul> <li data-api-symbol="saveworkerbranch()"> <a href="#saveworkerbranch">saveWorkerBranch()</a> </li><li data-api-symbol="servertimestamp()"> <a href="#servertimestamp">serverTimestamp()</a> </li><li data-api-symbol="setdatabaserules()"> <a href="#setdatabaserules">setDatabaseRules()</a> </li><li data-api-symbol="setdoc()"> <a href="#setdoc">setDoc()</a> </li><li data-api-symbol="setfirestorerules()"> <a href="#setfirestorerules">setFirestoreRules()</a> </li><li data-api-symbol="setlens()"> <a href="#setlens">setLens()</a> </li><li data-api-symbol="setopissuer()"> <a href="#setopissuer">setOpIssuer()</a> </li><li data-api-symbol="setpersistence()"> <a href="#setpersistence">setPersistence()</a> </li><li data-api-symbol="setproviderconfig()"> <a href="#setproviderconfig">setProviderConfig()</a> </li><li data-api-symbol="setrules()"> <a href="#setrules">setRules()</a> </li><li data-api-symbol="signinanonymously()"> <a href="#signinanonymously">signInAnonymously()</a> </li><li data-api-symbol="signinwithemailandpassword()"> <a href="#signinwithemailandpassword">signInWithEmailAndPassword()</a> </li><li data-api-symbol="signout()"> <a href="#signout">signOut()</a> </li><li data-api-symbol="startafter()"> <a href="#startafter">startAfter()</a> </li><li data-api-symbol="startat()"> <a href="#startat">startAt()</a> </li><li data-api-symbol="startpresence()"> <a href="#startpresence">startPresence()</a> </li><li data-api-symbol="subscribeevents()"> <a href="#subscribeevents">subscribeEvents()</a> </li><li data-api-symbol="subscribepresence()"> <a href="#subscribepresence">subscribePresence()</a> </li><li data-api-symbol="sum()"> <a href="#sum">sum()</a> </li><li data-api-symbol="switchworkerbranch()"> <a href="#switchworkerbranch">switchWorkerBranch()</a> </li><li data-api-symbol="updatedoc()"> <a href="#updatedoc">updateDoc()</a> </li><li data-api-symbol="uploadbytes()"> <a href="#uploadbytes">uploadBytes()</a> </li><li data-api-symbol="where()"> <a href="#where">where()</a> </li><li data-api-symbol="writebatch()"> <a href="#writebatch">writeBatch()</a> </li> </ul> </section> <p class="api-symbol-empty" data-api-symbol-empty hidden>No matching symbols</p> </div> </aside> </div> <script type="module">const a=document.querySelector("[data-api-symbol-filter]"),d=[...document.querySelectorAll("[data-api-symbol-group]")],n=document.querySelector("[data-api-symbol-empty]");a?.addEventListener("input",()=>{const t=a.value.trim().toLowerCase();let o=0;for(const i of d){let e=0;i.querySelectorAll("[data-api-symbol]").forEach(l=>{const r=!t||(l.dataset.apiSymbol??"").includes(t);l.hidden=!r,r&&e++}),i.hidden=e===0,o+=e}n&&(n.hidden=o>0)});</script> <script type="module">const s=new Map;document.querySelectorAll('.doc-toc a[href^="#"]').forEach(t=>s.set(decodeURIComponent(t.hash.slice(1)),t));if(s.size>0){const t=new Set,n=()=>{let o=null;for(const e of s.keys())if(t.has(e)){o=e;break}s.forEach((e,c)=>e.classList.toggle("active",c===o))},r=new IntersectionObserver(o=>{for(const e of o)e.isIntersecting?t.add(e.target.id):t.delete(e.target.id);n()},{rootMargin:"-72px 0px -60% 0px"});s.forEach((o,e)=>{const c=document.getElementById(e);c&&r.observe(c)})}</script> <script type="module">document.querySelector('.studio__nav [aria-current="page"]')?.scrollIntoView({block:"nearest",inline:"center"});</script> </body> </html>
+<h4 id="returns-135">Returns</h4>
+<p><a href="#clientwritebatch"><code>ClientWriteBatch</code></a></p>  </article> </main> <aside class="doc-toc api-symbols" aria-label="API symbols"> <h2 class="doc-toc-heading">Symbols</h2> <input class="api-symbol-filter" type="search" placeholder="Filter symbols" aria-label="Filter API symbols" data-api-symbol-filter> <div class="api-symbol-groups" data-api-symbol-groups> <section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="clientauth"> <a href="#clientauth">ClientAuth</a> </li><li data-api-symbol="clientdb"> <a href="#clientdb">ClientDb</a> </li><li data-api-symbol="clientdocsnapshot"> <a href="#clientdocsnapshot">ClientDocSnapshot</a> </li><li data-api-symbol="clientfirebasestorage"> <a href="#clientfirebasestorage">ClientFirebaseStorage</a> </li><li data-api-symbol="clientquerysnapshot"> <a href="#clientquerysnapshot">ClientQuerySnapshot</a> </li><li data-api-symbol="clientrtdb"> <a href="#clientrtdb">ClientRtdb</a> </li><li data-api-symbol="clientsettablemetadata"> <a href="#clientsettablemetadata">ClientSettableMetadata</a> </li><li data-api-symbol="clientstoragereference"> <a href="#clientstoragereference">ClientStorageReference</a> </li><li data-api-symbol="clienttransaction"> <a href="#clienttransaction">ClientTransaction</a> </li><li data-api-symbol="clientuser"> <a href="#clientuser">ClientUser</a> </li><li data-api-symbol="clientusercredential"> <a href="#clientusercredential">ClientUserCredential</a> </li><li data-api-symbol="clientwritebatch"> <a href="#clientwritebatch">ClientWriteBatch</a> </li><li data-api-symbol="collrefhandle"> <a href="#collrefhandle">CollRefHandle</a> </li><li data-api-symbol="docrefhandle"> <a href="#docrefhandle">DocRefHandle</a> </li><li data-api-symbol="presencesession"> <a href="#presencesession">PresenceSession</a> </li><li data-api-symbol="presencesnapshot"> <a href="#presencesnapshot">PresenceSnapshot</a> </li><li data-api-symbol="queryhandle"> <a href="#queryhandle">QueryHandle</a> </li><li data-api-symbol="resolvedidentity"> <a href="#resolvedidentity">ResolvedIdentity</a> </li><li data-api-symbol="rtdbdatasnapshot"> <a href="#rtdbdatasnapshot">RtdbDataSnapshot</a> </li><li data-api-symbol="rtdbrefhandle"> <a href="#rtdbrefhandle">RtdbRefHandle</a> </li><li data-api-symbol="serializedidtokenresult"> <a href="#serializedidtokenresult">SerializedIdTokenResult</a> </li><li data-api-symbol="serializeduser"> <a href="#serializeduser">SerializedUser</a> </li><li data-api-symbol="serializedusercredential"> <a href="#serializedusercredential">SerializedUserCredential</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#type-aliases"> Type Aliases </a> <ul> <li data-api-symbol="anyhandle"> <a href="#anyhandle">AnyHandle</a> </li><li data-api-symbol="authpersistencemode"> <a href="#authpersistencemode">AuthPersistenceMode</a> </li><li data-api-symbol="presenceclientkind"> <a href="#presenceclientkind">PresenceClientKind</a> </li><li data-api-symbol="presencevisibility"> <a href="#presencevisibility">PresenceVisibility</a> </li><li data-api-symbol="unsubscribe()"> <a href="#unsubscribe">Unsubscribe()</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#variables"> Variables </a> <ul> <li data-api-symbol="browserlocalpersistence"> <a href="#browserlocalpersistence">browserLocalPersistence</a> </li><li data-api-symbol="browsersessionpersistence"> <a href="#browsersessionpersistence">browserSessionPersistence</a> </li><li data-api-symbol="inmemorypersistence"> <a href="#inmemorypersistence">inMemoryPersistence</a> </li><li data-api-symbol="presence_heartbeat_interval_ms"> <a href="#presence_heartbeat_interval_ms">PRESENCE_HEARTBEAT_INTERVAL_MS</a> </li><li data-api-symbol="presence_stale_ms"> <a href="#presence_stale_ms">PRESENCE_STALE_MS</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#functions"> Functions </a> <ul> <li data-api-symbol="acceptprovidercredential()"> <a href="#acceptprovidercredential">acceptProviderCredential()</a> </li><li data-api-symbol="adddoc()"> <a href="#adddoc">addDoc()</a> </li><li data-api-symbol="adminclearusers()"> <a href="#adminclearusers">adminClearUsers()</a> </li><li data-api-symbol="admincreateuser()"> <a href="#admincreateuser">adminCreateUser()</a> </li><li data-api-symbol="admindeletedocument()"> <a href="#admindeletedocument">adminDeleteDocument()</a> </li><li data-api-symbol="admindeletertdbvalue()"> <a href="#admindeletertdbvalue">adminDeleteRtdbValue()</a> </li><li data-api-symbol="admindeleteuser()"> <a href="#admindeleteuser">adminDeleteUser()</a> </li><li data-api-symbol="admingetdocument()"> <a href="#admingetdocument">adminGetDocument()</a> </li><li data-api-symbol="adminlistdocuments()"> <a href="#adminlistdocuments">adminListDocuments()</a> </li><li data-api-symbol="adminreadrtdbstate()"> <a href="#adminreadrtdbstate">adminReadRtdbState()</a> </li><li data-api-symbol="adminreadstate()"> <a href="#adminreadstate">adminReadState()</a> </li><li data-api-symbol="adminsetdocument()"> <a href="#adminsetdocument">adminSetDocument()</a> </li><li data-api-symbol="adminsetrtdbvalue()"> <a href="#adminsetrtdbvalue">adminSetRtdbValue()</a> </li><li data-api-symbol="adminsubscribertdbvalue()"> <a href="#adminsubscribertdbvalue">adminSubscribeRtdbValue()</a> </li><li data-api-symbol="adminupdatertdbvalue()"> <a href="#adminupdatertdbvalue">adminUpdateRtdbValue()</a> </li><li data-api-symbol="adminupdateuser()"> <a href="#adminupdateuser">adminUpdateUser()</a> </li><li data-api-symbol="and()"> <a href="#and">and()</a> </li><li data-api-symbol="arrayremove()"> <a href="#arrayremove">arrayRemove()</a> </li><li data-api-symbol="arrayunion()"> <a href="#arrayunion">arrayUnion()</a> </li><li data-api-symbol="average()"> <a href="#average">average()</a> </li><li data-api-symbol="calltool()"> <a href="#calltool">callTool()</a> </li><li data-api-symbol="collection()"> <a href="#collection">collection()</a> </li><li data-api-symbol="collectiongroup()"> <a href="#collectiongroup">collectionGroup()</a> </li><li data-api-symbol="connectauthemulator()"> <a href="#connectauthemulator">connectAuthEmulator()</a> </li><li data-api-symbol="count()"> <a href="#count">count()</a> </li><li data-api-symbol="createuserwithemailandpassword()"> <a href="#createuserwithemailandpassword">createUserWithEmailAndPassword()</a> </li><li data-api-symbol="deletedoc()"> <a href="#deletedoc">deleteDoc()</a> </li><li data-api-symbol="deletefield()"> <a href="#deletefield">deleteField()</a> </li><li data-api-symbol="deleteobject()"> <a href="#deleteobject">deleteObject()</a> </li><li data-api-symbol="deleteworkerbranch()"> <a href="#deleteworkerbranch">deleteWorkerBranch()</a> </li><li data-api-symbol="doc()"> <a href="#doc">doc()</a> </li><li data-api-symbol="endat()"> <a href="#endat">endAt()</a> </li><li data-api-symbol="endbefore()"> <a href="#endbefore">endBefore()</a> </li><li data-api-symbol="eventhistory()"> <a href="#eventhistory">eventHistory()</a> </li><li data-api-symbol="exportworkerstate()"> <a href="#exportworkerstate">exportWorkerState()</a> </li><li data-api-symbol="getactiverules()"> <a href="#getactiverules">getActiveRules()</a> </li><li data-api-symbol="getaggregatefromserver()"> <a href="#getaggregatefromserver">getAggregateFromServer()</a> </li><li data-api-symbol="getauth()"> <a href="#getauth">getAuth()</a> </li><li data-api-symbol="getblob()"> <a href="#getblob">getBlob()</a> </li><li data-api-symbol="getbytes()"> <a href="#getbytes">getBytes()</a> </li><li data-api-symbol="getcountfromserver()"> <a href="#getcountfromserver">getCountFromServer()</a> </li><li data-api-symbol="getdoc()"> <a href="#getdoc">getDoc()</a> </li><li data-api-symbol="getdocs()"> <a href="#getdocs">getDocs()</a> </li><li data-api-symbol="getdownloadurl()"> <a href="#getdownloadurl">getDownloadURL()</a> </li><li data-api-symbol="getfirestore()"> <a href="#getfirestore">getFirestore()</a> </li><li data-api-symbol="getidtoken()"> <a href="#getidtoken-1">getIdToken()</a> </li><li data-api-symbol="getidtokenresult()"> <a href="#getidtokenresult-1">getIdTokenResult()</a> </li><li data-api-symbol="getlens()"> <a href="#getlens">getLens()</a> </li><li data-api-symbol="getmetadata()"> <a href="#getmetadata">getMetadata()</a> </li><li data-api-symbol="getproviderconfig()"> <a href="#getproviderconfig">getProviderConfig()</a> </li><li data-api-symbol="getrulesstatus()"> <a href="#getrulesstatus">getRulesStatus()</a> </li><li data-api-symbol="getsnapshot()"> <a href="#getsnapshot">getSnapshot()</a> </li><li data-api-symbol="getstorage()"> <a href="#getstorage">getStorage()</a> </li><li data-api-symbol="getworkerinstanceid()"> <a href="#getworkerinstanceid">getWorkerInstanceId()</a> </li><li data-api-symbol="getworkerversion()"> <a href="#getworkerversion">getWorkerVersion()</a> </li><li data-api-symbol="importworkerstate()"> <a href="#importworkerstate">importWorkerState()</a> </li><li data-api-symbol="increment()"> <a href="#increment">increment()</a> </li><li data-api-symbol="limit()"> <a href="#limit">limit()</a> </li><li data-api-symbol="limittolast()"> <a href="#limittolast">limitToLast()</a> </li><li data-api-symbol="listall()"> <a href="#listall">listAll()</a> </li><li data-api-symbol="listrootcollections()"> <a href="#listrootcollections">listRootCollections()</a> </li><li data-api-symbol="listsubcollections()"> <a href="#listsubcollections">listSubcollections()</a> </li><li data-api-symbol="listusers()"> <a href="#listusers">listUsers()</a> </li><li data-api-symbol="listworkerbranches()"> <a href="#listworkerbranches">listWorkerBranches()</a> </li><li data-api-symbol="mintpresenceclientid()"> <a href="#mintpresenceclientid">mintPresenceClientId()</a> </li><li data-api-symbol="onauthstatechanged()"> <a href="#onauthstatechanged">onAuthStateChanged()</a> </li><li data-api-symbol="onidtokenchanged()"> <a href="#onidtokenchanged">onIdTokenChanged()</a> </li><li data-api-symbol="onsnapshot()"> <a href="#onsnapshot">onSnapshot()</a> </li><li data-api-symbol="or()"> <a href="#or">or()</a> </li><li data-api-symbol="orderby()"> <a href="#orderby">orderBy()</a> </li><li data-api-symbol="query()"> <a href="#query">query()</a> </li><li data-api-symbol="ref()"> <a href="#ref">ref()</a> </li><li data-api-symbol="relayworkerop()"> <a href="#relayworkerop">relayWorkerOp()</a> </li><li data-api-symbol="relayworkersub()"> <a href="#relayworkersub">relayWorkerSub()</a> </li><li data-api-symbol="resetall()"> <a href="#resetall">resetAll()</a> </li><li data-api-symbol="rtdbchild()"> <a href="#rtdbchild">rtdbChild()</a> </li><li data-api-symbol="rtdbconnectdatabaseemulator()"> <a href="#rtdbconnectdatabaseemulator">rtdbConnectDatabaseEmulator()</a> </li><li data-api-symbol="rtdbget()"> <a href="#rtdbget">rtdbGet()</a> </li><li data-api-symbol="rtdbgetdatabase()"> <a href="#rtdbgetdatabase">rtdbGetDatabase()</a> </li><li data-api-symbol="rtdboff()"> <a href="#rtdboff">rtdbOff()</a> </li><li data-api-symbol="rtdbonvalue()"> <a href="#rtdbonvalue">rtdbOnValue()</a> </li><li data-api-symbol="rtdbpush()"> <a href="#rtdbpush">rtdbPush()</a> </li><li data-api-symbol="rtdbref()"> <a href="#rtdbref">rtdbRef()</a> </li><li data-api-symbol="rtdbremove()"> <a href="#rtdbremove">rtdbRemove()</a> </li><li data-api-symbol="rtdbservertimestamp()"> <a href="#rtdbservertimestamp">rtdbServerTimestamp()</a> </li><li data-api-symbol="rtdbset()"> <a href="#rtdbset">rtdbSet()</a> </li><li data-api-symbol="rtdbupdate()"> <a href="#rtdbupdate">rtdbUpdate()</a> </li><li data-api-symbol="runtransaction()"> <a href="#runtransaction">runTransaction()</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#multi-tab-correctness--read-set-validation--retry"> MULTI-TAB CORRECTNESS — READ-SET VALIDATION + RETRY </a> <ul> <li data-api-symbol="saveworkerbranch()"> <a href="#saveworkerbranch">saveWorkerBranch()</a> </li><li data-api-symbol="servertimestamp()"> <a href="#servertimestamp">serverTimestamp()</a> </li><li data-api-symbol="setdatabaserules()"> <a href="#setdatabaserules">setDatabaseRules()</a> </li><li data-api-symbol="setdoc()"> <a href="#setdoc">setDoc()</a> </li><li data-api-symbol="setfirestorerules()"> <a href="#setfirestorerules">setFirestoreRules()</a> </li><li data-api-symbol="setlens()"> <a href="#setlens">setLens()</a> </li><li data-api-symbol="setopissuer()"> <a href="#setopissuer">setOpIssuer()</a> </li><li data-api-symbol="setpersistence()"> <a href="#setpersistence">setPersistence()</a> </li><li data-api-symbol="setproviderconfig()"> <a href="#setproviderconfig">setProviderConfig()</a> </li><li data-api-symbol="setrules()"> <a href="#setrules">setRules()</a> </li><li data-api-symbol="signinanonymously()"> <a href="#signinanonymously">signInAnonymously()</a> </li><li data-api-symbol="signinwithemailandpassword()"> <a href="#signinwithemailandpassword">signInWithEmailAndPassword()</a> </li><li data-api-symbol="signout()"> <a href="#signout">signOut()</a> </li><li data-api-symbol="startafter()"> <a href="#startafter">startAfter()</a> </li><li data-api-symbol="startat()"> <a href="#startat">startAt()</a> </li><li data-api-symbol="startpresence()"> <a href="#startpresence">startPresence()</a> </li><li data-api-symbol="subscribeevents()"> <a href="#subscribeevents">subscribeEvents()</a> </li><li data-api-symbol="subscribepresence()"> <a href="#subscribepresence">subscribePresence()</a> </li><li data-api-symbol="sum()"> <a href="#sum">sum()</a> </li><li data-api-symbol="switchworkerbranch()"> <a href="#switchworkerbranch">switchWorkerBranch()</a> </li><li data-api-symbol="updatedoc()"> <a href="#updatedoc">updateDoc()</a> </li><li data-api-symbol="uploadbytes()"> <a href="#uploadbytes">uploadBytes()</a> </li><li data-api-symbol="where()"> <a href="#where">where()</a> </li><li data-api-symbol="writebatch()"> <a href="#writebatch">writeBatch()</a> </li> </ul> </section> <p class="api-symbol-empty" data-api-symbol-empty hidden>No matching symbols</p> </div> </aside> </div> <script type="module">const a=document.querySelector("[data-api-symbol-filter]"),d=[...document.querySelectorAll("[data-api-symbol-group]")],n=document.querySelector("[data-api-symbol-empty]");a?.addEventListener("input",()=>{const t=a.value.trim().toLowerCase();let o=0;for(const i of d){let e=0;i.querySelectorAll("[data-api-symbol]").forEach(l=>{const r=!t||(l.dataset.apiSymbol??"").includes(t);l.hidden=!r,r&&e++}),i.hidden=e===0,o+=e}n&&(n.hidden=o>0)});</script> <script type="module">const s=new Map;document.querySelectorAll('.doc-toc a[href^="#"]').forEach(t=>s.set(decodeURIComponent(t.hash.slice(1)),t));if(s.size>0){const t=new Set,n=()=>{let o=null;for(const e of s.keys())if(t.has(e)){o=e;break}s.forEach((e,c)=>e.classList.toggle("active",c===o))},r=new IntersectionObserver(o=>{for(const e of o)e.isIntersecting?t.add(e.target.id):t.delete(e.target.id);n()},{rootMargin:"-72px 0px -60% 0px"});s.forEach((o,e)=>{const c=document.getElementById(e);c&&r.observe(c)})}</script> <script type="module">document.querySelector('.studio__nav [aria-current="page"]')?.scrollIntoView({block:"nearest",inline:"center"});</script> </body> </html>