@agentuity/server 0.1.16 → 0.1.18

package/dist/api/queue/sources.js

@@ -0,0 +1,285 @@
+import { z } from 'zod';
+import { APIResponseSchema, APIResponseSchemaNoData, APIError } from '../api';
+import { SourceSchema, CreateSourceRequestSchema, UpdateSourceRequestSchema, } from './types';
+import { QueueError, QueueNotFoundError, SourceNotFoundError, SourceAlreadyExistsError, queueApiPath, buildQueueHeaders, } from './util';
+import { validateQueueName, validateSourceId, validateSourceName } from './validation';
+const SourceResponseSchema = APIResponseSchema(z.object({ source: SourceSchema }));
+const SourcesListResponseSchema = APIResponseSchema(z.object({
+    sources: z.array(SourceSchema),
+}));
+const DeleteSourceResponseSchema = APIResponseSchemaNoData();
+/**
+ * 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 async function createSource(client, queueName, params, options) {
+    validateQueueName(queueName);
+    validateSourceName(params.name);
+    const url = queueApiPath('sources/create', queueName);
+    try {
+        const resp = await client.post(url, params, SourceResponseSchema, CreateSourceRequestSchema, undefined, buildQueueHeaders(options?.orgId));
+        if (resp.success) {
+            return resp.data.source;
+        }
+        if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+            throw new QueueNotFoundError({
+                queueName,
+                message: resp.message,
+            });
+        }
+        if (resp.message?.includes('already exists')) {
+            throw new SourceAlreadyExistsError({
+                queueName,
+                name: params.name,
+                message: `A source with name "${params.name}" already exists for queue "${queueName}"`,
+            });
+        }
+        throw new QueueError({
+            queueName,
+            message: resp.message || 'Failed to create source',
+        });
+    }
+    catch (error) {
+        if (error instanceof APIError) {
+            const message = error.message || '';
+            if (message.includes('already exists')) {
+                throw new SourceAlreadyExistsError({
+                    queueName,
+                    name: params.name,
+                    message: `A source with name "${params.name}" already exists for queue "${queueName}"`,
+                });
+            }
+            if (message.includes('queue') && message.includes('not found')) {
+                throw new QueueNotFoundError({
+                    queueName,
+                    message,
+                });
+            }
+            throw new QueueError({
+                queueName,
+                message: message || 'Failed to create source',
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * 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 async function listSources(client, queueName, options) {
+    validateQueueName(queueName);
+    const url = queueApiPath('sources/list', queueName);
+    const resp = await client.get(url, SourcesListResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.sources;
+    }
+    if (resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to list sources',
+    });
+}
+/**
+ * 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 async function getSource(client, queueName, sourceId, options) {
+    validateQueueName(queueName);
+    validateSourceId(sourceId);
+    const url = queueApiPath('sources/get', queueName, sourceId);
+    const resp = await client.get(url, SourceResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.source;
+    }
+    if (resp.message?.includes('source') && resp.message?.includes('not found')) {
+        throw new SourceNotFoundError({
+            queueName,
+            sourceId,
+            message: resp.message,
+        });
+    }
+    if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to get 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 async function updateSource(client, queueName, sourceId, params, options) {
+    validateQueueName(queueName);
+    validateSourceId(sourceId);
+    if (params.name) {
+        validateSourceName(params.name);
+    }
+    const url = queueApiPath('sources/update', queueName, sourceId);
+    const resp = await client.patch(url, params, SourceResponseSchema, UpdateSourceRequestSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return resp.data.source;
+    }
+    if (resp.message?.includes('source') && resp.message?.includes('not found')) {
+        throw new SourceNotFoundError({
+            queueName,
+            sourceId,
+            message: resp.message,
+        });
+    }
+    if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to update 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 async function deleteSource(client, queueName, sourceId, options) {
+    validateQueueName(queueName);
+    validateSourceId(sourceId);
+    const url = queueApiPath('sources/delete', queueName, sourceId);
+    const resp = await client.delete(url, DeleteSourceResponseSchema, undefined, buildQueueHeaders(options?.orgId));
+    if (resp.success) {
+        return;
+    }
+    if (resp.message?.includes('source') && resp.message?.includes('not found')) {
+        throw new SourceNotFoundError({
+            queueName,
+            sourceId,
+            message: resp.message,
+        });
+    }
+    if (resp.message?.includes('queue') && resp.message?.includes('not found')) {
+        throw new QueueNotFoundError({
+            queueName,
+            message: resp.message,
+        });
+    }
+    throw new QueueError({
+        queueName,
+        message: resp.message || 'Failed to delete source',
+    });
+}
+//# sourceMappingURL=sources.js.map

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

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