@agentuity/core 1.0.32 → 1.0.34

package/dist/services/queue/analytics.js

@@ -0,0 +1,254 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { OrgAnalyticsSchema, QueueAnalyticsSchema, SSEStatsEventSchema, TimeSeriesDataSchema, } from "./types.js";
+import { buildQueueHeaders, QueueError, QueueNotFoundError, queueApiPathWithQuery, withQueueErrorHandling, } from "./util.js";
+import { validateQueueName } from "./validation.js";
+export const OrgAnalyticsResponseSchema = APIResponseSchema(z.object({ analytics: OrgAnalyticsSchema }));
+export const QueueAnalyticsResponseSchema = APIResponseSchema(z.object({ analytics: QueueAnalyticsSchema }));
+export const TimeSeriesResponseSchema = APIResponseSchema(z.object({ timeseries: TimeSeriesDataSchema }));
+/**
+ * Build query string from analytics options.
+ */
+function buildAnalyticsQuery(options) {
+    if (!options)
+        return undefined;
+    const params = new URLSearchParams();
+    if (options.start)
+        params.set('start', options.start);
+    if (options.end)
+        params.set('end', options.end);
+    if (options.granularity)
+        params.set('granularity', options.granularity);
+    if (options.projectId)
+        params.set('project_id', options.projectId);
+    if (options.agentId)
+        params.set('agent_id', options.agentId);
+    const query = params.toString();
+    return query || undefined;
+}
+/**
+ * Get org-level analytics for all queues.
+ *
+ * Returns aggregated statistics across all queues in the organization.
+ *
+ * @param client - The API client instance
+ * @param options - Analytics options (time range, filters)
+ * @returns Org-level analytics summary
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const analytics = await getOrgAnalytics(client, {
+ *   start: '2026-01-14T00:00:00Z',
+ *   end: '2026-01-15T00:00:00Z',
+ * });
+ * console.log(`Total queues: ${analytics.summary.total_queues}`);
+ * console.log(`Messages published: ${analytics.summary.total_messages_published}`);
+ * ```
+ */
+export async function getOrgAnalytics(client, options) {
+    const queryString = buildAnalyticsQuery(options);
+    const url = queueApiPathWithQuery('analytics/org', queryString);
+    const resp = await client.get(url, OrgAnalyticsResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.analytics;
+    }
+    throw new QueueError({
+        message: resp.message || 'Failed to get org analytics',
+    });
+}
+/**
+ * Get org-level time series analytics.
+ *
+ * Returns published and delivery metrics aggregated across all queues.
+ *
+ * @param client - The API client instance
+ * @param options - Analytics options (time range, filters)
+ * @returns Time series analytics data for the org
+ * @throws {QueueError} If the API request fails
+ */
+export async function getOrgTimeSeries(client, options) {
+    const queryString = buildAnalyticsQuery(options);
+    const url = queueApiPathWithQuery('analytics/org/timeseries', queryString);
+    const resp = await client.get(url, TimeSeriesResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.timeseries;
+    }
+    throw new QueueError({
+        message: resp.message || 'Failed to get org time series',
+    });
+}
+/**
+ * Get detailed analytics for a specific queue.
+ *
+ * Returns current state, period statistics, latency metrics, and destination stats.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Analytics options (time range, filters)
+ * @returns Queue analytics
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const analytics = await getQueueAnalytics(client, 'order-processing', {
+ *   start: '2026-01-14T00:00:00Z',
+ * });
+ * console.log(`Backlog: ${analytics.current.backlog}`);
+ * console.log(`P95 latency: ${analytics.latency.p95_ms}ms`);
+ * ```
+ */
+export async function getQueueAnalytics(client, name, options) {
+    validateQueueName(name);
+    const queryString = buildAnalyticsQuery(options);
+    const url = queueApiPathWithQuery('analytics/queue', queryString, name);
+    const resp = await withQueueErrorHandling(() => client.get(url, QueueAnalyticsResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName: name });
+    if (resp.success) {
+        return resp.data.analytics;
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to get queue analytics',
+    });
+}
+/**
+ * Get time series analytics data for a queue.
+ *
+ * Returns time-bucketed metrics for visualization in charts and graphs.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Analytics options (time range, granularity)
+ * @returns Time series data
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const timeseries = await getQueueTimeSeries(client, 'order-processing', {
+ *   granularity: 'hour',
+ *   start: '2026-01-14T00:00:00Z',
+ * });
+ * for (const point of timeseries.series) {
+ *   console.log(`${point.timestamp}: ${point.throughput} msg/h`);
+ * }
+ * ```
+ */
+export async function getQueueTimeSeries(client, name, options) {
+    validateQueueName(name);
+    const queryString = buildAnalyticsQuery(options);
+    const url = queueApiPathWithQuery('analytics/timeseries', queryString, name);
+    const resp = await withQueueErrorHandling(() => client.get(url, TimeSeriesResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName: name });
+    if (resp.success) {
+        return resp.data.timeseries;
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to get queue time series',
+    });
+}
+/**
+ * Stream real-time analytics for all queues via SSE.
+ *
+ * Returns an async iterator that yields stats events at the specified interval.
+ * The connection stays open until the iterator is closed or an error occurs.
+ *
+ * @param client - The API client instance
+ * @param options - Stream options (interval, orgId)
+ * @returns Async iterator of SSE stats events
+ *
+ * @example
+ * ```typescript
+ * const stream = streamOrgAnalytics(client, { interval: 5 });
+ * for await (const event of stream) {
+ *   console.log(`Backlog: ${event.backlog}, Throughput: ${event.throughput_1m}/min`);
+ * }
+ * ```
+ */
+export async function* streamOrgAnalytics(client, options) {
+    const params = new URLSearchParams();
+    if (options?.interval)
+        params.set('interval', String(options.interval));
+    const queryString = params.toString() || undefined;
+    const url = queueApiPathWithQuery('analytics/stream', queryString);
+    yield* streamSSE(client, url, options?.orgId);
+}
+/**
+ * Stream real-time analytics for a specific queue via SSE.
+ *
+ * Returns an async iterator that yields stats events at the specified interval.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param options - Stream options (interval, orgId)
+ * @returns Async iterator of SSE stats events
+ *
+ * @example
+ * ```typescript
+ * const stream = streamQueueAnalytics(client, 'order-processing', { interval: 5 });
+ * for await (const event of stream) {
+ *   console.log(`Backlog: ${event.backlog}, In-flight: ${event.messages_in_flight}`);
+ * }
+ * ```
+ */
+export async function* streamQueueAnalytics(client, name, options) {
+    validateQueueName(name);
+    const params = new URLSearchParams();
+    if (options?.interval)
+        params.set('interval', String(options.interval));
+    const queryString = params.toString() || undefined;
+    const url = queueApiPathWithQuery('analytics/stream', queryString, name);
+    yield* streamSSE(client, url, options?.orgId, name);
+}
+/**
+ * Internal helper to stream SSE events from a URL.
+ * Uses rawGet for streaming response access.
+ */
+async function* streamSSE(client, url, orgId, queueName) {
+    const response = await client.rawGet(url, undefined, buildQueueHeaders(orgId));
+    if (!response.ok) {
+        if (response.status === 404 && queueName) {
+            throw new QueueNotFoundError({ queueName });
+        }
+        throw new QueueError({
+            message: `SSE connection failed: ${response.status} ${response.statusText}`,
+        });
+    }
+    const reader = response.body?.getReader();
+    if (!reader) {
+        throw new QueueError({ message: 'No response body for SSE stream' });
+    }
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || '';
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    const jsonStr = line.slice(6).trim();
+                    if (jsonStr && jsonStr !== '{}') {
+                        try {
+                            const parsed = JSON.parse(jsonStr);
+                            const event = SSEStatsEventSchema.parse(parsed);
+                            yield event;
+                        }
+                        catch {
+                            // Skip malformed events
+                        }
+                    }
+                }
+            }
+        }
+    }
+    finally {
+        await reader.cancel();
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=analytics.js.map

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

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

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

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type Consumer, type QueueApiOptions } from './types.ts';
+export declare const ConsumersListResponseSchema: 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<{
+        consumers: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            queue_id: z.ZodString;
+            client_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            durable: z.ZodBoolean;
+            ip_address: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            last_offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            connected_at: z.ZodString;
+            disconnected_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$strip>>;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+/**
+ * List consumers for a queue.
+ *
+ * Returns active WebSocket consumers and recently disconnected durable consumers.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param options - Optional API options (e.g., orgId for CLI-authenticated requests)
+ * @returns Array of consumers
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const consumers = await listConsumers(client, 'order-processing');
+ * for (const consumer of consumers) {
+ *   const status = consumer.disconnected_at ? 'disconnected' : 'connected';
+ *   console.log(`Consumer ${consumer.id}: ${status} (durable: ${consumer.durable})`);
+ * }
+ * ```
+ */
+export declare function listConsumers(client: APIClient, queueName: string, options?: QueueApiOptions): Promise<Consumer[]>;
+//# sourceMappingURL=consumers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.d.ts","sourceRoot":"","sources":["../../../src/services/queue/consumers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAkB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAIjF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;8BAKvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiBrB"}

package/dist/services/queue/consumers.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { ConsumerSchema } from "./types.js";
+import { buildQueueHeaders, QueueError, queueApiPath, withQueueErrorHandling } from "./util.js";
+import { validateQueueName } from "./validation.js";
+export const ConsumersListResponseSchema = APIResponseSchema(z.object({
+    consumers: z.array(ConsumerSchema),
+    total: z.number(),
+}));
+/**
+ * List consumers for a queue.
+ *
+ * Returns active WebSocket consumers and recently disconnected durable consumers.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param options - Optional API options (e.g., orgId for CLI-authenticated requests)
+ * @returns Array of consumers
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const consumers = await listConsumers(client, 'order-processing');
+ * for (const consumer of consumers) {
+ *   const status = consumer.disconnected_at ? 'disconnected' : 'connected';
+ *   console.log(`Consumer ${consumer.id}: ${status} (durable: ${consumer.durable})`);
+ * }
+ * ```
+ */
+export async function listConsumers(client, queueName, options) {
+    validateQueueName(queueName);
+    const url = queueApiPath('consumers/list', queueName);
+    const resp = await withQueueErrorHandling(() => client.get(url, ConsumersListResponseSchema, undefined, buildQueueHeaders(options?.orgId)), { queueName });
+    if (resp.success) {
+        return resp.data.consumers;
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to list consumers',
+    });
+}
+//# sourceMappingURL=consumers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.js","sourceRoot":"","sources":["../../../src/services/queue/consumers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAiB,cAAc,EAAwB,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAC3D,CAAC,CAAC,MAAM,CAAC;IACR,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAiB,EACjB,SAAiB,EACjB,OAAyB;IAEzB,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,sBAAsB,CACxC,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,2BAA2B,EAAE,SAAS,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAC3F,EAAE,SAAS,EAAE,CACb,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,MAAM,IAAI,UAAU,CAAC;QACpB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,0BAA0B;KACnD,CAAC,CAAC;AACJ,CAAC"}

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