@webhooks-cc/sdk 1.1.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-C6vrhcEq.d.mts → diff-kGWh0pPP.d.mts}

@@ -2,6 +2,13 @@
  * A webhook endpoint that captures incoming HTTP requests.
  * Create endpoints via the dashboard or SDK to receive webhooks.
  */
+/** Team sharing metadata for an endpoint. */
+interface TeamShare {
+    /** Team identifier */
+    teamId: string;
+    /** Team display name */
+    teamName: string;
+}
 interface Endpoint {
     /** Unique identifier for this endpoint */
     id: string;
@@ -17,6 +24,10 @@ interface Endpoint {
     expiresAt?: number;
     /** Unix timestamp (ms) when the endpoint was created */
     createdAt: number;
+    /** Teams this endpoint is shared with (present when you own it) */
+    sharedWith?: TeamShare[];
+    /** Team this endpoint was shared from (present when shared with you) */
+    fromTeam?: TeamShare;
 }
 /** Mock response returned by the receiver instead of the default 200 OK. */
 interface MockResponse {
@@ -477,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 {
@@ -700,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 WebhookFlowVerifyOptions as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, TimeoutError as G, type HarExport as H, type UpdateEndpointOptions as I, type JsonBodyDiff as J, type UsageInfo as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type ValueDifference as Q, type Request as R, type SearchResult as S, type TemplateProvider as T, UnauthorizedError as U, type VerifySignatureOptions as V, type VerifyProvider as W, type WaitForAllOptions as X, type WaitForOptions as Y, WebhookFlowBuilder as Z, type WebhookFlowResult as _, type ParsedFormBody as a, WebhooksCC as a0, WebhooksCCError as a1, diffRequests as a2, 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 TemplateProviderInfo as y, type TextBodyDiff 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-C6vrhcEq.d.ts → diff-kGWh0pPP.d.ts}

@@ -2,6 +2,13 @@
  * A webhook endpoint that captures incoming HTTP requests.
  * Create endpoints via the dashboard or SDK to receive webhooks.
  */
+/** Team sharing metadata for an endpoint. */
+interface TeamShare {
+    /** Team identifier */
+    teamId: string;
+    /** Team display name */
+    teamName: string;
+}
 interface Endpoint {
     /** Unique identifier for this endpoint */
     id: string;
@@ -17,6 +24,10 @@ interface Endpoint {
     expiresAt?: number;
     /** Unix timestamp (ms) when the endpoint was created */
     createdAt: number;
+    /** Teams this endpoint is shared with (present when you own it) */
+    sharedWith?: TeamShare[];
+    /** Team this endpoint was shared from (present when shared with you) */
+    fromTeam?: TeamShare;
 }
 /** Mock response returned by the receiver instead of the default 200 OK. */
 interface MockResponse {
@@ -477,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 {
@@ -700,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 WebhookFlowVerifyOptions as $, ApiError as A, type BodyDiff as B, type ClearRequestsOptions as C, type DiffRequestsOptions as D, type Endpoint as E, type FormBodyValue as F, TimeoutError as G, type HarExport as H, type UpdateEndpointOptions as I, type JsonBodyDiff as J, type UsageInfo as K, type ListPaginatedRequestsOptions as L, type MockResponse as M, NotFoundError as N, type OperationDescription as O, type ParsedBody as P, type ValueDifference as Q, type Request as R, type SearchResult as S, type TemplateProvider as T, UnauthorizedError as U, type VerifySignatureOptions as V, type VerifyProvider as W, type WaitForAllOptions as X, type WaitForOptions as Y, WebhookFlowBuilder as Z, type WebhookFlowResult as _, type ParsedFormBody as a, WebhooksCC as a0, WebhooksCCError as a1, diffRequests as a2, 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 TemplateProviderInfo as y, type TextBodyDiff 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-C6vrhcEq.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 TemplateProvider, y as TemplateProviderInfo, z as TextBodyDiff, G as TimeoutError, U as UnauthorizedError, I as UpdateEndpointOptions, K as UsageInfo, Q as ValueDifference, W as VerifyProvider, X as WaitForAllOptions, Y as WaitForOptions, Z as WebhookFlowBuilder, _ as WebhookFlowResult, $ as WebhookFlowVerifyOptions, a0 as WebhooksCC, a1 as WebhooksCCError, a2 as diffRequests } from './diff-C6vrhcEq.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-C6vrhcEq.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 TemplateProvider, y as TemplateProviderInfo, z as TextBodyDiff, G as TimeoutError, U as UnauthorizedError, I as UpdateEndpointOptions, K as UsageInfo, Q as ValueDifference, W as VerifyProvider, X as WaitForAllOptions, Y as WaitForOptions, Z as WebhookFlowBuilder, _ as WebhookFlowResult, $ as WebhookFlowVerifyOptions, a0 as WebhooksCC, a1 as WebhooksCCError, a2 as diffRequests } from './diff-C6vrhcEq.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);
@@ -2472,7 +2489,11 @@ var WebhooksCC = class {
         return this.request("POST", "/endpoints", body);
       },
       list: async () => {
-        return this.request("GET", "/endpoints");
+        const response = await this.request(
+          "GET",
+          "/endpoints"
+        );
+        return [...response.owned, ...response.shared];
       },
       get: async (slug) => {
         validatePathSegment(slug, "slug");

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);
@@ -2331,7 +2343,11 @@ var WebhooksCC = class {
         return this.request("POST", "/endpoints", body);
       },
       list: async () => {
-        return this.request("GET", "/endpoints");
+        const response = await this.request(
+          "GET",
+          "/endpoints"
+        );
+        return [...response.owned, ...response.shared];
       },
       get: async (slug) => {
         validatePathSegment(slug, "slug");

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { g as DiffResult, e as CreateEndpointOptions, R as Request, a0 as WebhooksCC, E as Endpoint } from './diff-C6vrhcEq.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, a0 as WebhooksCC, E as Endpoint } from './diff-C6vrhcEq.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.1.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",
@@ -39,7 +39,7 @@
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.1"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",