@miosa/cli 1.1.18 → 1.1.20

package/dist/api-validation.d.ts

@@ -1,53 +0,0 @@
-/**
- * Field-level validation errors from the platform API.
- *
- * The API reports rejected fields in a top-level `errors` key, in one of two
- * shapes depending on which validator refused:
- *
- *   Ecto changeset (`Ecto.Changeset.traverse_errors/2`) — a map of field to a
- *   list of messages, possibly nested for embedded schemas:
- *
- *     {"error":{"code":"VALIDATION_FAILED","message":"sandbox template is invalid"},
- *      "errors":{"slug":["a template with this name already exists"]}}
- *
- *   Hand-rolled spec validators (BuildSpec) — a list of objects:
- *
- *     {"error":{"code":"INVALID_BUILDSPEC","message":"BuildSpec is invalid"},
- *      "errors":[{"code":"REQUIRED","field":"from","message":"is required"}]}
- *
- * Neither shape was read before: the CLI only looked at `error.details`, so it
- * fell back to dumping the whole raw response body and the customer saw a JSON
- * blob naming an internal column (2026-08-26 live customer call).
- */
-export interface FieldIssue {
-    /** Server-reported field path, e.g. "slug" or "steps.0.run". */
-    readonly field: string;
-    readonly message: string;
-    readonly code?: string;
-}
-export declare function isUniquenessMessage(message: string): boolean;
-export declare function isServerAssignedField(field: string): boolean;
-export declare function fieldLabel(field: string): string;
-/**
- * Collect field-level issues from an error response body. Returns an empty
- * array when the body carries no per-field detail, so callers can fall back to
- * the top-level message.
- */
-export declare function parseFieldIssues(body: unknown): FieldIssue[];
-export interface RenderedIssues {
-    /** One "field: message" line per issue, already labelled for the caller. */
-    readonly lines: string[];
-    /** Actionable next step, when the issues imply one. */
-    readonly hint?: string;
-}
-/**
- * Turn field issues into the lines the CLI prints.
- *
- * `sentFields` are the top-level keys the CLI actually put in the request body.
- * They are what makes the misattribution guard possible: when the server blames
- * a field the request never set (the `[:tenant_id, :slug]` unique_constraint
- * case, where Ecto attaches a composite-index error to the FIRST field), the
- * CLI must not repeat that blame back to the user as if it were their input.
- */
-export declare function renderFieldIssues(issues: readonly FieldIssue[], sentFields?: readonly string[]): RenderedIssues;
-//# sourceMappingURL=api-validation.d.ts.map

package/dist/api-validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-validation.d.ts","sourceRoot":"","sources":["../src/api-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAuCD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,EAAE,CAY5D;AA0DD,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,cAAc,CAgDhB"}

package/dist/api-validation.js

@@ -1,200 +0,0 @@
-/**
- * Field-level validation errors from the platform API.
- *
- * The API reports rejected fields in a top-level `errors` key, in one of two
- * shapes depending on which validator refused:
- *
- *   Ecto changeset (`Ecto.Changeset.traverse_errors/2`) — a map of field to a
- *   list of messages, possibly nested for embedded schemas:
- *
- *     {"error":{"code":"VALIDATION_FAILED","message":"sandbox template is invalid"},
- *      "errors":{"slug":["a template with this name already exists"]}}
- *
- *   Hand-rolled spec validators (BuildSpec) — a list of objects:
- *
- *     {"error":{"code":"INVALID_BUILDSPEC","message":"BuildSpec is invalid"},
- *      "errors":[{"code":"REQUIRED","field":"from","message":"is required"}]}
- *
- * Neither shape was read before: the CLI only looked at `error.details`, so it
- * fell back to dumping the whole raw response body and the customer saw a JSON
- * blob naming an internal column (2026-08-26 live customer call).
- */
-/**
- * Fields the client never sets: the server assigns them from the credential or
- * from its own request context. A validation error attributed to one of these
- * is a server-side attribution artifact, not something the caller can correct
- * by changing its request.
- */
-const SERVER_ASSIGNED_FIELDS = new Set([
-    "tenant_id",
-    "organization_id",
-    "owner_id",
-    "user_id",
-    "workspace_id",
-    "account_id",
-    "api_key_id",
-]);
-/**
- * Internal column names mapped to the flag or field a caller actually controls.
- * Keeps the CLI from telling someone to fix a field their command has no way
- * to set.
- */
-const FIELD_LABELS = {
-    slug: "name",
-    build_spec: "dockerfile",
-    normalized_build_spec: "dockerfile",
-    dockerfile: "dockerfile",
-    from: "dockerfile (FROM)",
-    steps: "dockerfile (RUN/WORKDIR/ENV steps)",
-    startCmd: "dockerfile (CMD/ENTRYPOINT)",
-    previewPort: "dockerfile (EXPOSE)",
-    artifactPaths: "dockerfile (artifact paths)",
-};
-/** Messages Ecto/Postgres produce for a unique-index violation. */
-const UNIQUENESS_MESSAGE = /has already been taken|already exists|must be unique/i;
-export function isUniquenessMessage(message) {
-    return UNIQUENESS_MESSAGE.test(message);
-}
-export function isServerAssignedField(field) {
-    return SERVER_ASSIGNED_FIELDS.has(rootField(field));
-}
-export function fieldLabel(field) {
-    const root = rootField(field);
-    const mapped = FIELD_LABELS[root];
-    if (!mapped)
-        return field;
-    const rest = field.slice(root.length);
-    return `${mapped}${rest}`;
-}
-function rootField(field) {
-    const dot = field.indexOf(".");
-    return dot === -1 ? field : field.slice(0, dot);
-}
-/**
- * Collect field-level issues from an error response body. Returns an empty
- * array when the body carries no per-field detail, so callers can fall back to
- * the top-level message.
- */
-export function parseFieldIssues(body) {
-    if (!isRecord(body))
-        return [];
-    const candidates = [body["errors"]];
-    if (isRecord(body["error"]))
-        candidates.push(body["error"]["details"]);
-    candidates.push(body["details"]);
-    for (const candidate of candidates) {
-        const issues = collect(candidate, "");
-        if (issues.length > 0)
-            return issues;
-    }
-    return [];
-}
-function collect(value, path) {
-    if (value === null || value === undefined)
-        return [];
-    if (typeof value === "string") {
-        return path === "" ? [] : [{ field: path, message: value }];
-    }
-    if (Array.isArray(value)) {
-        // A list of message strings under a field path, or a list of
-        // {field, message} objects at the top level.
-        return value.flatMap((entry, index) => {
-            if (typeof entry === "string") {
-                return path === "" ? [] : [{ field: path, message: entry }];
-            }
-            if (isRecord(entry) && typeof entry["message"] === "string") {
-                const field = asString(entry["field"]) ?? asString(entry["path"]) ?? path;
-                if (!field)
-                    return [];
-                return [
-                    {
-                        field,
-                        message: entry["message"],
-                        ...(asString(entry["code"])
-                            ? { code: asString(entry["code"]) }
-                            : {}),
-                    },
-                ];
-            }
-            return collect(entry, path === "" ? String(index) : `${path}.${index}`);
-        });
-    }
-    if (isRecord(value)) {
-        // A single {field, message} object.
-        if (typeof value["message"] === "string" && !("errors" in value)) {
-            const field = asString(value["field"]) ?? asString(value["path"]) ?? path;
-            if (field) {
-                return [
-                    {
-                        field,
-                        message: value["message"],
-                        ...(asString(value["code"])
-                            ? { code: asString(value["code"]) }
-                            : {}),
-                    },
-                ];
-            }
-        }
-        return Object.entries(value).flatMap(([key, nested]) => collect(nested, path === "" ? key : `${path}.${key}`));
-    }
-    return [];
-}
-/**
- * Turn field issues into the lines the CLI prints.
- *
- * `sentFields` are the top-level keys the CLI actually put in the request body.
- * They are what makes the misattribution guard possible: when the server blames
- * a field the request never set (the `[:tenant_id, :slug]` unique_constraint
- * case, where Ecto attaches a composite-index error to the FIRST field), the
- * CLI must not repeat that blame back to the user as if it were their input.
- */
-export function renderFieldIssues(issues, sentFields = []) {
-    if (issues.length === 0)
-        return { lines: [] };
-    const sent = new Set(sentFields);
-    const lines = [];
-    const hints = [];
-    for (const issue of issues) {
-        const root = rootField(issue.field);
-        const misattributed = isServerAssignedField(issue.field) &&
-            !sent.has(root) &&
-            isUniquenessMessage(issue.message);
-        if (misattributed) {
-            // The request never carried this field, so the caller cannot act on it.
-            // Report the collision as a collision and name the misattribution
-            // instead of parroting an internal column back at the user.
-            const collided = nameLikeField(sentFields);
-            lines.push(collided
-                ? `${collided}: already used by one of your existing resources`
-                : "already exists: this resource is already registered");
-            lines.push(`(the server reported this against "${issue.field}", ` +
-                `which this command did not send - treat it as a duplicate, not a tenancy problem)`);
-            hints.push(collided
-                ? `Pick a different --${collided}, or remove the existing one first.`
-                : "Pick a different name, or remove the existing resource first.");
-            continue;
-        }
-        lines.push(`${fieldLabel(issue.field)}: ${issue.message}`);
-        if (isUniquenessMessage(issue.message)) {
-            const label = fieldLabel(issue.field);
-            hints.push(`Pick a different --${label}, or remove the existing one first.`);
-        }
-    }
-    const hint = hints[0];
-    return hint === undefined ? { lines } : { lines, hint };
-}
-/** The most name-like field the request actually sent, for a duplicate hint. */
-function nameLikeField(sentFields) {
-    for (const candidate of ["name", "slug", "title", "id"]) {
-        if (sentFields.includes(candidate))
-            return candidate === "slug" ? "name" : candidate;
-    }
-    return undefined;
-}
-function asString(value) {
-    return typeof value === "string" && value !== "" ? value : undefined;
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-//# sourceMappingURL=api-validation.js.map

package/dist/api-validation.js.map

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

package/dist/endpoint.d.ts

@@ -1,37 +0,0 @@
-/**
- * Endpoint resolution and transport-failure diagnosis.
- *
- * A CLI that cannot resolve its API host must say which host it tried, where
- * that host came from, and how to change it. The bare
- * `Network error: getaddrinfo ENOTFOUND <host>` it printed before named the
- * host but nothing else, leaving no way to tell a typo in `MIOSA_ENDPOINT`
- * apart from a typo in `~/.miosa/config.json` apart from real DNS trouble
- * (2026-08-26 live customer call).
- */
-import { NetworkError } from "./errors.js";
-export declare const DEFAULT_ENDPOINT = "https://api.miosa.ai";
-export type EndpointSource = "MIOSA_ENDPOINT" | "config-file" | "built-in-default";
-export interface EndpointOrigin {
-    readonly source: EndpointSource;
-    /** Human description of where the value lives, and how to change it. */
-    readonly where: string;
-    readonly fix: string;
-}
-/**
- * Work out where the endpoint currently in use came from. Mirrors the
- * precedence in `loadConfig`: MIOSA_ENDPOINT, then the config file, then the
- * built-in default.
- */
-export declare function endpointOrigin(endpoint: string): EndpointOrigin;
-/**
- * Reject an endpoint that is not a usable absolute http(s) URL before any
- * request is attempted. Undici's own failure for this is the opaque
- * `TypeError: Invalid URL`, which does not even echo the offending value.
- */
-export declare function assertUsableEndpoint(endpoint: string): void;
-/**
- * Build a NetworkError that names the host, the config value behind it, and
- * the command that changes it.
- */
-export declare function transportError(err: unknown, endpoint: string): NetworkError;
-//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,MAAM,MAAM,cAAc,GACxB,gBAAgB,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAyB/D;AAaD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkB3D;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuC3E"}

package/dist/endpoint.js

@@ -1,123 +0,0 @@
-/**
- * Endpoint resolution and transport-failure diagnosis.
- *
- * A CLI that cannot resolve its API host must say which host it tried, where
- * that host came from, and how to change it. The bare
- * `Network error: getaddrinfo ENOTFOUND <host>` it printed before named the
- * host but nothing else, leaving no way to tell a typo in `MIOSA_ENDPOINT`
- * apart from a typo in `~/.miosa/config.json` apart from real DNS trouble
- * (2026-08-26 live customer call).
- */
-import { getConfigPath } from "./config.js";
-import { NetworkError, UserError } from "./errors.js";
-export const DEFAULT_ENDPOINT = "https://api.miosa.ai";
-/**
- * Work out where the endpoint currently in use came from. Mirrors the
- * precedence in `loadConfig`: MIOSA_ENDPOINT, then the config file, then the
- * built-in default.
- */
-export function endpointOrigin(endpoint) {
-    const fromEnv = process.env["MIOSA_ENDPOINT"];
-    const normalized = endpoint.replace(/\/$/, "");
-    if (fromEnv && fromEnv.replace(/\/$/, "") === normalized) {
-        return {
-            source: "MIOSA_ENDPOINT",
-            where: "the MIOSA_ENDPOINT environment variable",
-            fix: `unset MIOSA_ENDPOINT   (or: export MIOSA_ENDPOINT=${DEFAULT_ENDPOINT})`,
-        };
-    }
-    if (normalized === DEFAULT_ENDPOINT) {
-        return {
-            source: "built-in-default",
-            where: `the built-in default (${DEFAULT_ENDPOINT})`,
-            fix: `miosa config set api_url ${DEFAULT_ENDPOINT}`,
-        };
-    }
-    return {
-        source: "config-file",
-        where: `"endpoint" in ${configFileForDisplay()}`,
-        fix: `miosa config set api_url ${DEFAULT_ENDPOINT}`,
-    };
-}
-/**
- * Config file path for the message. Tolerates a stubbed config module (unit
- * tests replace it wholesale) by degrading to the documented location rather
- * than crashing the error path that is meant to explain a failure.
- */
-function configFileForDisplay() {
-    return typeof getConfigPath === "function"
-        ? getConfigPath()
-        : "~/.miosa/config.json";
-}
-/**
- * Reject an endpoint that is not a usable absolute http(s) URL before any
- * request is attempted. Undici's own failure for this is the opaque
- * `TypeError: Invalid URL`, which does not even echo the offending value.
- */
-export function assertUsableEndpoint(endpoint) {
-    const origin = endpointOrigin(endpoint);
-    let parsed;
-    try {
-        parsed = new URL(endpoint);
-    }
-    catch {
-        throw new UserError(`The MIOSA API endpoint is not a valid URL: ${JSON.stringify(endpoint)}`, `It is set in ${origin.where}. An endpoint must include the scheme, ` +
-            `for example ${DEFAULT_ENDPOINT}. Fix it with: ${origin.fix}`);
-    }
-    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
-        throw new UserError(`The MIOSA API endpoint must be http or https, got ${JSON.stringify(endpoint)}`, `It is set in ${origin.where}. Fix it with: ${origin.fix}`);
-    }
-}
-/** Walk `err.cause` for the first entry carrying an errno-style `code`. */
-function transportCause(err) {
-    let current = err;
-    for (let depth = 0; depth < 6 && current !== null && typeof current === "object"; depth += 1) {
-        const candidate = current;
-        if (typeof candidate.code === "string")
-            return candidate;
-        current = candidate.cause;
-    }
-    return undefined;
-}
-/**
- * Build a NetworkError that names the host, the config value behind it, and
- * the command that changes it.
- */
-export function transportError(err, endpoint) {
-    const origin = endpointOrigin(endpoint);
-    const raw = err instanceof Error ? err.message : String(err);
-    const cause = transportCause(err);
-    const code = typeof cause?.code === "string" ? cause.code : undefined;
-    let host;
-    try {
-        host = new URL(endpoint).host;
-    }
-    catch {
-        host = endpoint;
-    }
-    const detail = (() => {
-        switch (code) {
-            case "ENOTFOUND":
-            case "EAI_AGAIN":
-                return `DNS lookup failed for host "${host}" (${code}). That hostname does not resolve from this machine.`;
-            case "ECONNREFUSED":
-                return `The host "${host}" refused the connection (ECONNREFUSED). It resolved, but nothing is listening on that port.`;
-            case "ETIMEDOUT":
-            case "UND_ERR_CONNECT_TIMEOUT":
-                return `Connecting to "${host}" timed out (${code}).`;
-            case "CERT_HAS_EXPIRED":
-            case "DEPTH_ZERO_SELF_SIGNED_CERT":
-            case "UNABLE_TO_VERIFY_LEAF_SIGNATURE":
-                return `TLS verification failed for "${host}" (${code}).`;
-            default:
-                return `Could not reach "${host}": ${raw}`;
-        }
-    })();
-    const hint = code === "ENOTFOUND" || code === "EAI_AGAIN"
-        ? `The endpoint ${endpoint} comes from ${origin.where}. ` +
-            `Check it for a typo, then: ${origin.fix}`
-        : `The endpoint ${endpoint} comes from ${origin.where}. ` +
-            `Verify it with "miosa config get api_url", or change it: ${origin.fix}`;
-    return new NetworkError(`Cannot reach the MIOSA API. ${detail}`, hint);
-}
-//# sourceMappingURL=endpoint.js.map

package/dist/endpoint.js.map

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