@zudojs/queue 0.0.1

package/dist/jobResult/jobResult.type.d.ts

@@ -0,0 +1,34 @@
+import type { Timestamp } from "@zudojs/constants";
+/**
+ * Result of a job execution.
+ */
+export interface JobResult<T = unknown> {
+    /** Whether the job succeeded. */
+    readonly success: boolean;
+    /** The return value from the processor. */
+    readonly data?: T;
+    /** Error message if the job failed. */
+    readonly error?: string;
+    /** Duration of the job execution in milliseconds. */
+    readonly durationMs: number;
+    /** When the result was created. */
+    readonly timestamp: Timestamp;
+}
+/**
+ * Progress information for a job.
+ */
+export interface JobProgress {
+    /** Progress percentage (0-100). */
+    readonly percent: number;
+    /** Current step or phase. */
+    readonly step?: string;
+    /** Total steps (if known). */
+    readonly totalSteps?: number;
+    /** Current step number. */
+    readonly currentStep?: number;
+    /** Optional message. */
+    readonly message?: string;
+    /** When the progress was updated. */
+    readonly timestamp: Timestamp;
+}
+//# sourceMappingURL=jobResult.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobResult.type.d.ts","sourceRoot":"","sources":["../../src/jobResult/jobResult.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B"}

package/dist/jobResult/jobResult.type.js

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

package/dist/jobResult/jobResult.type.js.map

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

package/dist/jobTypes/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core type definitions for the queue system.
+ *
+ * Provides branded types for job IDs, queue names, and job names,
+ * as well as lifecycle state enums and priority constants.
+ */
+export { JobState, JobPriorityLevels, BackoffType, WorkerState, createJobId, createQueueName, createJobName, isJobId, isQueueName, isJobName, } from "./jobTypes.type.js";
+export type { JobId, QueueName, JobName, JobPriority, } from "./jobTypes.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobTypes/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,EACX,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,KAAK,EACL,SAAS,EACT,OAAO,EACP,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/jobTypes/index.js

@@ -0,0 +1,8 @@
+/**
+ * Core type definitions for the queue system.
+ *
+ * Provides branded types for job IDs, queue names, and job names,
+ * as well as lifecycle state enums and priority constants.
+ */
+export { JobState, JobPriorityLevels, BackoffType, WorkerState, createJobId, createQueueName, createJobName, isJobId, isQueueName, isJobName, } from "./jobTypes.type.js";
+//# sourceMappingURL=index.js.map

package/dist/jobTypes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobTypes/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,EACX,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/jobTypes/jobTypes.type.d.ts

@@ -0,0 +1,89 @@
+import type { EntityId } from "@zudojs/constants";
+/**
+ * Unique identifier for a job.
+ */
+export type JobId = EntityId & {
+    readonly __brand: "JobId";
+};
+/**
+ * Name of a queue.
+ */
+export type QueueName = string & {
+    readonly __brand: "QueueName";
+};
+/**
+ * Name of a job type.
+ */
+export type JobName = string & {
+    readonly __brand: "JobName";
+};
+/**
+ * Lifecycle states for a job.
+ */
+export declare enum JobState {
+    WAITING = "waiting",
+    SCHEDULED = "scheduled",
+    ACTIVE = "active",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    RETRYING = "retrying",
+    CANCELLED = "cancelled",
+    PAUSED = "paused",
+    DEAD_LETTER = "dead_letter"
+}
+/**
+ * Priority levels for jobs (higher number = higher priority).
+ */
+export type JobPriority = number;
+/**
+ * Default priority constants.
+ */
+export declare const JobPriorityLevels: Readonly<{
+    readonly LOW: 10;
+    readonly NORMAL: 50;
+    readonly HIGH: 100;
+    readonly CRITICAL: 200;
+}>;
+/**
+ * Backoff strategy types.
+ */
+export declare enum BackoffType {
+    FIXED = "fixed",
+    EXPONENTIAL = "exponential"
+}
+/**
+ * Worker lifecycle states.
+ */
+export declare enum WorkerState {
+    CREATED = "created",
+    STARTING = "starting",
+    RUNNING = "running",
+    DRAINING = "draining",
+    STOPPED = "stopped",
+    FAILED = "failed"
+}
+/**
+ * Creates a JobId from a string.
+ */
+export declare function createJobId(id: string): JobId;
+/**
+ * Creates a QueueName from a string.
+ */
+export declare function createQueueName(name: string): QueueName;
+/**
+ * Creates a JobName from a string.
+ */
+export declare function createJobName(name: string): JobName;
+/**
+ * Checks if a value is a valid JobId.
+ */
+export declare function isJobId(value: unknown): value is JobId;
+/**
+ * Checks if a value is a valid QueueName.
+ */
+export declare function isQueueName(value: unknown): value is QueueName;
+/**
+ * Checks if a value is a valid JobName.
+ */
+export declare function isJobName(value: unknown): value is JobName;
+//# sourceMappingURL=jobTypes.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobTypes.type.d.ts","sourceRoot":"","sources":["../../src/jobTypes/jobTypes.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,mBAAmB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,iBAAiB;kBACvB,EAAE;qBACC,EAAE;mBACJ,GAAG;uBACC,GAAG;EACJ,CAAC;AAEZ;;GAEG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/jobTypes/jobTypes.type.js

@@ -0,0 +1,81 @@
+/**
+ * Lifecycle states for a job.
+ */
+export var JobState;
+(function (JobState) {
+    JobState["WAITING"] = "waiting";
+    JobState["SCHEDULED"] = "scheduled";
+    JobState["ACTIVE"] = "active";
+    JobState["COMPLETED"] = "completed";
+    JobState["FAILED"] = "failed";
+    JobState["RETRYING"] = "retrying";
+    JobState["CANCELLED"] = "cancelled";
+    JobState["PAUSED"] = "paused";
+    JobState["DEAD_LETTER"] = "dead_letter";
+})(JobState || (JobState = {}));
+/**
+ * Default priority constants.
+ */
+export const JobPriorityLevels = Object.freeze({
+    LOW: 10,
+    NORMAL: 50,
+    HIGH: 100,
+    CRITICAL: 200,
+});
+/**
+ * Backoff strategy types.
+ */
+export var BackoffType;
+(function (BackoffType) {
+    BackoffType["FIXED"] = "fixed";
+    BackoffType["EXPONENTIAL"] = "exponential";
+})(BackoffType || (BackoffType = {}));
+/**
+ * Worker lifecycle states.
+ */
+export var WorkerState;
+(function (WorkerState) {
+    WorkerState["CREATED"] = "created";
+    WorkerState["STARTING"] = "starting";
+    WorkerState["RUNNING"] = "running";
+    WorkerState["DRAINING"] = "draining";
+    WorkerState["STOPPED"] = "stopped";
+    WorkerState["FAILED"] = "failed";
+})(WorkerState || (WorkerState = {}));
+/**
+ * Creates a JobId from a string.
+ */
+export function createJobId(id) {
+    return id;
+}
+/**
+ * Creates a QueueName from a string.
+ */
+export function createQueueName(name) {
+    return name;
+}
+/**
+ * Creates a JobName from a string.
+ */
+export function createJobName(name) {
+    return name;
+}
+/**
+ * Checks if a value is a valid JobId.
+ */
+export function isJobId(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/**
+ * Checks if a value is a valid QueueName.
+ */
+export function isQueueName(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/**
+ * Checks if a value is a valid JobName.
+ */
+export function isJobName(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=jobTypes.type.js.map

package/dist/jobTypes/jobTypes.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobTypes.type.js","sourceRoot":"","sources":["../../src/jobTypes/jobTypes.type.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,CAAN,IAAY,QAUX;AAVD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,uCAA2B,CAAA;AAC7B,CAAC,EAVW,QAAQ,KAAR,QAAQ,QAUnB;AAOD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,GAAG;CACL,CAAC,CAAC;AAEZ;;GAEG;AACH,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,0CAA2B,CAAA;AAC7B,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;AACnB,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Queue middleware types and utilities.
+ *
+ * Provides middleware composition for queue processing.
+ */
+export { createMiddlewareChain, createLoggingMiddleware, createTimeoutMiddleware, } from "./middleware.core.js";
+export type { QueueMiddlewareContext, QueueMiddleware, } from "./middleware.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,sBAAsB,EACtB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,7 @@
+/**
+ * Queue middleware types and utilities.
+ *
+ * Provides middleware composition for queue processing.
+ */
+export { createMiddlewareChain, createLoggingMiddleware, createTimeoutMiddleware, } from "./middleware.core.js";
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/middleware/middleware.core.d.ts

@@ -0,0 +1,16 @@
+import type { QueueMiddleware } from "./middleware.type.js";
+/**
+ * Creates a middleware chain from an array of middleware.
+ */
+export declare function createMiddlewareChain(middleware: QueueMiddleware[]): QueueMiddleware;
+/**
+ * Logging middleware for queue processing.
+ */
+export declare function createLoggingMiddleware(logger?: {
+    info: (message: string, data?: Record<string, unknown>) => void;
+}): QueueMiddleware;
+/**
+ * Timeout middleware for queue processing.
+ */
+export declare function createTimeoutMiddleware(timeoutMs: number): QueueMiddleware;
+//# sourceMappingURL=middleware.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.core.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,eAAe,EAAE,GAC5B,eAAe,CAkBjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE;IAC/C,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACjE,GAAG,eAAe,CAsClB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAe1E"}

package/dist/middleware/middleware.core.js

@@ -0,0 +1,76 @@
+import { JobTimeoutError } from "@zudojs/errors";
+/**
+ * Creates a middleware chain from an array of middleware.
+ */
+export function createMiddlewareChain(middleware) {
+    return async (ctx) => {
+        let index = -1;
+        const dispatch = async () => {
+            index++;
+            if (index < middleware.length) {
+                const current = middleware[index];
+                return current({
+                    ...ctx,
+                    next: dispatch,
+                });
+            }
+            return ctx.next();
+        };
+        return dispatch();
+    };
+}
+/**
+ * Logging middleware for queue processing.
+ */
+export function createLoggingMiddleware(logger) {
+    return async (ctx) => {
+        const startTime = Date.now();
+        logger?.info("Job processing started", {
+            jobId: ctx.job.id,
+            jobName: ctx.job.name,
+            queueName: ctx.job.queueName,
+            attempt: ctx.job.attempt,
+        });
+        try {
+            const result = await ctx.next();
+            const duration = Date.now() - startTime;
+            logger?.info("Job processing completed", {
+                jobId: ctx.job.id,
+                jobName: ctx.job.name,
+                queueName: ctx.job.queueName,
+                duration,
+                success: result?.success ?? true,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            logger?.info("Job processing failed", {
+                jobId: ctx.job.id,
+                jobName: ctx.job.name,
+                queueName: ctx.job.queueName,
+                duration,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    };
+}
+/**
+ * Timeout middleware for queue processing.
+ */
+export function createTimeoutMiddleware(timeoutMs) {
+    return async (ctx) => {
+        return Promise.race([
+            ctx.next(),
+            new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new JobTimeoutError(ctx.job.id, timeoutMs, {
+                        queueName: ctx.job.queueName,
+                    }));
+                }, timeoutMs);
+            }),
+        ]);
+    };
+}
+//# sourceMappingURL=middleware.core.js.map

package/dist/middleware/middleware.core.js.map

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

package/dist/middleware/middleware.type.d.ts

@@ -0,0 +1,19 @@
+import type { Job } from "../job/job.type.js";
+import type { JobContext } from "../jobContext/jobContext.type.js";
+import type { JobResult } from "../jobResult/jobResult.type.js";
+/**
+ * Context for queue middleware execution.
+ */
+export interface QueueMiddlewareContext<TData = unknown> {
+    /** The job being processed. */
+    readonly job: Job<TData>;
+    /** Job context. */
+    readonly context: JobContext<TData>;
+    /** The next middleware or processor in the chain. */
+    next(): Promise<JobResult | void>;
+}
+/**
+ * Queue middleware function.
+ */
+export type QueueMiddleware<TData = unknown> = (ctx: QueueMiddlewareContext<TData>) => Promise<JobResult | void>;
+//# sourceMappingURL=middleware.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.type.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO;IACrD,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,GAAG,OAAO,IAAI,CAC7C,GAAG,EAAE,sBAAsB,CAAC,KAAK,CAAC,KAC/B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC"}

package/dist/middleware/middleware.type.js

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

package/dist/middleware/middleware.type.js.map

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

package/dist/processor/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Processor interface and registry.
+ *
+ * Provides the core Processor type and a registry for
+ * managing job processors.
+ */
+export { createProcessorRegistry } from "./processor.core.js";
+export { isProcessor } from "./processor.type.js";
+export type { Processor, ProcessorInfo, ProcessorRegistry, } from "./processor.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processor/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/processor/index.js

@@ -0,0 +1,9 @@
+/**
+ * Processor interface and registry.
+ *
+ * Provides the core Processor type and a registry for
+ * managing job processors.
+ */
+export { createProcessorRegistry } from "./processor.core.js";
+export { isProcessor } from "./processor.type.js";
+//# sourceMappingURL=index.js.map

package/dist/processor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/processor/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/processor/processor.core.d.ts

@@ -0,0 +1,6 @@
+import type { ProcessorRegistry } from "./processor.type.js";
+/**
+ * Creates a new ProcessorRegistry.
+ */
+export declare function createProcessorRegistry(): ProcessorRegistry;
+//# sourceMappingURL=processor.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processor.core.d.ts","sourceRoot":"","sources":["../../src/processor/processor.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAkD3D"}

package/dist/processor/processor.core.js

@@ -0,0 +1,40 @@
+import { JobError } from "@zudojs/errors";
+/**
+ * Creates a new ProcessorRegistry.
+ */
+export function createProcessorRegistry() {
+    const processors = new Map();
+    const infoMap = new Map();
+    return {
+        register(jobName, processor, options) {
+            if (processors.has(jobName)) {
+                throw new JobError(`Processor already registered for job "${jobName}".`, { jobId: jobName });
+            }
+            processors.set(jobName, processor);
+            infoMap.set(jobName, {
+                jobName,
+                registeredAt: new Date(),
+                description: options?.description,
+            });
+        },
+        get(jobName) {
+            return processors.get(jobName);
+        },
+        has(jobName) {
+            return processors.has(jobName);
+        },
+        getAll() {
+            return Array.from(infoMap.values());
+        },
+        unregister(jobName) {
+            const deleted = processors.delete(jobName);
+            infoMap.delete(jobName);
+            return deleted;
+        },
+        clear() {
+            processors.clear();
+            infoMap.clear();
+        },
+    };
+}
+//# sourceMappingURL=processor.core.js.map

package/dist/processor/processor.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.core.js","sourceRoot":"","sources":["../../src/processor/processor.core.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD,OAAO;QACL,QAAQ,CACN,OAAe,EACf,SAAoC,EACpC,OAAkC;YAElC,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,QAAQ,CAChB,yCAAyC,OAAO,IAAI,EACpD,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;YACJ,CAAC;YAED,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,SAAsB,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;gBACnB,OAAO;gBACP,YAAY,EAAE,IAAI,IAAI,EAAE;gBACxB,WAAW,EAAE,OAAO,EAAE,WAAW;aAClC,CAAC,CAAC;QACL,CAAC;QAED,GAAG,CACD,OAAe;YAEf,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAA0C,CAAC;QAC1E,CAAC;QAED,GAAG,CAAC,OAAe;YACjB,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,MAAM;YACJ,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,UAAU,CAAC,OAAe;YACxB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/processor/processor.type.d.ts

@@ -0,0 +1,42 @@
+import type { Job } from "../job/job.type.js";
+import type { JobContext } from "../jobContext/jobContext.type.js";
+import type { JobResult } from "../jobResult/jobResult.type.js";
+/**
+ * A function that processes a job.
+ */
+export type Processor<TData = unknown, TResult = unknown> = (job: Job<TData>, context: JobContext<TData>) => Promise<JobResult<TResult>> | Promise<void>;
+/**
+ * Metadata about a registered processor.
+ */
+export interface ProcessorInfo {
+    /** The job name this processor handles. */
+    readonly jobName: string;
+    /** When the processor was registered. */
+    readonly registeredAt: Date;
+    /** Optional description. */
+    readonly description?: string;
+}
+/**
+ * Registry for job processors.
+ */
+export interface ProcessorRegistry {
+    /** Register a processor for a job type. */
+    register<TData, TResult>(jobName: string, processor: Processor<TData, TResult>, options?: {
+        description?: string;
+    }): void;
+    /** Get a processor by job name. */
+    get<TData, TResult>(jobName: string): Processor<TData, TResult> | undefined;
+    /** Check if a processor is registered. */
+    has(jobName: string): boolean;
+    /** Get all registered processor info. */
+    getAll(): ProcessorInfo[];
+    /** Remove a processor. */
+    unregister(jobName: string): boolean;
+    /** Clear all processors. */
+    clear(): void;
+}
+/**
+ * Checks if a value is a valid Processor.
+ */
+export declare function isProcessor(value: unknown): value is Processor;
+//# sourceMappingURL=processor.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processor.type.d.ts","sourceRoot":"","sources":["../../src/processor/processor.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC1D,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EACf,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,KACvB,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO,EACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,IAAI,CAAC;IACR,mCAAmC;IACnC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5E,0CAA0C;IAC1C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,yCAAyC;IACzC,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}

package/dist/processor/processor.type.js

@@ -0,0 +1,7 @@
+/**
+ * Checks if a value is a valid Processor.
+ */
+export function isProcessor(value) {
+    return typeof value === "function";
+}
+//# sourceMappingURL=processor.type.js.map

package/dist/processor/processor.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.type.js","sourceRoot":"","sources":["../../src/processor/processor.type.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC"}

package/dist/queue/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Queue interface and factory functions.
+ *
+ * Provides the core Queue type and functions for creating
+ * and managing job queues.
+ */
+export { createQueue, isQueue } from "./queue.core.js";
+export type { Queue, QueueOptions, QueueStats, QueueEventMap, } from "./queue.type.js";
+export type { QueueEventEmitter } from "../queueEmitter/queueEmitter.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEvD,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/queue/index.js

@@ -0,0 +1,8 @@
+/**
+ * Queue interface and factory functions.
+ *
+ * Provides the core Queue type and functions for creating
+ * and managing job queues.
+ */
+export { createQueue, isQueue } from "./queue.core.js";
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

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

package/dist/queue/queue.core.d.ts

@@ -0,0 +1,13 @@
+import type { QueueName } from "../jobTypes/jobTypes.type.js";
+import type { Queue, QueueOptions } from "./queue.type.js";
+/**
+ * Creates a new queue.
+ *
+ * @deprecated Use `createInMemoryQueue` instead for the full in-memory implementation.
+ */
+export declare function createQueue<TData>(name: QueueName, options?: QueueOptions): Queue<TData>;
+/**
+ * Checks if a value is a valid Queue.
+ */
+export declare function isQueue(value: unknown): value is Queue;
+//# sourceMappingURL=queue.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.core.d.ts","sourceRoot":"","sources":["../../src/queue/queue.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAWrE,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAc,MAAM,iBAAiB,CAAC;AAMvE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAC/B,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,YAAY,GACrB,KAAK,CAAC,KAAK,CAAC,CAEd;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAUtD"}

package/dist/queue/queue.core.js

@@ -0,0 +1,23 @@
+import { QueueClosedError, QueueDisposedError } from "@zudojs/errors";
+import { createInMemoryQueue } from "../inMemoryQueue/index.js";
+/**
+ * Creates a new queue.
+ *
+ * @deprecated Use `createInMemoryQueue` instead for the full in-memory implementation.
+ */
+export function createQueue(name, options) {
+    return createInMemoryQueue(name, options);
+}
+/**
+ * Checks if a value is a valid Queue.
+ */
+export function isQueue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "name" in value &&
+        "add" in value &&
+        "process" in value &&
+        "getJob" in value &&
+        "getNextJob" in value);
+}
+//# sourceMappingURL=queue.core.js.map

package/dist/queue/queue.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.core.js","sourceRoot":"","sources":["../../src/queue/queue.core.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,IAAe,EACf,OAAsB;IAEtB,OAAO,mBAAmB,CAAQ,IAAI,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,IAAI,KAAK;QACd,SAAS,IAAI,KAAK;QAClB,QAAQ,IAAI,KAAK;QACjB,YAAY,IAAI,KAAK,CACtB,CAAC;AACJ,CAAC"}