appduct 0.10.0 → 0.11.1

package/dist/cli/open-target.js

@@ -1,438 +0,0 @@
-/**
- * Emulator/simulator fast path (ARCHITECTURE.md §8 delivery path 1, §10 `link --open`): delivers a
- * deep link to a booted Android emulator/device or iOS simulator without any human handling a QR
- * code — this is the CI/agent path. All subprocess execution goes through the injectable
- * {@link ExecFn} seam so every branch here is testable without `adb`/`xcrun` installed.
- *
- * {@link detectBootedTargets} is the same enumeration used *before* a target is chosen, so callers
- * that were given no explicit target (notably `appduct_connect` over MCP) can deliver to the one
- * obvious device instead of falling back to a QR code nobody is there to scan.
- *
- * A third, experimental target — `ios-device`, a paired physical iPhone/iPad via `xcrun devicectl`
- * (issue #31) — is explicit opt-in only: it is never auto-detected, it needs the app's bundle id,
- * and its link must carry the LAN address rather than `127.0.0.1` (see {@link usesLoopbackAddress}).
- */
-import { execFile } from "node:child_process";
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { connectionError, usageError } from "../errors.js";
-export const isOpenTarget = (value) => {
-    return value === "android" || value === "ios-sim" || value === "ios-device";
-};
-/** Human-readable list of every accepted target, for the "must be one of" validation messages the
- * CLI, the shared `mintLink` core and `appduct_connect` each render in their own wording. */
-export const OPEN_TARGETS = ["android", "ios-sim", "ios-device"];
-/**
- * Whether a link delivered to this target reaches the daemon over loopback, and so must be minted
- * with the `127.0.0.1` address override (`link.ts`, `mcp/connect-tool.ts`). True for `android`
- * (`adb reverse` forwards the port onto the device) and `ios-sim` (the simulator shares the host's
- * network stack); false for `ios-device` — a physical iPhone reaches the daemon only over the LAN,
- * so such a link must carry the machine's real advertised address (issue #31).
- */
-export const usesLoopbackAddress = (target) => {
-    return target === "android" || target === "ios-sim";
-};
-/**
- * Whether an advertised address is one that only resolves back to the machine that minted the link.
- * `daemon/address.ts` falls back to `127.0.0.1` when it cannot find a routable interface, and such
- * a link handed to a physical phone points the phone at *itself*: the app connects to nothing, the
- * session is never claimed, and `wait_for_session` blocks for its whole timeout with no clue why.
- * The `ios-device` path checks this after minting and refuses rather than delivering.
- */
-export const isLoopbackAddress = (address) => {
-    const normalized = address.trim().toLowerCase().replace(/^\[|\]$/gu, "");
-    return (normalized === "localhost" ||
-        normalized === "::1" ||
-        normalized === "0.0.0.0" ||
-        normalized === "::" ||
-        /^127\./u.test(normalized));
-};
-/** The one wording for that refusal, shared by the CLI and MCP paths. */
-export const loopbackAddressMessage = (address) => `The daemon advertised "${address}", which a physical device cannot reach — it would point the ` +
-    "phone at itself and the session would never be claimed. No routable LAN address was detected; " +
-    'set "advertisedIp" in config.json to this machine\'s address on the network the device is on, ' +
-    "and retry.";
-/** Real subprocess execution via `execFile` (no shell involved — argv is passed verbatim). */
-export const defaultExec = (command, args) => {
-    return new Promise((resolve, reject) => {
-        execFile(command, args, { encoding: "utf8" }, (error, stdout, stderr) => {
-            if (error) {
-                reject(Object.assign(error, { stdout, stderr }));
-                return;
-            }
-            resolve({ stdout, stderr });
-        });
-    });
-};
-const TOOL_INSTALL_HINT = {
-    adb: "the Android platform-tools (adb)",
-    xcrun: "the Xcode command line tools (xcrun)",
-};
-const run = async (exec, command, args) => {
-    try {
-        return await exec(command, args);
-    }
-    catch (error) {
-        const err = error;
-        if (err.code === "ENOENT") {
-            throw connectionError(`"${command}" was not found on PATH. Install ${TOOL_INSTALL_HINT[command] ?? command} and retry.`);
-        }
-        const stderr = (err.stderr ?? "").trim();
-        throw connectionError(`"${command} ${args.join(" ")}" failed${stderr ? `: ${stderr}` : `: ${err.message}`}`);
-    }
-};
-const parseBootedSimulators = (stdout) => {
-    let parsed;
-    try {
-        parsed = JSON.parse(stdout);
-    }
-    catch {
-        return [];
-    }
-    return Object.values(parsed.devices ?? {})
-        .flat()
-        .filter((entry) => entry.state === "Booted" && typeof entry.udid === "string" && entry.udid.length > 0)
-        .map((entry) => ({ udid: entry.udid, name: entry.name ?? entry.udid }));
-};
-const listBootedSimulators = async (exec) => {
-    const preflight = await run(exec, "xcrun", ["simctl", "list", "devices", "booted", "--json"]);
-    return parseBootedSimulators(preflight.stdout);
-};
-const describeSimulator = (simulator) => `${simulator.name} (${simulator.udid})`;
-const deliverIosSim = async (exec, deepLink, device) => {
-    // An explicit udid is honored without a preflight, mirroring android's `--device` passthrough:
-    // the caller has already named the device, so re-listing only adds a failure mode.
-    if (device) {
-        await run(exec, "xcrun", ["simctl", "openurl", device, deepLink]);
-        return;
-    }
-    const booted = await listBootedSimulators(exec);
-    if (booted.length === 0) {
-        throw usageError("No booted iOS simulator found. Boot a simulator (e.g. via Xcode) and retry.");
-    }
-    if (booted.length > 1) {
-        // Previously this delivered to simctl's `booted` alias regardless, which silently picks one of
-        // several booted simulators — the link would land on an arbitrary device and the session would
-        // never be claimed, looking exactly like a hung `wait_for_session`. Errors like android does.
-        throw usageError(`Multiple iOS simulators are booted (${booted
-            .map(describeSimulator)
-            .join(", ")}); specify --device <udid>.`);
-    }
-    // Target the resolved udid rather than the `booted` alias: `booted` is only unambiguous while
-    // exactly one simulator is up, and a second one booting between the preflight and this call would
-    // otherwise redirect the link to an arbitrary device.
-    await run(exec, "xcrun", ["simctl", "openurl", booted[0].udid, deepLink]);
-};
-// --- ios-device (experimental, issue #31) ---
-/**
- * `devicectl` writes its JSON to a *file* (`--json-output <path>`), never to stdout, so this path
- * cannot reuse the stdout-parsing shape `simctl` uses. The file lives in a private `mkdtemp`
- * directory removed in a `finally`, so a failing `devicectl` (or a malformed payload) never leaks
- * a temp file.
- */
-const runDevicectlJson = async (exec, buildArgs) => {
-    let dir;
-    try {
-        dir = await mkdtemp(path.join(tmpdir(), "appduct-devicectl-"));
-    }
-    catch (error) {
-        // A read-only or missing TMPDIR would otherwise surface as a bare `EACCES`/`ENOENT` against a
-        // path the user never chose, with nothing saying which knob to turn.
-        throw connectionError(`A temporary directory for devicectl's --json-output could not be created in "${tmpdir()}" ` +
-            `(${error.message}). Set TMPDIR to a writable directory and retry.`);
-    }
-    const file = path.join(dir, "devicectl.json");
-    try {
-        await run(exec, "xcrun", buildArgs(file));
-        try {
-            return JSON.parse(await readFile(file, "utf8"));
-        }
-        catch {
-            // `devicectl` exited 0 but wrote nothing readable. Treated as an empty listing (the caller
-            // renders "no device found") rather than surfacing a JSON syntax error, matching how
-            // `parseBootedSimulators` handles unparseable `simctl` output.
-            return undefined;
-        }
-    }
-    finally {
-        // Swallowed deliberately: a failure to clean up a temp directory must not replace the
-        // devicectl error the caller actually needs to read (a `finally` that throws wins).
-        await rm(dir, { force: true, recursive: true }).catch(() => { });
-    }
-};
-/** `hardwareProperties.platform` values `devicectl` reports for things that are not an iPhone or
- * iPad. A paired Apple Watch or Vision Pro is a real CoreDevice and shows up in the same listing,
- * but cannot run the app and must never make the device choice look ambiguous. */
-const DELIVERABLE_PLATFORM = "ios";
-/**
- * The only `tunnelState` that means "not reachable at all". Deliberately *not* including
- * `disconnected`: a wired, trusted iPhone routinely reports `disconnected` (the tunnel is brought
- * up on demand), so excluding it would drop exactly the device this target exists to reach. This
- * matches the vendored Expo CLI's own `devicectl` integration
- * (`@expo/cli`'s `AppleDevice.js:102`), which keeps `disconnected` and excludes only `unavailable`.
- */
-const UNREACHABLE_TUNNEL_STATE = "unavailable";
-/** Expo's companion condition: a usable device is affirmatively `paired`. */
-const USABLE_PAIRING_STATE = "paired";
-/**
- * `devicectl list devices` lists **every CoreDevice the Mac has ever known**, across platforms and
- * regardless of whether it is plugged in — so the listing has to be filtered, not trusted.
- *
- * Filtering happens here rather than through `devicectl --filter` (an NSPredicate over undocumented
- * keys) so that every rule is exercised by the `ExecFn` tests instead of by a predicate string no
- * test can evaluate.
- *
- * Each rule drops an entry only when the field is **present and disqualifying**; a missing field
- * keeps the device. The field names are undocumented, so a `devicectl` that stops emitting one must
- * degrade to "offer the device and let the launch fail loudly", never to "silently find nothing".
- * That is the one deliberate departure from Expo, which tests `pairingState === "paired"`
- * positively and so would find nothing at all if the key were ever renamed.
- */
-const parsePairedIosDevices = (payload) => {
-    const devices = payload?.result?.devices;
-    if (!Array.isArray(devices)) {
-        return [];
-    }
-    return devices
-        .map((entry) => {
-        const platform = entry?.hardwareProperties?.platform;
-        if (typeof platform === "string" && platform.toLowerCase() !== DELIVERABLE_PLATFORM) {
-            return undefined;
-        }
-        const tunnelState = entry?.connectionProperties?.tunnelState;
-        if (typeof tunnelState === "string" && tunnelState.toLowerCase() === UNREACHABLE_TUNNEL_STATE) {
-            return undefined;
-        }
-        const pairingState = entry?.connectionProperties?.pairingState;
-        if (typeof pairingState === "string" && pairingState.toLowerCase() !== USABLE_PAIRING_STATE) {
-            return undefined;
-        }
-        // `hardwareProperties.udid` is what `--device` wants; `identifier` (the CoreDevice UUID) is
-        // also accepted by `devicectl`, so a listing that omits the udid is still usable rather than
-        // silently dropped. Checked for emptiness rather than `??`, which would keep a `""` udid and
-        // never reach the documented fallback.
-        const hardwareUdid = entry?.hardwareProperties?.udid;
-        const udid = typeof hardwareUdid === "string" && hardwareUdid.length > 0
-            ? hardwareUdid
-            : entry?.identifier;
-        return typeof udid === "string" && udid.length > 0
-            ? { udid, name: entry?.deviceProperties?.name ?? udid }
-            : undefined;
-    })
-        .filter((device) => device !== undefined);
-};
-const listPairedIosDevices = async (exec) => {
-    const payload = await runDevicectlJson(exec, (file) => [
-        "devicectl",
-        "list",
-        "devices",
-        "--timeout",
-        "5",
-        "--json-output",
-        file,
-    ]);
-    return parsePairedIosDevices(payload);
-};
-const describeIosDevice = (device) => `${device.name} (${device.udid})`;
-/** The single wording naming both ways to supply a bundle id, so the CLI and MCP paths agree. */
-export const MISSING_BUNDLE_ID_MESSAGE = "Delivering to a physical iPhone needs the app's bundle id: pass \"--bundle-id <id>\" (or " +
-    '"bundleId" over MCP), or set "iosBundleId" in config.json.';
-/**
- * A bundle id is the **only trailing positional** in the `devicectl device process launch` argv, so
- * a value beginning with `-` would be read by `devicectl` as an option rather than as the app to
- * launch — `--console`, say, silently changing what the command does. Apple's own grammar for a
- * bundle identifier is alphanumerics, `.` and `-`, which never legitimately starts with `-`, so
- * enforcing exactly that shape closes the hole at every entry point.
- *
- * A `--` terminator is deliberately *not* used instead: `devicectl` takes launch arguments after
- * the bundle id, its handling of `--` is undocumented, and none of it can be verified without
- * hardware — whereas this check is exact and fully testable.
- */
-const BUNDLE_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9.-]*$/u;
-export const isValidBundleId = (value) => BUNDLE_ID_PATTERN.test(value);
-export const invalidBundleIdMessage = (value) => `"${value}" is not a valid iOS bundle id (letters, digits, "." and "-", starting with a letter ` +
-    "or digit).";
-/** Same ambiguity rules as `deliverIosSim`: exactly one paired device, or the caller names one. */
-const resolveSingleIosDevice = async (exec) => {
-    const paired = await listPairedIosDevices(exec);
-    if (paired.length === 0) {
-        throw usageError('No connected iOS device was found ("xcrun devicectl list devices" listed none, ignoring ' +
-            "disconnected devices and non-iOS ones such as a paired Watch or Vision Pro). Connect the " +
-            "device, trust this Mac, and enable Developer Mode on it, then retry.");
-    }
-    if (paired.length > 1) {
-        throw usageError(`Multiple connected iOS devices were found (${paired
-            .map(describeIosDevice)
-            .join(", ")}); specify --device <udid>.`);
-    }
-    return paired[0].udid;
-};
-/**
- * Experimental physical-iPhone delivery (issue #31). `xcrun devicectl device process launch
- * --device <udid> --payload-url <url> <bundle-id>` is undocumented by Apple but is the mechanism
- * Xcode 15+ exposes for handing a URL to an installed, dev-signed app on a paired iOS 17+ device.
- * It may cold-launch (rather than foreground) the app; the app side copes either way, because a
- * delivered link supersedes a held session and the initial-URL path is handled.
- *
- * Unlike `ios-sim`, this is never auto-detected — see {@link detectBootedTargets}.
- */
-const deliverIosDevice = async (exec, deepLink, device, bundleId, relaunch) => {
-    // Checked before any enumeration: without a bundle id the launch cannot happen at all, so
-    // spending a `devicectl list devices` timeout first would only delay the same error.
-    if (!bundleId) {
-        throw usageError(MISSING_BUNDLE_ID_MESSAGE);
-    }
-    // Last line of defence: every caller validates too, but this is the one place the value reaches
-    // an argv, so it is the one place that must not be bypassable.
-    if (!isValidBundleId(bundleId)) {
-        throw usageError(invalidBundleIdMessage(bundleId));
-    }
-    // An explicit udid is honored without a preflight, mirroring the `ios-sim`/`android` passthrough.
-    const udid = device ?? (await resolveSingleIosDevice(exec));
-    await run(exec, "xcrun", [
-        "devicectl",
-        "device",
-        "process",
-        "launch",
-        "--device",
-        udid,
-        // Opt-in only (`--relaunch` / `relaunch: true`). A plain `process launch` is what the vendored
-        // Expo CLI does, so it is the better-attested default; what it does when the app is *already
-        // running* is the one thing nobody here can verify without hardware. If that turns out to fail
-        // rather than deliver the URL, `--terminate-existing` is the escape hatch — it kills the
-        // running instance first, which Appduct copes with because a delivered link supersedes a
-        // held session.
-        ...(relaunch ? ["--terminate-existing"] : []),
-        "--payload-url",
-        deepLink,
-        bundleId,
-    ]);
-};
-/** Parses `adb devices` output: header line, then `<serial>\t<state>` per attached device. */
-const parseAdbDevices = (stdout) => {
-    return stdout
-        .split("\n")
-        .slice(1)
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0)
-        .map((line) => {
-        const [serial = "", state = ""] = line.split(/\s+/u);
-        return { serial, state };
-    })
-        .filter((entry) => entry.serial.length > 0);
-};
-const listAttachedAndroidDevices = async (exec) => {
-    const listing = await run(exec, "adb", ["devices"]);
-    return parseAdbDevices(listing.stdout)
-        .filter((entry) => entry.state === "device")
-        .map((entry) => entry.serial);
-};
-/**
- * Resolves the `-s <serial>` argument, if any. `--device` always wins; otherwise, if
- * `ANDROID_SERIAL` is set, `adb` already honors it with no flag needed from us; otherwise exactly
- * one attached device is required (zero or several is an error naming what's attached).
- */
-const resolveAndroidSerial = async (exec, device, env) => {
-    if (device) {
-        return device;
-    }
-    if (env.ANDROID_SERIAL) {
-        return undefined;
-    }
-    const attached = await listAttachedAndroidDevices(exec);
-    if (attached.length === 0) {
-        throw usageError('No Android device or emulator is attached ("adb devices" listed none).');
-    }
-    if (attached.length > 1) {
-        throw usageError(`Multiple Android devices are attached (${attached.join(", ")}); specify --device <serial> or set ANDROID_SERIAL.`);
-    }
-    return undefined;
-};
-const withSerial = (args, serial) => {
-    return serial ? ["-s", serial, ...args] : args;
-};
-const deliverAndroid = async (exec, deepLink, wssPort, device, env) => {
-    const serial = await resolveAndroidSerial(exec, device, env);
-    // `adb reverse` before `am start`: the port forward must exist before the app tries to connect,
-    // which can happen the instant the deep link is handled.
-    await run(exec, "adb", withSerial(["reverse", `tcp:${wssPort}`, `tcp:${wssPort}`], serial));
-    await run(exec, "adb", withSerial([
-        "shell",
-        "am",
-        "start",
-        "-a",
-        "android.intent.action.VIEW",
-        "-d",
-        // `adb shell` reconstructs everything after "shell" into one string and re-parses it on the
-        // device's own shell; single-quoting the URL here (not just for local execFile, which never
-        // re-tokenizes argv) protects against that second, remote parse (ARCHITECTURE.md §8).
-        `'${deepLink}'`,
-    ], serial));
-};
-/** Best-effort enumeration: a missing or failing `xcrun`/`adb` means "no devices of that platform"
- * rather than an error. Detection runs when the caller named *no* target, so a machine without the
- * Android tools installed (or without Xcode) must still reach a clean `{ kind: "none" }` and its
- * QR fallback instead of failing the whole call. */
-const safeList = async (list) => {
-    try {
-        return await list();
-    }
-    catch {
-        return [];
-    }
-};
-/**
- * Enumerates every booted simulator and attached Android device so a caller with no explicit
- * target can deliver to the single obvious one. `ANDROID_SERIAL`, when set, narrows the Android
- * side to that serial — it is exactly the disambiguation the user has already made.
- *
- * Physical iPhones (`ios-device`) are deliberately *not* enumerated here (issue #31): a paired
- * iPhone is often someone's personal phone rather than a test device, delivery to it may
- * cold-launch the app, and it additionally needs a bundle id the caller has to supply. It is an
- * explicit, opt-in target only.
- */
-export const detectBootedTargets = async (options = {}) => {
-    const exec = options.exec ?? defaultExec;
-    const env = options.env ?? process.env;
-    const [simulators, androidSerials] = await Promise.all([
-        safeList(() => listBootedSimulators(exec)),
-        env.ANDROID_SERIAL
-            ? Promise.resolve([env.ANDROID_SERIAL])
-            : safeList(() => listAttachedAndroidDevices(exec)),
-    ]);
-    const candidates = [
-        ...simulators.map((simulator) => ({
-            target: "ios-sim",
-            device: simulator.udid,
-            label: describeSimulator(simulator),
-        })),
-        ...androidSerials.map((serial) => ({
-            target: "android",
-            device: serial,
-            label: serial,
-        })),
-    ];
-    if (candidates.length === 0) {
-        return { kind: "none" };
-    }
-    if (candidates.length === 1) {
-        return { kind: "single", detected: candidates[0] };
-    }
-    return { kind: "ambiguous", candidates };
-};
-/** Delivers `deepLink` to a booted Android device/emulator, an iOS simulator, or (experimentally)
- * a paired physical iOS device. Throws a clear, actionable error (missing tool, no booted device,
- * ambiguous device, missing bundle id) rather than a raw one. */
-export const deliverToOpenTarget = async (options) => {
-    const exec = options.exec ?? defaultExec;
-    if (options.target === "ios-sim") {
-        await deliverIosSim(exec, options.deepLink, options.device);
-        return;
-    }
-    if (options.target === "ios-device") {
-        await deliverIosDevice(exec, options.deepLink, options.device, options.bundleId, options.relaunch ?? false);
-        return;
-    }
-    await deliverAndroid(exec, options.deepLink, options.wssPort, options.device, options.env ?? process.env);
-};

package/dist/cli/result-types.d.ts.map

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

package/dist/cli/result-types.js

@@ -1,6 +0,0 @@
-/**
- * CLI command-result types (ARCHITECTURE.md §10). The v2 command table replaces the v1 shapes that
- * used to live here (`host`/`connect`/`session` — all removed from the v2 command surface) with
- * the thin-client shapes for the v2 command table.
- */
-export {};

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

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/cli/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAqB,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;GAIG;AACH,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAeF,eAAO,MAAM,cAAc,GACzB,SAAS,MAAM,EACf,SAAS,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAC/D,SAAS,YAAY,GACnB,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG;IAC5C,KAAK,EAAE,KAAK,CAAC;CACd,KACF,OAAO,CAAC,MAAM,CAkChB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,MAAM,EACf,SAAS,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAC3C,SAAS,YAAY,GAAG;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,KACA,OAAO,CAAC,MAAM,CAoFhB,CAAC"}

package/dist/cli/runner.js

@@ -1,111 +0,0 @@
-import { getExitCodeForError, toCliError } from "../errors.js";
-import { renderResult } from "../output.js";
-import { createCommandMeta } from "./types.js";
-const writeRenderedOutput = (rendered, writers) => {
-    if (rendered.stdout) {
-        writers.stdout.write(rendered.stdout);
-    }
-    if (rendered.stderr) {
-        writers.stderr.write(rendered.stderr);
-    }
-};
-export const executeCommand = async (command, handler, options) => {
-    const startedAt = options.clock.now();
-    const renderOptions = {
-        command,
-        json: options.json,
-        color: options.color,
-        qr: options.qr,
-        full: options.full,
-    };
-    try {
-        const result = await handler();
-        const finishedAt = options.clock.now();
-        const withMeta = {
-            ...result,
-            meta: createCommandMeta(command, startedAt, finishedAt),
-        };
-        writeRenderedOutput(renderResult(withMeta, renderOptions), options);
-        return 0;
-    }
-    catch (error) {
-        const finishedAt = options.clock.now();
-        const cliError = toCliError(error);
-        const result = {
-            ok: false,
-            error: cliError,
-            meta: createCommandMeta(command, startedAt, finishedAt),
-        };
-        writeRenderedOutput(renderResult(result, renderOptions), options);
-        return getExitCodeForError(error);
-    }
-};
-export const executeHostedCommand = async (command, handler, options) => {
-    const startedAt = options.clock.now();
-    let renderedSuccess = false;
-    try {
-        const hosted = await handler();
-        const finishedAt = options.clock.now();
-        const withMeta = {
-            ...hosted.result,
-            meta: createCommandMeta(command, startedAt, finishedAt),
-        };
-        // A live reporter (e.g. `events`'s streaming NDJSON/human lines) renders its own output as it
-        // goes; only the absence of a reporter (or an explicit "plain" one) falls back to the default
-        // one-shot `renderResult` bootstrap rendering.
-        const liveReporter = options.reporter;
-        const shouldRenderBootstrap = !liveReporter || liveReporter.kind === "plain";
-        if (shouldRenderBootstrap) {
-            writeRenderedOutput(renderResult(withMeta, {
-                command,
-                json: options.json,
-                color: options.color,
-            }), options);
-            renderedSuccess = true;
-        }
-        let resolved = false;
-        const stop = () => {
-            if (resolved) {
-                return;
-            }
-            resolved = true;
-            hosted.stop();
-        };
-        process.once("SIGINT", stop);
-        process.once("SIGTERM", stop);
-        try {
-            await hosted.completion;
-        }
-        finally {
-            resolved = true;
-            process.off("SIGINT", stop);
-            process.off("SIGTERM", stop);
-            options.reporter?.dispose();
-        }
-        return 0;
-    }
-    catch (error) {
-        options.reporter?.dispose();
-        const finishedAt = options.clock.now();
-        const cliError = toCliError(error);
-        const result = {
-            ok: false,
-            error: cliError,
-            meta: createCommandMeta(command, startedAt, finishedAt),
-        };
-        if (renderedSuccess && options.json) {
-            // The single-JSON-object-on-stdout contract was already fulfilled by the bootstrap render
-            // above; a failure that happens later (e.g. during a long-running `completion`) must still
-            // be a JSON object, just on stderr instead — bare text here was v1's defect (leaked
-            // unparseable output onto stderr in `--json` mode).
-            options.stderr.write(`${JSON.stringify(result)}\n`);
-            return getExitCodeForError(error);
-        }
-        writeRenderedOutput(renderResult(result, {
-            command,
-            json: options.json,
-            color: options.color,
-        }), options);
-        return getExitCodeForError(error);
-    }
-};

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,EACf,WAAW,IAAI,EACf,YAAY,IAAI,KACf,WAMF,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;CACd,CAAC"}

package/dist/cli/types.js

@@ -1,10 +0,0 @@
-export const systemClock = {
-    now: () => new Date(),
-};
-export const createCommandMeta = (command, startedAt, finishedAt) => {
-    return {
-        command,
-        timestamp: finishedAt.toISOString(),
-        duration_ms: finishedAt.getTime() - startedAt.getTime(),
-    };
-};

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli.js

@@ -1,2 +0,0 @@
-export { createCli } from "./cli/create-cli.js";
-export { runCli } from "./cli/dispatch.js";

package/dist/client/app-client.d.ts.map

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