@agentuity/server 1.0.22 → 1.0.23

package/dist/api/webhook/destinations.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from "../api.js";
+import { CreateWebhookDestinationRequestSchema, UpdateWebhookDestinationRequestSchema, WebhookDestinationSchema, } from "./types.js";
+import { buildWebhookHeaders, WebhookError, webhookApiPath, withWebhookErrorHandling, } from "./util.js";
+export const WebhookDestinationResponseSchema = APIResponseSchema(WebhookDestinationSchema);
+export const WebhookDestinationsListResponseSchema = APIResponseSchema(z.array(WebhookDestinationSchema));
+export const DeleteWebhookDestinationResponseSchema = APIResponseSchemaNoData();
+/**
+ * Create a destination for a webhook.
+ *
+ * Destinations define where incoming webhook payloads are forwarded to.
+ * When a webhook receives a payload, it will be delivered to all configured destinations.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Destination configuration including type and config
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The created destination
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destination = await createWebhookDestination(client, 'wh_abc123', {
+ *   type: 'url',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * });
+ * console.log(`Created destination ${destination.id}`);
+ * ```
+ */
+export async function createWebhookDestination(client, webhookId, params, options) {
+    const url = webhookApiPath('destination-create', webhookId);
+    const resp = await withWebhookErrorHandling(() => client.post(url, params, WebhookDestinationResponseSchema, CreateWebhookDestinationRequestSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to create webhook destination',
+    });
+}
+/**
+ * List all destinations for a webhook.
+ *
+ * Retrieves all destinations configured for a webhook.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Array of destinations configured for the webhook
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destinations = await listWebhookDestinations(client, 'wh_abc123');
+ * for (const dest of destinations) {
+ *   console.log(`Destination ${dest.id}: type=${dest.type}`);
+ * }
+ * ```
+ */
+export async function listWebhookDestinations(client, webhookId, options) {
+    const url = webhookApiPath('destination-list', webhookId);
+    const resp = await withWebhookErrorHandling(() => client.get(url, WebhookDestinationsListResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to list webhook destinations',
+    });
+}
+/**
+ * Update a webhook destination's configuration.
+ *
+ * Modifies an existing destination's config. Only the fields provided in params will be updated.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param destinationId - The destination ID to update (prefixed with whds_)
+ * @param params - Fields to update
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The updated destination
+ * @throws {WebhookDestinationNotFoundError} If the destination does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const updated = await updateWebhookDestination(client, 'wh_abc123', 'whds_def456', {
+ *   config: { url: 'https://api.example.com/webhook/v2' },
+ * });
+ * ```
+ */
+export async function updateWebhookDestination(client, webhookId, destinationId, params, options) {
+    const url = webhookApiPath('destination-update', webhookId, destinationId);
+    const resp = await withWebhookErrorHandling(() => client.put(url, params, WebhookDestinationResponseSchema, UpdateWebhookDestinationRequestSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId, destinationId });
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to update webhook destination',
+    });
+}
+/**
+ * Delete a webhook destination.
+ *
+ * Permanently removes a destination. Webhook payloads will no longer be
+ * forwarded to this endpoint. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param destinationId - The destination ID to delete (prefixed with whds_)
+ * @param options - Optional API options (e.g., orgId)
+ * @throws {WebhookDestinationNotFoundError} If the destination does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteWebhookDestination(client, 'wh_abc123', 'whds_def456');
+ * console.log('Destination deleted');
+ * ```
+ */
+export async function deleteWebhookDestination(client, webhookId, destinationId, options) {
+    const url = webhookApiPath('destination-delete', webhookId, destinationId);
+    const resp = await withWebhookErrorHandling(() => client.delete(url, DeleteWebhookDestinationResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId, destinationId });
+    if (resp.success) {
+        return;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to delete webhook destination',
+    });
+}
+//# sourceMappingURL=destinations.js.map

package/dist/api/webhook/destinations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.js","sourceRoot":"","sources":["../../../src/api/webhook/destinations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAEN,qCAAqC,EAErC,qCAAqC,EAGrC,wBAAwB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,qCAAqC,GAAG,iBAAiB,CACrE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,sCAAsC,GAAG,uBAAuB,EAAE,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,MAAiB,EACjB,SAAiB,EACjB,MAAuC,EACvC,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,IAAI,CACV,GAAG,EACH,MAAM,EACN,gCAAgC,EAChC,qCAAqC,EACrC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,CACb,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,sCAAsC;KAC/D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAiB,EACjB,SAAiB,EACjB,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CACT,GAAG,EACH,qCAAqC,EACrC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,CACb,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,qCAAqC;KAC9D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,MAAiB,EACjB,SAAiB,EACjB,aAAqB,EACrB,MAAuC,EACvC,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,oBAAoB,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CACT,GAAG,EACH,MAAM,EACN,gCAAgC,EAChC,qCAAqC,EACrC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,aAAa,EAAE,CAC5B,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,sCAAsC;KAC/D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,MAAiB,EACjB,SAAiB,EACjB,aAAqB,EACrB,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,oBAAoB,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,MAAM,CACZ,GAAG,EACH,sCAAsC,EACtC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,aAAa,EAAE,CAC5B,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;IACR,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,sCAAsC;KAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/api/webhook/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module webhook
+ *
+ * Webhook API client for managing webhooks, destinations, receipts, and deliveries.
+ *
+ * This module provides a complete client for the Agentuity Webhook API, supporting:
+ * - **Webhook Management**: Create, read, update, and delete webhooks
+ * - **Destinations**: Configure URL endpoints for webhook payload forwarding
+ * - **Receipts**: View incoming webhook payloads that were received
+ * - **Deliveries**: Track delivery attempts and retry failed deliveries
+ *
+ * @example Basic Webhook Operations
+ * ```typescript
+ * import { createWebhook, createWebhookDestination, listWebhookReceipts } from '@agentuity/server';
+ *
+ * // Create a webhook
+ * const webhook = await createWebhook(client, {
+ *   name: 'github-events',
+ *   description: 'Receives GitHub webhook events',
+ * });
+ *
+ * // Add a destination
+ * await createWebhookDestination(client, webhook.id, {
+ *   type: 'url',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * });
+ *
+ * // List receipts
+ * const { receipts } = await listWebhookReceipts(client, webhook.id);
+ * for (const receipt of receipts) {
+ *   console.log(`Received: ${receipt.id} at ${receipt.date}`);
+ * }
+ * ```
+ */
+export { type CreateWebhookDestinationRequest, CreateWebhookDestinationRequestSchema, type CreateWebhookRequest, CreateWebhookRequestSchema, type ListWebhookDeliveriesRequest, ListWebhookDeliveriesRequestSchema, type ListWebhookReceiptsRequest, ListWebhookReceiptsRequestSchema, type ListWebhooksRequest, ListWebhooksRequestSchema, type PaginationRequest, PaginationRequestSchema, type UpdateWebhookDestinationRequest, UpdateWebhookDestinationRequestSchema, type UpdateWebhookRequest, UpdateWebhookRequestSchema, type Webhook, type WebhookApiOptions, type WebhookDelivery, WebhookDeliverySchema, type WebhookDeliveryStatus, WebhookDeliveryStatusSchema, type WebhookDestination, WebhookDestinationSchema, type WebhookDestinationType, WebhookDestinationTypeSchema, type WebhookReceipt, WebhookReceiptSchema, WebhookSchema, } from './types.ts';
+export { WebhookDeliveryNotFoundError, WebhookDestinationNotFoundError, WebhookError, WebhookNotFoundError, WebhookReceiptNotFoundError, } from './util.ts';
+export { createWebhook, DeleteWebhookResponseSchema, deleteWebhook, getWebhook, listWebhooks, WebhookResponseSchema, WebhooksListResponseSchema, updateWebhook, } from './webhooks.ts';
+export { createWebhookDestination, DeleteWebhookDestinationResponseSchema, deleteWebhookDestination, listWebhookDestinations, updateWebhookDestination, WebhookDestinationResponseSchema, WebhookDestinationsListResponseSchema, } from './destinations.ts';
+export { getWebhookReceipt, listWebhookReceipts, WebhookReceiptResponseSchema, WebhookReceiptsListResponseSchema, } from './receipts.ts';
+export { listWebhookDeliveries, retryWebhookDelivery, WebhookDeliveriesListResponseSchema, WebhookDeliveryResponseSchema, } from './deliveries.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/webhook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/webhook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH,OAAO,EACN,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,4BAA4B,EACjC,kCAAkC,EAClC,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,+BAA+B,EACpC,qCAAqC,EACrC,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,OAAO,EACZ,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,cAAc,EACnB,oBAAoB,EACpB,aAAa,GACb,MAAM,YAAY,CAAC;AAMpB,OAAO,EACN,4BAA4B,EAC5B,+BAA+B,EAC/B,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,GAC3B,MAAM,WAAW,CAAC;AAMnB,OAAO,EACN,aAAa,EACb,2BAA2B,EAC3B,aAAa,EACb,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,GACb,MAAM,eAAe,CAAC;AAMvB,OAAO,EACN,wBAAwB,EACxB,sCAAsC,EACtC,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,gCAAgC,EAChC,qCAAqC,GACrC,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,iCAAiC,GACjC,MAAM,eAAe,CAAC;AAMvB,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,6BAA6B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/api/webhook/index.js

@@ -0,0 +1,59 @@
+/**
+ * @module webhook
+ *
+ * Webhook API client for managing webhooks, destinations, receipts, and deliveries.
+ *
+ * This module provides a complete client for the Agentuity Webhook API, supporting:
+ * - **Webhook Management**: Create, read, update, and delete webhooks
+ * - **Destinations**: Configure URL endpoints for webhook payload forwarding
+ * - **Receipts**: View incoming webhook payloads that were received
+ * - **Deliveries**: Track delivery attempts and retry failed deliveries
+ *
+ * @example Basic Webhook Operations
+ * ```typescript
+ * import { createWebhook, createWebhookDestination, listWebhookReceipts } from '@agentuity/server';
+ *
+ * // Create a webhook
+ * const webhook = await createWebhook(client, {
+ *   name: 'github-events',
+ *   description: 'Receives GitHub webhook events',
+ * });
+ *
+ * // Add a destination
+ * await createWebhookDestination(client, webhook.id, {
+ *   type: 'url',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * });
+ *
+ * // List receipts
+ * const { receipts } = await listWebhookReceipts(client, webhook.id);
+ * for (const receipt of receipts) {
+ *   console.log(`Received: ${receipt.id} at ${receipt.date}`);
+ * }
+ * ```
+ */
+// ============================================================================
+// Types & Schemas
+// ============================================================================
+export { CreateWebhookDestinationRequestSchema, CreateWebhookRequestSchema, ListWebhookDeliveriesRequestSchema, ListWebhookReceiptsRequestSchema, ListWebhooksRequestSchema, PaginationRequestSchema, UpdateWebhookDestinationRequestSchema, UpdateWebhookRequestSchema, WebhookDeliverySchema, WebhookDeliveryStatusSchema, WebhookDestinationSchema, WebhookDestinationTypeSchema, WebhookReceiptSchema, WebhookSchema, } from "./types.js";
+// ============================================================================
+// Errors
+// ============================================================================
+export { WebhookDeliveryNotFoundError, WebhookDestinationNotFoundError, WebhookError, WebhookNotFoundError, WebhookReceiptNotFoundError, } from "./util.js";
+// ============================================================================
+// Webhook Operations
+// ============================================================================
+export { createWebhook, DeleteWebhookResponseSchema, deleteWebhook, getWebhook, listWebhooks, WebhookResponseSchema, WebhooksListResponseSchema, updateWebhook, } from "./webhooks.js";
+// ============================================================================
+// Destination Operations
+// ============================================================================
+export { createWebhookDestination, DeleteWebhookDestinationResponseSchema, deleteWebhookDestination, listWebhookDestinations, updateWebhookDestination, WebhookDestinationResponseSchema, WebhookDestinationsListResponseSchema, } from "./destinations.js";
+// ============================================================================
+// Receipt Operations
+// ============================================================================
+export { getWebhookReceipt, listWebhookReceipts, WebhookReceiptResponseSchema, WebhookReceiptsListResponseSchema, } from "./receipts.js";
+// ============================================================================
+// Delivery Operations
+// ============================================================================
+export { listWebhookDeliveries, retryWebhookDelivery, WebhookDeliveriesListResponseSchema, WebhookDeliveryResponseSchema, } from "./deliveries.js";
+//# sourceMappingURL=index.js.map

package/dist/api/webhook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/webhook/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAEN,qCAAqC,EAErC,0BAA0B,EAE1B,kCAAkC,EAElC,gCAAgC,EAEhC,yBAAyB,EAEzB,uBAAuB,EAEvB,qCAAqC,EAErC,0BAA0B,EAI1B,qBAAqB,EAErB,2BAA2B,EAE3B,wBAAwB,EAExB,4BAA4B,EAE5B,oBAAoB,EACpB,aAAa,GACb,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACN,4BAA4B,EAC5B,+BAA+B,EAC/B,YAAY,EACZ,oBAAoB,EACpB,2BAA2B,GAC3B,MAAM,WAAW,CAAC;AAEnB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACN,aAAa,EACb,2BAA2B,EAC3B,aAAa,EACb,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,GACb,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,OAAO,EACN,wBAAwB,EACxB,sCAAsC,EACtC,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,gCAAgC,EAChC,qCAAqC,GACrC,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,EAC5B,iCAAiC,GACjC,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,mCAAmC,EACnC,6BAA6B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/api/webhook/receipts.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type ListWebhookReceiptsRequest, type WebhookApiOptions, type WebhookReceipt } from './types.ts';
+export declare const WebhookReceiptResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        webhook_id: z.ZodString;
+        headers: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        payload: z.ZodUnknown;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const WebhookReceiptsListResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        webhook_id: z.ZodString;
+        headers: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        payload: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "success">;
+/**
+ * List receipts for a webhook with optional pagination.
+ *
+ * Receipts represent incoming webhook payloads that were received.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Optional pagination parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Object containing the list of receipts
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const { receipts } = await listWebhookReceipts(client, 'wh_abc123', { limit: 10 });
+ * for (const receipt of receipts) {
+ *   console.log(`Receipt ${receipt.id}: received at ${receipt.date}`);
+ * }
+ * ```
+ */
+export declare function listWebhookReceipts(client: APIClient, webhookId: string, params?: ListWebhookReceiptsRequest, options?: WebhookApiOptions): Promise<{
+    receipts: WebhookReceipt[];
+}>;
+/**
+ * Get a specific receipt for a webhook.
+ *
+ * Retrieves the full receipt details including headers and payload.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param receiptId - The receipt ID (prefixed with whrc_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The receipt details
+ * @throws {WebhookReceiptNotFoundError} If the receipt does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const receipt = await getWebhookReceipt(client, 'wh_abc123', 'whrc_def456');
+ * console.log(`Receipt payload:`, receipt.payload);
+ * ```
+ */
+export declare function getWebhookReceipt(client: APIClient, webhookId: string, receiptId: string, options?: WebhookApiOptions): Promise<WebhookReceipt>;
+//# sourceMappingURL=receipts.d.ts.map

package/dist/api/webhook/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../../src/api/webhook/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAC9D,OAAO,EACN,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEnB,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;8BAA0C,CAAC;AACpF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;8BAAmD,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CA8BzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/api/webhook/receipts.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { WebhookReceiptSchema, } from "./types.js";
+import { buildWebhookHeaders, WebhookError, webhookApiPath, webhookApiPathWithQuery, withWebhookErrorHandling, } from "./util.js";
+export const WebhookReceiptResponseSchema = APIResponseSchema(WebhookReceiptSchema);
+export const WebhookReceiptsListResponseSchema = APIResponseSchema(z.array(WebhookReceiptSchema));
+/**
+ * List receipts for a webhook with optional pagination.
+ *
+ * Receipts represent incoming webhook payloads that were received.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Optional pagination parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Object containing the list of receipts
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const { receipts } = await listWebhookReceipts(client, 'wh_abc123', { limit: 10 });
+ * for (const receipt of receipts) {
+ *   console.log(`Receipt ${receipt.id}: received at ${receipt.date}`);
+ * }
+ * ```
+ */
+export async function listWebhookReceipts(client, webhookId, params, options) {
+    const searchParams = new URLSearchParams();
+    if (params?.limit !== undefined) {
+        searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset !== undefined) {
+        searchParams.set('offset', String(params.offset));
+    }
+    const queryString = searchParams.toString();
+    const url = webhookApiPathWithQuery('receipt-list', queryString || undefined, webhookId);
+    const resp = await withWebhookErrorHandling(() => client.get(url, WebhookReceiptsListResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
+    if (resp.success) {
+        return { receipts: resp.data };
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to list webhook receipts',
+    });
+}
+/**
+ * Get a specific receipt for a webhook.
+ *
+ * Retrieves the full receipt details including headers and payload.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param receiptId - The receipt ID (prefixed with whrc_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The receipt details
+ * @throws {WebhookReceiptNotFoundError} If the receipt does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const receipt = await getWebhookReceipt(client, 'wh_abc123', 'whrc_def456');
+ * console.log(`Receipt payload:`, receipt.payload);
+ * ```
+ */
+export async function getWebhookReceipt(client, webhookId, receiptId, options) {
+    const url = webhookApiPath('receipt-get', webhookId, receiptId);
+    const resp = await withWebhookErrorHandling(() => client.get(url, WebhookReceiptResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId, receiptId });
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to get webhook receipt',
+    });
+}
+//# sourceMappingURL=receipts.js.map

package/dist/api/webhook/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../../../src/api/webhook/receipts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAIN,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,4BAA4B,GAAG,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,iCAAiC,GAAG,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAElG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAiB,EACjB,SAAiB,EACjB,MAAmC,EACnC,OAA2B;IAE3B,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,uBAAuB,CAAC,cAAc,EAAE,WAAW,IAAI,SAAS,EAAE,SAAS,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CACT,GAAG,EACH,iCAAiC,EACjC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,CACb,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,iCAAiC;KAC1D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,MAAiB,EACjB,SAAiB,EACjB,SAAiB,EACjB,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CACT,GAAG,EACH,4BAA4B,EAC5B,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,SAAS,EAAE,CACxB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,+BAA+B;KACxD,CAAC,CAAC;AACJ,CAAC"}

package/dist/api/webhook/types.d.ts

@@ -0,0 +1,249 @@
+import { z } from 'zod';
+/**
+ * Webhook destination type schema.
+ *
+ * Currently only 'url' destinations are supported.
+ *
+ * @example
+ * ```typescript
+ * const destType = WebhookDestinationTypeSchema.parse('url');
+ * ```
+ */
+export declare const WebhookDestinationTypeSchema: z.ZodEnum<{
+    url: "url";
+}>;
+/**
+ * Webhook destination type.
+ */
+export type WebhookDestinationType = z.infer<typeof WebhookDestinationTypeSchema>;
+/**
+ * Webhook delivery status schema.
+ *
+ * - `pending`: Delivery is queued and waiting to be sent.
+ * - `success`: Delivery was completed successfully.
+ * - `failed`: Delivery failed after all retry attempts.
+ *
+ * @example
+ * ```typescript
+ * const status = WebhookDeliveryStatusSchema.parse('success');
+ * ```
+ */
+export declare const WebhookDeliveryStatusSchema: z.ZodEnum<{
+    success: "success";
+    pending: "pending";
+    failed: "failed";
+}>;
+/**
+ * Webhook delivery status type.
+ */
+export type WebhookDeliveryStatus = z.infer<typeof WebhookDeliveryStatusSchema>;
+/**
+ * Webhook schema representing a webhook endpoint.
+ *
+ * @example
+ * ```typescript
+ * const webhook = await getWebhook(client, 'wh_abc123');
+ * console.log(`Webhook: ${webhook.name} (${webhook.id})`);
+ * ```
+ */
+export declare const WebhookSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Webhook type.
+ */
+export type Webhook = z.infer<typeof WebhookSchema>;
+/**
+ * Webhook destination schema representing a delivery target for webhook events.
+ *
+ * Destinations define where incoming webhook payloads are forwarded to.
+ *
+ * @example
+ * ```typescript
+ * const destinations = await listWebhookDestinations(client, 'wh_abc123');
+ * for (const dest of destinations) {
+ *   console.log(`Destination ${dest.id}: type=${dest.type}`);
+ * }
+ * ```
+ */
+export declare const WebhookDestinationSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    webhook_id: z.ZodString;
+    type: z.ZodEnum<{
+        url: "url";
+    }>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * Webhook destination type.
+ */
+export type WebhookDestination = z.infer<typeof WebhookDestinationSchema>;
+/**
+ * Webhook receipt schema representing an incoming webhook payload that was received.
+ *
+ * Receipts capture the raw payload and headers of each incoming webhook request.
+ *
+ * @example
+ * ```typescript
+ * const receipt = await getWebhookReceipt(client, 'wh_abc123', 'whrc_def456');
+ * console.log(`Receipt ${receipt.id}: received at ${receipt.date}`);
+ * ```
+ */
+export declare const WebhookReceiptSchema: z.ZodObject<{
+    id: z.ZodString;
+    date: z.ZodString;
+    webhook_id: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Webhook receipt type.
+ */
+export type WebhookReceipt = z.infer<typeof WebhookReceiptSchema>;
+/**
+ * Webhook delivery schema representing a delivery attempt to a destination.
+ *
+ * Deliveries track the status and result of forwarding a received webhook
+ * payload to a configured destination.
+ *
+ * @example
+ * ```typescript
+ * const deliveries = await listWebhookDeliveries(client, 'wh_abc123');
+ * for (const delivery of deliveries) {
+ *   console.log(`Delivery ${delivery.id}: ${delivery.status}`);
+ * }
+ * ```
+ */
+export declare const WebhookDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    date: z.ZodString;
+    webhook_id: z.ZodString;
+    webhook_destination_id: z.ZodString;
+    webhook_receipt_id: z.ZodString;
+    status: z.ZodEnum<{
+        success: "success";
+        pending: "pending";
+        failed: "failed";
+    }>;
+    retries: z.ZodNumber;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    response: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+/**
+ * Webhook delivery type.
+ */
+export type WebhookDelivery = z.infer<typeof WebhookDeliverySchema>;
+/**
+ * Common options for webhook API calls.
+ *
+ * Used to pass organization context when calling from CLI or other
+ * contexts where the org is not implicit in the authentication token.
+ */
+export interface WebhookApiOptions {
+    /**
+     * Organization ID for the request.
+     * Required when using user authentication (CLI) instead of SDK key.
+     */
+    orgId?: string;
+}
+/**
+ * Request schema for creating a new webhook.
+ *
+ * @example
+ * ```typescript
+ * const request: CreateWebhookRequest = {
+ *   name: 'github-events',
+ *   description: 'Receives GitHub webhook events',
+ * };
+ * ```
+ */
+export declare const CreateWebhookRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Request type for creating a webhook. */
+export type CreateWebhookRequest = z.infer<typeof CreateWebhookRequestSchema>;
+/**
+ * Request schema for updating an existing webhook.
+ *
+ * @example
+ * ```typescript
+ * const request: UpdateWebhookRequest = {
+ *   name: 'github-events-v2',
+ *   description: 'Updated description',
+ * };
+ * ```
+ */
+export declare const UpdateWebhookRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Request type for updating a webhook. */
+export type UpdateWebhookRequest = z.infer<typeof UpdateWebhookRequestSchema>;
+/**
+ * Request schema for creating a webhook destination.
+ *
+ * @example
+ * ```typescript
+ * const request: CreateWebhookDestinationRequest = {
+ *   type: 'url',
+ *   config: { url: 'https://api.example.com/webhook' },
+ * };
+ * ```
+ */
+export declare const CreateWebhookDestinationRequestSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        url: "url";
+    }>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/** Request type for creating a webhook destination. */
+export type CreateWebhookDestinationRequest = z.infer<typeof CreateWebhookDestinationRequestSchema>;
+/**
+ * Request schema for updating a webhook destination.
+ *
+ * @example
+ * ```typescript
+ * const request: UpdateWebhookDestinationRequest = {
+ *   config: { url: 'https://api.example.com/webhook/v2' },
+ * };
+ * ```
+ */
+export declare const UpdateWebhookDestinationRequestSchema: z.ZodObject<{
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** Request type for updating a webhook destination. */
+export type UpdateWebhookDestinationRequest = z.infer<typeof UpdateWebhookDestinationRequestSchema>;
+export declare const PaginationRequestSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PaginationRequest = z.infer<typeof PaginationRequestSchema>;
+export declare const ListWebhooksRequestSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Request type for listing webhooks. */
+export type ListWebhooksRequest = z.infer<typeof ListWebhooksRequestSchema>;
+export declare const ListWebhookReceiptsRequestSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Request type for listing webhook receipts. */
+export type ListWebhookReceiptsRequest = z.infer<typeof ListWebhookReceiptsRequestSchema>;
+export declare const ListWebhookDeliveriesRequestSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Request type for listing webhook deliveries. */
+export type ListWebhookDeliveriesRequest = z.infer<typeof ListWebhookDeliveriesRequestSchema>;
+//# sourceMappingURL=types.d.ts.map