pyric-admin 0.1.0-alpha.24 → 0.1.0-alpha.26

package/dist/data-connect/index.js

@@ -1,11 +1,48 @@
 /**
- * `pyric-admin/data-connect`: a deferred entry for `firebase-admin/data-connect`.
- *
- * The sandbox does not model Data Connect. Every value `firebase-admin/data-connect`
- * exports is present so imports link; using one throws `PyricDeferredApiError`.
- * See `../deferred.ts`.
+ * `pyric-admin/data-connect`: deferred service handle for `firebase-admin/data-connect`.
  */
-import { deferredAdminEntry } from '../deferred.js';
+import { defineDeferredMembers } from 'pyric/app/internal';
+import { DEFERRED_SERVICE_TOKEN, deferredAdminEntry, guardDeferredServiceApp, resolveActiveAdminApp, } from '../deferred.js';
 export { PyricDeferredApiError } from '../deferred.js';
-export const { DataConnect, getDataConnect, validateAdminArgs, } = deferredAdminEntry('data-connect');
+export class DataConnect {
+    #app;
+    connectorConfig;
+    /** @internal */
+    constructor(...args) {
+        this.#app = guardDeferredServiceApp('data-connect', 'DataConnect', args);
+        this.connectorConfig = args[2];
+    }
+    get app() {
+        return this.#app;
+    }
+}
+defineDeferredMembers(DataConnect.prototype, 'pyric-admin/data-connect', 'DataConnect', {
+    async: [
+        'executeGraphql',
+        'executeGraphqlRead',
+        'executeMutation',
+        'executeQuery',
+        'insert',
+        'insertMany',
+        'upsert',
+        'upsertMany',
+    ],
+});
+const instancesByApp = new WeakMap();
+export function getDataConnect(connectorConfig, app) {
+    const resolved = resolveActiveAdminApp(app);
+    let byId = instancesByApp.get(resolved);
+    if (!byId) {
+        byId = new Map();
+        instancesByApp.set(resolved, byId);
+    }
+    const id = `${connectorConfig.location}-${connectorConfig.serviceId}`;
+    const existing = byId.get(id);
+    if (existing !== undefined)
+        return existing;
+    const created = new DataConnect(DEFERRED_SERVICE_TOKEN, resolved, connectorConfig);
+    byId.set(id, created);
+    return created;
+}
+export const { validateAdminArgs } = deferredAdminEntry('data-connect');
 //# sourceMappingURL=index.js.map

package/dist/data-connect/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data-connect/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,CAAC,MAAM,EACX,WAAW,EAAE,cAAc,EAAE,iBAAiB,GAC/C,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data-connect/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAQvD,MAAM,OAAO,WAAW;IACb,IAAI,CAAgB;IACpB,eAAe,CAAkB;IAE1C,gBAAgB;IAChB,YAAY,GAAG,IAAe;QAC5B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC,cAAc,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAoB,CAAC;IACpD,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CAUF;AAED,qBAAqB,CAAC,WAAW,CAAC,SAAS,EAAE,0BAA0B,EAAE,aAAa,EAAE;IACtF,KAAK,EAAE;QACL,gBAAgB;QAChB,oBAAoB;QACpB,iBAAiB;QACjB,cAAc;QACd,QAAQ;QACR,YAAY;QACZ,QAAQ;QACR,YAAY;KACb;CACF,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,OAAO,EAA2C,CAAC;AAE9E,MAAM,UAAU,cAAc,CAAC,eAAgC,EAAE,GAAmB;IAClF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACjB,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,EAAE,GAAG,GAAG,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,sBAAsB,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IACnF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC"}

package/dist/database/index.d.ts

@@ -40,11 +40,12 @@
  *         backing rule state to expose.
  *
  *     Sandbox state lives on the underlying `Sandbox` via a `WeakMap`
- *     keyed by the `Sandbox` instance — `sandbox.reset()` wipes it via
- *     the sandbox's `session_boundary` event with `phase: 'reset'`.
- *     Successive `getDatabase(app)` calls for the same sandbox return
- *     handles that share data (matches firebase-admin's
- *     singleton-per-app semantics).
+ *     keyed by the `Sandbox` instance, with one tree per RTDB instance
+ *     (the instance a database URL names). `sandbox.reset()` wipes every
+ *     tree via the sandbox's `session_boundary` event.
+ *     Successive `getDatabase(app)` calls for the same sandbox and instance
+ *     return the same handle (matches firebase-admin's one database per
+ *     app and URL).
  *
  *   - **Remote sandbox arm** (sandbox target whose `Sandbox` carries the
  *     `pyric/sandbox` remote brand — a Node-side handle onto the
@@ -52,7 +53,9 @@
  *     `connectRemoteSandbox()`) — every `Reference` data operation routes
  *     through the handle's worker-relay channel (`rtdb.get/set/update/
  *     remove/push` ops with `actAs: { mode: 'admin' }` pinned — firebase-
- *     admin's rules-bypass semantics), NOT into the process-local tree:
+ *     admin's rules-bypass semantics, and the instance the database
+ *     URL names on every op and value subscription), NOT into the
+ *     process-local tree:
  *     a local tree on a remote handle would be private server-side data
  *     the browser never sees. Differences from the local arm, both
  *     deliberate upgrades:
@@ -71,6 +74,9 @@
  *     sends it with the `rtdb.push` op (the worker-protocol contract).
  */
 import { type PyricAdminApp } from '../app/index.js';
+/** `firebase-admin/database`'s `enableLogging`. The sandbox does not model
+ *  the client logger, so it fails with an error naming it. */
+export declare const enableLogging: import("pyric/app/internal").DeferredApi;
 /** Mirror of `firebase-admin/database`'s `ServerValue` constant and sentinel constructors. */
 export declare const ServerValue: {
     readonly TIMESTAMP: object;
@@ -131,27 +137,26 @@ type AdminDatabase = Database;
  *
  * Signature mirrors `firebase-admin/database`'s `getDatabase(app?)`.
  *
- *   - `getDatabase()` — default database for the DEFAULT app (resolved
+ *   - `getDatabase()`: default database for the DEFAULT app (resolved
  *     through `pyric-admin/app`'s registry, exactly like firebase-admin's
  *     no-arg `getDatabase()`; throws `app/no-app` when no default app has
  *     been initialized). Works for local and remote sandbox apps.
- *   - `getDatabase(app)` — default database for the app.
- *   - `getDatabase(app, url)` — legacy Pyric-only compatibility form. New
- *     code should use the upstream-shaped {@link getDatabaseWithUrl} export.
+ *   - `getDatabase(app)`: the database the app's `databaseURL` option names,
+ *     else the default instance.
+ *   - `getDatabase(app, url)`: the database `url` names, as
+ *     {@link getDatabaseWithUrl} selects it.
  *
- * The sandbox brand returns the local or remote `Database` backed by the
- * per-`Sandbox` state described in the module-level docs.
+ * Each RTDB instance has its own data: one `Database` per sandbox and
+ * instance, backed by the per-`Sandbox` state described in the module-level
+ * docs. A URL that does not parse as a database URL throws the SDK's error.
  */
-export declare function getDatabase(app?: PyricAdminApp, _url?: string): AdminDatabase;
+export declare function getDatabase(app?: PyricAdminApp, url?: string): AdminDatabase;
 /**
- * Returns the {@link AdminDatabase} service selected by an upstream-shaped
- * database URL.
+ * Returns the {@link AdminDatabase} service for the RTDB instance `url` names.
  *
  * This is the exact `firebase-admin/database` argument order used by the
- * Firebase Functions SDK: `getDatabaseWithUrl(url, app?)`. The first Pyric
- * Functions slice has one shared RTDB instance, so the URL selects that
- * instance rather than creating a second sandbox database.
+ * Firebase Functions SDK: `getDatabaseWithUrl(url, app?)`.
  */
-export declare function getDatabaseWithUrl(_url: string, app?: PyricAdminApp): AdminDatabase;
+export declare function getDatabaseWithUrl(url: string, app?: PyricAdminApp): AdminDatabase;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/database/index.js

@@ -40,11 +40,12 @@
  *         backing rule state to expose.
  *
  *     Sandbox state lives on the underlying `Sandbox` via a `WeakMap`
- *     keyed by the `Sandbox` instance — `sandbox.reset()` wipes it via
- *     the sandbox's `session_boundary` event with `phase: 'reset'`.
- *     Successive `getDatabase(app)` calls for the same sandbox return
- *     handles that share data (matches firebase-admin's
- *     singleton-per-app semantics).
+ *     keyed by the `Sandbox` instance, with one tree per RTDB instance
+ *     (the instance a database URL names). `sandbox.reset()` wipes every
+ *     tree via the sandbox's `session_boundary` event.
+ *     Successive `getDatabase(app)` calls for the same sandbox and instance
+ *     return the same handle (matches firebase-admin's one database per
+ *     app and URL).
  *
  *   - **Remote sandbox arm** (sandbox target whose `Sandbox` carries the
  *     `pyric/sandbox` remote brand — a Node-side handle onto the
@@ -52,7 +53,9 @@
  *     `connectRemoteSandbox()`) — every `Reference` data operation routes
  *     through the handle's worker-relay channel (`rtdb.get/set/update/
  *     remove/push` ops with `actAs: { mode: 'admin' }` pinned — firebase-
- *     admin's rules-bypass semantics), NOT into the process-local tree:
+ *     admin's rules-bypass semantics, and the instance the database
+ *     URL names on every op and value subscription), NOT into the
+ *     process-local tree:
  *     a local tree on a remote handle would be private server-side data
  *     the browser never sees. Differences from the local arm, both
  *     deliberate upgrades:
@@ -71,9 +74,15 @@
  *     sends it with the `rtdb.push` op (the worker-protocol contract).
  */
 import { isRemoteSandbox, } from 'pyric/sandbox';
+import { createDatabaseInstanceRegistry, isCustomDatabaseHost, isDefaultDatabaseInstance, parseDatabaseLocationUrl, parseDatabaseUrl, } from 'pyric/sandbox/internal';
 import { ADMIN_APP_TARGET, getApp, } from '../app/index.js';
 import { assertAdminAppActive } from '../app/lifecycle.js';
 import { increment, serverTimestamp } from 'pyric/database';
+import { valueAtChildPath, valueChildren } from 'pyric/database/internal';
+import { deferredExport } from 'pyric/app/internal';
+/** `firebase-admin/database`'s `enableLogging`. The sandbox does not model
+ *  the client logger, so it fails with an error naming it. */
+export const enableLogging = deferredExport('pyric-admin/database', 'enableLogging');
 /** Mirror of `firebase-admin/database`'s `ServerValue` constant and sentinel constructors. */
 export const ServerValue = {
     TIMESTAMP: serverTimestamp(),
@@ -84,18 +93,20 @@ export const ServerValue = {
  *
  * Signature mirrors `firebase-admin/database`'s `getDatabase(app?)`.
  *
- *   - `getDatabase()` — default database for the DEFAULT app (resolved
+ *   - `getDatabase()`: default database for the DEFAULT app (resolved
  *     through `pyric-admin/app`'s registry, exactly like firebase-admin's
  *     no-arg `getDatabase()`; throws `app/no-app` when no default app has
  *     been initialized). Works for local and remote sandbox apps.
- *   - `getDatabase(app)` — default database for the app.
- *   - `getDatabase(app, url)` — legacy Pyric-only compatibility form. New
- *     code should use the upstream-shaped {@link getDatabaseWithUrl} export.
+ *   - `getDatabase(app)`: the database the app's `databaseURL` option names,
+ *     else the default instance.
+ *   - `getDatabase(app, url)`: the database `url` names, as
+ *     {@link getDatabaseWithUrl} selects it.
  *
- * The sandbox brand returns the local or remote `Database` backed by the
- * per-`Sandbox` state described in the module-level docs.
+ * Each RTDB instance has its own data: one `Database` per sandbox and
+ * instance, backed by the per-`Sandbox` state described in the module-level
+ * docs. A URL that does not parse as a database URL throws the SDK's error.
  */
-export function getDatabase(app, _url) {
+export function getDatabase(app, url) {
     if (app === undefined) {
         // No-arg mirror of firebase-admin's `getDatabase()` — resolve the
         // '[DEFAULT]' app from the registry (throws app/no-app on a miss).
@@ -103,59 +114,86 @@ export function getDatabase(app, _url) {
     }
     assertAdminAppActive(app);
     if (app[ADMIN_APP_TARGET] === 'sandbox') {
-        return getSandboxDatabase(app.sandbox);
+        return getSandboxDatabase(app.sandbox, adminDatabaseInstance(app, url));
     }
     throw new TypeError('pyric-admin/database: getDatabase expected a PyricAdminApp ' +
         '(initialize via `initializeApp` from pyric-admin/app).');
 }
 /**
- * Returns the {@link AdminDatabase} service selected by an upstream-shaped
- * database URL.
+ * Returns the {@link AdminDatabase} service for the RTDB instance `url` names.
  *
  * This is the exact `firebase-admin/database` argument order used by the
- * Firebase Functions SDK: `getDatabaseWithUrl(url, app?)`. The first Pyric
- * Functions slice has one shared RTDB instance, so the URL selects that
- * instance rather than creating a second sandbox database.
+ * Firebase Functions SDK: `getDatabaseWithUrl(url, app?)`.
  */
-export function getDatabaseWithUrl(_url, app) {
-    return getDatabase(app);
+export function getDatabaseWithUrl(url, app) {
+    if (typeof url !== 'string' || url === '') {
+        throw invalidDatabaseUrl();
+    }
+    return getDatabase(app, url);
+}
+/** firebase-admin's error for a missing or empty database URL. */
+function invalidDatabaseUrl() {
+    return Object.assign(new Error('Database URL must be a valid, non-empty URL string.'), { code: 'database/invalid-argument' });
+}
+/**
+ * The instance an admin database targets: `url`, else the app's `databaseURL`
+ * option, parsed as the production SDK parses it. `undefined` is the default
+ * instance, which the instance named `<projectId>-default-rtdb` or, for a
+ * project created before about 2020, `<projectId>` also is when the app's
+ * options name the project.
+ */
+function adminDatabaseInstance(app, url) {
+    if (url === '')
+        throw invalidDatabaseUrl();
+    const source = url ?? app.options.databaseURL;
+    if (source === undefined)
+        return undefined;
+    const instance = parseDatabaseUrl(source);
+    const projectId = app.options.projectId;
+    const isProjectDefault = isDefaultDatabaseInstance(instance.name, projectId);
+    return isProjectDefault ? undefined : instance;
 }
-/** One backend per `Sandbox`. Successive `getDatabase(app)` calls for
- *  the same sandbox return handles that share data — matches
- *  firebase-admin's singleton-per-app semantics. */
-const stateBySandbox = new WeakMap();
-function getOrCreateState(sandbox) {
-    let state = stateBySandbox.get(sandbox);
-    if (state !== undefined)
-        return state;
-    state = { root: {} };
-    stateBySandbox.set(sandbox, state);
-    // Wire `sandbox.reset()` → wipe the tree. `session_boundary` fires
-    // before the env swap, so consumer code that observes a reset sees
+/** One registry of instances per `Sandbox`. Successive `getDatabase(app)`
+ *  calls for the same sandbox and instance return the same handle, and
+ *  each instance keeps its own tree, as firebase-admin keeps one database
+ *  per URL. */
+const localInstancesBySandbox = new WeakMap();
+function localInstances(sandbox) {
+    const existing = localInstancesBySandbox.get(sandbox);
+    if (existing !== undefined)
+        return existing;
+    const registry = createDatabaseInstanceRegistry({
+        create: () => ({ state: { root: {} } }),
+    });
+    localInstancesBySandbox.set(sandbox, registry);
+    // Wire `sandbox.reset()` → wipe every instance's tree. `session_boundary`
+    // fires before the env swap, so consumer code that observes a reset sees
     // the freshly-cleared tree on the next read. `dispose` also fires a
     // boundary; treat it the same (the sandbox is being torn down — any
     // in-flight handle on the tree gets an empty view).
     sandbox.onEvent((event) => {
         if (event.kind === 'session_boundary') {
-            state.root = {};
+            for (const [, entry] of registry.entries())
+                entry.state.root = {};
         }
     });
-    return state;
+    return registry;
 }
-/** Build (or reuse) the sandbox Database handle for `sandbox`.
+/** Build (or reuse) the sandbox Database handle for `sandbox` and `instance`
+ *  (`undefined` is the default instance).
  *
  *  REMOTE handles dispatch here, BEFORE any local state is touched: a
  *  remote sandbox must never get a `SandboxState` (a private local tree)
  *  or a `sandbox.onEvent` wire-up (which throws on remote handles). */
-function getSandboxDatabase(sandbox) {
+function getSandboxDatabase(sandbox, instance) {
     if (isRemoteSandbox(sandbox)) {
-        return getRemoteDatabase(sandbox);
+        return getRemoteDatabase(sandbox, instance);
     }
-    const state = getOrCreateState(sandbox);
-    return buildSandboxDatabase(state);
-}
-function buildSandboxDatabase(state) {
-    return buildDatabaseShell((db, path) => buildSandboxRef(state, db, path));
+    const registry = localInstances(sandbox);
+    const entry = registry.getOrCreate(registry.keyOf(instance));
+    const state = entry.state;
+    entry.db ??= buildDatabaseShell(instance, (handle, path) => buildSandboxRef(state, handle, path));
+    return entry.db;
 }
 /**
  * The `Database`-level shell shared by the local and remote sandbox arms —
@@ -163,17 +201,22 @@ function buildSandboxDatabase(state) {
  * modeled on either arm; connection toggles are no-ops (the sandbox IS the
  * local emulator).
  */
-function buildDatabaseShell(refFactory) {
+function buildDatabaseShell(instance, refFactory) {
     const db = {
         ref(path) {
             return refFactory(db, path ?? '/');
         },
+        /** As the SDK parses it: the URL names a location, and for a
+         *  `firebaseio.com` database its host must be this database's host. */
         refFromURL(url) {
-            // Best-effort: strip the `https://<host>` prefix and treat the
-            // remainder as a path. The sandbox has no notion of multi-database
-            // hosts, so the host portion is ignored.
-            const u = url.replace(/^https?:\/\/[^/]+/, '');
-            return refFactory(db, u || '/');
+            const location = parseDatabaseLocationUrl(url);
+            if (instance !== undefined) {
+                const expectedHost = parseDatabaseLocationUrl(instance.url).host;
+                if (!isCustomDatabaseHost(expectedHost) && location.host !== expectedHost) {
+                    throw new Error(`FIREBASE FATAL ERROR: refFromURL: Host name does not match the current database: (found ${location.host} but expected ${expectedHost}) `);
+                }
+            }
+            return refFactory(db, location.path);
         },
         // Admin-only metadata methods — not modeled in the sandbox. The
         // sandbox is rule-bypass by construction; surfacing rule JSON would
@@ -578,6 +621,9 @@ function buildSandboxSnap(refAt, path, val) {
     const segs = pathSegments(path);
     const key = segs.length === 0 ? null : segs[segs.length - 1];
     const exists = val !== null;
+    // An array value still has children: `val()` renders integer keys as an
+    // array, and the SDK iterates them as '0', '1', ... (#1110).
+    const children = valueChildren(val);
     const snap = {
         key,
         get ref() {
@@ -591,35 +637,21 @@ function buildSandboxSnap(refAt, path, val) {
         },
         child(p) {
             const childSegs = pathSegments(p);
-            let cur = val;
-            for (const s of childSegs) {
-                if (cur === null || typeof cur !== 'object' || Array.isArray(cur)) {
-                    cur = null;
-                    break;
-                }
-                cur = cur[s] ?? null;
-            }
-            return buildSandboxSnap(refAt, joinPath([...segs, ...childSegs]), cur);
+            const childVal = valueAtChildPath(val, childSegs);
+            return buildSandboxSnap(refAt, joinPath([...segs, ...childSegs]), childVal);
         },
         hasChild(p) {
             return snap.child(p).exists();
         },
         hasChildren() {
-            return (val !== null &&
-                typeof val === 'object' &&
-                !Array.isArray(val) &&
-                Object.keys(val).length > 0);
+            return children.length > 0;
         },
         numChildren() {
-            if (val === null || typeof val !== 'object' || Array.isArray(val))
-                return 0;
-            return Object.keys(val).length;
+            return children.length;
         },
         forEach(cb) {
-            if (val === null || typeof val !== 'object' || Array.isArray(val))
-                return false;
-            for (const [k, v] of Object.entries(val)) {
-                const childSnap = buildSandboxSnap(refAt, joinPath([...segs, k]), v);
+            for (const { key: childKey, value } of children) {
+                const childSnap = buildSandboxSnap(refAt, joinPath([...segs, childKey]), value);
                 if (cb(childSnap) === true)
                     return true;
             }
@@ -655,22 +687,35 @@ function buildSandboxSnap(refAt, path, val) {
 // `onEvent` throws on remote handles by design.
 /** firebase-admin's rules-bypass lens, pinned on every relayed operation. */
 const REMOTE_ADMIN_LENS = { mode: 'admin' };
-/** One `Database` per remote handle — successive `getDatabase(app)` calls
- *  share the listener registry (matches the local arm's singleton-per-
- *  sandbox semantics). Keyed off the handle object; the data itself lives
- *  in the browser worker. */
-const remoteDbBySandbox = new WeakMap();
-function getRemoteDatabase(sandbox) {
-    let db = remoteDbBySandbox.get(sandbox);
-    if (db !== undefined)
-        return db;
+/** One `Database` per remote handle and instance. Successive
+ *  `getDatabase(app)` calls for an instance share the listener registry
+ *  (matches the local arm's singleton-per-instance semantics). Keyed off
+ *  the handle object; the data itself lives in the host. */
+const remoteDbsBySandbox = new WeakMap();
+function getRemoteDatabase(sandbox, instance) {
+    let registry = remoteDbsBySandbox.get(sandbox);
+    if (registry === undefined) {
+        registry = createDatabaseInstanceRegistry({ create: () => ({}) });
+        remoteDbsBySandbox.set(sandbox, registry);
+    }
+    const entry = registry.getOrCreate(registry.keyOf(instance));
+    if (entry.db !== undefined)
+        return entry.db;
     const state = {
         channel: sandbox.channel,
+        instance: instance?.name,
         listeners: new Map(),
     };
-    db = buildDatabaseShell((dbHandle, path) => buildRemoteRef(state, dbHandle, path));
-    remoteDbBySandbox.set(sandbox, db);
-    return db;
+    entry.db = buildDatabaseShell(instance, (dbHandle, path) => buildRemoteRef(state, dbHandle, path));
+    return entry.db;
+}
+/** Relay `op` on the state's instance, under firebase-admin's rules-bypass lens. */
+function relayRtdbOp(state, op) {
+    return state.channel.op({ ...op, instance: state.instance, actAs: REMOTE_ADMIN_LENS });
+}
+/** Subscribe to the value at `path` on the state's instance, under the admin lens. */
+function subscribeRtdbValue(state, path, onSnap, onError) {
+    return state.channel.subscribe({ target: { service: 'rtdb', instance: state.instance, path }, actAs: REMOTE_ADMIN_LENS }, onSnap, onError);
 }
 /**
  * Build a remote `Reference` at `path`. Same load-bearing surface as the
@@ -704,19 +749,17 @@ function buildRemoteRef(state, db, path) {
         // ─── Data-plane methods (relayed worker ops) ─────────────────────
         /** Set `value` at this path. `null` deletes. Relays `rtdb.set`. */
         async set(value) {
-            await state.channel.op({
+            await relayRtdbOp(state, {
                 method: 'rtdb.set',
                 path: canonical,
                 value: value ?? null,
-                actAs: REMOTE_ADMIN_LENS,
             });
         },
         /** Read this path (`rtdb.get`). Resolves to a `DataSnapshot`. */
         async get() {
-            const wire = (await state.channel.op({
+            const wire = (await relayRtdbOp(state, {
                 method: 'rtdb.get',
                 path: canonical,
-                actAs: REMOTE_ADMIN_LENS,
             }));
             return snapFromWire(wire);
         },
@@ -730,7 +773,7 @@ function buildRemoteRef(state, db, path) {
             return new Promise((resolve, reject) => {
                 let detach = null;
                 let settled = false;
-                detach = state.channel.subscribe({ target: { service: 'rtdb', path: canonical }, actAs: REMOTE_ADMIN_LENS }, (value) => {
+                detach = subscribeRtdbValue(state, canonical, (value) => {
                     if (settled)
                         return;
                     settled = true;
@@ -756,19 +799,17 @@ function buildRemoteRef(state, db, path) {
             if (values === null || typeof values !== 'object') {
                 throw new TypeError('pyric-admin/database sandbox: update expected an object.');
             }
-            await state.channel.op({
+            await relayRtdbOp(state, {
                 method: 'rtdb.update',
                 path: canonical,
                 values: values,
-                actAs: REMOTE_ADMIN_LENS,
             });
         },
         /** Delete the subtree at this path (`rtdb.remove`). */
         async remove() {
-            await state.channel.op({
+            await relayRtdbOp(state, {
                 method: 'rtdb.remove',
                 path: canonical,
-                actAs: REMOTE_ADMIN_LENS,
             });
         },
         /**
@@ -785,14 +826,7 @@ function buildRemoteRef(state, db, path) {
             const childPath = joinPath([...segs, id]);
             const write = value === undefined
                 ? Promise.resolve()
-                : state.channel
-                    .op({
-                    method: 'rtdb.push',
-                    path: canonical,
-                    key: id,
-                    value,
-                    actAs: REMOTE_ADMIN_LENS,
-                })
+                : relayRtdbOp(state, { method: 'rtdb.push', path: canonical, key: id, value })
                     .then(() => undefined);
             // Surface completion without forcing the caller to await: `.then`'s
             // rejection handler also keeps a fire-and-forget push from becoming
@@ -836,7 +870,7 @@ function buildRemoteRef(state, db, path) {
             const cancelCallback = typeof cancelCallbackOrContext === 'function'
                 ? cancelCallbackOrContext
                 : undefined;
-            const detach = state.channel.subscribe({ target: { service: 'rtdb', path: canonical }, actAs: REMOTE_ADMIN_LENS }, (value) => {
+            const detach = subscribeRtdbValue(state, canonical, (value) => {
                 callback(snapFromWire(value));
             }, (err) => {
                 detachListener(state, canonical, callback);