@agentuity/server 0.1.16 → 0.1.18

package/dist/api/queue/queues.d.ts

@@ -0,0 +1,153 @@
+import { APIClient } from '../api';
+import { type Queue, type CreateQueueRequest, type UpdateQueueRequest, type ListQueuesRequest, type QueueApiOptions } from './types';
+/**
+ * Create a new message queue.
+ *
+ * Creates a queue with the specified type and settings. The queue name is optional
+ * and will be auto-generated if not provided.
+ *
+ * @param client - The API client instance
+ * @param params - Queue creation parameters
+ * @returns The created queue
+ * @throws {QueueValidationError} If validation fails
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Create a worker queue with custom settings
+ * const queue = await createQueue(client, {
+ *   name: 'order-processing',
+ *   queue_type: 'worker',
+ *   description: 'Processes customer orders',
+ *   settings: {
+ *     default_max_retries: 3,
+ *     default_visibility_timeout_seconds: 60,
+ *   },
+ * });
+ * console.log(`Created queue: ${queue.id}`);
+ * ```
+ */
+export declare function createQueue(client: APIClient, params: CreateQueueRequest, options?: QueueApiOptions): Promise<Queue>;
+/**
+ * Get a queue by name.
+ *
+ * Retrieves the queue details including settings and statistics.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The queue details
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await getQueue(client, 'order-processing');
+ * console.log(`Queue has ${queue.stats?.message_count} messages`);
+ * ```
+ */
+export declare function getQueue(client: APIClient, name: string, options?: QueueApiOptions): Promise<Queue>;
+/**
+ * List all queues with optional pagination.
+ *
+ * @param client - The API client instance
+ * @param params - Optional pagination parameters
+ * @returns Object containing the list of queues and optional total count
+ * @throws {QueueValidationError} If pagination parameters are invalid
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // List first 10 queues
+ * const { queues, total } = await listQueues(client, { limit: 10 });
+ * console.log(`Found ${total} queues`);
+ *
+ * // Paginate through all queues
+ * const { queues: page2 } = await listQueues(client, { limit: 10, offset: 10 });
+ * ```
+ */
+export declare function listQueues(client: APIClient, params?: ListQueuesRequest, options?: QueueApiOptions): Promise<{
+    queues: Queue[];
+    total?: number;
+}>;
+/**
+ * Update an existing queue.
+ *
+ * Updates the queue description and/or settings. Only provided fields are updated.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param params - Update parameters
+ * @returns The updated queue
+ * @throws {QueueValidationError} If validation fails
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await updateQueue(client, 'order-processing', {
+ *   description: 'Updated description',
+ *   settings: { default_max_retries: 5 },
+ * });
+ * ```
+ */
+export declare function updateQueue(client: APIClient, name: string, params: UpdateQueueRequest, options?: QueueApiOptions): Promise<Queue>;
+/**
+ * Delete a queue.
+ *
+ * Permanently deletes a queue and all its messages. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteQueue(client, 'order-processing');
+ * console.log('Queue deleted');
+ * ```
+ */
+export declare function deleteQueue(client: APIClient, name: string, options?: QueueApiOptions): Promise<void>;
+/**
+ * Pause a queue.
+ *
+ * Pauses message processing for the queue. Messages can still be published
+ * but will not be delivered to consumers until the queue is resumed.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The updated queue with paused_at timestamp
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await pauseQueue(client, 'order-processing');
+ * console.log(`Queue paused at: ${queue.paused_at}`);
+ * ```
+ */
+export declare function pauseQueue(client: APIClient, name: string, options?: QueueApiOptions): Promise<Queue>;
+/**
+ * Resume a paused queue.
+ *
+ * Resumes message processing for a paused queue. Consumers will start
+ * receiving messages again.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The updated queue with paused_at cleared
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await resumeQueue(client, 'order-processing');
+ * console.log(`Queue resumed, paused_at: ${queue.paused_at}`); // null
+ * ```
+ */
+export declare function resumeQueue(client: APIClient, name: string, options?: QueueApiOptions): Promise<Queue>;
+//# sourceMappingURL=queues.d.ts.map

package/dist/api/queue/queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../../src/api/queue/queues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA8C,MAAM,QAAQ,CAAC;AAC/E,OAAO,EAEN,KAAK,KAAK,EACV,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGpB,MAAM,SAAS,CAAC;AA6BjB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CA0ChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,QAAQ,CAC7B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CAyBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC9C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CA+ChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CA2BhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CA2BhB"}

package/dist/api/queue/queues.js

@@ -0,0 +1,319 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData } from '../api';
+import { QueueSchema, CreateQueueRequestSchema, UpdateQueueRequestSchema, } from './types';
+import { QueueError, QueueNotFoundError, queueApiPath, queueApiPathWithQuery, buildQueueHeaders, } from './util';
+import { validateQueueName, validateQueueType, validateDescription, validateTTL, validateVisibilityTimeout, validateMaxRetries, validateMaxInFlight, validateLimit, validateOffset, } from './validation';
+const QueueResponseSchema = APIResponseSchema(z.object({ queue: QueueSchema }));
+const QueuesListResponseSchema = APIResponseSchema(z.object({
+    queues: z.array(QueueSchema),
+    total: z.number().optional(),
+}));
+const DeleteQueueResponseSchema = APIResponseSchemaNoData();
+/**
+ * Create a new message queue.
+ *
+ * Creates a queue with the specified type and settings. The queue name is optional
+ * and will be auto-generated if not provided.
+ *
+ * @param client - The API client instance
+ * @param params - Queue creation parameters
+ * @returns The created queue
+ * @throws {QueueValidationError} If validation fails
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Create a worker queue with custom settings
+ * const queue = await createQueue(client, {
+ *   name: 'order-processing',
+ *   queue_type: 'worker',
+ *   description: 'Processes customer orders',
+ *   settings: {
+ *     default_max_retries: 3,
+ *     default_visibility_timeout_seconds: 60,
+ *   },
+ * });
+ * console.log(`Created queue: ${queue.id}`);
+ * ```
+ */
+export async function createQueue(client, params, options) {
+    // Validate before sending to API
+    validateQueueType(params.queue_type);
+    if (params.name) {
+        validateQueueName(params.name);
+    }
+    if (params.description) {
+        validateDescription(params.description);
+    }
+    // Validate settings if provided
+    if (params.settings) {
+        if (params.settings.default_ttl_seconds !== undefined) {
+            validateTTL(params.settings.default_ttl_seconds ?? undefined);
+        }
+        if (params.settings.default_visibility_timeout_seconds !== undefined) {
+            validateVisibilityTimeout(params.settings.default_visibility_timeout_seconds);
+        }
+        if (params.settings.default_max_retries !== undefined) {
+            validateMaxRetries(params.settings.default_max_retries);
+        }
+        if (params.settings.max_in_flight_per_client !== undefined) {
+            validateMaxInFlight(params.settings.max_in_flight_per_client);
+        }
+    }
+    const url = queueApiPath('create');
+    const resp = await client.post(url, params, QueueResponseSchema, CreateQueueRequestSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.queue;
+    }
+    throw new QueueError({
+        message: resp.message || 'Failed to create queue',
+    });
+}
+/**
+ * Get a queue by name.
+ *
+ * Retrieves the queue details including settings and statistics.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The queue details
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await getQueue(client, 'order-processing');
+ * console.log(`Queue has ${queue.stats?.message_count} messages`);
+ * ```
+ */
+export async function getQueue(client, name, options) {
+    validateQueueName(name);
+    const url = queueApiPath('get', name);
+    const resp = await client.get(url, QueueResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.queue;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName: name,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to get queue',
+    });
+}
+/**
+ * List all queues with optional pagination.
+ *
+ * @param client - The API client instance
+ * @param params - Optional pagination parameters
+ * @returns Object containing the list of queues and optional total count
+ * @throws {QueueValidationError} If pagination parameters are invalid
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // List first 10 queues
+ * const { queues, total } = await listQueues(client, { limit: 10 });
+ * console.log(`Found ${total} queues`);
+ *
+ * // Paginate through all queues
+ * const { queues: page2 } = await listQueues(client, { limit: 10, offset: 10 });
+ * ```
+ */
+export async function listQueues(client, params, options) {
+    // Validate pagination params
+    if (params?.limit !== undefined) {
+        validateLimit(params.limit);
+    }
+    if (params?.offset !== undefined) {
+        validateOffset(params.offset);
+    }
+    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 = queueApiPathWithQuery('list', queryString || undefined);
+    const resp = await client.get(url, QueuesListResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return { queues: resp.data.queues, total: resp.data.total };
+    }
+    throw new QueueError({
+        message: resp.message || 'Failed to list queues',
+    });
+}
+/**
+ * Update an existing queue.
+ *
+ * Updates the queue description and/or settings. Only provided fields are updated.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @param params - Update parameters
+ * @returns The updated queue
+ * @throws {QueueValidationError} If validation fails
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await updateQueue(client, 'order-processing', {
+ *   description: 'Updated description',
+ *   settings: { default_max_retries: 5 },
+ * });
+ * ```
+ */
+export async function updateQueue(client, name, params, options) {
+    // Validate before sending to API
+    validateQueueName(name);
+    if (params.description) {
+        validateDescription(params.description);
+    }
+    // Validate settings if provided
+    if (params.settings) {
+        if (params.settings.default_ttl_seconds !== undefined) {
+            validateTTL(params.settings.default_ttl_seconds ?? undefined);
+        }
+        if (params.settings.default_visibility_timeout_seconds !== undefined) {
+            validateVisibilityTimeout(params.settings.default_visibility_timeout_seconds);
+        }
+        if (params.settings.default_max_retries !== undefined) {
+            validateMaxRetries(params.settings.default_max_retries);
+        }
+        if (params.settings.max_in_flight_per_client !== undefined) {
+            validateMaxInFlight(params.settings.max_in_flight_per_client);
+        }
+    }
+    const url = queueApiPath('update', name);
+    const resp = await client.patch(url, params, QueueResponseSchema, UpdateQueueRequestSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.queue;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName: name,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to update queue',
+    });
+}
+/**
+ * Delete a queue.
+ *
+ * Permanently deletes a queue and all its messages. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteQueue(client, 'order-processing');
+ * console.log('Queue deleted');
+ * ```
+ */
+export async function deleteQueue(client, name, options) {
+    validateQueueName(name);
+    const url = queueApiPath('delete', name);
+    const resp = await client.delete(url, DeleteQueueResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName: name,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to delete queue',
+    });
+}
+/**
+ * Pause a queue.
+ *
+ * Pauses message processing for the queue. Messages can still be published
+ * but will not be delivered to consumers until the queue is resumed.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The updated queue with paused_at timestamp
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await pauseQueue(client, 'order-processing');
+ * console.log(`Queue paused at: ${queue.paused_at}`);
+ * ```
+ */
+export async function pauseQueue(client, name, options) {
+    validateQueueName(name);
+    const url = queueApiPath('pause', name);
+    const resp = await client.post(url, {}, QueueResponseSchema, z.object({}), undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.queue;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName: name,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to pause queue',
+    });
+}
+/**
+ * Resume a paused queue.
+ *
+ * Resumes message processing for a paused queue. Consumers will start
+ * receiving messages again.
+ *
+ * @param client - The API client instance
+ * @param name - The queue name
+ * @returns The updated queue with paused_at cleared
+ * @throws {QueueValidationError} If the queue name is invalid
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const queue = await resumeQueue(client, 'order-processing');
+ * console.log(`Queue resumed, paused_at: ${queue.paused_at}`); // null
+ * ```
+ */
+export async function resumeQueue(client, name, options) {
+    validateQueueName(name);
+    const url = queueApiPath('resume', name);
+    const resp = await client.post(url, {}, QueueResponseSchema, z.object({}), undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.queue;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName: name,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName: name,
+        message: resp.message || 'Failed to resume queue',
+    });
+}
+//# sourceMappingURL=queues.js.map

package/dist/api/queue/queues.js.map

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

package/dist/api/queue/sources.d.ts

@@ -0,0 +1,132 @@
+import { APIClient } from '../api';
+import { type Source, type CreateSourceRequest, type UpdateSourceRequest, type QueueApiOptions } from './types';
+/**
+ * Create a source for a queue.
+ *
+ * Sources are public HTTP ingestion endpoints that allow external systems to
+ * publish messages to a queue. They support various authentication methods
+ * to secure access.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue to add the source to
+ * @param params - Source configuration including name and optional auth settings
+ * @returns The created source with assigned ID and public URL
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source name)
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {SourceAlreadyExistsError} If a source with the same name already exists
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const source = await createSource(client, 'order-events', {
+ *   name: 'webhook-ingestion',
+ *   description: 'Receives webhooks from external service',
+ *   auth_type: 'header',
+ *   auth_value: 'Bearer my-secret-token',
+ * });
+ * console.log(`Created source ${source.id} at ${source.url}`);
+ * ```
+ */
+export declare function createSource(client: APIClient, queueName: string, params: CreateSourceRequest, options?: QueueApiOptions): Promise<Source>;
+/**
+ * List all sources for a queue.
+ *
+ * Retrieves all HTTP ingestion endpoints configured for a queue. Each source
+ * provides a public URL for external systems to publish messages.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @returns Array of sources 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 sources = await listSources(client, 'order-events');
+ * for (const source of sources) {
+ *   console.log(`Source ${source.id}: ${source.name} (${source.enabled ? 'enabled' : 'disabled'})`);
+ *   console.log(`  URL: ${source.url}`);
+ *   console.log(`  Success rate: ${source.success_count}/${source.request_count}`);
+ * }
+ * ```
+ */
+export declare function listSources(client: APIClient, queueName: string, options?: QueueApiOptions): Promise<Source[]>;
+/**
+ * Get a source by ID.
+ *
+ * Retrieves a specific source's details including its public URL and statistics.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to retrieve (prefixed with qsrc_)
+ * @returns The source details
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const source = await getSource(client, 'order-events', 'qsrc_abc123');
+ * console.log(`Source: ${source.name}`);
+ * console.log(`URL: ${source.url}`);
+ * console.log(`Auth type: ${source.auth_type}`);
+ * console.log(`Last request: ${source.last_request_at}`);
+ * ```
+ */
+export declare function getSource(client: APIClient, queueName: string, sourceId: string, options?: QueueApiOptions): Promise<Source>;
+/**
+ * Update a source's configuration.
+ *
+ * Modifies an existing source's settings such as name, enabled status,
+ * or authentication configuration. Only the fields provided in params will be updated.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to update (prefixed with qsrc_)
+ * @param params - Fields to update (partial update supported)
+ * @returns The updated source
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Disable a source temporarily
+ * const updated = await updateSource(client, 'order-events', 'qsrc_abc123', {
+ *   enabled: false,
+ * });
+ *
+ * // Update authentication
+ * const updated = await updateSource(client, 'order-events', 'qsrc_abc123', {
+ *   auth_type: 'basic',
+ *   auth_value: 'user:password',
+ * });
+ * ```
+ */
+export declare function updateSource(client: APIClient, queueName: string, sourceId: string, params: UpdateSourceRequest, options?: QueueApiOptions): Promise<Source>;
+/**
+ * Delete a source from a queue.
+ *
+ * Permanently removes an HTTP ingestion endpoint. The public URL will no longer
+ * accept requests. This action cannot be undone.
+ *
+ * @param client - The API client instance
+ * @param queueName - The name of the queue
+ * @param sourceId - The source ID to delete (prefixed with qsrc_)
+ * @returns void
+ * @throws {QueueValidationError} If validation fails (invalid queue name or source ID)
+ * @throws {SourceNotFoundError} If the source does not exist
+ * @throws {QueueNotFoundError} If the queue does not exist
+ * @throws {QueueError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * await deleteSource(client, 'order-events', 'qsrc_abc123');
+ * console.log('Source deleted');
+ * ```
+ */
+export declare function deleteSource(client: APIClient, queueName: string, sourceId: string, options?: QueueApiOptions): Promise<void>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/api/queue/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../src/api/queue/sources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAwD,MAAM,QAAQ,CAAC;AACzF,OAAO,EAEN,KAAK,MAAM,EACX,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAGpB,MAAM,SAAS,CAAC;AAmBjB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA8DjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC9B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAmCf"}