@agentuity/server 1.0.22 → 1.0.24

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

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type CreateWebhookDestinationRequest, type UpdateWebhookDestinationRequest, type WebhookApiOptions, type WebhookDestination } from './types.ts';
+export declare const WebhookDestinationResponseSchema: 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;
+        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>;
+}, z.core.$strip>], "success">;
+export declare const WebhookDestinationsListResponseSchema: 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;
+        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>>;
+}, z.core.$strip>], "success">;
+export declare const DeleteWebhookDestinationResponseSchema: 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>;
+}, z.core.$strip>], "success">;
+/**
+ * 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 declare function createWebhookDestination(client: APIClient, webhookId: string, params: CreateWebhookDestinationRequest, options?: WebhookApiOptions): Promise<WebhookDestination>;
+/**
+ * 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 declare function listWebhookDestinations(client: APIClient, webhookId: string, options?: WebhookApiOptions): Promise<WebhookDestination[]>;
+/**
+ * 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 declare function updateWebhookDestination(client: APIClient, webhookId: string, destinationId: string, params: UpdateWebhookDestinationRequest, options?: WebhookApiOptions): Promise<WebhookDestination>;
+/**
+ * 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 declare function deleteWebhookDestination(client: APIClient, webhookId: string, destinationId: string, options?: WebhookApiOptions): Promise<void>;
+//# sourceMappingURL=destinations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.d.ts","sourceRoot":"","sources":["../../../src/api/webhook/destinations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,EACN,KAAK,+BAA+B,EAEpC,KAAK,+BAA+B,EAEpC,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,MAAM,YAAY,CAAC;AAQpB,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;8BAA8C,CAAC;AAC5F,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;8BAEjD,CAAC;AACF,eAAO,MAAM,sCAAsC;;;;;;8BAA4B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqB/B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAuB7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

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":"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"}

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"}