@adcp/sdk 13.0.0-rc.13 → 13.0.0-rc.14

package/dist/lib/registry/index.mjs

@@ -22,6 +22,59 @@ const MAX_BRAND_BULK_DOMAINS = 25;
 const MAX_BULK_DOMAINS = 100;
 const MAX_CHECK_DOMAINS = 1e4;
 const COMMUNITY_MIRROR_PLATFORM_RE = /^[a-z0-9_-]{1,64}$/;
+const MAX_REGISTRY_ERROR_DETAILS_BYTES = 64 * 1024;
+const MAX_RETRY_AFTER_MS = 2147483647;
+class RegistryRequestError extends Error {
+  status;
+  method;
+  retryAfterMs;
+  /** Bounded, untrusted JSON returned by the remote registry. */
+  details;
+  constructor(status, message, options) {
+    super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    this.name = "RegistryRequestError";
+    this.status = status;
+    this.method = options.method;
+    this.retryAfterMs = options.retryAfterMs;
+    this.details = options.details;
+  }
+}
+function isRegistryRequestError(error) {
+  if (error instanceof RegistryRequestError) return true;
+  if (error === null || typeof error !== "object" || Array.isArray(error)) return false;
+  const candidate = error;
+  return candidate.name === "RegistryRequestError" && typeof candidate.message === "string" && typeof candidate.status === "number" && Number.isFinite(candidate.status) && typeof candidate.method === "string";
+}
+function parseRegistryErrorDetails(text) {
+  if (new TextEncoder().encode(text).byteLength > MAX_REGISTRY_ERROR_DETAILS_BYTES) return void 0;
+  try {
+    const parsed = JSON.parse(text);
+    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function boundedRetryAfterMsFromSeconds(seconds) {
+  if (!Number.isFinite(seconds) || seconds < 0) return void 0;
+  const milliseconds = seconds * 1e3;
+  if (!Number.isFinite(milliseconds)) return MAX_RETRY_AFTER_MS;
+  return Math.min(milliseconds, MAX_RETRY_AFTER_MS);
+}
+function retryAfterMsFromDetails(details) {
+  if (!details || typeof details !== "object" || Array.isArray(details)) return void 0;
+  const record = details;
+  if (typeof record.retryAfterMs === "number" && Number.isFinite(record.retryAfterMs) && record.retryAfterMs >= 0) {
+    return Math.min(record.retryAfterMs, MAX_RETRY_AFTER_MS);
+  }
+  const seconds = record.retryAfter ?? record.retry_after;
+  return typeof seconds === "number" ? boundedRetryAfterMsFromSeconds(seconds) : void 0;
+}
+function retryAfterMsFromHeader(value) {
+  const trimmed = value?.trim();
+  if (!trimmed || !/^\d+$/.test(trimmed)) return void 0;
+  const seconds = Number(trimmed);
+  return Number.isFinite(seconds) ? boundedRetryAfterMsFromSeconds(seconds) : MAX_RETRY_AFTER_MS;
+}
 function buildCommunityMirrorAdagents(config) {
   const maybeConfig = config;
   if ("authorized_agents" in maybeConfig) {
@@ -694,7 +747,7 @@ class RegistryClient {
       return { events: [], cursor: null, has_more: false, cursor_expired: true };
     }
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "GET");
     }
     return this.parseJson(text);
   }
@@ -837,7 +890,7 @@ class RegistryClient {
     const { res, text } = await this.requestText(url, { headers: this.getHeaders() });
     if (opts?.nullOn404 && res.status === 404) return null;
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "GET");
     }
     return this.parseJson(text);
   }
@@ -848,7 +901,7 @@ class RegistryClient {
       body: JSON.stringify(body)
     });
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "POST");
     }
     return this.parseJson(text);
   }
@@ -859,7 +912,7 @@ class RegistryClient {
       body
     });
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "POST");
     }
     return this.parseJson(text);
   }
@@ -870,7 +923,7 @@ class RegistryClient {
       body: JSON.stringify(body)
     });
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "PUT");
     }
     return this.parseJson(text);
   }
@@ -880,7 +933,7 @@ class RegistryClient {
       headers: this.getHeaders()
     });
     if (!res.ok) {
-      throw new Error(`Registry request failed (${res.status}): ${this.preview(text)}`);
+      throw this.requestError(res, text, "DELETE");
     }
     return this.parseJson(text);
   }
@@ -995,7 +1048,13 @@ class RegistryClient {
         redirect: this.redirect,
         signal: controller.signal
       });
-      const text = await this.readBody(res, this.bodyLimitForUrl(url));
+      let text;
+      try {
+        text = await this.readBody(res, this.bodyLimitForUrl(url));
+      } catch (error) {
+        if (!res.ok) throw this.requestError(res, "", init.method ?? "GET", error);
+        throw error;
+      }
       return { res, text };
     });
     requestPromise.catch(() => {
@@ -1080,6 +1139,17 @@ class RegistryClient {
   preview(text) {
     return text.slice(0, ERROR_BODY_PREVIEW_CHARS).replace(/[\u0000-\u001f\u007f]/g, (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, "0")}`);
   }
+  requestError(res, text, method, cause) {
+    const details = parseRegistryErrorDetails(text);
+    const retryAfterMs = retryAfterMsFromHeader(res.headers.get("retry-after")) ?? retryAfterMsFromDetails(details);
+    const preview = cause === void 0 ? this.preview(text) : "[response body unavailable]";
+    return new RegistryRequestError(res.status, `Registry request failed (${res.status}): ${preview}`, {
+      method,
+      ...retryAfterMs !== void 0 ? { retryAfterMs } : {},
+      ...details !== void 0 ? { details } : {},
+      ...cause !== void 0 ? { cause } : {}
+    });
+  }
   buildParams(options) {
     if (!options) return "";
     const params = new URLSearchParams();
@@ -1112,8 +1182,10 @@ export {
   InMemoryCursorStore,
   PropertyRegistry,
   RegistryClient,
+  RegistryRequestError,
   RegistrySync,
   buildCommunityMirrorAdagents,
+  isRegistryRequestError,
   openFeedStream2 as openFeedStream,
   parseSseStream,
   sanitizeStreamText