@agentuity/core 1.0.33 → 1.0.34

package/dist/services/queue/destinations.d.ts

@@ -0,0 +1,269 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type CreateDestinationRequest, type DeliveryLog, type Destination, type ListDeliveryLogsRequest, type QueueApiOptions, type UpdateDestinationRequest } from './types.ts';
+export declare const DestinationResponseSchema: 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<{
+        destination: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            queue_id: z.ZodString;
+            destination_type: z.ZodEnum<{
+                http: "http";
+            }>;
+            config: z.ZodObject<{
+                url: z.ZodString;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                method: z.ZodDefault<z.ZodString>;
+                timeout_ms: z.ZodDefault<z.ZodNumber>;
+                retry_policy: z.ZodOptional<z.ZodObject<{
+                    max_attempts: z.ZodDefault<z.ZodNumber>;
+                    initial_backoff_ms: z.ZodDefault<z.ZodNumber>;
+                    max_backoff_ms: z.ZodDefault<z.ZodNumber>;
+                    backoff_multiplier: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strip>>;
+                signing: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    secret_key: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            enabled: z.ZodBoolean;
+            stats: z.ZodOptional<z.ZodObject<{
+                total_deliveries: z.ZodNumber;
+                successful_deliveries: z.ZodNumber;
+                failed_deliveries: z.ZodNumber;
+                last_delivery_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            success_count: z.ZodOptional<z.ZodNumber>;
+            failure_count: z.ZodOptional<z.ZodNumber>;
+            last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const DestinationsListResponseSchema: 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<{
+        destinations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            queue_id: z.ZodString;
+            destination_type: z.ZodEnum<{
+                http: "http";
+            }>;
+            config: z.ZodObject<{
+                url: z.ZodString;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                method: z.ZodDefault<z.ZodString>;
+                timeout_ms: z.ZodDefault<z.ZodNumber>;
+                retry_policy: z.ZodOptional<z.ZodObject<{
+                    max_attempts: z.ZodDefault<z.ZodNumber>;
+                    initial_backoff_ms: z.ZodDefault<z.ZodNumber>;
+                    max_backoff_ms: z.ZodDefault<z.ZodNumber>;
+                    backoff_multiplier: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strip>>;
+                signing: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    secret_key: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            enabled: z.ZodBoolean;
+            stats: z.ZodOptional<z.ZodObject<{
+                total_deliveries: z.ZodNumber;
+                successful_deliveries: z.ZodNumber;
+                failed_deliveries: z.ZodNumber;
+                last_delivery_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            success_count: z.ZodOptional<z.ZodNumber>;
+            failure_count: z.ZodOptional<z.ZodNumber>;
+            last_success_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_failure_error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const DeleteDestinationResponseSchema: 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 queue.
+ *
+ * Destinations are webhook endpoints that automatically receive messages when
+ * they are published to a queue. When a message is published, it will be
+ * delivered via HTTP POST to all active destinations configured for that queue.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue to add the destination to
+ * @param params - Destination configuration including URL and optional settings
+ * @returns The created destination with assigned ID
+ * @throws {QueueValidationError} If validation fails (invalid queue name or config)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destination = await createDestination(client, 'order-events', {
+ *   url: 'https://api.example.com/webhooks/orders',
+ *   config: {
+ *     retry_attempts: 3,
+ *     timeout_seconds: 30,
+ *   },
+ * });
+ * console.log(`Created destination ${destination.id}`);
+ * ```
+ */
+export declare function createDestination(client: APIClient, queueName: string, params: CreateDestinationRequest, options?: QueueApiOptions): Promise<Destination>;
+/**
+ * List all destinations for a queue.
+ *
+ * Retrieves all webhook destinations configured for a queue. Each destination
+ * represents an endpoint that receives messages when they are published.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @returns Array of destinations configured for the queue
+ * @throws {QueueValidationError} If validation fails (invalid queue name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destinations = await listDestinations(client, 'order-events');
+ * for (const dest of destinations) {
+ *   console.log(`Destination ${dest.id}: ${dest.url} (${dest.enabled ? 'enabled' : 'disabled'})`);
+ * }
+ * ```
+ */
+export declare function listDestinations(client: APIClient, queueName: string, options?: QueueApiOptions): Promise<Destination[]>;
+/**
+ * Update a destination's configuration.
+ *
+ * Modifies an existing destination's settings such as URL, enabled status,
+ * or retry configuration. Only the fields provided in params will be updated.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID to update (prefixed with qdest_)
+ * @param params - Fields to update (partial update supported)
+ * @returns The updated destination
+ * @throws {QueueValidationError} If validation fails (invalid queue name, destination ID, or config)
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Disable a destination temporarily
+ * const updated = await updateDestination(client, 'order-events', 'qdest_abc123', {
+ *   enabled: false,
+ * });
+ *
+ * // Update URL and retry settings
+ * const updated = await updateDestination(client, 'order-events', 'qdest_abc123', {
+ *   url: 'https://api.example.com/v2/webhooks/orders',
+ *   config: {
+ *     retry_attempts: 5,
+ *   },
+ * });
+ * ```
+ */
+export declare function updateDestination(client: APIClient, queueName: string, destinationId: string, params: UpdateDestinationRequest, options?: QueueApiOptions): Promise<Destination>;
+/**
+ * Delete a destination from a queue.
+ *
+ * Permanently removes a webhook destination. Messages will no longer be
+ * delivered to this endpoint. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID to delete (prefixed with qdest_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or destination ID)
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteDestination(client, 'order-events', 'qdest_abc123');
+ * console.log('Destination deleted');
+ * ```
+ */
+export declare function deleteDestination(client: APIClient, queueName: string, destinationId: string, options?: QueueApiOptions): Promise<void>;
+export declare const DeliveryLogsListResponseSchema: 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<{
+        deliveries: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            destination_id: z.ZodString;
+            queue_id: z.ZodString;
+            message_id: z.ZodString;
+            payload: z.ZodOptional<z.ZodUnknown>;
+            status: z.ZodEnum<{
+                success: "success";
+                pending: "pending";
+                failed: "failed";
+            }>;
+            http_status_code: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            duration_ms: z.ZodOptional<z.ZodNumber>;
+            attempt_number: z.ZodOptional<z.ZodNumber>;
+            request_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            response_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            delivered_at: z.ZodString;
+            created_at: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+/**
+ * List delivery attempts for a queue destination.
+ *
+ * Returns the most recent delivery attempts to a configured webhook destination,
+ * including HTTP status codes, timing, and error details for failed deliveries.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID (prefixed with qdest_)
+ * @param params - Optional filtering and pagination
+ * @returns Array of delivery log entries
+ * @throws {QueueValidationError} If validation fails
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const deliveries = await listDestinationDeliveries(client, 'order-events', 'qdest_abc123', {
+ *   limit: 50,
+ *   status: 'failed',
+ * });
+ * ```
+ */
+export declare function listDestinationDeliveries(client: APIClient, queueName: string, destinationId: string, params?: ListDeliveryLogsRequest, options?: QueueApiOptions): Promise<DeliveryLog[]>;
+//# sourceMappingURL=destinations.d.ts.map

package/dist/services/queue/destinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.d.ts","sourceRoot":"","sources":["../../../src/services/queue/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,wBAAwB,EAE7B,KAAK,WAAW,EAEhB,KAAK,WAAW,EAEhB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAE7B,MAAM,YAAY,CAAC;AAQpB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAErC,CAAC;AACF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAI1C,CAAC;AACF,eAAO,MAAM,+BAA+B;;;;;;8BAA4B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CA4BtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CAsBxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CA6BtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAI1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,yBAAyB,CAC9C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BxB"}

package/dist/services/queue/destinations.js

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from "../api.js";
+import { CreateDestinationRequestSchema, DeliveryLogSchema, DestinationSchema, UpdateDestinationRequestSchema, } from "./types.js";
+import { buildQueueHeaders, QueueError, queueApiPath, withQueueErrorHandling } from "./util.js";
+import { validateDestinationConfig, validateDestinationId, validateQueueName, } from "./validation.js";
+export const DestinationResponseSchema = APIResponseSchema(z.object({ destination: DestinationSchema }));
+export const DestinationsListResponseSchema = APIResponseSchema(z.object({
+    destinations: z.array(DestinationSchema),
+}));
+export const DeleteDestinationResponseSchema = APIResponseSchemaNoData();
+/**
+ * Create a destination for a queue.
+ *
+ * Destinations are webhook endpoints that automatically receive messages when
+ * they are published to a queue. When a message is published, it will be
+ * delivered via HTTP POST to all active destinations configured for that queue.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue to add the destination to
+ * @param params - Destination configuration including URL and optional settings
+ * @returns The created destination with assigned ID
+ * @throws {QueueValidationError} If validation fails (invalid queue name or config)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destination = await createDestination(client, 'order-events', {
+ *   url: 'https://api.example.com/webhooks/orders',
+ *   config: {
+ *     retry_attempts: 3,
+ *     timeout_seconds: 30,
+ *   },
+ * });
+ * console.log(`Created destination ${destination.id}`);
+ * ```
+ */
+export async function createDestination(client, queueName, params, options) {
+    validateQueueName(queueName);
+    if (params.config) {
+        validateDestinationConfig(params.config);
+    }
+    const url = queueApiPath('destinations/create', queueName);
+    const resp = await withQueueErrorHandling(() => client.post(url, params, DestinationResponseSchema, CreateDestinationRequestSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName, destinationUrl: params.config?.url });
+    if (resp.success) {
+        return resp.data.destination;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to create destination',
+    });
+}
+/**
+ * List all destinations for a queue.
+ *
+ * Retrieves all webhook destinations configured for a queue. Each destination
+ * represents an endpoint that receives messages when they are published.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @returns Array of destinations configured for the queue
+ * @throws {QueueValidationError} If validation fails (invalid queue name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const destinations = await listDestinations(client, 'order-events');
+ * for (const dest of destinations) {
+ *   console.log(`Destination ${dest.id}: ${dest.url} (${dest.enabled ? 'enabled' : 'disabled'})`);
+ * }
+ * ```
+ */
+export async function listDestinations(client, queueName, options) {
+    validateQueueName(queueName);
+    const url = queueApiPath('destinations/list', queueName);
+    const resp = await withQueueErrorHandling(() => client.get(url, DestinationsListResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName });
+    if (resp.success) {
+        return resp.data.destinations;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to list destinations',
+    });
+}
+/**
+ * Update a destination's configuration.
+ *
+ * Modifies an existing destination's settings such as URL, enabled status,
+ * or retry configuration. Only the fields provided in params will be updated.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID to update (prefixed with qdest_)
+ * @param params - Fields to update (partial update supported)
+ * @returns The updated destination
+ * @throws {QueueValidationError} If validation fails (invalid queue name, destination ID, or config)
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Disable a destination temporarily
+ * const updated = await updateDestination(client, 'order-events', 'qdest_abc123', {
+ *   enabled: false,
+ * });
+ *
+ * // Update URL and retry settings
+ * const updated = await updateDestination(client, 'order-events', 'qdest_abc123', {
+ *   url: 'https://api.example.com/v2/webhooks/orders',
+ *   config: {
+ *     retry_attempts: 5,
+ *   },
+ * });
+ * ```
+ */
+export async function updateDestination(client, queueName, destinationId, params, options) {
+    validateQueueName(queueName);
+    validateDestinationId(destinationId);
+    if (params.config) {
+        validateDestinationConfig(params.config);
+    }
+    const url = queueApiPath('destinations/update', queueName, destinationId);
+    const resp = await withQueueErrorHandling(() => client.patch(url, params, DestinationResponseSchema, UpdateDestinationRequestSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName, destinationId });
+    if (resp.success) {
+        return resp.data.destination;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to update destination',
+    });
+}
+/**
+ * Delete a destination from a queue.
+ *
+ * Permanently removes a webhook destination. Messages will no longer be
+ * delivered to this endpoint. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID to delete (prefixed with qdest_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or destination ID)
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteDestination(client, 'order-events', 'qdest_abc123');
+ * console.log('Destination deleted');
+ * ```
+ */
+export async function deleteDestination(client, queueName, destinationId, options) {
+    validateQueueName(queueName);
+    validateDestinationId(destinationId);
+    const url = queueApiPath('destinations/delete', queueName, destinationId);
+    const resp = await withQueueErrorHandling(() => client.delete(url, DeleteDestinationResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName, destinationId });
+    if (resp.success) {
+        return;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to delete destination',
+    });
+}
+export const DeliveryLogsListResponseSchema = APIResponseSchema(z.object({
+    deliveries: z.array(DeliveryLogSchema),
+}));
+/**
+ * List delivery attempts for a queue destination.
+ *
+ * Returns the most recent delivery attempts to a configured webhook destination,
+ * including HTTP status codes, timing, and error details for failed deliveries.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param destinationId - The destination ID (prefixed with qdest_)
+ * @param params - Optional filtering and pagination
+ * @returns Array of delivery log entries
+ * @throws {QueueValidationError} If validation fails
+ * @throws {DestinationNotFoundError} If the destination does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const deliveries = await listDestinationDeliveries(client, 'order-events', 'qdest_abc123', {
+ *   limit: 50,
+ *   status: 'failed',
+ * });
+ * ```
+ */
+export async function listDestinationDeliveries(client, queueName, destinationId, params, options) {
+    validateQueueName(queueName);
+    validateDestinationId(destinationId);
+    const queryParts = [];
+    if (params?.limit !== undefined)
+        queryParts.push(`limit=${params.limit}`);
+    if (params?.offset !== undefined)
+        queryParts.push(`offset=${params.offset}`);
+    if (params?.status)
+        queryParts.push(`status=${params.status}`);
+    const queryString = queryParts.length > 0 ? `?${queryParts.join('&')}` : '';
+    const url = queueApiPath('destinations/deliveries', queueName, destinationId) + queryString;
+    const resp = await withQueueErrorHandling(() => client.get(url, DeliveryLogsListResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName, destinationId });
+    if (resp.success) {
+        return resp.data.deliveries;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to list destination deliveries',
+    });
+}
+//# sourceMappingURL=destinations.js.map

package/dist/services/queue/destinations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destinations.js","sourceRoot":"","sources":["../../../src/services/queue/destinations.ts"],"names":[],"mappings":"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"}

package/dist/services/queue/dlq.d.ts

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type DeadLetterMessage, type ListDlqRequest, type Message, type QueueApiOptions } from './types.ts';
+export declare const DlqListResponseSchema: 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<{
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            queue_id: z.ZodString;
+            original_message_id: z.ZodOptional<z.ZodString>;
+            offset: z.ZodNumber;
+            payload: z.ZodUnknown;
+            metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            failure_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            delivery_attempts: z.ZodNumber;
+            moved_at: z.ZodOptional<z.ZodString>;
+            original_published_at: z.ZodOptional<z.ZodString>;
+            published_at: z.ZodOptional<z.ZodString>;
+            created_at: z.ZodString;
+        }, z.core.$strip>>;
+        total: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const ReplayDlqResponseSchema: 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<{
+        message: z.ZodObject<{
+            id: z.ZodString;
+            queue_id: z.ZodString;
+            offset: z.ZodNumber;
+            payload: z.ZodUnknown;
+            size: z.ZodOptional<z.ZodNumber>;
+            metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            state: z.ZodOptional<z.ZodEnum<{
+                pending: "pending";
+                failed: "failed";
+                leased: "leased";
+                processing: "processing";
+                delivered: "delivered";
+                dead: "dead";
+            }>>;
+            idempotency_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            partition_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            ttl_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            delivery_attempts: z.ZodOptional<z.ZodNumber>;
+            max_retries: z.ZodOptional<z.ZodNumber>;
+            published_at: z.ZodOptional<z.ZodString>;
+            expires_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            acknowledged_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodOptional<z.ZodString>;
+            updated_at: z.ZodOptional<z.ZodString>;
+            source_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            source_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const DeleteDlqResponseSchema: 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">;
+/**
+ * List messages in the dead letter queue.
+ *
+ * Retrieves messages that failed processing after exhausting all retries.
+ * These messages can be inspected, replayed back to the main queue, or deleted.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue whose DLQ to list
+ * @param params - Optional pagination parameters (limit, offset)
+ * @returns Object containing dead letter messages and optional total count
+ * @throws {QueueValidationError} If validation fails (invalid queue name, limit, or offset)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // List first 10 dead letter messages
+ * const result = await listDeadLetterMessages(client, 'order-queue', { limit: 10 });
+ * for (const msg of result.messages) {
+ *   console.log(`Failed message ${msg.id}: ${msg.failure_reason}`);
+ *   console.log(`Attempts: ${msg.delivery_attempts}, Moved at: ${msg.moved_at}`);
+ * }
+ * ```
+ */
+export declare function listDeadLetterMessages(client: APIClient, queueName: string, params?: ListDlqRequest, options?: QueueApiOptions): Promise<{
+    messages: DeadLetterMessage[];
+    total?: number;
+}>;
+/**
+ * Replay a dead letter message back to the main queue.
+ *
+ * Moves a message from the dead letter queue back to the main queue for
+ * reprocessing. The message state is reset to pending and retry count is
+ * preserved. Use this after fixing the underlying issue that caused the failure.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param messageId - The message ID to replay (prefixed with msg_)
+ * @returns The replayed message with updated state
+ * @throws {QueueValidationError} If validation fails (invalid queue name or message ID)
+ * @throws {MessageNotFoundError} If the message does not exist in the DLQ
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Replay a failed message after fixing the bug
+ * const message = await replayDeadLetterMessage(client, 'order-queue', 'msg_abc123');
+ * console.log(`Replayed message ${message.id}, now in state: ${message.state}`);
+ * ```
+ */
+export declare function replayDeadLetterMessage(client: APIClient, queueName: string, messageId: string, options?: QueueApiOptions): Promise<Message>;
+/**
+ * Purge all messages from a dead letter queue.
+ *
+ * Permanently deletes all messages in the dead letter queue. This operation
+ * cannot be undone. Use with caution - consider reviewing or exporting
+ * messages before purging.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue whose DLQ to purge
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Purge all dead letter messages after investigation
+ * await purgeDeadLetter(client, 'order-queue');
+ * console.log('All dead letter messages have been deleted');
+ * ```
+ */
+export declare function purgeDeadLetter(client: APIClient, queueName: string, options?: QueueApiOptions): Promise<void>;
+/**
+ * Delete a specific message from the dead letter queue.
+ *
+ * Permanently removes a single message from the dead letter queue.
+ * Use this when you've determined that a specific failed message
+ * should not be retried and can be discarded.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param messageId - The message ID to delete (prefixed with msg_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or message ID)
+ * @throws {MessageNotFoundError} If the message does not exist in the DLQ
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Delete a message that cannot be recovered
+ * await deleteDeadLetterMessage(client, 'order-queue', 'msg_abc123');
+ * console.log('Dead letter message deleted');
+ * ```
+ */
+export declare function deleteDeadLetterMessage(client: APIClient, queueName: string, messageId: string, options?: QueueApiOptions): Promise<void>;
+//# sourceMappingURL=dlq.d.ts.map

package/dist/services/queue/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../../src/services/queue/dlq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,cAAc,EACnB,KAAK,OAAO,EAEZ,KAAK,eAAe,EACpB,MAAM,YAAY,CAAC;AAepB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;8BAKjC,CAAC;AACF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAA0D,CAAC;AAC/F,eAAO,MAAM,uBAAuB;;;;;;8BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC5D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAmBf"}