@zenalexa/unicli 0.211.2 → 0.212.1

package/dist/transport/adapters/http.d.ts

@@ -0,0 +1,40 @@
+/**
+ * HttpTransport — wraps Node's native `fetch` behind the TransportAdapter
+ * interface.
+ *
+ * This is the transport for API-level steps: `fetch`, `fetch_text`,
+ * `parse_rss`, `html_to_md`, and HTTP-based `download`. The existing
+ * `src/engine/yaml-runner.ts` step bodies remain the canonical executor
+ * for v0.212 — this wrapper exposes the same primitives through the
+ * uniform `action()` / `snapshot()` / `open()` / `close()` contract so
+ * the new bus-driven dispatch path works today.
+ *
+ * Contract:
+ *  - `action()` NEVER throws — all failures become an `err()` envelope
+ *  - `capability.steps` is the single source of truth for dispatch
+ *  - `snapshot()` returns the last HTTP response body as JSON
+ */
+import type { ActionRequest, ActionResult, Capability, Snapshot, SnapshotFormat, TransportAdapter, TransportContext, TransportKind } from "../types.js";
+/**
+ * HttpTransport wraps Node's native `fetch` so the bus can route HTTP
+ * pipeline steps through a uniform envelope contract.
+ */
+export declare class HttpTransport implements TransportAdapter {
+    readonly kind: TransportKind;
+    readonly capability: Capability;
+    private ctx;
+    private lastEnvelope;
+    private lastBodyPreview;
+    open(ctx: TransportContext): Promise<void>;
+    snapshot(opts?: {
+        format?: SnapshotFormat;
+    }): Promise<Snapshot>;
+    action<T = unknown>(req: ActionRequest): Promise<ActionResult<T>>;
+    close(): Promise<void>;
+    private buildUrl;
+    private buildHeaders;
+    private doFetchJson;
+    private doFetchText;
+    private doDownload;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/adapters/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,aAAa,CAAC;AA0BrB;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAU;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAmB;IAElD,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,eAAe,CAAqB;IAEtC,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAS/D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAiDjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,YAAY;YAaN,WAAW;YA2GX,WAAW;YAqEX,UAAU;CA8DzB"}

package/dist/transport/adapters/http.js

@@ -0,0 +1,353 @@
+/**
+ * HttpTransport — wraps Node's native `fetch` behind the TransportAdapter
+ * interface.
+ *
+ * This is the transport for API-level steps: `fetch`, `fetch_text`,
+ * `parse_rss`, `html_to_md`, and HTTP-based `download`. The existing
+ * `src/engine/yaml-runner.ts` step bodies remain the canonical executor
+ * for v0.212 — this wrapper exposes the same primitives through the
+ * uniform `action()` / `snapshot()` / `open()` / `close()` contract so
+ * the new bus-driven dispatch path works today.
+ *
+ * Contract:
+ *  - `action()` NEVER throws — all failures become an `err()` envelope
+ *  - `capability.steps` is the single source of truth for dispatch
+ *  - `snapshot()` returns the last HTTP response body as JSON
+ */
+import { USER_AGENT } from "../../constants.js";
+import { err, exitCodeFor, ok } from "../../core/envelope.js";
+import { assertSafeRequestUrl } from "../../engine/yaml-runner.js";
+/** Steps this transport declares support for. */
+const HTTP_STEPS = [
+    "fetch",
+    "fetch_text",
+    "parse_rss",
+    "html_to_md",
+    "download",
+];
+const HTTP_CAPABILITY = {
+    steps: HTTP_STEPS,
+    snapshotFormats: ["json", "text"],
+    mutatesHost: false,
+};
+/**
+ * HttpTransport wraps Node's native `fetch` so the bus can route HTTP
+ * pipeline steps through a uniform envelope contract.
+ */
+export class HttpTransport {
+    kind = "http";
+    capability = HTTP_CAPABILITY;
+    ctx;
+    lastEnvelope;
+    lastBodyPreview;
+    async open(ctx) {
+        this.ctx = ctx;
+    }
+    async snapshot(opts) {
+        const format = opts?.format ?? "json";
+        const payload = this.lastEnvelope ?? { ok: true, data: null };
+        if (format === "text") {
+            return { format: "text", data: this.lastBodyPreview ?? "" };
+        }
+        return { format: "json", data: JSON.stringify(payload) };
+    }
+    async action(req) {
+        const start = Date.now();
+        try {
+            switch (req.kind) {
+                case "fetch": {
+                    const envelope = await this.doFetchJson(req.params);
+                    this.lastEnvelope = envelope;
+                    envelope.elapsedMs = Date.now() - start;
+                    return envelope;
+                }
+                case "fetch_text": {
+                    const envelope = await this.doFetchText(req.params);
+                    this.lastEnvelope = envelope;
+                    envelope.elapsedMs = Date.now() - start;
+                    return envelope;
+                }
+                case "download": {
+                    const envelope = await this.doDownload(req.params);
+                    this.lastEnvelope = envelope;
+                    envelope.elapsedMs = Date.now() - start;
+                    return envelope;
+                }
+                default:
+                    return err({
+                        transport: "http",
+                        step: 0,
+                        action: req.kind,
+                        reason: `unsupported action "${req.kind}" for http transport`,
+                        suggestion: `http transport supports: ${HTTP_STEPS.join(", ")}`,
+                        minimum_capability: `http.${req.kind}`,
+                        exit_code: exitCodeFor("usage_error"),
+                    });
+            }
+        }
+        catch (e) {
+            // Safety net — action() must never throw.
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: req.kind,
+                reason: `unexpected error in http.${req.kind}: ${msg}`,
+                suggestion: "inspect the transport input or file a bug report",
+                retryable: false,
+            });
+        }
+    }
+    async close() {
+        // Stateless wrapper — nothing to release. Idempotent by construction.
+        this.ctx = undefined;
+    }
+    // ── internals ────────────────────────────────────────────────────
+    buildUrl(raw, params) {
+        if (!params)
+            return raw;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            sp.set(k, String(v));
+        }
+        return raw + (raw.includes("?") ? "&" : "?") + sp.toString();
+    }
+    buildHeaders(extra, accept) {
+        const headers = {
+            "User-Agent": USER_AGENT,
+            ...(accept ? { Accept: accept } : {}),
+            ...(extra ?? {}),
+        };
+        if (this.ctx?.cookieHeader)
+            headers["Cookie"] = this.ctx.cookieHeader;
+        return headers;
+    }
+    async doFetchJson(p) {
+        const url = typeof p.url === "string" ? p.url : undefined;
+        if (!url) {
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch",
+                reason: "missing required param `url`",
+                suggestion: "pass params.url to the fetch action",
+                retryable: false,
+                exit_code: exitCodeFor("usage_error"),
+            });
+        }
+        try {
+            assertSafeRequestUrl(url);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch",
+                reason: msg,
+                suggestion: "remove loopback/metadata hosts or set UNICLI_ALLOW_LOCAL=1 for local development",
+                retryable: false,
+                exit_code: exitCodeFor("config_error"),
+            });
+        }
+        const method = typeof p.method === "string" ? p.method : "GET";
+        const params = p.params && typeof p.params === "object"
+            ? p.params
+            : undefined;
+        const extraHeaders = p.headers && typeof p.headers === "object"
+            ? p.headers
+            : undefined;
+        const headers = this.buildHeaders(extraHeaders, "application/json");
+        const init = { method, headers };
+        if (p.body !== undefined && method !== "GET") {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(p.body);
+        }
+        try {
+            const resp = await fetch(this.buildUrl(url, params), init);
+            if (!resp.ok) {
+                let preview = "";
+                try {
+                    preview = (await resp.text()).slice(0, 200);
+                }
+                catch {
+                    /* ignore */
+                }
+                this.lastBodyPreview = preview;
+                const retryable = resp.status === 429 ||
+                    resp.status === 500 ||
+                    resp.status === 502 ||
+                    resp.status === 503;
+                return err({
+                    transport: "http",
+                    step: 0,
+                    action: "fetch",
+                    reason: `HTTP ${resp.status} ${resp.statusText} from ${url}`,
+                    suggestion: resp.status === 401 || resp.status === 403
+                        ? `authentication required — run \`unicli auth setup <site>\``
+                        : resp.status === 404
+                            ? `endpoint not found — check the URL path`
+                            : `HTTP ${resp.status} — inspect the response or retry later`,
+                    retryable,
+                    exit_code: resp.status === 401 || resp.status === 403
+                        ? exitCodeFor("auth_required")
+                        : retryable
+                            ? exitCodeFor("temp_failure")
+                            : exitCodeFor("service_unavailable"),
+                });
+            }
+            const data = (await resp.json());
+            try {
+                this.lastBodyPreview = JSON.stringify(data).slice(0, 200);
+            }
+            catch {
+                this.lastBodyPreview = "";
+            }
+            return ok(data);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            const transient = /timeout|ETIMEDOUT|ECONNREFUSED|ECONNRESET|socket hang up/i.test(msg);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch",
+                reason: msg,
+                suggestion: transient
+                    ? "transient network error — retry with backoff"
+                    : "inspect the URL, DNS, or TLS configuration",
+                retryable: transient,
+                exit_code: transient
+                    ? exitCodeFor("temp_failure")
+                    : exitCodeFor("generic_error"),
+            });
+        }
+    }
+    async doFetchText(p) {
+        const url = typeof p.url === "string" ? p.url : undefined;
+        if (!url) {
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch_text",
+                reason: "missing required param `url`",
+                suggestion: "pass params.url to the fetch_text action",
+                retryable: false,
+                exit_code: exitCodeFor("usage_error"),
+            });
+        }
+        try {
+            assertSafeRequestUrl(url);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch_text",
+                reason: msg,
+                suggestion: "remove loopback/metadata hosts or set UNICLI_ALLOW_LOCAL=1 for local development",
+                retryable: false,
+                exit_code: exitCodeFor("config_error"),
+            });
+        }
+        const method = typeof p.method === "string" ? p.method : "GET";
+        const extraHeaders = p.headers && typeof p.headers === "object"
+            ? p.headers
+            : undefined;
+        try {
+            const resp = await fetch(url, {
+                method,
+                headers: this.buildHeaders(extraHeaders),
+            });
+            if (!resp.ok) {
+                return err({
+                    transport: "http",
+                    step: 0,
+                    action: "fetch_text",
+                    reason: `HTTP ${resp.status} ${resp.statusText} from ${url}`,
+                    suggestion: `check if the URL is still valid: ${url}`,
+                    retryable: resp.status === 429 ||
+                        resp.status === 500 ||
+                        resp.status === 502 ||
+                        resp.status === 503,
+                    exit_code: exitCodeFor("service_unavailable"),
+                });
+            }
+            const text = await resp.text();
+            this.lastBodyPreview = text.slice(0, 200);
+            return ok(text);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "fetch_text",
+                reason: msg,
+                suggestion: "inspect the URL or the network configuration",
+                retryable: /timeout|ETIMEDOUT|ECONNREFUSED|ECONNRESET/i.test(msg),
+            });
+        }
+    }
+    async doDownload(p) {
+        const url = typeof p.url === "string" ? p.url : undefined;
+        const dest = typeof p.dest === "string" ? p.dest : undefined;
+        if (!url || !dest) {
+            return err({
+                transport: "http",
+                step: 0,
+                action: "download",
+                reason: "download requires params.url and params.dest",
+                suggestion: "pass both `url` and `dest` (absolute file path)",
+                retryable: false,
+                exit_code: exitCodeFor("usage_error"),
+            });
+        }
+        try {
+            assertSafeRequestUrl(url);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "download",
+                reason: msg,
+                suggestion: "download target must be a public http(s) URL — set UNICLI_ALLOW_LOCAL=1 to override",
+                retryable: false,
+                exit_code: exitCodeFor("config_error"),
+            });
+        }
+        try {
+            const { httpDownload } = await import("../../engine/download.js");
+            const headers = {};
+            if (this.ctx?.cookieHeader)
+                headers["Cookie"] = this.ctx.cookieHeader;
+            const result = await httpDownload(url, dest, headers);
+            if (result.status !== "success" || !result.path) {
+                return err({
+                    transport: "http",
+                    step: 0,
+                    action: "download",
+                    reason: result.error ?? `download failed with status ${result.status}`,
+                    suggestion: "inspect the URL, dest path, and network",
+                    retryable: false,
+                });
+            }
+            return ok({ path: result.path, size: result.size ?? 0 });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return err({
+                transport: "http",
+                step: 0,
+                action: "download",
+                reason: msg,
+                suggestion: "verify url reachability and destination directory permissions",
+                retryable: /timeout|ETIMEDOUT|ECONNREFUSED|ECONNRESET/i.test(msg),
+            });
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/adapters/http.js.map

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

package/dist/transport/adapters/subprocess.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SubprocessTransport — wraps `child_process.spawn` behind the
+ * TransportAdapter interface.
+ *
+ * Mirrors the contract of the existing yaml-runner `exec` step
+ * (command + args + stdin + env + cwd + timeout) and adds a lightweight
+ * event stream (`stream()`) for callers that want to observe stdout/stderr
+ * chunks as they arrive.
+ */
+import type { ActionRequest, ActionResult, Capability, Snapshot, SnapshotFormat, TransportAdapter, TransportContext, TransportEvent, TransportKind } from "../types.js";
+export declare class SubprocessTransport implements TransportAdapter {
+    readonly kind: TransportKind;
+    readonly capability: Capability;
+    private ctx;
+    private readonly queue;
+    private lastOutcome;
+    open(ctx: TransportContext): Promise<void>;
+    snapshot(opts?: {
+        format?: SnapshotFormat;
+    }): Promise<Snapshot>;
+    action<T = unknown>(req: ActionRequest): Promise<ActionResult<T>>;
+    /** Optional event stream — drains stdout/stderr pushed by `doExec`. */
+    stream(): AsyncIterable<TransportEvent>;
+    close(): Promise<void>;
+    private doExec;
+}
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/transport/adapters/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/subprocess.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AA8DrB,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAgB;IAC5C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAyB;IAExD,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,WAAW,CAA0B;IAEvC,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAW/D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA8CvE,uEAAuE;IACvE,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC;IAmBjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,MAAM;CA0HrB"}