@igniter-js/jobs 0.1.12 → 0.1.14

package/dist/{adapter-CXZxomI9.d.mts → adapter-Cax_40HW.d.mts}

@@ -167,6 +167,10 @@ interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema
          */
         createdAt?: Date;
         metadata?: Record<string, unknown>;
+        /**
+         * Reports job progress and triggers the public progress hook when supported by the adapter.
+         */
+        updateProgress?: (progress: number, message?: string) => Promise<void>;
     };
     scope?: IgniterJobsScopeEntry;
 }
@@ -235,12 +239,12 @@ interface IgniterCronDefinition<TContext, TResult = unknown> {
     startDate?: Date;
     /** Optional end date for the schedule (adapter-dependent). */
     endDate?: Date;
-    handler: (context: Omit<IgniterJobsExecutionContext<TContext, unknown>, 'input'>) => Promise<TResult> | TResult;
+    handler: (context: Omit<IgniterJobsExecutionContext<TContext, unknown>, "input">) => Promise<TResult> | TResult;
 }
 /**
  * Supported job states for management queries.
  */
-type IgniterJobStatus = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused';
+type IgniterJobStatus = "waiting" | "active" | "completed" | "failed" | "delayed" | "paused";
 /**
  * Result shape for job inspection calls.
  */
@@ -475,7 +479,7 @@ type IgniterJobsAdapterScheduleParams = {
 interface IgniterJobsJobLog {
     timestamp: Date;
     message: string;
-    level: 'info' | 'warn' | 'error';
+    level: "info" | "warn" | "error";
 }
 /**
  * Adapter contract for jobs backends.
@@ -506,8 +510,6 @@ interface IgniterJobsAdapter {
         force?: boolean;
     }): Promise<void>;
     retryAllInQueue(queue: string): Promise<number>;
-    pauseJobType(queue: string, jobName: string): Promise<void>;
-    resumeJobType(queue: string, jobName: string): Promise<void>;
     searchJobs(filter: Record<string, unknown>): Promise<IgniterJobSearchResult[]>;
     searchQueues(filter: Record<string, unknown>): Promise<IgniterJobsQueueInfo[]>;
     searchWorkers(filter: Record<string, unknown>): Promise<IgniterJobsWorkerHandle[]>;
@@ -525,5 +527,24 @@ interface IgniterJobsAdapter {
 interface IgniterJobsBullMQAdapterOptions {
     redis: Redis;
 }
+/**
+ * Configuration for the Bun SQLite adapter.
+ */
+interface IgniterJobsBunSQLiteAdapterOptions {
+    /** SQLite file path used by the embedded runtime. */
+    path: string;
+    /** Forces immediate persistence for dispatched jobs. @default false */
+    durable?: boolean;
+    /** Worker heartbeat interval in milliseconds. @default 10000 */
+    heartbeatInterval?: number;
+    /** Long-poll timeout while the queue is empty. @default 0 */
+    pollTimeout?: number;
+    /** Number of jobs pulled per worker batch. @default 10 */
+    batchSize?: number;
+    /** Lock duration for active jobs in milliseconds. @default 30000 */
+    lockDuration?: number;
+    /** Maximum stalled detections before a job fails. @default 1 */
+    maxStalledCount?: number;
+}
 
-export type { IgniterJobsEvent as A, IgniterJobsExecutionContext as B, IgniterJobsFailureHook as C, IgniterJobsHookContext as D, IgniterJobsInferSchemaOutput as E, IgniterJobsInvokeOptions as F, IgniterJobsProgressHook as G, IgniterJobsScheduleOptions as H, IgniterJobsAdapter as I, IgniterJobsStartHook as J, IgniterJobsSuccessHook as K, IgniterJobsWorkerMetrics as L, IgniterJobsQueueManager as a, IgniterJobsBullMQAdapterOptions as b, IgniterJobDefinition as c, IgniterCronDefinition as d, IgniterJobsAdapterDispatchParams as e, IgniterJobsAdapterScheduleParams as f, IgniterJobSearchResult as g, IgniterJobStatus as h, IgniterJobsJobLog as i, IgniterJobsQueueInfo as j, IgniterJobsQueueCleanOptions as k, IgniterJobsWorkerHandle as l, IgniterJobsWorkerBuilderConfig as m, IgniterJobsEventHandler as n, IgniterJobCounts as o, IgniterJobsQueue as p, IgniterJobsScopeDefinition as q, IgniterJobsTelemetry as r, IgniterJobsLimiter as s, IgniterJobsWorkerHandlers as t, IgniterJobsDispatchParams as u, IgniterJobsScheduleParams as v, IgniterJobsInferSchemaInput as w, IgniterJobsScopeEntry as x, IgniterJobsSchema as y, IgniterJobsScopeOptions as z };
+export type { IgniterJobsExecutionContext as A, IgniterJobsFailureHook as B, IgniterJobsHookContext as C, IgniterJobsInferSchemaOutput as D, IgniterJobsInvokeOptions as E, IgniterJobsJobLog as F, IgniterJobsProgressHook as G, IgniterJobsQueueManager as H, IgniterJobsQueue as I, IgniterJobsScheduleOptions as J, IgniterJobsStartHook as K, IgniterJobsSuccessHook as L, IgniterJobsWorkerMetrics as M, IgniterJobsAdapter as a, IgniterJobsScopeDefinition as b, IgniterJobDefinition as c, IgniterJobsWorkerBuilderConfig as d, IgniterJobsTelemetry as e, IgniterJobsEventHandler as f, IgniterJobSearchResult as g, IgniterJobsQueueInfo as h, IgniterJobsWorkerHandle as i, IgniterJobsLimiter as j, IgniterJobsWorkerHandlers as k, IgniterJobsQueueCleanOptions as l, IgniterJobStatus as m, IgniterJobsDispatchParams as n, IgniterJobsScheduleParams as o, IgniterJobsInferSchemaInput as p, IgniterCronDefinition as q, IgniterJobsScopeEntry as r, IgniterJobsSchema as s, IgniterJobsScopeOptions as t, IgniterJobCounts as u, IgniterJobsAdapterDispatchParams as v, IgniterJobsAdapterScheduleParams as w, IgniterJobsBullMQAdapterOptions as x, IgniterJobsBunSQLiteAdapterOptions as y, IgniterJobsEvent as z };

package/dist/{adapter-CXZxomI9.d.ts → adapter-Cax_40HW.d.ts}

@@ -167,6 +167,10 @@ interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema
          */
         createdAt?: Date;
         metadata?: Record<string, unknown>;
+        /**
+         * Reports job progress and triggers the public progress hook when supported by the adapter.
+         */
+        updateProgress?: (progress: number, message?: string) => Promise<void>;
     };
     scope?: IgniterJobsScopeEntry;
 }
@@ -235,12 +239,12 @@ interface IgniterCronDefinition<TContext, TResult = unknown> {
     startDate?: Date;
     /** Optional end date for the schedule (adapter-dependent). */
     endDate?: Date;
-    handler: (context: Omit<IgniterJobsExecutionContext<TContext, unknown>, 'input'>) => Promise<TResult> | TResult;
+    handler: (context: Omit<IgniterJobsExecutionContext<TContext, unknown>, "input">) => Promise<TResult> | TResult;
 }
 /**
  * Supported job states for management queries.
  */
-type IgniterJobStatus = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused';
+type IgniterJobStatus = "waiting" | "active" | "completed" | "failed" | "delayed" | "paused";
 /**
  * Result shape for job inspection calls.
  */
@@ -475,7 +479,7 @@ type IgniterJobsAdapterScheduleParams = {
 interface IgniterJobsJobLog {
     timestamp: Date;
     message: string;
-    level: 'info' | 'warn' | 'error';
+    level: "info" | "warn" | "error";
 }
 /**
  * Adapter contract for jobs backends.
@@ -506,8 +510,6 @@ interface IgniterJobsAdapter {
         force?: boolean;
     }): Promise<void>;
     retryAllInQueue(queue: string): Promise<number>;
-    pauseJobType(queue: string, jobName: string): Promise<void>;
-    resumeJobType(queue: string, jobName: string): Promise<void>;
     searchJobs(filter: Record<string, unknown>): Promise<IgniterJobSearchResult[]>;
     searchQueues(filter: Record<string, unknown>): Promise<IgniterJobsQueueInfo[]>;
     searchWorkers(filter: Record<string, unknown>): Promise<IgniterJobsWorkerHandle[]>;
@@ -525,5 +527,24 @@ interface IgniterJobsAdapter {
 interface IgniterJobsBullMQAdapterOptions {
     redis: Redis;
 }
+/**
+ * Configuration for the Bun SQLite adapter.
+ */
+interface IgniterJobsBunSQLiteAdapterOptions {
+    /** SQLite file path used by the embedded runtime. */
+    path: string;
+    /** Forces immediate persistence for dispatched jobs. @default false */
+    durable?: boolean;
+    /** Worker heartbeat interval in milliseconds. @default 10000 */
+    heartbeatInterval?: number;
+    /** Long-poll timeout while the queue is empty. @default 0 */
+    pollTimeout?: number;
+    /** Number of jobs pulled per worker batch. @default 10 */
+    batchSize?: number;
+    /** Lock duration for active jobs in milliseconds. @default 30000 */
+    lockDuration?: number;
+    /** Maximum stalled detections before a job fails. @default 1 */
+    maxStalledCount?: number;
+}
 
-export type { IgniterJobsEvent as A, IgniterJobsExecutionContext as B, IgniterJobsFailureHook as C, IgniterJobsHookContext as D, IgniterJobsInferSchemaOutput as E, IgniterJobsInvokeOptions as F, IgniterJobsProgressHook as G, IgniterJobsScheduleOptions as H, IgniterJobsAdapter as I, IgniterJobsStartHook as J, IgniterJobsSuccessHook as K, IgniterJobsWorkerMetrics as L, IgniterJobsQueueManager as a, IgniterJobsBullMQAdapterOptions as b, IgniterJobDefinition as c, IgniterCronDefinition as d, IgniterJobsAdapterDispatchParams as e, IgniterJobsAdapterScheduleParams as f, IgniterJobSearchResult as g, IgniterJobStatus as h, IgniterJobsJobLog as i, IgniterJobsQueueInfo as j, IgniterJobsQueueCleanOptions as k, IgniterJobsWorkerHandle as l, IgniterJobsWorkerBuilderConfig as m, IgniterJobsEventHandler as n, IgniterJobCounts as o, IgniterJobsQueue as p, IgniterJobsScopeDefinition as q, IgniterJobsTelemetry as r, IgniterJobsLimiter as s, IgniterJobsWorkerHandlers as t, IgniterJobsDispatchParams as u, IgniterJobsScheduleParams as v, IgniterJobsInferSchemaInput as w, IgniterJobsScopeEntry as x, IgniterJobsSchema as y, IgniterJobsScopeOptions as z };
+export type { IgniterJobsExecutionContext as A, IgniterJobsFailureHook as B, IgniterJobsHookContext as C, IgniterJobsInferSchemaOutput as D, IgniterJobsInvokeOptions as E, IgniterJobsJobLog as F, IgniterJobsProgressHook as G, IgniterJobsQueueManager as H, IgniterJobsQueue as I, IgniterJobsScheduleOptions as J, IgniterJobsStartHook as K, IgniterJobsSuccessHook as L, IgniterJobsWorkerMetrics as M, IgniterJobsAdapter as a, IgniterJobsScopeDefinition as b, IgniterJobDefinition as c, IgniterJobsWorkerBuilderConfig as d, IgniterJobsTelemetry as e, IgniterJobsEventHandler as f, IgniterJobSearchResult as g, IgniterJobsQueueInfo as h, IgniterJobsWorkerHandle as i, IgniterJobsLimiter as j, IgniterJobsWorkerHandlers as k, IgniterJobsQueueCleanOptions as l, IgniterJobStatus as m, IgniterJobsDispatchParams as n, IgniterJobsScheduleParams as o, IgniterJobsInferSchemaInput as p, IgniterCronDefinition as q, IgniterJobsScopeEntry as r, IgniterJobsSchema as s, IgniterJobsScopeOptions as t, IgniterJobCounts as u, IgniterJobsAdapterDispatchParams as v, IgniterJobsAdapterScheduleParams as w, IgniterJobsBullMQAdapterOptions as x, IgniterJobsBunSQLiteAdapterOptions as y, IgniterJobsEvent as z };

package/dist/adapters/bun.d.mts

@@ -0,0 +1,93 @@
+import { a as IgniterJobsAdapter, H as IgniterJobsQueueManager, y as IgniterJobsBunSQLiteAdapterOptions, c as IgniterJobDefinition, q as IgniterCronDefinition, v as IgniterJobsAdapterDispatchParams, w as IgniterJobsAdapterScheduleParams, g as IgniterJobSearchResult, m as IgniterJobStatus, F as IgniterJobsJobLog, h as IgniterJobsQueueInfo, u as IgniterJobCounts, l as IgniterJobsQueueCleanOptions, i as IgniterJobsWorkerHandle, d as IgniterJobsWorkerBuilderConfig, f as IgniterJobsEventHandler } from '../adapter-Cax_40HW.mjs';
+import 'ioredis';
+import '@igniter-js/common';
+
+/**
+ * @fileoverview Bun SQLite adapter for @igniter-js/jobs
+ * @module @igniter-js/jobs/adapters/bun-sqlite
+ */
+
+/**
+ * Bun-native SQLite adapter for local, embedded, and desktop workloads.
+ */
+declare class IgniterJobsBunSQLiteAdapter implements IgniterJobsAdapter {
+    readonly client: {
+        type: "bun-sqlite";
+        path: string;
+    };
+    readonly queues: IgniterJobsQueueManager;
+    private readonly options;
+    private bunqueueModulePromise;
+    private readonly queueRuntimes;
+    private readonly workers;
+    private readonly subscribers;
+    private readonly registeredJobs;
+    private readonly registeredCrons;
+    private constructor();
+    static create(options: IgniterJobsBunSQLiteAdapterOptions): IgniterJobsAdapter;
+    registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
+    registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
+    dispatch(params: IgniterJobsAdapterDispatchParams): Promise<string>;
+    schedule(params: IgniterJobsAdapterScheduleParams): Promise<string>;
+    getJob(jobId: string, queue?: string): Promise<IgniterJobSearchResult | null>;
+    getJobState(jobId: string, queue?: string): Promise<IgniterJobStatus | null>;
+    getJobLogs(jobId: string, queue?: string): Promise<IgniterJobsJobLog[]>;
+    getJobProgress(jobId: string, queue?: string): Promise<number>;
+    retryJob(jobId: string, queue?: string): Promise<void>;
+    removeJob(jobId: string, queue?: string): Promise<void>;
+    promoteJob(jobId: string, queue?: string): Promise<void>;
+    moveJobToFailed(jobId: string, reason: string, queue?: string): Promise<void>;
+    retryManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    removeManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    getQueueInfo(queue: string): Promise<IgniterJobsQueueInfo | null>;
+    getQueueJobCounts(queue: string): Promise<IgniterJobCounts>;
+    listQueues(): Promise<IgniterJobsQueueInfo[]>;
+    pauseQueue(queue: string): Promise<void>;
+    resumeQueue(queue: string): Promise<void>;
+    drainQueue(queue: string): Promise<number>;
+    cleanQueue(queue: string, options: IgniterJobsQueueCleanOptions): Promise<number>;
+    obliterateQueue(queue: string, _options?: {
+        force?: boolean;
+    }): Promise<void>;
+    retryAllInQueue(queue: string): Promise<number>;
+    searchJobs(filter: Record<string, unknown>): Promise<IgniterJobSearchResult[]>;
+    searchQueues(filter: Record<string, unknown>): Promise<IgniterJobsQueueInfo[]>;
+    searchWorkers(filter: Record<string, unknown>): Promise<IgniterJobsWorkerHandle[]>;
+    createWorker(config: IgniterJobsWorkerBuilderConfig): Promise<IgniterJobsWorkerHandle>;
+    getWorkers(): Map<string, IgniterJobsWorkerHandle>;
+    publishEvent(channel: string, payload: unknown): Promise<void>;
+    subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    shutdown(): Promise<void>;
+    private loadBunqueue;
+    private getQueue;
+    private getAllQueueNames;
+    private markQueueCronsDirty;
+    private syncCronSchedulers;
+    private createEnvelope;
+    private toJobOptions;
+    private processJob;
+    private processRegisteredDefinition;
+    private processRegisteredCron;
+    private createExecutionContext;
+    private attachWorkerEvents;
+    private toWorkerHandle;
+    private buildWorkerMetrics;
+    private closeWorkerState;
+    private requireJob;
+    private findQueueByJobId;
+    private mapJob;
+    private mapJobSync;
+    private normalizeEnvelope;
+    private toPublicStatus;
+    private toBunqueueStatus;
+    private toBunqueueStates;
+    private distributeConcurrency;
+    private shouldExecuteScheduledJob;
+    private parseLogEntry;
+    private writeLog;
+    private writeQueueLog;
+    private invokeHook;
+    private invokeHandler;
+}
+
+export { IgniterJobsBunSQLiteAdapter, IgniterJobsBunSQLiteAdapterOptions };

package/dist/adapters/bun.d.ts

@@ -0,0 +1,93 @@
+import { a as IgniterJobsAdapter, H as IgniterJobsQueueManager, y as IgniterJobsBunSQLiteAdapterOptions, c as IgniterJobDefinition, q as IgniterCronDefinition, v as IgniterJobsAdapterDispatchParams, w as IgniterJobsAdapterScheduleParams, g as IgniterJobSearchResult, m as IgniterJobStatus, F as IgniterJobsJobLog, h as IgniterJobsQueueInfo, u as IgniterJobCounts, l as IgniterJobsQueueCleanOptions, i as IgniterJobsWorkerHandle, d as IgniterJobsWorkerBuilderConfig, f as IgniterJobsEventHandler } from '../adapter-Cax_40HW.js';
+import 'ioredis';
+import '@igniter-js/common';
+
+/**
+ * @fileoverview Bun SQLite adapter for @igniter-js/jobs
+ * @module @igniter-js/jobs/adapters/bun-sqlite
+ */
+
+/**
+ * Bun-native SQLite adapter for local, embedded, and desktop workloads.
+ */
+declare class IgniterJobsBunSQLiteAdapter implements IgniterJobsAdapter {
+    readonly client: {
+        type: "bun-sqlite";
+        path: string;
+    };
+    readonly queues: IgniterJobsQueueManager;
+    private readonly options;
+    private bunqueueModulePromise;
+    private readonly queueRuntimes;
+    private readonly workers;
+    private readonly subscribers;
+    private readonly registeredJobs;
+    private readonly registeredCrons;
+    private constructor();
+    static create(options: IgniterJobsBunSQLiteAdapterOptions): IgniterJobsAdapter;
+    registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
+    registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
+    dispatch(params: IgniterJobsAdapterDispatchParams): Promise<string>;
+    schedule(params: IgniterJobsAdapterScheduleParams): Promise<string>;
+    getJob(jobId: string, queue?: string): Promise<IgniterJobSearchResult | null>;
+    getJobState(jobId: string, queue?: string): Promise<IgniterJobStatus | null>;
+    getJobLogs(jobId: string, queue?: string): Promise<IgniterJobsJobLog[]>;
+    getJobProgress(jobId: string, queue?: string): Promise<number>;
+    retryJob(jobId: string, queue?: string): Promise<void>;
+    removeJob(jobId: string, queue?: string): Promise<void>;
+    promoteJob(jobId: string, queue?: string): Promise<void>;
+    moveJobToFailed(jobId: string, reason: string, queue?: string): Promise<void>;
+    retryManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    removeManyJobs(jobIds: string[], queue?: string): Promise<void>;
+    getQueueInfo(queue: string): Promise<IgniterJobsQueueInfo | null>;
+    getQueueJobCounts(queue: string): Promise<IgniterJobCounts>;
+    listQueues(): Promise<IgniterJobsQueueInfo[]>;
+    pauseQueue(queue: string): Promise<void>;
+    resumeQueue(queue: string): Promise<void>;
+    drainQueue(queue: string): Promise<number>;
+    cleanQueue(queue: string, options: IgniterJobsQueueCleanOptions): Promise<number>;
+    obliterateQueue(queue: string, _options?: {
+        force?: boolean;
+    }): Promise<void>;
+    retryAllInQueue(queue: string): Promise<number>;
+    searchJobs(filter: Record<string, unknown>): Promise<IgniterJobSearchResult[]>;
+    searchQueues(filter: Record<string, unknown>): Promise<IgniterJobsQueueInfo[]>;
+    searchWorkers(filter: Record<string, unknown>): Promise<IgniterJobsWorkerHandle[]>;
+    createWorker(config: IgniterJobsWorkerBuilderConfig): Promise<IgniterJobsWorkerHandle>;
+    getWorkers(): Map<string, IgniterJobsWorkerHandle>;
+    publishEvent(channel: string, payload: unknown): Promise<void>;
+    subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    shutdown(): Promise<void>;
+    private loadBunqueue;
+    private getQueue;
+    private getAllQueueNames;
+    private markQueueCronsDirty;
+    private syncCronSchedulers;
+    private createEnvelope;
+    private toJobOptions;
+    private processJob;
+    private processRegisteredDefinition;
+    private processRegisteredCron;
+    private createExecutionContext;
+    private attachWorkerEvents;
+    private toWorkerHandle;
+    private buildWorkerMetrics;
+    private closeWorkerState;
+    private requireJob;
+    private findQueueByJobId;
+    private mapJob;
+    private mapJobSync;
+    private normalizeEnvelope;
+    private toPublicStatus;
+    private toBunqueueStatus;
+    private toBunqueueStates;
+    private distributeConcurrency;
+    private shouldExecuteScheduledJob;
+    private parseLogEntry;
+    private writeLog;
+    private writeQueueLog;
+    private invokeHook;
+    private invokeHandler;
+}
+
+export { IgniterJobsBunSQLiteAdapter, IgniterJobsBunSQLiteAdapterOptions };