pyric-tools 0.1.0-alpha.7

package/dist/cli/deploy.js

@@ -0,0 +1,413 @@
+/**
+ * `pyric deploy [target]` — thin wrapper over `pyric-tools/deploy`'s
+ * programmatic surface. Reads `firebase.json` for paths (rules /
+ * indexes / hosting); resolves the project id from `--project` /
+ * `PYRIC_PROJECT` / `.firebaserc`; resolves a service-account scope
+ * from env.
+ *
+ * Supported targets come from the deploy provider registry (`rules`, `indexes`,
+ * `database`, `hosting`, `functions`, `storage`, ...).
+ * `functions` requires `--source <dir>` and a JSON-formatted
+ * `--config` (FunctionDeployConfig[]); this is the minimum to make
+ * the CLI a real handle on the library — extras (multi-function
+ * config files, watch mode, etc.) land in follow-ups.
+ *
+ * Every handler returns an exit code so the dispatcher can `process.exit`
+ * with the correct value:
+ *   0 — deploy succeeded
+ *   1 — usage error (bad/missing flag, no firebase.json, …)
+ *   2 — runtime / API error (auth failed, API non-2xx, …)
+ */
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { readFirebaseJson, readFirebaseRc } from './firebase-json.js';
+import { resolveScope } from './scope.js';
+import { ensureScope } from '../credentials/node/ensure-scope.js';
+import { providerByTarget } from '../deploy/registry.js';
+import { ensureApisEnabled } from '../deploy/api-enablement.js';
+import { createDeployReporter } from './deploy-progress.js';
+// ─── Agent I/O seam (A6) ─────────────────────────────────────────────
+//
+// The ToolHandler IS the schema — no hand-authored copy. Three knobs,
+// generic over deploy targets:
+//   --schema           print the tool's `parameters` JSON Schema, exit 0
+//   --json '<payload>' validate against that schema, feed the handler
+//                      DIRECTLY (firebase.json / hosting flags are
+//                      bypassed; project + credential resolution still
+//                      applies), print {ok, summary, data} as JSON
+//   --json             (bare) machine output for a normal resolved deploy
+//                      (mirror of firebase-tools' global -j/--json,
+//                      clones/firebase-tools/src/index.ts:16)
+export async function runDeploy(parsed, deps = {}) {
+    const out = deps.stdout ?? process.stdout;
+    const err = deps.stderr ?? process.stderr;
+    const cwd = deps.cwd ?? process.cwd();
+    const fjRead = deps.readFirebaseJson ?? readFirebaseJson;
+    const rcRead = deps.readFirebaseRc ?? readFirebaseRc;
+    const resolveScopeFn = deps.resolveScope ?? resolveScope;
+    const readFileFn = deps.readFile ?? readFile;
+    const targets = [...providerByTarget.keys()];
+    const target = parsed.positional[0];
+    if (!target) {
+        err.write(`pyric deploy: missing target. Usage: pyric deploy <${targets.join('|')}>\n`);
+        return 1;
+    }
+    const provider = providerByTarget.get(target);
+    if (!provider) {
+        err.write(`pyric deploy: unknown target '${target}'. Must be one of ${targets.join(', ')}.\n`);
+        return 1;
+    }
+    const flagJson = parsed.flags.get('json');
+    const machineOutput = flagJson !== undefined;
+    const jsonPayload = typeof flagJson === 'string' ? flagJson : undefined;
+    if (parsed.flags.get('schema') !== undefined) {
+        return printToolSchema(provider, deps, out, err);
+    }
+    // A direct payload bypasses firebase.json entirely — the payload is
+    // the whole tool input. Project + credential resolution below still
+    // applies (precedence: --json payload fields > everything else).
+    let firebaseJson = {};
+    if (jsonPayload === undefined) {
+        try {
+            firebaseJson = await fjRead(cwd);
+        }
+        catch (e) {
+            err.write(`${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    const flagProject = parsed.flags.get('project');
+    const explicitProject = typeof flagProject === 'string' ? flagProject : undefined;
+    const rc = await rcRead(cwd).catch(() => null);
+    // --project accepts a .firebaserc alias or a literal project id —
+    // mirror of firebase-tools' resolveAlias (`projects[alias] || alias`,
+    // clones/firebase-tools/src/rc.ts:79-81).
+    let projectIdHint = explicitProject;
+    if (projectIdHint && rc?.projects?.[projectIdHint]) {
+        projectIdHint = rc.projects[projectIdHint];
+    }
+    if (!projectIdHint) {
+        projectIdHint = rc?.projects?.default ?? undefined;
+    }
+    let scope;
+    let grantedScopes = 'all';
+    try {
+        const resolved = await resolveScopeFn({ projectId: projectIdHint });
+        scope = resolved.scope;
+        grantedScopes = resolved.grantedScopes ?? 'all';
+        // Machine-output mode keeps stdout pure JSON — the banner moves to
+        // stderr (same convention as `pyric dev --json`).
+        (machineOutput ? err : out).write(`pyric deploy: using project '${scope.projectId}' (credentials: ${resolved.source})\n`);
+    }
+    catch (e) {
+        err.write(`${e instanceof Error ? e.message : String(e)}\n`);
+        return 1;
+    }
+    if (jsonPayload !== undefined) {
+        return executeJsonPayload(jsonPayload, provider, scope, deps, out, err);
+    }
+    // Scope-upgrade preflight (logged-in users only; a service account is 'all').
+    // A user lacking this target's scope is re-authorized before dispatch (so the
+    // login UI never overlaps the deploy board); a non-interactive session fails fast.
+    const ensured = await ensureScope({
+        requiredScope: provider.requiredScope,
+        target,
+        scope,
+        grantedScopes,
+        interactive: !machineOutput && deps.stdout === undefined && process.stdout.isTTY === true,
+        env: process.env,
+        out,
+        err,
+        authorizer: deps.loginAuthorizer,
+        store: deps.credentialStore,
+        client: deps.oauthClient,
+    });
+    if (!ensured.ok)
+        return ensured.exit;
+    scope = ensured.scope;
+    // Every target is a registered provider; the dispatcher owns config
+    // resolution, the unit loop, exit aggregation, and the live reporter.
+    return runProviderDeploy(provider, {
+        firebaseJson,
+        firebaseRc: rc,
+        flags: singleValueFlags(parsed.flags),
+        projectId: scope.projectId,
+        cwd,
+        env: deps.env ?? process.env,
+        readFile: (p) => readFileFn(p, 'utf-8'),
+        getGitBranch: () => (deps.getGitBranch ?? getGitBranch)(cwd),
+    }, resolveDeployTools(provider, scope, deps), 
+    // API-enablement preflight, run by the dispatcher AFTER config resolution so
+    // a usage error (e.g. missing --source) still exits 1 before any network
+    // call. Auto-enables the target's APIs when the caller has permission, else
+    // prints console links + fails fast. See design rationale
+    () => (deps.ensureApis ?? ensureApisEnabled)({
+        scope,
+        apis: provider.requiredApis,
+        out: machineOutput ? err : out,
+        err,
+    }), out, err, machineOutput, deps.stdout === undefined && process.stdout.isTTY === true);
+}
+function singleValueFlags(flags) {
+    const out = new Map();
+    for (const [key, value] of flags) {
+        out.set(key, Array.isArray(value) ? value[value.length - 1] ?? true : value);
+    }
+    return out;
+}
+function defaultOperation(provider) {
+    return provider.operations.find((o) => o.default) ?? provider.operations[0];
+}
+/**
+ * Resolve a provider's tools, honoring the per-target test-injection overrides
+ * the CLI suite uses (`deps.createXxxDeployTools`). Production passes none, so the
+ * provider's own factory runs. This is the legacy DI seam; the providers own
+ * their factories, this just lets tests swap a fake in.
+ */
+function resolveDeployTools(provider, scope, deps) {
+    const override = provider.target === 'functions'
+        ? deps.createFunctionsDeployTools
+        : provider.target === 'hosting'
+            ? deps.createHostingDeployTools
+            : provider.target === 'rules' || provider.target === 'indexes'
+                ? deps.createFirestoreDeployTools
+                : provider.target === 'database'
+                    ? deps.createRtdbDeployTools
+                    : undefined;
+    return override ? override({ scope }) : provider.tools(scope);
+}
+/**
+ * Dispatch a registered provider (the strangler-fig path). Resolve config, then
+ * run each unit through the provider's handler. A usage error exits 1 BEFORE any
+ * network call; a unit's runtime failure continues the remaining units and exits
+ * 2 (matching the if-ladder's exit-2 accumulation). The reporter seam
+ * (`ctx.report`) is wired with the TTY board in slice 2 — functions emits no
+ * steps yet, so behavior here is byte-identical to the old `functions` branch.
+ */
+async function runProviderDeploy(provider, src, tools, runApiPreflight, out, err, machineOutput, isTTY) {
+    const op = defaultOperation(provider);
+    if (!op) {
+        err.write(`pyric deploy ${provider.target}: provider exposes no operations.\n`);
+        return 2;
+    }
+    const reporter = createDeployReporter({ out, err, machineOutput, isTTY });
+    let exit = 0;
+    try {
+        const resolved = await provider.resolveConfig(op.name, src);
+        if (!resolved.ok) {
+            // Usage error (missing/invalid config) — exit 1 before any network call.
+            err.write(`pyric deploy ${provider.target}: ${resolved.message}\n`);
+            reporter.dispose();
+            return 1;
+        }
+        // Config warnings (e.g. hosting's non-serving keys) print up front. A config
+        // READ error (a missing rules file) throws and is caught below as exit 2.
+        for (const warning of resolved.warnings ?? []) {
+            err.write(`pyric deploy ${provider.target}: warning: ${warning}\n`);
+        }
+        // Config is valid: ensure the target's Google APIs are enabled before the
+        // first mutation. Runs here (after resolveConfig) so a usage error never
+        // triggers a network call.
+        const apis = await runApiPreflight();
+        if (!apis.ok) {
+            reporter.dispose();
+            return apis.exit ?? 2;
+        }
+        const handler = tools.find((t) => t.name === op.toolName);
+        if (!handler) {
+            err.write(`pyric deploy ${provider.target}: ${op.toolName} tool not found.\n`);
+            reporter.dispose();
+            return 2;
+        }
+        for (const unit of resolved.units) {
+            reporter.report({
+                target: provider.target,
+                step: 'deploy',
+                status: 'start',
+                message: `deploying ${provider.target}`,
+            });
+            const ctx = {
+                signal: new AbortController().signal,
+                // The handler emits target-less step events; stamp the target here.
+                report: (e) => reporter.report({ target: provider.target, ...e }),
+            };
+            const result = await handler.execute(unit, ctx);
+            reporter.result(result);
+            if (!result.ok)
+                exit = 2;
+        }
+    }
+    catch (e) {
+        reporter.dispose();
+        err.write(`pyric deploy ${provider.target}: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 2;
+    }
+    reporter.dispose();
+    return exit;
+}
+/**
+ * `--schema`: print the tool's `parameters` JSON Schema and exit.
+ * Credential-free — handler construction only closes over the scope;
+ * `parameters` is static, and the stub scope throws if anything ever
+ * tries to execute.
+ */
+function printToolSchema(provider, deps, out, err) {
+    const op = defaultOperation(provider);
+    if (!op) {
+        err.write(`pyric deploy ${provider.target}: provider exposes no operations.\n`);
+        return 2;
+    }
+    const stubScope = {
+        projectId: '(schema-introspection)',
+        resolveToken: async () => {
+            throw new Error('schema introspection never mints tokens');
+        },
+    };
+    const handler = resolveDeployTools(provider, stubScope, deps).find((t) => t.name === op.toolName);
+    if (!handler) {
+        err.write(`pyric deploy ${provider.target}: ${op.toolName} tool not found.\n`);
+        return 2;
+    }
+    out.write(`${JSON.stringify(handler.parameters, null, 2)}\n`);
+    return 0;
+}
+/**
+ * `--json '<payload>'`: validate the payload against the tool's own
+ * `parameters` schema and feed it to the handler unchanged. The
+ * result ({ok, summary, data}) goes to stdout as JSON; errors —
+ * validation or handler failure — go to stderr as JSON. Exit codes
+ * keep the CLI contract (0 ok / 1 usage / 2 runtime).
+ */
+async function executeJsonPayload(raw, provider, scope, deps, out, err) {
+    let payload;
+    try {
+        payload = JSON.parse(raw);
+    }
+    catch (e) {
+        writeJsonError(err, `--json payload is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+        return 1;
+    }
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        writeJsonError(err, '--json payload must be a JSON object (the tool input)');
+        return 1;
+    }
+    const op = defaultOperation(provider);
+    if (!op) {
+        writeJsonError(err, `pyric deploy ${provider.target}: provider exposes no operations`);
+        return 2;
+    }
+    const handler = resolveDeployTools(provider, scope, deps).find((t) => t.name === op.toolName);
+    if (!handler) {
+        writeJsonError(err, `${op.toolName} tool not found`);
+        return 2;
+    }
+    const schema = handler.parameters;
+    const problems = validateAgainstSchema(payload, schema, 'input');
+    if (problems.length > 0) {
+        writeJsonError(err, `--json payload does not match the ${op.toolName} schema`, problems);
+        return 1;
+    }
+    // Typo guard: JSON Schema permits unknown keys (the handler ignores
+    // them), but an agent passing one almost certainly misspelled a real
+    // one — diagnostic warning on stderr, not a failure.
+    const known = schema.properties ?? {};
+    const unknown = Object.keys(payload).filter((k) => !(k in known));
+    if (unknown.length > 0) {
+        err.write(`pyric deploy: warning: payload keys not in the tool schema: ${unknown.join(', ')}\n`);
+    }
+    const result = await handler.execute(payload, { signal: new AbortController().signal });
+    (result.ok ? out : err).write(`${JSON.stringify(result)}\n`);
+    return result.ok ? 0 : 2;
+}
+function writeJsonError(err, summary, details) {
+    err.write(`${JSON.stringify({ ok: false, summary, ...(details ? { details } : {}) })}\n`);
+}
+/**
+ * Structural validation against the tool's `parameters` — the subset
+ * the deploy schemas use (object/array/string/number/boolean,
+ * `required`, nested `properties`, array `items`). Deeper semantic
+ * validation stays where it lives today (the handler / the config
+ * builder) — single source of truth.
+ */
+function validateAgainstSchema(value, schema, path) {
+    const errors = [];
+    switch (schema.type) {
+        case 'object': {
+            if (!value || typeof value !== 'object' || Array.isArray(value)) {
+                return [`${path} must be an object`];
+            }
+            const obj = value;
+            for (const req of schema.required ?? []) {
+                if (obj[req] === undefined)
+                    errors.push(`${path}.${req} is required`);
+            }
+            for (const [key, sub] of Object.entries(schema.properties ?? {})) {
+                if (obj[key] !== undefined) {
+                    errors.push(...validateAgainstSchema(obj[key], sub, `${path}.${key}`));
+                }
+            }
+            break;
+        }
+        case 'array': {
+            if (!Array.isArray(value))
+                return [`${path} must be an array`];
+            if (schema.items) {
+                value.forEach((v, i) => errors.push(...validateAgainstSchema(v, schema.items, `${path}[${i}]`)));
+            }
+            break;
+        }
+        case 'string':
+            if (typeof value !== 'string')
+                return [`${path} must be a string`];
+            break;
+        case 'number':
+            if (typeof value !== 'number')
+                return [`${path} must be a number`];
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean')
+                return [`${path} must be a boolean`];
+            break;
+        default:
+            // Untyped node — accept anything (mirrors JSON Schema semantics).
+            break;
+    }
+    return errors;
+}
+/**
+ * `pyric hosting:channel:deploy <channelId> [--expires <ttl>]` —
+ * mirror-form alias of `pyric deploy hosting --channel <channelId>`
+ * (upstream spelling: `firebase hosting:channel:deploy`,
+ * clones/firebase-tools/src/commands/hosting-channel-deploy.ts). It
+ * REWRITES the invocation and calls `runDeploy` — one code path, two
+ * spellings; the equivalence test in cli.test.ts pins both forms to
+ * the identical tool invocation so they can't drift.
+ */
+export async function runHostingChannelDeploy(parsed, deps = {}) {
+    const err = deps.stderr ?? process.stderr;
+    const channelId = parsed.positional[0];
+    if (!channelId) {
+        err.write('pyric hosting:channel:deploy: missing <channelId>. Usage: pyric hosting:channel:deploy <channelId> [--expires <30m|12h|7d>]\n');
+        return 1;
+    }
+    const flags = new Map(parsed.flags);
+    flags.set('channel', channelId);
+    return runDeploy({ subcommand: 'deploy', flags, positional: ['hosting', ...parsed.positional.slice(1)] }, deps);
+}
+/**
+ * Current git branch name, or `null` when git is unavailable / cwd is
+ * not a repo. Detached HEAD comes back as the literal `'HEAD'` (the
+ * caller rejects it — a preview channel needs a real branch name or
+ * an explicit id).
+ */
+function getGitBranch(cwd) {
+    return new Promise((resolve) => {
+        execFile('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd }, (error, stdout) => {
+            if (error)
+                return resolve(null);
+            const branch = stdout.trim();
+            resolve(branch.length > 0 ? branch : null);
+        });
+    });
+}
+//# sourceMappingURL=deploy.js.map

package/dist/cli/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/cli/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU5C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAyB,MAAM,6BAA6B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAsC5D,wEAAwE;AACxE,EAAE;AACF,sEAAsE;AACtE,+BAA+B;AAC/B,yEAAyE;AACzE,sEAAsE;AACtE,mEAAmE;AACnE,uEAAuE;AACvE,mEAAmE;AACnE,0EAA0E;AAC1E,oEAAoE;AACpE,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAkB,EAAE,OAAmB,EAAE;IACvE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAE7C,MAAM,OAAO,GAAG,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,KAAK,CAAC,sDAAsD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,iCAAiC,MAAM,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,QAAQ,KAAK,SAAS,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,oEAAoE;IACpE,oEAAoE;IACpE,iEAAiE;IACjE,IAAI,YAAY,GAAiB,EAAE,CAAC;IACpC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/C,kEAAkE;IAClE,sEAAsE;IACtE,0CAA0C;IAC1C,IAAI,aAAa,GAAG,eAAe,CAAC;IACpC,IAAI,aAAa,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC;QACnD,aAAa,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,IAAI,SAAS,CAAC;IACrD,CAAC;IAED,IAAI,KAAmB,CAAC;IACxB,IAAI,aAAa,GAAqB,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QACpE,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QACvB,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,KAAK,CAAC;QAChD,mEAAmE;QACnE,kDAAkD;QAClD,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAC/B,gCAAgC,KAAK,CAAC,SAAS,mBAAmB,QAAQ,CAAC,MAAM,KAAK,CACvF,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,kBAAkB,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,mFAAmF;IACnF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC;QAChC,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,MAAM;QACN,KAAK;QACL,aAAa;QACb,WAAW,EAAE,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QACzF,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG;QACH,GAAG;QACH,UAAU,EAAE,IAAI,CAAC,eAAe;QAChC,KAAK,EAAE,IAAI,CAAC,eAAe;QAC3B,MAAM,EAAE,IAAI,CAAC,WAAW;KACzB,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC;IACrC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAEtB,oEAAoE;IACpE,sEAAsE;IACtE,OAAO,iBAAiB,CACtB,QAAQ,EACR;QACE,YAAY;QACZ,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC;QACrC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG;QACH,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;QAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAoB;QAC1D,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,CAAC,GAAG,CAAC;KAC7D,EACD,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC;IACzC,6EAA6E;IAC7E,yEAAyE;IACzE,4EAA4E;IAC5E,0DAA0D;IAC1D,GAAG,EAAE,CACH,CAAC,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC,CAAC;QACrC,KAAK;QACL,IAAI,EAAE,QAAQ,CAAC,YAAY;QAC3B,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC9B,GAAG;KACJ,CAAC,EACJ,GAAG,EACH,GAAG,EACH,aAAa,EACb,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAC3D,CAAC;AAEJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA0B;IAClD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,SAAS,gBAAgB,CAAC,QAAwB;IAChD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,QAAwB,EAAE,KAAmB,EAAE,IAAgB;IACzF,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,KAAK,WAAW;QAC7B,CAAC,CAAC,IAAI,CAAC,0BAA0B;QACjC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;YAC7B,CAAC,CAAC,IAAI,CAAC,wBAAwB;YAC/B,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,OAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;gBAC5D,CAAC,CAAC,IAAI,CAAC,0BAA0B;gBACjC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU;oBAC9B,CAAC,CAAC,IAAI,CAAC,qBAAqB;oBAC9B,CAAC,CAAC,SAAS,CAAC;IACpB,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,iBAAiB,CAC9B,QAAwB,EACxB,GAAiB,EACjB,KAAoB,EACpB,eAAgD,EAChD,GAAS,EACT,GAAS,EACT,aAAsB,EACtB,KAAc;IAEd,MAAM,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,qCAAqC,CAAC,CAAC;QAChF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,yEAAyE;YACzE,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;YACpE,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,6EAA6E;QAC7E,0EAA0E;QAC1E,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC9C,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,cAAc,OAAO,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,0EAA0E;QAC1E,yEAAyE;QACzE,2BAA2B;QAC3B,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,QAAQ,oBAAoB,CAAC,CAAC;YAC/E,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,QAAQ,CAAC,MAAM,CAAC;gBACd,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,aAAa,QAAQ,CAAC,MAAM,EAAE;aACxC,CAAC,CAAC;YACH,MAAM,GAAG,GAAsB;gBAC7B,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;gBACpC,oEAAoE;gBACpE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;aAClE,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,IAAI,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CACtB,QAAwB,EACxB,IAAgB,EAChB,GAAS,EACT,GAAS;IAET,MAAM,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,qCAAqC,CAAC,CAAC;QAChF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,SAAS,GAAiB;QAC9B,SAAS,EAAE,wBAAwB;QACnC,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;IACF,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IAClG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,QAAQ,oBAAoB,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,kBAAkB,CAC/B,GAAW,EACX,QAAwB,EACxB,KAAmB,EACnB,IAAgB,EAChB,GAAS,EACT,GAAS;IAET,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,cAAc,CAAC,GAAG,EAAE,qCAAqC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvG,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,cAAc,CAAC,GAAG,EAAE,uDAAuD,CAAC,CAAC;QAC7E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,cAAc,CAAC,GAAG,EAAE,gBAAgB,QAAQ,CAAC,MAAM,kCAAkC,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC9F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,iBAAiB,CAAC,CAAC;QACrD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAwB,CAAC;IAChD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,cAAc,CAAC,GAAG,EAAE,qCAAqC,EAAE,CAAC,QAAQ,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,oEAAoE;IACpE,qEAAqE;IACrE,qDAAqD;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,CAAC,+DAA+D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,GAAS,EAAE,OAAe,EAAE,OAAkB;IACpE,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AAC5F,CAAC;AAUD;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,KAAc,EAAE,MAAkB,EAAE,IAAY;IAC7E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBACxC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,cAAc,CAAC,CAAC;YACxE,CAAC;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;YAC/D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrB,MAAM,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC,EAAE,MAAM,CAAC,KAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CACzE,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;YACnE,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;YACnE,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;YACrE,MAAM;QACR;YACE,kEAAkE;YAClE,MAAM;IACV,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAkB,EAClB,OAAmB,EAAE;IAErB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CACP,+HAA+H,CAChI,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,SAAS,CACd,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EACvF,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAChF,IAAI,KAAK;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/dev-runner.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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 { type ChildProcess } from 'node:child_process';
+/**
+ * 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 declare function waitForSandboxPeer(serveUrl: string, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+    fetchImpl?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<boolean>;
+export type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';
+/** Lockfile sniff, mirroring how init/vendor pick their install hints. */
+export declare function detectPackageManager(cwd: string): PackageManager;
+/** The project's `dev` script, or null (no package.json / no script). */
+export declare function readDevScript(cwd: string): string | null;
+export interface DevChildPlan {
+    /** argv to spawn — argv[0] is the executable, no shell. */
+    argv: string[];
+    /** Human-readable command for the pre-spawn line. */
+    label: string;
+}
+/**
+ * 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 declare function resolveDevChild(opts: {
+    passthrough: string[];
+    noRun: boolean;
+    json: boolean;
+    devScript: string | null;
+    packageManager: PackageManager;
+}): DevChildPlan | null;
+/**
+ * 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 declare function registerModuleUrl(): string;
+/**
+ * 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 declare function buildChildEnv(base: NodeJS.ProcessEnv, opts: {
+    serveUrl: string;
+    registerUrl: string;
+}): NodeJS.ProcessEnv;
+/**
+ * Incremental line prefixer: every child output line gets `[dev] `, partial
+ * lines are buffered until their newline (or flush at stream end).
+ */
+export declare function createLinePrefixer(prefix: string, write: (line: string) => void): {
+    push(chunk: string): void;
+    flush(): void;
+};
+export interface DevChildHandle {
+    /** Resolves with the exit code to propagate once the child is gone. */
+    exited: Promise<number>;
+    /** Forward a signal (Ctrl-C / SIGTERM). Marks the exit as user-initiated
+     *  so the propagated code is 0, and SIGKILLs a child that lingers. */
+    signal(sig: NodeJS.Signals): void;
+    child: ChildProcess;
+}
+/**
+ * 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 declare function spawnDevChild(plan: DevChildPlan, opts: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    json: boolean;
+}): DevChildHandle;
+//# sourceMappingURL=dev-runner.d.ts.map

package/dist/cli/dev-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-runner.d.ts","sourceRoot":"","sources":["../../src/cli/dev-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAM9D;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC,GACL,OAAO,CAAC,OAAO,CAAC,CAmBlB;AAID,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAKhE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUxD;AAED,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;CAChC,GAAG,YAAY,GAAG,IAAI,CAWtB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9C,MAAM,CAAC,UAAU,CAOnB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B;IAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAkB9C;AAID,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB;0EACsE;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,YAAY,CAAC;CACrB;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3D,cAAc,CAsDhB"}