@eik/cli 3.1.69 → 3.2.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [3.2.0](https://github.com/eik-lib/cli/compare/v3.1.69...v3.2.0) (2026-08-28)
+
+
+### Bug Fixes
+
+* add retry to latest-version HTTP utility ([45b3115](https://github.com/eik-lib/cli/commit/45b31152e6b620df0831e9ba6ef054085ba82f98))
+* retry HTTP requests on transient 5xx responses ([f7fa656](https://github.com/eik-lib/cli/commit/f7fa656a7001bacd98b2baf21903b935bbb4b535))
+
+
+### Features
+
+* make retry count and delay configurable through API and CLI ([b909b81](https://github.com/eik-lib/cli/commit/b909b81f46f59597ad52a80df3bea815e53f8eb7))
+
 ## [3.1.69](https://github.com/eik-lib/cli/compare/v3.1.68...v3.1.69) (2026-08-24)
 
 

package/classes/integrity.js

@@ -3,6 +3,7 @@ import assert from "@eik/common/lib/schemas/assert.js";
 import ValidationError from "@eik/common/lib/schemas/validation-error.js";
 import typeSlug from "@eik/common/lib/helpers/type-slug.js";
 import { joinUrlPathname } from "../utils/url.js";
+import { fetchWithRetry } from "../utils/http/retry.js";
 
 /**
  * @typedef {object} IntegrityOptions
@@ -13,6 +14,8 @@ import { joinUrlPathname } from "../utils/url.js";
  * @property {string} version
  * @property {string} [cwd]
  * @property {boolean} [debug]
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 
 export default class Integrity {
@@ -28,6 +31,8 @@ export default class Integrity {
 		type,
 		debug = false,
 		cwd = process.cwd(),
+		retries,
+		retryDelay,
 	}) {
 		this.log = abslog(logger);
 		this.server = server;
@@ -36,6 +41,8 @@ export default class Integrity {
 		this.debug = debug;
 		this.cwd = cwd;
 		this.type = type;
+		this.retries = retries;
+		this.retryDelay = retryDelay;
 	}
 
 	async run() {
@@ -80,7 +87,10 @@ export default class Integrity {
 			);
 			this.log.debug(`  ==> url: ${url}`);
 
-			const res = await fetch(url);
+			const res = await fetchWithRetry(() => fetch(url), {
+				maxRetries: this.retries !== undefined ? this.retries + 1 : undefined,
+				baseDelayMs: this.retryDelay,
+			});
 
 			if (res.ok) {
 				this.log.debug(`  ==> ok: true`);

package/classes/publish/package/publish.js

@@ -25,6 +25,8 @@ import Cleanup from "./tasks/cleanup.js";
  * @property {string[]} [map]
  * @property {string} [out="./.eik"]
  * @property {Record<string, string>} files
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 
 /**
@@ -59,6 +61,8 @@ export default class Publish {
 		map = [],
 		out = "./.eik",
 		files = {},
+		retries,
+		retryDelay,
 	}) {
 		const config = new EikConfig(
 			{
@@ -106,8 +110,15 @@ export default class Publish {
 			logger: this.log,
 			path: this.path,
 			config,
+			retries,
+			retryDelay,
+		});
+		this.uploadFiles = new UploadFiles({
+			logger: this.log,
+			config,
+			retries,
+			retryDelay,
 		});
-		this.uploadFiles = new UploadFiles({ logger: this.log, config });
 		this.saveMetafile = new SaveMetafile({ logger: this.log, cwd, config });
 		this.cleanup = new Cleanup({
 			logger: this.log,

package/classes/publish/package/tasks/check-if-already-published.js

@@ -15,7 +15,12 @@ export default class CheckIfAlreadyPublished extends Task {
 		log.debug("  ==> Fetching package metadata from server");
 
 		try {
-			if (await integrity(server, typeSlug(type), name, version)) {
+			if (
+				await integrity(server, typeSlug(type), name, version, {
+					retries: this.retries,
+					retryDelay: this.retryDelay,
+				})
+			) {
 				throw new Error(
 					`${name} version ${version} already exists on the Eik server. Publishing is not necessary.`,
 				);

package/classes/publish/package/tasks/task.js

@@ -7,5 +7,7 @@ export default class Task {
 		this.log = abslog(options.logger);
 		this.path = options.path;
 		this.config = options.config;
+		this.retries = options.retries;
+		this.retryDelay = options.retryDelay;
 	}
 }

package/classes/publish/package/tasks/upload-files.js

@@ -23,6 +23,8 @@ export default class UploadFiles extends Task {
 				pathname,
 				file: zipFile,
 				token,
+				retries: this.retries,
+				retryDelay: this.retryDelay,
 			});
 
 			return message;

package/classes/version.js

@@ -23,6 +23,8 @@ import hashCompare from "../utils/hash/compare.js";
  * @property {string} [out="./.eik"]
  * @property {string | Record<string, string>} files
  * @property {string} [configFile="eik.json"]
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 
 export default class Version {
@@ -41,6 +43,8 @@ export default class Version {
 		out = "./.eik",
 		files,
 		configFile = "eik.json",
+		retries,
+		retryDelay,
 	}) {
 		const config = new EikConfig(
 			{
@@ -61,6 +65,8 @@ export default class Version {
 		this.configFile = configFile;
 		this.path = isAbsolute(config.out) ? config.out : join(cwd, config.out);
 		this.level = level;
+		this.retries = retries;
+		this.retryDelay = retryDelay;
 	}
 
 	/**
@@ -99,7 +105,10 @@ export default class Version {
 
 		let integrityHash;
 		try {
-			integrityHash = await integrity(server, typeSlug(type), name, version);
+			integrityHash = await integrity(server, typeSlug(type), name, version, {
+				retries: this.retries,
+				retryDelay: this.retryDelay,
+			});
 		} catch (err) {
 			throw new Error(
 				`Unable to fetch package metadata from server: ${/** @type {any} */ (err).message}`,

package/commands/integrity.js

@@ -17,6 +17,11 @@ export const builder = (yargs) => {
 				alias: "s",
 				describe: "Eik server address, if different from configuration file",
 			},
+			retries: {
+				describe:
+					"Number of retry attempts on transient server errors. Each retry waits longer than the last (500 ms, 1000 ms, …). Default: 2 retries (3 total attempts). Set to 0 to disable.",
+				type: "number",
+			},
 		})
 		.example("eik integrity")
 		.example("eik integrity --server https://assets.myserver.com");
@@ -25,7 +30,7 @@ export const builder = (yargs) => {
 export const handler = commandHandler(
 	{ command, options: ["server"] },
 	async (argv, log, spinner) => {
-		const { name, version, server, out, type, cwd, debug } = argv;
+		const { name, version, server, out, type, cwd, debug, retries } = argv;
 
 		const integrity = await new Integrity({
 			logger: log,
@@ -35,6 +40,7 @@ export const handler = commandHandler(
 			debug,
 			cwd,
 			type,
+			retries,
 		}).run();
 
 		if (integrity) {

package/commands/publish.js

@@ -27,6 +27,11 @@ export const builder = (yargs) => {
 				type: "string",
 				alias: "t",
 			},
+			retries: {
+				describe:
+					"Number of retry attempts on transient server errors. Each retry waits longer than the last (500 ms, 1000 ms, …). Default: 2 retries (3 total attempts). Set to 0 to disable.",
+				type: "number",
+			},
 		})
 		.example("eik publish")
 		.example("eik publish --dry-run")
@@ -49,6 +54,7 @@ export const handler = commandHandler(
 			files,
 			type,
 			configFile,
+			retries,
 		} = argv;
 
 		if (type === "map") {
@@ -71,6 +77,7 @@ export const handler = commandHandler(
 			map,
 			out,
 			files,
+			retries,
 		};
 
 		const publish = await new PublishPackage(options).run();

package/commands/version.js

@@ -25,6 +25,11 @@ export const builder = (yargs) => {
 				describe: "Log details about the operation and skip upload",
 				type: "boolean",
 			},
+			retries: {
+				describe:
+					"Number of retry attempts on transient server errors. Each retry waits longer than the last (500 ms, 1000 ms, …). Default: 2 retries (3 total attempts). Set to 0 to disable.",
+				type: "number",
+			},
 		})
 		.example("eik version")
 		.example("eik version minor")
@@ -46,6 +51,7 @@ export const handler = commandHandler(
 			type,
 			files,
 			configFile,
+			retries,
 		} = argv;
 
 		const options = {
@@ -60,6 +66,7 @@ export const handler = commandHandler(
 			out,
 			files,
 			configFile,
+			retries,
 		};
 
 		const newVersion = await new VersionPackage(options).run();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eik/cli",
-  "version": "3.1.69",
+  "version": "3.2.0",
   "description": "CLI tool for publishing assets to an Eik server",
   "main": "./classes/index.js",
   "types": "./types/classes/index.d.ts",

package/types/classes/integrity.d.ts

@@ -7,6 +7,14 @@ export type IntegrityOptions = {
     version: string;
     cwd?: string;
     debug?: boolean;
+    /**
+     * - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+     */
+    retries?: number;
+    /**
+     * - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
+     */
+    retryDelay?: number;
 };
 /**
  * @typedef {object} IntegrityOptions
@@ -17,6 +25,8 @@ export type IntegrityOptions = {
  * @property {string} version
  * @property {string} [cwd]
  * @property {boolean} [debug]
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 export default class Integrity {
     log: abslog.ValidLogger;
@@ -26,10 +36,12 @@ export default class Integrity {
     debug: boolean;
     cwd: string;
     type: "map" | "npm" | "package" | undefined;
+    retries: number | undefined;
+    retryDelay: number | undefined;
     /**
      *
      * @param {IntegrityOptions} options
      */
-    constructor({ logger, name, version, server, type, debug, cwd, }: IntegrityOptions);
+    constructor({ logger, name, version, server, type, debug, cwd, retries, retryDelay, }: IntegrityOptions);
     run(): Promise<any>;
 }

package/types/classes/publish/package/publish.d.ts

@@ -21,6 +21,14 @@ export type PublishOptions = {
     map?: string[];
     out?: string;
     files: Record<string, string>;
+    /**
+     * - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+     */
+    retries?: number;
+    /**
+     * - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
+     */
+    retryDelay?: number;
 };
 export type PublishResult = {
     type: string;
@@ -52,6 +60,8 @@ export type PublishResult = {
  * @property {string[]} [map]
  * @property {string} [out="./.eik"]
  * @property {Record<string, string>} files
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 /**
  * @typedef {object} PublishResult
@@ -86,7 +96,7 @@ export default class Publish {
     /**
      * @param {PublishOptions} options
      */
-    constructor({ logger, cwd, token, dryRun, server, type, name, version, map, out, files, }: PublishOptions);
+    constructor({ logger, cwd, token, dryRun, server, type, name, version, map, out, files, retries, retryDelay, }: PublishOptions);
     /**
      * @returns {Promise<PublishResult>}
      */

package/types/classes/publish/package/tasks/task.d.ts

@@ -4,6 +4,8 @@ export default class Task {
     log: abslog.ValidLogger;
     path: any;
     config: any;
+    retries: any;
+    retryDelay: any;
     /** @param {any} options */
     constructor(options: any);
 }

package/types/classes/version.d.ts

@@ -11,6 +11,14 @@ export type VersionOptions = {
     out?: string;
     files: string | Record<string, string>;
     configFile?: string;
+    /**
+     * - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+     */
+    retries?: number;
+    /**
+     * - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
+     */
+    retryDelay?: number;
 };
 /**
  * @typedef {object} VersionOptions
@@ -25,6 +33,8 @@ export type VersionOptions = {
  * @property {string} [out="./.eik"]
  * @property {string | Record<string, string>} files
  * @property {string} [configFile="eik.json"]
+ * @property {number} [retries=2] - Number of retry attempts on transient 5xx/network errors (0 to disable). Default 2 retries = 3 total attempts
+ * @property {number} [retryDelay=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
  */
 export default class Version {
     log: abslog.ValidLogger;
@@ -32,10 +42,12 @@ export default class Version {
     configFile: string;
     path: any;
     level: import("semver").ReleaseType;
+    retries: number | undefined;
+    retryDelay: number | undefined;
     /**
      * @param {VersionOptions} options
      */
-    constructor({ logger, server, type, name, version, level, cwd, map, out, files, configFile, }: VersionOptions);
+    constructor({ logger, server, type, name, version, level, cwd, map, out, files, configFile, retries, retryDelay, }: VersionOptions);
     /**
      * Similar to `npm version`, but updates `eik.json`
      * @returns {Promise<string | null>} The new version number, or null if the versioning failed

package/types/utils/http/integrity.d.ts

@@ -11,4 +11,14 @@ export default _default;
  *
  * @throws Error
  */
-declare function _default(server: string, type: string, name: string, version: string): Promise<string | null>;
+/**
+ * @param {string} server
+ * @param {string} type
+ * @param {string} name
+ * @param {string} version
+ * @param {{ retries?: number, retryDelay?: number }} [options]
+ */
+declare function _default(server: string, type: string, name: string, version: string, { retries, retryDelay }?: {
+    retries?: number;
+    retryDelay?: number;
+}): Promise<any>;

package/types/utils/http/request.d.ts

@@ -6,6 +6,8 @@ export type RequestOptions = {
     file?: string;
     map?: string;
     token?: string;
+    retries?: number;
+    retryDelay?: number;
 };
 /**
  * @typedef {object} RequestOptions
@@ -16,6 +18,8 @@ export type RequestOptions = {
  * @property {string} [file]
  * @property {string} [map]
  * @property {string} [token]
+ * @property {number} [retries]
+ * @property {number} [retryDelay]
  */
 /**
  * HTTP Utility for making requests against an Eik server

package/types/utils/http/retry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wraps a fetch call with retry logic for transient server errors (5xx).
+ * 404 responses are returned immediately without retry — they indicate the
+ * resource does not exist, not a transient failure.
+ *
+ * @param {() => Promise<Response>} fn - Function that performs the fetch call
+ * @param {object} [options]
+ * @param {number} [options.maxRetries=3] - Total number of attempts (default 3 = 1 initial + 2 retries). Pass 1 to make exactly one attempt with no retry.
+ * @param {number} [options.baseDelayMs=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
+ * @returns {Promise<Response>}
+ */
+export declare function fetchWithRetry(fn: () => Promise<Response>, { maxRetries, baseDelayMs }?: {
+    maxRetries?: number;
+    baseDelayMs?: number;
+}): Promise<Response>;

package/utils/http/integrity.js

@@ -1,4 +1,5 @@
 import { join } from "node:path";
+import { fetchWithRetry } from "./retry.js";
 
 /**
  * Fetches package integrity string by name and version from a given Eik asset server.
@@ -12,11 +13,27 @@ import { join } from "node:path";
  *
  * @throws Error
  */
-export default async (server, type, name, version) => {
+/**
+ * @param {string} server
+ * @param {string} type
+ * @param {string} name
+ * @param {string} version
+ * @param {{ retries?: number, retryDelay?: number }} [options]
+ */
+export default async (
+	server,
+	type,
+	name,
+	version,
+	{ retries, retryDelay } = {},
+) => {
 	const url = new URL(join(type, name, version), server);
 	url.search = `?t=${Date.now()}`;
 
-	const res = await fetch(url);
+	const res = await fetchWithRetry(() => fetch(url), {
+		maxRetries: retries !== undefined ? retries + 1 : undefined,
+		baseDelayMs: retryDelay,
+	});
 
 	if (!res.ok) {
 		if (res.status === 404) {

package/utils/http/latest-version.js

@@ -1,4 +1,5 @@
 import { join } from "path";
+import { fetchWithRetry } from "./retry.js";
 
 /**
  * Fetches the latest version from an Eik server of a package by name, optionally restricting the lookup to a specified semver major version
@@ -11,9 +12,21 @@ import { join } from "path";
  *
  * @throws Error
  */
-export default async (server, type, name, major) => {
+export default async (
+	server,
+	type,
+	name,
+	major,
+	/** @type {{ retries?: number, retryDelay?: number }} */ {
+		retries,
+		retryDelay,
+	} = {},
+) => {
 	const url = new URL(`${join(type, name)}?t=${Date.now()}`, server);
-	const res = await fetch(url);
+	const res = await fetchWithRetry(() => fetch(url), {
+		maxRetries: retries !== undefined ? retries + 1 : undefined,
+		baseDelayMs: retryDelay,
+	});
 	if (!res.ok) {
 		if (res.status === 404) {
 			return null;

package/utils/http/request.js

@@ -1,4 +1,5 @@
 import { readFile } from "node:fs/promises";
+import { fetchWithRetry } from "./retry.js";
 
 /**
  * @typedef {object} RequestOptions
@@ -9,6 +10,8 @@ import { readFile } from "node:fs/promises";
  * @property {string} [file]
  * @property {string} [map]
  * @property {string} [token]
+ * @property {number} [retries]
+ * @property {number} [retryDelay]
  */
 
 /**
@@ -21,7 +24,17 @@ import { readFile } from "node:fs/promises";
  * @throws Error
  */
 async function request(options) {
-	const { method = "POST", host, pathname, data, file, map, token } = options;
+	const {
+		method = "POST",
+		host,
+		pathname,
+		data,
+		file,
+		map,
+		token,
+		retries,
+		retryDelay,
+	} = options;
 	const body = new FormData();
 	const headers = new Headers();
 
@@ -49,7 +62,13 @@ async function request(options) {
 		const url = new URL(pathname, host);
 		url.search = `?t=${Date.now()}`;
 
-		const res = await fetch(url, { method, body, headers });
+		const res = await fetchWithRetry(
+			() => fetch(url, { method, body, headers }),
+			{
+				maxRetries: retries !== undefined ? retries + 1 : undefined,
+				baseDelayMs: retryDelay,
+			},
+		);
 
 		if (!res.ok) {
 			const err = new Error(

package/utils/http/retry.js

@@ -0,0 +1,45 @@
+/**
+ * Wraps a fetch call with retry logic for transient server errors (5xx).
+ * 404 responses are returned immediately without retry — they indicate the
+ * resource does not exist, not a transient failure.
+ *
+ * @param {() => Promise<Response>} fn - Function that performs the fetch call
+ * @param {object} [options]
+ * @param {number} [options.maxRetries=3] - Total number of attempts (default 3 = 1 initial + 2 retries). Pass 1 to make exactly one attempt with no retry.
+ * @param {number} [options.baseDelayMs=500] - Base delay in ms between retries; doubles each attempt (500 ms, 1000 ms, …)
+ * @returns {Promise<Response>}
+ */
+export async function fetchWithRetry(
+	fn,
+	{ maxRetries = 3, baseDelayMs = 500 } = {},
+) {
+	let lastErr;
+	for (let attempt = 1; attempt <= maxRetries; attempt++) {
+		let res;
+		try {
+			res = await fn();
+		} catch (err) {
+			// Network-level failure (ECONNRESET, ENOTFOUND, etc.)
+			lastErr = err;
+			if (attempt < maxRetries) {
+				await delay(baseDelayMs * attempt);
+				continue;
+			}
+			throw err;
+		}
+
+		// 5xx — transient server error, retry
+		if (res.status >= 500 && attempt < maxRetries) {
+			await delay(baseDelayMs * attempt);
+			continue;
+		}
+
+		return res;
+	}
+	throw lastErr;
+}
+
+/** @param {number} ms */
+function delay(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}