jamdesk 1.1.165 → 1.1.166

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.165",
+  "version": "1.1.166",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/lib/build/error-parser.ts

@@ -120,6 +120,79 @@ export function parseErrorDetails(
   const { pageToFileMap, discoveryHint, repoFullName } = opts;
   const lowerOutput = output.toLowerCase();
 
+  // R2 upload failure — our storage provider erred, never the customer's
+  // content. putWithRetry (scripts/upload-content-to-r2.ts) tags every
+  // failed put with this prefix; by the time we see it here the docs
+  // compiled fine and only the CDN upload failed. Checked before the
+  // generic timeout/OOM classifiers because R2 error text often contains
+  // "timeout". Transient indicators mirror isRetryableR2PutError's
+  // message heuristics — only those become `temporary` (= silently
+  // auto-retried); anything else (403 auth, missing bucket, misconfig)
+  // is platform breakage where a retry won't help and the customer +
+  // ops must hear about it immediately.
+  if (
+    phase === 'r2_upload' &&
+    (message.includes('R2 put failed') || lowerOutput.includes('r2 put failed'))
+  ) {
+    const r2Text = `${message} ${lowerOutput}`.toLowerCase();
+    const R2_TRANSIENT_INDICATORS = [
+      // Authoritative signal from putWithRetry (scripts/upload-content-to-r2.ts):
+      // its terminal catch appends "[retry envelope exhausted]" ONLY when the
+      // failure was retried the full 5 attempts by status code / error name /
+      // $retryable — a richer classification than the message-substring list
+      // below. It captures transient failures whose text matches none of those
+      // substrings (429 "Too Many Requests", SlowDown "Please reduce your
+      // request rate."). Checked first; the substrings below stay as a fallback
+      // for the SIGTERM/legacy paths that don't carry the marker.
+      'retry envelope exhausted',
+      'internal error',
+      'please try again',
+      'timeout',
+      // Bare Node socket errors ("connect ETIMEDOUT 1.2.3.4:443") do NOT
+      // contain the substring "timeout" (note the extra "d") — listed
+      // separately, mirroring isRetryableR2PutError which checks both.
+      'etimedout',
+      'econnreset',
+      'socket hang up',
+      'throttl',
+      'slow down',
+      'service unavailable',
+      // 502s can surface as a bare "Bad Gateway" body with none of the
+      // texts above — putWithRetry retries them by status code, so an
+      // exhaustion with this text is transient too.
+      'bad gateway',
+      // Matches putWithRetry's defensive post-loop fallback message
+      // ("R2 put retry loop exhausted"). That fallback is currently
+      // unreachable — the final attempt always rethrows the tagged
+      // original error — but match it anyway in case the loop structure
+      // changes; exhausting retries implies the error was transient.
+      'retry loop exhausted',
+    ];
+    if (R2_TRANSIENT_INDICATORS.some((s) => r2Text.includes(s))) {
+      return {
+        type: 'temporary',
+        message: 'Content upload failed',
+        details:
+          'Your documentation built successfully, but uploading it to our CDN hit a ' +
+          'temporary storage error on our side. Your content and repository are fine.',
+        suggestion:
+          "We'll retry this build automatically in a few minutes — no action needed; " +
+          'if a later build succeeded, this failure is already resolved. ' +
+          'If it keeps failing, click "Try Again" or contact support.',
+      };
+    }
+    return {
+      type: 'build_error',
+      message: 'Content upload failed',
+      details:
+        'Uploading your documentation to our CDN failed with a storage error on our ' +
+        'side. Your content and repository are fine.',
+      suggestion:
+        'This does not look like a passing glitch, so we have not scheduled an ' +
+        'automatic retry. Please contact support and quote the reference below.',
+    };
+  }
+
   // Extract error source information upfront - used by multiple error types
   const errorSource = extractErrorSource(output, pageToFileMap);
 

package/vendored/lib/interrupt-auto-retry.ts

@@ -0,0 +1,50 @@
+/**
+ * Auto-retry eligibility + customer-facing copy for the graceful-shutdown
+ * (SIGTERM/SIGINT) "Build interrupted" failure write in server.ts.
+ *
+ * Extracted as a pure seam (same rationale as lib/child-process.ts):
+ * server.ts starts the HTTP listener and registers the signal handlers at
+ * import time, so this logic is unit-tested here instead of through a full
+ * server import driving a real signal.
+ *
+ * Mirrors the reportFailure contract in firestore-reporter.ts exactly —
+ * Tasks 4/5 consume `autoRetryEligible === true` as meaning this rule
+ * regardless of which write path produced it:
+ * - autoRetriedFrom set → NOT eligible (once-only), and the suggestion is
+ *   rewritten to honest "we already retried" copy: this failure is the one
+ *   notification the customer receives during a persistent outage, so it
+ *   must not imply another retry is coming.
+ * - tarballKey set → NOT eligible (CLI/CI already saw the failure via
+ *   non-zero exit; silently publishing later would contradict their
+ *   recorded result).
+ * - JD_AUTO_RETRY_DISABLED=1 → NOT eligible (producer-side kill switch).
+ * - snap === null (doc read failed) → NOT eligible, generic copy
+ *   (fail-closed, legacy behavior).
+ */
+
+export interface InterruptBuildSnap {
+  get(field: string): unknown;
+}
+
+export function computeInterruptRetryFields(
+  snap: InterruptBuildSnap | null,
+  errorRef: string,
+  env: Record<string, string | undefined> = process.env,
+): { autoRetryEligible: boolean; errorSuggestion: string } {
+  const isAutoRetryBuild = Boolean(snap?.get('autoRetriedFrom'));
+  const autoRetryEligible =
+    snap !== null &&
+    env.JD_AUTO_RETRY_DISABLED !== '1' &&
+    !isAutoRetryBuild &&
+    !snap.get('tarballKey');
+
+  const reference = `\n\nIf you need help, provide this reference: ${errorRef}`;
+  const errorSuggestion = isAutoRetryBuild
+    ? 'We already retried this build automatically and it failed again — ' +
+      'this looks like a longer outage on our side. Please try again in a ' +
+      'few minutes, or contact support if it persists.' +
+      reference
+    : `This is temporary and should resolve itself. Please try again in a few minutes.${reference}`;
+
+  return { autoRetryEligible, errorSuggestion };
+}

package/vendored/workspace-package-lock.json

@@ -395,9 +395,6 @@
       "cpu": [
         "arm"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -414,9 +411,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -433,9 +427,6 @@
       "cpu": [
         "ppc64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -452,9 +443,6 @@
       "cpu": [
         "riscv64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -471,9 +459,6 @@
       "cpu": [
         "s390x"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -490,9 +475,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -509,9 +491,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -528,9 +507,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "LGPL-3.0-or-later",
       "optional": true,
       "os": [
@@ -547,9 +523,6 @@
       "cpu": [
         "arm"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -572,9 +545,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -597,9 +567,6 @@
       "cpu": [
         "ppc64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -622,9 +589,6 @@
       "cpu": [
         "riscv64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -647,9 +611,6 @@
       "cpu": [
         "s390x"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -672,9 +633,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -697,9 +655,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -722,9 +677,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "Apache-2.0",
       "optional": true,
       "os": [
@@ -999,9 +951,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1018,9 +967,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1037,9 +983,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1056,9 +999,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1398,9 +1338,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1417,9 +1354,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1436,9 +1370,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1455,9 +1386,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3959,9 +3887,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -3982,9 +3907,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -4005,9 +3927,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -4028,9 +3947,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [