@orchestr-sh/orchestr 1.7.4 → 1.8.0

package/dist/Console/Commands/QueueWorkCommand.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * QueueWorkCommand
+ *
+ * Start processing jobs on the queue as a daemon.
+ * Mirrors Laravel's `php artisan queue:work`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueWorkCommand = void 0;
+const Command_1 = require("../Command");
+class QueueWorkCommand extends Command_1.Command {
+    app;
+    signature = 'queue:work [connection]';
+    description = 'Start processing jobs on the queue as a daemon';
+    constructor(app) {
+        super();
+        this.app = app;
+    }
+    async handle(args, options) {
+        const manager = this.app.make('queue');
+        const worker = this.app.make('queue.worker');
+        const connection = args[0] || manager.getDefaultConnection();
+        const queues = options.queue || 'default';
+        const once = options.once === true || options.once === 'true';
+        this.info(`[${new Date().toISOString()}] Processing jobs from the [${queues}] queue(s) on [${connection}] connection.`);
+        const workerOptions = {
+            name: options.name || 'default',
+            sleep: Number(options.sleep) || 3,
+            tries: Number(options.tries) || 1,
+            timeout: Number(options.timeout) || 60,
+            memory: Number(options.memory) || 128,
+            maxJobs: Number(options['max-jobs']) || 0,
+            maxTime: Number(options['max-time']) || 0,
+            force: options.force === true || options.force === 'true',
+            stopWhenEmpty: options['stop-when-empty'] === true || options['stop-when-empty'] === 'true',
+            backoff: Number(options.backoff) || 0,
+            rest: Number(options.rest) || 0,
+        };
+        if (once) {
+            const processed = await worker.runOnce(connection, queues, workerOptions);
+            if (!processed) {
+                this.comment('No jobs available.');
+            }
+            return;
+        }
+        await worker.daemon(connection, queues, workerOptions);
+        this.info('Worker stopped.');
+    }
+}
+exports.QueueWorkCommand = QueueWorkCommand;
+//# sourceMappingURL=QueueWorkCommand.js.map

package/dist/Console/Commands/QueueWorkCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueWorkCommand.js","sourceRoot":"","sources":["../../../src/Console/Commands/QueueWorkCommand.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,wCAAqD;AAKrD,MAAa,gBAAiB,SAAQ,iBAAO;IAIrB;IAHtB,SAAS,GAAG,yBAAyB,CAAC;IACtC,WAAW,GAAG,gDAAgD,CAAC;IAE/D,YAAsB,GAAgB;QACpC,KAAK,EAAE,CAAC;QADY,QAAG,GAAH,GAAG,CAAa;IAEtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAc,EAAE,OAAuB;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAS,cAAc,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAI,OAAO,CAAC,KAAgB,IAAI,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;QAE9D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,+BAA+B,MAAM,kBAAkB,UAAU,eAAe,CAAC,CAAC;QAExH,MAAM,aAAa,GAAG;YACpB,IAAI,EAAG,OAAO,CAAC,IAAe,IAAI,SAAS;YAC3C,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YACzC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;YACzD,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,KAAK,MAAM;YAC3F,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACrC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SAChC,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;YAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACrC,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;CACF;AA3CD,4CA2CC"}

package/dist/Facades/Bus.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Bus Facade
+ *
+ * Provides static access to the command bus for dispatching jobs,
+ * chains, and batches.
+ *
+ * @example
+ * ```typescript
+ * // Dispatch a job
+ * await Bus.dispatch(new ProcessPodcast(podcastId));
+ *
+ * // Dispatch synchronously
+ * await Bus.dispatchSync(new ProcessPodcast(podcastId));
+ *
+ * // Chain jobs
+ * await Bus.chain([
+ *   new ProcessPodcast(id),
+ *   new OptimizePodcast(id),
+ *   new ReleasePodcast(id),
+ * ]).dispatch();
+ *
+ * // Batch jobs
+ * const batch = await Bus.batch([
+ *   new ProcessPodcast(1),
+ *   new ProcessPodcast(2),
+ * ])
+ *   .then((batch) => console.log('Done'))
+ *   .catch((batch, error) => console.error('Failed'))
+ *   .dispatch();
+ * ```
+ */
+import { Facade } from '../Support/Facade';
+import type { QueueManager } from '../Queue/QueueManager';
+import type { Job } from '../Queue/Job';
+import { PendingChain } from '../Queue/PendingChain';
+import { PendingBatch } from '../Queue/Batching/PendingBatch';
+declare class BusFacadeClass extends Facade {
+    protected static getFacadeAccessor(): string;
+    /**
+     * Dispatch a job to the queue
+     */
+    static dispatch(job: Job): Promise<string>;
+    /**
+     * Dispatch a job synchronously
+     */
+    static dispatchSync(job: Job): Promise<void>;
+    /**
+     * Dispatch a job immediately (alias for dispatchSync)
+     */
+    static dispatchNow(job: Job): Promise<void>;
+    /**
+     * Create a new chain of queueable jobs
+     */
+    static chain(jobs: Job[]): PendingChain;
+    /**
+     * Create a new batch of queueable jobs
+     */
+    static batch(jobs: Job[]): PendingBatch;
+}
+export declare const Bus: typeof BusFacadeClass & QueueManager;
+export {};
+//# sourceMappingURL=Bus.d.ts.map

package/dist/Facades/Bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bus.d.ts","sourceRoot":"","sources":["../../src/Facades/Bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,cAAM,cAAe,SAAQ,MAAM;IACjC,SAAS,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAI5C;;OAEG;WACU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAKhD;;OAEG;WACU,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD;;OAEG;WACU,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY;IAKvC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY;CAIxC;AAED,eAAO,MAAM,GAAG,EAyBC,OAAO,cAAc,GAAG,YAAY,CAAC"}

package/dist/Facades/Bus.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Bus Facade
+ *
+ * Provides static access to the command bus for dispatching jobs,
+ * chains, and batches.
+ *
+ * @example
+ * ```typescript
+ * // Dispatch a job
+ * await Bus.dispatch(new ProcessPodcast(podcastId));
+ *
+ * // Dispatch synchronously
+ * await Bus.dispatchSync(new ProcessPodcast(podcastId));
+ *
+ * // Chain jobs
+ * await Bus.chain([
+ *   new ProcessPodcast(id),
+ *   new OptimizePodcast(id),
+ *   new ReleasePodcast(id),
+ * ]).dispatch();
+ *
+ * // Batch jobs
+ * const batch = await Bus.batch([
+ *   new ProcessPodcast(1),
+ *   new ProcessPodcast(2),
+ * ])
+ *   .then((batch) => console.log('Done'))
+ *   .catch((batch, error) => console.error('Failed'))
+ *   .dispatch();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bus = void 0;
+const Facade_1 = require("../Support/Facade");
+const PendingChain_1 = require("../Queue/PendingChain");
+const PendingBatch_1 = require("../Queue/Batching/PendingBatch");
+class BusFacadeClass extends Facade_1.Facade {
+    static getFacadeAccessor() {
+        return 'queue';
+    }
+    /**
+     * Dispatch a job to the queue
+     */
+    static async dispatch(job) {
+        const manager = this.getFacadeRoot();
+        return manager.dispatch(job);
+    }
+    /**
+     * Dispatch a job synchronously
+     */
+    static async dispatchSync(job) {
+        const manager = this.getFacadeRoot();
+        return manager.dispatchSync(job);
+    }
+    /**
+     * Dispatch a job immediately (alias for dispatchSync)
+     */
+    static async dispatchNow(job) {
+        return this.dispatchSync(job);
+    }
+    /**
+     * Create a new chain of queueable jobs
+     */
+    static chain(jobs) {
+        const manager = this.getFacadeRoot();
+        return new PendingChain_1.PendingChain(manager, jobs);
+    }
+    /**
+     * Create a new batch of queueable jobs
+     */
+    static batch(jobs) {
+        const app = this.getFacadeApplication();
+        return new PendingBatch_1.PendingBatch(app, jobs);
+    }
+}
+exports.Bus = new Proxy(BusFacadeClass, {
+    get(target, prop) {
+        if (prop in target) {
+            const value = target[prop];
+            if (typeof value === 'function') {
+                return value.bind(target);
+            }
+            return value;
+        }
+        try {
+            const root = target.getFacadeRoot();
+            if (root && prop in root) {
+                const value = root[prop];
+                if (typeof value === 'function') {
+                    return (...args) => value.apply(root, args);
+                }
+                return value;
+            }
+        }
+        catch (error) {
+            // Facade root not available yet
+        }
+        return undefined;
+    },
+});
+//# sourceMappingURL=Bus.js.map

package/dist/Facades/Bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bus.js","sourceRoot":"","sources":["../../src/Facades/Bus.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAEH,8CAA2C;AAG3C,wDAAqD;AACrD,iEAA8D;AAE9D,MAAM,cAAe,SAAQ,eAAM;IACvB,MAAM,CAAC,iBAAiB;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAQ;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAkB,CAAC;QACrD,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAQ;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAkB,CAAC;QACrD,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAQ;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAW;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAkB,CAAC;QACrD,OAAO,IAAI,2BAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAW;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACxC,OAAO,IAAI,2BAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAEY,QAAA,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE;IAC3C,GAAG,CAAC,MAAM,EAAE,IAAI;QACd,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,GAAI,MAAc,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAI,MAAc,CAAC,aAAa,EAAkB,CAAC;YAC7D,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAI,IAAY,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gCAAgC;QAClC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAoD,CAAC"}

package/dist/Facades/Queue.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Queue Facade
+ *
+ * Provides static access to the queue manager for dispatching
+ * and managing queued jobs.
+ *
+ * @example
+ * ```typescript
+ * // Push a job onto the queue
+ * await Queue.push(new ProcessPodcast(podcastId));
+ *
+ * // Push onto a specific queue
+ * await Queue.pushOn('high-priority', new ProcessPodcast(podcastId));
+ *
+ * // Push with a delay
+ * await Queue.later(60, new ProcessPodcast(podcastId));
+ *
+ * // Get queue size
+ * const size = await Queue.size();
+ *
+ * // Event hooks
+ * Queue.before((connectionName, job) => {
+ *   console.log('Processing:', job.displayName());
+ * });
+ *
+ * Queue.after((connectionName, job) => {
+ *   console.log('Processed:', job.displayName());
+ * });
+ *
+ * Queue.failing((connectionName, job, error) => {
+ *   console.error('Failed:', job.displayName(), error);
+ * });
+ * ```
+ */
+import { Facade } from '../Support/Facade';
+import type { QueueManager } from '../Queue/QueueManager';
+declare class QueueFacadeClass extends Facade {
+    protected static getFacadeAccessor(): string;
+}
+export declare const Queue: typeof QueueFacadeClass & QueueManager;
+export {};
+//# sourceMappingURL=Queue.d.ts.map

package/dist/Facades/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../src/Facades/Queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,cAAM,gBAAiB,SAAQ,MAAM;IACnC,SAAS,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM;CAG7C;AAED,eAAO,MAAM,KAAK,EA2BD,OAAO,gBAAgB,GAAG,YAAY,CAAC"}

package/dist/Facades/Queue.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Queue Facade
+ *
+ * Provides static access to the queue manager for dispatching
+ * and managing queued jobs.
+ *
+ * @example
+ * ```typescript
+ * // Push a job onto the queue
+ * await Queue.push(new ProcessPodcast(podcastId));
+ *
+ * // Push onto a specific queue
+ * await Queue.pushOn('high-priority', new ProcessPodcast(podcastId));
+ *
+ * // Push with a delay
+ * await Queue.later(60, new ProcessPodcast(podcastId));
+ *
+ * // Get queue size
+ * const size = await Queue.size();
+ *
+ * // Event hooks
+ * Queue.before((connectionName, job) => {
+ *   console.log('Processing:', job.displayName());
+ * });
+ *
+ * Queue.after((connectionName, job) => {
+ *   console.log('Processed:', job.displayName());
+ * });
+ *
+ * Queue.failing((connectionName, job, error) => {
+ *   console.error('Failed:', job.displayName(), error);
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+const Facade_1 = require("../Support/Facade");
+class QueueFacadeClass extends Facade_1.Facade {
+    static getFacadeAccessor() {
+        return 'queue';
+    }
+}
+exports.Queue = new Proxy(QueueFacadeClass, {
+    get(target, prop) {
+        // First check if it's a static method on the facade class itself
+        if (prop in target) {
+            const value = target[prop];
+            if (typeof value === 'function') {
+                return value.bind(target);
+            }
+            return value;
+        }
+        // Then try to get from the facade root (the QueueManager instance)
+        try {
+            const root = target.getFacadeRoot();
+            if (root && prop in root) {
+                const value = root[prop];
+                if (typeof value === 'function') {
+                    return (...args) => value.apply(root, args);
+                }
+                return value;
+            }
+        }
+        catch (error) {
+            // Facade root not available yet
+        }
+        return undefined;
+    },
+});
+//# sourceMappingURL=Queue.js.map

package/dist/Facades/Queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../src/Facades/Queue.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,8CAA2C;AAG3C,MAAM,gBAAiB,SAAQ,eAAM;IACzB,MAAM,CAAC,iBAAiB;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAEY,QAAA,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,EAAE;IAC/C,GAAG,CAAC,MAAM,EAAE,IAAI;QACd,iEAAiE;QACjE,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,GAAI,MAAc,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mEAAmE;QACnE,IAAI,CAAC;YACH,MAAM,IAAI,GAAI,MAAc,CAAC,aAAa,EAAkB,CAAC;YAC7D,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAI,IAAY,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gCAAgC;QAClC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAsD,CAAC"}

package/dist/Facades/index.d.ts

@@ -7,4 +7,6 @@ export { Config } from './Config';
 export { DB } from './DB';
 export { Route } from './Route';
 export { Event, EventFake } from './Event';
+export { Queue } from './Queue';
+export { Bus } from './Bus';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Facades/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Facades/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}

package/dist/Facades/index.js

@@ -5,7 +5,7 @@
  * Export all facades for easy importing
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventFake = exports.Event = exports.Route = exports.DB = exports.Config = void 0;
+exports.Bus = exports.Queue = exports.EventFake = exports.Event = exports.Route = exports.DB = exports.Config = void 0;
 var Config_1 = require("./Config");
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return Config_1.Config; } });
 var DB_1 = require("./DB");
@@ -15,4 +15,8 @@ Object.defineProperty(exports, "Route", { enumerable: true, get: function () { r
 var Event_1 = require("./Event");
 Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return Event_1.Event; } });
 Object.defineProperty(exports, "EventFake", { enumerable: true, get: function () { return Event_1.EventFake; } });
+var Queue_1 = require("./Queue");
+Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return Queue_1.Queue; } });
+var Bus_1 = require("./Bus");
+Object.defineProperty(exports, "Bus", { enumerable: true, get: function () { return Bus_1.Bus; } });
 //# sourceMappingURL=index.js.map

package/dist/Facades/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Facades/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AACX,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,iCAA2C;AAAlC,8FAAA,KAAK,OAAA;AAAE,kGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Facades/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AACX,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,iCAA2C;AAAlC,8FAAA,KAAK,OAAA;AAAE,kGAAA,SAAS,OAAA;AACzB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,6BAA4B;AAAnB,0FAAA,GAAG,OAAA"}

package/dist/Queue/Batching/Batch.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Batch
+ *
+ * Represents a batch of jobs being processed.
+ * Tracks progress and fires callbacks on completion/failure.
+ *
+ * Mirrors Laravel's Illuminate\Bus\Batch.
+ */
+import type { QueueManager } from '../QueueManager';
+export interface BatchOptions {
+    thenCallbacks: Array<(batch: Batch) => void | Promise<void>>;
+    catchCallbacks: Array<(batch: Batch, error: Error) => void | Promise<void>>;
+    finallyCallbacks: Array<(batch: Batch) => void | Promise<void>>;
+    allowFailures: boolean;
+}
+export declare class Batch {
+    protected manager: QueueManager;
+    readonly name: string;
+    readonly id: string;
+    readonly createdAt: Date;
+    protected _totalJobs: number;
+    protected _pendingJobs: number;
+    protected _failedJobs: number;
+    protected _failedJobIds: string[];
+    protected _cancelled: boolean;
+    protected _finishedAt: Date | null;
+    protected _options: BatchOptions;
+    constructor(manager: QueueManager, name: string, totalJobs: number, options: BatchOptions);
+    /**
+     * Get the total number of jobs in the batch
+     */
+    get totalJobs(): number;
+    /**
+     * Get the number of pending jobs
+     */
+    get pendingJobs(): number;
+    /**
+     * Get the number of failed jobs
+     */
+    get failedJobs(): number;
+    /**
+     * Get the number of processed jobs
+     */
+    get processedJobs(): number;
+    /**
+     * Get the batch progress percentage (0-100)
+     */
+    progress(): number;
+    /**
+     * Whether the batch has finished
+     */
+    finished(): boolean;
+    /**
+     * Whether the batch has been cancelled
+     */
+    cancelled(): boolean;
+    /**
+     * Record a successful job completion
+     */
+    recordSuccessfulJob(jobId: string): Promise<void>;
+    /**
+     * Record a failed job
+     */
+    recordFailedJob(jobId: string, error: Error): Promise<void>;
+    /**
+     * Cancel the batch
+     */
+    cancel(): void;
+    /**
+     * Fire the then callbacks
+     */
+    protected fireThenCallbacks(): Promise<void>;
+    /**
+     * Fire the catch callbacks
+     */
+    protected fireCatchCallbacks(error: Error): Promise<void>;
+    /**
+     * Fire the finally callbacks
+     */
+    protected fireFinallyCallbacks(): Promise<void>;
+    /**
+     * Convert to a plain object for inspection
+     */
+    toJSON(): Record<string, any>;
+}
+//# sourceMappingURL=Batch.d.ts.map

package/dist/Queue/Batching/Batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Batch.d.ts","sourceRoot":"","sources":["../../../src/Queue/Batching/Batch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,cAAc,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,gBAAgB,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,KAAK;IAad,SAAS,CAAC,OAAO,EAAE,YAAY;aACf,IAAI,EAAE,MAAM;IAb9B,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,WAAW,EAAE,MAAM,CAAK;IAClC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,CAAM;IACvC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAS;IACtC,SAAS,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAQ;IAC1C,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAGrB,OAAO,EAAE,YAAY,EACf,IAAI,EAAE,MAAM,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY;IASvB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM;IAKlB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;cACa,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlD;;OAEG;cACa,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrD;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAc9B"}

package/dist/Queue/Batching/Batch.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Batch
+ *
+ * Represents a batch of jobs being processed.
+ * Tracks progress and fires callbacks on completion/failure.
+ *
+ * Mirrors Laravel's Illuminate\Bus\Batch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Batch = void 0;
+const crypto_1 = require("crypto");
+class Batch {
+    manager;
+    name;
+    id;
+    createdAt;
+    _totalJobs;
+    _pendingJobs;
+    _failedJobs = 0;
+    _failedJobIds = [];
+    _cancelled = false;
+    _finishedAt = null;
+    _options;
+    constructor(manager, name, totalJobs, options) {
+        this.manager = manager;
+        this.name = name;
+        this.id = (0, crypto_1.randomUUID)();
+        this.createdAt = new Date();
+        this._totalJobs = totalJobs;
+        this._pendingJobs = totalJobs;
+        this._options = options;
+    }
+    /**
+     * Get the total number of jobs in the batch
+     */
+    get totalJobs() {
+        return this._totalJobs;
+    }
+    /**
+     * Get the number of pending jobs
+     */
+    get pendingJobs() {
+        return this._pendingJobs;
+    }
+    /**
+     * Get the number of failed jobs
+     */
+    get failedJobs() {
+        return this._failedJobs;
+    }
+    /**
+     * Get the number of processed jobs
+     */
+    get processedJobs() {
+        return this._totalJobs - this._pendingJobs;
+    }
+    /**
+     * Get the batch progress percentage (0-100)
+     */
+    progress() {
+        if (this._totalJobs === 0)
+            return 100;
+        return Math.round((this.processedJobs / this._totalJobs) * 100);
+    }
+    /**
+     * Whether the batch has finished
+     */
+    finished() {
+        return this._pendingJobs === 0;
+    }
+    /**
+     * Whether the batch has been cancelled
+     */
+    cancelled() {
+        return this._cancelled;
+    }
+    /**
+     * Record a successful job completion
+     */
+    async recordSuccessfulJob(jobId) {
+        this._pendingJobs = Math.max(0, this._pendingJobs - 1);
+        if (this.finished()) {
+            await this.fireThenCallbacks();
+            await this.fireFinallyCallbacks();
+            this._finishedAt = new Date();
+        }
+    }
+    /**
+     * Record a failed job
+     */
+    async recordFailedJob(jobId, error) {
+        this._failedJobs++;
+        this._failedJobIds.push(jobId);
+        this._pendingJobs = Math.max(0, this._pendingJobs - 1);
+        // Fire catch callbacks
+        await this.fireCatchCallbacks(error);
+        if (!this._options.allowFailures) {
+            this.cancel();
+        }
+        if (this.finished()) {
+            await this.fireFinallyCallbacks();
+            this._finishedAt = new Date();
+        }
+    }
+    /**
+     * Cancel the batch
+     */
+    cancel() {
+        this._cancelled = true;
+    }
+    /**
+     * Fire the then callbacks
+     */
+    async fireThenCallbacks() {
+        for (const callback of this._options.thenCallbacks) {
+            try {
+                await callback(this);
+            }
+            catch (error) {
+                console.error('[Queue] Error in batch then callback:', error);
+            }
+        }
+    }
+    /**
+     * Fire the catch callbacks
+     */
+    async fireCatchCallbacks(error) {
+        for (const callback of this._options.catchCallbacks) {
+            try {
+                await callback(this, error);
+            }
+            catch (callbackError) {
+                console.error('[Queue] Error in batch catch callback:', callbackError);
+            }
+        }
+    }
+    /**
+     * Fire the finally callbacks
+     */
+    async fireFinallyCallbacks() {
+        for (const callback of this._options.finallyCallbacks) {
+            try {
+                await callback(this);
+            }
+            catch (error) {
+                console.error('[Queue] Error in batch finally callback:', error);
+            }
+        }
+    }
+    /**
+     * Convert to a plain object for inspection
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            totalJobs: this._totalJobs,
+            pendingJobs: this._pendingJobs,
+            failedJobs: this._failedJobs,
+            processedJobs: this.processedJobs,
+            progress: this.progress(),
+            cancelled: this._cancelled,
+            createdAt: this.createdAt.toISOString(),
+            finishedAt: this._finishedAt?.toISOString() || null,
+        };
+    }
+}
+exports.Batch = Batch;
+//# sourceMappingURL=Batch.js.map

package/dist/Queue/Batching/Batch.js.map

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