pyric-tools 0.1.0-alpha.7

package/dist/cli/dev-runner.js

@@ -0,0 +1,227 @@
+/**
+ * The `pyric dev` child runner — "one command, not two" (adoption design):
+ * after the host is up, run the user's OWN dev command with the environment
+ * activated so their unchanged firebase-admin/firebase imports resolve to the
+ * pyric sandbox:
+ *
+ *   PYRIC_SANDBOX=remote:<serve url>          (the activator)
+ *   NODE_OPTIONS += --import pyric-tools/register   (the substitution seam)
+ *
+ * Child-command precedence: explicit `pyric dev -- <cmd>` wins; else the
+ * project package.json `dev` script (via the detected package manager); else
+ * host-only (today's behavior). `--no-run` forces host-only; `--json`
+ * defaults to host-only (an explicit `--` still wins — agents can opt in).
+ *
+ * Everything decision-shaped here is pure and exported for the unit suite;
+ * only `spawnDevChild` touches the process table.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── First-run race guard ───────────────────────────────────────────────────
+/**
+ * Wait (bounded) for a browser tab to register as the bridge's sandbox peer
+ * before the child spawns. `pyric dev` opens the tab and spawns the child in
+ * the same breath; a child whose first line is a sandbox op otherwise races
+ * the tab's boot and dies on the no-tab fail-fast — the exact first-run of
+ * the two-command story. Polls `/__pyric/health` (`sandboxConnected`).
+ *
+ * Returns true when a peer connected, false on timeout (caller warns and
+ * spawns anyway — the child may not touch the sandbox at all). Injectable
+ * clock/fetch for the unit suite.
+ */
+export async function waitForSandboxPeer(serveUrl, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 30_000;
+    const intervalMs = opts.intervalMs ?? 250;
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const res = await fetchImpl(`${serveUrl.replace(/\/$/, '')}/__pyric/health`);
+            if (res.ok) {
+                const health = (await res.json());
+                if (health.sandboxConnected === true)
+                    return true;
+            }
+        }
+        catch {
+            // Health not up yet — keep polling until the deadline.
+        }
+        if (Date.now() >= deadline)
+            return false;
+        await sleep(intervalMs);
+    }
+}
+/** Lockfile sniff, mirroring how init/vendor pick their install hints. */
+export function detectPackageManager(cwd) {
+    if (existsSync(join(cwd, 'bun.lock')) || existsSync(join(cwd, 'bun.lockb')))
+        return 'bun';
+    if (existsSync(join(cwd, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(join(cwd, 'yarn.lock')))
+        return 'yarn';
+    return 'npm';
+}
+/** The project's `dev` script, or null (no package.json / no script). */
+export function readDevScript(cwd) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
+        const dev = pkg.scripts?.dev;
+        return typeof dev === 'string' && dev.trim().length > 0 ? dev : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Decide what (if anything) to run after the host is up.
+ *
+ * Matrix:
+ *   --no-run                → null, always
+ *   `-- <cmd>`              → that command (wins over everything else)
+ *   --json (no `--`)        → null (machine mode defaults to host-only)
+ *   package.json dev script → `<pm> run dev`
+ *   none of the above       → null (host-only, today's behavior)
+ *
+ * A `dev` script that itself invokes `pyric dev` is treated as absent —
+ * running it would recurse forever (pyric dev → npm run dev → pyric dev …).
+ */
+export function resolveDevChild(opts) {
+    if (opts.noRun)
+        return null;
+    if (opts.passthrough.length > 0) {
+        return { argv: [...opts.passthrough], label: opts.passthrough.join(' ') };
+    }
+    if (opts.json)
+        return null;
+    if (opts.devScript && !/(^|[\s;&|])pyric\s+dev\b/.test(opts.devScript)) {
+        const label = `${opts.packageManager} run dev`;
+        return { argv: [opts.packageManager, 'run', 'dev'], label };
+    }
+    return null;
+}
+// ─── Environment for the child (pure) ──────────────────────────────────────
+/**
+ * The absolute `file:` URL of the register module, resolved from
+ * pyric-tools' OWN installed location — `import.meta.resolve` walks this
+ * package's `exports` (self-reference), so it lands on the right file no
+ * matter how the user's node_modules are laid out (hoisted, pnpm-isolated,
+ * vendored). Fallback: relative to this compiled file (dist/cli/ →
+ * dist/register/), for runtimes without a usable import.meta.resolve.
+ */
+export function registerModuleUrl() {
+    try {
+        const url = import.meta.resolve('pyric-tools/register');
+        if (typeof url === 'string' && url.length > 0)
+            return url;
+    }
+    catch {
+        // fall through
+    }
+    return new URL('../register/index.js', import.meta.url).href;
+}
+/**
+ * Child env: sets the activator and APPENDS the loader to NODE_OPTIONS —
+ * never replaces it (the user's own --inspect / --max-old-space-size etc.
+ * must survive). `file:` URLs are percent-encoded, so no quoting is needed
+ * even for paths with spaces.
+ */
+export function buildChildEnv(base, opts) {
+    const importFlag = `--import ${opts.registerUrl}`;
+    return {
+        ...base,
+        PYRIC_SANDBOX: `remote:${opts.serveUrl}`,
+        NODE_OPTIONS: base.NODE_OPTIONS ? `${base.NODE_OPTIONS} ${importFlag}` : importFlag,
+    };
+}
+// ─── Line prefixing (pure core) ────────────────────────────────────────────
+/**
+ * Incremental line prefixer: every child output line gets `[dev] `, partial
+ * lines are buffered until their newline (or flush at stream end).
+ */
+export function createLinePrefixer(prefix, write) {
+    let buffer = '';
+    return {
+        push(chunk) {
+            buffer += chunk;
+            let nl;
+            while ((nl = buffer.indexOf('\n')) !== -1) {
+                write(`${prefix}${buffer.slice(0, nl)}\n`);
+                buffer = buffer.slice(nl + 1);
+            }
+        },
+        flush() {
+            if (buffer.length > 0) {
+                write(`${prefix}${buffer}\n`);
+                buffer = '';
+            }
+        },
+    };
+}
+/** How long a signalled child may linger before SIGKILL. */
+const FORCE_KILL_AFTER_MS = 2_000;
+/**
+ * Spawn the child with inherited stdin and `[dev]`-prefixed stdout/stderr.
+ * In `--json` mode ALL child output goes to stderr — stdout carries exactly
+ * the one machine line (the serve --json contract).
+ */
+export function spawnDevChild(plan, opts) {
+    const [command, ...args] = plan.argv;
+    const child = spawn(command, args, {
+        cwd: opts.cwd,
+        env: opts.env,
+        stdio: ['inherit', 'pipe', 'pipe'],
+    });
+    const outTarget = opts.json ? process.stderr : process.stdout;
+    const out = createLinePrefixer('[dev] ', (line) => outTarget.write(line));
+    const err = createLinePrefixer('[dev] ', (line) => process.stderr.write(line));
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (chunk) => out.push(chunk));
+    child.stderr?.on('data', (chunk) => err.push(chunk));
+    let signalled = false;
+    let forceTimer = null;
+    const exited = new Promise((resolve) => {
+        child.once('error', (e) => {
+            process.stderr.write(`pyric dev: failed to run \`${plan.label}\`: ${e.message}\n`);
+            resolve(1);
+        });
+        child.once('exit', (code, signal) => {
+            out.flush();
+            err.flush();
+            if (forceTimer)
+                clearTimeout(forceTimer);
+            // User-initiated stop (Ctrl-C forwarded) is a clean shutdown → 0.
+            if (signalled)
+                resolve(0);
+            else if (typeof code === 'number')
+                resolve(code);
+            else
+                resolve(signal ? 1 : 0);
+        });
+    });
+    return {
+        exited,
+        child,
+        signal(sig) {
+            if (child.exitCode !== null || signalled)
+                return;
+            signalled = true;
+            try {
+                child.kill(sig);
+            }
+            catch {
+                return;
+            }
+            forceTimer = setTimeout(() => {
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch { }
+            }, FORCE_KILL_AFTER_MS);
+            forceTimer.unref();
+        },
+    };
+}
+//# sourceMappingURL=dev-runner.js.map

package/dist/cli/dev-runner.js.map

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

package/dist/cli/discover.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `pyric firestore:discover [collection?]` — thin wrapper over
+ * `pyric-tools/discover`'s `crawl` against the project's Firestore.
+ *
+ * Uses the REST-backed `CrawlerFirestore` so this works from any Node
+ * environment with a service-account token (no firebase-admin
+ * required at runtime).
+ *
+ * An optional positional `collection` narrows the crawl via the
+ * crawler's `rootFilter` — useful for "tell me about this one
+ * collection" probes that don't want to walk the whole tree.
+ *
+ * Prints the discovered schema (templatePath → CollectionSchema map)
+ * as JSON.
+ */
+import { crawl, type CrawlerFirestore } from '../discover/index.js';
+import type { ParsedArgs } from './parse-args.js';
+import type { ProjectScope } from '../deploy/index.js';
+import { readFirebaseRc } from './firebase-json.js';
+export interface DiscoverDeps {
+    resolveScope?: (opts: {
+        projectId?: string;
+    }) => Promise<{
+        scope: ProjectScope;
+        source: string;
+    }>;
+    /**
+     * Build a CrawlerFirestore from a scope + token. Defaults to
+     * `createRestCrawlerFirestore`; tests pass a stub here to avoid
+     * real RPCs.
+     */
+    createFirestore?: (opts: {
+        accessToken: string;
+        projectId: string;
+    }) => CrawlerFirestore;
+    crawl?: typeof crawl;
+    readFirebaseRc?: typeof readFirebaseRc;
+    cwd?: string;
+    stdout?: {
+        write(s: string): void;
+    };
+    stderr?: {
+        write(s: string): void;
+    };
+}
+export declare function runFirestoreDiscover(parsed: ParsedArgs, deps?: DiscoverDeps): Promise<number>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/cli/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/cli/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,EAGL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,CAAC;IACzF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACrC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,CAoEjB"}

package/dist/cli/discover.js

@@ -0,0 +1,77 @@
+/**
+ * `pyric firestore:discover [collection?]` — thin wrapper over
+ * `pyric-tools/discover`'s `crawl` against the project's Firestore.
+ *
+ * Uses the REST-backed `CrawlerFirestore` so this works from any Node
+ * environment with a service-account token (no firebase-admin
+ * required at runtime).
+ *
+ * An optional positional `collection` narrows the crawl via the
+ * crawler's `rootFilter` — useful for "tell me about this one
+ * collection" probes that don't want to walk the whole tree.
+ *
+ * Prints the discovered schema (templatePath → CollectionSchema map)
+ * as JSON.
+ */
+import { crawl, createRestCrawlerFirestore, } from '../discover/index.js';
+import { resolveScope } from './scope.js';
+import { readFirebaseRc } from './firebase-json.js';
+export async function runFirestoreDiscover(parsed, deps = {}) {
+    const out = deps.stdout ?? process.stdout;
+    const err = deps.stderr ?? process.stderr;
+    const flagProject = parsed.flags.get('project');
+    const explicit = typeof flagProject === 'string' ? flagProject : undefined;
+    let projectIdHint = explicit;
+    if (!projectIdHint) {
+        const rcRead = deps.readFirebaseRc ?? readFirebaseRc;
+        const rc = await rcRead(deps.cwd ?? process.cwd()).catch(() => null);
+        projectIdHint = rc?.projects?.default ?? undefined;
+    }
+    let scope;
+    try {
+        const resolveScopeFn = deps.resolveScope ?? resolveScope;
+        const resolved = await resolveScopeFn({ projectId: projectIdHint });
+        scope = resolved.scope;
+    }
+    catch (e) {
+        err.write(`${e instanceof Error ? e.message : String(e)}\n`);
+        return 1;
+    }
+    let token;
+    try {
+        token = await scope.resolveToken();
+    }
+    catch (e) {
+        err.write(`pyric firestore:discover: failed to resolve access token: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 2;
+    }
+    const createFirestoreFn = deps.createFirestore ?? createRestCrawlerFirestore;
+    const db = createFirestoreFn({ accessToken: token, projectId: scope.projectId });
+    const collectionFilter = parsed.positional[0];
+    const options = collectionFilter
+        ? { rootFilter: (id) => id === collectionFilter }
+        : {};
+    const crawlFn = deps.crawl ?? crawl;
+    try {
+        const result = await crawlFn(db, options);
+        // Convert the Map<string, CollectionSchema> into a plain object
+        // for JSON serialization. Maps don't survive `JSON.stringify`
+        // — they emit `{}` without explicit conversion.
+        const schemaByTemplate = {};
+        for (const [k, v] of result.finalizedSchemas) {
+            schemaByTemplate[k] = v;
+        }
+        out.write(`${JSON.stringify({
+            complete: result.complete,
+            listOps: result.listOps,
+            readOps: result.readOps,
+            schemaByTemplate,
+        }, null, 2)}\n`);
+        return 0;
+    }
+    catch (e) {
+        err.write(`pyric firestore:discover: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 2;
+    }
+}
+//# sourceMappingURL=discover.js.map

package/dist/cli/discover.js.map

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

package/dist/cli/firebase-json.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Minimal `firebase.json` / `.firebaserc` reader for the CLI.
+ *
+ * Surfaces only the fields the subcommands actually touch — the
+ * full firebase.json schema is huge and a full parse isn't needed
+ * for any current subcommand. New fields land alongside the
+ * subcommand that consumes them.
+ *
+ * `.firebaserc` carries the project id under `projects.default`;
+ * the standard Firebase CLI uses the same convention.
+ */
+export interface FirebaseJson {
+    firestore?: {
+        rules?: string;
+        indexes?: string;
+        database?: string;
+    };
+    /** Realtime Database rules path plus optional explicit instance URL. */
+    database?: {
+        rules?: string;
+        url?: string;
+    };
+    hosting?: unknown;
+    functions?: unknown;
+    /** Storage rules + (optional) target bucket. A single object, or an array for
+     *  multi-bucket projects. `rules` is a path; `bucket` overrides the default
+     *  `{projectId}.firebasestorage.app`. */
+    storage?: {
+        rules?: string;
+        bucket?: string;
+    } | Array<{
+        rules?: string;
+        bucket?: string;
+    }>;
+}
+export interface FirebaseRc {
+    projects?: {
+        default?: string;
+        [alias: string]: string | undefined;
+    };
+    /**
+     * Deploy-target maps, keyed project → resource type → target name →
+     * resource ids (mirrors firebase-tools' RCData,
+     * clones/firebase-tools/src/rc.ts:28-36). Only `hosting` (target →
+     * site ids) is consumed today.
+     */
+    targets?: {
+        [projectId: string]: {
+            [targetType: string]: {
+                [targetName: string]: string[] | undefined;
+            } | undefined;
+        } | undefined;
+    };
+}
+/**
+ * Read + parse `firebase.json` from `cwd`. Throws when missing — every
+ * subcommand that needs project metadata expects a present file.
+ */
+export declare function readFirebaseJson(cwd?: string): Promise<FirebaseJson>;
+/**
+ * Read + parse `.firebaserc` from `cwd`. Returns null when missing —
+ * the project id can also come from `--project` / `PYRIC_PROJECT`, so
+ * absence is not fatal at this layer.
+ */
+export declare function readFirebaseRc(cwd?: string): Promise<FirebaseRc | null>;
+//# sourceMappingURL=firebase-json.d.ts.map

package/dist/cli/firebase-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-json.d.ts","sourceRoot":"","sources":["../../src/cli/firebase-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,wEAAwE;IACxE,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;6CAEyC;IACzC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACrC,CAAC;IACF;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QACR,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,CAAC,UAAU,EAAE,MAAM,GAAG;gBACpB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;aAC5C,GAAG,SAAS,CAAC;SACf,GAAG,SAAS,CAAC;KACf,CAAC;CACH;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkBzF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgB5F"}

package/dist/cli/firebase-json.js

@@ -0,0 +1,60 @@
+/**
+ * Minimal `firebase.json` / `.firebaserc` reader for the CLI.
+ *
+ * Surfaces only the fields the subcommands actually touch — the
+ * full firebase.json schema is huge and a full parse isn't needed
+ * for any current subcommand. New fields land alongside the
+ * subcommand that consumes them.
+ *
+ * `.firebaserc` carries the project id under `projects.default`;
+ * the standard Firebase CLI uses the same convention.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Read + parse `firebase.json` from `cwd`. Throws when missing — every
+ * subcommand that needs project metadata expects a present file.
+ */
+export async function readFirebaseJson(cwd = process.cwd()) {
+    const path = join(cwd, 'firebase.json');
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            throw new Error(`pyric: no firebase.json found at ${path}. Run \`pyric init\` to scaffold one.`);
+        }
+        throw e;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`pyric: failed to parse firebase.json: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * Read + parse `.firebaserc` from `cwd`. Returns null when missing —
+ * the project id can also come from `--project` / `PYRIC_PROJECT`, so
+ * absence is not fatal at this layer.
+ */
+export async function readFirebaseRc(cwd = process.cwd()) {
+    const path = join(cwd, '.firebaserc');
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT')
+            return null;
+        throw e;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`pyric: failed to parse .firebaserc: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+//# sourceMappingURL=firebase-json.js.map

package/dist/cli/firebase-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-json.js","sourceRoot":"","sources":["../../src/cli/firebase-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyCjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACxC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,uCAAuC,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,yCAAyC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChE,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,uCAAuC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * `pyric` CLI — front door to the bridge + project tooling.
+ *
+ * Subcommands:
+ *   pyric bridge [--mode sandbox|prod] [--port N] [--project ID] …
+ *   pyric dev [--port N] [--host H] [--no-cache] [--bridge] [--ui] [--seed FILE] [--no-watch] [--no-open] [--no-capture] [--no-run] [--json] [--persist] [--fresh] [-- <cmd>]
+ *   pyric init [dir] [--template web|node] [--name N] [--force] [--json]
+ *   pyric vendor [dir] [--json]
+ *   pyric snapshot [--out FILE] [--port N] [--force] [--json] [--include-passwords]
+ *   pyric mcp
+ *   pyric deploy <rules|indexes|database|hosting|functions>
+ *   pyric hosting:channel:deploy <channelId> [--expires <ttl>]
+ *   pyric rules:lint <path>
+ *   pyric rules:validate <path>
+ *   pyric rules:simulate [--stdin]
+ *   pyric database:rules:lint <path>
+ *   pyric database:rules:validate <path>
+ *   pyric database:rules:simulate [--stdin]
+ *   pyric auth:configure-provider <provider> <true|false>
+ *   pyric auth:manage-domains <add|remove|list> [domain]
+ *   pyric firestore:discover [collection]
+ *   pyric login [--ci]
+ *   pyric logout
+ *   pyric whoami
+ *   pyric --help
+ *   pyric --version
+ *
+ * Env vars:
+ *   PYRIC_MODE                       — 'sandbox' (default) or 'prod' (bridge)
+ *   PYRIC_PORT                       — bridge port (default 5174)
+ *   PYRIC_PROJECT                    — project id (sandbox: any; prod: Firebase project id)
+ *   PYRIC_VERBOSE                    — set to 1 for per-tool-call logging
+ *   FIREBASE_SA_BASE64               — base64-encoded service-account JSON (deploy / auth / discover)
+ *   GOOGLE_APPLICATION_CREDENTIALS   — path to service-account JSON (deploy / auth / discover)
+ *   FIREBASE_DATABASE_URL            — Realtime Database URL for deploy database
+ *   PYRIC_OAUTH_CLIENT_ID            — Google "Desktop app" OAuth client id (pyric login)
+ *   PYRIC_OAUTH_CLIENT_SECRET        — its client secret (pyric login; required by Google)
+ *   PYRIC_REFRESH_TOKEN              — CI refresh token from `pyric login --ci`
+ *
+ * Exit codes:
+ *   0  success
+ *   1  usage error
+ *   2  runtime error
+ */
+import { type ParsedArgs } from './parse-args.js';
+/**
+ * Dispatch a parsed CLI invocation to its subcommand handler.
+ * Exported so the test suite can drive the dispatcher directly
+ * without spawning a child process. `process.exit` is not called
+ * here — the caller (the top-level `main()` below) does that.
+ */
+export declare function dispatch(parsed: ParsedArgs): Promise<number>;
+export { parseArgs } from './parse-args.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkY7D;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA8DlE;AAQD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}