@igniter-js/jobs 0.1.13 → 0.1.15

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

@@ -127,6 +127,62 @@ type IgniterJobsInferSchemaOutput<TSchema> = TSchema extends StandardSchemaV1 ?
     _output?: infer TOutput;
 } ? TOutput : unknown;
 
+type IgniterJobsJobStreamSchemaMap = Record<string, IgniterJobsSchema>;
+interface IgniterJobsJobStreamPersistenceConfig {
+    enabled: boolean;
+    maxEvents?: number;
+}
+interface IgniterJobsJobStreamDefinition<TEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> {
+    persistence?: IgniterJobsJobStreamPersistenceConfig;
+    events?: TEvents;
+}
+interface IgniterJobsJobStreamEvent<TType extends string = string, TData = unknown> {
+    id: string;
+    type: TType;
+    data: TData;
+    timestamp: Date;
+    jobId: string;
+    jobName: string;
+    queue: string;
+    scope?: IgniterJobsScopeEntry;
+}
+interface IgniterJobsJobStreamReadParams {
+    after?: string;
+    limit?: number;
+}
+type IgniterJobsJobStreamReadResult<TEvent extends IgniterJobsJobStreamEvent = IgniterJobsJobStreamEvent> = {
+    items: TEvent[];
+    nextCursor?: string;
+    hasMore: boolean;
+};
+type IgniterJobsStreamEventsFromDefinition<TDef> = TDef extends {
+    stream?: {
+        events?: infer TEvents;
+    };
+} ? TEvents extends IgniterJobsJobStreamSchemaMap ? TEvents : {} : {};
+type IgniterJobsStreamEventKeys<TDef> = Extract<keyof IgniterJobsStreamEventsFromDefinition<TDef>, string>;
+type IgniterJobsInferStreamType<TDef> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? string : IgniterJobsStreamEventKeys<TDef>;
+type IgniterJobsInferStreamEmitData<TDef, TType extends string> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? unknown : TType extends IgniterJobsStreamEventKeys<TDef> ? IgniterJobsInferSchemaInput<IgniterJobsStreamEventsFromDefinition<TDef>[TType]> : unknown;
+type IgniterJobsInferStreamReadData<TDef, TType extends string> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? unknown : TType extends IgniterJobsStreamEventKeys<TDef> ? IgniterJobsInferSchemaOutput<IgniterJobsStreamEventsFromDefinition<TDef>[TType]> : unknown;
+type IgniterJobsInferJobStreamEvent<TDef> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? IgniterJobsJobStreamEvent<string, unknown> : {
+    [K in IgniterJobsStreamEventKeys<TDef>]: IgniterJobsJobStreamEvent<K, IgniterJobsInferStreamReadData<TDef, K>>;
+}[IgniterJobsStreamEventKeys<TDef>];
+interface IgniterJobsExecutionStreamEmitter<TDef = unknown, TType extends string = IgniterJobsInferStreamType<TDef>> {
+    emit<TEventType extends TType>(type: TEventType, data: IgniterJobsInferStreamEmitData<TDef, TEventType>): Promise<string>;
+}
+interface IgniterJobsJobStreamAccessor<TDef = unknown> {
+    subscribe(handler: (event: IgniterJobsInferJobStreamEvent<TDef>) => void | Promise<void>): Promise<() => Promise<void>>;
+    read(params?: IgniterJobsJobStreamReadParams): Promise<IgniterJobsJobStreamReadResult<IgniterJobsInferJobStreamEvent<TDef>>>;
+}
+
 /**
  * Rate limiter configuration applied to job dispatch or worker level.
  */
@@ -152,7 +208,7 @@ interface IgniterJobsInvokeOptions {
 /**
  * Runtime execution context passed to handlers.
  */
-interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown> {
+interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> {
     input: IgniterJobsInferSchemaInput<TInput>;
     context: TContext;
     job: {
@@ -167,45 +223,55 @@ 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>;
+        /**
+         * Emits typed stream events for the current job execution.
+         */
+        stream: IgniterJobsExecutionStreamEmitter<IgniterJobDefinition<TContext, TInput, unknown, TStreamEvents>>;
     };
     scope?: IgniterJobsScopeEntry;
 }
 /**
  * Hook context shared by lifecycle handlers.
  */
-interface IgniterJobsHookContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown> extends IgniterJobsExecutionContext<TContext, TInput> {
+interface IgniterJobsHookContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> extends IgniterJobsExecutionContext<TContext, TInput, TStreamEvents> {
     startedAt?: Date;
     duration?: number;
 }
-type IgniterJobsStartHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput>) => void | Promise<void>;
-type IgniterJobsSuccessHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsStartHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents>) => void | Promise<void>;
+type IgniterJobsSuccessHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     result: TResult;
 }) => void | Promise<void>;
-type IgniterJobsFailureHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsFailureHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     error: Error;
     isFinalAttempt: boolean;
 }) => void | Promise<void>;
-type IgniterJobsProgressHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsProgressHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     progress: number;
     message?: string;
 }) => void | Promise<void>;
 /**
  * Definition of a job registered on a queue.
  */
-interface IgniterJobDefinition<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown> extends IgniterJobsInvokeOptions {
+interface IgniterJobDefinition<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> extends IgniterJobsInvokeOptions {
     /** Optional input schema for validation. */
     input?: TInput;
     /** Optional output schema (validation handled externally). */
     output?: IgniterJobsSchema;
     /** Optional queue override (creates child queue in adapters). */
     queue?: string;
+    /** Optional stream configuration for live and persisted per-job events. */
+    stream?: IgniterJobsJobStreamDefinition<TStreamEvents>;
     /** Job handler implementation. */
-    handler: (context: IgniterJobsExecutionContext<TContext, TInput>) => Promise<TResult> | TResult;
+    handler: (context: IgniterJobsExecutionContext<TContext, TInput, TStreamEvents>) => Promise<TResult> | TResult;
     /** Lifecycle hooks */
-    onStart?: IgniterJobsStartHook<TContext, TInput>;
-    onProgress?: IgniterJobsProgressHook<TContext, TInput>;
-    onSuccess?: IgniterJobsSuccessHook<TContext, TInput, TResult>;
-    onFailure?: IgniterJobsFailureHook<TContext, TInput>;
+    onStart?: IgniterJobsStartHook<TContext, TInput, TStreamEvents>;
+    onProgress?: IgniterJobsProgressHook<TContext, TInput, TStreamEvents>;
+    onSuccess?: IgniterJobsSuccessHook<TContext, TInput, TResult, TStreamEvents>;
+    onFailure?: IgniterJobsFailureHook<TContext, TInput, TStreamEvents>;
 }
 /**
  * Definition for cron-style recurring tasks.
@@ -235,12 +301,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.
  */
@@ -299,11 +365,11 @@ type IgniterJobsScheduleParams<TInput = unknown> = IgniterJobsDispatchParams<TIn
 /**
  * Queue configuration produced by `IgniterQueueBuilder`.
  */
-interface IgniterJobsQueue<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any>>, TCron extends Record<string, IgniterCronDefinition<TContext, any>>> {
+interface IgniterJobsQueue<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any, any>>, TCron extends Record<string, IgniterCronDefinition<TContext, any>>> {
     name: string;
     jobs: TJobs;
     crons: TCron;
-    defaultJobOptions?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    defaultJobOptions?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
 }
 /**
  * Information about a queue used by management APIs.
@@ -475,7 +541,26 @@ type IgniterJobsAdapterScheduleParams = {
 interface IgniterJobsJobLog {
     timestamp: Date;
     message: string;
-    level: 'info' | 'warn' | 'error';
+    level: "info" | "warn" | "error";
+}
+interface IgniterJobsAdapterJobStreamWriteParams {
+    queue: string;
+    jobName: string;
+    jobId: string;
+    scope?: IgniterJobsScopeEntry;
+    persistence?: IgniterJobsJobStreamPersistenceConfig;
+    event: Omit<IgniterJobsJobStreamEvent<string, unknown>, "id">;
+}
+interface IgniterJobsAdapterJobStreamReadParams {
+    queue: string;
+    jobId: string;
+    after?: string;
+    limit?: number;
+}
+interface IgniterJobsAdapterJobStreamSubscribeParams {
+    queue: string;
+    jobId: string;
+    handler: (event: IgniterJobsJobStreamEvent<string, unknown>) => void | Promise<void>;
 }
 /**
  * Adapter contract for jobs backends.
@@ -506,8 +591,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[]>;
@@ -515,6 +598,9 @@ interface IgniterJobsAdapter {
     getWorkers(): Map<string, IgniterJobsWorkerHandle>;
     publishEvent(channel: string, payload: unknown): Promise<void>;
     subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    writeJobStreamEvent(params: IgniterJobsAdapterJobStreamWriteParams): Promise<string>;
+    readJobStream(params: IgniterJobsAdapterJobStreamReadParams): Promise<IgniterJobsJobStreamReadResult<IgniterJobsJobStreamEvent<string, unknown>>>;
+    subscribeJobStream(params: IgniterJobsAdapterJobStreamSubscribeParams): Promise<() => Promise<void>>;
     registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
     registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
     shutdown(): Promise<void>;
@@ -525,5 +611,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 { IgniterJobsSuccessHook as $, IgniterJobsAdapterJobStreamWriteParams as A, IgniterJobsAdapterScheduleParams as B, IgniterJobsBullMQAdapterOptions as C, IgniterJobsBunSQLiteAdapterOptions as D, IgniterJobsEvent as E, IgniterJobsExecutionContext as F, IgniterJobsExecutionStreamEmitter as G, IgniterJobsFailureHook as H, IgniterJobsQueue as I, IgniterJobsHookContext as J, IgniterJobsInferJobStreamEvent as K, IgniterJobsInferSchemaOutput as L, IgniterJobsInferStreamEmitData as M, IgniterJobsInferStreamReadData as N, IgniterJobsInferStreamType as O, IgniterJobsInvokeOptions as P, IgniterJobsJobLog as Q, IgniterJobsJobStreamDefinition as R, IgniterJobsJobStreamEvent as S, IgniterJobsJobStreamPersistenceConfig as T, IgniterJobsJobStreamReadParams as U, IgniterJobsJobStreamReadResult as V, IgniterJobsProgressHook as W, IgniterJobsQueueManager as X, IgniterJobsScheduleOptions as Y, IgniterJobsStartHook as Z, IgniterJobsStreamEventsFromDefinition as _, IgniterJobsAdapter as a, IgniterJobsWorkerMetrics as a0, 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, IgniterJobsInferSchemaInput as o, IgniterJobsScheduleParams as p, IgniterJobsJobStreamAccessor as q, IgniterCronDefinition as r, IgniterJobsScopeEntry as s, IgniterJobsSchema as t, IgniterJobsJobStreamSchemaMap as u, IgniterJobsScopeOptions as v, IgniterJobCounts as w, IgniterJobsAdapterDispatchParams as x, IgniterJobsAdapterJobStreamReadParams as y, IgniterJobsAdapterJobStreamSubscribeParams as z };

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

@@ -127,6 +127,62 @@ type IgniterJobsInferSchemaOutput<TSchema> = TSchema extends StandardSchemaV1 ?
     _output?: infer TOutput;
 } ? TOutput : unknown;
 
+type IgniterJobsJobStreamSchemaMap = Record<string, IgniterJobsSchema>;
+interface IgniterJobsJobStreamPersistenceConfig {
+    enabled: boolean;
+    maxEvents?: number;
+}
+interface IgniterJobsJobStreamDefinition<TEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> {
+    persistence?: IgniterJobsJobStreamPersistenceConfig;
+    events?: TEvents;
+}
+interface IgniterJobsJobStreamEvent<TType extends string = string, TData = unknown> {
+    id: string;
+    type: TType;
+    data: TData;
+    timestamp: Date;
+    jobId: string;
+    jobName: string;
+    queue: string;
+    scope?: IgniterJobsScopeEntry;
+}
+interface IgniterJobsJobStreamReadParams {
+    after?: string;
+    limit?: number;
+}
+type IgniterJobsJobStreamReadResult<TEvent extends IgniterJobsJobStreamEvent = IgniterJobsJobStreamEvent> = {
+    items: TEvent[];
+    nextCursor?: string;
+    hasMore: boolean;
+};
+type IgniterJobsStreamEventsFromDefinition<TDef> = TDef extends {
+    stream?: {
+        events?: infer TEvents;
+    };
+} ? TEvents extends IgniterJobsJobStreamSchemaMap ? TEvents : {} : {};
+type IgniterJobsStreamEventKeys<TDef> = Extract<keyof IgniterJobsStreamEventsFromDefinition<TDef>, string>;
+type IgniterJobsInferStreamType<TDef> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? string : IgniterJobsStreamEventKeys<TDef>;
+type IgniterJobsInferStreamEmitData<TDef, TType extends string> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? unknown : TType extends IgniterJobsStreamEventKeys<TDef> ? IgniterJobsInferSchemaInput<IgniterJobsStreamEventsFromDefinition<TDef>[TType]> : unknown;
+type IgniterJobsInferStreamReadData<TDef, TType extends string> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? unknown : TType extends IgniterJobsStreamEventKeys<TDef> ? IgniterJobsInferSchemaOutput<IgniterJobsStreamEventsFromDefinition<TDef>[TType]> : unknown;
+type IgniterJobsInferJobStreamEvent<TDef> = [
+    IgniterJobsStreamEventKeys<TDef>
+] extends [never] ? IgniterJobsJobStreamEvent<string, unknown> : {
+    [K in IgniterJobsStreamEventKeys<TDef>]: IgniterJobsJobStreamEvent<K, IgniterJobsInferStreamReadData<TDef, K>>;
+}[IgniterJobsStreamEventKeys<TDef>];
+interface IgniterJobsExecutionStreamEmitter<TDef = unknown, TType extends string = IgniterJobsInferStreamType<TDef>> {
+    emit<TEventType extends TType>(type: TEventType, data: IgniterJobsInferStreamEmitData<TDef, TEventType>): Promise<string>;
+}
+interface IgniterJobsJobStreamAccessor<TDef = unknown> {
+    subscribe(handler: (event: IgniterJobsInferJobStreamEvent<TDef>) => void | Promise<void>): Promise<() => Promise<void>>;
+    read(params?: IgniterJobsJobStreamReadParams): Promise<IgniterJobsJobStreamReadResult<IgniterJobsInferJobStreamEvent<TDef>>>;
+}
+
 /**
  * Rate limiter configuration applied to job dispatch or worker level.
  */
@@ -152,7 +208,7 @@ interface IgniterJobsInvokeOptions {
 /**
  * Runtime execution context passed to handlers.
  */
-interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown> {
+interface IgniterJobsExecutionContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> {
     input: IgniterJobsInferSchemaInput<TInput>;
     context: TContext;
     job: {
@@ -167,45 +223,55 @@ 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>;
+        /**
+         * Emits typed stream events for the current job execution.
+         */
+        stream: IgniterJobsExecutionStreamEmitter<IgniterJobDefinition<TContext, TInput, unknown, TStreamEvents>>;
     };
     scope?: IgniterJobsScopeEntry;
 }
 /**
  * Hook context shared by lifecycle handlers.
  */
-interface IgniterJobsHookContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown> extends IgniterJobsExecutionContext<TContext, TInput> {
+interface IgniterJobsHookContext<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> extends IgniterJobsExecutionContext<TContext, TInput, TStreamEvents> {
     startedAt?: Date;
     duration?: number;
 }
-type IgniterJobsStartHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput>) => void | Promise<void>;
-type IgniterJobsSuccessHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsStartHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents>) => void | Promise<void>;
+type IgniterJobsSuccessHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     result: TResult;
 }) => void | Promise<void>;
-type IgniterJobsFailureHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsFailureHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     error: Error;
     isFinalAttempt: boolean;
 }) => void | Promise<void>;
-type IgniterJobsProgressHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown> = (context: IgniterJobsHookContext<TContext, TInput> & {
+type IgniterJobsProgressHook<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> = (context: IgniterJobsHookContext<TContext, TInput, TStreamEvents> & {
     progress: number;
     message?: string;
 }) => void | Promise<void>;
 /**
  * Definition of a job registered on a queue.
  */
-interface IgniterJobDefinition<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown> extends IgniterJobsInvokeOptions {
+interface IgniterJobDefinition<TContext, TInput extends IgniterJobsSchema | unknown = unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined> extends IgniterJobsInvokeOptions {
     /** Optional input schema for validation. */
     input?: TInput;
     /** Optional output schema (validation handled externally). */
     output?: IgniterJobsSchema;
     /** Optional queue override (creates child queue in adapters). */
     queue?: string;
+    /** Optional stream configuration for live and persisted per-job events. */
+    stream?: IgniterJobsJobStreamDefinition<TStreamEvents>;
     /** Job handler implementation. */
-    handler: (context: IgniterJobsExecutionContext<TContext, TInput>) => Promise<TResult> | TResult;
+    handler: (context: IgniterJobsExecutionContext<TContext, TInput, TStreamEvents>) => Promise<TResult> | TResult;
     /** Lifecycle hooks */
-    onStart?: IgniterJobsStartHook<TContext, TInput>;
-    onProgress?: IgniterJobsProgressHook<TContext, TInput>;
-    onSuccess?: IgniterJobsSuccessHook<TContext, TInput, TResult>;
-    onFailure?: IgniterJobsFailureHook<TContext, TInput>;
+    onStart?: IgniterJobsStartHook<TContext, TInput, TStreamEvents>;
+    onProgress?: IgniterJobsProgressHook<TContext, TInput, TStreamEvents>;
+    onSuccess?: IgniterJobsSuccessHook<TContext, TInput, TResult, TStreamEvents>;
+    onFailure?: IgniterJobsFailureHook<TContext, TInput, TStreamEvents>;
 }
 /**
  * Definition for cron-style recurring tasks.
@@ -235,12 +301,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.
  */
@@ -299,11 +365,11 @@ type IgniterJobsScheduleParams<TInput = unknown> = IgniterJobsDispatchParams<TIn
 /**
  * Queue configuration produced by `IgniterQueueBuilder`.
  */
-interface IgniterJobsQueue<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any>>, TCron extends Record<string, IgniterCronDefinition<TContext, any>>> {
+interface IgniterJobsQueue<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any, any>>, TCron extends Record<string, IgniterCronDefinition<TContext, any>>> {
     name: string;
     jobs: TJobs;
     crons: TCron;
-    defaultJobOptions?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    defaultJobOptions?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
 }
 /**
  * Information about a queue used by management APIs.
@@ -475,7 +541,26 @@ type IgniterJobsAdapterScheduleParams = {
 interface IgniterJobsJobLog {
     timestamp: Date;
     message: string;
-    level: 'info' | 'warn' | 'error';
+    level: "info" | "warn" | "error";
+}
+interface IgniterJobsAdapterJobStreamWriteParams {
+    queue: string;
+    jobName: string;
+    jobId: string;
+    scope?: IgniterJobsScopeEntry;
+    persistence?: IgniterJobsJobStreamPersistenceConfig;
+    event: Omit<IgniterJobsJobStreamEvent<string, unknown>, "id">;
+}
+interface IgniterJobsAdapterJobStreamReadParams {
+    queue: string;
+    jobId: string;
+    after?: string;
+    limit?: number;
+}
+interface IgniterJobsAdapterJobStreamSubscribeParams {
+    queue: string;
+    jobId: string;
+    handler: (event: IgniterJobsJobStreamEvent<string, unknown>) => void | Promise<void>;
 }
 /**
  * Adapter contract for jobs backends.
@@ -506,8 +591,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[]>;
@@ -515,6 +598,9 @@ interface IgniterJobsAdapter {
     getWorkers(): Map<string, IgniterJobsWorkerHandle>;
     publishEvent(channel: string, payload: unknown): Promise<void>;
     subscribeEvent(channel: string, handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
+    writeJobStreamEvent(params: IgniterJobsAdapterJobStreamWriteParams): Promise<string>;
+    readJobStream(params: IgniterJobsAdapterJobStreamReadParams): Promise<IgniterJobsJobStreamReadResult<IgniterJobsJobStreamEvent<string, unknown>>>;
+    subscribeJobStream(params: IgniterJobsAdapterJobStreamSubscribeParams): Promise<() => Promise<void>>;
     registerJob(queueName: string, jobName: string, definition: IgniterJobDefinition<any, any, any>): void;
     registerCron(queueName: string, cronName: string, definition: IgniterCronDefinition<any, any>): void;
     shutdown(): Promise<void>;
@@ -525,5 +611,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 { IgniterJobsSuccessHook as $, IgniterJobsAdapterJobStreamWriteParams as A, IgniterJobsAdapterScheduleParams as B, IgniterJobsBullMQAdapterOptions as C, IgniterJobsBunSQLiteAdapterOptions as D, IgniterJobsEvent as E, IgniterJobsExecutionContext as F, IgniterJobsExecutionStreamEmitter as G, IgniterJobsFailureHook as H, IgniterJobsQueue as I, IgniterJobsHookContext as J, IgniterJobsInferJobStreamEvent as K, IgniterJobsInferSchemaOutput as L, IgniterJobsInferStreamEmitData as M, IgniterJobsInferStreamReadData as N, IgniterJobsInferStreamType as O, IgniterJobsInvokeOptions as P, IgniterJobsJobLog as Q, IgniterJobsJobStreamDefinition as R, IgniterJobsJobStreamEvent as S, IgniterJobsJobStreamPersistenceConfig as T, IgniterJobsJobStreamReadParams as U, IgniterJobsJobStreamReadResult as V, IgniterJobsProgressHook as W, IgniterJobsQueueManager as X, IgniterJobsScheduleOptions as Y, IgniterJobsStartHook as Z, IgniterJobsStreamEventsFromDefinition as _, IgniterJobsAdapter as a, IgniterJobsWorkerMetrics as a0, 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, IgniterJobsInferSchemaInput as o, IgniterJobsScheduleParams as p, IgniterJobsJobStreamAccessor as q, IgniterCronDefinition as r, IgniterJobsScopeEntry as s, IgniterJobsSchema as t, IgniterJobsJobStreamSchemaMap as u, IgniterJobsScopeOptions as v, IgniterJobCounts as w, IgniterJobsAdapterDispatchParams as x, IgniterJobsAdapterJobStreamReadParams as y, IgniterJobsAdapterJobStreamSubscribeParams as z };

package/dist/adapters/bun.d.mts

@@ -0,0 +1,101 @@
+import { a as IgniterJobsAdapter, X as IgniterJobsQueueManager, D as IgniterJobsBunSQLiteAdapterOptions, c as IgniterJobDefinition, r as IgniterCronDefinition, x as IgniterJobsAdapterDispatchParams, B as IgniterJobsAdapterScheduleParams, g as IgniterJobSearchResult, m as IgniterJobStatus, Q as IgniterJobsJobLog, h as IgniterJobsQueueInfo, w as IgniterJobCounts, l as IgniterJobsQueueCleanOptions, i as IgniterJobsWorkerHandle, d as IgniterJobsWorkerBuilderConfig, f as IgniterJobsEventHandler, A as IgniterJobsAdapterJobStreamWriteParams, y as IgniterJobsAdapterJobStreamReadParams, V as IgniterJobsJobStreamReadResult, S as IgniterJobsJobStreamEvent, z as IgniterJobsAdapterJobStreamSubscribeParams } from '../adapter-DDyMVche.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 streamSubscribers;
+    private readonly registeredJobs;
+    private streamDatabasePromise;
+    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>>;
+    writeJobStreamEvent(params: IgniterJobsAdapterJobStreamWriteParams): Promise<string>;
+    readJobStream(params: IgniterJobsAdapterJobStreamReadParams): Promise<IgniterJobsJobStreamReadResult<IgniterJobsJobStreamEvent<string, unknown>>>;
+    subscribeJobStream(params: IgniterJobsAdapterJobStreamSubscribeParams): Promise<() => Promise<void>>;
+    shutdown(): Promise<void>;
+    private loadBunqueue;
+    private getStreamDatabase;
+    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 getStreamKey;
+    private mapStreamRow;
+    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 };