@gjsify/cli 0.64.3-next.261 → 0.64.4

package/lib/utils/transient-retry.js

@@ -0,0 +1,72 @@
+// Bounded retry for npm-side TRANSIENT failures, shared by the publish PUT and the OIDC exchange.
+//
+// THE INCIDENT (release run 39737673761, v0.64.3). During an npm incident the registry answered
+// the FIRST PUT of the sweep (`@gjsify/adwaita-core`) with `503 {"error":"Service Unavailable"}`.
+// `gjsify publish` retried only the OTP challenge, so it exited 1, `foreach --exec` threw on the
+// non-zero child, and the sweep stopped with 0 of 232 packages published. The OIDC exchange
+// already retried a 503 (v0.7.3, `@gjsify/process`); the PUT never did.
+//
+// A 5xx after a PUT may still have LANDED, so a retry is only safe because the caller treats the
+// answer to the retried PUT idempotently (409 / 403 "previously published" → the republish path).
+/** HTTP statuses worth retrying — npm-side transient/overload conditions. */
+export const TRANSIENT_STATUSES = new Set([408, 425, 429, 500, 502, 503, 504]);
+export const isTransientStatus = (status) => TRANSIENT_STATUSES.has(status);
+/** Longest single wait, whether it came from the backoff or from a `Retry-After`. */
+export const MAX_RETRY_DELAY_MS = 30_000;
+/**
+ * Milliseconds a `Retry-After` header asks for: delta-seconds or an HTTP date. `undefined` when
+ * absent or unparseable.
+ */
+export function parseRetryAfter(value, now = Date.now()) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    if (/^\d+(?:\.\d+)?$/.test(trimmed))
+        return Math.round(Number(trimmed) * 1000);
+    const at = Date.parse(trimmed);
+    return Number.isNaN(at) ? undefined : Math.max(0, at - now);
+}
+/** The wait before retry `attempt` (0-based): `Retry-After` if the server sent one, else doubling backoff; capped. */
+export function retryDelayMs(attempt, baseMs, retryAfter) {
+    const asked = parseRetryAfter(retryAfter);
+    return Math.min(asked ?? baseMs * 2 ** attempt, MAX_RETRY_DELAY_MS);
+}
+/**
+ * Five retries at 2/4/8/16/30 s: ~60 s of patience per package. Long enough to ride out a blip,
+ * short enough that a real outage fails the sweep in a minute instead of stalling 232 packages
+ * behind it — the failure is then a red job, recovered by a re-run (`--tolerate-republish`).
+ */
+export const DEFAULT_TRANSIENT_RETRIES = 5;
+export const DEFAULT_TRANSIENT_BASE_MS = 2000;
+/**
+ * Run `doFetch`, retrying a thrown network error or a transient status. Returns the last response
+ * once the budget is spent (the caller interprets the 5xx); rethrows the last network error.
+ */
+export async function fetchWithTransientRetry(doFetch, opts = {}) {
+    const retries = opts.retries ?? DEFAULT_TRANSIENT_RETRIES;
+    const baseMs = opts.baseMs ?? DEFAULT_TRANSIENT_BASE_MS;
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    for (let attempt = 0;; attempt++) {
+        let response;
+        let failure;
+        try {
+            response = await doFetch();
+        }
+        catch (err) {
+            failure = err;
+        }
+        if (response && !isTransientStatus(response.status))
+            return { response, retried: attempt };
+        if (attempt >= retries) {
+            if (response)
+                return { response, retried: attempt };
+            throw failure;
+        }
+        const delay = retryDelayMs(attempt, baseMs, response?.headers.get('retry-after'));
+        const what = response
+            ? `${response.status} ${response.statusText}`
+            : `network error: ${failure instanceof Error ? failure.message : String(failure)}`;
+        opts.log?.(`transient ${what} (attempt ${attempt + 1}/${retries + 1}), retrying in ${delay}ms`);
+        await sleep(delay);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.64.3-next.261",
+    "version": "0.64.4",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -142,22 +142,22 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/blueprint": "0.64.3-next.261",
-        "@gjsify/buffer": "0.64.3-next.261",
-        "@gjsify/create-app": "0.64.3-next.261",
-        "@gjsify/node-globals": "0.64.3-next.261",
-        "@gjsify/node-polyfills": "0.64.3-next.261",
-        "@gjsify/npm-registry": "0.64.3-next.261",
-        "@gjsify/resolve-npm": "0.64.3-next.261",
-        "@gjsify/rolldown-plugin-gjsify": "0.64.3-next.261",
-        "@gjsify/vite-plugin-blueprint": "0.64.3-next.261",
-        "@gjsify/rolldown-plugin-pnp": "0.64.3-next.261",
-        "@gjsify/semver": "0.64.3-next.261",
-        "@gjsify/tar": "0.64.3-next.261",
-        "@gjsify/tsc": "0.64.3-next.261",
-        "@gjsify/utils": "0.64.3-next.261",
-        "@gjsify/web-polyfills": "0.64.3-next.261",
-        "@gjsify/workspace": "0.64.3-next.261",
+        "@gjsify/blueprint": "^0.64.4",
+        "@gjsify/buffer": "^0.64.4",
+        "@gjsify/create-app": "^0.64.4",
+        "@gjsify/node-globals": "^0.64.4",
+        "@gjsify/node-polyfills": "^0.64.4",
+        "@gjsify/npm-registry": "^0.64.4",
+        "@gjsify/resolve-npm": "^0.64.4",
+        "@gjsify/rolldown-plugin-gjsify": "^0.64.4",
+        "@gjsify/vite-plugin-blueprint": "^0.64.4",
+        "@gjsify/rolldown-plugin-pnp": "^0.64.4",
+        "@gjsify/semver": "^0.64.4",
+        "@gjsify/tar": "^0.64.4",
+        "@gjsify/tsc": "^0.64.4",
+        "@gjsify/utils": "^0.64.4",
+        "@gjsify/web-polyfills": "^0.64.4",
+        "@gjsify/workspace": "^0.64.4",
         "acorn": "^8.17.0",
         "cosmiconfig": "^9.0.2",
         "get-tsconfig": "^4.14.0",
@@ -166,13 +166,13 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "0.64.3-next.261",
+        "@gjsify/unit": "^0.64.4",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/oxfmt-native": "0.64.3-next.261",
-        "@gjsify/rolldown-native": "0.64.3-next.261"
+        "@gjsify/oxfmt-native": "^0.64.4",
+        "@gjsify/rolldown-native": "^0.64.4"
     },
     "peerDependenciesMeta": {
         "@gjsify/oxfmt-native": {
@@ -191,6 +191,5 @@
     "bugs": {
         "url": "https://github.com/gjsify/gjsify/issues"
     },
-    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/infra/cli#readme",
-    "gitHead": "886de21be840429ce043cdbf8195172530e230d4"
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/infra/cli#readme"
 }