@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/transport-resilience.d.ts

@@ -0,0 +1,136 @@
+import { TtctlError } from "./auth/errors.js";
+import type { ToptalSurface } from "./types.js";
+/**
+ * Final-failure transport error raised after all retries are exhausted or
+ * when a fatal signal-driven condition (caller abort, internal timeout)
+ * terminates the request loop.
+ *
+ * Extends {@link TtctlError} so it propagates through service callers'
+ * `if (err instanceof TtctlError) throw err;` guard verbatim — surfaces
+ * (CLI / MCP) render `error.recovery` directly.
+ *
+ * **Codes**:
+ *
+ * - `TIMEOUT`     — internal per-request timeout fired (default 30s,
+ *                   overridable via `TTCTL_TRANSPORT_TIMEOUT_MS`). The
+ *                   underlying socket/handshake never completed in time.
+ * - `ABORTED`     — caller's `AbortSignal` aborted before the request
+ *                   completed. Typically driven by the MCP client cancelling
+ *                   an in-flight tool call.
+ * - `RATE_LIMITED` — HTTP 429 returned by the surface and the retry budget
+ *                    was exhausted. `lastRetryAfterMs` (when set) reports
+ *                    the server's last `Retry-After` hint.
+ * - `SERVER_ERROR` — HTTP 5xx returned by the surface and the retry budget
+ *                    was exhausted.
+ */
+export declare class TransportError extends TtctlError {
+    readonly surface: ToptalSurface;
+    readonly endpoint: string;
+    readonly attempts: number;
+    readonly lastStatus?: number | undefined;
+    readonly lastRetryAfterMs?: number | undefined;
+    readonly name = "TransportError";
+    readonly code: "TIMEOUT" | "ABORTED" | "RATE_LIMITED" | "SERVER_ERROR";
+    readonly recovery: string;
+    constructor(code: "TIMEOUT" | "ABORTED" | "RATE_LIMITED" | "SERVER_ERROR", surface: ToptalSurface, endpoint: string, attempts: number, message: string, lastStatus?: number | undefined, lastRetryAfterMs?: number | undefined, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Transport resilience configuration. All fields are read from environment
+ * variables ONCE on first call to {@link readTransportConfig} and cached. The
+ * cache is reset by {@link resetTransportConfigCache} (test-only).
+ *
+ * Env-var resolution:
+ *
+ * | Field          | Env var                              | Default | Bounds   |
+ * |----------------|--------------------------------------|---------|----------|
+ * | `timeoutMs`    | `TTCTL_TRANSPORT_TIMEOUT_MS`         | 30000   | ≥ 1      |
+ * | `connectMs`    | `TTCTL_TRANSPORT_CONNECT_TIMEOUT_MS` | 10000   | ≥ 1      |
+ * | `maxRetries`   | `TTCTL_TRANSPORT_MAX_RETRIES`        | 3       | 0–10     |
+ *
+ * Invalid values (NaN, negative, out-of-range) silently fall back to the
+ * default — the transport must not blow up on a stray operator typo in an
+ * MCP client env block.
+ */
+export interface TransportConfig {
+    /** Total request timeout in milliseconds applied to each attempt. */
+    timeoutMs: number;
+    /** Connection-establishment timeout in milliseconds. */
+    connectMs: number;
+    /** Maximum number of retry attempts for 429 and 5xx responses. */
+    maxRetries: number;
+}
+export declare function readTransportConfig(): TransportConfig;
+/**
+ * Reset the cached transport config so the next {@link readTransportConfig}
+ * call re-reads the environment. Test-only — production callers never reach
+ * for this directly.
+ */
+export declare function resetTransportConfigCache(): void;
+/**
+ * Parse an HTTP `Retry-After` header value into a delay in milliseconds.
+ *
+ * The header takes one of two forms (RFC 9110 § 10.2.3):
+ *
+ * - **delta-seconds** — an integer number of seconds (e.g. `Retry-After: 30`).
+ * - **HTTP-date**     — an absolute timestamp (e.g.
+ *   `Retry-After: Fri, 31 Dec 2025 23:59:59 GMT`); delay is computed as
+ *   `target - now`, clamped to ≥ 0.
+ *
+ * Returns `undefined` when the header is absent, malformed, or yields a
+ * negative delay; callers fall back to computed exponential backoff.
+ *
+ * `nowMs` is injectable for deterministic tests.
+ */
+export declare function parseRetryAfter(headerValue: string | undefined, nowMs?: number): number | undefined;
+/**
+ * Compute exponential-backoff delay in milliseconds for a retry attempt.
+ *
+ * Formula: `baseMs × 2^attempt`, with ±25 % uniform jitter, clamped to
+ * `capMs`. `attempt` is zero-indexed (0 = first retry).
+ *
+ * 429 responses use a longer base (250 ms) than 5xx (100 ms) so a rate-limit
+ * recovery walks back further than a transient server hiccup. The jitter
+ * (`random` injectable for tests) reduces the thundering-herd risk when many
+ * MCP tool calls land on the same 429 window simultaneously.
+ */
+export declare function computeBackoffDelay(reason: "rate-limit" | "server-error", attempt: number, random?: () => number): number;
+/**
+ * Sleep for `ms` milliseconds, rejecting with the signal's abort reason if
+ * the caller aborts during the wait. Used for between-retry backoff so a
+ * cancellation propagates promptly rather than waiting out the full delay.
+ */
+export declare function sleepUnlessAborted(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Combine the caller's `AbortSignal` (if any) with a per-attempt internal
+ * timeout into a single signal usable by the underlying transport. Returns
+ * the combined signal plus a `dispose()` to release the timeout resource
+ * once the attempt completes (preventing dangling timers).
+ *
+ * When no caller signal is provided, the combined signal IS the timeout
+ * signal directly — no `AbortSignal.any` wrapping overhead.
+ */
+export declare function combineSignals(callerSignal: AbortSignal | undefined, timeoutMs: number): {
+    signal: AbortSignal;
+    dispose: () => void;
+};
+/**
+ * Classify an error thrown by the underlying transport into a stable
+ * category so the retry loop can decide whether to retry, surface, or
+ * re-throw.
+ *
+ * - `aborted-by-caller` — the caller's signal aborted (cancellation).
+ * - `timeout`           — the internal per-attempt timeout fired.
+ * - `network`           — any other transport-level failure (DNS, socket
+ *                          reset, TLS error). NOT retried in v1 (could be a
+ *                          follow-up for #229 if empirical wedge data shows
+ *                          retries help).
+ */
+export declare function classifyTransportError(err: unknown, callerSignal: AbortSignal | undefined): "aborted-by-caller" | "timeout" | "network";
+/**
+ * Determine whether a response status code is retryable per the issue
+ * #229 policy.
+ */
+export declare function isRetryableStatus(status: number): boolean;
+//# sourceMappingURL=transport-resilience.d.ts.map

package/dist/transport-resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-resilience.d.ts","sourceRoot":"","sources":["../src/transport-resilience.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,cAAe,SAAQ,UAAU;aAO1B,OAAO,EAAE,aAAa;aACtB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;aAEhB,UAAU,CAAC,EAAE,MAAM;aACnB,gBAAgB,CAAC,EAAE,MAAM;IAX3C,SAAkB,IAAI,oBAAoB;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,EAC7C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,gBAAgB,CAAC,EAAE,MAAM,YAAA,EACzC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMhC;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAgB,mBAAmB,IAAI,eAAe,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAkBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,MAAmB,GAAG,MAAM,GAAG,SAAS,CAmB/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,GAAG,cAAc,EACrC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,MAAoB,GACjC,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlF;AAeD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,WAAW,GAAG,SAAS,EACrC,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAe9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,YAAY,EAAE,WAAW,GAAG,SAAS,GACpC,mBAAmB,GAAG,SAAS,GAAG,SAAS,CAO7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/transport-resilience.js

@@ -0,0 +1,247 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { TtctlError } from "./auth/errors.js";
+/**
+ * Final-failure transport error raised after all retries are exhausted or
+ * when a fatal signal-driven condition (caller abort, internal timeout)
+ * terminates the request loop.
+ *
+ * Extends {@link TtctlError} so it propagates through service callers'
+ * `if (err instanceof TtctlError) throw err;` guard verbatim — surfaces
+ * (CLI / MCP) render `error.recovery` directly.
+ *
+ * **Codes**:
+ *
+ * - `TIMEOUT`     — internal per-request timeout fired (default 30s,
+ *                   overridable via `TTCTL_TRANSPORT_TIMEOUT_MS`). The
+ *                   underlying socket/handshake never completed in time.
+ * - `ABORTED`     — caller's `AbortSignal` aborted before the request
+ *                   completed. Typically driven by the MCP client cancelling
+ *                   an in-flight tool call.
+ * - `RATE_LIMITED` — HTTP 429 returned by the surface and the retry budget
+ *                    was exhausted. `lastRetryAfterMs` (when set) reports
+ *                    the server's last `Retry-After` hint.
+ * - `SERVER_ERROR` — HTTP 5xx returned by the surface and the retry budget
+ *                    was exhausted.
+ */
+export class TransportError extends TtctlError {
+    surface;
+    endpoint;
+    attempts;
+    lastStatus;
+    lastRetryAfterMs;
+    name = "TransportError";
+    code;
+    recovery;
+    constructor(code, surface, endpoint, attempts, message, lastStatus, lastRetryAfterMs, options) {
+        super(message, options);
+        this.surface = surface;
+        this.endpoint = endpoint;
+        this.attempts = attempts;
+        this.lastStatus = lastStatus;
+        this.lastRetryAfterMs = lastRetryAfterMs;
+        this.code = code;
+        this.recovery = RECOVERY[code];
+    }
+}
+const RECOVERY = {
+    TIMEOUT: "The Toptal API did not respond in time. Try again; if the wedge persists, file an issue.",
+    ABORTED: "Request was cancelled by the caller before it completed.",
+    RATE_LIMITED: "Toptal returned HTTP 429 (rate limited) after the configured retry budget. Wait a few minutes and retry.",
+    SERVER_ERROR: "Toptal returned a 5xx response after the configured retry budget. Retry later or file an issue.",
+};
+const DEFAULT_CONFIG = Object.freeze({
+    timeoutMs: 30_000,
+    connectMs: 10_000,
+    maxRetries: 3,
+});
+let cachedConfig;
+export function readTransportConfig() {
+    if (cachedConfig !== undefined)
+        return cachedConfig;
+    cachedConfig = {
+        timeoutMs: readPositiveIntEnv("TTCTL_TRANSPORT_TIMEOUT_MS", DEFAULT_CONFIG.timeoutMs),
+        connectMs: readPositiveIntEnv("TTCTL_TRANSPORT_CONNECT_TIMEOUT_MS", DEFAULT_CONFIG.connectMs),
+        maxRetries: readBoundedIntEnv("TTCTL_TRANSPORT_MAX_RETRIES", DEFAULT_CONFIG.maxRetries, 0, 10),
+    };
+    return cachedConfig;
+}
+/**
+ * Reset the cached transport config so the next {@link readTransportConfig}
+ * call re-reads the environment. Test-only — production callers never reach
+ * for this directly.
+ */
+export function resetTransportConfigCache() {
+    cachedConfig = undefined;
+}
+function readPositiveIntEnv(name, defaultValue) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === "")
+        return defaultValue;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 1)
+        return defaultValue;
+    return parsed;
+}
+function readBoundedIntEnv(name, defaultValue, min, max) {
+    const raw = process.env[name];
+    if (raw === undefined || raw === "")
+        return defaultValue;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < min || parsed > max)
+        return defaultValue;
+    return parsed;
+}
+/**
+ * Parse an HTTP `Retry-After` header value into a delay in milliseconds.
+ *
+ * The header takes one of two forms (RFC 9110 § 10.2.3):
+ *
+ * - **delta-seconds** — an integer number of seconds (e.g. `Retry-After: 30`).
+ * - **HTTP-date**     — an absolute timestamp (e.g.
+ *   `Retry-After: Fri, 31 Dec 2025 23:59:59 GMT`); delay is computed as
+ *   `target - now`, clamped to ≥ 0.
+ *
+ * Returns `undefined` when the header is absent, malformed, or yields a
+ * negative delay; callers fall back to computed exponential backoff.
+ *
+ * `nowMs` is injectable for deterministic tests.
+ */
+export function parseRetryAfter(headerValue, nowMs = Date.now()) {
+    if (headerValue === undefined)
+        return undefined;
+    const trimmed = headerValue.trim();
+    if (trimmed === "")
+        return undefined;
+    // delta-seconds — integer form first; tolerant of leading-zero / surrounding-space variants.
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = Number.parseInt(trimmed, 10);
+        if (!Number.isFinite(seconds) || seconds < 0)
+            return undefined;
+        return seconds * 1000;
+    }
+    // HTTP-date form. RFC 9110 requires `IMF-fixdate` / `obs-date` shapes
+    // which always carry alphabetic day-name / month-name tokens; reject
+    // pure-numeric leftovers (e.g. `"-1"`, `"12.5"`) that `Date.parse`
+    // would otherwise opportunistically interpret as a year.
+    if (!/[A-Za-z]/.test(trimmed))
+        return undefined;
+    const parsed = Date.parse(trimmed);
+    if (Number.isNaN(parsed))
+        return undefined;
+    const delta = parsed - nowMs;
+    return delta > 0 ? delta : 0;
+}
+/**
+ * Compute exponential-backoff delay in milliseconds for a retry attempt.
+ *
+ * Formula: `baseMs × 2^attempt`, with ±25 % uniform jitter, clamped to
+ * `capMs`. `attempt` is zero-indexed (0 = first retry).
+ *
+ * 429 responses use a longer base (250 ms) than 5xx (100 ms) so a rate-limit
+ * recovery walks back further than a transient server hiccup. The jitter
+ * (`random` injectable for tests) reduces the thundering-herd risk when many
+ * MCP tool calls land on the same 429 window simultaneously.
+ */
+export function computeBackoffDelay(reason, attempt, random = Math.random) {
+    const baseMs = reason === "rate-limit" ? 250 : 100;
+    const capMs = 30_000;
+    const raw = baseMs * 2 ** attempt;
+    const jitter = 1 + (random() * 2 - 1) * 0.25; // ±25%
+    return Math.min(Math.max(0, Math.round(raw * jitter)), capMs);
+}
+/**
+ * Sleep for `ms` milliseconds, rejecting with the signal's abort reason if
+ * the caller aborts during the wait. Used for between-retry backoff so a
+ * cancellation propagates promptly rather than waiting out the full delay.
+ */
+export function sleepUnlessAborted(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(toError(signal.reason));
+            return;
+        }
+        const timer = setTimeout(() => {
+            if (signal !== undefined) {
+                signal.removeEventListener("abort", onAbort);
+            }
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            // `signal` is guaranteed defined here — `onAbort` is registered only
+            // via the `signal?.addEventListener` branch below — but the listener
+            // closure references the outer-scope binding so eslint cannot infer
+            // narrowing across the boundary. Read defensively.
+            reject(toError(signal?.reason));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/**
+ * Normalise an arbitrary `AbortSignal.reason` value into an `Error`. The
+ * runtime convention is for `reason` to BE an `Error` (DOMException for
+ * `AbortSignal.timeout`, custom `Error` for `AbortController.abort(err)`),
+ * but the type is `unknown` and operators occasionally pass strings or
+ * `undefined`. Wrap non-Error shapes so downstream Promise consumers
+ * always see a real Error.
+ */
+function toError(value) {
+    if (value instanceof Error)
+        return value;
+    return new Error(typeof value === "string" ? value : "Aborted");
+}
+/**
+ * Combine the caller's `AbortSignal` (if any) with a per-attempt internal
+ * timeout into a single signal usable by the underlying transport. Returns
+ * the combined signal plus a `dispose()` to release the timeout resource
+ * once the attempt completes (preventing dangling timers).
+ *
+ * When no caller signal is provided, the combined signal IS the timeout
+ * signal directly — no `AbortSignal.any` wrapping overhead.
+ */
+export function combineSignals(callerSignal, timeoutMs) {
+    const timeoutController = new AbortController();
+    const timer = setTimeout(() => {
+        timeoutController.abort(new DOMException("Transport request timed out.", "TimeoutError"));
+    }, timeoutMs);
+    // Unref so a stray timer doesn't keep Node alive on early caller resolution.
+    timer.unref();
+    const signal = callerSignal === undefined ? timeoutController.signal : AbortSignal.any([callerSignal, timeoutController.signal]);
+    return {
+        signal,
+        dispose: () => {
+            clearTimeout(timer);
+        },
+    };
+}
+/**
+ * Classify an error thrown by the underlying transport into a stable
+ * category so the retry loop can decide whether to retry, surface, or
+ * re-throw.
+ *
+ * - `aborted-by-caller` — the caller's signal aborted (cancellation).
+ * - `timeout`           — the internal per-attempt timeout fired.
+ * - `network`           — any other transport-level failure (DNS, socket
+ *                          reset, TLS error). NOT retried in v1 (could be a
+ *                          follow-up for #229 if empirical wedge data shows
+ *                          retries help).
+ */
+export function classifyTransportError(err, callerSignal) {
+    if (callerSignal?.aborted)
+        return "aborted-by-caller";
+    if (err instanceof DOMException && err.name === "TimeoutError")
+        return "timeout";
+    if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
+        return "timeout";
+    }
+    return "network";
+}
+/**
+ * Determine whether a response status code is retryable per the issue
+ * #229 policy.
+ */
+export function isRetryableStatus(status) {
+    return status === 429 || (status >= 500 && status < 600);
+}
+//# sourceMappingURL=transport-resilience.js.map

package/dist/transport-resilience.js.map

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