@agentuity/core 1.0.33 → 1.0.35

package/src/api/queue/destinations.ts

@@ -1,259 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema, APIResponseSchemaNoData } from '../api.ts';
-import {
-	type CreateDestinationRequest,
-	CreateDestinationRequestSchema,
-	type Destination,
-	DestinationSchema,
-	type QueueApiOptions,
-	type UpdateDestinationRequest,
-	UpdateDestinationRequestSchema,
-} from './types.ts';
-import { buildQueueHeaders, QueueError, queueApiPath, withQueueErrorHandling } from './util.ts';
-import {
-	validateDestinationConfig,
-	validateDestinationId,
-	validateQueueName,
-} from './validation.ts';
-
-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: APIClient,
-	queueName: string,
-	params: CreateDestinationRequest,
-	options?: QueueApiOptions
-): Promise<Destination> {
-	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: APIClient,
-	queueName: string,
-	options?: QueueApiOptions
-): Promise<Destination[]> {
-	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 dest_)
- * @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', 'dest_abc123', {
- *   enabled: false,
- * });
- *
- * // Update URL and retry settings
- * const updated = await updateDestination(client, 'order-events', 'dest_abc123', {
- *   url: 'https://api.example.com/v2/webhooks/orders',
- *   config: {
- *     retry_attempts: 5,
- *   },
- * });
- * ```
- */
-export async function updateDestination(
-	client: APIClient,
-	queueName: string,
-	destinationId: string,
-	params: UpdateDestinationRequest,
-	options?: QueueApiOptions
-): Promise<Destination> {
-	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 dest_)
- * @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', 'dest_abc123');
- * console.log('Destination deleted');
- * ```
- */
-export async function deleteDestination(
-	client: APIClient,
-	queueName: string,
-	destinationId: string,
-	options?: QueueApiOptions
-): Promise<void> {
-	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',
-	});
-}

package/src/api/queue/index.ts

@@ -1,308 +0,0 @@
-/**
- * @module queue
- *
- * Queue API client for managing message queues, messages, destinations, and dead letter queues.
- *
- * This module provides a complete client for the Agentuity Queue API, supporting:
- * - **Queue Management**: Create, read, update, and delete message queues
- * - **Message Operations**: Publish, consume, acknowledge, and manage messages
- * - **Destinations**: Configure webhook endpoints for automatic message delivery
- * - **Dead Letter Queue**: Handle failed messages that exceeded retry limits
- *
- * @example Basic Queue Operations
- * ```typescript
- * import { createQueue, publishMessage, receiveMessage, ackMessage } from '@agentuity/server';
- *
- * // Create a worker queue
- * const queue = await createQueue(client, {
- *   name: 'order-processing',
- *   queue_type: 'worker',
- * });
- *
- * // Publish a message
- * await publishMessage(client, 'order-processing', {
- *   payload: { orderId: 123 },
- * });
- *
- * // Receive and acknowledge a message
- * const message = await receiveMessage(client, 'order-processing');
- * if (message) {
- *   // Process the message...
- *   await ackMessage(client, 'order-processing', message.id);
- * }
- * ```
- *
- * @example Webhook Destinations
- * ```typescript
- * import { createDestination } from '@agentuity/server';
- *
- * // Messages are automatically delivered to this URL
- * await createDestination(client, 'order-processing', {
- *   destination_type: 'http',
- *   config: { url: 'https://api.example.com/webhook' },
- * });
- * ```
- */
-
-// ============================================================================
-// Types & Schemas
-// ============================================================================
-
-export {
-	type AnalyticsGranularity,
-	// Analytics types
-	AnalyticsGranularitySchema,
-	type AnalyticsOptions,
-	type BatchPublishMessagesRequest,
-	BatchPublishMessagesRequestSchema,
-	type ConsumeMessagesRequest,
-	ConsumeMessagesRequestSchema,
-	type CreateDestinationRequest,
-	CreateDestinationRequestSchema,
-	type CreateQueueRequest,
-	CreateQueueRequestSchema,
-	type CreateSourceRequest,
-	CreateSourceRequestSchema,
-	type DeadLetterMessage,
-	DeadLetterMessageSchema,
-	type Destination,
-	type DestinationAnalytics,
-	DestinationAnalyticsSchema,
-	DestinationSchema,
-	type DestinationStats,
-	DestinationStatsSchema,
-	type DestinationType,
-	DestinationTypeSchema,
-	type HttpDestinationConfig,
-	HttpDestinationConfigSchema,
-	type LatencyStats,
-	LatencyStatsSchema,
-	type ListDlqRequest,
-	ListDlqRequestSchema,
-	type ListMessagesRequest,
-	ListMessagesRequestSchema,
-	type ListQueuesRequest,
-	ListQueuesRequestSchema,
-	type Message,
-	MessageSchema,
-	type MessageState,
-	MessageStateSchema,
-	type OrgAnalytics,
-	OrgAnalyticsSchema,
-	type OrgAnalyticsSummary,
-	OrgAnalyticsSummarySchema,
-	type PublishMessageRequest,
-	PublishMessageRequestSchema,
-	type Queue,
-	type QueueAnalytics,
-	QueueAnalyticsSchema,
-	type QueueApiOptions,
-	type QueueCurrentStats,
-	QueueCurrentStatsSchema,
-	type QueuePeriodStats,
-	QueuePeriodStatsSchema,
-	QueueSchema,
-	type QueueSettings,
-	QueueSettingsSchema,
-	type QueueStats,
-	QueueStatsSchema,
-	type QueueSummary,
-	QueueSummarySchema,
-	type QueueType,
-	QueueTypeSchema,
-	type Source,
-	type SourceAuthType,
-	// Source types
-	SourceAuthTypeSchema,
-	SourceSchema,
-	type SSEStatsEvent,
-	SSEStatsEventSchema,
-	type StreamAnalyticsOptions,
-	type TimePeriod,
-	TimePeriodSchema,
-	type TimeSeriesData,
-	TimeSeriesDataSchema,
-	type TimeSeriesPoint,
-	TimeSeriesPointSchema,
-	type UpdateDestinationRequest,
-	UpdateDestinationRequestSchema,
-	type UpdateQueueRequest,
-	UpdateQueueRequestSchema,
-	type UpdateSourceRequest,
-	UpdateSourceRequestSchema,
-	type WebSocketAuthRequest,
-	WebSocketAuthRequestSchema,
-	type WebSocketAuthResponse,
-	WebSocketAuthResponseSchema,
-	type WebSocketMessage,
-	WebSocketMessageSchema,
-} from './types.ts';
-
-// ============================================================================
-// Errors
-// ============================================================================
-
-export {
-	DestinationAlreadyExistsError,
-	DestinationNotFoundError,
-	MessageNotFoundError,
-	QueueError,
-	QueueInvalidArgumentError,
-	QueueNotFoundError,
-	SourceAlreadyExistsError,
-	SourceNotFoundError,
-} from './util.ts';
-
-// ============================================================================
-// Queue Operations
-// ============================================================================
-
-export {
-	createQueue,
-	DeleteQueueResponseSchema,
-	deleteQueue,
-	getQueue,
-	listQueues,
-	pauseQueue,
-	QueueResponseSchema,
-	QueuesListResponseSchema,
-	resumeQueue,
-	updateQueue,
-} from './queues.ts';
-
-// ============================================================================
-// Message Operations
-// ============================================================================
-
-export {
-	AckNackResponseSchema,
-	ackMessage,
-	BatchPublishResponseSchema,
-	batchPublishMessages,
-	consumeMessages,
-	DeleteMessageResponseSchema,
-	deleteMessage,
-	getMessage,
-	getMessageByOffset,
-	getQueueHead,
-	getQueueTail,
-	listMessages,
-	MessageResponseSchema,
-	MessagesListResponseSchema,
-	nackMessage,
-	OffsetResponseSchema,
-	publishMessage,
-	ReceiveResponseSchema,
-	receiveMessage,
-	replayMessage,
-} from './messages.ts';
-
-// ============================================================================
-// Dead Letter Queue Operations
-// ============================================================================
-
-export {
-	DeleteDlqResponseSchema,
-	DlqListResponseSchema,
-	deleteDeadLetterMessage,
-	listDeadLetterMessages,
-	purgeDeadLetter,
-	ReplayDlqResponseSchema,
-	replayDeadLetterMessage,
-} from './dlq.ts';
-
-// ============================================================================
-// Destination Operations
-// ============================================================================
-
-export {
-	createDestination,
-	DeleteDestinationResponseSchema,
-	DestinationResponseSchema,
-	DestinationsListResponseSchema,
-	deleteDestination,
-	listDestinations,
-	updateDestination,
-} from './destinations.ts';
-
-// ============================================================================
-// Source Operations
-// ============================================================================
-
-export {
-	createSource,
-	DeleteSourceResponseSchema,
-	deleteSource,
-	getSource,
-	listSources,
-	SourceResponseSchema,
-	SourcesListResponseSchema,
-	updateSource,
-} from './sources.ts';
-
-// ============================================================================
-// Analytics Operations
-// ============================================================================
-
-export {
-	getOrgAnalytics,
-	getQueueAnalytics,
-	getQueueTimeSeries,
-	OrgAnalyticsResponseSchema,
-	QueueAnalyticsResponseSchema,
-	streamOrgAnalytics,
-	streamQueueAnalytics,
-	TimeSeriesResponseSchema,
-} from './analytics.ts';
-
-// ============================================================================
-// WebSocket Operations
-// ============================================================================
-
-export {
-	createQueueWebSocket,
-	subscribeToQueue,
-	type QueueWebSocketOptions,
-	type QueueWebSocketConnection,
-	type QueueWebSocketState,
-	type SubscribeToQueueOptions,
-} from './websocket.ts';
-
-// ============================================================================
-// Validation Utilities
-// ============================================================================
-
-export {
-	MAX_BATCH_SIZE,
-	MAX_DESCRIPTION_LENGTH,
-	MAX_IDEMPOTENCY_KEY_LENGTH,
-	MAX_IN_FLIGHT,
-	MAX_METADATA_SIZE,
-	MAX_PARTITION_KEY_LENGTH,
-	MAX_PAYLOAD_SIZE,
-	MAX_QUEUE_NAME_LENGTH,
-	MAX_RETRIES,
-	MAX_SOURCE_NAME_LENGTH,
-	MAX_VISIBILITY_TIMEOUT,
-	MIN_QUEUE_NAME_LENGTH,
-	QueueValidationError,
-	validateBatchSize,
-	validateDescription,
-	validateDestinationConfig,
-	validateDestinationId,
-	validateIdempotencyKey,
-	validateLimit,
-	validateMaxInFlight,
-	validateMaxRetries,
-	validateMessageId,
-	validateOffset,
-	validatePartitionKey,
-	validatePayload,
-	validateQueueName,
-	validateQueueType,
-	validateSourceId,
-	validateSourceName,
-	validateTTL,
-	validateVisibilityTimeout,
-	validateWebhookUrl,
-} from './validation.ts';