@shrub/queue 0.5.68 → 0.5.71

package/dist/queue.d.ts

@@ -1,15 +1,15 @@
 import { IEvent } from "@sprig/event-emitter";
-export declare type WorkerCallback<TData = any> = (job: IJob<TData>) => Promise<void | any>;
+export declare type WorkerCallback<TData = any, TReturnValue = any> = (job: IJob<TData, TReturnValue>) => Promise<void | TReturnValue>;
 /** Defines the API for a queue. */
-export interface IQueue {
+export interface IQueue<TData = any, TReturnValue = any> {
     /** The name of the queue. */
     readonly name: string;
     /** Adds a job to the queue. */
-    add<TData = any>(options: IJobOptions<TData>): Promise<IJob<TData>>;
+    add(options: IJobOptions<TData>): Promise<IJob<TData, TReturnValue>>;
     /** Closes the queue and all workers associated with the queue. */
     close(): Promise<void>;
     /** Creates a new worker for handling/processing jobs. */
-    createWorker<TData = any>(optionsOrCallback: IWorkerOptions<TData> | WorkerCallback<TData>): IWorker;
+    createWorker(optionsOrCallback: IWorkerOptions<TData> | WorkerCallback<TData, TReturnValue>): IWorker;
     /** Waits until the queue is ready for processing. */
     waitUntilReady(): Promise<void>;
 }
@@ -19,7 +19,7 @@ export interface IQueueAdapter {
     getQueue(name: string): IQueue | undefined;
 }
 /** Represents a specific instance of a job in the queue. */
-export interface IJob<TData = any> {
+export interface IJob<TData = any, TReturnValue = any> {
     readonly id: string;
     readonly name: string;
     readonly data: TData;
@@ -28,7 +28,7 @@ export interface IJob<TData = any> {
     readonly isFailed: Promise<boolean>;
     readonly progress: number | object;
     updateProgress(progress: number | object): Promise<void>;
-    waitUntilFinished(): Promise<any>;
+    waitUntilFinished(): Promise<TReturnValue>;
 }
 /** Defines options for creating jobs. */
 export interface IJobOptions<TData = any> {
@@ -51,40 +51,40 @@ export interface IJobRepeatOptions {
     readonly immediate?: boolean;
 }
 /** Defines options for registering a process for handling jobs. */
-export interface IWorkerOptions<TData = any> {
+export interface IWorkerOptions<TData = any, TReturnValue = any> {
     /** A callback for handling jobs. */
-    readonly callback: WorkerCallback<TData>;
+    readonly callback: WorkerCallback<TData, TReturnValue>;
     /** Optionally specifies the maximum number of parallel jobs that can be processed at once; if not specified, the underlying queue's default will be used. */
     readonly concurrency?: number;
 }
 /** Defines a worker responsible for processing jobs. */
-export interface IWorker {
+export interface IWorker<TData = any, TReturnValue = any> {
     /** An event that is raised when a job has becomes active. */
-    readonly onJobActive: IEvent<IJobActiveEventArgs>;
+    readonly onJobActive: IEvent<IJobActiveEventArgs<TData, TReturnValue>>;
     /** An event that is raised when a job has completed. */
-    readonly onJobCompleted: IEvent<IJobCompletedEventArgs>;
+    readonly onJobCompleted: IEvent<IJobCompletedEventArgs<TData, TReturnValue>>;
     /** An event that is raised when a job has failed. */
-    readonly onJobFailed: IEvent<IJobFailedEventArgs>;
+    readonly onJobFailed: IEvent<IJobFailedEventArgs<TData, TReturnValue>>;
     /** An event that is raised when a job has reported progress. */
-    readonly onJobProgress: IEvent<IJobProgressEventArgs>;
+    readonly onJobProgress: IEvent<IJobProgressEventArgs<TData, TReturnValue>>;
     /** Closes the worker and all underlying connections. */
     close(): Promise<void>;
     /** Waits until the worker is ready for processing. */
     waitUntilReady(): Promise<void>;
 }
-export interface IJobActiveEventArgs {
-    readonly job: IJob;
+export interface IJobActiveEventArgs<TData = any, TReturnValue = any> {
+    readonly job: IJob<TData, TReturnValue>;
 }
-export interface IJobCompletedEventArgs {
-    readonly job: IJob;
+export interface IJobCompletedEventArgs<TData = any, TReturnValue = any> {
+    readonly job: IJob<TData, TReturnValue>;
     readonly returnValue: any;
 }
-export interface IJobFailedEventArgs {
-    readonly job: IJob;
+export interface IJobFailedEventArgs<TData = any, TReturnValue = any> {
+    readonly job: IJob<TData, TReturnValue>;
     readonly error: Error;
 }
-export interface IJobProgressEventArgs {
-    readonly job: IJob;
+export interface IJobProgressEventArgs<TData = any, TReturnValue = any> {
+    readonly job: IJob<TData, TReturnValue>;
     readonly progress: number | object;
 }
 /** Base class for a queue adapter that accepts a set of names/patterns defining the queue(s) the adapter supports. */

package/dist/service.d.ts

@@ -1,5 +1,9 @@
 import { IQueue } from "./queue";
 export interface IQueueService {
-    getQueue(name: string): IQueue;
+    getQueue<TData = any, TReturnValue = any>(name: string | IQueueName<TData, TReturnValue>): IQueue<TData, TReturnValue>;
 }
+export interface IQueueName<TData = any, TReturnValue = any> {
+    readonly name: string;
+}
+export declare const createQueueName: <TData = any, TReturnValue = any>(name: string) => IQueueName<TData, TReturnValue>;
 export declare const IQueueService: import("@shrub/core").IService<IQueueService>;

package/dist/service.js

@@ -6,9 +6,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueService = exports.IQueueAdapterService = exports.IQueueService = void 0;
+exports.QueueService = exports.IQueueAdapterService = exports.IQueueService = exports.createQueueName = void 0;
 const core_1 = require("@shrub/core");
 const queue_1 = require("./queue");
+const createQueueName = (name) => ({ name });
+exports.createQueueName = createQueueName;
 exports.IQueueService = core_1.createService("queue-service");
 /** @internal */
 exports.IQueueAdapterService = core_1.createService("queue-adapter-service");
@@ -17,7 +19,8 @@ let QueueService = class QueueService {
     constructor() {
         this.adapters = new queue_1.QueueAdapterCollection();
     }
-    getQueue(name) {
+    getQueue(queueName) {
+        const name = typeof queueName === "string" ? queueName : queueName.name;
         const queue = this.adapters.asQueueAdapter().getQueue(name);
         if (!queue) {
             throw new Error(`No queue adapter found to handle queue with name (${name}).`);
@@ -32,4 +35,4 @@ QueueService = __decorate([
     core_1.Singleton
 ], QueueService);
 exports.QueueService = QueueService;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9zZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLHNDQUF1RDtBQUN2RCxtQ0FBd0U7QUFZM0QsUUFBQSxhQUFhLEdBQUcsb0JBQWEsQ0FBZ0IsZUFBZSxDQUFDLENBQUM7QUFFM0UsZ0JBQWdCO0FBQ0gsUUFBQSxvQkFBb0IsR0FBRyxvQkFBYSxDQUF1Qix1QkFBdUIsQ0FBQyxDQUFDO0FBRWpHLGdCQUFnQjtBQUVoQixJQUFhLFlBQVksR0FBekIsTUFBYSxZQUFZO0lBQXpCO1FBQ3FCLGFBQVEsR0FBRyxJQUFJLDhCQUFzQixFQUFFLENBQUM7SUFlN0QsQ0FBQztJQWJHLFFBQVEsQ0FBQyxJQUFZO1FBQ2pCLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxRQUFRLENBQUMsY0FBYyxFQUFFLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBRTVELElBQUksQ0FBQyxLQUFLLEVBQUU7WUFDUixNQUFNLElBQUksS0FBSyxDQUFDLHFEQUFxRCxJQUFJLElBQUksQ0FBQyxDQUFDO1NBQ2xGO1FBRUQsT0FBTyxLQUFLLENBQUM7SUFDakIsQ0FBQztJQUVELFFBQVEsQ0FBQyxPQUFzQjtRQUMzQixJQUFJLENBQUMsUUFBUSxDQUFDLGVBQWUsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUMzQyxDQUFDO0NBQ0osQ0FBQTtBQWhCWSxZQUFZO0lBRHhCLGdCQUFTO0dBQ0csWUFBWSxDQWdCeEI7QUFoQlksb0NBQVkifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9zZXJ2aWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLHNDQUF1RDtBQUN2RCxtQ0FBd0U7QUFnQmpFLE1BQU0sZUFBZSxHQUFHLENBQWtDLElBQVksRUFBbUMsRUFBRSxDQUFDLENBQUMsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0FBQWpILFFBQUEsZUFBZSxtQkFBa0c7QUFFakgsUUFBQSxhQUFhLEdBQUcsb0JBQWEsQ0FBZ0IsZUFBZSxDQUFDLENBQUM7QUFFM0UsZ0JBQWdCO0FBQ0gsUUFBQSxvQkFBb0IsR0FBRyxvQkFBYSxDQUF1Qix1QkFBdUIsQ0FBQyxDQUFDO0FBRWpHLGdCQUFnQjtBQUVoQixJQUFhLFlBQVksR0FBekIsTUFBYSxZQUFZO0lBQXpCO1FBQ3FCLGFBQVEsR0FBRyxJQUFJLDhCQUFzQixFQUFFLENBQUM7SUFnQjdELENBQUM7SUFkRyxRQUFRLENBQUMsU0FBOEI7UUFDbkMsTUFBTSxJQUFJLEdBQUcsT0FBTyxTQUFTLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUM7UUFDeEUsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQyxjQUFjLEVBQUUsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFNUQsSUFBSSxDQUFDLEtBQUssRUFBRTtZQUNSLE1BQU0sSUFBSSxLQUFLLENBQUMscURBQXFELElBQUksSUFBSSxDQUFDLENBQUM7U0FDbEY7UUFFRCxPQUFPLEtBQUssQ0FBQztJQUNqQixDQUFDO0lBRUQsUUFBUSxDQUFDLE9BQXNCO1FBQzNCLElBQUksQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzNDLENBQUM7Q0FDSixDQUFBO0FBakJZLFlBQVk7SUFEeEIsZ0JBQVM7R0FDRyxZQUFZLENBaUJ4QjtBQWpCWSxvQ0FBWSJ9

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@shrub/queue",
     "description": "Provides a basic abstraction and support for job/task queues.",
-    "version": "0.5.68",
+    "version": "0.5.71",
     "license": "MIT",
     "repository": {
         "type": "git",
@@ -25,9 +25,9 @@
         "test": "jest"
     },
     "dependencies": {
-        "@shrub/core": "0.5.68",
-        "@shrub/logging": "0.5.68",
-        "@sprig/event-emitter": "^0.2.1"
+        "@shrub/core": "0.5.71",
+        "@shrub/logging": "0.5.71",
+        "@sprig/event-emitter": "^0.2.2"
     },
-    "gitHead": "5cd38a0008a78426f1d43526db577eea75407b9f"
+    "gitHead": "d9539767f177e4f88d1daccb3205c39316056587"
 }