@zudojs/queue 0.0.1

package/dist/queueRegistry/queueRegistry.type.d.ts

@@ -0,0 +1,31 @@
+import type { QueueName } from "../jobTypes/jobTypes.type.js";
+import type { Queue } from "../queue/queue.type.js";
+/**
+ * Information about a registered queue.
+ */
+export interface QueueInfo {
+    /** Queue name. */
+    readonly name: QueueName;
+    /** When the queue was registered. */
+    readonly registeredAt: Date;
+    /** Queue options. */
+    readonly options?: Record<string, unknown>;
+}
+/**
+ * Registry for queue instances.
+ */
+export interface QueueRegistry {
+    /** Register a queue. */
+    register<TData>(queue: Queue<TData>): void;
+    /** Get a queue by name. */
+    get<TData>(name: QueueName): Queue<TData> | undefined;
+    /** Check if a queue is registered. */
+    has(name: QueueName): boolean;
+    /** Get all registered queue info. */
+    getAll(): QueueInfo[];
+    /** Remove a queue. */
+    unregister(name: QueueName): boolean;
+    /** Clear all queues. */
+    clear(): void;
+}
+//# sourceMappingURL=queueRegistry.type.d.ts.map

package/dist/queueRegistry/queueRegistry.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueRegistry.type.d.ts","sourceRoot":"","sources":["../../src/queueRegistry/queueRegistry.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,qBAAqB;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC3C,2BAA2B;IAC3B,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACtD,sCAAsC;IACtC,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,qCAAqC;IACrC,MAAM,IAAI,SAAS,EAAE,CAAC;IACtB,sBAAsB;IACtB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/queueRegistry/queueRegistry.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queueRegistry.type.js.map

package/dist/queueRegistry/queueRegistry.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueRegistry.type.js","sourceRoot":"","sources":["../../src/queueRegistry/queueRegistry.type.ts"],"names":[],"mappings":""}

package/dist/retryPolicy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Retry policy and backoff strategies.
+ *
+ * Provides functions for calculating retry delays and
+ * creating backoff configurations.
+ */
+export { calculateRetryDelay, shouldRetry, createBackoffOptions, createFixedBackoff, createExponentialBackoff, } from "./retryPolicy.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retryPolicy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/retryPolicy/index.js

@@ -0,0 +1,8 @@
+/**
+ * Retry policy and backoff strategies.
+ *
+ * Provides functions for calculating retry delays and
+ * creating backoff configurations.
+ */
+export { calculateRetryDelay, shouldRetry, createBackoffOptions, createFixedBackoff, createExponentialBackoff, } from "./retryPolicy.core.js";
+//# sourceMappingURL=index.js.map

package/dist/retryPolicy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retryPolicy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/retryPolicy/retryPolicy.core.d.ts

@@ -0,0 +1,29 @@
+import { BackoffType } from "../jobTypes/jobTypes.type.js";
+import type { BackoffOptions } from "../jobOptions/jobOptions.type.js";
+/**
+ * Calculates the delay for the next retry attempt.
+ */
+export declare function calculateRetryDelay(attempt: number, backoff?: BackoffOptions): number;
+/**
+ * Checks if a job should be retried based on its state.
+ */
+export declare function shouldRetry(attempt: number, maxAttempts: number): boolean;
+/**
+ * Creates a backoff options object.
+ */
+export declare function createBackoffOptions(type: BackoffType, delay: number, options?: {
+    maxDelay?: number;
+    multiplier?: number;
+}): BackoffOptions;
+/**
+ * Creates a fixed backoff options.
+ */
+export declare function createFixedBackoff(delay: number): BackoffOptions;
+/**
+ * Creates an exponential backoff options.
+ */
+export declare function createExponentialBackoff(delay: number, options?: {
+    maxDelay?: number;
+    multiplier?: number;
+}): BackoffOptions;
+//# sourceMappingURL=retryPolicy.core.d.ts.map

package/dist/retryPolicy/retryPolicy.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryPolicy.core.d.ts","sourceRoot":"","sources":["../../src/retryPolicy/retryPolicy.core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,cAAc,CAOhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAEhE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,cAAc,CAEhB"}

package/dist/retryPolicy/retryPolicy.core.js

@@ -0,0 +1,51 @@
+import { BackoffType } from "../jobTypes/jobTypes.type.js";
+/**
+ * Calculates the delay for the next retry attempt.
+ */
+export function calculateRetryDelay(attempt, backoff) {
+    if (!backoff) {
+        return 0;
+    }
+    const { type, delay, maxDelay, multiplier } = backoff;
+    switch (type) {
+        case BackoffType.FIXED:
+            return delay;
+        case BackoffType.EXPONENTIAL: {
+            const multiplierValue = multiplier ?? 2;
+            const calculatedDelay = delay * Math.pow(multiplierValue, attempt - 1);
+            return maxDelay ? Math.min(calculatedDelay, maxDelay) : calculatedDelay;
+        }
+        default:
+            return delay;
+    }
+}
+/**
+ * Checks if a job should be retried based on its state.
+ */
+export function shouldRetry(attempt, maxAttempts) {
+    return attempt < maxAttempts;
+}
+/**
+ * Creates a backoff options object.
+ */
+export function createBackoffOptions(type, delay, options) {
+    return {
+        type,
+        delay,
+        maxDelay: options?.maxDelay,
+        multiplier: options?.multiplier,
+    };
+}
+/**
+ * Creates a fixed backoff options.
+ */
+export function createFixedBackoff(delay) {
+    return createBackoffOptions(BackoffType.FIXED, delay);
+}
+/**
+ * Creates an exponential backoff options.
+ */
+export function createExponentialBackoff(delay, options) {
+    return createBackoffOptions(BackoffType.EXPONENTIAL, delay, options);
+}
+//# sourceMappingURL=retryPolicy.core.js.map

package/dist/retryPolicy/retryPolicy.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryPolicy.core.js","sourceRoot":"","sources":["../../src/retryPolicy/retryPolicy.core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,OAAwB;IAExB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEtD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,KAAK,CAAC;QAEf,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,eAAe,GAAG,UAAU,IAAI,CAAC,CAAC;YACxC,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACvE,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;QAC1E,CAAC;QAED;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,WAAmB;IAC9D,OAAO,OAAO,GAAG,WAAW,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAiB,EACjB,KAAa,EACb,OAGC;IAED,OAAO;QACL,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,oBAAoB,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,OAGC;IAED,OAAO,oBAAoB,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/serializer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serializer abstraction for job payloads.
+ *
+ * Provides serialization and deserialization of job data
+ * with JSON and passthrough implementations.
+ */
+export { JsonSerializer, createJsonSerializer, PassthroughSerializer, } from "./serializer.core.js";
+export type { Serializer } from "./serializer.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/serializer/index.js

@@ -0,0 +1,8 @@
+/**
+ * Serializer abstraction for job payloads.
+ *
+ * Provides serialization and deserialization of job data
+ * with JSON and passthrough implementations.
+ */
+export { JsonSerializer, createJsonSerializer, PassthroughSerializer, } from "./serializer.core.js";
+//# sourceMappingURL=index.js.map

package/dist/serializer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/serializer/serializer.core.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @zudojs/queue — Serializer
+ *
+ * Job payload serialization using @zudojs/serialization's JSONSerializer.
+ */
+import type { Serializer } from "./serializer.type.js";
+/** Default JSON serializer backed by @zudojs/serialization. */
+export declare const JsonSerializer: Serializer;
+/**
+ * Creates a serializer with custom options.
+ */
+export declare function createJsonSerializer(options?: {
+    replacer?: (key: string, value: unknown) => unknown;
+    space?: number;
+    preserveTypes?: boolean;
+}): Serializer;
+/** No-op serializer that passes data through unchanged. */
+export declare const PassthroughSerializer: Serializer;
+//# sourceMappingURL=serializer.core.d.ts.map

package/dist/serializer/serializer.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.core.d.ts","sourceRoot":"","sources":["../../src/serializer/serializer.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,UAQ3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,UAAU,CAiBb;AAED,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,EAAE,UAelC,CAAC"}

package/dist/serializer/serializer.core.js

@@ -0,0 +1,53 @@
+/**
+ * @zudojs/queue — Serializer
+ *
+ * Job payload serialization using @zudojs/serialization's JSONSerializer.
+ */
+import { JSONSerializer } from "@zudojs/serialization";
+/** Default JSON serializer backed by @zudojs/serialization. */
+export const JsonSerializer = Object.freeze({
+    serialize(data) {
+        return new JSONSerializer().serialize(data);
+    },
+    deserialize(data) {
+        return new JSONSerializer().deserialize(data);
+    },
+});
+/**
+ * Creates a serializer with custom options.
+ */
+export function createJsonSerializer(options) {
+    const inner = new JSONSerializer();
+    return Object.freeze({
+        serialize(data) {
+            return inner.serialize(data, {
+                pretty: options?.space !== undefined,
+                preserveTypes: options?.preserveTypes,
+                indent: options?.space,
+            });
+        },
+        deserialize(data) {
+            return inner.deserialize(data, {
+                preserveTypes: options?.preserveTypes,
+            });
+        },
+    });
+}
+/** No-op serializer that passes data through unchanged. */
+export const PassthroughSerializer = Object.freeze({
+    serialize(data) {
+        if (typeof data === "string") {
+            return data;
+        }
+        return new JSONSerializer().serialize(data);
+    },
+    deserialize(data) {
+        try {
+            return new JSONSerializer().deserialize(data);
+        }
+        catch {
+            return data;
+        }
+    },
+});
+//# sourceMappingURL=serializer.core.js.map

package/dist/serializer/serializer.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.core.js","sourceRoot":"","sources":["../../src/serializer/serializer.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAe,MAAM,CAAC,MAAM,CAAC;IACtD,SAAS,CAAI,IAAO;QAClB,OAAO,IAAI,cAAc,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAI,IAAY;QACzB,OAAO,IAAI,cAAc,EAAE,CAAC,WAAW,CAAI,IAAI,CAAC,CAAC;IACnD,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAIpC;IACC,MAAM,KAAK,GAAG,IAAI,cAAc,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,CAAI,IAAO;YAClB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;gBAC3B,MAAM,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS;gBACpC,aAAa,EAAE,OAAO,EAAE,aAAa;gBACrC,MAAM,EAAE,OAAO,EAAE,KAAK;aACvB,CAAC,CAAC;QACL,CAAC;QAED,WAAW,CAAI,IAAY;YACzB,OAAO,KAAK,CAAC,WAAW,CAAI,IAAI,EAAE;gBAChC,aAAa,EAAE,OAAO,EAAE,aAAa;aACtC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAe,MAAM,CAAC,MAAM,CAAC;IAC7D,SAAS,CAAI,IAAO;QAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,cAAc,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,WAAW,CAAI,IAAY;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,cAAc,EAAE,CAAC,WAAW,CAAI,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/serializer/serializer.type.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Serializer for job payloads.
+ *
+ * Provides serialization and deserialization of job data.
+ */
+export interface Serializer {
+    /** Serialize data to a string. */
+    serialize<T>(data: T): string;
+    /** Deserialize a string to data. */
+    deserialize<T>(data: string): T;
+}
+//# sourceMappingURL=serializer.type.d.ts.map

package/dist/serializer/serializer.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.type.d.ts","sourceRoot":"","sources":["../../src/serializer/serializer.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;CACjC"}

package/dist/serializer/serializer.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serializer.type.js.map

package/dist/serializer/serializer.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.type.js","sourceRoot":"","sources":["../../src/serializer/serializer.type.ts"],"names":[],"mappings":""}

package/dist/worker/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Worker abstraction with lifecycle management.
+ *
+ * Provides the core Worker type and functions for creating
+ * and managing job workers.
+ */
+export { createWorker, isWorker } from "./worker.core.js";
+export type { Worker, WorkerOptions, WorkerStats, WorkerLifecycleState, } from "./worker.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/worker/index.js

@@ -0,0 +1,8 @@
+/**
+ * Worker abstraction with lifecycle management.
+ *
+ * Provides the core Worker type and functions for creating
+ * and managing job workers.
+ */
+export { createWorker, isWorker } from "./worker.core.js";
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/worker/worker.core.d.ts

@@ -0,0 +1,11 @@
+import type { Queue } from "../queue/queue.type.js";
+import type { Worker, WorkerOptions } from "./worker.type.js";
+/**
+ * Creates a new Worker.
+ */
+export declare function createWorker<TData>(id: string, queue: Queue<TData>, options?: WorkerOptions): Worker<TData>;
+/**
+ * Checks if a value is a valid Worker.
+ */
+export declare function isWorker(value: unknown): value is Worker;
+//# sourceMappingURL=worker.core.d.ts.map

package/dist/worker/worker.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.core.d.ts","sourceRoot":"","sources":["../../src/worker/worker.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EAGd,MAAM,kBAAkB,CAAC;AAM1B;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EACnB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAAC,KAAK,CAAC,CA0Hf;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAUxD"}

package/dist/worker/worker.core.js

@@ -0,0 +1,117 @@
+import { WorkerState } from "../jobTypes/jobTypes.type.js";
+import { WorkerLifecycleError } from "@zudojs/errors";
+/**
+ * Creates a new Worker.
+ */
+export function createWorker(id, queue, options) {
+    let state = WorkerState.CREATED;
+    let stats = { processed: 0, succeeded: 0, failed: 0, concurrency: 0 };
+    const concurrency = options?.concurrency ?? 1;
+    const pollInterval = options?.pollInterval ?? 100;
+    let pollTimer = null;
+    let activeJobs = 0;
+    let abortController = null;
+    const poll = async () => {
+        if (state !== WorkerState.RUNNING || abortController?.signal.aborted) {
+            return;
+        }
+        if (activeJobs >= concurrency) {
+            pollTimer = setTimeout(poll, pollInterval);
+            return;
+        }
+        const job = await queue.getNextJob();
+        if (!job) {
+            pollTimer = setTimeout(poll, pollInterval);
+            return;
+        }
+        const proc = queue.getProcessor(job.name);
+        if (!proc) {
+            pollTimer = setTimeout(poll, pollInterval);
+            return;
+        }
+        activeJobs++;
+        stats.processed++;
+        try {
+            await proc(job, {
+                signal: abortController?.signal ?? new AbortController().signal,
+            });
+            stats.succeeded++;
+        }
+        catch {
+            stats.failed++;
+        }
+        finally {
+            activeJobs--;
+            pollTimer = setTimeout(poll, 0);
+        }
+    };
+    return {
+        id,
+        queue,
+        queueName: queue.name,
+        get state() {
+            return state;
+        },
+        async start() {
+            if (state !== WorkerState.CREATED && state !== WorkerState.STOPPED) {
+                throw new WorkerLifecycleError(`Worker "${id}" cannot start from state "${state}".`, { workerId: id });
+            }
+            state = WorkerState.STARTING;
+            abortController = new AbortController();
+            try {
+                state = WorkerState.RUNNING;
+                pollTimer = setTimeout(poll, 0);
+            }
+            catch (error) {
+                state = WorkerState.FAILED;
+                throw error;
+            }
+        },
+        async stop() {
+            if (state !== WorkerState.RUNNING) {
+                return;
+            }
+            state = WorkerState.DRAINING;
+            abortController?.abort();
+            while (activeJobs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, 50));
+            }
+            if (pollTimer) {
+                clearTimeout(pollTimer);
+                pollTimer = null;
+            }
+            state = WorkerState.STOPPED;
+        },
+        async forceStop() {
+            abortController?.abort();
+            if (pollTimer) {
+                clearTimeout(pollTimer);
+                pollTimer = null;
+            }
+            state = WorkerState.STOPPED;
+        },
+        isRunning() {
+            return state === WorkerState.RUNNING;
+        },
+        getStats() {
+            return {
+                ...stats,
+                concurrency,
+                state,
+            };
+        },
+    };
+}
+/**
+ * Checks if a value is a valid Worker.
+ */
+export function isWorker(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "id" in value &&
+        "queueName" in value &&
+        "state" in value &&
+        "start" in value &&
+        "stop" in value);
+}
+//# sourceMappingURL=worker.core.js.map

package/dist/worker/worker.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.core.js","sourceRoot":"","sources":["../../src/worker/worker.core.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAU,EACV,KAAmB,EACnB,OAAuB;IAEvB,IAAI,KAAK,GAAyB,WAAW,CAAC,OAAO,CAAC;IACtD,IAAI,KAAK,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACtE,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,GAAG,CAAC;IAClD,IAAI,SAAS,GAAyC,IAAI,CAAC;IAC3D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAAe,GAA2B,IAAI,CAAC;IAEnD,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,KAAK,KAAK,WAAW,CAAC,OAAO,IAAI,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACrE,OAAO;QACT,CAAC;QAED,IAAI,UAAU,IAAI,WAAW,EAAE,CAAC;YAC9B,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,UAAU,EAAE,CAAC;QACb,KAAK,CAAC,SAAS,EAAE,CAAC;QAElB,IAAI,CAAC;YACH,MAAM,IAAI,CACR,GAAY,EACZ;gBACE,MAAM,EAAE,eAAe,EAAE,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;aACvD,CACX,CAAC;YACF,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,UAAU,EAAE,CAAC;YACb,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,EAAE;QACF,KAAK;QACL,SAAS,EAAE,KAAK,CAAC,IAAI;QAErB,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,KAAK;YACT,IAAI,KAAK,KAAK,WAAW,CAAC,OAAO,IAAI,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;gBACnE,MAAM,IAAI,oBAAoB,CAC5B,WAAW,EAAE,8BAA8B,KAAK,IAAI,EACpD,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;YACJ,CAAC;YAED,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC;YAC7B,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YAExC,IAAI,CAAC;gBACH,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;gBAC5B,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;gBAC3B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,KAAK,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;gBAClC,OAAO;YACT,CAAC;YAED,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC;YAC7B,eAAe,EAAE,KAAK,EAAE,CAAC;YAEzB,OAAO,UAAU,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;QAC9B,CAAC;QAED,KAAK,CAAC,SAAS;YACb,eAAe,EAAE,KAAK,EAAE,CAAC;YAEzB,IAAI,SAAS,EAAE,CAAC;gBACd,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC;QAC9B,CAAC;QAED,SAAS;YACP,OAAO,KAAK,KAAK,WAAW,CAAC,OAAO,CAAC;QACvC,CAAC;QAED,QAAQ;YACN,OAAO;gBACL,GAAG,KAAK;gBACR,WAAW;gBACX,KAAK;aACN,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,IAAI,IAAI,KAAK;QACb,WAAW,IAAI,KAAK;QACpB,OAAO,IAAI,KAAK;QAChB,OAAO,IAAI,KAAK;QAChB,MAAM,IAAI,KAAK,CAChB,CAAC;AACJ,CAAC"}

package/dist/worker/worker.type.d.ts

@@ -0,0 +1,61 @@
+import type { Queue } from "../queue/queue.type.js";
+import type { QueueMiddleware } from "../middleware/middleware.type.js";
+import type { WorkerState } from "../jobTypes/jobTypes.type.js";
+/**
+ * Options for creating a worker.
+ */
+export interface WorkerOptions {
+    /** Maximum number of jobs to process concurrently. */
+    readonly concurrency?: number;
+    /** Poll interval in milliseconds. */
+    readonly pollInterval?: number;
+    /** Maximum number of stalled jobs before marking as failed. */
+    readonly maxStalledCount?: number;
+    /** Job timeout in milliseconds. */
+    readonly timeoutMs?: number;
+    /** Middleware for job processing. */
+    readonly middleware?: QueueMiddleware[];
+}
+/**
+ * Worker lifecycle states.
+ */
+export type WorkerLifecycleState = WorkerState;
+/**
+ * A worker that processes jobs from a queue.
+ */
+export interface Worker<TData = unknown> {
+    /** Worker ID. */
+    readonly id: string;
+    /** Queue this worker processes jobs from. */
+    readonly queue: Queue<TData>;
+    /** Queue name. */
+    readonly queueName: string;
+    /** Current worker state. */
+    readonly state: WorkerLifecycleState;
+    /** Start processing jobs. */
+    start(): Promise<void>;
+    /** Stop processing jobs gracefully. */
+    stop(): Promise<void>;
+    /** Force stop processing jobs. */
+    forceStop(): Promise<void>;
+    /** Check if the worker is running. */
+    isRunning(): boolean;
+    /** Get worker statistics. */
+    getStats(): WorkerStats;
+}
+/**
+ * Worker statistics.
+ */
+export interface WorkerStats {
+    /** Number of jobs processed. */
+    readonly processed: number;
+    /** Number of successful jobs. */
+    readonly succeeded: number;
+    /** Number of failed jobs. */
+    readonly failed: number;
+    /** Current concurrency. */
+    readonly concurrency: number;
+    /** Worker state. */
+    readonly state: WorkerLifecycleState;
+}
+//# sourceMappingURL=worker.type.d.ts.map

package/dist/worker/worker.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.type.d.ts","sourceRoot":"","sources":["../../src/worker/worker.type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG,OAAO;IACrC,iBAAiB;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,6BAA6B;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,uCAAuC;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,kCAAkC;IAClC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,sCAAsC;IACtC,SAAS,IAAI,OAAO,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,IAAI,WAAW,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC"}

package/dist/worker/worker.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.type.js.map

package/dist/worker/worker.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.type.js","sourceRoot":"","sources":["../../src/worker/worker.type.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@zudojs/queue",
+  "version": "0.0.1",
+  "description": "Background job and asynchronous task infrastructure with in-memory and adapter-based queue implementations.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/constants": "workspace:*",
+    "@zudojs/serialization": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "queue",
+    "jobs",
+    "background-jobs",
+    "worker"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}