node-autotask 0.18.0 → 0.19.0

package/dist/{chunk-VYUZZIEE.js → chunk-LB2X4X4B.js}

@@ -1,6 +1,6 @@
 import {
   CAPABILITIES
-} from "./chunk-VV2UUW2J.js";
+} from "./chunk-NDK7WYWA.js";
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -1536,6 +1536,7 @@ var DEFAULT_TIMEOUT_MS = 3e4;
 var DEFAULT_MAX_RETRIES = 3;
 var DEFAULT_MAINTENANCE_MAX_WAIT_MS = 36e5;
 var DEFAULT_MAINTENANCE_POLL_MS = 3e4;
+var MAINTENANCE_WINDOW_MAX_MS = 4 * 36e5;
 var DEFAULT_MAX_CONCURRENT = 10;
 var DEFAULT_MAX_RESPONSE_BYTES = 64 * 1024 * 1024;
 var DEFAULT_MAX_SCAN_RECORDS = 500;
@@ -14779,9 +14780,21 @@ function backoffDelay(attempt) {
   const exp = Math.min(BACKOFF_CAP_MS, BACKOFF_BASE_MS * 2 ** attempt);
   return Math.floor(exp / 2 + Math.random() * (exp / 2));
 }
-function isMaintenancePage(err) {
-  const snippet = typeof err.details?.bodySnippet === "string" ? err.details.bodySnippet : "";
-  return /maintenance|temporarily unavailable|service unavailable|outage|downtime|down for/i.test(snippet);
+var MAINTENANCE_PROBE_BYTES = 256;
+function maintenanceProbe(text) {
+  return Buffer.from(text, "utf8").subarray(0, MAINTENANCE_PROBE_BYTES).toString("utf8");
+}
+function looksLikeMaintenanceText(text) {
+  return /maintenance|temporarily unavailable|service unavailable|outage|downtime|down for/i.test(
+    maintenanceProbe(text)
+  );
+}
+function isHtmlLike(contentType, body) {
+  if (contentType !== null && /text\/html|application\/xhtml/i.test(contentType)) return true;
+  return body.trimStart().startsWith("<");
+}
+function maintenanceExhaustedAction(maxWaitMs, waits) {
+  return `The zone stayed in a maintenance window for ${Math.round(maxWaitMs / 6e4)} min \u2014 the SDK waited and retried ${waits} time(s) and gave up. Re-run after the window (the observed median is about 2 h; the ceiling is 4 h \u2014 MAINTENANCE_WINDOW_MAX_MS), or raise maintenanceMaxWaitMs.`;
 }
 function parseRetryAfter(value) {
   if (value === null || value.length === 0) return void 0;
@@ -15217,6 +15230,7 @@ var HttpClient = class {
     const maintenancePollMs = opts.maintenancePollMs ?? this.maintenancePollMs;
     let firstMaintenanceAt;
     let maintenanceWaits = 0;
+    let maintenanceBudgetSpent = false;
     const started = Date.now();
     let deadlineAt = started + timeoutMs;
     const callerSignal = opts.signal ?? ambientSignal.getStore();
@@ -15437,12 +15451,13 @@ var HttpClient = class {
               httpStatus: status,
               suggestedAction: "The zone returned a non-JSON 2xx body; verify baseUrl points at the REST API."
             });
-            if (err2.code === "UNEXPECTED_CONTENT_TYPE" && maintenanceMaxWaitMs > 0 && isMaintenancePage(err2)) {
+            if (err2.code === "UNEXPECTED_CONTENT_TYPE" && maintenanceMaxWaitMs > 0 && looksLikeMaintenanceText(text)) {
               const now = Date.now();
               firstMaintenanceAt ??= now;
               const remaining = maintenanceMaxWaitMs - (now - firstMaintenanceAt);
               if (remaining > 0) {
                 const wait = Math.min(maintenancePollMs, remaining);
+                if (wait >= remaining) maintenanceBudgetSpent = true;
                 maintenanceWaits += 1;
                 this.logger.warn?.(
                   `[autotask] maintenance window on ${method} ${opts.path}; waiting ${Math.round(wait / 1e3)}s (retry ${maintenanceWaits}, up to ${Math.round(maintenanceMaxWaitMs / 6e4)} min)`,
@@ -15453,6 +15468,7 @@ var HttpClient = class {
                 await pause(wait);
                 continue;
               }
+              maintenanceBudgetSpent = true;
             }
             if (err2.code === "UNEXPECTED_CONTENT_TYPE" && retriable5xx && attempt < maxRetries) {
               const retryAfter = parseRetryAfter(res.headers.get("Retry-After"));
@@ -15467,17 +15483,27 @@ var HttpClient = class {
                 continue;
               }
             }
-            if (maintenanceWaits > 0 && err2.code === "UNEXPECTED_CONTENT_TYPE") {
+            const pageSnippet = typeof err2.details?.bodySnippet === "string" ? err2.details.bodySnippet : "";
+            if (maintenanceWaits > 0) {
               err2.details = {
                 ...err2.details ?? {},
                 maintenance: {
                   waits: maintenanceWaits,
                   waitedMs: Date.now() - (firstMaintenanceAt ?? Date.now()),
                   maxWaitMs: maintenanceMaxWaitMs,
-                  exhausted: true
+                  exhausted: maintenanceBudgetSpent
                 }
               };
-              err2.suggestedAction = `The zone stayed in a maintenance window for ${Math.round(maintenanceMaxWaitMs / 6e4)} min \u2014 the SDK waited and retried ${maintenanceWaits} time(s) and gave up. Re-run after the window (typically under 30 min), or raise maintenanceMaxWaitMs.`;
+              if (maintenanceBudgetSpent) {
+                err2.suggestedAction = maintenanceExhaustedAction(maintenanceMaxWaitMs, maintenanceWaits);
+              }
+            }
+            if (err2.code === "UNEXPECTED_CONTENT_TYPE" && !looksLikeMaintenanceText(text) && isHtmlLike(res.headers.get("Content-Type"), text)) {
+              err2.details = { ...err2.details ?? {}, maintenancePatternMiss: true };
+              this.logger.debug?.(
+                `[autotask] non-JSON body did not match the maintenance vocabulary on ${method} ${opts.path}: ${pageSnippet}`,
+                correlationId
+              );
             }
             attachEmptyReasonDetails(err2);
             throw err2;
@@ -15489,12 +15515,37 @@ var HttpClient = class {
           break;
         }
         let body;
+        let nonJsonBody;
         if (text.length > 0) {
           try {
             body = JSON.parse(text);
           } catch {
             body = text;
+            nonJsonBody = text;
+          }
+        }
+        const nonJsonSnippet = nonJsonBody === void 0 ? void 0 : bodySnippet(nonJsonBody, this.redactPersonalData);
+        const nonJsonIsMaintenance = nonJsonBody !== void 0 && looksLikeMaintenanceText(nonJsonBody);
+        const nonJsonIsHtmlCandidate = nonJsonBody !== void 0 && isHtmlLike(res.headers.get("Content-Type"), nonJsonBody);
+        const nonJsonMaintenanceMayWait = nonJsonIsMaintenance && retriable5xx;
+        if (nonJsonBody !== void 0 && maintenanceMaxWaitMs > 0 && nonJsonMaintenanceMayWait) {
+          const now = Date.now();
+          firstMaintenanceAt ??= now;
+          const remaining = maintenanceMaxWaitMs - (now - firstMaintenanceAt);
+          if (remaining > 0) {
+            const wait = Math.min(maintenancePollMs, remaining);
+            if (wait >= remaining) maintenanceBudgetSpent = true;
+            maintenanceWaits += 1;
+            this.logger.warn?.(
+              `[autotask] maintenance window on ${method} ${opts.path} (HTTP ${status}); waiting ${Math.round(wait / 1e3)}s (retry ${maintenanceWaits}, up to ${Math.round(maintenanceMaxWaitMs / 6e4)} min)`,
+              correlationId
+            );
+            deadlineAt = Date.now() + wait + timeoutMs;
+            armDeadline(deadlineAt - Date.now());
+            await pause(wait);
+            continue;
           }
+          maintenanceBudgetSpent = true;
         }
         const deterministic500 = status >= 500 && isDeterministicVendor500(parseVendorErrors(body));
         const retryableStatus = status === 429 || status >= 500;
@@ -15537,6 +15588,32 @@ var HttpClient = class {
           credentialShapeExpectation(headers, this.auth)
         );
         err.correlationId = correlationId;
+        if (maintenanceWaits > 0) {
+          err.details = {
+            ...err.details ?? {},
+            maintenance: {
+              waits: maintenanceWaits,
+              waitedMs: Date.now() - (firstMaintenanceAt ?? Date.now()),
+              maxWaitMs: maintenanceMaxWaitMs,
+              exhausted: maintenanceBudgetSpent
+            }
+          };
+          if (maintenanceBudgetSpent) {
+            err.suggestedAction = maintenanceExhaustedAction(maintenanceMaxWaitMs, maintenanceWaits);
+          }
+        }
+        if (nonJsonBody !== void 0) {
+          if (nonJsonIsMaintenance && !retriable5xx) {
+            err.details = { ...err.details ?? {}, maintenanceDetected: true };
+            err.suggestedAction = `A maintenance-shaped page answered ${method} ${opts.path} (HTTP ${status}); it was NOT waited out or re-sent \u2014 a non-2xx edge page can arrive after the request was forwarded, so verify the record before re-issuing (only a GET or an explicitly idempotent-flagged call waits this window out).`;
+          } else if (!nonJsonIsMaintenance && nonJsonIsHtmlCandidate) {
+            err.details = { ...err.details ?? {}, maintenancePatternMiss: true };
+            this.logger.debug?.(
+              `[autotask] non-JSON body did not match the maintenance vocabulary on ${method} ${opts.path}: ${nonJsonSnippet}`,
+              correlationId
+            );
+          }
+        }
         if (status === 401 && zoneRetry !== void 0) {
           err.details = {
             ...err.details ?? {},
@@ -18702,6 +18779,7 @@ export {
   DEFAULT_MAX_RETRIES,
   DEFAULT_MAINTENANCE_MAX_WAIT_MS,
   DEFAULT_MAINTENANCE_POLL_MS,
+  MAINTENANCE_WINDOW_MAX_MS,
   DEFAULT_MAX_CONCURRENT,
   DEFAULT_MAX_RESPONSE_BYTES,
   DEFAULT_MAX_SCAN_RECORDS,