@zudojs/queue 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @zudojs/queue - Background job and asynchronous task infrastructure.
+ *
+ * This package provides the core queue system for the Zudojs framework,
+ * enabling asynchronous job processing with support for retries, backoff,
+ * concurrency, and lifecycle management.
+ *
+ * @packageDocumentation
+ */
+export * from "./jobTypes/index.js";
+export * from "./job/index.js";
+export * from "./jobContext/index.js";
+export * from "./jobOptions/index.js";
+export * from "./jobResult/index.js";
+export * from "./processor/index.js";
+export * from "./queue/index.js";
+export * from "./queueManager/index.js";
+export * from "./queueRegistry/index.js";
+export * from "./queueEvents/index.js";
+export * from "./queueEmitter/index.js";
+export * from "./retryPolicy/index.js";
+export * from "./serializer/index.js";
+export * from "./middleware/index.js";
+export * from "./worker/index.js";
+export * from "./inMemoryQueue/index.js";
+export * from "./deadLetter/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @zudojs/queue - Background job and asynchronous task infrastructure.
+ *
+ * This package provides the core queue system for the Zudojs framework,
+ * enabling asynchronous job processing with support for retries, backoff,
+ * concurrency, and lifecycle management.
+ *
+ * @packageDocumentation
+ */
+// Job types
+export * from "./jobTypes/index.js";
+// Job
+export * from "./job/index.js";
+// Job context
+export * from "./jobContext/index.js";
+// Job options
+export * from "./jobOptions/index.js";
+// Job result
+export * from "./jobResult/index.js";
+// Processor
+export * from "./processor/index.js";
+// Queue
+export * from "./queue/index.js";
+// Queue manager
+export * from "./queueManager/index.js";
+// Queue registry
+export * from "./queueRegistry/index.js";
+// Queue events
+export * from "./queueEvents/index.js";
+// Queue emitter
+export * from "./queueEmitter/index.js";
+// Retry policy
+export * from "./retryPolicy/index.js";
+// Serializer
+export * from "./serializer/index.js";
+// Middleware
+export * from "./middleware/index.js";
+// Worker
+export * from "./worker/index.js";
+// In-memory queue
+export * from "./inMemoryQueue/index.js";
+// Dead letter
+export * from "./deadLetter/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY;AACZ,cAAc,qBAAqB,CAAC;AAEpC,MAAM;AACN,cAAc,gBAAgB,CAAC;AAE/B,cAAc;AACd,cAAc,uBAAuB,CAAC;AAEtC,cAAc;AACd,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,gBAAgB;AAChB,cAAc,yBAAyB,CAAC;AAExC,iBAAiB;AACjB,cAAc,0BAA0B,CAAC;AAEzC,eAAe;AACf,cAAc,wBAAwB,CAAC;AAEvC,gBAAgB;AAChB,cAAc,yBAAyB,CAAC;AAExC,eAAe;AACf,cAAc,wBAAwB,CAAC;AAEvC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,SAAS;AACT,cAAc,mBAAmB,CAAC;AAElC,kBAAkB;AAClB,cAAc,0BAA0B,CAAC;AAEzC,cAAc;AACd,cAAc,uBAAuB,CAAC"}

package/dist/job/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Job interface and factory functions.
+ *
+ * Provides the core Job type and functions for creating
+ * and manipulating job instances.
+ */
+export { createJob, isJob, updateJobState, incrementJobAttempt, } from "./job.core.js";
+export type { Job, JobInput } from "./job.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/job/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,KAAK,EACL,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/job/index.js

@@ -0,0 +1,8 @@
+/**
+ * Job interface and factory functions.
+ *
+ * Provides the core Job type and functions for creating
+ * and manipulating job instances.
+ */
+export { createJob, isJob, updateJobState, incrementJobAttempt, } from "./job.core.js";
+//# sourceMappingURL=index.js.map

package/dist/job/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/job/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,KAAK,EACL,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/job/job.core.d.ts

@@ -0,0 +1,19 @@
+import type { JobId, JobState } from "../jobTypes/jobTypes.type.js";
+import type { Job, JobInput } from "./job.type.js";
+/**
+ * Creates a new job instance.
+ */
+export declare function createJob<TData>(input: JobInput<TData>, id?: JobId): Job<TData>;
+/**
+ * Checks if a value is a valid Job.
+ */
+export declare function isJob(value: unknown): value is Job;
+/**
+ * Updates a job's state.
+ */
+export declare function updateJobState<TData>(job: Job<TData>, state: JobState, additional?: Partial<Pick<Job, "error" | "startedAt" | "completedAt" | "failedAt">>): Job<TData>;
+/**
+ * Increments a job's attempt counter.
+ */
+export declare function incrementJobAttempt<TData>(job: Job<TData>): Job<TData>;
+//# sourceMappingURL=job.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job.core.d.ts","sourceRoot":"","sources":["../../src/job/job.core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOnD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EACtB,EAAE,CAAC,EAAE,KAAK,GACT,GAAG,CAAC,KAAK,CAAC,CAqCZ;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CASlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAClC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EACf,KAAK,EAAE,QAAQ,EACf,UAAU,CAAC,EAAE,OAAO,CAClB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC,CAC9D,GACA,GAAG,CAAC,KAAK,CAAC,CASZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAMtE"}

package/dist/job/job.core.js

@@ -0,0 +1,74 @@
+import { randomBytes } from "node:crypto";
+import { createJobId, JobState as JobStateEnum, } from "../jobTypes/jobTypes.type.js";
+/**
+ * Creates a new job instance.
+ */
+export function createJob(input, id) {
+    const now = new Date().toISOString();
+    const options = input.options;
+    const jobId = id ?? createJobId(`job_${Date.now()}_${randomBytes(6).toString("hex")}`);
+    return {
+        id: jobId,
+        name: input.name,
+        queueName: input.queueName,
+        data: input.data,
+        state: options?.delay || options?.scheduledAt
+            ? JobStateEnum.SCHEDULED
+            : JobStateEnum.WAITING,
+        attempt: 0,
+        maxAttempts: options?.attempts ?? 1,
+        priority: options?.priority ?? 50,
+        createdAt: now,
+        updatedAt: now,
+        scheduledAt: options?.scheduledAt
+            ? options.scheduledAt.toISOString()
+            : options?.delay
+                ? new Date(Date.now() + options.delay).toISOString()
+                : undefined,
+        timeoutMs: options?.timeout,
+        deduplicationKey: options?.deduplicationKey,
+        metadata: options?.metadata,
+        backoff: options?.backoff
+            ? {
+                type: options.backoff.type,
+                delay: options.backoff.delay,
+                maxDelay: options.backoff.maxDelay,
+                multiplier: options.backoff.multiplier,
+            }
+            : undefined,
+    };
+}
+/**
+ * Checks if a value is a valid Job.
+ */
+export function isJob(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "id" in value &&
+        "name" in value &&
+        "state" in value &&
+        "data" in value);
+}
+/**
+ * Updates a job's state.
+ */
+export function updateJobState(job, state, additional) {
+    const now = new Date().toISOString();
+    return {
+        ...job,
+        state,
+        updatedAt: now,
+        ...additional,
+    };
+}
+/**
+ * Increments a job's attempt counter.
+ */
+export function incrementJobAttempt(job) {
+    return {
+        ...job,
+        attempt: job.attempt + 1,
+        updatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=job.core.js.map

package/dist/job/job.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.core.js","sourceRoot":"","sources":["../../src/job/job.core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO1C,OAAO,EACL,WAAW,EACX,QAAQ,IAAI,YAAY,GACzB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,KAAsB,EACtB,EAAU;IAEV,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe,CAAC;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,KAAK,GACT,EAAE,IAAI,WAAW,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE3E,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EACH,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,WAAW;YACpC,CAAC,CAAC,YAAY,CAAC,SAAS;YACxB,CAAC,CAAC,YAAY,CAAC,OAAO;QAC1B,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;QACnC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE;QACjC,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,OAAO,EAAE,WAAW;YAC/B,CAAC,CAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAgB;YAClD,CAAC,CAAC,OAAO,EAAE,KAAK;gBACd,CAAC,CAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAgB;gBACnE,CAAC,CAAC,SAAS;QACf,SAAS,EAAE,OAAO,EAAE,OAAO;QAC3B,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;QAC3C,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,OAAO,EAAE,OAAO,EAAE,OAAO;YACvB,CAAC,CAAC;gBACE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC1B,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;gBAC5B,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ;gBAClC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;aACvC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,IAAI,IAAI,KAAK;QACb,MAAM,IAAI,KAAK;QACf,OAAO,IAAI,KAAK;QAChB,MAAM,IAAI,KAAK,CAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAe,EACf,KAAe,EACf,UAEC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe,CAAC;IAElD,OAAO;QACL,GAAG,GAAG;QACN,KAAK;QACL,SAAS,EAAE,GAAG;QACd,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAQ,GAAe;IACxD,OAAO;QACL,GAAG,GAAG;QACN,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe;KACjD,CAAC;AACJ,CAAC"}

package/dist/job/job.type.d.ts

@@ -0,0 +1,65 @@
+import type { Timestamp } from "@zudojs/constants";
+import type { JobId, JobName, JobState, JobPriority, BackoffType } from "../jobTypes/jobTypes.type.js";
+import type { JobOptions } from "../jobOptions/jobOptions.type.js";
+/**
+ * A unit of work in the queue system.
+ */
+export interface Job<TData = unknown> {
+    /** Unique identifier for the job. */
+    readonly id: JobId;
+    /** Name/type of the job. */
+    readonly name: JobName;
+    /** Queue this job belongs to. */
+    readonly queueName: string;
+    /** Job payload data. */
+    readonly data: TData;
+    /** Current state of the job. */
+    readonly state: JobState;
+    /** Number of attempts made. */
+    readonly attempt: number;
+    /** Maximum number of attempts allowed. */
+    readonly maxAttempts: number;
+    /** Job priority. */
+    readonly priority: JobPriority;
+    /** When the job was created. */
+    readonly createdAt: Timestamp;
+    /** When the job was last updated. */
+    readonly updatedAt: Timestamp;
+    /** When the job should be processed (for delayed jobs). */
+    readonly scheduledAt?: Timestamp;
+    /** When the job started processing. */
+    readonly startedAt?: Timestamp;
+    /** When the job completed. */
+    readonly completedAt?: Timestamp;
+    /** When the job failed. */
+    readonly failedAt?: Timestamp;
+    /** Error message if the job failed. */
+    readonly error?: string;
+    /** Timeout in milliseconds. */
+    readonly timeoutMs?: number;
+    /** Deduplication key. */
+    readonly deduplicationKey?: string;
+    /** Additional metadata. */
+    readonly metadata?: Record<string, unknown>;
+    /** Backoff configuration. */
+    readonly backoff?: {
+        readonly type: BackoffType;
+        readonly delay: number;
+        readonly maxDelay?: number;
+        readonly multiplier?: number;
+    };
+}
+/**
+ * Input data for creating a new job.
+ */
+export interface JobInput<TData = unknown> {
+    /** Name/type of the job. */
+    readonly name: JobName;
+    /** Queue this job belongs to. */
+    readonly queueName: string;
+    /** Job payload data. */
+    readonly data: TData;
+    /** Job options. */
+    readonly options?: JobOptions;
+}
+//# sourceMappingURL=job.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job.type.d.ts","sourceRoot":"","sources":["../../src/job/job.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,KAAK,GAAG,OAAO;IAClC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,OAAO;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,mBAAmB;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;CAC/B"}

package/dist/job/job.type.js

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

package/dist/job/job.type.js.map

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

package/dist/jobContext/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Job context for processor execution.
+ *
+ * Provides context information to job processors during execution.
+ */
+export { createJobContext, isJobContext } from "./jobContext.core.js";
+export type { JobContext } from "./jobContext.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobContext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEtE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jobContext/index.js

@@ -0,0 +1,7 @@
+/**
+ * Job context for processor execution.
+ *
+ * Provides context information to job processors during execution.
+ */
+export { createJobContext, isJobContext } from "./jobContext.core.js";
+//# sourceMappingURL=index.js.map

package/dist/jobContext/index.js.map

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

package/dist/jobContext/jobContext.core.d.ts

@@ -0,0 +1,17 @@
+import type { Job } from "../job/job.type.js";
+import type { JobProgress } from "../jobResult/jobResult.type.js";
+import type { JobContext } from "./jobContext.type.js";
+/**
+ * Creates a JobContext for a job processor.
+ */
+export declare function createJobContext<TData>(job: Job<TData>, signal: AbortSignal, options?: {
+    onProgress?: (progress: JobProgress) => Promise<void>;
+    logger?: {
+        info: (message: string, data?: Record<string, unknown>) => void;
+    };
+}): JobContext<TData>;
+/**
+ * Checks if a value is a valid JobContext.
+ */
+export declare function isJobContext(value: unknown): value is JobContext;
+//# sourceMappingURL=jobContext.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobContext.core.d.ts","sourceRoot":"","sources":["../../src/jobContext/jobContext.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EACpC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KACjE,CAAC;CACE,GACL,UAAU,CAAC,KAAK,CAAC,CAoBnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAShE"}

package/dist/jobContext/jobContext.core.js

@@ -0,0 +1,36 @@
+/**
+ * Creates a JobContext for a job processor.
+ */
+export function createJobContext(job, signal, options = {}) {
+    return {
+        job,
+        signal,
+        updateProgress: async (progress) => {
+            if (options.onProgress) {
+                await options.onProgress(progress);
+            }
+        },
+        log: (message, data) => {
+            if (options.logger) {
+                options.logger.info(message, {
+                    jobId: job.id,
+                    jobName: job.name,
+                    queueName: job.queueName,
+                    ...data,
+                });
+            }
+        },
+    };
+}
+/**
+ * Checks if a value is a valid JobContext.
+ */
+export function isJobContext(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "job" in value &&
+        "signal" in value &&
+        "updateProgress" in value &&
+        "log" in value);
+}
+//# sourceMappingURL=jobContext.core.js.map

package/dist/jobContext/jobContext.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobContext.core.js","sourceRoot":"","sources":["../../src/jobContext/jobContext.core.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAe,EACf,MAAmB,EACnB,OAAO,GAKH,EAAE;IAEN,OAAO;QACL,GAAG;QACH,MAAM;QACN,cAAc,EAAE,KAAK,EAAE,QAAqB,EAAE,EAAE;YAC9C,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,GAAG,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;YACvD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC3B,KAAK,EAAE,GAAG,CAAC,EAAE;oBACb,OAAO,EAAE,GAAG,CAAC,IAAI;oBACjB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,GAAG,IAAI;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,QAAQ,IAAI,KAAK;QACjB,gBAAgB,IAAI,KAAK;QACzB,KAAK,IAAI,KAAK,CACf,CAAC;AACJ,CAAC"}

package/dist/jobContext/jobContext.type.d.ts

@@ -0,0 +1,16 @@
+import type { Job } from "../job/job.type.js";
+import type { JobProgress } from "../jobResult/jobResult.type.js";
+/**
+ * Context provided to a job processor during execution.
+ */
+export interface JobContext<TData = unknown> {
+    /** The job being processed. */
+    readonly job: Job<TData>;
+    /** AbortSignal for cancellation support. */
+    readonly signal: AbortSignal;
+    /** Update job progress. */
+    updateProgress(progress: JobProgress): Promise<void>;
+    /** Log a message with job context. */
+    log(message: string, data?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=jobContext.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobContext.type.d.ts","sourceRoot":"","sources":["../../src/jobContext/jobContext.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,OAAO;IACzC,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2BAA2B;IAC3B,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,sCAAsC;IACtC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D"}

package/dist/jobContext/jobContext.type.js

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

package/dist/jobContext/jobContext.type.js.map

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

package/dist/jobOptions/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Job options and configuration types.
+ *
+ * Provides options for job creation, retry policies, and defaults.
+ */
+export { DEFAULT_JOB_OPTIONS, mergeJobOptions } from "./jobOptions.core.js";
+export type { BackoffOptions, JobOptions } from "./jobOptions.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobOptions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jobOptions/index.js

@@ -0,0 +1,7 @@
+/**
+ * Job options and configuration types.
+ *
+ * Provides options for job creation, retry policies, and defaults.
+ */
+export { DEFAULT_JOB_OPTIONS, mergeJobOptions } from "./jobOptions.core.js";
+//# sourceMappingURL=index.js.map

package/dist/jobOptions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobOptions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jobOptions/jobOptions.core.d.ts

@@ -0,0 +1,10 @@
+import type { JobOptions } from "./jobOptions.type.js";
+/**
+ * Default job options.
+ */
+export declare const DEFAULT_JOB_OPTIONS: Readonly<Pick<JobOptions, "attempts" | "timeout">>;
+/**
+ * Merges user-provided job options with defaults.
+ */
+export declare function mergeJobOptions(options?: JobOptions): Required<Pick<JobOptions, "attempts" | "timeout">> & Pick<JobOptions, "backoff" | "delay" | "priority" | "deduplicationKey" | "scheduledAt" | "metadata">;
+//# sourceMappingURL=jobOptions.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobOptions.core.d.ts","sourceRoot":"","sources":["../../src/jobOptions/jobOptions.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CACxC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC,CAIxC,CAAC;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC,GACnD,IAAI,CACF,UAAU,EACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,kBAAkB,GAClB,aAAa,GACb,UAAU,CACb,CAWF"}

package/dist/jobOptions/jobOptions.core.js

@@ -0,0 +1,23 @@
+/**
+ * Default job options.
+ */
+export const DEFAULT_JOB_OPTIONS = Object.freeze({
+    attempts: 1,
+    timeout: 30_000,
+});
+/**
+ * Merges user-provided job options with defaults.
+ */
+export function mergeJobOptions(options) {
+    return {
+        attempts: options?.attempts ?? DEFAULT_JOB_OPTIONS.attempts ?? 1,
+        timeout: options?.timeout ?? DEFAULT_JOB_OPTIONS.timeout ?? 30_000,
+        backoff: options?.backoff,
+        delay: options?.delay,
+        priority: options?.priority,
+        deduplicationKey: options?.deduplicationKey,
+        scheduledAt: options?.scheduledAt,
+        metadata: options?.metadata,
+    };
+}
+//# sourceMappingURL=jobOptions.core.js.map

package/dist/jobOptions/jobOptions.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobOptions.core.js","sourceRoot":"","sources":["../../src/jobOptions/jobOptions.core.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAE5B,MAAM,CAAC,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,MAAM;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAoB;IAWpB,OAAO;QACL,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,IAAI,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,mBAAmB,CAAC,OAAO,IAAI,MAAM;QAClE,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;QAC3C,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

package/dist/jobOptions/jobOptions.type.d.ts

@@ -0,0 +1,36 @@
+import type { BackoffType } from "../jobTypes/jobTypes.type.js";
+/**
+ * Backoff configuration for retry attempts.
+ */
+export interface BackoffOptions {
+    /** Backoff strategy type. */
+    readonly type: BackoffType;
+    /** Initial delay in milliseconds. */
+    readonly delay: number;
+    /** Maximum delay in milliseconds (for exponential). */
+    readonly maxDelay?: number;
+    /** Multiplier for exponential backoff. */
+    readonly multiplier?: number;
+}
+/**
+ * Options for adding a job to the queue.
+ */
+export interface JobOptions {
+    /** Maximum number of attempts (default: 1, no retries). */
+    readonly attempts?: number;
+    /** Backoff configuration for retries. */
+    readonly backoff?: BackoffOptions;
+    /** Delay in milliseconds before the job becomes active. */
+    readonly delay?: number;
+    /** Job priority (higher number = higher priority). */
+    readonly priority?: number;
+    /** Timeout in milliseconds for job execution. */
+    readonly timeout?: number;
+    /** Key for job deduplication. */
+    readonly deduplicationKey?: string;
+    /** Timestamp when the job should be scheduled. */
+    readonly scheduledAt?: Date;
+    /** Additional metadata to attach to the job. */
+    readonly metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=jobOptions.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobOptions.type.d.ts","sourceRoot":"","sources":["../../src/jobOptions/jobOptions.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C"}

package/dist/jobOptions/jobOptions.type.js

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

package/dist/jobOptions/jobOptions.type.js.map

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

package/dist/jobResult/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Job result and progress types.
+ *
+ * Provides types for job execution results and progress tracking.
+ */
+export { createJobResult, createJobErrorResult, createJobProgress, } from "./jobResult.core.js";
+export type { JobResult, JobProgress } from "./jobResult.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobResult/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/jobResult/index.js

@@ -0,0 +1,7 @@
+/**
+ * Job result and progress types.
+ *
+ * Provides types for job execution results and progress tracking.
+ */
+export { createJobResult, createJobErrorResult, createJobProgress, } from "./jobResult.core.js";
+//# sourceMappingURL=index.js.map

package/dist/jobResult/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobResult/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/jobResult/jobResult.core.d.ts

@@ -0,0 +1,19 @@
+import type { JobResult, JobProgress } from "./jobResult.type.js";
+/**
+ * Creates a successful job result.
+ */
+export declare function createJobResult<T>(data: T, durationMs: number): JobResult<T>;
+/**
+ * Creates a failed job result.
+ */
+export declare function createJobErrorResult(error: string, durationMs: number): JobResult;
+/**
+ * Creates a job progress update.
+ */
+export declare function createJobProgress(percent: number, options?: {
+    step?: string;
+    totalSteps?: number;
+    currentStep?: number;
+    message?: string;
+}): JobProgress;
+//# sourceMappingURL=jobResult.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobResult.core.d.ts","sourceRoot":"","sources":["../../src/jobResult/jobResult.core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAO5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,SAAS,CAOX;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,WAAW,CASb"}

package/dist/jobResult/jobResult.core.js

@@ -0,0 +1,36 @@
+/**
+ * Creates a successful job result.
+ */
+export function createJobResult(data, durationMs) {
+    return {
+        success: true,
+        data,
+        durationMs,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Creates a failed job result.
+ */
+export function createJobErrorResult(error, durationMs) {
+    return {
+        success: false,
+        error,
+        durationMs,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Creates a job progress update.
+ */
+export function createJobProgress(percent, options = {}) {
+    return {
+        percent: Math.max(0, Math.min(100, percent)),
+        step: options.step,
+        totalSteps: options.totalSteps,
+        currentStep: options.currentStep,
+        message: options.message,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=jobResult.core.js.map

package/dist/jobResult/jobResult.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobResult.core.js","sourceRoot":"","sources":["../../src/jobResult/jobResult.core.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAI,IAAO,EAAE,UAAkB;IAC5D,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,UAAU;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,UAAkB;IAElB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK;QACL,UAAU;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,OAAO,GAKH,EAAE;IAEN,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAe;KACjD,CAAC;AACJ,CAAC"}