@alanszp/queue 9.2.3 → 9.2.6

package/dist/errors/JobCannotBePromotedError.d.ts

@@ -0,0 +1,10 @@
+import { BaseError, RenderableContext, RenderableError } from "@alanszp/errors";
+import { JobState } from "bullmq";
+export declare class JobCannotBePromotedError extends BaseError implements RenderableError {
+    jobId: string;
+    currentJobState: JobState | "unknown";
+    constructor(jobId: string, currentJobState: JobState | "unknown");
+    code(): string;
+    renderMessage(): string;
+    context(): RenderableContext;
+}

package/dist/errors/JobCannotBePromotedError.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobCannotBePromotedError = void 0;
+const errors_1 = require("@alanszp/errors");
+class JobCannotBePromotedError extends errors_1.BaseError {
+    constructor(jobId, currentJobState) {
+        super("JobCannotBePromotedError");
+        this.jobId = jobId;
+        this.currentJobState = currentJobState;
+    }
+    code() {
+        return "job_cannot_be_promoted_error";
+    }
+    renderMessage() {
+        return "Job not found";
+    }
+    context() {
+        return {
+            jobId: this.jobId,
+            currentJobState: this.currentJobState,
+        };
+    }
+}
+exports.JobCannotBePromotedError = JobCannotBePromotedError;
+//# sourceMappingURL=JobCannotBePromotedError.js.map

package/dist/errors/JobCannotBePromotedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobCannotBePromotedError.js","sourceRoot":"","sources":["../../src/errors/JobCannotBePromotedError.ts"],"names":[],"mappings":";;;AAAA,4CAAgF;AAGhF,MAAa,wBACX,SAAQ,kBAAS;IAOjB,YAAY,KAAa,EAAE,eAAqC;QAC9D,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,IAAI;QACF,OAAO,8BAA8B,CAAC;IACxC,CAAC;IAED,aAAa;QACX,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC;IACJ,CAAC;CACF;AA5BD,4DA4BC"}

package/dist/errors/JobNotFoundError.d.ts

@@ -0,0 +1,8 @@
+import { BaseError, RenderableContext, RenderableError } from "@alanszp/errors";
+export declare class JobNotFoundError extends BaseError implements RenderableError {
+    jobId: string;
+    constructor(jobId: string);
+    code(): string;
+    renderMessage(): string;
+    context(): RenderableContext;
+}

package/dist/errors/JobNotFoundError.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobNotFoundError = void 0;
+const errors_1 = require("@alanszp/errors");
+class JobNotFoundError extends errors_1.BaseError {
+    constructor(jobId) {
+        super("JobNotFoundError");
+        this.jobId = jobId;
+    }
+    code() {
+        return "job_not_found_error";
+    }
+    renderMessage() {
+        return "Job not found";
+    }
+    context() {
+        return {
+            jobId: this.jobId,
+        };
+    }
+}
+exports.JobNotFoundError = JobNotFoundError;
+//# sourceMappingURL=JobNotFoundError.js.map

package/dist/errors/JobNotFoundError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobNotFoundError.js","sourceRoot":"","sources":["../../src/errors/JobNotFoundError.ts"],"names":[],"mappings":";;;AAAA,4CAAgF;AAEhF,MAAa,gBAAiB,SAAQ,kBAAS;IAG7C,YAAY,KAAa;QACvB,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,aAAa;QACX,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AArBD,4CAqBC"}

package/dist/queue/createQueue.d.ts

@@ -1,4 +1,4 @@
 import { Queue } from "./queue";
 import { JobData, QueueOptions } from "../types";
 import { SharedContext } from "@alanszp/shared-context";
-export declare function createQueue<JobType = JobData>(name: string, getContext: () => SharedContext, queueOptions?: QueueOptions): Queue;
+export declare function createQueue<Data = JobData>(name: string, getContext: () => SharedContext, queueOptions?: QueueOptions): Queue<Data>;

package/dist/queue/queue.d.ts

@@ -1,18 +1,27 @@
 import { Job, JobsOptions } from "bullmq";
+import { ListResult } from "@alanszp/core";
 import { SharedContext } from "@alanszp/shared-context";
-import { ConnectionOptions, JobData, QueueOptions } from "../types";
-export declare class Queue<JobType = JobData> {
+import { ConnectionOptions, JobData, JobReturnValue, JobTypeEnum, QueueOptions } from "../types";
+export declare class Queue<Data = JobData, ReturnValue = JobReturnValue> {
     private _queue;
     private name;
     private getSharedContext;
     constructor(connection: ConnectionOptions, name: string, prefix: string, getSharedContext: () => SharedContext, queueOptions?: QueueOptions);
     getName(): string;
-    publishJob(job: JobType, opts?: JobsOptions): Promise<Job<JobType>>;
-    publishBulkJob(jobDatas: JobType[]): Promise<Job<JobType>[]>;
+    publishJob(job: Data, opts?: JobsOptions): Promise<Job<Data, ReturnValue>>;
+    publishBulkJob(jobDatas: Data[]): Promise<Job<Data, ReturnValue>[]>;
     publishBulkJobWithOptions(jobDefinitions: {
-        jobData: JobType;
+        jobData: Data;
         opts: JobsOptions;
-    }[]): Promise<void>;
+    }[]): Promise<Job<Data, ReturnValue>[]>;
+    private pageToStartEnd;
+    getJobsAndCountByStatus(statuses: JobTypeEnum[], page?: number, pageSize?: number, ascending?: boolean): Promise<ListResult<Job<Data, ReturnValue>>>;
+    getJobCountByStatus(statuses: JobTypeEnum[], page?: number, pageSize?: number): Promise<number>;
+    getJobsByStatus(statuses: JobTypeEnum[], page?: number, pageSize?: number, ascending?: boolean): Promise<Job<Data, ReturnValue>[]>;
+    deleteJob(jobId: string): Promise<void>;
+    getJob(jobId: string): Promise<Job<Data, ReturnValue> | undefined>;
+    getJobOrFail(jobId: string): Promise<Job<Data, ReturnValue>>;
+    changeDelayToJob(jobId: string, delayMs: number): Promise<void>;
     close(): Promise<void>;
     private get queue();
 }

package/dist/queue/queue.js

@@ -12,9 +12,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Queue = void 0;
 const lodash_1 = require("lodash");
 const types_1 = require("../types");
+const JobNotFoundError_1 = require("../errors/JobNotFoundError");
+const JobCannotBePromotedError_1 = require("../errors/JobCannotBePromotedError");
 const BULL_PREFIX = "b";
 const DEFAULT_COMPLETED_JOB_MAX_AGE_IN_SECONDS = 60 * 60 * 24 * 30;
 const DEFAULT_COMPLETED_JOB_MAX_COUNT = 500;
+const DEFAULT_FAILED_JOB_MAX_COUNT = 1000;
 class Queue {
     constructor(connection, name, prefix, getSharedContext, queueOptions) {
         this.name = name;
@@ -25,6 +28,9 @@ class Queue {
                     age: DEFAULT_COMPLETED_JOB_MAX_AGE_IN_SECONDS,
                     count: DEFAULT_COMPLETED_JOB_MAX_COUNT,
                 },
+                removeOnFail: {
+                    count: DEFAULT_FAILED_JOB_MAX_COUNT,
+                },
                 attempts: 3,
                 backoff: {
                     type: "exponential",
@@ -58,7 +64,67 @@ class Queue {
                 data,
                 opts,
             }));
-            yield this.queue.addBulk(jobs);
+            return this.queue.addBulk(jobs);
+        });
+    }
+    pageToStartEnd(pageNumber, pageSize) {
+        return {
+            start: (pageNumber - 1) * pageSize,
+            end: pageNumber * pageSize - 1,
+        };
+    }
+    getJobsAndCountByStatus(statuses, page = 1, pageSize = 50, ascending = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { start, end } = this.pageToStartEnd(page, pageSize);
+            const [total, elements] = yield Promise.all([
+                this.queue.getJobCountByTypes(...statuses),
+                this.queue.getJobs(statuses, start, end, ascending),
+            ]);
+            return {
+                total,
+                elements,
+                page,
+                pageSize,
+            };
+        });
+    }
+    getJobCountByStatus(statuses, page = 1, pageSize = 50) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.queue.getJobCountByTypes(...statuses);
+        });
+    }
+    getJobsByStatus(statuses, page = 1, pageSize = 50, ascending = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { start, end } = this.pageToStartEnd(page, pageSize);
+            return this.queue.getJobs(statuses, start, end, ascending);
+        });
+    }
+    deleteJob(jobId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.queue.remove(jobId);
+        });
+    }
+    getJob(jobId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.queue.getJob(jobId);
+        });
+    }
+    getJobOrFail(jobId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const job = yield this.queue.getJob(jobId);
+            if (!job)
+                throw new JobNotFoundError_1.JobNotFoundError(jobId);
+            return job;
+        });
+    }
+    changeDelayToJob(jobId, delayMs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const job = yield this.getJobOrFail(jobId);
+            const state = yield job.getState();
+            if (state !== types_1.JobStateEnum.DELAYED) {
+                throw new JobCannotBePromotedError_1.JobCannotBePromotedError(jobId, state);
+            }
+            job.changeDelay(delayMs);
         });
     }
     close() {

package/dist/queue/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/queue/queue.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,mCAA+B;AAG/B,oCAA8E;AAE9E,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,wCAAwC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACnE,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAE5C,MAAa,KAAK;IAOhB,YACE,UAA6B,EAC7B,IAAY,EACZ,MAAc,EACd,gBAAqC,EACrC,YAA2B;QAE3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAEzC,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAQ,CAAU,IAAI,kCACnC,IAAA,cAAK,EACN;YACE,iBAAiB,EAAE;gBACjB,gBAAgB,EAAE;oBAChB,GAAG,EAAE,wCAAwC;oBAC7C,KAAK,EAAE,+BAA+B;iBACvC;gBACD,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE;oBACP,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,IAAI;iBACZ;aACF;YACD,UAAU;SACX,EACD,YAAY,IAAI,EAAE,CACnB,GACE,EAAE,MAAM,EAAE,IAAI,MAAM,KAAK,WAAW,EAAE,EAAE,EAC3C,CAAC;IACL,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAEK,UAAU,CAAC,GAAY,EAAE,IAAkB;;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,kCAAO,GAAG,KAAE,GAAG,EAAE,GAAG,KAAI,IAAI,CAAC,CAAC;QAC/D,CAAC;KAAA;IAEK,cAAc,CAAC,QAAmB;;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;KAAA;IAEK,yBAAyB,CAC7B,cAAyD;;YAEzD,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5D,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,IAAI;aACL,CAAC,CAAC,CAAC;YACJ,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;IAEK,KAAK;;YACT,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3B,CAAC;KAAA;IAED,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AA1ED,sBA0EC"}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/queue/queue.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,2 +1,22 @@
-export { ConnectionOptions, RedisOptions, Job, Worker as RawWorker, WorkerOptions, Queue as RawQueue, QueueOptions, JobsOptions, } from "bullmq";
-export declare type JobData = any;
+export { ConnectionOptions, RedisOptions, Job, Worker as RawWorker, WorkerOptions, Queue as RawQueue, QueueOptions, JobState, JobType, JobsOptions, } from "bullmq";
+export declare type JobData = unknown;
+export declare type JobReturnValue = unknown;
+export declare enum JobStateEnum {
+    ACTIVE = "active",
+    DELAYED = "delayed",
+    WAITING = "waiting",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    WAITING_CHILDREN = "waiting-children"
+}
+export declare enum JobTypeEnum {
+    ACTIVE = "active",
+    DELAYED = "delayed",
+    WAITING = "waiting",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    WAITING_CHILDREN = "waiting-children",
+    PAUSED = "paused",
+    REPEAT = "repeat",
+    WAIT = "wait"
+}

package/dist/types.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RawQueue = exports.RawWorker = exports.Job = void 0;
+exports.JobTypeEnum = exports.JobStateEnum = exports.RawQueue = exports.RawWorker = exports.Job = void 0;
 // decoupling from bullmq
 var bullmq_1 = require("bullmq");
 Object.defineProperty(exports, "Job", { enumerable: true, get: function () { return bullmq_1.Job; } });
 Object.defineProperty(exports, "RawWorker", { enumerable: true, get: function () { return bullmq_1.Worker; } });
 Object.defineProperty(exports, "RawQueue", { enumerable: true, get: function () { return bullmq_1.Queue; } });
+var JobStateEnum;
+(function (JobStateEnum) {
+    JobStateEnum["ACTIVE"] = "active";
+    JobStateEnum["DELAYED"] = "delayed";
+    JobStateEnum["WAITING"] = "waiting";
+    JobStateEnum["COMPLETED"] = "completed";
+    JobStateEnum["FAILED"] = "failed";
+    JobStateEnum["WAITING_CHILDREN"] = "waiting-children";
+})(JobStateEnum = exports.JobStateEnum || (exports.JobStateEnum = {}));
+var JobTypeEnum;
+(function (JobTypeEnum) {
+    JobTypeEnum["ACTIVE"] = "active";
+    JobTypeEnum["DELAYED"] = "delayed";
+    JobTypeEnum["WAITING"] = "waiting";
+    JobTypeEnum["COMPLETED"] = "completed";
+    JobTypeEnum["FAILED"] = "failed";
+    JobTypeEnum["WAITING_CHILDREN"] = "waiting-children";
+    JobTypeEnum["PAUSED"] = "paused";
+    JobTypeEnum["REPEAT"] = "repeat";
+    JobTypeEnum["WAIT"] = "wait";
+})(JobTypeEnum = exports.JobTypeEnum || (exports.JobTypeEnum = {}));
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,yBAAyB;AACzB,iCASgB;AANd,6FAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAa;AAEnB,kGAAA,KAAK,OAAY"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,yBAAyB;AACzB,iCAWgB;AARd,6FAAA,GAAG,OAAA;AACH,mGAAA,MAAM,OAAa;AAEnB,kGAAA,KAAK,OAAY;AAWnB,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,qDAAqC,CAAA;AACvC,CAAC,EAPW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAOvB;AAED,IAAY,WAUX;AAVD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;IACjB,oDAAqC,CAAA;IACrC,gCAAiB,CAAA;IACjB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;AACf,CAAC,EAVW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAUtB"}

package/dist/worker/worker.d.ts

@@ -1,5 +1,5 @@
 import { ILogger } from "@alanszp/logger";
-import { JobData, Job, RawWorker, WorkerOptions } from "../types";
+import { JobData, Job, RawWorker, WorkerOptions, JobReturnValue } from "../types";
 import { SharedContext } from "@alanszp/shared-context";
 import { Audit } from "@alanszp/audit";
 export interface WorkerStatus {
@@ -15,25 +15,25 @@ export interface WorkerContext {
     baseLogger: ILogger;
     audit: Audit;
 }
-interface Worker<T = JobData> {
-    handleJobFailed?(job: Job<T>, error: Error): Promise<void> | void;
-    handleJobCompleted?(job: Job<T>): Promise<void> | void;
+interface Worker<Data = JobData, ReturnValue = JobReturnValue> {
+    handleJobFailed?(job: Job<Data, ReturnValue>, error: Error): Promise<void> | void;
+    handleJobCompleted?(job: Job<Data, ReturnValue>): Promise<void> | void;
     handleJobError?(error: Error): Promise<void> | void;
 }
-declare abstract class Worker<T = JobData> {
+declare abstract class Worker<Data = JobData, ReturnValue = unknown> {
     private _worker;
     private _queue;
     private getLogger;
     constructor();
-    abstract process(job: Job<T>): Promise<void>;
+    abstract process(job: Job<Data, ReturnValue>): Promise<ReturnValue>;
     abstract setup(): WorkerSetup;
     abstract getContext(): WorkerContext;
     close(): Promise<void>;
     get status(): WorkerStatus;
     get id(): RawWorker["id"];
     private processJob;
-    processFailed(job: Job<T>, error: Error): Promise<void>;
-    processCompleted(job: Job<T>): Promise<void>;
+    processFailed(job: Job<Data, ReturnValue>, error: Error): Promise<void>;
+    processCompleted(job: Job<Data, ReturnValue>, returnValue: ReturnValue): Promise<void>;
     processError(error: Error): Promise<void>;
     run(): Promise<void>;
     protected registerHooks(): void;

package/dist/worker/worker.js

@@ -40,7 +40,7 @@ class Worker {
                 queue: this.queueFullName,
                 job,
             });
-            yield this.process(job);
+            return this.process(job);
         }));
     }
     processFailed(job, error) {
@@ -55,11 +55,12 @@ class Worker {
             }
         });
     }
-    processCompleted(job) {
+    processCompleted(job, returnValue) {
         return __awaiter(this, void 0, void 0, function* () {
             this.getLogger().info("worker.job.completed", {
                 queue: this.queueFullName,
                 job,
+                returnValue,
             });
             if (this.handleJobCompleted) {
                 yield this.handleJobCompleted(job);
@@ -101,7 +102,7 @@ class Worker {
         // on error: handle unhandled exceptions
         this.worker.on("error", (error) => this.processError(error));
         // on completed: allow to do something else after a job is completed
-        this.worker.on("completed", (job) => this.processCompleted(job));
+        this.worker.on("completed", (job, result) => this.processCompleted(job, result));
         // on failed: when the process fails with an exception it is possible to listen for the "failed" event
         this.worker.on("failed", (job, error) => this.processFailed(job, error));
     }

package/dist/worker/worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/worker/worker.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,4DAAyD;AACzD,oCAAkE;AAGlE,yDAAsD;AA4BtD,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAe,MAAM;IAOnB;QACE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAExD,MAAM,iBAAiB,GAAG,qCAAiB,CAAC,WAAW,EAAE,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC;QAE7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAS,CAAI,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,kBACrD,OAAO,EAAE,KAAK,EACd,UAAU,EAAE,iBAAiB,CAAC,aAAa,EAAE,EAC7C,MAAM,EAAE,IAAI,MAAM,KAAK,WAAW,EAAE,IACjC,aAAa,EAChB,CAAC;QACH,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAErE,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IASM,KAAK;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,IAAW,MAAM;QACf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9E,CAAC;IAED,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAEO,UAAU;QAChB,OAAO,IAAA,yBAAW,EAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAO,GAAG,EAAE,EAAE;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACnD,KAAK,EAAE,IAAI,CAAC,aAAa;gBACzB,GAAG;aACJ,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAA,CAAC,CAAC;IACL,CAAC;IAEK,aAAa,CAAC,GAAW,EAAE,KAAY;;YAC3C,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBACzC,KAAK,EAAE,IAAI,CAAC,aAAa;gBACzB,GAAG;gBACH,KAAK;aACN,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,eAAe,EAAE;gBACxB,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;aACxC;QACH,CAAC;KAAA;IAEK,gBAAgB,CAAC,GAAW;;YAChC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAC5C,KAAK,EAAE,IAAI,CAAC,aAAa;gBACzB,GAAG;aACJ,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,kBAAkB,EAAE;gBAC3B,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;aACpC;QACH,CAAC;KAAA;IAEK,YAAY,CAAC,KAAY;;YAC7B,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,gCAAgC,EAAE;gBACvD,KAAK,EAAE,IAAI,CAAC,aAAa;gBACzB,KAAK;aACN,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,cAAc,EAAE;gBACvB,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aAClC;QACH,CAAC;KAAA;IAEK,GAAG;;YACP,IAAI;gBACF,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBAC3C,KAAK,EAAE,IAAI,CAAC,aAAa;iBAC1B,CAAC,CAAC;gBAEH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE;oBAC1C,KAAK,EAAE,IAAI,CAAC,aAAa;iBAC1B,CAAC,CAAC;aACJ;YAAC,OAAO,KAAc,EAAE;gBACvB,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE;oBACzC,KAAK,EAAE,IAAI,CAAC,aAAa;oBACzB,KAAK;iBACN,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;aACb;QACH,CAAC;KAAA;IAES,aAAa;QACrB,wCAAwC;QACxC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,oEAAoE;QACpE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,sGAAsG;QACtG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAW,EAAE,KAAY,EAAE,EAAE,CACrD,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAC/B,CAAC;IACJ,CAAC;IAED,IAAc,MAAM;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,aAAa;QACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAChD,OAAO,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAGQ,wBAAM"}
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/worker/worker.ts"],"names":[],"mappings":"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"}

package/dist/wrappers/withContext.d.ts

@@ -1,3 +1,4 @@
 import { Job, JobData } from "bullmq";
 import { WorkerContext } from "../worker/worker";
-export declare function withContext<T = JobData>(workerContext: WorkerContext, executor: (job: Job<T>) => Promise<void>): (job: Job<T>) => Promise<void>;
+import { JobReturnValue } from "../types";
+export declare function withContext<T = JobData, ReturnValue = JobReturnValue>(workerContext: WorkerContext, executor: (job: Job<T>) => Promise<ReturnValue>): (job: Job<T>) => Promise<ReturnValue>;

package/dist/wrappers/withContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"withContext.js","sourceRoot":"","sources":["../../src/wrappers/withContext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gDAAwB;AACxB,4DAAyD;AAIzD,SAAgB,WAAW,CACzB,aAA4B,EAC5B,QAAwC;IAExC,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAsC,CAAC;QAChE,OAAO,aAAa,CAAC,aAAa,CAAC,GAAG,CACpC,GAAS,EAAE;YACT,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAA,EACD;YACE,MAAM,EAAE,aAAa,CAAC,UAAU;YAChC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE;YACtC,WAAW,EAAE,GAAG,IAAI,IAAA,cAAI,GAAE;YAC1B,cAAc,EAAE,GAAG,IAAI,IAAA,6BAAa,GAAE;YACtC,SAAS,EAAE,IAAA,cAAI,GAAE;SAClB,CACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAnBD,kCAmBC"}
+{"version":3,"file":"withContext.js","sourceRoot":"","sources":["../../src/wrappers/withContext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gDAAwB;AACxB,4DAAyD;AAKzD,SAAgB,WAAW,CACzB,aAA4B,EAC5B,QAA+C;IAE/C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,IAAsC,CAAC;QAChE,OAAO,aAAa,CAAC,aAAa,CAAC,GAAG,CACpC,GAAS,EAAE;YACT,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAA,EACD;YACE,MAAM,EAAE,aAAa,CAAC,UAAU;YAChC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE;YACtC,WAAW,EAAE,GAAG,IAAI,IAAA,cAAI,GAAE;YAC1B,cAAc,EAAE,GAAG,IAAI,IAAA,6BAAa,GAAE;YACtC,SAAS,EAAE,IAAA,cAAI,GAAE;SAClB,CACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAnBD,kCAmBC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanszp/queue",
-  "version": "9.2.3",
+  "version": "9.2.6",
   "description": "Workers and queues",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -26,11 +26,12 @@
   },
   "dependencies": {
     "@alanszp/audit": "^9.0.0",
+    "@alanszp/core": "^9.2.2",
     "@alanszp/logger": "^9.0.0",
     "@alanszp/shared-context": "^9.0.0",
     "bullmq": "^2.1.2",
     "ioredis": "^5.2.3",
     "lodash": "^4.17.21"
   },
-  "gitHead": "dcb2a6f5d6489dbcb67197d26b8da716ea3c9c97"
+  "gitHead": "a5e4b5c25d8acdbfdf1cfa07791c620cc0d2fff5"
 }

package/src/errors/JobCannotBePromotedError.ts

@@ -0,0 +1,32 @@
+import { BaseError, RenderableContext, RenderableError } from "@alanszp/errors";
+import { JobState } from "bullmq";
+
+export class JobCannotBePromotedError
+  extends BaseError
+  implements RenderableError
+{
+  public jobId: string;
+
+  public currentJobState: JobState | "unknown";
+
+  constructor(jobId: string, currentJobState: JobState | "unknown") {
+    super("JobCannotBePromotedError");
+    this.jobId = jobId;
+    this.currentJobState = currentJobState;
+  }
+
+  code(): string {
+    return "job_cannot_be_promoted_error";
+  }
+
+  renderMessage(): string {
+    return "Job not found";
+  }
+
+  context(): RenderableContext {
+    return {
+      jobId: this.jobId,
+      currentJobState: this.currentJobState,
+    };
+  }
+}

package/src/errors/JobNotFoundError.ts

@@ -0,0 +1,24 @@
+import { BaseError, RenderableContext, RenderableError } from "@alanszp/errors";
+
+export class JobNotFoundError extends BaseError implements RenderableError {
+  public jobId: string;
+
+  constructor(jobId: string) {
+    super("JobNotFoundError");
+    this.jobId = jobId;
+  }
+
+  code(): string {
+    return "job_not_found_error";
+  }
+
+  renderMessage(): string {
+    return "Job not found";
+  }
+
+  context(): RenderableContext {
+    return {
+      jobId: this.jobId,
+    };
+  }
+}

package/src/queue/createQueue.ts

@@ -4,13 +4,13 @@ import { ConnectionManager } from "../connectionManager";
 import { JobData, QueueOptions } from "../types";
 import { SharedContext } from "@alanszp/shared-context";
 
-export function createQueue<JobType = JobData>(
+export function createQueue<Data = JobData>(
   name: string,
   getContext: () => SharedContext,
   queueOptions?: QueueOptions
-): Queue {
+): Queue<Data> {
   const connection = ConnectionManager.getInstance().getConnection();
-  const queue = new Queue<JobType>(
+  const queue = new Queue<Data>(
     connection,
     name,
     ConnectionManager.getInstance().getServiceName(),

package/src/queue/queue.ts

@@ -1,14 +1,27 @@
-import { merge } from "lodash";
+import { capitalize, merge } from "lodash";
 import { Job, JobsOptions } from "bullmq";
+import { ListResult } from "@alanszp/core";
 import { SharedContext } from "@alanszp/shared-context";
-import { ConnectionOptions, JobData, QueueOptions, RawQueue } from "../types";
+import {
+  ConnectionOptions,
+  JobData,
+  JobReturnValue,
+  JobStateEnum,
+  JobTypeEnum,
+  QueueOptions,
+  RawQueue,
+} from "../types";
+import { JobNotFoundError } from "../errors/JobNotFoundError";
+import { JobCannotBePromotedError } from "../errors/JobCannotBePromotedError";
+import { ResultTypes } from "ioredis/built/utils/RedisCommander";
 
 const BULL_PREFIX = "b";
 
 const DEFAULT_COMPLETED_JOB_MAX_AGE_IN_SECONDS = 60 * 60 * 24 * 30;
 const DEFAULT_COMPLETED_JOB_MAX_COUNT = 500;
+const DEFAULT_FAILED_JOB_MAX_COUNT = 1000;
 
-export class Queue<JobType = JobData> {
+export class Queue<Data = JobData, ReturnValue = JobReturnValue> {
   private _queue: RawQueue;
 
   private name: string;
@@ -26,7 +39,7 @@ export class Queue<JobType = JobData> {
 
     this.getSharedContext = getSharedContext;
 
-    this._queue = new RawQueue<JobType>(name, {
+    this._queue = new RawQueue<Data>(name, {
       ...merge(
         {
           defaultJobOptions: {
@@ -34,6 +47,9 @@ export class Queue<JobType = JobData> {
               age: DEFAULT_COMPLETED_JOB_MAX_AGE_IN_SECONDS,
               count: DEFAULT_COMPLETED_JOB_MAX_COUNT,
             },
+            removeOnFail: {
+              count: DEFAULT_FAILED_JOB_MAX_COUNT,
+            },
             attempts: 3,
             backoff: {
               type: "exponential",
@@ -52,34 +68,109 @@ export class Queue<JobType = JobData> {
     return this.name;
   }
 
-  async publishJob(job: JobType, opts?: JobsOptions): Promise<Job<JobType>> {
+  async publishJob(
+    job: Data,
+    opts?: JobsOptions
+  ): Promise<Job<Data, ReturnValue>> {
     const context = this.getSharedContext();
     const lid = context.getLifecycleId();
     const lch = context.getLifecycleChain();
     return this.queue.add(this.name, { ...job, lid, lch }, opts);
   }
 
-  async publishBulkJob(jobDatas: JobType[]): Promise<Job<JobType>[]> {
+  async publishBulkJob(jobDatas: Data[]): Promise<Job<Data, ReturnValue>[]> {
     const jobs = jobDatas.map((data) => ({ name: this.name, data }));
     return this.queue.addBulk(jobs);
   }
 
   async publishBulkJobWithOptions(
-    jobDefinitions: { jobData: JobType; opts: JobsOptions }[]
-  ): Promise<void> {
+    jobDefinitions: { jobData: Data; opts: JobsOptions }[]
+  ): Promise<Job<Data, ReturnValue>[]> {
     const jobs = jobDefinitions.map(({ jobData: data, opts }) => ({
       name: this.name,
       data,
       opts,
     }));
-    await this.queue.addBulk(jobs);
+    return this.queue.addBulk(jobs);
+  }
+
+  private pageToStartEnd(pageNumber: number, pageSize: number) {
+    return {
+      start: (pageNumber - 1) * pageSize,
+      end: pageNumber * pageSize - 1,
+    };
+  }
+
+  public async getJobsAndCountByStatus(
+    statuses: JobTypeEnum[],
+    page: number = 1,
+    pageSize: number = 50,
+    ascending: boolean = false
+  ): Promise<ListResult<Job<Data, ReturnValue>>> {
+    const { start, end } = this.pageToStartEnd(page, pageSize);
+    const [total, elements] = await Promise.all([
+      this.queue.getJobCountByTypes(...statuses),
+      this.queue.getJobs(statuses, start, end, ascending),
+    ]);
+
+    return {
+      total,
+      elements,
+      page,
+      pageSize,
+    };
+  }
+
+  public async getJobCountByStatus(
+    statuses: JobTypeEnum[],
+    page: number = 1,
+    pageSize: number = 50
+  ): Promise<number> {
+    return this.queue.getJobCountByTypes(...statuses);
+  }
+
+  public async getJobsByStatus(
+    statuses: JobTypeEnum[],
+    page: number = 1,
+    pageSize: number = 50,
+    ascending: boolean = false
+  ): Promise<Job<Data, ReturnValue>[]> {
+    const { start, end } = this.pageToStartEnd(page, pageSize);
+    return this.queue.getJobs(statuses, start, end, ascending);
+  }
+
+  public async deleteJob(jobId: string) {
+    this.queue.remove(jobId);
+  }
+
+  public async getJob(
+    jobId: string
+  ): Promise<Job<Data, ReturnValue> | undefined> {
+    return this.queue.getJob(jobId);
+  }
+
+  public async getJobOrFail(jobId: string): Promise<Job<Data, ReturnValue>> {
+    const job = await this.queue.getJob(jobId);
+    if (!job) throw new JobNotFoundError(jobId);
+    return job;
+  }
+
+  public async changeDelayToJob(jobId: string, delayMs: number) {
+    const job = await this.getJobOrFail(jobId);
+
+    const state = await job.getState();
+    if (state !== JobStateEnum.DELAYED) {
+      throw new JobCannotBePromotedError(jobId, state);
+    }
+
+    job.changeDelay(delayMs);
   }
 
   async close(): Promise<void> {
     await this.queue.close();
   }
 
-  private get queue(): RawQueue<JobType> {
+  private get queue(): RawQueue<Data, ReturnValue> {
     return this._queue;
   }
 }

package/src/types.ts

@@ -7,9 +7,32 @@ export {
   WorkerOptions,
   Queue as RawQueue,
   QueueOptions,
+  JobState,
+  JobType,
   JobsOptions,
 } from "bullmq";
 
-// This may seems odd but actual Job data type from bullmq is any 🤷‍♂️
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export type JobData = any;
+export type JobData = unknown;
+
+export type JobReturnValue = unknown;
+
+export enum JobStateEnum {
+  ACTIVE = "active",
+  DELAYED = "delayed",
+  WAITING = "waiting",
+  COMPLETED = "completed",
+  FAILED = "failed",
+  WAITING_CHILDREN = "waiting-children",
+}
+
+export enum JobTypeEnum {
+  ACTIVE = "active",
+  DELAYED = "delayed",
+  WAITING = "waiting",
+  COMPLETED = "completed",
+  FAILED = "failed",
+  WAITING_CHILDREN = "waiting-children",
+  PAUSED = "paused",
+  REPEAT = "repeat",
+  WAIT = "wait",
+}

package/src/worker/worker.ts

@@ -1,6 +1,12 @@
 import { ILogger } from "@alanszp/logger";
 import { ConnectionManager } from "../connectionManager";
-import { JobData, Job, RawWorker, WorkerOptions } from "../types";
+import {
+  JobData,
+  Job,
+  RawWorker,
+  WorkerOptions,
+  JobReturnValue,
+} from "../types";
 import { SharedContext } from "@alanszp/shared-context";
 import { Audit } from "@alanszp/audit";
 import { withContext } from "../wrappers/withContext";
@@ -23,9 +29,12 @@ export interface WorkerContext {
 
 // optional methods
 
-interface Worker<T = JobData> {
-  handleJobFailed?(job: Job<T>, error: Error): Promise<void> | void;
-  handleJobCompleted?(job: Job<T>): Promise<void> | void;
+interface Worker<Data = JobData, ReturnValue = JobReturnValue> {
+  handleJobFailed?(
+    job: Job<Data, ReturnValue>,
+    error: Error
+  ): Promise<void> | void;
+  handleJobCompleted?(job: Job<Data, ReturnValue>): Promise<void> | void;
   handleJobError?(error: Error): Promise<void> | void;
 }
 
@@ -33,7 +42,7 @@ type QueueName = { name: string; prefix: string; namespace: string };
 
 const BULL_PREFIX = "b";
 
-abstract class Worker<T = JobData> {
+abstract class Worker<Data = JobData, ReturnValue = unknown> {
   private _worker: RawWorker;
 
   private _queue: QueueName;
@@ -48,7 +57,7 @@ abstract class Worker<T = JobData> {
 
     const prefix = connectionManager.getServiceName();
     this._queue = { name, prefix, namespace: BULL_PREFIX };
-    this._worker = new RawWorker<T>(name, this.processJob(), {
+    this._worker = new RawWorker<Data, ReturnValue>(name, this.processJob(), {
       autorun: false,
       connection: connectionManager.getConnection(),
       prefix: `{${prefix}}:${BULL_PREFIX}`,
@@ -60,7 +69,7 @@ abstract class Worker<T = JobData> {
   }
 
   // Handle job
-  abstract process(job: Job<T>): Promise<void>;
+  abstract process(job: Job<Data, ReturnValue>): Promise<ReturnValue>;
 
   abstract setup(): WorkerSetup;
 
@@ -78,17 +87,20 @@ abstract class Worker<T = JobData> {
     return this.worker.id;
   }
 
-  private processJob(): (job: Job<T>) => Promise<void> {
+  private processJob(): (job: Job<Data, ReturnValue>) => Promise<ReturnValue> {
     return withContext(this.getContext(), async (job) => {
       this.getLogger().info(`worker.process.job_received`, {
         queue: this.queueFullName,
         job,
       });
-      await this.process(job);
+      return this.process(job);
     });
   }
 
-  async processFailed(job: Job<T>, error: Error): Promise<void> {
+  async processFailed(
+    job: Job<Data, ReturnValue>,
+    error: Error
+  ): Promise<void> {
     this.getLogger().warn("worker.job.failed", {
       queue: this.queueFullName,
       job,
@@ -99,10 +111,14 @@ abstract class Worker<T = JobData> {
     }
   }
 
-  async processCompleted(job: Job<T>): Promise<void> {
+  async processCompleted(
+    job: Job<Data, ReturnValue>,
+    returnValue: ReturnValue
+  ): Promise<void> {
     this.getLogger().info("worker.job.completed", {
       queue: this.queueFullName,
       job,
+      returnValue,
     });
     if (this.handleJobCompleted) {
       await this.handleJobCompleted(job);
@@ -142,9 +158,13 @@ abstract class Worker<T = JobData> {
     // on error: handle unhandled exceptions
     this.worker.on("error", (error: Error) => this.processError(error));
     // on completed: allow to do something else after a job is completed
-    this.worker.on("completed", (job: Job<T>) => this.processCompleted(job));
+    this.worker.on(
+      "completed",
+      (job: Job<Data, ReturnValue>, result: ReturnValue) =>
+        this.processCompleted(job, result)
+    );
     // on failed: when the process fails with an exception it is possible to listen for the "failed" event
-    this.worker.on("failed", (job: Job<T>, error: Error) =>
+    this.worker.on("failed", (job: Job<Data, ReturnValue>, error: Error) =>
       this.processFailed(job, error)
     );
   }

package/src/wrappers/withContext.ts

@@ -2,11 +2,12 @@ import cuid from "cuid";
 import { appIdentifier } from "../helpers/appIdentifier";
 import { Job, JobData } from "bullmq";
 import { WorkerContext } from "../worker/worker";
+import { JobReturnValue } from "../types";
 
-export function withContext<T = JobData>(
+export function withContext<T = JobData, ReturnValue = JobReturnValue>(
   workerContext: WorkerContext,
-  executor: (job: Job<T>) => Promise<void>
-): (job: Job<T>) => Promise<void> {
+  executor: (job: Job<T>) => Promise<ReturnValue>
+): (job: Job<T>) => Promise<ReturnValue> {
   return (job) => {
     const { lid, lch } = job.data as { lid?: string; lch?: string };
     return workerContext.sharedContext.run(