@cardelli/ambit 0.1.4 → 0.2.0

package/esm/lib/command.d.ts

@@ -1,54 +1,26 @@
-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 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":"AAKA,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,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

@@ -1,27 +1,70 @@
 // =============================================================================
 // Shell Command Helpers
 // =============================================================================
-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 +72,15 @@ 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
-// =============================================================================
-/**
- * Run a command while showing a spinner.
- */
-export const runWithSpinner = async (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
+// Wrappers
 // =============================================================================
-/**
- * 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 });
-        });
-    });
-};
+/** Run and parse stdout as JSON. */
+export const runJson = (args, options) => runCommand(args, options).then((r) => r.json());

package/esm/lib/machine.d.ts

@@ -0,0 +1,11 @@
+import { Result } from "./result.js";
+/** A state machine phase with a transition function. */
+export interface Machine<Phase extends string, Ctx> {
+    /** The terminal phase — when reached, the machine stops. */
+    terminal: Phase;
+    /** Execute the transition for the given phase. Returns the next phase. */
+    transition: (phase: Phase, ctx: Ctx) => Promise<Result<Phase>>;
+}
+/** Run a state machine from an initial phase to its terminal phase. */
+export declare const runMachine: <Phase extends string, Ctx>(machine: Machine<Phase, Ctx>, initial: Phase, ctx: Ctx) => Promise<Result<Phase>>;
+//# sourceMappingURL=machine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../src/lib/machine.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,wDAAwD;AACxD,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,MAAM,EAAE,GAAG;IAChD,4DAA4D;IAC5D,QAAQ,EAAE,KAAK,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CAChE;AAED,uEAAuE;AACvE,eAAO,MAAM,UAAU,GAAU,KAAK,SAAS,MAAM,EAAE,GAAG,EACxD,SAAS,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAC5B,SAAS,KAAK,EACd,KAAK,GAAG,KACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAQvB,CAAC"}

package/esm/lib/machine.js

@@ -0,0 +1,15 @@
+// =============================================================================
+// State Machine - Hydrate → Interpret → Run Pattern
+// =============================================================================
+import { Result } from "./result.js";
+/** Run a state machine from an initial phase to its terminal phase. */
+export const runMachine = async (machine, initial, ctx) => {
+    let phase = initial;
+    while (phase !== machine.terminal) {
+        const result = await machine.transition(phase, ctx);
+        if (!result.ok)
+            return result;
+        phase = result.value;
+    }
+    return Result.ok(phase);
+};

package/esm/lib/output.d.ts

@@ -1,4 +1,3 @@
-import "../_dnt.polyfills.js";
 export type SuccessResult<T> = {
     ok: true;
 } & T;
@@ -12,6 +11,8 @@ 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;
+    skip(text: string): this;
     ok(text: string): this;
     err(text: string): this;
     info(text: string): this;
@@ -25,7 +26,7 @@ export declare class Output<T extends Record<string, unknown>> {
         fail(msg: string): void;
         stop(): void;
     };
-    print(): void;
+    spin<R>(label: string, fn: () => Promise<R>): Promise<R>;
     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":"AAkBA,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,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,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;IAiBlE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB9D,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

@@ -1,8 +1,6 @@
 // =============================================================================
 // Output - Unified Output Handling for CLI Commands
 // =============================================================================
-import "../_dnt.polyfills.js";
-import * as dntShim from "../_dnt.shims.js";
 import { bold, dim, Spinner, statusErr, statusInfo, statusOk, statusWarn, } from "./cli.js";
 // =============================================================================
 // Output Class
@@ -26,9 +24,19 @@ 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)
     // ===========================================================================
+    skip(text) {
+        if (!this.jsonMode)
+            console.log(dim(`~ ${text}`));
+        return this;
+    }
     ok(text) {
         if (!this.jsonMode)
             statusOk(text);
@@ -69,7 +77,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: () => { } };
@@ -83,15 +90,23 @@ export class Output {
         };
     }
     // ===========================================================================
-    // Terminal Output
+    // Async Spinner Wrapper
     // ===========================================================================
-    // Print result as JSON (no-op in human mode)
-    print() {
-        if (this.jsonMode && this.result) {
-            console.log(JSON.stringify(this.result, null, 2));
+    async spin(label, fn) {
+        const s = this.spinner(label);
+        try {
+            const result = await fn();
+            s.success(label);
+            return result;
+        }
+        catch (e) {
+            s.fail(label);
+            throw e;
         }
     }
-    // Fatal error — outputs { ok: false, error } and exits
+    // ===========================================================================
+    // Terminal Output
+    // ===========================================================================
     die(message) {
         if (this.jsonMode) {
             console.log(JSON.stringify({ ok: false, error: message }, null, 2));
@@ -99,9 +114,8 @@ export class Output {
         else {
             statusErr(message);
         }
-        dntShim.Deno.exit(1);
+        throw new Error("exit");
     }
-    // Check if in JSON mode
     isJson() {
         return this.jsonMode;
     }

package/esm/lib/result.d.ts

@@ -1,8 +1,19 @@
-export type Result<T, K extends string = string> = ({
-    ok: true;
-} & T) | {
-    ok: false;
-    kind: K;
-    message: string;
-};
+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":"AAIA,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,46 @@
-export {};
+// =============================================================================
+// Result<T> — Shared Success/Failure Type
+// =============================================================================
+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);
+    }
+}

package/esm/main.d.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import "./_dnt.polyfills.js";
-import "./src/cli/commands/create.js";
-import "./src/cli/commands/deploy.js";
-import "./src/cli/commands/list.js";
-import "./src/cli/commands/status.js";
-import "./src/cli/commands/destroy.js";
-import "./src/cli/commands/doctor.js";
+import "./cli/commands/create/index.js";
+import "./cli/commands/deploy/index.js";
+import "./cli/commands/list.js";
+import "./cli/commands/status.js";
+import "./cli/commands/destroy/index.js";
+import "./cli/commands/doctor.js";
 //# sourceMappingURL=main.d.ts.map

package/esm/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC;AA+B7B,OAAO,8BAA8B,CAAC;AACtC,OAAO,8BAA8B,CAAC;AACtC,OAAO,4BAA4B,CAAC;AACpC,OAAO,8BAA8B,CAAC;AACtC,OAAO,+BAA+B,CAAC;AACvC,OAAO,8BAA8B,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,qBAAqB,CAAC;AA8B7B,OAAO,gCAAgC,CAAC;AACxC,OAAO,gCAAgC,CAAC;AACxC,OAAO,wBAAwB,CAAC;AAChC,OAAO,0BAA0B,CAAC;AAClC,OAAO,iCAAiC,CAAC;AACzC,OAAO,0BAA0B,CAAC"}

package/esm/main.js

@@ -24,21 +24,19 @@ import * as dntShim from "./_dnt.shims.js";
 //   ambit doctor
 //
 // =============================================================================
-import { runCli } from "./src/cli/mod.js";
+import { runCli } from "./cli/mod.js";
 import { Spinner, statusErr } from "./lib/cli.js";
-// Import commands to register them
-import "./src/cli/commands/create.js";
-import "./src/cli/commands/deploy.js";
-import "./src/cli/commands/list.js";
-import "./src/cli/commands/status.js";
-import "./src/cli/commands/destroy.js";
-import "./src/cli/commands/doctor.js";
+import "./cli/commands/create/index.js";
+import "./cli/commands/deploy/index.js";
+import "./cli/commands/list.js";
+import "./cli/commands/status.js";
+import "./cli/commands/destroy/index.js";
+import "./cli/commands/doctor.js";
 // =============================================================================
 // Main
 // =============================================================================
 const main = async () => {
     const spinner = new Spinner();
-    // Handle signals
     try {
         dntShim.Deno.addSignalListener("SIGINT", () => {
             spinner.stop();

package/esm/providers/fly.d.ts

@@ -0,0 +1,81 @@
+import { type FlyApp, type FlyAppInfo, type FlyIp, type FlyMachine } from "../schemas/fly.js";
+/**
+ * Thrown when a `fly deploy` command fails. Carries the raw stderr so callers
+ * can surface it through `out` (respecting JSON mode) instead of printing
+ * directly.
+ */
+export declare class FlyDeployError extends Error {
+    /** Last meaningful line from flyctl stderr. */
+    readonly detail: string;
+    constructor(app: string, stderr: string);
+}
+export type MachineSize = "shared-cpu-1x" | "shared-cpu-2x" | "shared-cpu-4x";
+export interface MachineConfig {
+    size: MachineSize;
+    memoryMb?: number;
+    region?: string;
+    autoStopSeconds?: number;
+}
+export interface MachineResult {
+    id: string;
+    state: string;
+    size: string;
+    region: string;
+    privateIp?: string;
+}
+export interface SafeDeployOptions {
+    image?: string;
+    config?: string;
+    region?: string;
+    routerId?: string;
+}
+export interface FlyProvider {
+    auth: {
+        ensureInstalled(): Promise<void>;
+        login(opts?: {
+            interactive?: boolean;
+        }): Promise<string>;
+        getToken(): Promise<string>;
+    };
+    orgs: {
+        list(): Promise<Record<string, string>>;
+    };
+    apps: {
+        list(org?: string): Promise<FlyApp[]>;
+        listWithNetwork(org: string): Promise<FlyAppInfo[]>;
+        create(name: string, org: string, opts?: {
+            network?: string;
+            routerId?: string;
+        }): Promise<void>;
+        delete(name: string): Promise<void>;
+        exists(name: string): Promise<boolean>;
+        getConfig(name: string): Promise<Record<string, unknown> | null>;
+    };
+    machines: {
+        list(app: string): Promise<FlyMachine[]>;
+        clone(app: string, config: MachineConfig): Promise<MachineResult>;
+        destroy(app: string, machineId: string): Promise<void>;
+    };
+    secrets: {
+        set(app: string, secrets: Record<string, string>, opts?: {
+            stage?: boolean;
+        }): Promise<void>;
+    };
+    ips: {
+        list(app: string): Promise<FlyIp[]>;
+        release(app: string, address: string): Promise<void>;
+        allocateFlycast(app: string, network: string): Promise<void>;
+    };
+    certs: {
+        list(app: string): Promise<string[]>;
+        remove(app: string, hostname: string): Promise<void>;
+    };
+    deploy: {
+        router(app: string, dir: string, config?: {
+            region?: string;
+        }): Promise<void>;
+        app(app: string, options: SafeDeployOptions): Promise<void>;
+    };
+}
+export declare const createFlyProvider: () => FlyProvider;
+//# sourceMappingURL=fly.d.ts.map

package/esm/providers/fly.d.ts.map

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