@automate.ax/integration-contracts 0.94.1 → 0.95.1

package/dist/close/api.d.ts

@@ -13,14 +13,16 @@ interface CloseRequestOptions<TSchema extends z.ZodType> {
 /** Error returned by a rejected Close API request. */
 export declare class CloseApiError extends Error {
     readonly details: Encodable;
+    readonly retryAfter?: string;
     readonly status: number;
     /**
      * Creates an error from a rejected Close response.
      *
      * @param status - HTTP response status.
      * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
      */
-    constructor(status: number, details: Encodable);
+    constructor(status: number, details: Encodable, retryAfter?: string);
 }
 /**
  * Creates a minimal authenticated Close REST client.

package/dist/close/api.js

@@ -17,17 +17,20 @@ export const CLOSE_RESPONSE_SCHEMA = z.union([
 /** Error returned by a rejected Close API request. */
 export class CloseApiError extends Error {
     details;
+    retryAfter;
     status;
     /**
      * Creates an error from a rejected Close response.
      *
      * @param status - HTTP response status.
      * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
      */
-    constructor(status, details) {
+    constructor(status, details, retryAfter) {
         super(`Close API request failed (${status}).`);
         this.name = "CloseApiError";
         this.details = details;
+        this.retryAfter = retryAfter;
         this.status = status;
     }
 }
@@ -85,7 +88,7 @@ export function getCloseApi(secret) {
             const parsed = text ? parseJson(text) : null;
             const result = CLOSE_RESPONSE_SCHEMA.safeParse(options.responseKeyFormat === "provider" ? parsed : fromClose(parsed));
             if (!response.ok || !result.success) {
-                throw new CloseApiError(response.status, result.success ? result.data : { response: text });
+                throw new CloseApiError(response.status, result.success ? result.data : { response: text }, response.headers.get("Retry-After") ?? undefined);
             }
             return options.responseSchema.parse(result.data);
         },

package/dist/jobnimbus/api.d.ts

@@ -21,14 +21,16 @@ interface JobNimbusRequestOptions<TSchema extends z.ZodType> {
 /** Error returned by a rejected JobNimbus API request. */
 export declare class JobNimbusApiError extends Error {
     readonly details: Encodable;
+    readonly retryAfter?: string;
     readonly status: number;
     /**
      * Creates an error from a rejected JobNimbus response.
      *
      * @param status - HTTP response status.
      * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
      */
-    constructor(status: number, details: Encodable);
+    constructor(status: number, details: Encodable, retryAfter?: string);
 }
 /**
  * Creates an authenticated client for one documented JobNimbus API root.

package/dist/jobnimbus/api.js

@@ -20,17 +20,20 @@ export const JOB_NIMBUS_RESPONSE_SCHEMA = z.union([
 /** Error returned by a rejected JobNimbus API request. */
 export class JobNimbusApiError extends Error {
     details;
+    retryAfter;
     status;
     /**
      * Creates an error from a rejected JobNimbus response.
      *
      * @param status - HTTP response status.
      * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
      */
-    constructor(status, details) {
+    constructor(status, details, retryAfter) {
         super(`JobNimbus API request failed (${status}).`);
         this.name = "JobNimbusApiError";
         this.details = details;
+        this.retryAfter = retryAfter;
         this.status = status;
     }
 }
@@ -96,7 +99,7 @@ export function getJobNimbusApi(secret, api) {
             const text = await response.text();
             const parsed = JOB_NIMBUS_RESPONSE_SCHEMA.safeParse(fromJobNimbus(text ? parseJson(text) : null));
             if (!response.ok || !parsed.success) {
-                throw new JobNimbusApiError(response.status, parsed.success ? parsed.data : { response: text });
+                throw new JobNimbusApiError(response.status, parsed.success ? parsed.data : { response: text }, response.headers.get("Retry-After") ?? undefined);
             }
             return options.responseSchema.parse(parsed.data);
         },
@@ -112,9 +115,7 @@ export async function downloadJobNimbusFile(secret, fileId) {
     const { apiKey } = JOB_NIMBUS_SECRET_SCHEMA.parse(secret);
     const response = await fetch(new URL(encodeURIComponent(z.string().trim().min(1).parse(fileId)), "https://app.jobnimbus.com/files/"), { headers: { Authorization: `Bearer ${apiKey}` } });
     if (!response.ok) {
-        throw new JobNimbusApiError(response.status, {
-            response: await response.text(),
-        });
+        throw new JobNimbusApiError(response.status, { response: await response.text() }, response.headers.get("Retry-After") ?? undefined);
     }
     return response.blob();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.94.1",
+  "version": "0.95.1",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -48,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.94.1",
+    "@automate.ax/codec": "0.95.1",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",

package/src/close/api.ts

@@ -36,6 +36,7 @@ interface CloseRequestOptions<TSchema extends z.ZodType> {
 /** Error returned by a rejected Close API request. */
 export class CloseApiError extends Error {
   readonly details: Encodable
+  readonly retryAfter?: string
   readonly status: number
 
   /**
@@ -43,11 +44,13 @@ export class CloseApiError extends Error {
    *
    * @param status - HTTP response status.
    * @param details - Codec-safe response details.
+   * @param retryAfter - Raw provider retry timing, when present.
    */
-  constructor(status: number, details: Encodable) {
+  constructor(status: number, details: Encodable, retryAfter?: string) {
     super(`Close API request failed (${status}).`)
     this.name = "CloseApiError"
     this.details = details
+    this.retryAfter = retryAfter
     this.status = status
   }
 }
@@ -128,6 +131,7 @@ export function getCloseApi(secret: unknown) {
         throw new CloseApiError(
           response.status,
           result.success ? result.data : { response: text },
+          response.headers.get("Retry-After") ?? undefined,
         )
       }
       return options.responseSchema.parse(result.data)

package/src/jobnimbus/api.ts

@@ -44,6 +44,7 @@ interface JobNimbusRequestOptions<TSchema extends z.ZodType> {
 /** Error returned by a rejected JobNimbus API request. */
 export class JobNimbusApiError extends Error {
   readonly details: Encodable
+  readonly retryAfter?: string
   readonly status: number
 
   /**
@@ -51,11 +52,13 @@ export class JobNimbusApiError extends Error {
    *
    * @param status - HTTP response status.
    * @param details - Codec-safe response details.
+   * @param retryAfter - Raw provider retry timing, when present.
    */
-  constructor(status: number, details: Encodable) {
+  constructor(status: number, details: Encodable, retryAfter?: string) {
     super(`JobNimbus API request failed (${status}).`)
     this.name = "JobNimbusApiError"
     this.details = details
+    this.retryAfter = retryAfter
     this.status = status
   }
 }
@@ -139,6 +142,7 @@ export function getJobNimbusApi(secret: unknown, api: JobNimbusApi) {
         throw new JobNimbusApiError(
           response.status,
           parsed.success ? parsed.data : { response: text },
+          response.headers.get("Retry-After") ?? undefined,
         )
       }
       return options.responseSchema.parse(parsed.data)
@@ -162,9 +166,11 @@ export async function downloadJobNimbusFile(secret: unknown, fileId: string) {
     { headers: { Authorization: `Bearer ${apiKey}` } },
   )
   if (!response.ok) {
-    throw new JobNimbusApiError(response.status, {
-      response: await response.text(),
-    })
+    throw new JobNimbusApiError(
+      response.status,
+      { response: await response.text() },
+      response.headers.get("Retry-After") ?? undefined,
+    )
   }
   return response.blob()
 }