@webhooks-cc/sdk 1.2.0 → 1.2.1

package/dist/{chunk-7IMPSHQY.mjs → chunk-NSGVJJSF.mjs}

@@ -26,11 +26,16 @@ var TimeoutError = class extends WebhooksCCError {
   }
 };
 var RateLimitError = class extends WebhooksCCError {
-  constructor(retryAfter) {
-    const message = retryAfter ? `Rate limited, retry after ${retryAfter}s` : "Rate limited";
+  constructor(retryAfter, meta) {
+    const message = retryAfter !== void 0 ? `Rate limited, retry after ${retryAfter}s` : "Rate limited";
     super(429, message);
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
+    if (meta) {
+      this.limit = meta.limit;
+      this.remaining = meta.remaining;
+      this.reset = meta.reset;
+    }
   }
 };
 

package/dist/{diff-DbTsOT_n.d.mts → diff-kGWh0pPP.d.mts}

@@ -488,11 +488,26 @@ declare class NotFoundError extends WebhooksCCError {
 declare class TimeoutError extends WebhooksCCError {
     constructor(timeoutMs: number);
 }
+/** Rate limit metadata from X-RateLimit-* response headers. */
+interface RateLimitMeta {
+    /** Maximum number of requests allowed in the current window. */
+    limit: number;
+    /** Number of requests remaining in the current window. */
+    remaining: number;
+    /** Unix epoch timestamp (seconds) when the rate limit window resets. */
+    reset: number;
+}
 /** Thrown when the API returns 429 Too Many Requests. */
 declare class RateLimitError extends WebhooksCCError {
     /** Seconds until the rate limit resets, if provided by the server. */
     readonly retryAfter?: number;
-    constructor(retryAfter?: number);
+    /** Maximum number of requests allowed in the current window. */
+    readonly limit?: number;
+    /** Number of requests remaining in the current window. */
+    readonly remaining?: number;
+    /** Unix epoch timestamp (seconds) when the rate limit window resets. */
+    readonly reset?: number;
+    constructor(retryAfter?: number, meta?: RateLimitMeta);
 }
 
 interface FlowClient {
@@ -711,4 +726,4 @@ type ComparableRequest = Pick<Request, "method" | "path" | "headers" | "body"> &
  */
 declare function diffRequests(left: ComparableRequest | SearchResult, right: ComparableRequest | SearchResult, options?: DiffRequestsOptions): DiffResult;
 
-export { type WebhookFlowResult as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, type TextBodyDiff as G, type HarExport as H, TimeoutError as I, type JsonBodyDiff as J, type UpdateEndpointOptions as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type UsageInfo as Q, type Request as R, type SearchResult as S, type TeamShare as T, UnauthorizedError as U, type VerifySignatureOptions as V, type ValueDifference as W, type VerifyProvider as X, type WaitForAllOptions as Y, type WaitForOptions as Z, WebhookFlowBuilder as _, type ParsedFormBody as a, type WebhookFlowVerifyOptions as a0, WebhooksCC as a1, WebhooksCCError as a2, diffRequests as a3, type SignatureVerificationResult as b, type ClientHooks as c, type ClientOptions as d, type CreateEndpointOptions as e, type CurlExport as f, type DiffResult as g, type ErrorHookInfo as h, type ExportRequestsOptions as i, type HeaderDiff as j, type ListRequestsOptions as k, type PaginatedResult as l, RateLimitError as m, type RequestDifferences as n, type RequestHookInfo as o, type RequestsExport as p, type ResponseHookInfo as q, type RetryOptions as r, type SDKDescription as s, type SearchFilters as t, type SendOptions as u, type SendTemplateOptions as v, type SendToOptions as w, type SubscribeOptions as x, type TemplateProvider as y, type TemplateProviderInfo as z };
+export { WebhookFlowBuilder as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, type TemplateProviderInfo as G, type HarExport as H, type TextBodyDiff as I, type JsonBodyDiff as J, TimeoutError as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type UpdateEndpointOptions as Q, type Request as R, type SearchResult as S, type TeamShare as T, UnauthorizedError as U, type VerifySignatureOptions as V, type UsageInfo as W, type ValueDifference as X, type VerifyProvider as Y, type WaitForAllOptions as Z, type WaitForOptions as _, type ParsedFormBody as a, type WebhookFlowResult as a0, type WebhookFlowVerifyOptions as a1, WebhooksCC as a2, WebhooksCCError as a3, diffRequests as a4, type SignatureVerificationResult as b, type ClientHooks as c, type ClientOptions as d, type CreateEndpointOptions as e, type CurlExport as f, type DiffResult as g, type ErrorHookInfo as h, type ExportRequestsOptions as i, type HeaderDiff as j, type ListRequestsOptions as k, type PaginatedResult as l, RateLimitError as m, type RateLimitMeta as n, type RequestDifferences as o, type RequestHookInfo as p, type RequestsExport as q, type ResponseHookInfo as r, type RetryOptions as s, type SDKDescription as t, type SearchFilters as u, type SendOptions as v, type SendTemplateOptions as w, type SendToOptions as x, type SubscribeOptions as y, type TemplateProvider as z };

package/dist/{diff-DbTsOT_n.d.ts → diff-kGWh0pPP.d.ts}

@@ -488,11 +488,26 @@ declare class NotFoundError extends WebhooksCCError {
 declare class TimeoutError extends WebhooksCCError {
     constructor(timeoutMs: number);
 }
+/** Rate limit metadata from X-RateLimit-* response headers. */
+interface RateLimitMeta {
+    /** Maximum number of requests allowed in the current window. */
+    limit: number;
+    /** Number of requests remaining in the current window. */
+    remaining: number;
+    /** Unix epoch timestamp (seconds) when the rate limit window resets. */
+    reset: number;
+}
 /** Thrown when the API returns 429 Too Many Requests. */
 declare class RateLimitError extends WebhooksCCError {
     /** Seconds until the rate limit resets, if provided by the server. */
     readonly retryAfter?: number;
-    constructor(retryAfter?: number);
+    /** Maximum number of requests allowed in the current window. */
+    readonly limit?: number;
+    /** Number of requests remaining in the current window. */
+    readonly remaining?: number;
+    /** Unix epoch timestamp (seconds) when the rate limit window resets. */
+    readonly reset?: number;
+    constructor(retryAfter?: number, meta?: RateLimitMeta);
 }
 
 interface FlowClient {
@@ -711,4 +726,4 @@ type ComparableRequest = Pick<Request, "method" | "path" | "headers" | "body"> &
  */
 declare function diffRequests(left: ComparableRequest | SearchResult, right: ComparableRequest | SearchResult, options?: DiffRequestsOptions): DiffResult;
 
-export { type WebhookFlowResult as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, type TextBodyDiff as G, type HarExport as H, TimeoutError as I, type JsonBodyDiff as J, type UpdateEndpointOptions as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type UsageInfo as Q, type Request as R, type SearchResult as S, type TeamShare as T, UnauthorizedError as U, type VerifySignatureOptions as V, type ValueDifference as W, type VerifyProvider as X, type WaitForAllOptions as Y, type WaitForOptions as Z, WebhookFlowBuilder as _, type ParsedFormBody as a, type WebhookFlowVerifyOptions as a0, WebhooksCC as a1, WebhooksCCError as a2, diffRequests as a3, type SignatureVerificationResult as b, type ClientHooks as c, type ClientOptions as d, type CreateEndpointOptions as e, type CurlExport as f, type DiffResult as g, type ErrorHookInfo as h, type ExportRequestsOptions as i, type HeaderDiff as j, type ListRequestsOptions as k, type PaginatedResult as l, RateLimitError as m, type RequestDifferences as n, type RequestHookInfo as o, type RequestsExport as p, type ResponseHookInfo as q, type RetryOptions as r, type SDKDescription as s, type SearchFilters as t, type SendOptions as u, type SendTemplateOptions as v, type SendToOptions as w, type SubscribeOptions as x, type TemplateProvider as y, type TemplateProviderInfo as z };
+export { WebhookFlowBuilder as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, type TemplateProviderInfo as G, type HarExport as H, type TextBodyDiff as I, type JsonBodyDiff as J, TimeoutError as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type UpdateEndpointOptions as Q, type Request as R, type SearchResult as S, type TeamShare as T, UnauthorizedError as U, type VerifySignatureOptions as V, type UsageInfo as W, type ValueDifference as X, type VerifyProvider as Y, type WaitForAllOptions as Z, type WaitForOptions as _, type ParsedFormBody as a, type WebhookFlowResult as a0, type WebhookFlowVerifyOptions as a1, WebhooksCC as a2, WebhooksCCError as a3, diffRequests as a4, type SignatureVerificationResult as b, type ClientHooks as c, type ClientOptions as d, type CreateEndpointOptions as e, type CurlExport as f, type DiffResult as g, type ErrorHookInfo as h, type ExportRequestsOptions as i, type HeaderDiff as j, type ListRequestsOptions as k, type PaginatedResult as l, RateLimitError as m, type RateLimitMeta as n, type RequestDifferences as o, type RequestHookInfo as p, type RequestsExport as q, type ResponseHookInfo as r, type RetryOptions as s, type SDKDescription as t, type SearchFilters as u, type SendOptions as v, type SendTemplateOptions as w, type SendToOptions as x, type SubscribeOptions as y, type TemplateProvider as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { R as Request, P as ParsedBody, a as ParsedFormBody, S as SearchResult, V as VerifySignatureOptions, b as SignatureVerificationResult } from './diff-DbTsOT_n.mjs';
-export { A as ApiError, B as BodyDiff, C as ClearRequestsOptions, c as ClientHooks, d as ClientOptions, e as CreateEndpointOptions, f as CurlExport, D as DiffRequestsOptions, g as DiffResult, E as Endpoint, h as ErrorHookInfo, i as ExportRequestsOptions, F as FormBodyValue, H as HarExport, j as HeaderDiff, J as JsonBodyDiff, L as ListPaginatedRequestsOptions, k as ListRequestsOptions, M as MockResponse, N as NotFoundError, O as OperationDescription, l as PaginatedResult, m as RateLimitError, n as RequestDifferences, o as RequestHookInfo, p as RequestsExport, q as ResponseHookInfo, r as RetryOptions, s as SDKDescription, t as SearchFilters, u as SendOptions, v as SendTemplateOptions, w as SendToOptions, x as SubscribeOptions, T as TeamShare, y as TemplateProvider, z as TemplateProviderInfo, G as TextBodyDiff, I as TimeoutError, U as UnauthorizedError, K as UpdateEndpointOptions, Q as UsageInfo, W as ValueDifference, X as VerifyProvider, Y as WaitForAllOptions, Z as WaitForOptions, _ as WebhookFlowBuilder, $ as WebhookFlowResult, a0 as WebhookFlowVerifyOptions, a1 as WebhooksCC, a2 as WebhooksCCError, a3 as diffRequests } from './diff-DbTsOT_n.mjs';
+import { R as Request, P as ParsedBody, a as ParsedFormBody, S as SearchResult, V as VerifySignatureOptions, b as SignatureVerificationResult } from './diff-kGWh0pPP.mjs';
+export { A as ApiError, B as BodyDiff, C as ClearRequestsOptions, c as ClientHooks, d as ClientOptions, e as CreateEndpointOptions, f as CurlExport, D as DiffRequestsOptions, g as DiffResult, E as Endpoint, h as ErrorHookInfo, i as ExportRequestsOptions, F as FormBodyValue, H as HarExport, j as HeaderDiff, J as JsonBodyDiff, L as ListPaginatedRequestsOptions, k as ListRequestsOptions, M as MockResponse, N as NotFoundError, O as OperationDescription, l as PaginatedResult, m as RateLimitError, n as RateLimitMeta, o as RequestDifferences, p as RequestHookInfo, q as RequestsExport, r as ResponseHookInfo, s as RetryOptions, t as SDKDescription, u as SearchFilters, v as SendOptions, w as SendTemplateOptions, x as SendToOptions, y as SubscribeOptions, T as TeamShare, z as TemplateProvider, G as TemplateProviderInfo, I as TextBodyDiff, K as TimeoutError, U as UnauthorizedError, Q as UpdateEndpointOptions, W as UsageInfo, X as ValueDifference, Y as VerifyProvider, Z as WaitForAllOptions, _ as WaitForOptions, $ as WebhookFlowBuilder, a0 as WebhookFlowResult, a1 as WebhookFlowVerifyOptions, a2 as WebhooksCC, a3 as WebhooksCCError, a4 as diffRequests } from './diff-kGWh0pPP.mjs';
 
 /**
  * Safely parse a JSON request body.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as Request, P as ParsedBody, a as ParsedFormBody, S as SearchResult, V as VerifySignatureOptions, b as SignatureVerificationResult } from './diff-DbTsOT_n.js';
-export { A as ApiError, B as BodyDiff, C as ClearRequestsOptions, c as ClientHooks, d as ClientOptions, e as CreateEndpointOptions, f as CurlExport, D as DiffRequestsOptions, g as DiffResult, E as Endpoint, h as ErrorHookInfo, i as ExportRequestsOptions, F as FormBodyValue, H as HarExport, j as HeaderDiff, J as JsonBodyDiff, L as ListPaginatedRequestsOptions, k as ListRequestsOptions, M as MockResponse, N as NotFoundError, O as OperationDescription, l as PaginatedResult, m as RateLimitError, n as RequestDifferences, o as RequestHookInfo, p as RequestsExport, q as ResponseHookInfo, r as RetryOptions, s as SDKDescription, t as SearchFilters, u as SendOptions, v as SendTemplateOptions, w as SendToOptions, x as SubscribeOptions, T as TeamShare, y as TemplateProvider, z as TemplateProviderInfo, G as TextBodyDiff, I as TimeoutError, U as UnauthorizedError, K as UpdateEndpointOptions, Q as UsageInfo, W as ValueDifference, X as VerifyProvider, Y as WaitForAllOptions, Z as WaitForOptions, _ as WebhookFlowBuilder, $ as WebhookFlowResult, a0 as WebhookFlowVerifyOptions, a1 as WebhooksCC, a2 as WebhooksCCError, a3 as diffRequests } from './diff-DbTsOT_n.js';
+import { R as Request, P as ParsedBody, a as ParsedFormBody, S as SearchResult, V as VerifySignatureOptions, b as SignatureVerificationResult } from './diff-kGWh0pPP.js';
+export { A as ApiError, B as BodyDiff, C as ClearRequestsOptions, c as ClientHooks, d as ClientOptions, e as CreateEndpointOptions, f as CurlExport, D as DiffRequestsOptions, g as DiffResult, E as Endpoint, h as ErrorHookInfo, i as ExportRequestsOptions, F as FormBodyValue, H as HarExport, j as HeaderDiff, J as JsonBodyDiff, L as ListPaginatedRequestsOptions, k as ListRequestsOptions, M as MockResponse, N as NotFoundError, O as OperationDescription, l as PaginatedResult, m as RateLimitError, n as RateLimitMeta, o as RequestDifferences, p as RequestHookInfo, q as RequestsExport, r as ResponseHookInfo, s as RetryOptions, t as SDKDescription, u as SearchFilters, v as SendOptions, w as SendTemplateOptions, x as SendToOptions, y as SubscribeOptions, T as TeamShare, z as TemplateProvider, G as TemplateProviderInfo, I as TextBodyDiff, K as TimeoutError, U as UnauthorizedError, Q as UpdateEndpointOptions, W as UsageInfo, X as ValueDifference, Y as VerifyProvider, Z as WaitForAllOptions, _ as WaitForOptions, $ as WebhookFlowBuilder, a0 as WebhookFlowResult, a1 as WebhookFlowVerifyOptions, a2 as WebhooksCC, a3 as WebhooksCCError, a4 as diffRequests } from './diff-kGWh0pPP.js';
 
 /**
  * Safely parse a JSON request body.

package/dist/index.js

@@ -103,11 +103,16 @@ var TimeoutError = class extends WebhooksCCError {
   }
 };
 var RateLimitError = class extends WebhooksCCError {
-  constructor(retryAfter) {
-    const message = retryAfter ? `Rate limited, retry after ${retryAfter}s` : "Rate limited";
+  constructor(retryAfter, meta) {
+    const message = retryAfter !== void 0 ? `Rate limited, retry after ${retryAfter}s` : "Rate limited";
     super(429, message);
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
+    if (meta) {
+      this.limit = meta.limit;
+      this.remaining = meta.remaining;
+      this.reset = meta.reset;
+    }
   }
 };
 
@@ -2238,7 +2243,19 @@ function mapStatusToError(status, message, response) {
         const parsed = parseInt(retryAfterHeader, 10);
         retryAfter = Number.isNaN(parsed) ? void 0 : parsed;
       }
-      return new RateLimitError(retryAfter);
+      const limitHeader = response.headers.get("x-ratelimit-limit");
+      const remainingHeader = response.headers.get("x-ratelimit-remaining");
+      const resetHeader = response.headers.get("x-ratelimit-reset");
+      let meta;
+      if (limitHeader !== null && remainingHeader !== null && resetHeader !== null) {
+        const limit = parseInt(limitHeader, 10);
+        const remaining = parseInt(remainingHeader, 10);
+        const reset = parseInt(resetHeader, 10);
+        if (!Number.isNaN(limit) && !Number.isNaN(remaining) && !Number.isNaN(reset) && limit >= 0 && remaining >= 0 && reset >= 0) {
+          meta = { limit, remaining, reset };
+        }
+      }
+      return new RateLimitError(retryAfter, meta);
     }
     default:
       return new WebhooksCCError(status, message);

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   WebhooksCCError,
   diffRequests,
   parseDuration
-} from "./chunk-7IMPSHQY.mjs";
+} from "./chunk-NSGVJJSF.mjs";
 
 // src/sse.ts
 async function* parseSSE(stream) {
@@ -2097,7 +2097,19 @@ function mapStatusToError(status, message, response) {
         const parsed = parseInt(retryAfterHeader, 10);
         retryAfter = Number.isNaN(parsed) ? void 0 : parsed;
       }
-      return new RateLimitError(retryAfter);
+      const limitHeader = response.headers.get("x-ratelimit-limit");
+      const remainingHeader = response.headers.get("x-ratelimit-remaining");
+      const resetHeader = response.headers.get("x-ratelimit-reset");
+      let meta;
+      if (limitHeader !== null && remainingHeader !== null && resetHeader !== null) {
+        const limit = parseInt(limitHeader, 10);
+        const remaining = parseInt(remainingHeader, 10);
+        const reset = parseInt(resetHeader, 10);
+        if (!Number.isNaN(limit) && !Number.isNaN(remaining) && !Number.isNaN(reset) && limit >= 0 && remaining >= 0 && reset >= 0) {
+          meta = { limit, remaining, reset };
+        }
+      }
+      return new RateLimitError(retryAfter, meta);
     }
     default:
       return new WebhooksCCError(status, message);

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { g as DiffResult, e as CreateEndpointOptions, R as Request, a1 as WebhooksCC, E as Endpoint } from './diff-DbTsOT_n.mjs';
+import { g as DiffResult, e as CreateEndpointOptions, R as Request, a2 as WebhooksCC, E as Endpoint } from './diff-kGWh0pPP.mjs';
 
 type TestingClient = Pick<WebhooksCC, "endpoints" | "requests">;
 interface AssertRequestExpectation {

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { g as DiffResult, e as CreateEndpointOptions, R as Request, a1 as WebhooksCC, E as Endpoint } from './diff-DbTsOT_n.js';
+import { g as DiffResult, e as CreateEndpointOptions, R as Request, a2 as WebhooksCC, E as Endpoint } from './diff-kGWh0pPP.js';
 
 type TestingClient = Pick<WebhooksCC, "endpoints" | "requests">;
 interface AssertRequestExpectation {

package/dist/testing.mjs

@@ -3,7 +3,7 @@ import {
   TimeoutError,
   diffRequests,
   parseDuration
-} from "./chunk-7IMPSHQY.mjs";
+} from "./chunk-NSGVJJSF.mjs";
 
 // src/testing.ts
 var MIN_CAPTURE_POLL_INTERVAL = 10;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webhooks-cc/sdk",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "TypeScript SDK for webhooks.cc — create endpoints, capture requests, assert in tests",
   "main": "dist/index.js",
   "module": "dist/index.mjs",