@orchestr-sh/orchestr 1.7.4 → 1.9.1

package/dist/Queue/Failed/DatabaseFailedJobProvider.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * DatabaseFailedJobProvider
+ *
+ * Stores failed jobs in a database table.
+ * Mirrors Laravel's Illuminate\Queue\Failed\DatabaseUuidFailedJobProvider.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseFailedJobProvider = void 0;
+const crypto_1 = require("crypto");
+class DatabaseFailedJobProvider {
+    app;
+    table;
+    databaseConnection;
+    constructor(app, config) {
+        this.app = app;
+        this.table = config.table || 'failed_jobs';
+        this.databaseConnection = config.database;
+    }
+    /**
+     * Get the database connection
+     */
+    getConnection() {
+        const db = this.app.make('db');
+        return db.connection(this.databaseConnection);
+    }
+    async log(connection, queue, payload, exception) {
+        const uuid = (0, crypto_1.randomUUID)();
+        const conn = this.getConnection();
+        await conn.table(this.table).insert({
+            uuid,
+            connection,
+            queue,
+            payload,
+            exception: this.formatException(exception),
+            failed_at: new Date().toISOString(),
+        });
+        return uuid;
+    }
+    async all() {
+        const conn = this.getConnection();
+        const results = await conn.table(this.table)
+            .orderBy('id', 'desc')
+            .get();
+        return results;
+    }
+    async find(id) {
+        const conn = this.getConnection();
+        const result = await conn.table(this.table)
+            .where('id', '=', id)
+            .orWhere('uuid', '=', String(id))
+            .first();
+        return result || null;
+    }
+    async forget(id) {
+        const conn = this.getConnection();
+        const deleted = await conn.table(this.table)
+            .where('id', '=', id)
+            .orWhere('uuid', '=', String(id))
+            .delete();
+        return deleted > 0;
+    }
+    async flush(hours) {
+        const conn = this.getConnection();
+        if (hours !== undefined && hours > 0) {
+            const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+            await conn.table(this.table)
+                .where('failed_at', '<=', cutoff)
+                .delete();
+        }
+        else {
+            await conn.table(this.table).delete();
+        }
+    }
+    async count(connection, queue) {
+        const conn = this.getConnection();
+        let query = conn.table(this.table);
+        if (connection) {
+            query = query.where('connection', '=', connection);
+        }
+        if (queue) {
+            query = query.where('queue', '=', queue);
+        }
+        return Number(await query.count()) || 0;
+    }
+    /**
+     * Format an exception for storage
+     */
+    formatException(exception) {
+        const lines = [
+            `${exception.constructor.name}: ${exception.message}`,
+        ];
+        if (exception.stack) {
+            lines.push('', exception.stack);
+        }
+        return lines.join('\n');
+    }
+}
+exports.DatabaseFailedJobProvider = DatabaseFailedJobProvider;
+//# sourceMappingURL=DatabaseFailedJobProvider.js.map

package/dist/Queue/Failed/DatabaseFailedJobProvider.js.map

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

package/dist/Queue/Failed/FailedJobProvider.d.ts

@@ -0,0 +1,42 @@
+/**
+ * FailedJobProvider Contract
+ *
+ * Defines the interface for failed job storage implementations.
+ * Mirrors Laravel's Illuminate\Queue\Failed\FailedJobProviderInterface.
+ */
+export interface FailedJobRecord {
+    id: number | string;
+    uuid: string;
+    connection: string;
+    queue: string;
+    payload: string;
+    exception: string;
+    failed_at: string;
+}
+export interface FailedJobProvider {
+    /**
+     * Log a failed job
+     */
+    log(connection: string, queue: string, payload: string, exception: Error): Promise<string | number>;
+    /**
+     * Get a list of all failed jobs
+     */
+    all(): Promise<FailedJobRecord[]>;
+    /**
+     * Get a single failed job by ID
+     */
+    find(id: string | number): Promise<FailedJobRecord | null>;
+    /**
+     * Delete a single failed job
+     */
+    forget(id: string | number): Promise<boolean>;
+    /**
+     * Delete all failed jobs
+     */
+    flush(hours?: number): Promise<void>;
+    /**
+     * Count all failed jobs
+     */
+    count(connection?: string, queue?: string): Promise<number>;
+}
+//# sourceMappingURL=FailedJobProvider.d.ts.map

package/dist/Queue/Failed/FailedJobProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailedJobProvider.d.ts","sourceRoot":"","sources":["../../../src/Queue/Failed/FailedJobProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,CACD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,GACf,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAE5B;;OAEG;IACH,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAElC;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D"}

package/dist/Queue/Failed/FailedJobProvider.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * FailedJobProvider Contract
+ *
+ * Defines the interface for failed job storage implementations.
+ * Mirrors Laravel's Illuminate\Queue\Failed\FailedJobProviderInterface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=FailedJobProvider.js.map

package/dist/Queue/Failed/FailedJobProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailedJobProvider.js","sourceRoot":"","sources":["../../../src/Queue/Failed/FailedJobProvider.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/Queue/Job.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Job Base Class
+ *
+ * Base class for all queueable jobs in the application.
+ * Mirrors Laravel's Job with Dispatchable, InteractsWithQueue,
+ * Queueable, and SerializesModels traits.
+ *
+ * @example
+ * ```typescript
+ * class ProcessPodcast extends Job {
+ *   public tries = 5;
+ *   public timeout = 120;
+ *   public backoff = [10, 30, 60];
+ *
+ *   constructor(public podcastId: number) {
+ *     super();
+ *   }
+ *
+ *   async handle(): Promise<void> {
+ *     // Process podcast...
+ *   }
+ *
+ *   async failed(error: Error): Promise<void> {
+ *     console.error('Failed:', error);
+ *   }
+ * }
+ *
+ * // Dispatch
+ * await ProcessPodcast.dispatch(podcastId);
+ * await ProcessPodcast.dispatch(podcastId).onQueue('high').delay(60);
+ * ```
+ */
+import type { QueueableJob } from './Contracts/QueueableJob';
+import type { JobMiddleware } from './Middleware/JobMiddleware';
+export declare abstract class Job implements QueueableJob {
+    /**
+     * The unique identifier for the job
+     */
+    uuid: string;
+    /**
+     * The name of the connection the job should be sent to
+     */
+    connection?: string;
+    /**
+     * The name of the queue the job should be sent to
+     */
+    queue?: string;
+    /**
+     * The number of seconds before the job should be processed
+     */
+    delay?: number | Date;
+    /**
+     * The number of times the job may be attempted
+     */
+    tries?: number;
+    /**
+     * The maximum number of unhandled exceptions to allow before failing
+     */
+    maxExceptions?: number;
+    /**
+     * The number of seconds the job can run before timing out
+     */
+    timeout?: number;
+    /**
+     * The number of seconds to wait before retrying the job
+     */
+    backoff?: number | number[];
+    /**
+     * The timestamp after which the job should no longer be retried
+     */
+    retryUntil?: Date;
+    /**
+     * Indicate if the job should be marked as failed on timeout
+     */
+    failOnTimeout?: boolean;
+    /**
+     * Indicate if the job should be dispatched after all database transactions have committed
+     */
+    afterCommit?: boolean;
+    /**
+     * Internal: the job ID from the queue driver
+     */
+    jobId?: string;
+    /**
+     * Internal: the number of times the job has been attempted
+     */
+    attempts: number;
+    /**
+     * Internal: whether the job has been deleted
+     */
+    protected _deleted: boolean;
+    /**
+     * Internal: whether the job has been released
+     */
+    protected _released: boolean;
+    /**
+     * Internal: the release delay
+     */
+    protected _releaseDelay: number;
+    /**
+     * Internal: whether the job has been marked as failed
+     */
+    protected _failed: boolean;
+    constructor();
+    /**
+     * Execute the job
+     */
+    abstract handle(...args: any[]): Promise<void> | void;
+    /**
+     * Handle a job failure
+     */
+    failed?(error: Error): Promise<void> | void;
+    /**
+     * Get the middleware the job should pass through
+     */
+    middleware?(): JobMiddleware[];
+    /**
+     * Get the display name of the job
+     */
+    displayName(): string;
+    /**
+     * Delete the job from the queue
+     */
+    delete(): void;
+    /**
+     * Release the job back onto the queue after a delay
+     */
+    release(delay?: number): void;
+    /**
+     * Mark the job as failed
+     */
+    fail(error?: Error): void;
+    /**
+     * Determine if the job has been deleted
+     */
+    isDeleted(): boolean;
+    /**
+     * Determine if the job has been released
+     */
+    isReleased(): boolean;
+    /**
+     * Get the release delay
+     */
+    getReleaseDelay(): number;
+    /**
+     * Determine if the job has been marked as failed
+     */
+    hasFailed(): boolean;
+    /**
+     * Determine if the job has exceeded the maximum number of attempts
+     */
+    hasExceededMaxAttempts(): boolean;
+    /**
+     * Get the number of seconds to wait before retrying the job
+     */
+    getBackoffDelay(attempt: number): number;
+    /**
+     * Serialize the job for queue storage
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Serialize a value for JSON storage
+     */
+    protected serializeValue(value: any): any;
+    /**
+     * Restore a job from serialized data
+     */
+    static fromJSON<T extends Job>(this: typeof Job & (new (...args: any[]) => T), data: Record<string, any>): T;
+    /**
+     * Deserialize a value from JSON
+     */
+    protected static deserializeValue(value: any): any;
+    /**
+     * Static dispatch methods (applied by applyJobDispatchable)
+     * These are typed via the JobClass type helper below
+     */
+    static dispatch: (...args: any[]) => any;
+    static dispatchSync: (...args: any[]) => Promise<void>;
+    static dispatchIf: (condition: boolean | (() => boolean), ...args: any[]) => any;
+    static dispatchUnless: (condition: boolean | (() => boolean), ...args: any[]) => any;
+    static dispatchAfterResponse: (...args: any[]) => void;
+}
+/**
+ * Type helper for Job classes with static dispatch methods
+ */
+export type JobClass<T extends Job = Job> = typeof Job & {
+    new (...args: any[]): T;
+    dispatch(...args: any[]): import('./PendingDispatch').PendingDispatch;
+    dispatchSync(...args: any[]): Promise<void>;
+    dispatchIf(condition: boolean | (() => boolean), ...args: any[]): import('./PendingDispatch').PendingDispatch | null;
+    dispatchUnless(condition: boolean | (() => boolean), ...args: any[]): import('./PendingDispatch').PendingDispatch | null;
+    dispatchAfterResponse(...args: any[]): void;
+};
+//# sourceMappingURL=Job.d.ts.map

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

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

package/dist/Queue/Job.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * Job Base Class
+ *
+ * Base class for all queueable jobs in the application.
+ * Mirrors Laravel's Job with Dispatchable, InteractsWithQueue,
+ * Queueable, and SerializesModels traits.
+ *
+ * @example
+ * ```typescript
+ * class ProcessPodcast extends Job {
+ *   public tries = 5;
+ *   public timeout = 120;
+ *   public backoff = [10, 30, 60];
+ *
+ *   constructor(public podcastId: number) {
+ *     super();
+ *   }
+ *
+ *   async handle(): Promise<void> {
+ *     // Process podcast...
+ *   }
+ *
+ *   async failed(error: Error): Promise<void> {
+ *     console.error('Failed:', error);
+ *   }
+ * }
+ *
+ * // Dispatch
+ * await ProcessPodcast.dispatch(podcastId);
+ * await ProcessPodcast.dispatch(podcastId).onQueue('high').delay(60);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Job = void 0;
+const crypto_1 = require("crypto");
+class Job {
+    /**
+     * The unique identifier for the job
+     */
+    uuid;
+    /**
+     * The name of the connection the job should be sent to
+     */
+    connection;
+    /**
+     * The name of the queue the job should be sent to
+     */
+    queue;
+    /**
+     * The number of seconds before the job should be processed
+     */
+    delay;
+    /**
+     * The number of times the job may be attempted
+     */
+    tries = 1;
+    /**
+     * The maximum number of unhandled exceptions to allow before failing
+     */
+    maxExceptions;
+    /**
+     * The number of seconds the job can run before timing out
+     */
+    timeout = 60;
+    /**
+     * The number of seconds to wait before retrying the job
+     */
+    backoff;
+    /**
+     * The timestamp after which the job should no longer be retried
+     */
+    retryUntil;
+    /**
+     * Indicate if the job should be marked as failed on timeout
+     */
+    failOnTimeout = false;
+    /**
+     * Indicate if the job should be dispatched after all database transactions have committed
+     */
+    afterCommit = false;
+    /**
+     * Internal: the job ID from the queue driver
+     */
+    jobId;
+    /**
+     * Internal: the number of times the job has been attempted
+     */
+    attempts = 0;
+    /**
+     * Internal: whether the job has been deleted
+     */
+    _deleted = false;
+    /**
+     * Internal: whether the job has been released
+     */
+    _released = false;
+    /**
+     * Internal: the release delay
+     */
+    _releaseDelay = 0;
+    /**
+     * Internal: whether the job has been marked as failed
+     */
+    _failed = false;
+    constructor() {
+        this.uuid = (0, crypto_1.randomUUID)();
+    }
+    /**
+     * Get the display name of the job
+     */
+    displayName() {
+        return this.constructor.name;
+    }
+    /**
+     * Delete the job from the queue
+     */
+    delete() {
+        this._deleted = true;
+    }
+    /**
+     * Release the job back onto the queue after a delay
+     */
+    release(delay = 0) {
+        this._released = true;
+        this._releaseDelay = delay;
+    }
+    /**
+     * Mark the job as failed
+     */
+    fail(error) {
+        this._failed = true;
+        if (error && this.failed) {
+            this.failed(error);
+        }
+    }
+    /**
+     * Determine if the job has been deleted
+     */
+    isDeleted() {
+        return this._deleted;
+    }
+    /**
+     * Determine if the job has been released
+     */
+    isReleased() {
+        return this._released;
+    }
+    /**
+     * Get the release delay
+     */
+    getReleaseDelay() {
+        return this._releaseDelay;
+    }
+    /**
+     * Determine if the job has been marked as failed
+     */
+    hasFailed() {
+        return this._failed;
+    }
+    /**
+     * Determine if the job has exceeded the maximum number of attempts
+     */
+    hasExceededMaxAttempts() {
+        if (this.tries && this.attempts >= this.tries) {
+            return true;
+        }
+        if (this.retryUntil && new Date() >= this.retryUntil) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get the number of seconds to wait before retrying the job
+     */
+    getBackoffDelay(attempt) {
+        const backoff = this.backoff;
+        if (backoff === undefined || backoff === null) {
+            return 0;
+        }
+        if (typeof backoff === 'number') {
+            return backoff;
+        }
+        if (Array.isArray(backoff)) {
+            return backoff[Math.min(attempt - 1, backoff.length - 1)] ?? 0;
+        }
+        return 0;
+    }
+    /**
+     * Serialize the job for queue storage
+     */
+    toJSON() {
+        const data = {
+            _class: this.constructor.name,
+        };
+        const properties = Object.getOwnPropertyNames(this);
+        for (const prop of properties) {
+            // Skip internal properties
+            if (prop.startsWith('_'))
+                continue;
+            const value = this[prop];
+            if (value !== undefined) {
+                data[prop] = this.serializeValue(value);
+            }
+        }
+        return data;
+    }
+    /**
+     * Serialize a value for JSON storage
+     */
+    serializeValue(value) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (value instanceof Date) {
+            return { _type: 'Date', value: value.toISOString() };
+        }
+        if (typeof value === 'object' && typeof value.toJSON === 'function') {
+            return value.toJSON();
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.serializeValue(item));
+        }
+        if (typeof value === 'object') {
+            const serialized = {};
+            for (const [key, val] of Object.entries(value)) {
+                serialized[key] = this.serializeValue(val);
+            }
+            return serialized;
+        }
+        return value;
+    }
+    /**
+     * Restore a job from serialized data
+     */
+    static fromJSON(data) {
+        const instance = Object.create(this.prototype);
+        for (const [key, value] of Object.entries(data)) {
+            if (key === '_class')
+                continue;
+            instance[key] = Job.deserializeValue(value);
+        }
+        return instance;
+    }
+    /**
+     * Deserialize a value from JSON
+     */
+    static deserializeValue(value) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (typeof value === 'object' && value._type) {
+            switch (value._type) {
+                case 'Date':
+                    return new Date(value.value);
+                default:
+                    return value;
+            }
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.deserializeValue(item));
+        }
+        if (typeof value === 'object') {
+            const deserialized = {};
+            for (const [key, val] of Object.entries(value)) {
+                deserialized[key] = this.deserializeValue(val);
+            }
+            return deserialized;
+        }
+        return value;
+    }
+    /**
+     * Static dispatch methods (applied by applyJobDispatchable)
+     * These are typed via the JobClass type helper below
+     */
+    static dispatch;
+    static dispatchSync;
+    static dispatchIf;
+    static dispatchUnless;
+    static dispatchAfterResponse;
+}
+exports.Job = Job;
+// Apply dispatch methods
+const Dispatchable_1 = require("./Concerns/Dispatchable");
+(0, Dispatchable_1.applyJobDispatchable)(Job);
+//# sourceMappingURL=Job.js.map

package/dist/Queue/Job.js.map

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