@agentuity/core 1.0.33 → 1.0.35

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

@@ -0,0 +1,228 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type CreateQueueRequest, type ListQueuesRequest, type Queue, type QueueApiOptions, type UpdateQueueRequest } from './types.ts';
+export declare const QueueResponseSchema: 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<{
+        queue: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            internal: z.ZodOptional<z.ZodBoolean>;
+            queue_type: z.ZodEnum<{
+                worker: "worker";
+                pubsub: "pubsub";
+            }>;
+            default_ttl_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            default_visibility_timeout_seconds: z.ZodOptional<z.ZodNumber>;
+            default_max_retries: z.ZodOptional<z.ZodNumber>;
+            default_retry_backoff_ms: z.ZodOptional<z.ZodNumber>;
+            default_retry_max_backoff_ms: z.ZodOptional<z.ZodNumber>;
+            default_retry_multiplier: z.ZodOptional<z.ZodNumber>;
+            max_in_flight_per_client: z.ZodOptional<z.ZodNumber>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            message_count: z.ZodOptional<z.ZodNumber>;
+            dlq_count: z.ZodOptional<z.ZodNumber>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            paused_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            retention_seconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const QueuesListResponseSchema: 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<{
+        queues: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            internal: z.ZodOptional<z.ZodBoolean>;
+            queue_type: z.ZodEnum<{
+                worker: "worker";
+                pubsub: "pubsub";
+            }>;
+            default_ttl_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            default_visibility_timeout_seconds: z.ZodOptional<z.ZodNumber>;
+            default_max_retries: z.ZodOptional<z.ZodNumber>;
+            default_retry_backoff_ms: z.ZodOptional<z.ZodNumber>;
+            default_retry_max_backoff_ms: z.ZodOptional<z.ZodNumber>;
+            default_retry_multiplier: z.ZodOptional<z.ZodNumber>;
+            max_in_flight_per_client: z.ZodOptional<z.ZodNumber>;
+            next_offset: z.ZodOptional<z.ZodNumber>;
+            message_count: z.ZodOptional<z.ZodNumber>;
+            dlq_count: z.ZodOptional<z.ZodNumber>;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            paused_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            retention_seconds: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        total: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const DeleteQueueResponseSchema: 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 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/services/queue/queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../../src/services/queue/queues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,WAAW,CAAC;AACvF,OAAO,EACN,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACV,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EAEvB,MAAM,YAAY,CAAC;AAoBpB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAAsD,CAAC;AACvF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAKpC,CAAC;AACF,eAAO,MAAM,yBAAyB;;;;;;8BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;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,CAgBhB;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,CAkE9C;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,CA4ChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CAwBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,KAAK,CAAC,CAwBhB"}

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

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

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

@@ -0,0 +1,309 @@
+/**
+ * @module queue
+ *
+ * Queue service for publishing messages to Agentuity queues.
+ *
+ * This module provides a simplified interface for agents to publish messages
+ * to queues. For full queue management (CRUD, consume, acknowledge), use
+ * the `@agentuity/server` package.
+ *
+ * @example Publishing from an agent
+ * ```typescript
+ * // Inside an agent handler
+ * const result = await ctx.queue.publish('order-queue', {
+ *   orderId: 123,
+ *   action: 'process',
+ * });
+ * console.log(`Published message ${result.id}`);
+ * ```
+ */
+import { FetchAdapter } from '../adapter.ts';
+import { z } from 'zod';
+/**
+ * Parameters for publishing a message to a queue.
+ *
+ * @example
+ * ```typescript
+ * const params: QueuePublishParams = {
+ *   metadata: { priority: 'high' },
+ *   partitionKey: 'customer-123',
+ *   idempotencyKey: 'order-456-v1',
+ *   ttl: 3600, // 1 hour
+ * };
+ * ```
+ */
+export declare const QueuePublishParamsSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    partitionKey: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    projectId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    sync: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type QueuePublishParams = z.infer<typeof QueuePublishParamsSchema>;
+/**
+ * Result of publishing a message to a queue.
+ *
+ * @example
+ * ```typescript
+ * const result = await queue.publish('my-queue', payload);
+ * console.log(`Message ${result.id} published at offset ${result.offset}`);
+ * ```
+ */
+export declare const QueuePublishResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    offset: z.ZodNumber;
+    publishedAt: z.ZodString;
+}, z.core.$strip>;
+export type QueuePublishResult = z.infer<typeof QueuePublishResultSchema>;
+/**
+ * Parameters for creating a queue.
+ *
+ * @example
+ * ```typescript
+ * const result = await ctx.queue.createQueue('my-queue', {
+ *   queueType: 'pubsub',
+ *   settings: { defaultTtlSeconds: 86400 },
+ * });
+ * ```
+ */
+export declare const QueueCreateParamsSchema: z.ZodObject<{
+    queueType: z.ZodOptional<z.ZodEnum<{
+        worker: "worker";
+        pubsub: "pubsub";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodObject<{
+        defaultTtlSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        defaultVisibilityTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
+        defaultMaxRetries: z.ZodOptional<z.ZodNumber>;
+        maxInFlightPerClient: z.ZodOptional<z.ZodNumber>;
+        retentionSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QueueCreateParams = z.infer<typeof QueueCreateParamsSchema>;
+/**
+ * Result of creating a queue.
+ */
+export declare const QueueCreateResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    queueType: z.ZodString;
+}, z.core.$strip>;
+export type QueueCreateResult = z.infer<typeof QueueCreateResultSchema>;
+/**
+ * Queue service interface for publishing messages.
+ *
+ * This is the interface available to agents via `ctx.queue`. It provides
+ * a simple publish-only interface suitable for agent workflows.
+ *
+ * For full queue management (create queues, consume messages, manage destinations),
+ * use the `@agentuity/server` package.
+ *
+ * @example
+ * ```typescript
+ * // In an agent handler
+ * export default createAgent('my-agent', {
+ *   handler: async (ctx, input) => {
+ *     // Publish a message to a queue
+ *     await ctx.queue.publish('notifications', {
+ *       type: 'email',
+ *       to: input.email,
+ *       subject: 'Welcome!',
+ *     });
+ *     return { success: true };
+ *   },
+ * });
+ * ```
+ */
+export interface QueueService {
+    /**
+     * Publish a message to a queue.
+     *
+     * The payload can be a string or an object. Objects are automatically
+     * JSON-stringified before publishing.
+     *
+     * @param queueName - The name of the queue to publish to
+     * @param payload - The message payload (string or JSON-serializable object)
+     * @param params - Optional publish parameters (metadata, TTL, etc.)
+     * @returns The publish result with message ID and offset
+     * @throws {QueueNotFoundError} If the queue does not exist
+     * @throws {QueueValidationError} If validation fails (invalid name, payload too large, etc.)
+     * @throws {QueuePublishError} If the publish operation fails
+     *
+     * @example Publishing a simple message
+     * ```typescript
+     * const result = await ctx.queue.publish('my-queue', 'Hello, World!');
+     * ```
+     *
+     * @example Publishing with options
+     * ```typescript
+     * const result = await ctx.queue.publish('my-queue', { task: 'process' }, {
+     *   metadata: { priority: 'high' },
+     *   idempotencyKey: 'task-123',
+     *   ttl: 3600,
+     * });
+     * ```
+     */
+    publish(queueName: string, payload: string | object, params?: QueuePublishParams): Promise<QueuePublishResult>;
+    /**
+     * Create a queue with idempotent semantics.
+     *
+     * If the queue already exists, this returns successfully without error.
+     * Safe to call multiple times — uses an internal cache to avoid redundant API calls.
+     *
+     * @param queueName - The name of the queue to create
+     * @param params - Optional creation parameters (queue type, settings, etc.)
+     * @returns The create result with queue name and type
+     * @throws {QueueValidationError} If the queue name is invalid
+     *
+     * @example Creating a worker queue
+     * ```typescript
+     * const result = await ctx.queue.createQueue('task-queue');
+     * ```
+     *
+     * @example Creating a pubsub queue with settings
+     * ```typescript
+     * const result = await ctx.queue.createQueue('events', {
+     *   queueType: 'pubsub',
+     *   settings: { defaultTtlSeconds: 86400 },
+     * });
+     * ```
+     */
+    createQueue(queueName: string, params?: QueueCreateParams): Promise<QueueCreateResult>;
+    /**
+     * Delete a queue.
+     *
+     * Permanently deletes a queue and all its messages. This action cannot be undone.
+     * If the queue has already been deleted or does not exist, a {@link QueueNotFoundError} is thrown.
+     *
+     * @param queueName - The name of the queue to delete
+     * @throws {QueueNotFoundError} If the queue does not exist
+     * @throws {QueueValidationError} If the queue name is invalid
+     *
+     * @example Deleting a queue
+     * ```typescript
+     * await ctx.queue.deleteQueue('old-queue');
+     * ```
+     */
+    deleteQueue(queueName: string): Promise<void>;
+}
+/**
+ * Error thrown when a publish operation fails.
+ *
+ * This is a general error for publish failures that aren't specifically
+ * validation or not-found errors.
+ */
+export declare const QueuePublishError: {
+    new (args?: {
+        message?: string;
+        cause?: unknown;
+    } | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "QueuePublishError";
+    } & Readonly<Record<string, never>>;
+    readonly defaultMessage?: string;
+} & (<Shape extends {
+    [x: string]: any;
+} = Record<string, never>>() => {
+    new (args?: (Shape extends Record<string, never> ? {
+        message?: string;
+        cause?: unknown;
+    } : Shape & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "QueuePublishError";
+    } & Readonly<Shape>;
+    readonly defaultMessage?: string;
+});
+/**
+ * Error thrown when a queue is not found.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ctx.queue.publish('non-existent', 'payload');
+ * } catch (error) {
+ *   if (error instanceof QueueNotFoundError) {
+ *     console.error('Queue does not exist');
+ *   }
+ * }
+ * ```
+ */
+export declare const QueueNotFoundError: {
+    new (args?: {
+        message?: string;
+        cause?: unknown;
+    } | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "QueueNotFoundError";
+    } & Readonly<Record<string, never>>;
+    readonly defaultMessage?: string;
+} & (<Shape extends {
+    [x: string]: any;
+} = Record<string, never>>() => {
+    new (args?: (Shape extends Record<string, never> ? {
+        message?: string;
+        cause?: unknown;
+    } : Shape & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "QueueNotFoundError";
+    } & Readonly<Shape>;
+    readonly defaultMessage?: string;
+});
+/**
+ * Error thrown when validation fails.
+ *
+ * Contains the field name and optionally the invalid value for debugging.
+ */
+export declare const QueueValidationError: {
+    new (args?: ({
+        /** The field that failed validation */
+        field: string;
+        /** The invalid value (for debugging) */
+        value?: unknown;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("../../error.ts").RichError & {
+        readonly _tag: "QueueValidationError";
+    } & Readonly<{
+        /** The field that failed validation */
+        field: string;
+        /** The invalid value (for debugging) */
+        value?: unknown;
+    }>;
+    readonly defaultMessage?: string;
+};
+/**
+ * HTTP-based implementation of the QueueService interface.
+ *
+ * This service communicates with the Agentuity Queue API to publish messages.
+ * It is automatically configured and available via `ctx.queue` in agent handlers.
+ *
+ * @internal This class is instantiated by the runtime; use `ctx.queue` instead.
+ */
+export declare class QueueStorageService implements QueueService {
+    #private;
+    /**
+     * Creates a new QueueStorageService.
+     *
+     * @param baseUrl - The base URL of the Queue API
+     * @param adapter - The fetch adapter for making HTTP requests
+     */
+    constructor(baseUrl: string, adapter: FetchAdapter);
+    /**
+     * @inheritdoc
+     */
+    publish(queueName: string, payload: string | object, params?: QueuePublishParams): Promise<QueuePublishResult>;
+    /**
+     * @inheritdoc
+     */
+    createQueue(queueName: string, params?: QueueCreateParams): Promise<QueueCreateResult>;
+    /**
+     * @inheritdoc
+     */
+    deleteQueue(queueName: string): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/queue/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBA8CnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;iBAiBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAiDlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEvF;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAMD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAAuC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAAwC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;QAChC,uCAAuC;eAChC,MAAM;QACb,wCAAwC;gBAChC,OAAO;;;;;;;QAHf,uCAAuC;eAChC,MAAM;QACb,wCAAwC;gBAChC,OAAO;;;CACZ,CAAC;AA2DL;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,YAAY;;IAKvD;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAKlD;;OAEG;IACG,OAAO,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC;IA6F9B;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8E5F;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BnD"}