atomic-queues 1.4.1 → 1.6.0

package/dist/utils/async.utils.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.retry = retry;
+exports.batch = batch;
+exports.createTimeout = createTimeout;
+exports.withTimeout = withTimeout;
+/**
+ * Sleep utility for async operations.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry utility with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * const result = await retry(
+ *   () => someUnreliableOperation(),
+ *   { maxAttempts: 3, baseDelay: 1000 },
+ * );
+ * ```
+ */
+async function retry(fn, options) {
+    const { maxAttempts, baseDelay, maxDelay = 30000, exponential = true, onRetry } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxAttempts) {
+                throw lastError;
+            }
+            if (onRetry) {
+                onRetry(attempt, lastError);
+            }
+            const delay = exponential
+                ? Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay)
+                : baseDelay;
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Batch utility for processing items in chunks.
+ *
+ * @example
+ * ```typescript
+ * await batch(items, 10, async (chunk) => {
+ *   await Promise.all(chunk.map(processItem));
+ * });
+ * ```
+ */
+async function batch(items, batchSize, processor) {
+    for (let i = 0; i < items.length; i += batchSize) {
+        const chunk = items.slice(i, i + batchSize);
+        await processor(chunk);
+    }
+}
+/**
+ * Create a timeout promise that rejects after specified ms.
+ */
+function createTimeout(ms, message = 'Operation timed out') {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(message)), ms);
+    });
+}
+/**
+ * Run an operation with a timeout.
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   someAsyncOperation(),
+ *   5000,
+ *   'Operation took too long',
+ * );
+ * ```
+ */
+async function withTimeout(promise, ms, message) {
+    return Promise.race([promise, createTimeout(ms, message)]);
+}
+//# sourceMappingURL=async.utils.js.map

package/dist/utils/async.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.utils.js","sourceRoot":"","sources":["../../src/utils/async.utils.ts"],"names":[],"mappings":";;AAGA,sBAEC;AAaD,sBAqCC;AAYD,sBASC;AAKD,sCAIC;AAcD,kCAMC;AAzGD;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,OAMC;IAED,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1F,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAE3B,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,KAAK,GAAG,WAAW;gBACvB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC;gBAC1D,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,KAAK,CACzB,KAAU,EACV,SAAiB,EACjB,SAAwC;IAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5C,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,EAAU,EAAE,OAAO,GAAG,qBAAqB;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,EAAU,EACV,OAAgB;IAEhB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/helpers.d.ts

@@ -1,124 +1,5 @@
-import { IAtomicJobData, IJobOptions } from '../domain';
-/**
- * Create an atomic job data payload.
- *
- * @example
- * ```typescript
- * const jobData = createAtomicJobData({
- *   entityType: 'user',
- *   entityId: '123',
- *   type: 'command',
- *   commandName: 'SendMessageCommand',
- *   payload: { message: 'Hello!' },
- * });
- *
- * await queueManager.addJob('user-123-queue', 'send-message', jobData);
- * ```
- */
-export declare function createAtomicJobData<T = unknown>(options: {
-    entityType: string;
-    entityId: string;
-    type: 'command' | 'query' | 'custom';
-    commandName?: string;
-    payload: T;
-    metadata?: Record<string, unknown>;
-}): IAtomicJobData<T>;
-/**
- * Create default job options with common settings.
- *
- * @example
- * ```typescript
- * const options = createDefaultJobOptions({
- *   priority: 0, // Highest priority
- *   attempts: 5,
- * });
- * ```
- */
-export declare function createDefaultJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
-/**
- * Create high-priority job options (for SIGTERM signals, etc.)
- */
-export declare function createHighPriorityJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
-/**
- * Sleep utility for async operations.
- */
-export declare function sleep(ms: number): Promise<void>;
-/**
- * Retry utility with exponential backoff.
- *
- * @example
- * ```typescript
- * const result = await retry(
- *   () => someUnreliableOperation(),
- *   { maxAttempts: 3, baseDelay: 1000 },
- * );
- * ```
- */
-export declare function retry<T>(fn: () => Promise<T>, options: {
-    maxAttempts: number;
-    baseDelay: number;
-    maxDelay?: number;
-    exponential?: boolean;
-    onRetry?: (attempt: number, error: Error) => void;
-}): Promise<T>;
-/**
- * Generate a queue name for an entity.
- */
-export declare function getEntityQueueName(entityType: string, entityId: string, prefix?: string): string;
-/**
- * Generate a worker name for an entity.
- */
-export declare function getEntityWorkerName(entityType: string, entityId: string, prefix?: string): string;
-/**
- * Parse a queue name to extract entity info.
- */
-export declare function parseQueueName(queueName: string): {
-    prefix: string;
-    entityType: string;
-    entityId: string;
-} | null;
-/**
- * Create a SIGTERM job payload for worker termination.
- */
-export declare function createSigtermPayload<T = unknown>(entityType: string, entityId: string): IAtomicJobData<T>;
-/**
- * Check if a job is a SIGTERM signal.
- */
-export declare function isSigtermJob(data: IAtomicJobData): boolean;
-/**
- * Batch utility for processing items in chunks.
- *
- * @example
- * ```typescript
- * await batch(items, 10, async (chunk) => {
- *   await Promise.all(chunk.map(processItem));
- * });
- * ```
- */
-export declare function batch<T>(items: T[], batchSize: number, processor: (batch: T[]) => Promise<void>): Promise<void>;
-/**
- * Create a timeout promise that rejects after specified ms.
- */
-export declare function createTimeout(ms: number, message?: string): Promise<never>;
-/**
- * Run an operation with a timeout.
- *
- * @example
- * ```typescript
- * const result = await withTimeout(
- *   someAsyncOperation(),
- *   5000,
- *   'Operation took too long',
- * );
- * ```
- */
-export declare function withTimeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
-/**
- * Debounce utility for functions.
- */
-export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): (...args: Parameters<T>) => void;
-/**
- * Throttle utility for functions.
- */
-export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): (...args: Parameters<T>) => void;
+export * from './job.utils';
+export * from './async.utils';
+export * from './naming.utils';
+export * from './rate-limit.utils';
 //# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,cAAc,CAAC,CAAC,CAAC,CAUpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAYb;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAKb;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD,GACA,OAAO,CAAC,CAAC,CAAC,CA4BZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAO,GACZ,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAO,GACZ,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAUP;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,cAAc,CAAC,CAAC,CAAC,CASnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAK1D;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,SAAwB,GAAG,OAAO,CAAC,KAAK,CAAC,CAIzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/utils/helpers.js

@@ -1,229 +1,21 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAtomicJobData = createAtomicJobData;
-exports.createDefaultJobOptions = createDefaultJobOptions;
-exports.createHighPriorityJobOptions = createHighPriorityJobOptions;
-exports.sleep = sleep;
-exports.retry = retry;
-exports.getEntityQueueName = getEntityQueueName;
-exports.getEntityWorkerName = getEntityWorkerName;
-exports.parseQueueName = parseQueueName;
-exports.createSigtermPayload = createSigtermPayload;
-exports.isSigtermJob = isSigtermJob;
-exports.batch = batch;
-exports.createTimeout = createTimeout;
-exports.withTimeout = withTimeout;
-exports.debounce = debounce;
-exports.throttle = throttle;
-const uuid_1 = require("uuid");
-/**
- * Create an atomic job data payload.
- *
- * @example
- * ```typescript
- * const jobData = createAtomicJobData({
- *   entityType: 'user',
- *   entityId: '123',
- *   type: 'command',
- *   commandName: 'SendMessageCommand',
- *   payload: { message: 'Hello!' },
- * });
- *
- * await queueManager.addJob('user-123-queue', 'send-message', jobData);
- * ```
- */
-function createAtomicJobData(options) {
-    return {
-        uuid: (0, uuid_1.v4)(),
-        entityId: options.entityId,
-        entityType: options.entityType,
-        type: options.type,
-        commandName: options.commandName,
-        payload: options.payload,
-        metadata: options.metadata,
-    };
-}
-/**
- * Create default job options with common settings.
- *
- * @example
- * ```typescript
- * const options = createDefaultJobOptions({
- *   priority: 0, // Highest priority
- *   attempts: 5,
- * });
- * ```
- */
-function createDefaultJobOptions(overrides) {
-    return {
-        removeOnComplete: true,
-        removeOnFail: false,
-        attempts: Number.MAX_SAFE_INTEGER,
-        backoff: {
-            type: 'fixed',
-            delay: 1000,
-        },
-        priority: 1,
-        ...overrides,
-    };
-}
-/**
- * Create high-priority job options (for SIGTERM signals, etc.)
- */
-function createHighPriorityJobOptions(overrides) {
-    return createDefaultJobOptions({
-        priority: 0, // Highest priority
-        ...overrides,
-    });
-}
-/**
- * Sleep utility for async operations.
- */
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Retry utility with exponential backoff.
- *
- * @example
- * ```typescript
- * const result = await retry(
- *   () => someUnreliableOperation(),
- *   { maxAttempts: 3, baseDelay: 1000 },
- * );
- * ```
- */
-async function retry(fn, options) {
-    const { maxAttempts, baseDelay, maxDelay = 30000, exponential = true, onRetry } = options;
-    let lastError;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-        try {
-            return await fn();
-        }
-        catch (error) {
-            lastError = error;
-            if (attempt === maxAttempts) {
-                throw lastError;
-            }
-            if (onRetry) {
-                onRetry(attempt, lastError);
-            }
-            const delay = exponential
-                ? Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay)
-                : baseDelay;
-            await sleep(delay);
-        }
-    }
-    throw lastError;
-}
-/**
- * Generate a queue name for an entity.
- */
-function getEntityQueueName(entityType, entityId, prefix = 'aq') {
-    return `${prefix}:${entityType}:${entityId}:queue`;
-}
-/**
- * Generate a worker name for an entity.
- */
-function getEntityWorkerName(entityType, entityId, prefix = 'aq') {
-    return `${prefix}:${entityType}:${entityId}:worker`;
-}
-/**
- * Parse a queue name to extract entity info.
- */
-function parseQueueName(queueName) {
-    const parts = queueName.split(':');
-    if (parts.length >= 4 && parts[3] === 'queue') {
-        return {
-            prefix: parts[0],
-            entityType: parts[1],
-            entityId: parts[2],
-        };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
     }
-    return null;
-}
-/**
- * Create a SIGTERM job payload for worker termination.
- */
-function createSigtermPayload(entityType, entityId) {
-    return {
-        uuid: (0, uuid_1.v4)(),
-        entityId,
-        entityType,
-        type: 'custom',
-        payload: { type: 'SIGTERM' },
-        metadata: { signal: 'SIGTERM' },
-    };
-}
-/**
- * Check if a job is a SIGTERM signal.
- */
-function isSigtermJob(data) {
-    return (data.type === 'custom' &&
-        data.payload?.type === 'SIGTERM');
-}
-/**
- * Batch utility for processing items in chunks.
- *
- * @example
- * ```typescript
- * await batch(items, 10, async (chunk) => {
- *   await Promise.all(chunk.map(processItem));
- * });
- * ```
- */
-async function batch(items, batchSize, processor) {
-    for (let i = 0; i < items.length; i += batchSize) {
-        const chunk = items.slice(i, i + batchSize);
-        await processor(chunk);
-    }
-}
-/**
- * Create a timeout promise that rejects after specified ms.
- */
-function createTimeout(ms, message = 'Operation timed out') {
-    return new Promise((_, reject) => {
-        setTimeout(() => reject(new Error(message)), ms);
-    });
-}
-/**
- * Run an operation with a timeout.
- *
- * @example
- * ```typescript
- * const result = await withTimeout(
- *   someAsyncOperation(),
- *   5000,
- *   'Operation took too long',
- * );
- * ```
- */
-async function withTimeout(promise, ms, message) {
-    return Promise.race([promise, createTimeout(ms, message)]);
-}
-/**
- * Debounce utility for functions.
- */
-function debounce(fn, ms) {
-    let timeoutId = null;
-    return (...args) => {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-        }
-        timeoutId = setTimeout(() => fn(...args), ms);
-    };
-}
-/**
- * Throttle utility for functions.
- */
-function throttle(fn, ms) {
-    let lastCall = 0;
-    return (...args) => {
-        const now = Date.now();
-        if (now - lastCall >= ms) {
-            lastCall = now;
-            fn(...args);
-        }
-    };
-}
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./job.utils"), exports);
+__exportStar(require("./async.utils"), exports);
+__exportStar(require("./naming.utils"), exports);
+__exportStar(require("./rate-limit.utils"), exports);
 //# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,gDAA8B;AAC9B,iDAA+B;AAC/B,qDAAmC"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './helpers';
+export * from './redis.utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/utils/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./helpers"), exports);
+__exportStar(require("./redis.utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,gDAA8B"}

package/dist/utils/job.utils.d.ts

@@ -0,0 +1,50 @@
+import { IAtomicJobData, IJobOptions } from '../domain';
+/**
+ * Create an atomic job data payload.
+ *
+ * @example
+ * ```typescript
+ * const jobData = createAtomicJobData({
+ *   entityType: 'user',
+ *   entityId: '123',
+ *   type: 'command',
+ *   commandName: 'SendMessageCommand',
+ *   payload: { message: 'Hello!' },
+ * });
+ *
+ * await queueManager.addJob('user-123-queue', 'send-message', jobData);
+ * ```
+ */
+export declare function createAtomicJobData<T = unknown>(options: {
+    entityType: string;
+    entityId: string;
+    type: 'command' | 'query' | 'custom';
+    commandName?: string;
+    payload: T;
+    metadata?: Record<string, unknown>;
+}): IAtomicJobData<T>;
+/**
+ * Create default job options with common settings.
+ *
+ * @example
+ * ```typescript
+ * const options = createDefaultJobOptions({
+ *   priority: 0, // Highest priority
+ *   attempts: 5,
+ * });
+ * ```
+ */
+export declare function createDefaultJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
+/**
+ * Create high-priority job options (for SIGTERM signals, etc.)
+ */
+export declare function createHighPriorityJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
+/**
+ * Create a SIGTERM job payload for worker termination.
+ */
+export declare function createSigtermPayload<T = unknown>(entityType: string, entityId: string): IAtomicJobData<T>;
+/**
+ * Check if a job is a SIGTERM signal.
+ */
+export declare function isSigtermJob(data: IAtomicJobData): boolean;
+//# sourceMappingURL=job.utils.d.ts.map

package/dist/utils/job.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.utils.d.ts","sourceRoot":"","sources":["../../src/utils/job.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,cAAc,CAAC,CAAC,CAAC,CAUpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAYb;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAKb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,cAAc,CAAC,CAAC,CAAC,CASnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAK1D"}

package/dist/utils/job.utils.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAtomicJobData = createAtomicJobData;
+exports.createDefaultJobOptions = createDefaultJobOptions;
+exports.createHighPriorityJobOptions = createHighPriorityJobOptions;
+exports.createSigtermPayload = createSigtermPayload;
+exports.isSigtermJob = isSigtermJob;
+const uuid_1 = require("uuid");
+/**
+ * Create an atomic job data payload.
+ *
+ * @example
+ * ```typescript
+ * const jobData = createAtomicJobData({
+ *   entityType: 'user',
+ *   entityId: '123',
+ *   type: 'command',
+ *   commandName: 'SendMessageCommand',
+ *   payload: { message: 'Hello!' },
+ * });
+ *
+ * await queueManager.addJob('user-123-queue', 'send-message', jobData);
+ * ```
+ */
+function createAtomicJobData(options) {
+    return {
+        uuid: (0, uuid_1.v4)(),
+        entityId: options.entityId,
+        entityType: options.entityType,
+        type: options.type,
+        commandName: options.commandName,
+        payload: options.payload,
+        metadata: options.metadata,
+    };
+}
+/**
+ * Create default job options with common settings.
+ *
+ * @example
+ * ```typescript
+ * const options = createDefaultJobOptions({
+ *   priority: 0, // Highest priority
+ *   attempts: 5,
+ * });
+ * ```
+ */
+function createDefaultJobOptions(overrides) {
+    return {
+        removeOnComplete: true,
+        removeOnFail: false,
+        attempts: Number.MAX_SAFE_INTEGER,
+        backoff: {
+            type: 'fixed',
+            delay: 1000,
+        },
+        priority: 1,
+        ...overrides,
+    };
+}
+/**
+ * Create high-priority job options (for SIGTERM signals, etc.)
+ */
+function createHighPriorityJobOptions(overrides) {
+    return createDefaultJobOptions({
+        priority: 0, // Highest priority
+        ...overrides,
+    });
+}
+/**
+ * Create a SIGTERM job payload for worker termination.
+ */
+function createSigtermPayload(entityType, entityId) {
+    return {
+        uuid: (0, uuid_1.v4)(),
+        entityId,
+        entityType,
+        type: 'custom',
+        payload: { type: 'SIGTERM' },
+        metadata: { signal: 'SIGTERM' },
+    };
+}
+/**
+ * Check if a job is a SIGTERM signal.
+ */
+function isSigtermJob(data) {
+    return (data.type === 'custom' &&
+        data.payload?.type === 'SIGTERM');
+}
+//# sourceMappingURL=job.utils.js.map

package/dist/utils/job.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.utils.js","sourceRoot":"","sources":["../../src/utils/job.utils.ts"],"names":[],"mappings":";;AAmBA,kDAiBC;AAaD,0DAcC;AAKD,oEAOC;AAKD,oDAYC;AAKD,oCAKC;AAtGD,+BAAoC;AAGpC;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,mBAAmB,CAAc,OAOhD;IACC,OAAO;QACL,IAAI,EAAE,IAAA,SAAM,GAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,uBAAuB,CACrC,SAAgC;IAEhC,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,gBAAgB;QACjC,OAAO,EAAE;YACP,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI;SACZ;QACD,QAAQ,EAAE,CAAC;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,SAAgC;IAEhC,OAAO,uBAAuB,CAAC;QAC7B,QAAQ,EAAE,CAAC,EAAE,mBAAmB;QAChC,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAClC,UAAkB,EAClB,QAAgB;IAEhB,OAAO;QACL,IAAI,EAAE,IAAA,SAAM,GAAE;QACd,QAAQ;QACR,UAAU;QACV,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAO;QACjC,QAAQ,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAoB;IAC/C,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,QAAQ;QACrB,IAAI,CAAC,OAA6B,EAAE,IAAI,KAAK,SAAS,CACxD,CAAC;AACJ,CAAC"}

package/dist/utils/naming.utils.d.ts

@@ -0,0 +1,21 @@
+export declare const DEFAULT_KEY_PREFIX = "aq";
+export declare function resolveKeyPrefix(config: {
+    keyPrefix?: string;
+}): string;
+/**
+ * Generate a queue name for an entity.
+ */
+export declare function getEntityQueueName(entityType: string, entityId: string, prefix?: string): string;
+/**
+ * Generate a worker name for an entity.
+ */
+export declare function getEntityWorkerName(entityType: string, entityId: string, prefix?: string): string;
+/**
+ * Parse a queue name to extract entity info.
+ */
+export declare function parseQueueName(queueName: string): {
+    prefix: string;
+    entityType: string;
+    entityId: string;
+} | null;
+//# sourceMappingURL=naming.utils.d.ts.map