@orchestr-sh/orchestr 1.10.0 → 1.11.0

package/dist/Queue/QueueManager.d.cts

@@ -0,0 +1,147 @@
+import { Job } from "./Job.cjs";
+import { QueueDriver } from "./Contracts/QueueDriver.cjs";
+
+//#region src/Queue/QueueManager.d.ts
+interface QueueConnectionConfig {
+  driver: string;
+  connection?: string;
+  table?: string;
+  queue?: string;
+  retry_after?: number;
+  block_for?: number | null;
+  after_commit?: boolean;
+  [key: string]: any;
+}
+interface QueueFailedConfig {
+  driver: string;
+  database?: string;
+  table?: string;
+}
+interface QueueBatchingConfig {
+  database: string;
+  table: string;
+}
+interface QueueConfig {
+  default: string;
+  connections: Record<string, QueueConnectionConfig>;
+  batching?: QueueBatchingConfig;
+  failed?: QueueFailedConfig;
+}
+type DriverFactory = (config: QueueConnectionConfig) => QueueDriver;
+declare class QueueManager {
+  protected config: QueueConfig;
+  protected connections: Map<string, QueueDriver>;
+  protected driverFactories: Map<string, DriverFactory>;
+  protected jobRegistry: Map<string, new (...args: any[]) => Job>;
+  /**
+   * Event callbacks
+   */
+  protected beforeCallbacks: Array<(connectionName: string, job: Job) => void>;
+  protected afterCallbacks: Array<(connectionName: string, job: Job) => void>;
+  protected failingCallbacks: Array<(connectionName: string, job: Job, error: Error) => void>;
+  protected loopingCallbacks: Array<() => void>;
+  constructor(config: QueueConfig);
+  /**
+   * Register a queue driver factory
+   */
+  registerDriver(name: string, factory: DriverFactory): void;
+  /**
+   * Register a job class for deserialization
+   */
+  registerJob(name: string, jobClass: new (...args: any[]) => Job): void;
+  /**
+   * Get a job class from the registry
+   */
+  getJobClass(name: string): (new (...args: any[]) => Job) | undefined;
+  /**
+   * Get a queue connection instance
+   */
+  connection(name?: string): QueueDriver;
+  /**
+   * Create a new queue connection
+   */
+  protected createConnection(name: string): QueueDriver;
+  /**
+   * Dispatch a job to its configured connection and queue
+   */
+  dispatch(job: Job): Promise<string>;
+  /**
+   * Dispatch a job synchronously (bypass queue, execute immediately)
+   */
+  dispatchSync(job: Job): Promise<void>;
+  /**
+   * Push a job onto a specific queue
+   */
+  push(job: Job, queue?: string): Promise<string>;
+  /**
+   * Push a job onto a specific named queue
+   */
+  pushOn(queue: string, job: Job): Promise<string>;
+  /**
+   * Push a job after a delay
+   */
+  later(delay: number | Date, job: Job, queue?: string): Promise<string>;
+  /**
+   * Push multiple jobs onto the queue
+   */
+  bulk(jobs: Job[], queue?: string): Promise<void>;
+  /**
+   * Register a callback to be called before a job is processed
+   */
+  before(callback: (connectionName: string, job: Job) => void): void;
+  /**
+   * Register a callback to be called after a job is processed
+   */
+  after(callback: (connectionName: string, job: Job) => void): void;
+  /**
+   * Register a callback to be called when a job fails
+   */
+  failing(callback: (connectionName: string, job: Job, error: Error) => void): void;
+  /**
+   * Register a callback to be called on each worker loop iteration
+   */
+  looping(callback: () => void): void;
+  /**
+   * Fire the before job callbacks
+   */
+  fireBeforeCallbacks(connectionName: string, job: Job): void;
+  /**
+   * Fire the after job callbacks
+   */
+  fireAfterCallbacks(connectionName: string, job: Job): void;
+  /**
+   * Fire the failing job callbacks
+   */
+  fireFailingCallbacks(connectionName: string, job: Job, error: Error): void;
+  /**
+   * Fire the looping callbacks
+   */
+  fireLoopingCallbacks(): void;
+  /**
+   * Disconnect from a queue connection
+   */
+  disconnect(name?: string): void;
+  /**
+   * Get the default connection name
+   */
+  getDefaultConnection(): string;
+  /**
+   * Set the default connection name
+   */
+  setDefaultConnection(name: string): void;
+  /**
+   * Get all connection names
+   */
+  getConnections(): string[];
+  /**
+   * Get the queue configuration
+   */
+  getConfig(): QueueConfig;
+  /**
+   * Get the connection configuration
+   */
+  getConnectionConfig(name?: string): QueueConnectionConfig;
+}
+//#endregion
+export { QueueBatchingConfig, QueueConfig, QueueConnectionConfig, QueueFailedConfig, QueueManager };
+//# sourceMappingURL=QueueManager.d.cts.map

package/dist/Queue/QueueManager.d.cts.map

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

package/dist/Queue/QueueManager.d.mts

@@ -0,0 +1,147 @@
+import { Job } from "./Job.mjs";
+import { QueueDriver } from "./Contracts/QueueDriver.mjs";
+
+//#region src/Queue/QueueManager.d.ts
+interface QueueConnectionConfig {
+  driver: string;
+  connection?: string;
+  table?: string;
+  queue?: string;
+  retry_after?: number;
+  block_for?: number | null;
+  after_commit?: boolean;
+  [key: string]: any;
+}
+interface QueueFailedConfig {
+  driver: string;
+  database?: string;
+  table?: string;
+}
+interface QueueBatchingConfig {
+  database: string;
+  table: string;
+}
+interface QueueConfig {
+  default: string;
+  connections: Record<string, QueueConnectionConfig>;
+  batching?: QueueBatchingConfig;
+  failed?: QueueFailedConfig;
+}
+type DriverFactory = (config: QueueConnectionConfig) => QueueDriver;
+declare class QueueManager {
+  protected config: QueueConfig;
+  protected connections: Map<string, QueueDriver>;
+  protected driverFactories: Map<string, DriverFactory>;
+  protected jobRegistry: Map<string, new (...args: any[]) => Job>;
+  /**
+   * Event callbacks
+   */
+  protected beforeCallbacks: Array<(connectionName: string, job: Job) => void>;
+  protected afterCallbacks: Array<(connectionName: string, job: Job) => void>;
+  protected failingCallbacks: Array<(connectionName: string, job: Job, error: Error) => void>;
+  protected loopingCallbacks: Array<() => void>;
+  constructor(config: QueueConfig);
+  /**
+   * Register a queue driver factory
+   */
+  registerDriver(name: string, factory: DriverFactory): void;
+  /**
+   * Register a job class for deserialization
+   */
+  registerJob(name: string, jobClass: new (...args: any[]) => Job): void;
+  /**
+   * Get a job class from the registry
+   */
+  getJobClass(name: string): (new (...args: any[]) => Job) | undefined;
+  /**
+   * Get a queue connection instance
+   */
+  connection(name?: string): QueueDriver;
+  /**
+   * Create a new queue connection
+   */
+  protected createConnection(name: string): QueueDriver;
+  /**
+   * Dispatch a job to its configured connection and queue
+   */
+  dispatch(job: Job): Promise<string>;
+  /**
+   * Dispatch a job synchronously (bypass queue, execute immediately)
+   */
+  dispatchSync(job: Job): Promise<void>;
+  /**
+   * Push a job onto a specific queue
+   */
+  push(job: Job, queue?: string): Promise<string>;
+  /**
+   * Push a job onto a specific named queue
+   */
+  pushOn(queue: string, job: Job): Promise<string>;
+  /**
+   * Push a job after a delay
+   */
+  later(delay: number | Date, job: Job, queue?: string): Promise<string>;
+  /**
+   * Push multiple jobs onto the queue
+   */
+  bulk(jobs: Job[], queue?: string): Promise<void>;
+  /**
+   * Register a callback to be called before a job is processed
+   */
+  before(callback: (connectionName: string, job: Job) => void): void;
+  /**
+   * Register a callback to be called after a job is processed
+   */
+  after(callback: (connectionName: string, job: Job) => void): void;
+  /**
+   * Register a callback to be called when a job fails
+   */
+  failing(callback: (connectionName: string, job: Job, error: Error) => void): void;
+  /**
+   * Register a callback to be called on each worker loop iteration
+   */
+  looping(callback: () => void): void;
+  /**
+   * Fire the before job callbacks
+   */
+  fireBeforeCallbacks(connectionName: string, job: Job): void;
+  /**
+   * Fire the after job callbacks
+   */
+  fireAfterCallbacks(connectionName: string, job: Job): void;
+  /**
+   * Fire the failing job callbacks
+   */
+  fireFailingCallbacks(connectionName: string, job: Job, error: Error): void;
+  /**
+   * Fire the looping callbacks
+   */
+  fireLoopingCallbacks(): void;
+  /**
+   * Disconnect from a queue connection
+   */
+  disconnect(name?: string): void;
+  /**
+   * Get the default connection name
+   */
+  getDefaultConnection(): string;
+  /**
+   * Set the default connection name
+   */
+  setDefaultConnection(name: string): void;
+  /**
+   * Get all connection names
+   */
+  getConnections(): string[];
+  /**
+   * Get the queue configuration
+   */
+  getConfig(): QueueConfig;
+  /**
+   * Get the connection configuration
+   */
+  getConnectionConfig(name?: string): QueueConnectionConfig;
+}
+//#endregion
+export { QueueBatchingConfig, QueueConfig, QueueConnectionConfig, QueueFailedConfig, QueueManager };
+//# sourceMappingURL=QueueManager.d.mts.map

package/dist/Queue/QueueManager.d.mts.map

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

package/dist/Queue/QueueManager.mjs

@@ -0,0 +1,2 @@
+var e=class{connections=new Map;driverFactories=new Map;jobRegistry=new Map;beforeCallbacks=[];afterCallbacks=[];failingCallbacks=[];loopingCallbacks=[];constructor(e){this.config=e}registerDriver(e,t){this.driverFactories.set(e,t)}registerJob(e,t){this.jobRegistry.set(e,t)}getJobClass(e){return this.jobRegistry.get(e)}connection(e){let t=e||this.config.default;if(this.connections.has(t))return this.connections.get(t);let n=this.createConnection(t);return this.connections.set(t,n),n}createConnection(e){let t=this.config.connections[e];if(!t)throw Error(`Queue connection [${e}] not configured.`);let n=this.driverFactories.get(t.driver);if(!n)throw Error(`Queue driver [${t.driver}] not registered. Available drivers: ${Array.from(this.driverFactories.keys()).join(`, `)}`);let r=n(t);return r.setConnectionName(e),r}async dispatch(e){let t=e.connection||this.config.default,n=this.connection(t),r=e.queue;return e.delay?n.later(e.delay,e,r):n.push(e,r)}async dispatchSync(e){try{await e.handle()}catch(t){throw e.failed&&await e.failed(t),t}}async push(e,t){let n=e.connection||this.config.default;return this.connection(n).push(e,t)}async pushOn(e,t){return t.queue=e,this.push(t)}async later(e,t,n){let r=t.connection||this.config.default;return this.connection(r).later(e,t,n)}async bulk(e,t){let n=this.config.default;return this.connection(n).bulk(e,t)}before(e){this.beforeCallbacks.push(e)}after(e){this.afterCallbacks.push(e)}failing(e){this.failingCallbacks.push(e)}looping(e){this.loopingCallbacks.push(e)}fireBeforeCallbacks(e,t){for(let n of this.beforeCallbacks)n(e,t)}fireAfterCallbacks(e,t){for(let n of this.afterCallbacks)n(e,t)}fireFailingCallbacks(e,t,n){for(let r of this.failingCallbacks)r(e,t,n)}fireLoopingCallbacks(){for(let e of this.loopingCallbacks)e()}disconnect(e){let t=e||this.config.default;this.connections.delete(t)}getDefaultConnection(){return this.config.default}setDefaultConnection(e){this.config.default=e}getConnections(){return Object.keys(this.config.connections)}getConfig(){return this.config}getConnectionConfig(e){let t=e||this.config.default,n=this.config.connections[t];if(!n)throw Error(`Queue connection [${t}] not configured.`);return n}};export{e as QueueManager};
+//# sourceMappingURL=QueueManager.mjs.map

package/dist/Queue/QueueManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueManager.mjs","names":[],"sources":["../../src/Queue/QueueManager.ts"],"sourcesContent":["/**\n * QueueManager\n *\n * Manages multiple queue connections and drivers.\n * Follows the same Manager pattern as DatabaseManager.\n *\n * Mirrors Laravel's Illuminate\\Queue\\QueueManager.\n */\n\nimport type { QueueDriver } from './Contracts/QueueDriver';\nimport type { Job } from './Job';\nimport type { Worker } from './Workers/Worker';\nimport type { WorkerOptions } from './Workers/WorkerOptions';\nimport { JobPayload } from './JobPayload';\n\nexport interface QueueConnectionConfig {\n  driver: string;\n  connection?: string;\n  table?: string;\n  queue?: string;\n  retry_after?: number;\n  block_for?: number | null;\n  after_commit?: boolean;\n  [key: string]: any;\n}\n\nexport interface QueueFailedConfig {\n  driver: string;\n  database?: string;\n  table?: string;\n}\n\nexport interface QueueBatchingConfig {\n  database: string;\n  table: string;\n}\n\nexport interface QueueConfig {\n  default: string;\n  connections: Record<string, QueueConnectionConfig>;\n  batching?: QueueBatchingConfig;\n  failed?: QueueFailedConfig;\n}\n\nexport type DriverFactory = (config: QueueConnectionConfig) => QueueDriver;\n\nexport class QueueManager {\n  protected connections: Map<string, QueueDriver> = new Map();\n  protected driverFactories: Map<string, DriverFactory> = new Map();\n  protected jobRegistry: Map<string, new (...args: any[]) => Job> = new Map();\n\n  /**\n   * Event callbacks\n   */\n  protected beforeCallbacks: Array<(connectionName: string, job: Job) => void> = [];\n  protected afterCallbacks: Array<(connectionName: string, job: Job) => void> = [];\n  protected failingCallbacks: Array<(connectionName: string, job: Job, error: Error) => void> = [];\n  protected loopingCallbacks: Array<() => void> = [];\n\n  constructor(protected config: QueueConfig) {}\n\n  /**\n   * Register a queue driver factory\n   */\n  registerDriver(name: string, factory: DriverFactory): void {\n    this.driverFactories.set(name, factory);\n  }\n\n  /**\n   * Register a job class for deserialization\n   */\n  registerJob(name: string, jobClass: new (...args: any[]) => Job): void {\n    this.jobRegistry.set(name, jobClass);\n  }\n\n  /**\n   * Get a job class from the registry\n   */\n  getJobClass(name: string): (new (...args: any[]) => Job) | undefined {\n    return this.jobRegistry.get(name);\n  }\n\n  /**\n   * Get a queue connection instance\n   */\n  connection(name?: string): QueueDriver {\n    const connectionName = name || this.config.default;\n\n    if (this.connections.has(connectionName)) {\n      return this.connections.get(connectionName)!;\n    }\n\n    const driver = this.createConnection(connectionName);\n    this.connections.set(connectionName, driver);\n\n    return driver;\n  }\n\n  /**\n   * Create a new queue connection\n   */\n  protected createConnection(name: string): QueueDriver {\n    const config = this.config.connections[name];\n\n    if (!config) {\n      throw new Error(`Queue connection [${name}] not configured.`);\n    }\n\n    const factory = this.driverFactories.get(config.driver);\n\n    if (!factory) {\n      throw new Error(\n        `Queue driver [${config.driver}] not registered. Available drivers: ${Array.from(this.driverFactories.keys()).join(', ')}`\n      );\n    }\n\n    const driver = factory(config);\n    driver.setConnectionName(name);\n\n    return driver;\n  }\n\n  /**\n   * Dispatch a job to its configured connection and queue\n   */\n  async dispatch(job: Job): Promise<string> {\n    const connectionName = job.connection || this.config.default;\n    const driver = this.connection(connectionName);\n    const queue = job.queue;\n\n    if (job.delay) {\n      return driver.later(job.delay, job, queue);\n    }\n\n    return driver.push(job, queue);\n  }\n\n  /**\n   * Dispatch a job synchronously (bypass queue, execute immediately)\n   */\n  async dispatchSync(job: Job): Promise<void> {\n    try {\n      await job.handle();\n    } catch (error) {\n      if (job.failed) {\n        await job.failed(error as Error);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Push a job onto a specific queue\n   */\n  async push(job: Job, queue?: string): Promise<string> {\n    const connectionName = job.connection || this.config.default;\n    return this.connection(connectionName).push(job, queue);\n  }\n\n  /**\n   * Push a job onto a specific named queue\n   */\n  async pushOn(queue: string, job: Job): Promise<string> {\n    job.queue = queue;\n    return this.push(job);\n  }\n\n  /**\n   * Push a job after a delay\n   */\n  async later(delay: number | Date, job: Job, queue?: string): Promise<string> {\n    const connectionName = job.connection || this.config.default;\n    return this.connection(connectionName).later(delay, job, queue);\n  }\n\n  /**\n   * Push multiple jobs onto the queue\n   */\n  async bulk(jobs: Job[], queue?: string): Promise<void> {\n    const connectionName = this.config.default;\n    return this.connection(connectionName).bulk(jobs, queue);\n  }\n\n  /**\n   * Register a callback to be called before a job is processed\n   */\n  before(callback: (connectionName: string, job: Job) => void): void {\n    this.beforeCallbacks.push(callback);\n  }\n\n  /**\n   * Register a callback to be called after a job is processed\n   */\n  after(callback: (connectionName: string, job: Job) => void): void {\n    this.afterCallbacks.push(callback);\n  }\n\n  /**\n   * Register a callback to be called when a job fails\n   */\n  failing(callback: (connectionName: string, job: Job, error: Error) => void): void {\n    this.failingCallbacks.push(callback);\n  }\n\n  /**\n   * Register a callback to be called on each worker loop iteration\n   */\n  looping(callback: () => void): void {\n    this.loopingCallbacks.push(callback);\n  }\n\n  /**\n   * Fire the before job callbacks\n   */\n  fireBeforeCallbacks(connectionName: string, job: Job): void {\n    for (const callback of this.beforeCallbacks) {\n      callback(connectionName, job);\n    }\n  }\n\n  /**\n   * Fire the after job callbacks\n   */\n  fireAfterCallbacks(connectionName: string, job: Job): void {\n    for (const callback of this.afterCallbacks) {\n      callback(connectionName, job);\n    }\n  }\n\n  /**\n   * Fire the failing job callbacks\n   */\n  fireFailingCallbacks(connectionName: string, job: Job, error: Error): void {\n    for (const callback of this.failingCallbacks) {\n      callback(connectionName, job, error);\n    }\n  }\n\n  /**\n   * Fire the looping callbacks\n   */\n  fireLoopingCallbacks(): void {\n    for (const callback of this.loopingCallbacks) {\n      callback();\n    }\n  }\n\n  /**\n   * Disconnect from a queue connection\n   */\n  disconnect(name?: string): void {\n    const connectionName = name || this.config.default;\n    this.connections.delete(connectionName);\n  }\n\n  /**\n   * Get the default connection name\n   */\n  getDefaultConnection(): string {\n    return this.config.default;\n  }\n\n  /**\n   * Set the default connection name\n   */\n  setDefaultConnection(name: string): void {\n    this.config.default = name;\n  }\n\n  /**\n   * Get all connection names\n   */\n  getConnections(): string[] {\n    return Object.keys(this.config.connections);\n  }\n\n  /**\n   * Get the queue configuration\n   */\n  getConfig(): QueueConfig {\n    return this.config;\n  }\n\n  /**\n   * Get the connection configuration\n   */\n  getConnectionConfig(name?: string): QueueConnectionConfig {\n    const connectionName = name || this.config.default;\n    const config = this.config.connections[connectionName];\n\n    if (!config) {\n      throw new Error(`Queue connection [${connectionName}] not configured.`);\n    }\n\n    return config;\n  }\n}\n"],"mappings":"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"}

package/dist/Queue/QueueServiceProvider.cjs

@@ -0,0 +1 @@
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../Foundation/ServiceProvider.cjs`),t=require(`./Drivers/DatabaseDriver.cjs`),n=require(`./Drivers/NullDriver.cjs`),r=require(`./Drivers/SyncDriver.cjs`),i=require(`./Failed/DatabaseFailedJobProvider.cjs`),a=require(`./QueueManager.cjs`),o=require(`./Workers/Worker.cjs`);var s=class extends e.ServiceProvider{register(){this.app.singleton(`queue`,()=>{let e=new a.QueueManager(this.getConfig());return e.registerDriver(`sync`,e=>new r.SyncDriver(e)),e.registerDriver(`database`,e=>new t.DatabaseDriver(e,this.app)),e.registerDriver(`null`,e=>new n.NullDriver(e)),e}),this.app.singleton(`queue.worker`,()=>new o.Worker(this.app.make(`queue`),this.app)),this.app.singleton(`queue.failer`,()=>{let e=this.getConfig().failed||{driver:`database`,table:`failed_jobs`};return new i.DatabaseFailedJobProvider(this.app,{table:e.table||`failed_jobs`,database:e.database})})}getConfig(){try{let e=this.app.make(`config`),t=e?.items?.queue||e?.get?.(`queue`);if(t)return t}catch{}return{default:`sync`,connections:{sync:{driver:`sync`}},failed:{driver:`database`,database:`sqlite`,table:`failed_jobs`}}}};exports.QueueServiceProvider=s;

package/dist/Queue/QueueServiceProvider.d.cts

@@ -0,0 +1,17 @@
+import { ServiceProvider } from "../Foundation/ServiceProvider.cjs";
+import { QueueConfig } from "./QueueManager.cjs";
+
+//#region src/Queue/QueueServiceProvider.d.ts
+declare class QueueServiceProvider extends ServiceProvider {
+  /**
+   * Register queue services
+   */
+  register(): void;
+  /**
+   * Get the queue configuration
+   */
+  protected getConfig(): QueueConfig;
+}
+//#endregion
+export { QueueServiceProvider };
+//# sourceMappingURL=QueueServiceProvider.d.cts.map

package/dist/Queue/QueueServiceProvider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueServiceProvider.d.cts","names":[],"sources":["../../src/Queue/QueueServiceProvider.ts"],"mappings":";;;;cAgBa,oBAAA,SAA6B,eAAA;EAIxC;;;EAAA,QAAA,CAAA;EAgCkC;;;EAAA,UAAxB,SAAA,CAAA,GAAa,WAAA;AAAA"}

package/dist/Queue/QueueServiceProvider.d.mts

@@ -0,0 +1,17 @@
+import { ServiceProvider } from "../Foundation/ServiceProvider.mjs";
+import { QueueConfig } from "./QueueManager.mjs";
+
+//#region src/Queue/QueueServiceProvider.d.ts
+declare class QueueServiceProvider extends ServiceProvider {
+  /**
+   * Register queue services
+   */
+  register(): void;
+  /**
+   * Get the queue configuration
+   */
+  protected getConfig(): QueueConfig;
+}
+//#endregion
+export { QueueServiceProvider };
+//# sourceMappingURL=QueueServiceProvider.d.mts.map

package/dist/Queue/QueueServiceProvider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueServiceProvider.d.mts","names":[],"sources":["../../src/Queue/QueueServiceProvider.ts"],"mappings":";;;;cAgBa,oBAAA,SAA6B,eAAA;EAIxC;;;EAAA,QAAA,CAAA;EAgCkC;;;EAAA,UAAxB,SAAA,CAAA,GAAa,WAAA;AAAA"}

package/dist/Queue/QueueServiceProvider.mjs

@@ -0,0 +1,2 @@
+import{ServiceProvider as e}from"../Foundation/ServiceProvider.mjs";import{DatabaseDriver as t}from"./Drivers/DatabaseDriver.mjs";import{NullDriver as n}from"./Drivers/NullDriver.mjs";import{SyncDriver as r}from"./Drivers/SyncDriver.mjs";import{DatabaseFailedJobProvider as i}from"./Failed/DatabaseFailedJobProvider.mjs";import{QueueManager as a}from"./QueueManager.mjs";import{Worker as o}from"./Workers/Worker.mjs";var s=class extends e{register(){this.app.singleton(`queue`,()=>{let e=new a(this.getConfig());return e.registerDriver(`sync`,e=>new r(e)),e.registerDriver(`database`,e=>new t(e,this.app)),e.registerDriver(`null`,e=>new n(e)),e}),this.app.singleton(`queue.worker`,()=>new o(this.app.make(`queue`),this.app)),this.app.singleton(`queue.failer`,()=>{let e=this.getConfig().failed||{driver:`database`,table:`failed_jobs`};return new i(this.app,{table:e.table||`failed_jobs`,database:e.database})})}getConfig(){try{let e=this.app.make(`config`),t=e?.items?.queue||e?.get?.(`queue`);if(t)return t}catch{}return{default:`sync`,connections:{sync:{driver:`sync`}},failed:{driver:`database`,database:`sqlite`,table:`failed_jobs`}}}};export{s as QueueServiceProvider};
+//# sourceMappingURL=QueueServiceProvider.mjs.map

package/dist/Queue/QueueServiceProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueServiceProvider.mjs","names":[],"sources":["../../src/Queue/QueueServiceProvider.ts"],"sourcesContent":["/**\n * QueueServiceProvider\n *\n * Registers queue services into the container.\n * Mirrors Laravel's Illuminate\\Queue\\QueueServiceProvider.\n */\n\nimport { ServiceProvider } from '@/Foundation/ServiceProvider';\nimport type { QueueConfig } from './QueueManager';\nimport { DatabaseDriver } from './Drivers/DatabaseDriver';\nimport { NullDriver } from './Drivers/NullDriver';\nimport { SyncDriver } from './Drivers/SyncDriver';\nimport { DatabaseFailedJobProvider } from './Failed/DatabaseFailedJobProvider';\nimport { QueueManager } from './QueueManager';\nimport { Worker } from './Workers/Worker';\n\nexport class QueueServiceProvider extends ServiceProvider {\n  /**\n   * Register queue services\n   */\n  register(): void {\n    this.app.singleton('queue', () => {\n      const config = this.getConfig();\n      const manager = new QueueManager(config);\n\n      // Register built-in drivers\n      manager.registerDriver('sync', (driverConfig) => new SyncDriver(driverConfig));\n      manager.registerDriver('database', (driverConfig) => new DatabaseDriver(driverConfig, this.app));\n      manager.registerDriver('null', (driverConfig) => new NullDriver(driverConfig));\n\n      return manager;\n    });\n\n    this.app.singleton('queue.worker', () => {\n      const manager = this.app.make<QueueManager>('queue');\n      return new Worker(manager, this.app);\n    });\n\n    this.app.singleton('queue.failer', () => {\n      const config = this.getConfig();\n      const failedConfig = config.failed || { driver: 'database', table: 'failed_jobs' };\n\n      return new DatabaseFailedJobProvider(this.app, {\n        table: failedConfig.table || 'failed_jobs',\n        database: failedConfig.database,\n      });\n    });\n  }\n\n  /**\n   * Get the queue configuration\n   */\n  protected getConfig(): QueueConfig {\n    try {\n      const configService = this.app.make('config') as any;\n      const queueConfig = configService?.items?.queue || configService?.get?.('queue');\n      if (queueConfig) {\n        return queueConfig;\n      }\n    } catch {\n      // Config service not available\n    }\n\n    // Default configuration\n    return {\n      default: 'sync',\n      connections: {\n        sync: {\n          driver: 'sync',\n        },\n      },\n      failed: {\n        driver: 'database',\n        database: 'sqlite',\n        table: 'failed_jobs',\n      },\n    };\n  }\n}\n"],"mappings":"iaAgBA,IAAa,EAAb,cAA0C,CAAgB,CAIxD,UAAiB,CACf,KAAK,IAAI,UAAU,YAAe,CAEhC,IAAM,EAAU,IAAI,EADL,KAAK,WAAW,CACS,CAOxC,OAJA,EAAQ,eAAe,OAAS,GAAiB,IAAI,EAAW,EAAa,CAAC,CAC9E,EAAQ,eAAe,WAAa,GAAiB,IAAI,EAAe,EAAc,KAAK,IAAI,CAAC,CAChG,EAAQ,eAAe,OAAS,GAAiB,IAAI,EAAW,EAAa,CAAC,CAEvE,GACP,CAEF,KAAK,IAAI,UAAU,mBAEV,IAAI,EADK,KAAK,IAAI,KAAmB,QAAQ,CACzB,KAAK,IAAI,CACpC,CAEF,KAAK,IAAI,UAAU,mBAAsB,CAEvC,IAAM,EADS,KAAK,WAAW,CACH,QAAU,CAAE,OAAQ,WAAY,MAAO,cAAe,CAElF,OAAO,IAAI,EAA0B,KAAK,IAAK,CAC7C,MAAO,EAAa,OAAS,cAC7B,SAAU,EAAa,SACxB,CAAC,EACF,CAMJ,WAAmC,CACjC,GAAI,CACF,IAAM,EAAgB,KAAK,IAAI,KAAK,SAAS,CACvC,EAAc,GAAe,OAAO,OAAS,GAAe,MAAM,QAAQ,CAChF,GAAI,EACF,OAAO,OAEH,EAKR,MAAO,CACL,QAAS,OACT,YAAa,CACX,KAAM,CACJ,OAAQ,OACT,CACF,CACD,OAAQ,CACN,OAAQ,WACR,SAAU,SACV,MAAO,cACR,CACF"}

package/dist/Queue/Workers/Worker.cjs

@@ -0,0 +1 @@
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../JobPayload.cjs`),t=require(`./WorkerOptions.cjs`);var n=class{shouldQuit=!1;paused=!1;jobsProcessed=0;startTime=0;constructor(e,t){this.manager=e,this.app=t}async daemon(e,n,r={}){let i={...t.DEFAULT_WORKER_OPTIONS,...r};for(this.startTime=Date.now(),this.listenForSignals();!this.shouldQuit;){if(this.manager.fireLoopingCallbacks(),this.paused){await this.sleep(i.sleep);continue}if(await this.runNextJob(e,n,i))i.rest>0&&await this.sleep(i.rest/1e3);else{if(i.stopWhenEmpty){this.stop();break}await this.sleep(i.sleep)}this.shouldStop(i)&&this.stop()}}async runOnce(e,n,r={}){let i={...t.DEFAULT_WORKER_OPTIONS,...r};return this.runNextJob(e,n,i)}async runNextJob(e,t,n){let r=this.manager.connection(e),i=t.split(`,`).map(e=>e.trim());for(let t of i){let i=await r.pop(t);if(i)return await this.processJob(e,r,i,n),this.jobsProcessed++,!0}return!1}async processJob(t,n,r,i){let a;try{a=e.JobPayload.deserialize(r.payload)}catch{console.error(`[Queue] Invalid job payload, deleting job ${r.id}`),await n.delete(r.id);return}let o=this.manager.getJobClass(a.job);if(!o){console.error(`[Queue] Job class [${a.job}] not registered. Deleting job ${r.id}`),await n.delete(r.id);return}let s;try{s=o.fromJSON(a.data)}catch(e){console.error(`[Queue] Failed to deserialize job [${a.job}]:`,e),await n.delete(r.id);return}s.jobId=r.id,s.uuid=a.uuid,s.attempts=r.attempts;let c=s.tries??i.tries;this.manager.fireBeforeCallbacks(t,s);try{if(await this.runJobWithMiddleware(s,i),s.isReleased()){await n.release(r.id,s.getReleaseDelay());return}if(s.isDeleted()){await n.delete(r.id);return}await n.delete(r.id),this.manager.fireAfterCallbacks(t,s)}catch(e){await this.handleJobException(t,n,r,s,a,c,e)}}async runJobWithMiddleware(e,t){let n=e.middleware?.()||[],r=e.timeout??t.timeout;await this.buildMiddlewarePipeline(n,async()=>{await this.executeWithTimeout(e,r)})()}buildMiddlewarePipeline(e,t){return e.reduceRight((t,n)=>()=>n.handle(e[0],t),t)}async executeWithTimeout(e,t){if(t<=0){await e.handle();return}let n=t*1e3;await Promise.race([e.handle(),new Promise((t,r)=>{setTimeout(()=>{r(Error(`Job [${e.displayName()}] has been attempted too long or run too long. The job may have previously timed out.`))},n)})])}async handleJobException(e,t,n,r,i,a,o){if(this.manager.fireFailingCallbacks(e,r,o),a>0&&n.attempts>=a){await this.failJob(e,t,n,r,i,o);return}if(r.retryUntil&&new Date>=r.retryUntil){await this.failJob(e,t,n,r,i,o);return}let s=r.getBackoffDelay(n.attempts);await t.release(n.id,s),console.error(`[Queue] Job [${r.displayName()}] failed (attempt ${n.attempts}/${a||`unlimited`}). Retrying in ${s}s. Error: ${o.message}`)}async failJob(e,t,n,r,i,a){if(await t.delete(n.id),r.failed)try{await r.failed(a)}catch(e){console.error(`[Queue] Error in failed() handler for [${r.displayName()}]:`,e)}try{let t=this.getFailedJobProvider();t&&await t.log(e,n.queue,n.payload,a)}catch(e){console.error(`[Queue] Failed to store failed job:`,e)}console.error(`[Queue] Job [${r.displayName()}] has failed after ${n.attempts} attempt(s). Error: ${a.message}`)}getFailedJobProvider(){try{return this.app.make(`queue.failer`)}catch{return null}}shouldStop(e){return!!(e.maxJobs>0&&this.jobsProcessed>=e.maxJobs||e.maxTime>0&&(Date.now()-this.startTime)/1e3>=e.maxTime||this.memoryExceeded(e.memory))}memoryExceeded(e){return process.memoryUsage().rss/1024/1024>=e}async sleep(e){return new Promise(t=>setTimeout(t,e*1e3))}listenForSignals(){process.on(`SIGTERM`,()=>{this.shouldQuit=!0}),process.on(`SIGINT`,()=>{this.shouldQuit=!0}),process.on(`SIGUSR2`,()=>{this.shouldQuit=!0})}stop(){this.shouldQuit=!0}pause(){this.paused=!0}resume(){this.paused=!1}getJobsProcessed(){return this.jobsProcessed}};exports.Worker=n;

package/dist/Queue/Workers/Worker.d.cts

@@ -0,0 +1,94 @@
+import { Application } from "../../Foundation/Application.cjs";
+import { JobMiddleware } from "../Middleware/JobMiddleware.cjs";
+import { Job } from "../Job.cjs";
+import { QueueDriver, QueueDriverJob } from "../Contracts/QueueDriver.cjs";
+import { QueueManager } from "../QueueManager.cjs";
+import { FailedJobProvider } from "../Failed/FailedJobProvider.cjs";
+import { JobPayloadData } from "../JobPayload.cjs";
+import { WorkerOptions } from "./WorkerOptions.cjs";
+
+//#region src/Queue/Workers/Worker.d.ts
+declare class Worker {
+  protected manager: QueueManager;
+  protected app: Application;
+  protected shouldQuit: boolean;
+  protected paused: boolean;
+  protected jobsProcessed: number;
+  protected startTime: number;
+  constructor(manager: QueueManager, app: Application);
+  /**
+   * Run the worker daemon loop
+   */
+  daemon(connectionName: string, queues: string, options?: WorkerOptions): Promise<void>;
+  /**
+   * Process a single job (--once mode)
+   */
+  runOnce(connectionName: string, queues: string, options?: WorkerOptions): Promise<boolean>;
+  /**
+   * Get the next job and process it
+   */
+  runNextJob(connectionName: string, queues: string, options: Required<WorkerOptions>): Promise<boolean>;
+  /**
+   * Process a single job
+   */
+  protected processJob(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, options: Required<WorkerOptions>): Promise<void>;
+  /**
+   * Run a job through its middleware pipeline then execute it
+   */
+  protected runJobWithMiddleware(job: Job, options: Required<WorkerOptions>): Promise<void>;
+  /**
+   * Build a middleware pipeline
+   */
+  protected buildMiddlewarePipeline(middleware: JobMiddleware[], destination: () => Promise<void>): () => Promise<void>;
+  /**
+   * Execute a job with a timeout
+   */
+  protected executeWithTimeout(job: Job, timeout: number): Promise<void>;
+  /**
+   * Handle an exception that occurred while processing a job
+   */
+  protected handleJobException(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, job: Job, payload: JobPayloadData, maxTries: number, error: Error): Promise<void>;
+  /**
+   * Mark a job as failed and store it
+   */
+  protected failJob(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, job: Job, payload: JobPayloadData, error: Error): Promise<void>;
+  /**
+   * Get the failed job provider
+   */
+  protected getFailedJobProvider(): FailedJobProvider | null;
+  /**
+   * Determine if the worker should stop
+   */
+  protected shouldStop(options: Required<WorkerOptions>): boolean;
+  /**
+   * Determine if the memory limit has been exceeded
+   */
+  protected memoryExceeded(memoryLimit: number): boolean;
+  /**
+   * Sleep for the given number of seconds
+   */
+  protected sleep(seconds: number): Promise<void>;
+  /**
+   * Listen for process signals for graceful shutdown
+   */
+  protected listenForSignals(): void;
+  /**
+   * Stop the worker
+   */
+  stop(): void;
+  /**
+   * Pause the worker
+   */
+  pause(): void;
+  /**
+   * Resume the worker
+   */
+  resume(): void;
+  /**
+   * Get the number of jobs processed
+   */
+  getJobsProcessed(): number;
+}
+//#endregion
+export { Worker };
+//# sourceMappingURL=Worker.d.cts.map

package/dist/Queue/Workers/Worker.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Worker.d.cts","names":[],"sources":["../../../src/Queue/Workers/Worker.ts"],"mappings":";;;;;;;;;;cAoBa,MAAA;EAAA,UAOC,OAAA,EAAS,YAAA;EAAA,UACT,GAAA,EAAK,WAAA;EAAA,UAPP,UAAA;EAAA,UACA,MAAA;EAAA,UACA,aAAA;EAAA,UACA,SAAA;cAGE,OAAA,EAAS,YAAA,EACT,GAAA,EAAK,WAAA;EAiFP;;;EA3EJ,MAAA,CAAO,cAAA,UAAwB,MAAA,UAAgB,OAAA,GAAS,aAAA,GAAqB,OAAA;EAoJzC;;;EAzGpC,OAAA,CAAQ,cAAA,UAAwB,MAAA,UAAgB,OAAA,GAAS,aAAA,GAAqB,OAAA;EA0HtE;;;EAlHR,UAAA,CAAW,cAAA,UAAwB,MAAA,UAAgB,OAAA,EAAS,QAAA,CAAS,aAAA,IAAiB,OAAA;EA6H7B;;;EAAA,UAxG/C,UAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,OAAA,EAAS,QAAA,CAAS,aAAA,IACjB,OAAA;EAiIQ;;;EAAA,UA1DK,oBAAA,CAAqB,GAAA,EAAK,GAAA,EAAK,OAAA,EAAS,QAAA,CAAS,aAAA,IAAiB,OAAA;EA6FxE;;;EAAA,UA7EA,uBAAA,CACR,UAAA,EAAY,aAAA,IACZ,WAAA,QAAmB,OAAA,eACZ,OAAA;EA8EN;;;EAAA,UArEa,kBAAA,CAAmB,GAAA,EAAK,GAAA,EAAK,OAAA,WAAkB,OAAA;EAiJvB;;;EAAA,UAxHxB,kBAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,cAAA,EACT,QAAA,UACA,KAAA,EAAO,KAAA,GACN,OAAA;EAxNkB;;;EAAA,UAqPL,OAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,cAAA,EACT,KAAA,EAAO,KAAA,GACN,OAAA;EAjQO;;;EAAA,UAgSA,oBAAA,CAAA,GAAwB,iBAAA;EA3Rb;;;EAAA,UAsSX,UAAA,CAAW,OAAA,EAAS,QAAA,CAAS,aAAA;EA/RjC;;;EAAA,UAwTI,cAAA,CAAe,WAAA;EAxT4B;;;EAAA,UAiUrC,KAAA,CAAM,OAAA,WAAkB,OAAA;EAtRF;;;EAAA,UA6R5B,gBAAA,CAAA;EArRJ;;;EAuSN,IAAA,CAAA;EAvS2E;;;EA8S3E,KAAA,CAAA;EAxRE;;;EA+RF,MAAA,CAAA;EA7RE;;;EAoSF,gBAAA,CAAA;AAAA"}

package/dist/Queue/Workers/Worker.d.mts

@@ -0,0 +1,94 @@
+import { Application } from "../../Foundation/Application.mjs";
+import { JobMiddleware } from "../Middleware/JobMiddleware.mjs";
+import { Job } from "../Job.mjs";
+import { QueueDriver, QueueDriverJob } from "../Contracts/QueueDriver.mjs";
+import { QueueManager } from "../QueueManager.mjs";
+import { FailedJobProvider } from "../Failed/FailedJobProvider.mjs";
+import { JobPayloadData } from "../JobPayload.mjs";
+import { WorkerOptions } from "./WorkerOptions.mjs";
+
+//#region src/Queue/Workers/Worker.d.ts
+declare class Worker {
+  protected manager: QueueManager;
+  protected app: Application;
+  protected shouldQuit: boolean;
+  protected paused: boolean;
+  protected jobsProcessed: number;
+  protected startTime: number;
+  constructor(manager: QueueManager, app: Application);
+  /**
+   * Run the worker daemon loop
+   */
+  daemon(connectionName: string, queues: string, options?: WorkerOptions): Promise<void>;
+  /**
+   * Process a single job (--once mode)
+   */
+  runOnce(connectionName: string, queues: string, options?: WorkerOptions): Promise<boolean>;
+  /**
+   * Get the next job and process it
+   */
+  runNextJob(connectionName: string, queues: string, options: Required<WorkerOptions>): Promise<boolean>;
+  /**
+   * Process a single job
+   */
+  protected processJob(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, options: Required<WorkerOptions>): Promise<void>;
+  /**
+   * Run a job through its middleware pipeline then execute it
+   */
+  protected runJobWithMiddleware(job: Job, options: Required<WorkerOptions>): Promise<void>;
+  /**
+   * Build a middleware pipeline
+   */
+  protected buildMiddlewarePipeline(middleware: JobMiddleware[], destination: () => Promise<void>): () => Promise<void>;
+  /**
+   * Execute a job with a timeout
+   */
+  protected executeWithTimeout(job: Job, timeout: number): Promise<void>;
+  /**
+   * Handle an exception that occurred while processing a job
+   */
+  protected handleJobException(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, job: Job, payload: JobPayloadData, maxTries: number, error: Error): Promise<void>;
+  /**
+   * Mark a job as failed and store it
+   */
+  protected failJob(connectionName: string, driver: QueueDriver, rawJob: QueueDriverJob, job: Job, payload: JobPayloadData, error: Error): Promise<void>;
+  /**
+   * Get the failed job provider
+   */
+  protected getFailedJobProvider(): FailedJobProvider | null;
+  /**
+   * Determine if the worker should stop
+   */
+  protected shouldStop(options: Required<WorkerOptions>): boolean;
+  /**
+   * Determine if the memory limit has been exceeded
+   */
+  protected memoryExceeded(memoryLimit: number): boolean;
+  /**
+   * Sleep for the given number of seconds
+   */
+  protected sleep(seconds: number): Promise<void>;
+  /**
+   * Listen for process signals for graceful shutdown
+   */
+  protected listenForSignals(): void;
+  /**
+   * Stop the worker
+   */
+  stop(): void;
+  /**
+   * Pause the worker
+   */
+  pause(): void;
+  /**
+   * Resume the worker
+   */
+  resume(): void;
+  /**
+   * Get the number of jobs processed
+   */
+  getJobsProcessed(): number;
+}
+//#endregion
+export { Worker };
+//# sourceMappingURL=Worker.d.mts.map

package/dist/Queue/Workers/Worker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Worker.d.mts","names":[],"sources":["../../../src/Queue/Workers/Worker.ts"],"mappings":";;;;;;;;;;cAoBa,MAAA;EAAA,UAOC,OAAA,EAAS,YAAA;EAAA,UACT,GAAA,EAAK,WAAA;EAAA,UAPP,UAAA;EAAA,UACA,MAAA;EAAA,UACA,aAAA;EAAA,UACA,SAAA;cAGE,OAAA,EAAS,YAAA,EACT,GAAA,EAAK,WAAA;EAiFP;;;EA3EJ,MAAA,CAAO,cAAA,UAAwB,MAAA,UAAgB,OAAA,GAAS,aAAA,GAAqB,OAAA;EAoJzC;;;EAzGpC,OAAA,CAAQ,cAAA,UAAwB,MAAA,UAAgB,OAAA,GAAS,aAAA,GAAqB,OAAA;EA0HtE;;;EAlHR,UAAA,CAAW,cAAA,UAAwB,MAAA,UAAgB,OAAA,EAAS,QAAA,CAAS,aAAA,IAAiB,OAAA;EA6H7B;;;EAAA,UAxG/C,UAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,OAAA,EAAS,QAAA,CAAS,aAAA,IACjB,OAAA;EAiIQ;;;EAAA,UA1DK,oBAAA,CAAqB,GAAA,EAAK,GAAA,EAAK,OAAA,EAAS,QAAA,CAAS,aAAA,IAAiB,OAAA;EA6FxE;;;EAAA,UA7EA,uBAAA,CACR,UAAA,EAAY,aAAA,IACZ,WAAA,QAAmB,OAAA,eACZ,OAAA;EA8EN;;;EAAA,UArEa,kBAAA,CAAmB,GAAA,EAAK,GAAA,EAAK,OAAA,WAAkB,OAAA;EAiJvB;;;EAAA,UAxHxB,kBAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,cAAA,EACT,QAAA,UACA,KAAA,EAAO,KAAA,GACN,OAAA;EAxNkB;;;EAAA,UAqPL,OAAA,CACd,cAAA,UACA,MAAA,EAAQ,WAAA,EACR,MAAA,EAAQ,cAAA,EACR,GAAA,EAAK,GAAA,EACL,OAAA,EAAS,cAAA,EACT,KAAA,EAAO,KAAA,GACN,OAAA;EAjQO;;;EAAA,UAgSA,oBAAA,CAAA,GAAwB,iBAAA;EA3Rb;;;EAAA,UAsSX,UAAA,CAAW,OAAA,EAAS,QAAA,CAAS,aAAA;EA/RjC;;;EAAA,UAwTI,cAAA,CAAe,WAAA;EAxT4B;;;EAAA,UAiUrC,KAAA,CAAM,OAAA,WAAkB,OAAA;EAtRF;;;EAAA,UA6R5B,gBAAA,CAAA;EArRJ;;;EAuSN,IAAA,CAAA;EAvS2E;;;EA8S3E,KAAA,CAAA;EAxRE;;;EA+RF,MAAA,CAAA;EA7RE;;;EAoSF,gBAAA,CAAA;AAAA"}

package/dist/Queue/Workers/Worker.mjs

@@ -0,0 +1,2 @@
+import{JobPayload as e}from"../JobPayload.mjs";import{DEFAULT_WORKER_OPTIONS as t}from"./WorkerOptions.mjs";var n=class{shouldQuit=!1;paused=!1;jobsProcessed=0;startTime=0;constructor(e,t){this.manager=e,this.app=t}async daemon(e,n,r={}){let i={...t,...r};for(this.startTime=Date.now(),this.listenForSignals();!this.shouldQuit;){if(this.manager.fireLoopingCallbacks(),this.paused){await this.sleep(i.sleep);continue}if(await this.runNextJob(e,n,i))i.rest>0&&await this.sleep(i.rest/1e3);else{if(i.stopWhenEmpty){this.stop();break}await this.sleep(i.sleep)}this.shouldStop(i)&&this.stop()}}async runOnce(e,n,r={}){let i={...t,...r};return this.runNextJob(e,n,i)}async runNextJob(e,t,n){let r=this.manager.connection(e),i=t.split(`,`).map(e=>e.trim());for(let t of i){let i=await r.pop(t);if(i)return await this.processJob(e,r,i,n),this.jobsProcessed++,!0}return!1}async processJob(t,n,r,i){let a;try{a=e.deserialize(r.payload)}catch{console.error(`[Queue] Invalid job payload, deleting job ${r.id}`),await n.delete(r.id);return}let o=this.manager.getJobClass(a.job);if(!o){console.error(`[Queue] Job class [${a.job}] not registered. Deleting job ${r.id}`),await n.delete(r.id);return}let s;try{s=o.fromJSON(a.data)}catch(e){console.error(`[Queue] Failed to deserialize job [${a.job}]:`,e),await n.delete(r.id);return}s.jobId=r.id,s.uuid=a.uuid,s.attempts=r.attempts;let c=s.tries??i.tries;this.manager.fireBeforeCallbacks(t,s);try{if(await this.runJobWithMiddleware(s,i),s.isReleased()){await n.release(r.id,s.getReleaseDelay());return}if(s.isDeleted()){await n.delete(r.id);return}await n.delete(r.id),this.manager.fireAfterCallbacks(t,s)}catch(e){await this.handleJobException(t,n,r,s,a,c,e)}}async runJobWithMiddleware(e,t){let n=e.middleware?.()||[],r=e.timeout??t.timeout;await this.buildMiddlewarePipeline(n,async()=>{await this.executeWithTimeout(e,r)})()}buildMiddlewarePipeline(e,t){return e.reduceRight((t,n)=>()=>n.handle(e[0],t),t)}async executeWithTimeout(e,t){if(t<=0){await e.handle();return}let n=t*1e3;await Promise.race([e.handle(),new Promise((t,r)=>{setTimeout(()=>{r(Error(`Job [${e.displayName()}] has been attempted too long or run too long. The job may have previously timed out.`))},n)})])}async handleJobException(e,t,n,r,i,a,o){if(this.manager.fireFailingCallbacks(e,r,o),a>0&&n.attempts>=a){await this.failJob(e,t,n,r,i,o);return}if(r.retryUntil&&new Date>=r.retryUntil){await this.failJob(e,t,n,r,i,o);return}let s=r.getBackoffDelay(n.attempts);await t.release(n.id,s),console.error(`[Queue] Job [${r.displayName()}] failed (attempt ${n.attempts}/${a||`unlimited`}). Retrying in ${s}s. Error: ${o.message}`)}async failJob(e,t,n,r,i,a){if(await t.delete(n.id),r.failed)try{await r.failed(a)}catch(e){console.error(`[Queue] Error in failed() handler for [${r.displayName()}]:`,e)}try{let t=this.getFailedJobProvider();t&&await t.log(e,n.queue,n.payload,a)}catch(e){console.error(`[Queue] Failed to store failed job:`,e)}console.error(`[Queue] Job [${r.displayName()}] has failed after ${n.attempts} attempt(s). Error: ${a.message}`)}getFailedJobProvider(){try{return this.app.make(`queue.failer`)}catch{return null}}shouldStop(e){return!!(e.maxJobs>0&&this.jobsProcessed>=e.maxJobs||e.maxTime>0&&(Date.now()-this.startTime)/1e3>=e.maxTime||this.memoryExceeded(e.memory))}memoryExceeded(e){return process.memoryUsage().rss/1024/1024>=e}async sleep(e){return new Promise(t=>setTimeout(t,e*1e3))}listenForSignals(){process.on(`SIGTERM`,()=>{this.shouldQuit=!0}),process.on(`SIGINT`,()=>{this.shouldQuit=!0}),process.on(`SIGUSR2`,()=>{this.shouldQuit=!0})}stop(){this.shouldQuit=!0}pause(){this.paused=!0}resume(){this.paused=!1}getJobsProcessed(){return this.jobsProcessed}};export{n as Worker};
+//# sourceMappingURL=Worker.mjs.map