@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/lib/error-routing.js

@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { TtctlError } from "@ttctl/core";
+import { exitCodeForTtctlError, presentTtctlError } from "../errors.js";
+import { emitErrorAndExit } from "./envelopes.js";
+/**
+ * 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 function handleDomainError(commandLabel, err, DomainErrorClass, format = "pretty", hintForCode) {
+    const operation = commandLabel.replace(/ /g, ".");
+    if (err instanceof TtctlError) {
+        if (format === "pretty")
+            presentTtctlError(err);
+        emitErrorAndExit({
+            operation,
+            format,
+            errors: [{ code: err.code, message: err.message, hint: err.recovery }],
+            exitCode: exitCodeForTtctlError(err),
+        });
+    }
+    if (err instanceof DomainErrorClass) {
+        const envelopeError = { code: err.code, message: err.message };
+        const hint = hintForCode?.(err.code);
+        if (hint !== undefined)
+            envelopeError.hint = hint;
+        emitErrorAndExit({
+            operation,
+            format,
+            errors: [envelopeError],
+            prettySummary: `${commandLabel} failed (${err.code}): ${err.message}`,
+        });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    emitErrorAndExit({
+        operation,
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `${commandLabel} failed: ${message}`,
+    });
+}
+//# sourceMappingURL=error-routing.js.map

package/dist/lib/error-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-routing.js","sourceRoot":"","sources":["../../src/lib/error-routing.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAiBlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,GAAY,EACZ,gBAA6C,EAC7C,SAAuB,QAAQ,EAC/B,WAAqD;IAErD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,QAAQ;YAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAChD,gBAAgB,CAAC;YACf,SAAS;YACT,MAAM;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;YACtE,QAAQ,EAAE,qBAAqB,CAAC,GAAG,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,MAAM,aAAa,GAAkB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC9E,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS;YAAE,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC;QAClD,gBAAgB,CAAC;YACf,SAAS;YACT,MAAM;YACN,MAAM,EAAE,CAAC,aAAa,CAAC;YACvB,aAAa,EAAE,GAAG,YAAY,YAAY,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE;SACtE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,gBAAgB,CAAC;QACf,SAAS;QACT,MAAM;QACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAC7C,aAAa,EAAE,GAAG,YAAY,YAAY,OAAO,EAAE;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/format-helpers.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared rendering helpers for the post-#126 `pretty` format. Centralised
+ * so every sub-domain formatter applies the same null convention and
+ * paragraph layout — the audit at
+ * `docs/audit/2026-05-output-format-formatter-audit.md` flagged at least
+ * four distinct null-rendering conventions across the 11 sub-domains.
+ *
+ * Used today by the rewritten `formatProfilePretty` (basic) and
+ * `formatPortfolioPretty` (portfolio) per #129. Other sub-domains adopt
+ * these helpers as their formatters are revisited.
+ */
+/**
+ * Default placeholder for fields the user CAN set but hasn't. Renders
+ * verbatim in `pretty` per the audit's standardisation recommendation
+ * (§ Standardization Recommendation for `pretty`). The placeholder is
+ * intentionally bracketed so it cannot collide with a value the user
+ * stored — `(` / `)` are not valid leading characters in any of the
+ * Toptal profile fields we render.
+ */
+export declare const UNSET_PLACEHOLDER = "(unset)";
+/**
+ * Coerce a `string | null | undefined | ""` value into either the value
+ * itself (when present) or a placeholder. The empty string is treated as
+ * "unset" because the talent-profile API returns `""` for fields the
+ * user has explicitly cleared (e.g., a deleted bio surfaces as
+ * `about: ""`, not `about: null`) — empirically observed in the
+ * `UPDATE_BASIC_INFO` round-trip and the `Profile.city` server contract.
+ *
+ * Pass an explicit `fallback` when the formatter wants a CTA-style
+ * placeholder (e.g., `"(unset — set with: ttctl profile basic update --bio
+ * \"<text>\")"`); the default `"(unset)"` is the audit-standardised
+ * convention.
+ */
+export declare function unsetOr(value: string | null | undefined, fallback?: string): string;
+/**
+ * Indent every line of `text` by `indent` (default: two spaces). Empty
+ * lines stay empty so paragraph breaks survive verbatim — the audit's
+ * `pretty` contract requires `\n\n` in a source field to render as
+ * actual blank lines, not escaped strings.
+ *
+ * Caller-controlled indent string lets a formatter compose nested
+ * indentation (e.g., a portfolio item already indented two spaces from
+ * the list marker can pass `"    "` to indent its description body four
+ * spaces total).
+ */
+export declare function indentLines(text: string, indent?: string): string;
+/**
+ * Render a multi-paragraph field for `pretty` output: emit the prefix on
+ * its own line, then the body indented one level deeper. Paragraph breaks
+ * (`\n\n` in source) survive as actual blank lines via {@link indentLines}.
+ *
+ * The two-line shape ("Header:" then indented body) matches the audit's
+ * recommendation for paragraph-bearing fields — single-line prefixes
+ * collapse hierarchy and force the user to scan past the prefix to find
+ * the start of the value.
+ *
+ * `outerIndent` is the indent of the prefix line itself (the surrounding
+ * formatter's indent level); the body is indented `outerIndent + "  "`.
+ *
+ * @example
+ *   renderMultiParagraph("Bio", "Hello.\n\nWorld.", "  ")
+ *   // "  Bio:\n    Hello.\n\n    World."
+ */
+export declare function renderMultiParagraph(prefix: string, body: string, outerIndent?: string): string;
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/lib/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/format-helpers.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAGtG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAKvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,MAAa,GAAG,MAAM,CAGrG"}

package/dist/lib/format-helpers.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Shared rendering helpers for the post-#126 `pretty` format. Centralised
+ * so every sub-domain formatter applies the same null convention and
+ * paragraph layout — the audit at
+ * `docs/audit/2026-05-output-format-formatter-audit.md` flagged at least
+ * four distinct null-rendering conventions across the 11 sub-domains.
+ *
+ * Used today by the rewritten `formatProfilePretty` (basic) and
+ * `formatPortfolioPretty` (portfolio) per #129. Other sub-domains adopt
+ * these helpers as their formatters are revisited.
+ */
+/**
+ * Default placeholder for fields the user CAN set but hasn't. Renders
+ * verbatim in `pretty` per the audit's standardisation recommendation
+ * (§ Standardization Recommendation for `pretty`). The placeholder is
+ * intentionally bracketed so it cannot collide with a value the user
+ * stored — `(` / `)` are not valid leading characters in any of the
+ * Toptal profile fields we render.
+ */
+export const UNSET_PLACEHOLDER = "(unset)";
+/**
+ * Coerce a `string | null | undefined | ""` value into either the value
+ * itself (when present) or a placeholder. The empty string is treated as
+ * "unset" because the talent-profile API returns `""` for fields the
+ * user has explicitly cleared (e.g., a deleted bio surfaces as
+ * `about: ""`, not `about: null`) — empirically observed in the
+ * `UPDATE_BASIC_INFO` round-trip and the `Profile.city` server contract.
+ *
+ * Pass an explicit `fallback` when the formatter wants a CTA-style
+ * placeholder (e.g., `"(unset — set with: ttctl profile basic update --bio
+ * \"<text>\")"`); the default `"(unset)"` is the audit-standardised
+ * convention.
+ */
+export function unsetOr(value, fallback = UNSET_PLACEHOLDER) {
+    if (value === null || value === undefined || value === "")
+        return fallback;
+    return value;
+}
+/**
+ * Indent every line of `text` by `indent` (default: two spaces). Empty
+ * lines stay empty so paragraph breaks survive verbatim — the audit's
+ * `pretty` contract requires `\n\n` in a source field to render as
+ * actual blank lines, not escaped strings.
+ *
+ * Caller-controlled indent string lets a formatter compose nested
+ * indentation (e.g., a portfolio item already indented two spaces from
+ * the list marker can pass `"    "` to indent its description body four
+ * spaces total).
+ */
+export function indentLines(text, indent = "  ") {
+    return text
+        .split("\n")
+        .map((line) => (line === "" ? "" : `${indent}${line}`))
+        .join("\n");
+}
+/**
+ * Render a multi-paragraph field for `pretty` output: emit the prefix on
+ * its own line, then the body indented one level deeper. Paragraph breaks
+ * (`\n\n` in source) survive as actual blank lines via {@link indentLines}.
+ *
+ * The two-line shape ("Header:" then indented body) matches the audit's
+ * recommendation for paragraph-bearing fields — single-line prefixes
+ * collapse hierarchy and force the user to scan past the prefix to find
+ * the start of the value.
+ *
+ * `outerIndent` is the indent of the prefix line itself (the surrounding
+ * formatter's indent level); the body is indented `outerIndent + "  "`.
+ *
+ * @example
+ *   renderMultiParagraph("Bio", "Hello.\n\nWorld.", "  ")
+ *   // "  Bio:\n    Hello.\n\n    World."
+ */
+export function renderMultiParagraph(prefix, body, outerIndent = "  ") {
+    const innerIndent = `${outerIndent}  `;
+    return `${outerIndent}${prefix}:\n${indentLines(body, innerIndent)}`;
+}
+//# sourceMappingURL=format-helpers.js.map

package/dist/lib/format-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.js","sourceRoot":"","sources":["../../src/lib/format-helpers.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAC,KAAgC,EAAE,WAAmB,iBAAiB;IAC5F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAiB,IAAI;IAC7D,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;SACtD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,IAAY,EAAE,cAAsB,IAAI;IAC3F,MAAM,WAAW,GAAG,GAAG,WAAW,IAAI,CAAC;IACvC,OAAO,GAAG,WAAW,GAAG,MAAM,MAAM,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/lib/format-overrides.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Per-command output-strategy overrides for the post-reframe `pretty`
+ * format dispatch (#121 epic, audit at
+ * `docs/audit/2026-05-output-format-formatter-audit.md`).
+ *
+ * The default `pretty` strategy is `"default"` — one row per
+ * field, key/value layout. Some commands carry paragraph-length
+ * fields that don't fit a row layout (reviewer comments, portfolio
+ * descriptions, employment experience items). Those commands register
+ * a `"multi-line"` strategy so the dispatch pipeline routes them to
+ * the curated multi-line renderer instead.
+ *
+ * The registry is keyed by the **canonical command path** —
+ * sub-domain verbs only, no Commander.js aliases. Aliases (`certs`
+ * for `certifications`, `experience` for `employment`, `rm` for
+ * `remove`) MUST collapse to the canonical form before lookup. The
+ * dispatch layer (added in a downstream issue) is responsible for
+ * the alias collapse.
+ *
+ * The registry intentionally ships small. Adding an entry should be
+ * a deliberate decision tied to a specific defect (e.g., an audit
+ * row in the triage report) — not a forward-looking guess.
+ */
+/**
+ * Output strategy alternatives the `pretty` dispatcher can select.
+ *
+ * - `"default"` — fall through to the per-command formatter
+ *   registered alongside the action handler. The dispatcher does not
+ *   intervene.
+ * - `"multi-line"` — route through the curated multi-line renderer.
+ *   Used for commands whose entity carries paragraph-length text that
+ *   would overflow a row-based layout.
+ *
+ * Future strategies (e.g., `"compact"` for inline single-line lists)
+ * land as additional union members.
+ */
+export type FormatStrategy = "default" | "multi-line";
+/**
+ * Per-command-path strategy registry. Lookup is by canonical command
+ * path (e.g., `"profile reviews list"`). Unknown paths fall through
+ * to {@link DEFAULT_STRATEGY}.
+ *
+ * The registry is `ReadonlyMap` to discourage mutation at the call
+ * site; tests that need to override entries should construct a fresh
+ * map and pass it through a dependency-injected lookup function (the
+ * registry is not a global singleton in spirit — `resolveStrategy`
+ * accepts an explicit map for testability).
+ *
+ * Initial entries (per § Override Registry Decisions in the audit):
+ *
+ * - `profile reviews list`: forward-looking. The current entity
+ *   (`SectionReview`) carries no paragraph-length fields, but #127
+ *   may surface reviewer-comment / rejection-reason fields, at which
+ *   point a row-based table breaks. Registering today is no-cost
+ *   (multi-line still reads fine on short data) and forward-safe.
+ *
+ * Two further candidates are tracked as TODO comments below for the
+ * downstream issue (#129 — formatter rewrites) to enroll once their
+ * formatters are reshaped:
+ *
+ * - `profile employment list`: `experienceItems` is paragraph-length
+ *   today; current table renders only a count.
+ * - `profile portfolio list`: `description` and `accomplishment` are
+ *   paragraph-length post-#129 fix.
+ */
+export declare const FORMAT_OVERRIDES: ReadonlyMap<string, FormatStrategy>;
+/**
+ * Default strategy when a command path has no registered override.
+ * Exported so callers and tests can reference the same constant.
+ */
+export declare const DEFAULT_STRATEGY: FormatStrategy;
+/**
+ * Resolve the format strategy for a canonical command path. Pure —
+ * no I/O. The optional `overrides` parameter lets tests inject an
+ * alternate registry without touching the module-level constant.
+ *
+ * Lookup is case-sensitive and exact-match. Aliases must collapse to
+ * the canonical form upstream.
+ */
+export declare function resolveStrategy(commandPath: string, overrides?: ReadonlyMap<string, FormatStrategy>): FormatStrategy;
+//# sourceMappingURL=format-overrides.d.ts.map

package/dist/lib/format-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-overrides.d.ts","sourceRoot":"","sources":["../../src/lib/format-overrides.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,YAAY,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAO/D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAA0B,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAoB,GAChE,cAAc,CAEhB"}

package/dist/lib/format-overrides.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Per-command-path strategy registry. Lookup is by canonical command
+ * path (e.g., `"profile reviews list"`). Unknown paths fall through
+ * to {@link DEFAULT_STRATEGY}.
+ *
+ * The registry is `ReadonlyMap` to discourage mutation at the call
+ * site; tests that need to override entries should construct a fresh
+ * map and pass it through a dependency-injected lookup function (the
+ * registry is not a global singleton in spirit — `resolveStrategy`
+ * accepts an explicit map for testability).
+ *
+ * Initial entries (per § Override Registry Decisions in the audit):
+ *
+ * - `profile reviews list`: forward-looking. The current entity
+ *   (`SectionReview`) carries no paragraph-length fields, but #127
+ *   may surface reviewer-comment / rejection-reason fields, at which
+ *   point a row-based table breaks. Registering today is no-cost
+ *   (multi-line still reads fine on short data) and forward-safe.
+ *
+ * Two further candidates are tracked as TODO comments below for the
+ * downstream issue (#129 — formatter rewrites) to enroll once their
+ * formatters are reshaped:
+ *
+ * - `profile employment list`: `experienceItems` is paragraph-length
+ *   today; current table renders only a count.
+ * - `profile portfolio list`: `description` and `accomplishment` are
+ *   paragraph-length post-#129 fix.
+ */
+export const FORMAT_OVERRIDES = new Map([
+    ["profile reviews list", "multi-line"],
+    // TODO(#129): enroll "profile employment list" → "multi-line" once
+    // the formatter is rewritten to render `experienceItems` content.
+    // TODO(#129): enroll "profile portfolio list" → "multi-line" once
+    // the formatter is rewritten to render `description` and
+    // `accomplishment`.
+]);
+/**
+ * Default strategy when a command path has no registered override.
+ * Exported so callers and tests can reference the same constant.
+ */
+export const DEFAULT_STRATEGY = "default";
+/**
+ * Resolve the format strategy for a canonical command path. Pure —
+ * no I/O. The optional `overrides` parameter lets tests inject an
+ * alternate registry without touching the module-level constant.
+ *
+ * Lookup is case-sensitive and exact-match. Aliases must collapse to
+ * the canonical form upstream.
+ */
+export function resolveStrategy(commandPath, overrides = FORMAT_OVERRIDES) {
+    return overrides.get(commandPath) ?? DEFAULT_STRATEGY;
+}
+//# sourceMappingURL=format-overrides.js.map

package/dist/lib/format-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-overrides.js","sourceRoot":"","sources":["../../src/lib/format-overrides.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAyCpC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwC,IAAI,GAAG,CAAyB;IACnG,CAAC,sBAAsB,EAAE,YAAY,CAAC;IACtC,mEAAmE;IACnE,kEAAkE;IAClE,kEAAkE;IAClE,yDAAyD;IACzD,oBAAoB;CACrB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB,SAAS,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,YAAiD,gBAAgB;IAEjE,OAAO,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,gBAAgB,CAAC;AACxD,CAAC"}

package/dist/lib/freetext.d.ts

@@ -0,0 +1,83 @@
+import { spawn as defaultSpawn } from "node:child_process";
+/**
+ * Stable error codes carried by {@link FreeTextError}. Script consumers
+ * branch on `error.code` rather than parsing the user-facing prose. Codes
+ * intentionally cover only conditions surfaced *before* the helper hands
+ * control back to the caller — anything caused by the underlying value
+ * (e.g. server-side rejection of an empty bio) is the caller's domain.
+ */
+export type FreeTextErrorCode = "MODE_CONFLICT" | "FILE_NOT_FOUND" | "FILE_READ_ERROR" | "STDIN_UNAVAILABLE" | "STDIN_DOUBLE_CLAIM" | "EDITOR_FAILED";
+/**
+ * Typed error thrown by {@link resolveFreeText} for input mistakes the user
+ * must fix before retrying. Callers render the standard
+ * `<command> failed (<code>): <message>` shape and exit non-zero.
+ *
+ * Production failures from the API or the platform stay typed as their
+ * domain errors (e.g. `profile.basic.ProfileError`, `TtctlError`); this
+ * type covers ONLY input-resolution failures that happen on the local
+ * machine before any network call.
+ */
+export declare class FreeTextError extends Error {
+    readonly code: FreeTextErrorCode;
+    readonly name = "FreeTextError";
+    constructor(code: FreeTextErrorCode, message: string);
+}
+/**
+ * Options for {@link resolveFreeText}. The first block tunes behavior; the
+ * trailing block (`stdin` / `readFile` / `spawn`) is the test-injection
+ * surface — production callers leave these `undefined` and the helper
+ * resolves defaults (`process.stdin`, `node:fs/promises`'s `readFile`,
+ * `node:child_process`'s `spawn`).
+ */
+export interface ResolveFreeTextOptions {
+    /** User-facing flag name used in error messages, e.g. `"bio"`. */
+    readonly flagName: string;
+    /** Initial editor buffer for `--edit` mode. Empty string when omitted. */
+    readonly currentValue?: string;
+    /** Whether the caller's `--edit`-style boolean flag was set. */
+    readonly enableEditor?: boolean;
+    /** Override the `$EDITOR` lookup. Falls back to `process.env.EDITOR ?? "vi"`. */
+    readonly editorEnv?: string;
+    /** Test-only: stream consumed for the `-` (stdin) mode. */
+    readonly stdin?: NodeJS.ReadableStream;
+    /** Test-only: replace the `fs.readFile` used by the `@path` mode. */
+    readonly readFile?: (path: string) => Promise<string>;
+    /** Test-only: replace `child_process.spawn` used by the editor mode. */
+    readonly spawn?: typeof defaultSpawn;
+}
+/**
+ * Reset the module-level stdin-claim guard. Test-only. Production callers
+ * must not call this — the guard exists precisely to prevent the same
+ * process from consuming stdin twice in a single CLI invocation.
+ *
+ * @internal
+ */
+export declare function _resetStdinClaimForTesting(): void;
+/**
+ * Resolve a free-text flag value through the four supported input modes.
+ *
+ * Modes (in priority order):
+ *
+ * 1. **Editor** — `enableEditor === true` opens `$EDITOR` seeded with
+ *    `currentValue` and returns the saved buffer. Combining `enableEditor`
+ *    with a defined `rawValue` is ambiguous; the helper rejects it before
+ *    any I/O.
+ * 2. **Stdin** — `rawValue === "-"` reads `process.stdin` (or the injected
+ *    stream) until EOF. Empty stdin is NOT an error — it returns the empty
+ *    string, per AC. A non-piped TTY surfaces `STDIN_UNAVAILABLE` rather
+ *    than hanging the CLI forever waiting on an interactive user.
+ * 3. **File** — `rawValue.startsWith("@")` reads the file at the path that
+ *    follows the `@` and returns its UTF-8 contents. ENOENT becomes
+ *    `FILE_NOT_FOUND`; any other read failure becomes `FILE_READ_ERROR`.
+ * 4. **Inline** — any other defined `rawValue` is returned verbatim.
+ *
+ * Returns `undefined` when neither `rawValue` is defined nor `enableEditor`
+ * is set — this is the "user did not pass the flag" case, which the caller
+ * usually branches on to leave the field unchanged.
+ *
+ * Throws {@link FreeTextError} for input mistakes; callers are expected to
+ * surface the error with the standard `(<code>): <message>` rendering and
+ * exit non-zero before any network call is made.
+ */
+export declare function resolveFreeText(rawValue: string | undefined, options: ResolveFreeTextOptions): Promise<string | undefined>;
+//# sourceMappingURL=freetext.d.ts.map

package/dist/lib/freetext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freetext.d.ts","sourceRoot":"","sources":["../../src/lib/freetext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK9E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,CAAC;AAEpB;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;IAFzC,SAAkB,IAAI,mBAAmB;gBAEvB,IAAI,EAAE,iBAAiB,EACvC,OAAO,EAAE,MAAM;CAIlB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAEvC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,YAAY,CAAC;CACtC;AAQD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwD7B"}

package/dist/lib/freetext.js

@@ -0,0 +1,182 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { spawn as defaultSpawn } from "node:child_process";
+import { mkdtemp, readFile as defaultReadFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Typed error thrown by {@link resolveFreeText} for input mistakes the user
+ * must fix before retrying. Callers render the standard
+ * `<command> failed (<code>): <message>` shape and exit non-zero.
+ *
+ * Production failures from the API or the platform stay typed as their
+ * domain errors (e.g. `profile.basic.ProfileError`, `TtctlError`); this
+ * type covers ONLY input-resolution failures that happen on the local
+ * machine before any network call.
+ */
+export class FreeTextError extends Error {
+    code;
+    name = "FreeTextError";
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+// Module-level guard for the "two flags both want stdin" diagnostic. Once
+// any caller has consumed stdin in this process, a second `-` claim throws
+// `STDIN_DOUBLE_CLAIM` instead of reading already-empty input. Tests reset
+// this via {@link _resetStdinClaimForTesting}.
+let stdinClaimed = false;
+/**
+ * Reset the module-level stdin-claim guard. Test-only. Production callers
+ * must not call this — the guard exists precisely to prevent the same
+ * process from consuming stdin twice in a single CLI invocation.
+ *
+ * @internal
+ */
+export function _resetStdinClaimForTesting() {
+    stdinClaimed = false;
+}
+/**
+ * Resolve a free-text flag value through the four supported input modes.
+ *
+ * Modes (in priority order):
+ *
+ * 1. **Editor** — `enableEditor === true` opens `$EDITOR` seeded with
+ *    `currentValue` and returns the saved buffer. Combining `enableEditor`
+ *    with a defined `rawValue` is ambiguous; the helper rejects it before
+ *    any I/O.
+ * 2. **Stdin** — `rawValue === "-"` reads `process.stdin` (or the injected
+ *    stream) until EOF. Empty stdin is NOT an error — it returns the empty
+ *    string, per AC. A non-piped TTY surfaces `STDIN_UNAVAILABLE` rather
+ *    than hanging the CLI forever waiting on an interactive user.
+ * 3. **File** — `rawValue.startsWith("@")` reads the file at the path that
+ *    follows the `@` and returns its UTF-8 contents. ENOENT becomes
+ *    `FILE_NOT_FOUND`; any other read failure becomes `FILE_READ_ERROR`.
+ * 4. **Inline** — any other defined `rawValue` is returned verbatim.
+ *
+ * Returns `undefined` when neither `rawValue` is defined nor `enableEditor`
+ * is set — this is the "user did not pass the flag" case, which the caller
+ * usually branches on to leave the field unchanged.
+ *
+ * Throws {@link FreeTextError} for input mistakes; callers are expected to
+ * surface the error with the standard `(<code>): <message>` rendering and
+ * exit non-zero before any network call is made.
+ */
+export async function resolveFreeText(rawValue, options) {
+    const { flagName } = options;
+    const enableEditor = options.enableEditor ?? false;
+    // Mode-conflict gate: combining `--edit` with any concrete value (inline,
+    // `-`, or `@path`) is ambiguous about which side wins, so we refuse to
+    // guess. Catches all three cross-mode combinations in a single check.
+    if (enableEditor && rawValue !== undefined) {
+        throw new FreeTextError("MODE_CONFLICT", `--edit cannot be combined with --${flagName} <value>; pick one input mode`);
+    }
+    if (enableEditor) {
+        const editor = options.editorEnv ?? process.env.EDITOR ?? "vi";
+        const seed = options.currentValue ?? "";
+        return invokeEditor(editor, seed, options.spawn ?? defaultSpawn);
+    }
+    if (rawValue === undefined)
+        return undefined;
+    if (rawValue === "-") {
+        if (stdinClaimed) {
+            throw new FreeTextError("STDIN_DOUBLE_CLAIM", `--${flagName}: stdin already consumed by an earlier flag; only one flag may read stdin per invocation`);
+        }
+        const stream = options.stdin ?? process.stdin;
+        if (isTtyStream(stream)) {
+            throw new FreeTextError("STDIN_UNAVAILABLE", `--${flagName}: stdin requested ('-') but no input is being piped; pipe via shell or use @path`);
+        }
+        stdinClaimed = true;
+        return readAllFromStream(stream);
+    }
+    if (rawValue.startsWith("@")) {
+        const filePath = rawValue.slice(1);
+        const reader = options.readFile ?? defaultReader;
+        try {
+            return await reader(filePath);
+        }
+        catch (err) {
+            const code = err.code;
+            const message = err instanceof Error ? err.message : String(err);
+            if (code === "ENOENT") {
+                throw new FreeTextError("FILE_NOT_FOUND", `--${flagName}: file not found: ${filePath}`);
+            }
+            throw new FreeTextError("FILE_READ_ERROR", `--${flagName}: failed to read ${filePath}: ${message}`);
+        }
+    }
+    return rawValue;
+}
+const defaultReader = (path) => defaultReadFile(path, "utf-8");
+function isTtyStream(stream) {
+    // `process.stdin` (a `tty.ReadStream`) carries `isTTY: true` when the
+    // user is running an interactive shell with no piped input. Non-TTY
+    // streams (test fakes, real pipes) lack the property at runtime even
+    // though `NodeJS.ReadStream` types it as a definite `boolean` — narrow
+    // through a structural cast so the missing-property case becomes
+    // `false` rather than a thrown access.
+    const maybeTty = stream;
+    return maybeTty.isTTY === true;
+}
+/**
+ * Read the entire stream as a UTF-8 string. The encoding is set on the
+ * stream so iteration yields strings, not Buffers — this also keeps a
+ * single decoder across chunks (avoids splitting a multi-byte character
+ * across two reads).
+ */
+async function readAllFromStream(stream) {
+    stream.setEncoding("utf-8");
+    let buf = "";
+    for await (const chunk of stream) {
+        buf += String(chunk);
+    }
+    return buf;
+}
+/**
+ * Edit-in-`$EDITOR` flow. Writes `seed` to a randomly-named file in
+ * `os.tmpdir()`, spawns the editor with `stdio: "inherit"` so the editor
+ * directly owns the user's TTY, awaits exit, reads the saved buffer, and
+ * cleans up the temp directory in `finally` even on editor failure.
+ *
+ * The editor process inherits stdio so the user sees the editor UI
+ * directly; the helper itself produces no terminal output during the edit.
+ */
+async function invokeEditor(editor, seed, spawn) {
+    const dir = await mkdtemp(join(tmpdir(), "ttctl-edit-"));
+    const tempFile = join(dir, "buffer.txt");
+    try {
+        await writeFile(tempFile, seed, "utf-8");
+        await new Promise((resolve, reject) => {
+            const child = spawn(editor, [tempFile], { stdio: "inherit" });
+            let settled = false;
+            child.on("error", (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(new FreeTextError("EDITOR_FAILED", `failed to launch editor '${editor}': ${err.message}`));
+            });
+            child.on("close", (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new FreeTextError("EDITOR_FAILED", `editor '${editor}' exited with code ${String(code)}`));
+                }
+            });
+        });
+        // `return await` inside try/finally ensures the cleanup in `finally`
+        // runs AFTER the read settles, not concurrently with it.
+        return await defaultReadFile(tempFile, "utf-8");
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true }).catch(() => {
+            // Cleanup is best-effort: the OS reaps `tmpdir` entries periodically
+            // anyway, and surfacing a cleanup failure would mask the actual
+            // editor result the caller cares about.
+        });
+    }
+}
+//# sourceMappingURL=freetext.js.map

package/dist/lib/freetext.js.map

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