@zapier/zapier-sdk 0.102.0 → 0.102.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @zapier/zapier-sdk
 
+## 0.102.1
+
+### Patch Changes
+
+- 173df80: `ZapierRateLimitError` now surfaces the server's explanatory message — quota used, when the window resets, and how to request a higher limit — instead of the bare string "Rate limited". When the response body is empty or unreadable, the message falls back to "Rate limited" as before.
+
+  `rateLimit.resetMs` on the error is now a real epoch timestamp when the server sends `X-RateLimit-Reset` as seconds-until-reset (the IETF draft convention) instead of a date in 1970. This also fixes the retry delay computed from that header when `Retry-After` is absent, which previously collapsed to zero and retried immediately.
+
+- Updated dependencies [173df80]
+  - @zapier/kitcore@0.17.2
+
 ## 0.102.0
 
 ### Minor Changes

package/dist/{chunk-V4FAEYKU.cjs → chunk-424K4TOH.cjs}

@@ -1988,7 +1988,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.102.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.102.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -2104,6 +2104,7 @@ var PollApprovalResponseSchema = zod.z.object({
   approval_url: zod.z.string().optional()
 });
 var APPROVAL_MAX_POLLING_INTERVAL_MILLISECONDS = 5e3;
+var EPOCH_THRESHOLD_SECONDS = 1e9;
 function validateSdkPath(path) {
   if (!path.startsWith("/") || path.startsWith("//")) {
     throw new ZapierValidationError(
@@ -2144,11 +2145,12 @@ function parseRateLimitHeaders(response) {
   }
   const reset = response.headers.get("x-ratelimit-reset");
   if (reset) {
-    const resetTimestamp = parseInt(reset, 10);
-    if (!isNaN(resetTimestamp)) {
-      info.resetMs = resetTimestamp * 1e3;
+    const resetValue = parseInt(reset, 10);
+    if (!isNaN(resetValue)) {
+      const isEpoch = resetValue >= EPOCH_THRESHOLD_SECONDS;
+      info.resetMs = isEpoch ? resetValue * 1e3 : Date.now() + resetValue * 1e3;
       if (info.retryAfterMs === void 0) {
-        info.retryAfterMs = Math.max(0, info.resetMs - Date.now());
+        info.retryAfterMs = isEpoch ? Math.max(0, info.resetMs - Date.now()) : Math.max(0, resetValue * 1e3);
       }
     }
   }
@@ -2286,11 +2288,14 @@ var ZapierApiClient = class {
         const rateLimitInfo = parseRateLimitHeaders(response);
         const delayMs = rateLimitInfo.retryAfterMs ?? calculateExponentialBackoffMs(retries + 1);
         if (delayMs > this.maxNetworkRetryDelayMilliseconds || retries >= this.maxNetworkRetries) {
-          throw new ZapierRateLimitError("Rate limited", {
-            statusCode: 429,
-            rateLimit: rateLimitInfo,
-            retries
-          });
+          throw new ZapierRateLimitError(
+            await this.readRateLimitErrorMessage(response),
+            {
+              statusCode: 429,
+              rateLimit: rateLimitInfo,
+              retries
+            }
+          );
         }
         retries++;
         this.emitEvent("api:rate_limit_retry", {
@@ -2725,6 +2730,17 @@ var ZapierApiClient = class {
     }
     return void 0;
   }
+  // Surface the server's explanatory 429 body (e.g. quota details and how
+  // to get a higher limit) instead of a bare "Rate limited". The body is
+  // only consumed on the terminal throw path, never on retries.
+  async readRateLimitErrorMessage(response) {
+    try {
+      const { data } = await this.parseResult(response);
+      return this.extractErrorMessage(data)?.trim() || "Rate limited";
+    } catch {
+      return "Rate limited";
+    }
+  }
   // Helper to parse API error response
   parseErrorResponse(errorInfo) {
     const fallbackMessage = `HTTP ${errorInfo.status}: ${errorInfo.statusText}`;

package/dist/{chunk-SAKWJ4RS.mjs → chunk-6EO4LIAI.mjs}

@@ -1987,7 +1987,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.102.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.102.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -2103,6 +2103,7 @@ var PollApprovalResponseSchema = z.object({
   approval_url: z.string().optional()
 });
 var APPROVAL_MAX_POLLING_INTERVAL_MILLISECONDS = 5e3;
+var EPOCH_THRESHOLD_SECONDS = 1e9;
 function validateSdkPath(path) {
   if (!path.startsWith("/") || path.startsWith("//")) {
     throw new ZapierValidationError(
@@ -2143,11 +2144,12 @@ function parseRateLimitHeaders(response) {
   }
   const reset = response.headers.get("x-ratelimit-reset");
   if (reset) {
-    const resetTimestamp = parseInt(reset, 10);
-    if (!isNaN(resetTimestamp)) {
-      info.resetMs = resetTimestamp * 1e3;
+    const resetValue = parseInt(reset, 10);
+    if (!isNaN(resetValue)) {
+      const isEpoch = resetValue >= EPOCH_THRESHOLD_SECONDS;
+      info.resetMs = isEpoch ? resetValue * 1e3 : Date.now() + resetValue * 1e3;
       if (info.retryAfterMs === void 0) {
-        info.retryAfterMs = Math.max(0, info.resetMs - Date.now());
+        info.retryAfterMs = isEpoch ? Math.max(0, info.resetMs - Date.now()) : Math.max(0, resetValue * 1e3);
       }
     }
   }
@@ -2285,11 +2287,14 @@ var ZapierApiClient = class {
         const rateLimitInfo = parseRateLimitHeaders(response);
         const delayMs = rateLimitInfo.retryAfterMs ?? calculateExponentialBackoffMs(retries + 1);
         if (delayMs > this.maxNetworkRetryDelayMilliseconds || retries >= this.maxNetworkRetries) {
-          throw new ZapierRateLimitError("Rate limited", {
-            statusCode: 429,
-            rateLimit: rateLimitInfo,
-            retries
-          });
+          throw new ZapierRateLimitError(
+            await this.readRateLimitErrorMessage(response),
+            {
+              statusCode: 429,
+              rateLimit: rateLimitInfo,
+              retries
+            }
+          );
         }
         retries++;
         this.emitEvent("api:rate_limit_retry", {
@@ -2724,6 +2729,17 @@ var ZapierApiClient = class {
     }
     return void 0;
   }
+  // Surface the server's explanatory 429 body (e.g. quota details and how
+  // to get a higher limit) instead of a bare "Rate limited". The body is
+  // only consumed on the terminal throw path, never on retries.
+  async readRateLimitErrorMessage(response) {
+    try {
+      const { data } = await this.parseResult(response);
+      return this.extractErrorMessage(data)?.trim() || "Rate limited";
+    } catch {
+      return "Rate limited";
+    }
+  }
   // Helper to parse API error response
   parseErrorResponse(errorInfo) {
     const fallbackMessage = `HTTP ${errorInfo.status}: ${errorInfo.statusText}`;