@configdirector/cli 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `@configdirector/cli` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.18.1] - 2026-11-03
+
+### Fixed
+
+- Commands no longer fail with `Could not reach the Admin API` when opening a connection takes longer than a quarter of a second, as it sometimes does on GitHub-hosted runners, which find the Admin API's IPv6 addresses but cannot reach them. Each of the Admin API's addresses now gets two seconds to connect before the CLI tries the next.
+- When none of the Admin API's addresses can be reached, `Could not reach the Admin API` says why each one failed, where it showed empty brackets.
+- Commands no longer fail the first time the network drops a connection to the Admin API. When a connection cannot be opened, the CLI tries again up to twice, half a second and then a second later. When the network breaks a connection after a request went out, it tries again only for requests that read, replace or delete; the others, such as `configs create`, still exit with 2, because ConfigDirector may already have received them.
+
 ## [0.18.0] - 2026-11-03
 
 ### Changed

package/dist/configdirector.mjs

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
+import { setDefaultAutoSelectFamilyAttemptTimeout } from "node:net";
 import { homedir } from "node:os";
 import { Command, CommanderError, Option } from "commander";
+import { setTimeout } from "node:timers/promises";
 import * as v from "valibot";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { mkdir, open, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
@@ -12,7 +14,7 @@ import { promisify } from "node:util";
 import { randomUUID } from "node:crypto";
 import { text } from "node:stream/consumers";
 //#region package.json
-var version = "0.18.0";
+var version = "0.18.1";
 //#endregion
 //#region src/CliError.ts
 var CliError = class extends Error {
@@ -84,9 +86,11 @@ var ServiceSuspendedError = class extends CliError {
 		super(`Your organization's service is suspended, so ConfigDirector refuses Admin API requests. The dashboard's billing page shows why and how to reinstate it. Retry after ${retryAfterSeconds} seconds.`);
 	}
 };
+const messageOf = (failure) => failure instanceof Error ? failure.message : String(failure);
+const connectionFailureReasonOf = (failure) => failure instanceof AggregateError ? failure.errors.map(messageOf).join("; ") : failure.message;
 var ApiUnreachableError = class extends CliError {
 	constructor(baseUrl, cause) {
-		const reason = cause instanceof Error && cause.cause instanceof Error ? cause.cause.message : String(cause);
+		const reason = cause instanceof Error && cause.cause instanceof Error ? connectionFailureReasonOf(cause.cause) : String(cause);
 		super(`Could not reach the Admin API at ${baseUrl} (${reason}). Check the network connection, --base-url or CONFIGDIRECTOR_BASE_URL.`);
 	}
 };
@@ -127,6 +131,40 @@ const CreatedConfigSchema = v.object({
 	server: v.boolean()
 });
 //#endregion
+//#region src/admin-api/connection-failure-retry.ts
+const millisecondsBeforeEachRetry = [500, 1e3];
+const repeatableMethods = new Set([
+	"GET",
+	"PUT",
+	"DELETE"
+]);
+const retriesAfter = {
+	"never-opened": () => true,
+	dropped: (method) => repeatableMethods.has(method),
+	"not-transient": () => false
+};
+const neverOpenedCodes = new Set(["UND_ERR_CONNECT_TIMEOUT", "EAI_AGAIN"]);
+const droppedCodes = new Set([
+	"ECONNRESET",
+	"EPIPE",
+	"UND_ERR_SOCKET"
+]);
+const connectionFailureOf = (failure) => {
+	const cause = failure instanceof Error ? failure.cause : void 0;
+	if (cause instanceof AggregateError) return "never-opened";
+	if (!(cause instanceof Error)) return "not-transient";
+	const { code = "", syscall } = cause;
+	if (syscall === "connect" || neverOpenedCodes.has(code)) return "never-opened";
+	return droppedCodes.has(code) ? "dropped" : "not-transient";
+};
+const retryDecisionAfter = (method, failure, attemptsMade) => {
+	const waitMilliseconds = millisecondsBeforeEachRetry[attemptsMade - 1];
+	return waitMilliseconds !== void 0 && retriesAfter[connectionFailureOf(failure)](method) ? {
+		decision: "retry",
+		waitMilliseconds
+	} : { decision: "give-up" };
+};
+//#endregion
 //#region src/admin-api/targeting-rules.ts
 const RuleValueSchema = v.union([
 	v.string(),
@@ -619,20 +657,25 @@ var AdminApiClient = class {
 			"User-Agent": `configdirector-cli/${version}`,
 			"X-SourceClient": "cli"
 		};
-		try {
-			return await fetch(url, "body" in request ? {
-				method: request.method,
-				headers: {
-					...headers,
-					"Content-Type": "application/json"
-				},
-				body: JSON.stringify(request.body)
-			} : {
-				method: request.method,
-				headers
-			});
-		} catch (error) {
-			throw new ApiUnreachableError(this.connection.baseUrl, error);
+		const requestInit = "body" in request ? {
+			method: request.method,
+			headers: {
+				...headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(request.body)
+		} : {
+			method: request.method,
+			headers
+		};
+		for (let attemptsMade = 1;; attemptsMade += 1) try {
+			return await fetch(url, requestInit);
+		} catch (failure) {
+			const retry = retryDecisionAfter(request.method, failure, attemptsMade);
+			switch (retry.decision) {
+				case "give-up": throw new ApiUnreachableError(this.connection.baseUrl, failure);
+				case "retry": await setTimeout(retry.waitMilliseconds);
+			}
 		}
 	}
 };
@@ -5243,6 +5286,7 @@ const run = async (invocation) => {
 };
 //#endregion
 //#region src/main.ts
+setDefaultAutoSelectFamilyAttemptTimeout(2e3);
 process.exitCode = await run({
 	commandLineArguments: process.argv.slice(2),
 	environmentVariables: process.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/cli",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Command line tool for ConfigDirector, the managed configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",