@cardelli/ambit 0.1.4 → 0.1.5

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "@cardelli/ambit",
-    "version": "0.1.4",
+    "version": "0.1.5",
     "description": "Deploy apps to the cloud that only you and your AI agents can reach",
     "license": "MIT",
     "exports": {

package/esm/deps/jsr.io/@zod/zod/4.3.6/src/v4/core/json-schema-generator.d.ts

@@ -44,7 +44,7 @@ export declare class JSONSchemaGenerator {
         path: (string | number)[];
     }) => void;
     /** @deprecated Access via ctx instead */
-    get io(): "output" | "input";
+    get io(): "input" | "output";
     /** @deprecated Access via ctx instead */
     get counter(): number;
     set counter(value: number);

package/esm/lib/cli.d.ts

@@ -25,7 +25,6 @@ export declare const prompt: (message: string) => Promise<string>;
 export declare const confirm: (message: string) => Promise<boolean>;
 export declare const readSecret: (message: string) => Promise<string>;
 export declare const fileExists: (path: string) => Promise<boolean>;
-export declare const fileExistsSync: (path: string) => boolean;
 export declare const getConfigDir: () => string;
 export declare const getConfigPath: () => string;
 export declare const ensureConfigDir: () => Promise<void>;

package/esm/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAKA,OAAO,sBAAsB,CAAC;AAiB9B,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AACzE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AAC3E,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AAMvE,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAMF,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,KAGrC,CAAC;AAQF,qBAAa,OAAO;IAClB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAM;IAErB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI5B;AAMD,eAAO,MAAM,MAAM,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAW5D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAG9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAIhE,CAAC;AAMF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAO9D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,OAO7C,CAAC;AAMF,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAOpD,CAAC;AAMF,eAAO,MAAM,QAAQ,GAAI,SAAQ,MAAU,KAAG,MAO7C,CAAC;AAMF,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CASpE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/lib/cli.ts"],"names":[],"mappings":"AAKA,OAAO,sBAAsB,CAAC;AAiB9B,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AACrE,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAmC,CAAC;AACzE,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC;AAC3E,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AACvE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,KAAG,MAAkC,CAAC;AAMvE,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,IAE5C,CAAC;AAMF,eAAO,MAAM,GAAG,GAAI,SAAS,MAAM,KAAG,KAGrC,CAAC;AAQF,qBAAa,OAAO;IAClB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAM;IAErB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI5B;AAMD,eAAO,MAAM,MAAM,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAW5D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAG9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAoChE,CAAC;AAMF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAI9D,CAAC;AAMF,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC;AAEF,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAUpD,CAAC;AAMF,eAAO,MAAM,QAAQ,GAAI,SAAQ,MAAU,KAAG,MAM7C,CAAC;AAMF,eAAO,MAAM,aAAa,GAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CASpE,CAAC"}

package/esm/lib/cli.js

@@ -102,30 +102,46 @@ export const confirm = async (message) => {
     return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
 };
 export const readSecret = async (message) => {
-    // Note: This is a simplified version - for proper secret input,
-    // you'd want to disable echo on the terminal
-    return await prompt(message);
+    if (!dntShim.Deno.stdin.isTerminal) {
+        return await prompt(message);
+    }
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    await dntShim.Deno.stdout.write(encoder.encode(message));
+    let echoDisabled = false;
+    try {
+        const sttyOff = await new dntShim.Deno.Command("stty", {
+            args: ["-echo"],
+            stdin: "inherit",
+            stdout: "null",
+            stderr: "null",
+        }).output();
+        echoDisabled = sttyOff.success;
+        const buf = new Uint8Array(1024);
+        const n = await dntShim.Deno.stdin.read(buf);
+        if (n === null)
+            return "";
+        return decoder.decode(buf.subarray(0, n)).trim();
+    }
+    finally {
+        if (echoDisabled) {
+            await new dntShim.Deno.Command("stty", {
+                args: ["echo"],
+                stdin: "inherit",
+                stdout: "null",
+                stderr: "null",
+            }).output();
+        }
+        await dntShim.Deno.stdout.write(encoder.encode("\n"));
+    }
 };
 // =============================================================================
 // File Utilities
 // =============================================================================
 export const fileExists = async (path) => {
-    try {
-        await dntShim.Deno.stat(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-export const fileExistsSync = (path) => {
-    try {
-        dntShim.Deno.statSync(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return dntShim.Deno.stat(path)
+        .then(() => true)
+        .catch(() => false);
 };
 // =============================================================================
 // Config Directory
@@ -142,8 +158,11 @@ export const ensureConfigDir = async () => {
     try {
         await dntShim.Deno.mkdir(dir, { recursive: true });
     }
-    catch {
-        // Ignore - already exists
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.AlreadyExists) {
+            return;
+        }
+        throw error;
     }
 };
 // =============================================================================
@@ -151,11 +170,7 @@ export const ensureConfigDir = async () => {
 // =============================================================================
 export const randomId = (length = 6) => {
     const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
-    let result = "";
-    for (let i = 0; i < length; i++) {
-        result += chars.charAt(Math.floor(Math.random() * chars.length));
-    }
-    return result;
+    return Array.from({ length }, () => chars[Math.floor(Math.random() * chars.length)]).join("");
 };
 // =============================================================================
 // Command Exists Check

package/esm/lib/command.d.ts

@@ -1,54 +1,29 @@
 import "../_dnt.polyfills.js";
-export interface CommandResult {
-    success: boolean;
-    code: number;
-    stdout: string;
-    stderr: string;
-}
-/**
- * Run a command and capture output.
- */
-export declare const runCommand: (args: string[], options?: {
+import { Result } from "./result.js";
+export interface RunOptions {
+    interactive?: boolean;
     cwd?: string;
     env?: Record<string, string>;
-    stdin?: "inherit" | "null" | "piped";
-}) => Promise<CommandResult>;
-/**
- * Run a command that outputs JSON and parse it.
- */
-export declare const runCommandJson: <T>(args: string[], options?: {
-    cwd?: string;
-    env?: Record<string, string>;
-}) => Promise<{
-    success: boolean;
-    data?: T;
-    error?: string;
-}>;
-/**
- * Run a command while showing a spinner.
- */
-export declare const runWithSpinner: (label: string, args: string[], options?: {
-    cwd?: string;
-    env?: Record<string, string>;
-}) => Promise<CommandResult>;
-/**
- * Run a command with spinner and return simplified result.
- */
-export declare const runQuiet: (label: string, args: string[], options?: {
-    cwd?: string;
-    env?: Record<string, string>;
-}) => Promise<{
-    success: boolean;
-    output: string;
-}>;
+    stdin?: "inherit" | "null";
+}
+export declare class CmdResult {
+    readonly code: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly ok: boolean;
+    constructor(code: number, stdout: string, stderr: string);
+    /** Parse stdout as JSON, returning Result<T>. */
+    json<T>(): Result<T>;
+    /** Merged stdout + stderr. */
+    get output(): string;
+}
 /**
- * Run a command interactively (inherits stdio).
+ * Run a command and capture output.
+ * When `interactive: true`, inherits all stdio (no capture).
  */
-export declare const runInteractive: (args: string[], options?: {
-    cwd?: string;
-    env?: Record<string, string>;
-}) => Promise<{
-    success: boolean;
-    code: number;
-}>;
+export declare const runCommand: (args: string[], options?: RunOptions) => Promise<CmdResult>;
+/** Run with spinner, return CmdResult. */
+export declare const runQuiet: (label: string, args: string[], options?: RunOptions) => Promise<CmdResult>;
+/** Run and parse stdout as JSON. */
+export declare const runJson: <T>(args: string[], options?: RunOptions) => Promise<Result<T>>;
 //# sourceMappingURL=command.d.ts.map

package/esm/lib/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lib/command.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAU9B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EAAE,EACd,UAAU;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CACtC,KACA,OAAO,CAAC,aAAa,CAwCvB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,EACpC,MAAM,MAAM,EAAE,EACd,UAAU;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,KACA,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmBxD,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,MAAM,MAAM,EAAE,EACd,UAAU;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,KACA,OAAO,CAAC,aAAa,CAavB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,EACb,MAAM,MAAM,EAAE,EACd,UAAU;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,KACA,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAM9C,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EAAE,EACd,UAAU;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,KACA,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkB5C,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/lib/command.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAK9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B;AAMD,qBAAa,SAAS;IAIlB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;gBAGV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAKzB,iDAAiD;IACjD,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IAapB,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAMD;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,SAAS,CA2CnB,CAAC;AAMF,0CAA0C;AAC1C,eAAO,MAAM,QAAQ,GACnB,OAAO,MAAM,EACb,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,SAAS,CAOnB,CAAC;AAEF,oCAAoC;AACpC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,MAAM,MAAM,EAAE,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAuD,CAAC"}

package/esm/lib/command.js

@@ -4,24 +4,69 @@
 import "../_dnt.polyfills.js";
 import { spawn } from "node:child_process";
 import { Spinner } from "./cli.js";
+import { Result } from "./result.js";
+// =============================================================================
+// Command Result
+// =============================================================================
+export class CmdResult {
+    code;
+    stdout;
+    stderr;
+    ok;
+    constructor(code, stdout, stderr) {
+        this.code = code;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.ok = code === 0;
+    }
+    /** Parse stdout as JSON, returning Result<T>. */
+    json() {
+        if (!this.ok) {
+            return Result.err(this.stderr || `Command failed with code ${this.code}`);
+        }
+        try {
+            return Result.ok(JSON.parse(this.stdout));
+        }
+        catch {
+            return Result.err(`Failed to parse JSON: ${this.stdout.slice(0, 100)}`);
+        }
+    }
+    /** Merged stdout + stderr. */
+    get output() {
+        return (this.stdout + this.stderr).trimEnd();
+    }
+}
 // =============================================================================
 // Run Command
 // =============================================================================
 /**
  * Run a command and capture output.
+ * When `interactive: true`, inherits all stdio (no capture).
  */
 export const runCommand = (args, options) => {
     const [cmd, ...cmdArgs] = args;
+    const interactive = options?.interactive ?? false;
     return new Promise((resolve) => {
         const child = spawn(cmd, cmdArgs, {
             cwd: options?.cwd,
             env: options?.env ? { ...process.env, ...options.env } : undefined,
-            stdio: [
-                options?.stdin === "inherit" ? "inherit" : "ignore",
-                "pipe",
-                "pipe",
-            ],
+            stdio: interactive
+                ? "inherit"
+                : [
+                    options?.stdin === "inherit" ? "inherit" : "ignore",
+                    "pipe",
+                    "pipe",
+                ],
         });
+        if (interactive) {
+            child.on("error", () => {
+                resolve(new CmdResult(-1, "", ""));
+            });
+            child.on("close", (code) => {
+                resolve(new CmdResult(code ?? 1, "", ""));
+            });
+            return;
+        }
         const stdout = [];
         const stderr = [];
         child.stdout.setEncoding("utf8");
@@ -29,98 +74,24 @@ export const runCommand = (args, options) => {
         child.stdout.on("data", (chunk) => stdout.push(chunk));
         child.stderr.on("data", (chunk) => stderr.push(chunk));
         child.on("error", (error) => {
-            resolve({
-                success: false,
-                code: -1,
-                stdout: "",
-                stderr: error.message,
-            });
+            resolve(new CmdResult(-1, "", error.message));
         });
         child.on("close", (code) => {
-            resolve({
-                success: code === 0,
-                code: code ?? 1,
-                stdout: stdout.join(""),
-                stderr: stderr.join(""),
-            });
+            resolve(new CmdResult(code ?? 1, stdout.join(""), stderr.join("")));
         });
     });
 };
 // =============================================================================
-// Run Command with JSON Output
-// =============================================================================
-/**
- * Run a command that outputs JSON and parse it.
- */
-export const runCommandJson = async (args, options) => {
-    const result = await runCommand(args, options);
-    if (!result.success) {
-        return {
-            success: false,
-            error: result.stderr || `Command failed with code ${result.code}`,
-        };
-    }
-    try {
-        const data = JSON.parse(result.stdout);
-        return { success: true, data };
-    }
-    catch {
-        return {
-            success: false,
-            error: `Failed to parse JSON output: ${result.stdout.slice(0, 100)}`,
-        };
-    }
-};
-// =============================================================================
-// Run with Spinner
+// Wrappers
 // =============================================================================
-/**
- * Run a command while showing a spinner.
- */
-export const runWithSpinner = async (label, args, options) => {
+/** Run with spinner, return CmdResult. */
+export const runQuiet = (label, args, options) => {
     const spinner = new Spinner();
     spinner.start(label);
-    const result = await runCommand(args, options);
-    if (result.success) {
-        spinner.success(label);
-    }
-    else {
-        spinner.fail(label);
-    }
-    return result;
-};
-// =============================================================================
-// Run Quiet
-// =============================================================================
-/**
- * Run a command with spinner and return simplified result.
- */
-export const runQuiet = async (label, args, options) => {
-    const result = await runWithSpinner(label, args, options);
-    return {
-        success: result.success,
-        output: result.stdout + result.stderr,
-    };
-};
-// =============================================================================
-// Run Interactive
-// =============================================================================
-/**
- * Run a command interactively (inherits stdio).
- */
-export const runInteractive = (args, options) => {
-    const [cmd, ...cmdArgs] = args;
-    return new Promise((resolve) => {
-        const child = spawn(cmd, cmdArgs, {
-            cwd: options?.cwd,
-            env: options?.env ? { ...process.env, ...options.env } : undefined,
-            stdio: "inherit",
-        });
-        child.on("error", () => {
-            resolve({ success: false, code: -1 });
-        });
-        child.on("close", (code) => {
-            resolve({ success: (code ?? 1) === 0, code: code ?? 1 });
-        });
+    return runCommand(args, options).then((r) => {
+        r.ok ? spinner.success(label) : spinner.fail(label);
+        return r;
     });
 };
+/** Run and parse stdout as JSON. */
+export const runJson = (args, options) => runCommand(args, options).then((r) => r.json());

package/esm/lib/output.d.ts

@@ -12,6 +12,7 @@ export declare class Output<T extends Record<string, unknown>> {
     constructor(jsonMode: boolean);
     done(data: T): this;
     fail(error: string, data?: Record<string, unknown>): this;
+    print(): void;
     ok(text: string): this;
     err(text: string): this;
     info(text: string): this;
@@ -25,7 +26,6 @@ export declare class Output<T extends Record<string, unknown>> {
         fail(msg: string): void;
         stop(): void;
     };
-    print(): void;
     die(message: string): never;
     isJson(): boolean;
 }

package/esm/lib/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAmB9B,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,OAAO,CAAC,MAAM,CAGE;IAChB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,EAAE,OAAO;IAS7B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMnB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASzD,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,IAAI,IAAI;IAMb,OAAO,CACL,OAAO,EAAE,MAAM,GACd;QAAE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,IAAI,IAAI,CAAA;KAAE;IAkBxE,KAAK,IAAI,IAAI;IAOb,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAU3B,MAAM,IAAI,OAAO;CAGlB;AAMD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,CAAC,CAAC,CAEX"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAmB9B,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,qBAAa,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,OAAO,CAAC,MAAM,CAGE;IAChB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,EAAE,OAAO;IAS7B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAMnB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKzD,KAAK,IAAI,IAAI;IAUb,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,IAAI,IAAI;IAKb,OAAO,CACL,OAAO,EAAE,MAAM,GACd;QAAE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,IAAI,IAAI,CAAA;KAAE;IAiBxE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAS3B,MAAM,IAAI,OAAO;CAGlB;AAMD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,CAAC,CAAC,CAEX"}

package/esm/lib/output.js

@@ -26,6 +26,11 @@ export class Output {
         this.result = { ok: false, error, ...data };
         return this;
     }
+    print() {
+        if (this.jsonMode && this.result) {
+            console.log(JSON.stringify(this.result, null, 2));
+        }
+    }
     // ===========================================================================
     // Human-Mode Output (no-op in JSON mode)
     // ===========================================================================
@@ -69,7 +74,6 @@ export class Output {
             console.log();
         return this;
     }
-    // JSON-aware spinner — no-op in JSON mode
     spinner(message) {
         if (this.jsonMode) {
             return { success: () => { }, fail: () => { }, stop: () => { } };
@@ -85,13 +89,6 @@ export class Output {
     // ===========================================================================
     // Terminal Output
     // ===========================================================================
-    // Print result as JSON (no-op in human mode)
-    print() {
-        if (this.jsonMode && this.result) {
-            console.log(JSON.stringify(this.result, null, 2));
-        }
-    }
-    // Fatal error — outputs { ok: false, error } and exits
     die(message) {
         if (this.jsonMode) {
             console.log(JSON.stringify({ ok: false, error: message }, null, 2));
@@ -101,7 +98,6 @@ export class Output {
         }
         dntShim.Deno.exit(1);
     }
-    // Check if in JSON mode
     isJson() {
         return this.jsonMode;
     }

package/esm/lib/result.d.ts

@@ -1,8 +1,20 @@
-export type Result<T, K extends string = string> = ({
-    ok: true;
-} & T) | {
-    ok: false;
-    kind: K;
-    message: string;
-};
+import "../_dnt.polyfills.js";
+export declare class Result<T> {
+    readonly ok: boolean;
+    private readonly _value;
+    private readonly _error;
+    private constructor();
+    static ok<T>(value: T): Result<T>;
+    static err<T = never>(error: string): Result<T>;
+    get value(): T | undefined;
+    get error(): string | undefined;
+    map<U>(fn: (value: T) => U): Result<U>;
+    flatMap<U>(fn: (value: T) => Result<U>): Result<U>;
+    unwrap(): T;
+    unwrapOr(fallback: T): T;
+    match<U>(cases: {
+        ok: (value: T) => U;
+        err: (error: string) => U;
+    }): U;
+}
 //# sourceMappingURL=result.d.ts.map

package/esm/lib/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/lib/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAC3C,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,CAAC,GAClB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/lib/result.ts"],"names":[],"mappings":"AAGA,OAAO,sBAAsB,CAAC;AAG9B,qBAAa,MAAM,CAAC,CAAC;IAEjB,QAAQ,CAAC,EAAE,EAAE,OAAO;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO;IAMP,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAIjC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAI/C,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAEzB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAKtC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAKlD,MAAM,IAAI,CAAC;IAKX,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC;IAIxB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAA;KAAE,GAAG,CAAC;CAGvE"}

package/esm/lib/result.js

@@ -1 +1,47 @@
-export {};
+// =============================================================================
+// Result<T> — Shared Success/Failure Type
+// =============================================================================
+import "../_dnt.polyfills.js";
+export class Result {
+    ok;
+    _value;
+    _error;
+    constructor(ok, _value, _error) {
+        this.ok = ok;
+        this._value = _value;
+        this._error = _error;
+    }
+    static ok(value) {
+        return new Result(true, value, undefined);
+    }
+    static err(error) {
+        return new Result(false, undefined, error);
+    }
+    get value() {
+        return this._value;
+    }
+    get error() {
+        return this._error;
+    }
+    map(fn) {
+        if (this.ok)
+            return Result.ok(fn(this._value));
+        return Result.err(this._error);
+    }
+    flatMap(fn) {
+        if (this.ok)
+            return fn(this._value);
+        return Result.err(this._error);
+    }
+    unwrap() {
+        if (this.ok)
+            return this._value;
+        throw new Error(this._error);
+    }
+    unwrapOr(fallback) {
+        return this.ok ? this._value : fallback;
+    }
+    match(cases) {
+        return this.ok ? cases.ok(this._value) : cases.err(this._error);
+    }
+}