@pyric/cli 0.1.0-alpha.9

package/dist/functions-rtdb/in-memory-delivery.js

@@ -0,0 +1,36 @@
+function canonicalPath(path) {
+    const normalized = path.split('/').filter(Boolean).join('/');
+    return normalized ? `/${normalized}` : '/';
+}
+/** Deterministic test adapter for the snapshot-delivery seam. */
+export class InMemoryRtdbTriggerDelivery {
+    #values = new Map();
+    #listeners = new Map();
+    seed(path, value) {
+        this.#values.set(canonicalPath(path), structuredClone(value));
+    }
+    emit(path, value) {
+        const key = canonicalPath(path);
+        const snapshot = structuredClone(value);
+        this.#values.set(key, snapshot);
+        for (const listener of this.#listeners.get(key) ?? []) {
+            listener(structuredClone(snapshot));
+        }
+    }
+    subscribe(path, listener) {
+        const key = canonicalPath(path);
+        let listeners = this.#listeners.get(key);
+        if (!listeners) {
+            listeners = new Set();
+            this.#listeners.set(key, listeners);
+        }
+        listeners.add(listener);
+        listener(structuredClone(this.#values.get(key) ?? null));
+        return () => {
+            listeners?.delete(listener);
+            if (listeners?.size === 0)
+                this.#listeners.delete(key);
+        };
+    }
+}
+//# sourceMappingURL=in-memory-delivery.js.map

package/dist/functions-rtdb/in-memory-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-delivery.js","sourceRoot":"","sources":["../../src/functions-rtdb/in-memory-delivery.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,iEAAiE;AACjE,MAAM,OAAO,2BAA2B;IAC7B,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,UAAU,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEvE,IAAI,CAAC,IAAY,EAAE,KAAc;QAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,KAAc;QAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,QAAkC;QACxD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE;YACV,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/functions-rtdb/project.d.ts

@@ -0,0 +1,7 @@
+export interface FunctionsRtdbProject {
+    sourceDir: string;
+    entry: string;
+}
+/** Discover the one Node Functions source supported by the first RTDB slice. */
+export declare function discoverFunctionsRtdbProject(cwd: string): FunctionsRtdbProject | null;
+//# sourceMappingURL=project.d.ts.map

package/dist/functions-rtdb/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/project.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAOD,gFAAgF;AAChF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA0DrF"}

package/dist/functions-rtdb/project.js

@@ -0,0 +1,54 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/** Discover the one Node Functions source supported by the first RTDB slice. */
+export function discoverFunctionsRtdbProject(cwd) {
+    const firebaseJsonPath = join(cwd, 'firebase.json');
+    if (!existsSync(firebaseJsonPath))
+        return null;
+    let config;
+    try {
+        config = JSON.parse(readFileSync(firebaseJsonPath, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`pyric dev: failed to parse firebase.json while discovering Functions: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (config.functions === undefined || config.functions === null)
+        return null;
+    const declared = Array.isArray(config.functions)
+        ? config.functions
+        : [config.functions];
+    if (declared.length !== 1) {
+        throw new Error('pyric dev: multiple Functions codebases are not supported by the first ' +
+            'onValueCreated slice; configure one source for this development session.');
+    }
+    const functions = declared[0];
+    if (typeof functions !== 'object' || functions === null) {
+        throw new Error('pyric dev: firebase.json `functions` must be an object with a source.');
+    }
+    if (functions.source !== undefined && typeof functions.source !== 'string') {
+        throw new Error('pyric dev: firebase.json `functions.source` must be a string.');
+    }
+    const sourceDir = resolve(cwd, functions.source ?? 'functions');
+    const packageJsonPath = join(sourceDir, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        throw new Error(`pyric dev: Functions source is declared but ${packageJsonPath} does not exist.`);
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`pyric dev: failed to parse ${packageJsonPath}: ` +
+            `${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (packageJson.main !== undefined && typeof packageJson.main !== 'string') {
+        throw new Error(`pyric dev: ${packageJsonPath} \`main\` must be a string.`);
+    }
+    const entry = resolve(sourceDir, packageJson.main ?? 'index.js');
+    if (!existsSync(entry) || !statSync(entry).isFile()) {
+        throw new Error(`pyric dev: Functions entry does not exist: ${entry}`);
+    }
+    return { sourceDir, entry };
+}
+//# sourceMappingURL=project.js.map

package/dist/functions-rtdb/project.js.map

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

package/dist/functions-rtdb/projection.d.ts

@@ -0,0 +1,14 @@
+export interface RtdbSnapshotCommit {
+    path: string;
+    before: unknown;
+    after: unknown;
+}
+export interface CreatedValueProjection {
+    ref: string;
+    params: Record<string, string>;
+    value: unknown;
+}
+export declare function watchPath(reference: string): string;
+/** Project absent-to-present values for one v2 RTDB trigger reference. */
+export declare function projectValueCreates(reference: string, commit: RtdbSnapshotCommit): CreatedValueProjection[];
+//# sourceMappingURL=projection.d.ts.map

package/dist/functions-rtdb/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/projection.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;CAChB;AAuBD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,GACzB,sBAAsB,EAAE,CAmD1B"}

package/dist/functions-rtdb/projection.js

@@ -0,0 +1,65 @@
+import { normalizeRtdbReference, rtdbReferenceParamName, rtdbReferenceParts, } from './reference-pattern.js';
+function canonicalPath(path) {
+    const normalized = normalizeRtdbReference(path);
+    return normalized ? `/${normalized}` : '/';
+}
+function exists(value) {
+    return value !== null && value !== undefined;
+}
+function child(value, key) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    return Object.prototype.hasOwnProperty.call(value, key)
+        ? value[key]
+        : undefined;
+}
+function childKeys(value) {
+    if (typeof value !== 'object' || value === null)
+        return [];
+    return Object.keys(value).filter((key) => exists(child(value, key))).sort();
+}
+export function watchPath(reference) {
+    const literal = [];
+    for (const segment of rtdbReferenceParts(reference)) {
+        if (rtdbReferenceParamName(segment))
+            break;
+        literal.push(segment);
+    }
+    return canonicalPath(literal.join('/'));
+}
+/** Project absent-to-present values for one v2 RTDB trigger reference. */
+export function projectValueCreates(reference, commit) {
+    const pattern = rtdbReferenceParts(reference);
+    const committed = rtdbReferenceParts(commit.path);
+    if (committed.length > pattern.length)
+        return [];
+    const params = {};
+    for (let index = 0; index < committed.length; index += 1) {
+        const capture = rtdbReferenceParamName(pattern[index]);
+        if (capture)
+            params[capture] = committed[index];
+        else if (pattern[index] !== committed[index])
+            return [];
+    }
+    const projected = [];
+    const visit = (depth, before, after, concrete, captures) => {
+        if (depth === pattern.length) {
+            if (!exists(before) && exists(after)) {
+                projected.push({ ref: concrete.join('/'), params: captures, value: after });
+            }
+            return;
+        }
+        const segment = pattern[depth];
+        const capture = rtdbReferenceParamName(segment);
+        if (capture) {
+            for (const key of childKeys(after)) {
+                visit(depth + 1, child(before, key), child(after, key), [...concrete, key], { ...captures, [capture]: key });
+            }
+            return;
+        }
+        visit(depth + 1, child(before, segment), child(after, segment), [...concrete, segment], captures);
+    };
+    visit(committed.length, commit.before, commit.after, committed, params);
+    return projected;
+}
+//# sourceMappingURL=projection.js.map

package/dist/functions-rtdb/projection.js.map

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

package/dist/functions-rtdb/reference-pattern.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeRtdbReference(reference: string): string;
+export declare function rtdbReferenceParts(reference: string): string[];
+export declare function rtdbReferenceParamName(segment: string): string | null;
+export declare function supportsRtdbReference(reference: string): boolean;
+//# sourceMappingURL=reference-pattern.d.ts.map

package/dist/functions-rtdb/reference-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-pattern.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/reference-pattern.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMhE"}

package/dist/functions-rtdb/reference-pattern.js

@@ -0,0 +1,14 @@
+export function normalizeRtdbReference(reference) {
+    return reference.split('/').filter(Boolean).join('/');
+}
+export function rtdbReferenceParts(reference) {
+    const normalized = normalizeRtdbReference(reference);
+    return normalized ? normalized.split('/') : [];
+}
+export function rtdbReferenceParamName(segment) {
+    return /^\{([A-Za-z0-9_]+)(?:=\*)?\}$/.exec(segment)?.[1] ?? null;
+}
+export function supportsRtdbReference(reference) {
+    return rtdbReferenceParts(reference).every((segment) => rtdbReferenceParamName(segment) !== null || (!segment.includes('{') && !segment.includes('}') && !segment.includes('*')));
+}
+//# sourceMappingURL=reference-pattern.js.map

package/dist/functions-rtdb/reference-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-pattern.js","sourceRoot":"","sources":["../../src/functions-rtdb/reference-pattern.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CACrD,sBAAsB,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAC1C,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC3E,CACF,CAAC;AACJ,CAAC"}

package/dist/functions-rtdb/remote-delivery.d.ts

@@ -0,0 +1,9 @@
+import type { RemoteRtdb } from '../remote/index.js';
+import type { RtdbTriggerDelivery } from './delivery.js';
+/** Existing remote RTDB value subscriptions adapted to the execution seam. */
+export declare class RemoteRtdbTriggerDelivery implements RtdbTriggerDelivery {
+    #private;
+    constructor(rtdb: Pick<RemoteRtdb, 'onValue'>);
+    subscribe(path: string, listener: (value: unknown) => void, onError?: (error: unknown) => void): () => void;
+}
+//# sourceMappingURL=remote-delivery.d.ts.map

package/dist/functions-rtdb/remote-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-delivery.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/remote-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,8EAA8E;AAC9E,qBAAa,yBAA0B,YAAW,mBAAmB;;gBAGvD,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IAI7C,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,MAAM,IAAI;CAOd"}

package/dist/functions-rtdb/remote-delivery.js

@@ -0,0 +1,11 @@
+/** Existing remote RTDB value subscriptions adapted to the execution seam. */
+export class RemoteRtdbTriggerDelivery {
+    #rtdb;
+    constructor(rtdb) {
+        this.#rtdb = rtdb;
+    }
+    subscribe(path, listener, onError) {
+        return this.#rtdb.onValue(path, (snapshot) => listener(snapshot.value), onError);
+    }
+}
+//# sourceMappingURL=remote-delivery.js.map

package/dist/functions-rtdb/remote-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-delivery.js","sourceRoot":"","sources":["../../src/functions-rtdb/remote-delivery.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,OAAO,yBAAyB;IAC3B,KAAK,CAA8B;IAE5C,YAAY,IAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,SAAS,CACP,IAAY,EACZ,QAAkC,EAClC,OAAkC;QAElC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,IAAI,EACJ,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EACtC,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/pkg-version.d.ts

@@ -0,0 +1,2 @@
+export declare function cliVersion(): string;
+//# sourceMappingURL=pkg-version.d.ts.map

package/dist/pkg-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg-version.d.ts","sourceRoot":"","sources":["../src/pkg-version.ts"],"names":[],"mappings":"AAwBA,wBAAgB,UAAU,IAAI,MAAM,CAwBnC"}

package/dist/pkg-version.js

@@ -0,0 +1,47 @@
+/**
+ * @pyric/cli' OWN package version, resolved at runtime — the version-skew
+ * stamp both ends of the worker relay compare (integration-smoke fix: an old
+ * `pyric dev` accepting a newer client's frame and dying mid-handling used to
+ * surface as a bare 30s timeout with no hint).
+ *
+ * Resolution order:
+ *   1. A standalone `bun build --compile` binary's baked version
+ *      (`globalThis.__PYRIC_EMBEDDED__.version` — see serve/standalone-assets).
+ *   2. The nearest `package.json` walking up from THIS module (dist/ or src/),
+ *      i.e. the @pyric/cli install actually executing.
+ *   3. `'0.0.0'` when neither resolves (never throws).
+ *
+ * Node-only (node:fs / node:url) — do NOT import from browser-bundled modules
+ * (`bridge/protocol.ts`, the bridge client, worker code). The server
+ * (`bridge/server/peer.ts`) and the Node remote client (`remote/index.ts`)
+ * are the intended consumers.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+let cached = null;
+export function cliVersion() {
+    if (cached !== null)
+        return cached;
+    const embedded = globalThis.__PYRIC_EMBEDDED__;
+    if (typeof embedded?.version === 'string' && embedded.version.length > 0) {
+        cached = embedded.version;
+        return cached;
+    }
+    try {
+        let dir = dirname(fileURLToPath(import.meta.url));
+        while (!existsSync(join(dir, 'package.json'))) {
+            const parent = dirname(dir);
+            if (parent === dir)
+                break; // filesystem root
+            dir = parent;
+        }
+        const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        cached = pkg.version ?? '0.0.0';
+    }
+    catch {
+        cached = '0.0.0';
+    }
+    return cached;
+}
+//# sourceMappingURL=pkg-version.js.map

package/dist/pkg-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg-version.js","sourceRoot":"","sources":["../src/pkg-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,UAAU,UAAU;IACxB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,QAAQ,GACZ,UACD,CAAC,kBAAkB,CAAC;IACrB,IAAI,OAAO,QAAQ,EAAE,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM,CAAC,kBAAkB;YAC7C,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAErE,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/register/esm-exports.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Minimal `exports`-field walker for the CJS→ESM seam in
+ * `@pyric/cli/register`.
+ *
+ * Why it exists: a rewritten CJS `require('firebase-admin/app')` resolves
+ * `pyric-admin/app` under the `require` condition, but the pyric mirrors are
+ * ESM-only (`import`-condition exports) — Node's CJS resolver throws
+ * ERR_PACKAGE_PATH_NOT_EXPORTED and ignores hook-supplied condition
+ * overrides. `require(esm)` (Node ≥ 22.12) can LOAD the module fine once we
+ * hand it the file, so the register hook locates the package
+ * (`Module.findPackageJSON`) and resolves the subpath here under import
+ * conditions.
+ *
+ * Deliberately narrow, matching what the pyric packages actually publish:
+ * literal subpaths only (no `*` patterns), string targets, and nested
+ * condition objects tried in `node` → `import` → `default` order (`types`
+ * and unknown conditions are skipped).
+ */
+/**
+ * Resolve `subpath` (e.g. `'./app'`, or `'.'` for the root) against a
+ * package's `exports` field under import conditions. Returns the relative
+ * file target (e.g. `'./dist/app/index.js'`) or null when the subpath is
+ * not exported.
+ */
+export declare function resolveEsmOnlySubpath(exportsField: unknown, subpath: string): string | null;
+//# sourceMappingURL=esm-exports.d.ts.map

package/dist/register/esm-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-exports.d.ts","sourceRoot":"","sources":["../../src/register/esm-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmBH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAiBf"}

package/dist/register/esm-exports.js

@@ -0,0 +1,61 @@
+/**
+ * Minimal `exports`-field walker for the CJS→ESM seam in
+ * `@pyric/cli/register`.
+ *
+ * Why it exists: a rewritten CJS `require('firebase-admin/app')` resolves
+ * `pyric-admin/app` under the `require` condition, but the pyric mirrors are
+ * ESM-only (`import`-condition exports) — Node's CJS resolver throws
+ * ERR_PACKAGE_PATH_NOT_EXPORTED and ignores hook-supplied condition
+ * overrides. `require(esm)` (Node ≥ 22.12) can LOAD the module fine once we
+ * hand it the file, so the register hook locates the package
+ * (`Module.findPackageJSON`) and resolves the subpath here under import
+ * conditions.
+ *
+ * Deliberately narrow, matching what the pyric packages actually publish:
+ * literal subpaths only (no `*` patterns), string targets, and nested
+ * condition objects tried in `node` → `import` → `default` order (`types`
+ * and unknown conditions are skipped).
+ */
+const CONDITION_ORDER = ['node', 'import', 'default'];
+/** Resolve one condition object/string to its file target, or null. */
+function resolveTarget(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null || typeof value !== 'object')
+        return null;
+    for (const condition of CONDITION_ORDER) {
+        if (condition in value) {
+            const resolved = resolveTarget(value[condition] ?? null);
+            if (resolved !== null)
+                return resolved;
+        }
+    }
+    return null;
+}
+/**
+ * Resolve `subpath` (e.g. `'./app'`, or `'.'` for the root) against a
+ * package's `exports` field under import conditions. Returns the relative
+ * file target (e.g. `'./dist/app/index.js'`) or null when the subpath is
+ * not exported.
+ */
+export function resolveEsmOnlySubpath(exportsField, subpath) {
+    if (exportsField === null || exportsField === undefined)
+        return null;
+    if (typeof exportsField === 'string') {
+        return subpath === '.' ? exportsField : null;
+    }
+    if (typeof exportsField !== 'object')
+        return null;
+    const map = exportsField;
+    const keys = Object.keys(map);
+    const isSubpathMap = keys.every((k) => k === '.' || k.startsWith('./'));
+    if (!isSubpathMap) {
+        // Bare conditions object — describes the root subpath only.
+        return subpath === '.' ? resolveTarget(map) : null;
+    }
+    const entry = map[subpath];
+    if (entry === undefined)
+        return null;
+    return resolveTarget(entry);
+}
+//# sourceMappingURL=esm-exports.js.map

package/dist/register/esm-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-exports.js","sourceRoot":"","sources":["../../src/register/esm-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAE/D,uEAAuE;AACvE,SAAS,aAAa,CAAC,KAAmB;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC;YACzD,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAqB,EACrB,OAAe;IAEf,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,YAA4C,CAAC;IAEzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,4DAA4D;QAC5D,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,GAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/register/hooks.d.ts

@@ -0,0 +1,13 @@
+interface ResolveContext {
+    parentURL?: string;
+    conditions: string[];
+    importAttributes: Record<string, string>;
+}
+interface ResolveResult {
+    url: string;
+    format?: string | null;
+    shortCircuit?: boolean;
+}
+export declare function resolve(specifier: string, context: ResolveContext, nextResolve: (specifier: string, context?: ResolveContext) => Promise<ResolveResult>): Promise<ResolveResult>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/register/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/register/hooks.ts"],"names":[],"mappings":"AAYA,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AACD,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,GACnF,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/register/hooks.js

@@ -0,0 +1,15 @@
+/**
+ * `module.register()` fallback hooks — the ASYNC (loader-thread) variant of
+ * the specifier rewrite, used only on Node 22.x older than 22.15 where the
+ * sync `module.registerHooks` API doesn't exist yet.
+ *
+ * Runs on Node's loader thread, so it intercepts ESM `import` ONLY — CJS
+ * `require('firebase-admin')` is NOT rewritten on this path (index.ts logs
+ * a warning saying exactly that). Keep this module free of side effects and
+ * heavy imports: the loader thread re-instantiates it in isolation.
+ */
+import { mapFirebaseSpecifier } from './mapping.js';
+export function resolve(specifier, context, nextResolve) {
+    return nextResolve(mapFirebaseSpecifier(specifier) ?? specifier, context);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/register/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/register/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAapD,MAAM,UAAU,OAAO,CACrB,SAAiB,EACjB,OAAuB,EACvB,WAAoF;IAEpF,OAAO,WAAW,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,SAAS,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC"}

package/dist/register/index.d.ts

@@ -0,0 +1,5 @@
+/** Whether this process's firebase-admin/firebase imports are being rewritten
+ *  to the pyric sandbox — true only when `PYRIC_SANDBOX` was set (and not
+ *  refused by the production guard) at the moment this module loaded. */
+export declare let active: boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/register/index.ts"],"names":[],"mappings":"AAoIA;;yEAEyE;AACzE,eAAO,IAAI,MAAM,SAAQ,CAAC"}

package/dist/register/index.js

@@ -0,0 +1,124 @@
+/**
+ * `@pyric/cli/register` — the Node substitution seam (adoption layer 2).
+ *
+ * Loaded via `node --import @pyric/cli/register` (which `pyric dev` injects
+ * through NODE_OPTIONS), it makes the user's UNCHANGED `firebase-admin` /
+ * `firebase` imports resolve to `pyric-admin` / `pyric`, every subpath 1:1,
+ * and installs the sandbox-factory global that `pyric-admin`'s ambient
+ * `initializeApp()` consumes.
+ *
+ * ACTIVATOR, NOT LOCATOR (adoption-experience design): activation is purely
+ * the `PYRIC_SANDBOX` env var injected at invocation — never file presence,
+ * never app code. Without it this module is INERT (import it freely; nothing
+ * happens). Under `NODE_ENV=production` it REFUSES with one stderr line
+ * unless `PYRIC_SANDBOX_FORCE=1`. On activation it logs one stderr line.
+ *
+ * Hooks API: `module.registerHooks` (sync, Node ≥ 22.15) intercepts BOTH
+ * `require()` and `import`. On older 22.x it falls back to
+ * `module.register()` (ESM-only) with a warning that CJS require() is not
+ * rewritten.
+ */
+import Module from 'node:module';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { mapFirebaseSpecifier } from './mapping.js';
+import { resolveEsmOnlySubpath } from './esm-exports.js';
+import { remoteSandbox } from '../remote/index.js';
+/** The shared seam with pyric-admin's ambient init: a synchronous factory
+ *  returning the lazy branded handle. `Symbol.for` so both packages agree
+ *  without importing each other's types. */
+const SANDBOX_FACTORY = Symbol.for('pyric.remote.sandboxFactory');
+/** `module.registerHooks` landed in Node 22.15 / 23.5 — feature-detect
+ *  (typed locally: the repo's ambient node types predate it). */
+const moduleApi = Module;
+/**
+ * CJS→ESM seam: a rewritten `require()` fails against the pyric mirrors'
+ * `import`-condition-only exports (the CJS resolver ignores hook-supplied
+ * condition overrides), even though `require(esm)` can load them fine.
+ * Locate the package from this installed CLI and resolve the subpath under
+ * import conditions ourselves. The user's function package is not required
+ * to install Pyric's mapped targets. Returns the resolved file URL, or null
+ * to rethrow the original error.
+ */
+function resolveEsmOnlyForRequire(mapped) {
+    if (typeof moduleApi.findPackageJSON !== 'function')
+        return null;
+    const slash = mapped.indexOf('/');
+    const pkgName = slash === -1 ? mapped : mapped.slice(0, slash);
+    const subpath = slash === -1 ? '.' : `.${mapped.slice(slash)}`;
+    let pkgJsonPath;
+    try {
+        pkgJsonPath = moduleApi.findPackageJSON(pkgName, import.meta.url);
+    }
+    catch {
+        return null;
+    }
+    if (!pkgJsonPath)
+        return null;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+        const target = resolveEsmOnlySubpath(pkg.exports, subpath);
+        if (!target)
+            return null;
+        return pathToFileURL(join(dirname(pkgJsonPath), target)).href;
+    }
+    catch {
+        return null;
+    }
+}
+function activate() {
+    if (typeof moduleApi.registerHooks === 'function') {
+        moduleApi.registerHooks({
+            resolve(specifier, context, nextResolve) {
+                const mapped = mapFirebaseSpecifier(specifier);
+                if (mapped === null)
+                    return nextResolve(specifier, context);
+                try {
+                    return nextResolve(mapped, { ...context, parentURL: import.meta.url });
+                }
+                catch (err) {
+                    // CJS `require('firebase-admin/app')` resolves under the `require`
+                    // condition, but the pyric mirrors are ESM-only. Resolve the file
+                    // under import conditions ourselves — require(esm) (Node ≥ 22.12)
+                    // loads it fine once given the URL.
+                    const code = err.code;
+                    if (code === 'ERR_PACKAGE_PATH_NOT_EXPORTED' || code === 'MODULE_NOT_FOUND') {
+                        const url = resolveEsmOnlyForRequire(mapped);
+                        if (url)
+                            return { url, shortCircuit: true };
+                    }
+                    throw err;
+                }
+            },
+        });
+    }
+    else {
+        process.stderr.write('@pyric/cli/register: this Node version lacks module.registerHooks (needs >= 22.15) — ' +
+            'falling back to module.register: ESM imports of firebase-admin/firebase are rewritten, ' +
+            "but CJS require('firebase-admin') is NOT intercepted. Upgrade Node to >= 22.15 for full coverage.\n");
+        moduleApi.register?.(new URL('./hooks.js', import.meta.url));
+    }
+    // The factory global — exact contract shared with pyric-admin's ambient
+    // init: synchronous, returns the lazy branded handle.
+    globalThis[SANDBOX_FACTORY] = (opts) => remoteSandbox(opts);
+    process.stderr.write(`@pyric/cli/register: active — firebase-admin/firebase imports now resolve to the ` +
+        `pyric sandbox (PYRIC_SANDBOX=${process.env.PYRIC_SANDBOX}).\n`);
+}
+/** Whether this process's firebase-admin/firebase imports are being rewritten
+ *  to the pyric sandbox — true only when `PYRIC_SANDBOX` was set (and not
+ *  refused by the production guard) at the moment this module loaded. */
+export let active = false;
+if (process.env.PYRIC_SANDBOX) {
+    if (process.env.NODE_ENV === 'production' && process.env.PYRIC_SANDBOX_FORCE !== '1') {
+        process.stderr.write('@pyric/cli/register: refusing to activate under NODE_ENV=production — ' +
+            'firebase-admin/firebase imports are NOT rewritten. ' +
+            'Set PYRIC_SANDBOX_FORCE=1 to override (dev/CI only).\n');
+    }
+    else {
+        activate();
+        active = true;
+    }
+}
+// No PYRIC_SANDBOX → inert by design: importing this module rewrites nothing.
+//# sourceMappingURL=index.js.map

package/dist/register/index.js.map

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

package/dist/register/mapping.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The specifier map behind `@pyric/cli/register`: unmodified Firebase
+ * imports resolve to their pyric mirrors. Most subpaths map 1:1
+ * (`firebase-admin/app` → `pyric-admin/app`, `firebase/firestore` →
+ * `pyric/firestore`, …). `firebase/app` maps to the Node register adapter,
+ * which translates FirebaseOptions into the process sandbox before entering
+ * the strict `pyric/app` mirror.
+ *
+ * Pure — the resolution hooks (index.ts / hooks.ts) call this and the unit
+ * suite exercises it directly. Deliberately narrow: only the two package
+ * roots match. `@firebase/*` internals, `firebase-functions`, and anything
+ * merely *containing* "firebase" pass through untouched.
+ */
+/**
+ * Map a Firebase specifier to its pyric mirror, or return `null` when the
+ * specifier is not a Firebase package (leave it for the default resolver).
+ */
+export declare function mapFirebaseSpecifier(specifier: string): string | null;
+//# sourceMappingURL=mapping.d.ts.map