@zapier/kitcore 0.17.1 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @zapier/kitcore
 
+## 0.18.0
+
+### Minor Changes
+
+- 2c8ea56: **Added `httpFetchPluginRef` (`kitcore/httpFetch`), the function
+  `dispatchHttpRequest` calls to reach the network.** Provide it and the default
+  dispatch stage calls that function instead of the ambient `fetch` — a
+  debug-wrapped fetch, a test double, a polyfill. Provide nothing and the stage
+  behaves as before.
+
+  ```ts
+  const httpFetch = defineProperty({
+    namespace: "kitcore",
+    name: "httpFetch",
+    value: myFetch,
+  });
+
+  // Or supply it by id, with no plugin of your own:
+  createSdk(root, { configuration: { [HTTP_FETCH_ID]: myFetch } });
+  ```
+
+  It is a value rather than a wrap, so the `dispatchHttpRequest` wrap slot stays
+  free for a host that replaces the stage outright.
+
+## 0.17.2
+
+### Patch Changes
+
+- 173df80: `retryHttpRequestPlugin` now reads `X-RateLimit-Reset` values under 1e9 as seconds until the window resets (the IETF draft convention, sent by rate limiters like `@fastify/rate-limit` and Envoy) instead of always as an epoch timestamp. Previously a delta value was read as a date in 1970, the computed wait clamped to zero, and every remaining attempt resent immediately. Now the retry waits as directed, and a delta beyond `maxDelayMilliseconds` gives up and returns the 429 instead of hammering. Epoch-style values (1e9 and above, e.g. GitHub's) behave as before.
+
+  `X-RateLimit-Reset` now directs the delay only on a 429. Rate limiters attach `x-ratelimit-*` headers to every response passing through them, so on a 5xx the value describes the quota window rather than the outage; those retries now use `Retry-After` when present or exponential backoff.
+
 ## 0.17.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -29,6 +29,7 @@ __export(index_exports, {
   CoreError: () => CoreError,
   CoreErrorCode: () => CoreErrorCode,
   CoreSignal: () => CoreSignal,
+  HTTP_FETCH_ID: () => HTTP_FETCH_ID,
   RETRY_HTTP_REQUEST_OPTIONS_ID: () => RETRY_HTTP_REQUEST_OPTIONS_ID,
   STABILITY_LEVELS: () => STABILITY_LEVELS,
   STABILITY_TITLES: () => STABILITY_TITLES,
@@ -89,6 +90,7 @@ __export(index_exports, {
   getRegistry: () => getRegistry,
   getRegistryPlugin: () => getRegistryPlugin,
   getSchemaDescription: () => getSchemaDescription,
+  httpFetchPluginRef: () => httpFetchPluginRef,
   initializeHttpRequestPlugin: () => initializeHttpRequestPlugin,
   isCoreCancelledSignal: () => isCoreCancelledSignal,
   isCoreError: () => isCoreError,
@@ -4944,6 +4946,8 @@ var authorizeHttpRequestPlugin = defineMethod({
 
 // src/transport/dispatch-http-request.ts
 var import_zod7 = require("zod");
+var HTTP_FETCH_ID = "kitcore/httpFetch";
+var httpFetchPluginRef = declareOptionalProperty({ id: HTTP_FETCH_ID });
 function toFetchInput(request) {
   const init = { ...request };
   const { url } = request;
@@ -4954,11 +4958,12 @@ function toFetchInput(request) {
 var dispatchHttpRequestPlugin = defineMethod({
   name: "dispatchHttpRequest",
   namespace: "kitcore",
+  imports: [httpFetchPluginRef],
   inputSchema: import_zod7.z.custom(),
   skipInputValidation: true,
-  run: async ({ input }) => {
+  run: async ({ input, imports }) => {
     const { url, init } = toFetchInput(input.request);
-    return fetch(url, init);
+    return (imports.httpFetch ?? fetch)(url, init);
   }
 });
 
@@ -5058,6 +5063,7 @@ var DEFAULT_IDEMPOTENT_METHODS = [
 ];
 var BASE_BACKOFF_MILLISECONDS = 1e3;
 var JITTER_FACTOR = 0.5;
+var EPOCH_THRESHOLD_SECONDS = 1e9;
 function directedDelayMilliseconds(response) {
   const retryAfter = response.headers.get("retry-after");
   if (retryAfter) {
@@ -5066,11 +5072,12 @@ function directedDelayMilliseconds(response) {
     const date = Date.parse(retryAfter);
     if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
   }
+  if (response.status !== 429) return void 0;
   const reset = response.headers.get("x-ratelimit-reset");
   if (reset) {
-    const resetSeconds = Number.parseInt(reset, 10);
-    if (!Number.isNaN(resetSeconds)) {
-      return Math.max(0, resetSeconds * 1e3 - Date.now());
+    const resetValue = Number.parseInt(reset, 10);
+    if (!Number.isNaN(resetValue)) {
+      return resetValue >= EPOCH_THRESHOLD_SECONDS ? Math.max(0, resetValue * 1e3 - Date.now()) : Math.max(0, resetValue * 1e3);
     }
   }
   return void 0;
@@ -5309,6 +5316,7 @@ var resolveConnectionPlugin = defineMethod({
   CoreError,
   CoreErrorCode,
   CoreSignal,
+  HTTP_FETCH_ID,
   RETRY_HTTP_REQUEST_OPTIONS_ID,
   STABILITY_LEVELS,
   STABILITY_TITLES,
@@ -5369,6 +5377,7 @@ var resolveConnectionPlugin = defineMethod({
   getRegistry,
   getRegistryPlugin,
   getSchemaDescription,
+  httpFetchPluginRef,
   initializeHttpRequestPlugin,
   isCoreCancelledSignal,
   isCoreError,