@orchestr-sh/orchestr 1.7.4 → 1.9.1

package/dist/Facades/Cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../src/Facades/Cache.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,8CAA2C;AAI3C,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;YAED,8CAA8C;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAgB,CAAC;YACzC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAI,KAAa,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACtD,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,CAAmE,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,7 @@ 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';
+export { Cache } from './Cache';
 //# 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;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,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.Cache = 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,10 @@ 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; } });
+var Cache_1 = require("./Cache");
+Object.defineProperty(exports, "Cache", { enumerable: true, get: function () { return Cache_1.Cache; } });
 //# 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;AACZ,iCAAgC;AAAvB,8FAAA,KAAK,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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"}

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

@@ -0,0 +1,72 @@
+/**
+ * PendingBatch
+ *
+ * Fluent builder for creating a batch of jobs.
+ * Jobs in a batch can run concurrently, with callbacks
+ * for progress, completion, and failure.
+ *
+ * Mirrors Laravel's Illuminate\Bus\PendingBatch.
+ *
+ * @example
+ * ```typescript
+ * const batch = await Bus.batch([
+ *   new ImportCSVRow(1),
+ *   new ImportCSVRow(2),
+ *   new ImportCSVRow(3),
+ * ])
+ *   .name('Import CSV')
+ *   .then((batch) => console.log('All done!'))
+ *   .catch((batch, error) => console.error('Failed:', error))
+ *   .finally((batch) => console.log('Batch finished'))
+ *   .onQueue('imports')
+ *   .dispatch();
+ * ```
+ */
+import type { Job } from '../Job';
+import type { Application } from '../../Foundation/Application';
+import { Batch } from './Batch';
+export declare class PendingBatch {
+    protected app: Application;
+    protected jobs: Job[];
+    protected _name: string;
+    protected _connection?: string;
+    protected _queue?: string;
+    protected _thenCallbacks: Array<(batch: Batch) => void | Promise<void>>;
+    protected _catchCallbacks: Array<(batch: Batch, error: Error) => void | Promise<void>>;
+    protected _finallyCallbacks: Array<(batch: Batch) => void | Promise<void>>;
+    protected _allowFailures: boolean;
+    constructor(app: Application, jobs: Job[]);
+    /**
+     * Set the name for the batch
+     */
+    name(name: string): this;
+    /**
+     * Set the connection for all jobs in the batch
+     */
+    onConnection(connection: string): this;
+    /**
+     * Set the queue for all jobs in the batch
+     */
+    onQueue(queue: string): this;
+    /**
+     * Register a callback for when all jobs in the batch complete
+     */
+    then(callback: (batch: Batch) => void | Promise<void>): this;
+    /**
+     * Register a callback for when a job in the batch fails
+     */
+    catch(callback: (batch: Batch, error: Error) => void | Promise<void>): this;
+    /**
+     * Register a callback for when the batch finishes (success or failure)
+     */
+    finally(callback: (batch: Batch) => void | Promise<void>): this;
+    /**
+     * Allow the batch to continue processing even if a job fails
+     */
+    allowFailures(allow?: boolean): this;
+    /**
+     * Dispatch the batch
+     */
+    dispatch(): Promise<Batch>;
+}
+//# sourceMappingURL=PendingBatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PendingBatch.d.ts","sourceRoot":"","sources":["../../../src/Queue/Batching/PendingBatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,YAAY;IAUrB,SAAS,CAAC,GAAG,EAAE,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;IAVvB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAM;IAC7B,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM;IAC7E,SAAS,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM;IAC5F,SAAS,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM;IAChF,SAAS,CAAC,cAAc,EAAE,OAAO,CAAS;gBAG9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,GAAG,EAAE;IAGvB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK5D;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK3E;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACH,aAAa,CAAC,KAAK,GAAE,OAAc,GAAG,IAAI;IAK1C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;CAkCjC"}

package/dist/Queue/Batching/PendingBatch.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * PendingBatch
+ *
+ * Fluent builder for creating a batch of jobs.
+ * Jobs in a batch can run concurrently, with callbacks
+ * for progress, completion, and failure.
+ *
+ * Mirrors Laravel's Illuminate\Bus\PendingBatch.
+ *
+ * @example
+ * ```typescript
+ * const batch = await Bus.batch([
+ *   new ImportCSVRow(1),
+ *   new ImportCSVRow(2),
+ *   new ImportCSVRow(3),
+ * ])
+ *   .name('Import CSV')
+ *   .then((batch) => console.log('All done!'))
+ *   .catch((batch, error) => console.error('Failed:', error))
+ *   .finally((batch) => console.log('Batch finished'))
+ *   .onQueue('imports')
+ *   .dispatch();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingBatch = void 0;
+const Batch_1 = require("./Batch");
+class PendingBatch {
+    app;
+    jobs;
+    _name = '';
+    _connection;
+    _queue;
+    _thenCallbacks = [];
+    _catchCallbacks = [];
+    _finallyCallbacks = [];
+    _allowFailures = false;
+    constructor(app, jobs) {
+        this.app = app;
+        this.jobs = jobs;
+    }
+    /**
+     * Set the name for the batch
+     */
+    name(name) {
+        this._name = name;
+        return this;
+    }
+    /**
+     * Set the connection for all jobs in the batch
+     */
+    onConnection(connection) {
+        this._connection = connection;
+        return this;
+    }
+    /**
+     * Set the queue for all jobs in the batch
+     */
+    onQueue(queue) {
+        this._queue = queue;
+        return this;
+    }
+    /**
+     * Register a callback for when all jobs in the batch complete
+     */
+    then(callback) {
+        this._thenCallbacks.push(callback);
+        return this;
+    }
+    /**
+     * Register a callback for when a job in the batch fails
+     */
+    catch(callback) {
+        this._catchCallbacks.push(callback);
+        return this;
+    }
+    /**
+     * Register a callback for when the batch finishes (success or failure)
+     */
+    finally(callback) {
+        this._finallyCallbacks.push(callback);
+        return this;
+    }
+    /**
+     * Allow the batch to continue processing even if a job fails
+     */
+    allowFailures(allow = true) {
+        this._allowFailures = allow;
+        return this;
+    }
+    /**
+     * Dispatch the batch
+     */
+    async dispatch() {
+        const manager = this.app.make('queue');
+        // Apply connection/queue to all jobs
+        for (const job of this.jobs) {
+            if (this._connection) {
+                job.connection = this._connection;
+            }
+            if (this._queue) {
+                job.queue = this._queue;
+            }
+        }
+        // Create batch instance
+        const batch = new Batch_1.Batch(manager, this._name, this.jobs.length, {
+            thenCallbacks: this._thenCallbacks,
+            catchCallbacks: this._catchCallbacks,
+            finallyCallbacks: this._finallyCallbacks,
+            allowFailures: this._allowFailures,
+        });
+        // Dispatch all jobs with batch metadata
+        for (const job of this.jobs) {
+            job._batchId = batch.id;
+            await manager.dispatch(job);
+        }
+        return batch;
+    }
+}
+exports.PendingBatch = PendingBatch;
+//# sourceMappingURL=PendingBatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PendingBatch.js","sourceRoot":"","sources":["../../../src/Queue/Batching/PendingBatch.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAKH,mCAAgC;AAEhC,MAAa,YAAY;IAUX;IACA;IAVF,KAAK,GAAW,EAAE,CAAC;IACnB,WAAW,CAAU;IACrB,MAAM,CAAU;IAChB,cAAc,GAAkD,EAAE,CAAC;IACnE,eAAe,GAAgE,EAAE,CAAC;IAClF,iBAAiB,GAAkD,EAAE,CAAC;IACtE,cAAc,GAAY,KAAK,CAAC;IAE1C,YACY,GAAgB,EAChB,IAAW;QADX,QAAG,GAAH,GAAG,CAAa;QAChB,SAAI,GAAJ,IAAI,CAAO;IACpB,CAAC;IAEJ;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,UAAkB;QAC7B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,QAAgD;QACnD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAA8D;QAClE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAgD;QACtD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAiB,IAAI;QACjC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,OAAO,CAAC,CAAC;QAErD,qCAAqC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,KAAK,GAAG,IAAI,aAAK,CACrB,OAAO,EACP,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,CAAC,MAAM,EAChB;YACE,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CACF,CAAC;QAEF,wCAAwC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,GAAW,CAAC,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA3GD,oCA2GC"}

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

@@ -0,0 +1,3 @@
+export { Batch } from './Batch';
+export { PendingBatch } from './PendingBatch';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Queue/Batching/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/Queue/Batching/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingBatch = exports.Batch = void 0;
+var Batch_1 = require("./Batch");
+Object.defineProperty(exports, "Batch", { enumerable: true, get: function () { return Batch_1.Batch; } });
+var PendingBatch_1 = require("./PendingBatch");
+Object.defineProperty(exports, "PendingBatch", { enumerable: true, get: function () { return PendingBatch_1.PendingBatch; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Queue/Batching/index.ts"],"names":[],"mappings":";;;AAAA,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}