@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/lib/envelopes.js

@@ -0,0 +1,598 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { formatYaml } from "./output.js";
+/**
+ * Cross-CLI envelope ABI (#128) — discriminated-union wire shape for
+ * write-success and error responses, plus the top-level list envelope.
+ *
+ * The envelope locks the public-API contract for the JSON output:
+ * pre-`v1.0` (`0.x`) signals "expect breaking changes"; `v1.0` onward,
+ * any JSON shape change is a breaking-change release (semver-major).
+ *
+ * Discriminators:
+ *
+ * - `ok: true | false` separates success from error.
+ * - `operation: string` (e.g., `"profile.skills.add"`) identifies the
+ *   verb so consumers can branch without parsing the command path.
+ * - For success: `created` / `updated` / `removed` field name selects
+ *   the verb (add / update / remove respectively). Mutually exclusive.
+ * - For errors: `errors[]` is ALWAYS plural — even single-error cases
+ *   ship a 1-element array so consumers don't branch on 1-vs-N shape.
+ *
+ * Routing (per `emitErrorAndExit`):
+ *
+ * - `--output=json` errors → STDOUT (machine consumers read structured
+ *   payload regardless of exit code).
+ * - `--output=yaml` errors → STDOUT (same reasoning).
+ * - `--output=pretty` errors → STDERR human-formatted block; STDOUT
+ *   stays clean.
+ * - Exit code is nonzero on error in all formats; `0` on success.
+ *
+ * The version string is hard-coded `"1.0"` here. Bumping to `"1.1"`
+ * signals an additive (non-breaking) change; bumping to `"2.0"`
+ * signals a breaking change — both are forward-evolution levers
+ * consumers may discriminate on.
+ */
+export const ENVELOPE_VERSION = "1.0";
+/**
+ * Wrap an array as the v0.4+ list envelope (`{version, items,
+ * pageInfo?}`). The `version` field is required (locked at `"1.0"`)
+ * so wire consumers can branch on the envelope shape uniformly across
+ * success / error / list payloads.
+ *
+ * When `pageInfo` is supplied (by a paginated command's action
+ * handler after threading `--page` / `--per-page` through to the
+ * service layer), it's included verbatim. When omitted (by a list
+ * command whose wire op has no pagination args, OR when the user
+ * passes no flags and the server returns no metadata), the envelope
+ * surfaces `{version, items}` only.
+ *
+ * The empty-state wrapper from #122 (`isEmptyCollection` in
+ * `lib/empty-state-cta.ts`) detects both raw `[]` AND `{items: []}` —
+ * wrapping list output through this helper keeps the empty-state
+ * behavior unchanged on json/yaml.
+ *
+ * Pure — no I/O.
+ */
+export function wrapListEnvelope(items, pageInfo) {
+    const env = { version: ENVELOPE_VERSION, items };
+    if (pageInfo !== undefined)
+        env.pageInfo = pageInfo;
+    return env;
+}
+/**
+ * Pretty success-line marker. The visible glyph is a heavy check
+ * (`✓`); kept in a constant so tests can assert on it without
+ * duplicating Unicode escapes across snapshots.
+ */
+export const PRETTY_SUCCESS_PREFIX = "✓";
+/**
+ * Indent every line of `text` by two spaces. Used for the indented
+ * entity preview that follows the one-line `prettySummary` in success
+ * envelopes' pretty rendering.
+ *
+ * Pure — directly unit-testable.
+ */
+function indent(text) {
+    return text
+        .split("\n")
+        .map((line) => `  ${line}`)
+        .join("\n");
+}
+/**
+ * Stringify the JSON success-add envelope (single-line, no extra
+ * whitespace — matches `formatResult` json branch). Exposed for tests.
+ */
+export function formatAddJson(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Stringify the YAML success-add envelope as block-style YAML via
+ * `formatYaml`. Exposed for tests.
+ */
+export function formatAddYaml(envelope) {
+    return formatYaml(envelope);
+}
+/**
+ * Stringify the JSON success-update envelope. Exposed for tests.
+ */
+export function formatUpdateJson(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Stringify the YAML success-update envelope. Exposed for tests.
+ */
+export function formatUpdateYaml(envelope) {
+    return formatYaml(envelope);
+}
+/**
+ * Stringify the JSON success-remove envelope. Exposed for tests.
+ */
+export function formatRemoveJson(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Stringify the YAML success-remove envelope. Exposed for tests.
+ */
+export function formatRemoveYaml(envelope) {
+    return formatYaml(envelope);
+}
+/**
+ * Stringify the JSON error envelope. Exposed for tests.
+ */
+export function formatErrorJson(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Stringify the YAML error envelope. Exposed for tests.
+ */
+export function formatErrorYaml(envelope) {
+    return formatYaml(envelope);
+}
+/**
+ * Build the pretty-format rendering of a success-add envelope:
+ *
+ *     ✓ Added: <prettySummary>
+ *       <prettyEntity-line-1>
+ *       <prettyEntity-line-2>
+ *       …
+ *
+ * `prettyEntity` is OPTIONAL — when omitted the output is just the
+ * single-line summary. `notice` (when present) appears on its own
+ * trailing line, also indented.
+ *
+ * Pure — directly unit-testable.
+ */
+export function formatAddPretty(args) {
+    const lines = [`${PRETTY_SUCCESS_PREFIX} Added: ${args.prettySummary}`];
+    if (args.prettyEntity !== undefined) {
+        lines.push(indent(args.prettyEntity(args.entity)));
+    }
+    if (args.notice !== undefined) {
+        lines.push(indent(`notice: ${args.notice}`));
+    }
+    return lines.join("\n");
+}
+/**
+ * Build the pretty-format rendering of a success-update envelope.
+ * Mirror of `formatAddPretty` with an "Updated:" header. v0.4 does NOT
+ * render the `changes` diff (the deep comparison is out of scope per
+ * #128 caller context); the field is reserved on the JSON/YAML wire
+ * shape only.
+ */
+export function formatUpdatePretty(args) {
+    const lines = [`${PRETTY_SUCCESS_PREFIX} Updated: ${args.prettySummary}`];
+    if (args.prettyEntity !== undefined) {
+        lines.push(indent(args.prettyEntity(args.entity)));
+    }
+    if (args.notice !== undefined) {
+        lines.push(indent(`notice: ${args.notice}`));
+    }
+    return lines.join("\n");
+}
+/**
+ * Build the pretty-format rendering of a success-remove envelope:
+ *
+ *     ✓ Removed: <prettySummary or id>
+ *
+ * The summary defaults to the bare id when no `prettySummary` is
+ * supplied; callers that have the entity name handy (post-fetch) can
+ * pass a richer line like `"sk_abc123 (TypeScript)"`.
+ */
+export function formatRemovePretty(args) {
+    const summary = args.prettySummary ?? args.id;
+    const lines = [`${PRETTY_SUCCESS_PREFIX} Removed: ${summary}`];
+    if (args.notice !== undefined) {
+        lines.push(indent(`notice: ${args.notice}`));
+    }
+    return lines.join("\n");
+}
+/**
+ * Maximum number of diff entries rendered in the pretty form of a
+ * `WIRE_SHAPE_ERROR` (per `docs/wire-validation-error-format.md`
+ * § `-o pretty`). The JSON / YAML wire shapes carry the full list;
+ * only the human-readable rendering caps to keep terminal output
+ * scannable. When the diff exceeds the cap, a `… and <K> more` line
+ * tells the operator where to look for the full data.
+ */
+export const WIRE_SHAPE_DIFF_PRETTY_CAP = 10;
+/**
+ * Render a single {@link WireShapeDiffEntry} as the one-line form used
+ * inside the `Diff (schema vs wire):` block (per
+ * `docs/wire-validation-error-format.md` § `-o pretty`). Examples:
+ *
+ *     ~ records[0].duration: expected number, got string ("480")
+ *     - records[1].notes: expected string, got undefined
+ *     + records[0].surprise: unexpected wire field (unknown)
+ *
+ * The `value?` slot is rendered inline parenthesised with surrounding
+ * double quotes for string values — matching the spec's `("480")`
+ * formatting. Non-string values are rendered verbatim (already
+ * stringified upstream by `renderValue` in `wire-shape.ts`).
+ */
+function formatWireShapeDiffEntry(entry) {
+    if (entry.op === "+") {
+        return `+ ${entry.path}: unexpected wire field (${entry.actual})`;
+    }
+    if (entry.op === "-") {
+        return `- ${entry.path}: expected ${entry.expected}, got ${entry.actual}`;
+    }
+    // op === "~"
+    if (entry.value === undefined) {
+        return `~ ${entry.path}: expected ${entry.expected}, got ${entry.actual}`;
+    }
+    return `~ ${entry.path}: expected ${entry.expected}, got ${entry.actual} ("${entry.value}")`;
+}
+/**
+ * Build the pretty-format rendering of an error envelope. Each error
+ * surfaces as its own block; `field` and `hint` annotate the message
+ * when present.
+ *
+ *     Error: <message-1>
+ *       (Code: <code-1>)
+ *       (Field: <field-1>)
+ *       Diff (schema vs wire):
+ *         <op> <path>: expected <expected>, got <actual> [("<value>")]
+ *         …
+ *       Hint: <hint-1>
+ *
+ *     Error: <message-2>
+ *       …
+ *
+ * The format is symmetric with `formatTtctlErrorMessage` from
+ * `errors.ts` (used for the typed-hierarchy `TtctlError` block) — same
+ * `Error: …` prefix, same parenthesised metadata. The recovery line
+ * from `TtctlError` does not have a generic equivalent here; callers
+ * convert to `hint` if a recovery sentence is available.
+ *
+ * `WIRE_SHAPE_ERROR` (Z-3 / #286) carries a `diff` field — when
+ * present, the pretty form renders a `Diff (schema vs wire):` block
+ * before the `Hint:` footer per
+ * `docs/wire-validation-error-format.md` § `-o pretty`. Capped at
+ * {@link WIRE_SHAPE_DIFF_PRETTY_CAP} entries; overflow renders a
+ * `… and <K> more …` line pointing at `-o json` for the full diff.
+ */
+export function formatErrorPretty(envelope) {
+    const blocks = envelope.errors.map((err) => {
+        const lines = [`Error: ${err.message}`];
+        lines.push(`  (Code: ${err.code})`);
+        if (err.field !== undefined) {
+            lines.push(`  (Field: ${err.field})`);
+        }
+        if (err.diff !== undefined && err.diff.length > 0) {
+            lines.push(`  Diff (schema vs wire):`);
+            const head = err.diff.slice(0, WIRE_SHAPE_DIFF_PRETTY_CAP);
+            for (const entry of head) {
+                lines.push(`    ${formatWireShapeDiffEntry(entry)}`);
+            }
+            const overflow = err.diff.length - head.length;
+            if (overflow > 0) {
+                lines.push(`    … and ${overflow.toString()} more (see -o json for the full diff).`);
+            }
+        }
+        if (err.hint !== undefined) {
+            lines.push(`  Hint: ${err.hint}`);
+        }
+        return lines.join("\n");
+    });
+    return blocks.join("\n\n");
+}
+/**
+ * One-line stderr summary for the pretty error path. The AC requires
+ * a "one-line stderr summary" alongside the multi-line block — when
+ * stdout is structured (json/yaml) the summary is omitted because the
+ * structured payload IS the summary.
+ *
+ * Defaults to `Error: <first-error.message>` when the caller does not
+ * pass an explicit summary. Useful when piping the multi-line block
+ * elsewhere but still wanting a glance-readable single line on the
+ * terminal.
+ */
+export function defaultPrettyErrorSummary(envelope) {
+    const first = envelope.errors[0];
+    if (first === undefined) {
+        return "Error: (no error details supplied)";
+    }
+    return `Error: ${first.message}`;
+}
+/**
+ * Build the success-add envelope object (pure — no I/O). Shape:
+ * `{ok: true, version: "1.0", operation, created, notice?}`. Exposed
+ * separately from `emitAddSuccess` so callers (and tests) can inspect
+ * the structured shape without going through stdout.
+ */
+export function buildAddEnvelope(args) {
+    const env = {
+        ok: true,
+        version: ENVELOPE_VERSION,
+        operation: args.operation,
+        created: args.created,
+    };
+    if (args.notice !== undefined)
+        env.notice = args.notice;
+    return env;
+}
+/**
+ * Build the success-update envelope object (pure — no I/O). Shape:
+ * `{ok: true, version: "1.0", operation, updated, changes?, notice?}`.
+ *
+ * `changes` is reserved (see `EnvelopeChange` doc). Callers do not
+ * thread it through in v0.4; the parameter is preserved for future
+ * extension without an API churn.
+ */
+export function buildUpdateEnvelope(args) {
+    const env = {
+        ok: true,
+        version: ENVELOPE_VERSION,
+        operation: args.operation,
+        updated: args.updated,
+    };
+    if (args.changes !== undefined)
+        env.changes = args.changes;
+    if (args.notice !== undefined)
+        env.notice = args.notice;
+    return env;
+}
+/**
+ * Build the success-remove envelope object (pure — no I/O). Shape:
+ * `{ok: true, version: "1.0", operation, removed: {id}, notice?}`.
+ */
+export function buildRemoveEnvelope(args) {
+    const env = {
+        ok: true,
+        version: ENVELOPE_VERSION,
+        operation: args.operation,
+        removed: { id: args.id },
+    };
+    if (args.notice !== undefined)
+        env.notice = args.notice;
+    return env;
+}
+/**
+ * Build the error envelope object (pure — no I/O). Shape:
+ * `{ok: false, version: "1.0", operation, errors[]}`. `errors` is
+ * normalised to a plural array even for single-error inputs so the
+ * wire shape is stable.
+ */
+export function buildErrorEnvelope(args) {
+    return {
+        ok: false,
+        version: ENVELOPE_VERSION,
+        operation: args.operation,
+        errors: args.errors,
+    };
+}
+/**
+ * Side-effecting emitter for the `add` success envelope. Writes the
+ * per-format payload to stdout with a trailing newline; never throws.
+ *
+ * - `json` → single-line JSON envelope on stdout
+ * - `yaml` → block-style YAML envelope on stdout
+ * - `pretty` → `✓ Added: <summary>` + indented `prettyEntity?` on stdout
+ *
+ * The success path always exits 0 (the helper does not call
+ * `process.exit` — leaves it to the caller / Node's natural exit).
+ */
+export function emitAddSuccess(args) {
+    const envelope = buildAddEnvelope({
+        operation: args.operation,
+        created: args.created,
+        notice: args.notice,
+    });
+    const payload = renderSuccessAdd(envelope, args.format, {
+        prettySummary: args.prettySummary,
+        prettyEntity: args.prettyEntity,
+    });
+    process.stdout.write(`${payload}\n`);
+}
+function renderSuccessAdd(envelope, format, prettyArgs) {
+    if (format === "json")
+        return formatAddJson(envelope);
+    if (format === "yaml")
+        return formatAddYaml(envelope);
+    return formatAddPretty({
+        prettySummary: prettyArgs.prettySummary,
+        prettyEntity: prettyArgs.prettyEntity,
+        entity: envelope.created,
+        notice: envelope.notice,
+    });
+}
+/**
+ * Side-effecting emitter for the `update` success envelope. Mirror of
+ * `emitAddSuccess` for the update verb.
+ */
+export function emitUpdateSuccess(args) {
+    const envelope = buildUpdateEnvelope({
+        operation: args.operation,
+        updated: args.updated,
+        changes: args.changes,
+        notice: args.notice,
+    });
+    const payload = renderSuccessUpdate(envelope, args.format, {
+        prettySummary: args.prettySummary,
+        prettyEntity: args.prettyEntity,
+    });
+    process.stdout.write(`${payload}\n`);
+}
+function renderSuccessUpdate(envelope, format, prettyArgs) {
+    if (format === "json")
+        return formatUpdateJson(envelope);
+    if (format === "yaml")
+        return formatUpdateYaml(envelope);
+    return formatUpdatePretty({
+        prettySummary: prettyArgs.prettySummary,
+        prettyEntity: prettyArgs.prettyEntity,
+        entity: envelope.updated,
+        notice: envelope.notice,
+    });
+}
+/**
+ * Side-effecting emitter for the `remove` success envelope. The id is
+ * the server-issued identifier of the now-deleted entity (the caller
+ * already knows it from the input or from the API response).
+ */
+export function emitRemoveSuccess(args) {
+    const envelope = buildRemoveEnvelope({
+        operation: args.operation,
+        id: args.id,
+        notice: args.notice,
+    });
+    const payload = renderSuccessRemove(envelope, args.format, args.prettySummary);
+    process.stdout.write(`${payload}\n`);
+}
+function renderSuccessRemove(envelope, format, prettySummary) {
+    if (format === "json")
+        return formatRemoveJson(envelope);
+    if (format === "yaml")
+        return formatRemoveYaml(envelope);
+    return formatRemovePretty({
+        id: envelope.removed.id,
+        prettySummary,
+        notice: envelope.notice,
+    });
+}
+/**
+ * Build the dry-run success envelope object (pure — no I/O). Shape:
+ * `{ok: true, version: "1.0", operation, dryRun: true, preview, notice?}`.
+ *
+ * Exposed separately from {@link emitDryRunSuccess} so callers (and
+ * tests) can inspect the structured shape without going through stdout.
+ */
+export function buildDryRunEnvelope(args) {
+    const env = {
+        ok: true,
+        version: ENVELOPE_VERSION,
+        operation: args.operation,
+        dryRun: true,
+        preview: args.preview,
+    };
+    if (args.notice !== undefined)
+        env.notice = args.notice;
+    return env;
+}
+/**
+ * Stringify the JSON dry-run envelope (single-line, no extra whitespace
+ * — matches `formatResult` json branch). Exposed for tests.
+ */
+export function formatDryRunJson(envelope) {
+    return JSON.stringify(envelope);
+}
+/**
+ * Stringify the YAML dry-run envelope as block-style YAML via
+ * `formatYaml`. Exposed for tests.
+ */
+export function formatDryRunYaml(envelope) {
+    return formatYaml(envelope);
+}
+/**
+ * Build the pretty-format rendering of a dry-run envelope:
+ *
+ *     ✓ Dry run: would call `<operationName>` (no changes sent)
+ *       surface:    <surface> (<transport>)
+ *       endpoint:   <endpoint>
+ *       variables:
+ *         <pretty-printed-JSON, 2-space indented>
+ *       headers:
+ *         authorization: Token token=<redacted>
+ *         <other-header>: <value>
+ *         …
+ *
+ * Pure — directly unit-testable. The output is human-friendly: the
+ * variables block uses `JSON.stringify(_, null, 2)` to give a readable
+ * multi-line shape, while headers list one-per-line so the redacted
+ * `authorization` is obvious at a glance.
+ */
+export function formatDryRunPretty(envelope) {
+    const { preview } = envelope;
+    const lines = [
+        `${PRETTY_SUCCESS_PREFIX} Dry run: would call \`${preview.operationName}\` (no changes sent)`,
+        indent(`surface:    ${preview.surface} (${preview.transport})`),
+        indent(`endpoint:   ${preview.endpoint}`),
+        indent(`variables:`),
+    ];
+    const variablesJson = JSON.stringify(preview.variables, null, 2);
+    for (const line of variablesJson.split("\n")) {
+        // 4-space indent (2 base + 2 nest) so the JSON body is visibly
+        // grouped under the `variables:` header.
+        lines.push(`    ${line}`);
+    }
+    lines.push(indent("headers:"));
+    // Sort headers for stable pretty rendering — JSON.stringify preserves
+    // insertion order, but sort here so the human view doesn't depend on
+    // the order COMMON_HEADERS keys were defined in. The `authorization`
+    // line surfaces under "a" naturally; redaction is visible without
+    // prejudice across sort orders.
+    for (const key of Object.keys(preview.headers).sort()) {
+        lines.push(`    ${key}: ${preview.headers[key] ?? ""}`);
+    }
+    if (envelope.notice !== undefined) {
+        lines.push(indent(`notice: ${envelope.notice}`));
+    }
+    return lines.join("\n");
+}
+/**
+ * Side-effecting emitter for the dry-run success envelope. Mirrors
+ * {@link emitUpdateSuccess} for the dry-run variant — writes the
+ * per-format payload to stdout with a trailing newline; never throws.
+ *
+ * - `json` → single-line JSON envelope on stdout
+ * - `yaml` → block-style YAML envelope on stdout
+ * - `pretty` → multi-line `✓ Dry run: …` block on stdout
+ *
+ * The success path always exits 0 (helper does not call `process.exit`
+ * — leaves it to the caller / Node's natural exit). This matches the
+ * AC: a well-formed dry-run preview exits 0 regardless of whether the
+ * apply-path WOULD have errored at the server level.
+ */
+export function emitDryRunSuccess(args) {
+    const envelope = buildDryRunEnvelope({
+        operation: args.operation,
+        preview: args.preview,
+        notice: args.notice,
+    });
+    const payload = renderDryRun(envelope, args.format);
+    process.stdout.write(`${payload}\n`);
+}
+function renderDryRun(envelope, format) {
+    if (format === "json")
+        return formatDryRunJson(envelope);
+    if (format === "yaml")
+        return formatDryRunYaml(envelope);
+    return formatDryRunPretty(envelope);
+}
+/**
+ * Side-effecting error emitter. Routes per format and exits the
+ * process — never returns.
+ *
+ * Routing:
+ *
+ * - `json` / `yaml`: the structured envelope is written to STDOUT (so
+ *   `jq`/`yq` consumers see structured payload regardless of exit
+ *   code). The exit code is nonzero (default `1`).
+ * - `pretty`: a one-line stderr summary is written FIRST, then the
+ *   multi-line human block (also on stderr). STDOUT stays clean.
+ *
+ * Exit code defaults to `1`; callers can pass a different value (e.g.
+ * `2` for transport-level Cloudflare blocks, mirroring
+ * `exitCodeForTtctlError`).
+ */
+export function emitErrorAndExit(args) {
+    const envelope = buildErrorEnvelope({
+        operation: args.operation,
+        errors: args.errors,
+    });
+    const code = args.exitCode ?? 1;
+    if (args.format === "json") {
+        process.stdout.write(`${formatErrorJson(envelope)}\n`);
+    }
+    else if (args.format === "yaml") {
+        process.stdout.write(`${formatErrorYaml(envelope)}\n`);
+    }
+    else {
+        const summary = args.prettySummary ?? defaultPrettyErrorSummary(envelope);
+        process.stderr.write(`${summary}\n`);
+        process.stderr.write(`${formatErrorPretty(envelope)}\n`);
+    }
+    process.exit(code);
+}
+//# sourceMappingURL=envelopes.js.map

package/dist/lib/envelopes.js.map

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

package/dist/lib/error-routing.d.ts

@@ -0,0 +1,49 @@
+import type { OutputFormat } from "./output.js";
+/**
+ * Structural shape every domain error class instance satisfies: a
+ * machine-readable `code` token plus a human-readable `message`. All
+ * `*Error` classes exported from `@ttctl/core/services` match this shape
+ * (`ApplicationsError`, `AvailabilityError`, `ContractsError`,
+ * `EngagementsError`, `JobsError`, `PaymentsError`, `TimesheetError`,
+ * `profile.basic.ProfileError`, `profile.visas.VisasError`, …).
+ */
+export interface DomainErrorLike {
+    code: string;
+    message: string;
+}
+/**
+ * Generic CLI error router (#330). Single source of truth for the
+ * branching logic that was previously copied into nine structurally
+ * identical handler functions across `packages/cli/src/commands/*\/shared.ts`
+ * (one per sub-domain). Each domain re-exports a thin wrapper that
+ * closes over its `DomainErrorClass` (and optionally a per-code hint
+ * adapter) so the call sites in action handlers stay unchanged.
+ *
+ * Three branches in priority order:
+ *
+ * 1. `TtctlError` subclasses (`AuthRevokedError`, `Cf403Error`,
+ *    `Cf403PersistentError`, `SchedulerBearerExpired`, …) keep their
+ *    dedicated 3-block pretty rendering on `pretty` (Error / Recovery /
+ *    Code) via {@link presentTtctlError}; `json` / `yaml` flow through
+ *    the envelope so machine consumers see the stable wire shape. Exit
+ *    code routes via {@link exitCodeForTtctlError} — Cloudflare-403
+ *    codes exit `2`, everything else `1`.
+ * 2. Domain errors (i.e. `instanceof DomainErrorClass`) flow through the
+ *    envelope. When `hintForCode` is supplied and returns a string for
+ *    the given code, the envelope entry carries a `hint:` field;
+ *    otherwise the entry is just `{code, message}`.
+ *    `exactOptionalPropertyTypes: true` — the entry is built additively
+ *    so the omitted-vs-undefined distinction is preserved at the
+ *    envelope boundary.
+ * 3. Anything else (a plain `Error` thrown from helper code, or a
+ *    non-Error throw) collapses into `INTERNAL_ERROR` so the user sees
+ *    a structured envelope rather than the bare exception message.
+ *
+ * `commandLabel` is the user-visible prefix (e.g. `"applications show"`);
+ * the envelope `operation` is derived by replacing spaces with dots
+ * (`"applications.show"`).
+ *
+ * Returns `never` — every branch exits the process via `process.exit`.
+ */
+export declare function handleDomainError<E extends DomainErrorLike>(commandLabel: string, err: unknown, DomainErrorClass: new (...args: never[]) => E, format?: OutputFormat, hintForCode?: (code: E["code"]) => string | undefined): never;
+//# sourceMappingURL=error-routing.d.ts.map

package/dist/lib/error-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-routing.d.ts","sourceRoot":"","sources":["../../src/lib/error-routing.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,eAAe,EACzD,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,EACZ,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAC7C,MAAM,GAAE,YAAuB,EAC/B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,GACpD,KAAK,CA6BP"}