@alanszp/queue 9.2.4 → 9.3.0

package/dist/reporter/totalCount/JobTotalCountReporter.d.ts

@@ -0,0 +1,12 @@
+import { Job } from "../../types";
+import { ITotalCountReporter } from "./ITotalCountReporter";
+export declare class JobTotalCountReporter<JobInstance extends Job> implements ITotalCountReporter {
+    private total;
+    private current;
+    private job;
+    constructor(job: JobInstance);
+    setTotal(total: number): void;
+    increment(n?: number): void;
+    reset(value?: number): void;
+    report(): void;
+}

package/dist/reporter/totalCount/JobTotalCountReporter.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobTotalCountReporter = void 0;
+class JobTotalCountReporter {
+    constructor(job) {
+        this.total = 1;
+        this.current = 0;
+        this.job = job;
+    }
+    setTotal(total) {
+        this.total = total;
+        this.reset();
+    }
+    increment(n) {
+        this.current += n !== null && n !== void 0 ? n : 1;
+        this.report();
+    }
+    reset(value) {
+        this.current = value !== null && value !== void 0 ? value : 0;
+        this.report();
+    }
+    report() {
+        this.job
+            .updateProgress({ total: this.total, current: this.current })
+            .catch(() => { });
+    }
+}
+exports.JobTotalCountReporter = JobTotalCountReporter;
+//# sourceMappingURL=JobTotalCountReporter.js.map

package/dist/reporter/totalCount/JobTotalCountReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobTotalCountReporter.js","sourceRoot":"","sources":["../../../src/reporter/totalCount/JobTotalCountReporter.ts"],"names":[],"mappings":";;;AAGA,MAAa,qBAAqB;IAShC,YAAY,GAAgB;QANpB,UAAK,GAAG,CAAC,CAAC;QAEV,YAAO,GAAG,CAAC,CAAC;QAKlB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,SAAS,CAAC,CAAU;QAClB,IAAI,CAAC,OAAO,IAAI,CAAC,aAAD,CAAC,cAAD,CAAC,GAAI,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,OAAO,GAAG,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,GAAG;aACL,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aAC5D,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrB,CAAC;CACF;AAjCD,sDAiCC"}

package/dist/reporter/totalCount/MockTotalCountReporter.d.ts

@@ -0,0 +1,8 @@
+import { ITotalCountReporter } from "./ITotalCountReporter";
+export declare class MockTotalCountReporter implements ITotalCountReporter {
+    private total;
+    private progress;
+    setTotal(total: number): void;
+    increment(n?: number): void;
+    reset(value?: number): void;
+}

package/dist/reporter/totalCount/MockTotalCountReporter.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockTotalCountReporter = void 0;
+class MockTotalCountReporter {
+    constructor() {
+        this.total = 1;
+        this.progress = 0;
+    }
+    setTotal(total) {
+        this.total = total;
+        this.reset();
+    }
+    increment(n) {
+        this.progress += n !== null && n !== void 0 ? n : 1;
+    }
+    reset(value) {
+        this.progress = value !== null && value !== void 0 ? value : 0;
+    }
+}
+exports.MockTotalCountReporter = MockTotalCountReporter;
+//# sourceMappingURL=MockTotalCountReporter.js.map

package/dist/reporter/totalCount/MockTotalCountReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockTotalCountReporter.js","sourceRoot":"","sources":["../../../src/reporter/totalCount/MockTotalCountReporter.ts"],"names":[],"mappings":";;;AAEA,MAAa,sBAAsB;IAAnC;QACU,UAAK,GAAG,CAAC,CAAC;QAEV,aAAQ,GAAG,CAAC,CAAC;IAcvB,CAAC;IAZC,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,SAAS,CAAC,CAAU;QAClB,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAD,CAAC,cAAD,CAAC,GAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,QAAQ,GAAG,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAjBD,wDAiBC"}

package/dist/types.d.ts

@@ -1,3 +1,22 @@
-export { ConnectionOptions, RedisOptions, Job, Worker as RawWorker, WorkerOptions, Queue as RawQueue, QueueOptions, JobsOptions, } from "bullmq";
+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/workerRepository.d.ts

@@ -1,5 +1,5 @@
 import { Worker, WorkerStatus } from "./worker";
-export declare type WokerStatusWithId = {
+export declare type WorkerStatusWithId = {
     status: WorkerStatus;
 } & {
     id: string;
@@ -16,7 +16,7 @@ export declare class WorkerRepository {
     static get Instance(): WorkerRepository;
     registerWorker(queueName: string, workerClass: WorkerClass): WorkerRepository;
     getWorkersByQueues(queueNames: string[]): Worker[];
-    getWorkerStatuses(): WokerStatusWithId[];
+    getWorkerStatuses(): WorkerStatusWithId[];
     getCloseConnections(): Promise<void>[];
     private get workers();
     private get activeWorkers();

package/dist/worker/workerRepository.js

@@ -32,12 +32,17 @@ class WorkerRepository {
                 this._activeWorkers.push(worker);
                 return worker;
             }
-            this.getLogger().warn("worker_repository.invalid_queue_name", { queueName });
+            this.getLogger().warn("worker_repository.invalid_queue_name", {
+                queueName,
+            });
             return null;
         }));
     }
     getWorkerStatuses() {
-        return this.activeWorkers.map((worker) => ({ id: worker.id, status: worker.status }));
+        return this.activeWorkers.map((worker) => ({
+            id: worker.id,
+            status: worker.status,
+        }));
     }
     getCloseConnections() {
         return this.activeWorkers.map((worker) => worker.close());

package/dist/worker/workerRepository.js.map

@@ -1 +1 @@
-{"version":3,"file":"workerRepository.js","sourceRoot":"","sources":["../../src/worker/workerRepository.ts"],"names":[],"mappings":";;;AACA,mCAA0C;AAC1C,4DAAyD;AASzD,MAAa,gBAAgB;IAS3B;QACE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,qCAAiB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;IAC7D,CAAC;IAEM,MAAM,KAAK,QAAQ;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC;SACvB;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,cAAc,CAAC,SAAiB,EAAE,WAAwB;QAC/D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB,CAAC,UAAoB;QACrC,IAAI,IAAA,gBAAO,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACzB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YACrE,OAAO,EAAE,CAAC;SACX;QAED,OAAO,IAAA,gBAAO,EACZ,UAAU,CAAC,GAAG,CAAC,CAAC,SAAiB,EAAE,EAAE;YACnC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;gBAC3B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7C,oEAAoE;gBACpE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjC,OAAO,MAAM,CAAC;aACf;YACD,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAEM,mBAAmB;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AA/DD,4CA+DC"}
+{"version":3,"file":"workerRepository.js","sourceRoot":"","sources":["../../src/worker/workerRepository.ts"],"names":[],"mappings":";;;AACA,mCAA0C;AAC1C,4DAAyD;AASzD,MAAa,gBAAgB;IAS3B;QACE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,qCAAiB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC;IAC7D,CAAC;IAEM,MAAM,KAAK,QAAQ;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC;SACvB;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,cAAc,CACnB,SAAiB,EACjB,WAAwB;QAExB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB,CAAC,UAAoB;QACrC,IAAI,IAAA,gBAAO,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACzB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YACrE,OAAO,EAAE,CAAC;SACX;QAED,OAAO,IAAA,gBAAO,EACZ,UAAU,CAAC,GAAG,CAAC,CAAC,SAAiB,EAAE,EAAE;YACnC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;gBAC3B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7C,oEAAoE;gBACpE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjC,OAAO,MAAM,CAAC;aACf;YACD,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,sCAAsC,EAAE;gBAC5D,SAAS;aACV,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC,CAAC;IACN,CAAC;IAEM,mBAAmB;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAY,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF;AAvED,4CAuEC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanszp/queue",
-  "version": "9.2.4",
+  "version": "9.3.0",
   "description": "Workers and queues",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -20,17 +20,20 @@
   },
   "devDependencies": {
     "@types/node": "^15.12.3",
+    "class-validator": "^0.13.1",
     "ts-node": "^10.0.0",
     "tslint": "^6.1.3",
     "typescript": "^4.3.4"
   },
   "dependencies": {
     "@alanszp/audit": "^9.0.0",
+    "@alanszp/core": "^9.2.2",
     "@alanszp/logger": "^9.0.0",
     "@alanszp/shared-context": "^9.0.0",
+    "@alanszp/validations": "^9.0.0",
     "bullmq": "^2.1.2",
     "ioredis": "^5.2.3",
     "lodash": "^4.17.21"
   },
-  "gitHead": "0f35519e3073a3b4aa2b0060303eacf228d321ee"
+  "gitHead": "01f4cf7780357778908e8d40007747d8aa580c70"
 }

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/jobsManagement/commands/asyncCreationCommands.ts

@@ -0,0 +1,58 @@
+import { ILogger } from "@alanszp/logger";
+import { BaseModel } from "@alanszp/validations";
+import { CreateAsyncJobInput } from "../inputs/CreateAsyncJobInput";
+import { Queue } from "../../queue/queue";
+import { Job } from "../../types";
+
+export async function asyncJobCreationCommand<
+  QueueInputBody,
+  RealInput extends BaseModel & QueueInputBody,
+  AsyncInput extends CreateAsyncJobInput<RealInput>
+>(
+  logger: ILogger,
+  queue: Queue<QueueInputBody>,
+  input: AsyncInput
+): Promise<Job<QueueInputBody>> {
+  const child = logger.child({
+    input,
+    queueName: queue.getName(),
+  });
+
+  child.info("worker.async.create_job.starting");
+  await input.validate();
+
+  child.debug("worker.async.create_job.validated");
+
+  const job = await queue.publishJob(input.asyncInput, {
+    delay: input.getDelayInMs(),
+  });
+
+  child.debug("worker.async.create_job.succeed", { jobId: job.id });
+
+  return job;
+}
+
+export async function immediateExecutionJobCreationCommand<
+  QueueInputBody,
+  RealInput extends QueueInputBody & BaseModel
+>(
+  logger: ILogger,
+  queue: Queue<QueueInputBody>,
+  input: RealInput
+): Promise<Job<QueueInputBody>> {
+  const child = logger.child({
+    input,
+    queueName: queue.getName(),
+  });
+
+  child.info("worker.async.create_job.starting");
+  await input.validate();
+
+  child.debug("worker.async.create_job.validated");
+
+  const job = await queue.publishJob(input);
+
+  child.debug("worker.async.create_job.succeed", { jobId: job.id });
+
+  return job;
+}

package/src/jobsManagement/commands/getCommands.ts

@@ -0,0 +1,57 @@
+import { ILogger } from "@alanszp/logger";
+import { GetJobInput } from "../inputs/GetJobInput";
+import { SearchJobsInput } from "../inputs/SearchJobsInput";
+import { ListResult } from "@alanszp/core";
+import { Queue } from "../../queue/queue";
+import { Job } from "../../types";
+
+export async function getJobStatus<QueueInputBody, ReturnValue>(
+  logger: ILogger,
+  queue: Queue<QueueInputBody, ReturnValue>,
+  input: GetJobInput
+): Promise<Job<QueueInputBody, ReturnValue> | undefined> {
+  const child = logger.child({
+    input,
+    queueName: queue.getName(),
+  });
+
+  child.info("worker.get_job.starting");
+  await input.validate();
+
+  child.debug("worker.get_job.validated");
+
+  const job = await queue.getJobOrFail(input.jobId);
+
+  child.info("worker.get_job.succeed", { jobId: job?.id ?? null });
+
+  return job;
+}
+
+export async function searchJobsCommand<QueueInputBody, ReturnValue>(
+  logger: ILogger,
+  queue: Queue<QueueInputBody, ReturnValue>,
+  input: SearchJobsInput
+): Promise<ListResult<Job<QueueInputBody, ReturnValue>>> {
+  const child = logger.child({
+    input,
+    queueName: queue.getName(),
+  });
+
+  child.info("worker.get_job.starting");
+  await input.validate();
+
+  child.debug("worker.get_job.validated");
+
+  const jobs = await queue.getJobsAndCountByStatus(
+    input.status,
+    input.page,
+    input.pageSize
+  );
+
+  child.info("worker.get_job.succeed", {
+    jobTotal: jobs.total,
+    jobInPage: jobs.elements.length,
+  });
+
+  return jobs;
+}

package/src/jobsManagement/commands/workerHealthCommand.ts

@@ -0,0 +1,10 @@
+import {
+  WorkerStatusWithId,
+  WorkerRepository,
+} from "../../worker/workerRepository";
+
+export function workerHealthCommand(): WorkerStatusWithId[] {
+  const statuses = WorkerRepository.Instance.getWorkerStatuses();
+
+  return statuses;
+}

package/src/jobsManagement/index.ts

@@ -0,0 +1,6 @@
+export * from "./inputs/CreateAsyncJobInput";
+export * from "./inputs/GetJobInput";
+export * from "./inputs/SearchJobsInput";
+export * from "./commands/asyncCreationCommands";
+export * from "./commands/getCommands";
+export * from "./commands/workerHealthCommand";

package/src/jobsManagement/inputs/CreateAsyncJobInput.ts

@@ -0,0 +1,37 @@
+import { IsDateString, IsDefined, IsOptional } from "class-validator";
+import { BaseModel } from "@alanszp/validations";
+import { differenceInMilliseconds } from "date-fns";
+
+export interface CreateAsyncJobQueryParams {
+  executeOn?: string;
+}
+
+export class CreateAsyncJobInput<
+  RealInput extends BaseModel
+> extends BaseModel {
+  @IsDateString()
+  @IsOptional()
+  public executeOn?: string;
+
+  @IsDefined()
+  public asyncInput: RealInput;
+
+  constructor(asyncParams: CreateAsyncJobQueryParams, asyncInput: RealInput) {
+    super();
+    this.executeOn = asyncParams.executeOn;
+    this.asyncInput = asyncInput;
+  }
+
+  async validate(): Promise<void> {
+    await super.validate();
+
+    await this.asyncInput.validate();
+  }
+
+  getDelayInMs(): number | undefined {
+    if (!this.executeOn) return undefined;
+    const date = new Date(this.executeOn);
+    const delay = differenceInMilliseconds(date, new Date());
+    return delay > 0 ? delay : undefined;
+  }
+}

package/src/jobsManagement/inputs/GetJobInput.ts

@@ -0,0 +1,17 @@
+import { IsDefined, IsString } from "class-validator";
+import { BaseModel } from "@alanszp/validations";
+
+export class GetJobInput extends BaseModel {
+  @IsDefined()
+  @IsString()
+  public jobId: string;
+
+  constructor(jobId: string) {
+    super();
+    this.jobId = jobId;
+  }
+
+  async validate(): Promise<void> {
+    await super.validate();
+  }
+}

package/src/jobsManagement/inputs/SearchJobsInput.ts

@@ -0,0 +1,45 @@
+import {
+  IsDefined,
+  IsArray,
+  IsEnum,
+  IsNumber,
+  Min,
+  Max,
+} from "class-validator";
+import { BaseModel } from "@alanszp/validations";
+import { JobTypeEnum } from "../../types";
+import { assignPaginableKeys } from "@alanszp/core";
+
+export interface SearchJobInputProps {
+  status: JobTypeEnum[];
+  page?: string | number;
+  pageSize?: number;
+}
+
+export class SearchJobsInput extends BaseModel {
+  @IsDefined()
+  @IsArray()
+  @IsEnum(JobTypeEnum, { each: true })
+  public status: JobTypeEnum[];
+
+  @IsDefined()
+  @IsNumber()
+  @Min(1)
+  public page: number;
+
+  @IsDefined()
+  @IsNumber()
+  @Min(1)
+  @Max(100)
+  public pageSize: number;
+
+  constructor({ status, page, pageSize }: SearchJobInputProps) {
+    super();
+    this.status = status;
+    assignPaginableKeys(this, { page, pageSize });
+  }
+
+  async validate(): Promise<void> {
+    await super.validate();
+  }
+}

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(),