@igniter-js/jobs 0.1.14 → 0.1.15

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { IgniterLogger, IgniterError } from '@igniter-js/common';
-import { I as IgniterJobsQueue, a as IgniterJobsAdapter, b as IgniterJobsScopeDefinition, c as IgniterJobDefinition, d as IgniterJobsWorkerBuilderConfig, e as IgniterJobsTelemetry, f as IgniterJobsEventHandler, g as IgniterJobSearchResult, h as IgniterJobsQueueInfo, i as IgniterJobsWorkerHandle, j as IgniterJobsLimiter, k as IgniterJobsWorkerHandlers, l as IgniterJobsQueueCleanOptions, m as IgniterJobStatus, n as IgniterJobsDispatchParams, o as IgniterJobsScheduleParams, p as IgniterJobsInferSchemaInput, q as IgniterCronDefinition, r as IgniterJobsScopeEntry, s as IgniterJobsSchema, t as IgniterJobsScopeOptions } from './adapter-Cax_40HW.mjs';
-export { u as IgniterJobCounts, v as IgniterJobsAdapterDispatchParams, w as IgniterJobsAdapterScheduleParams, x as IgniterJobsBullMQAdapterOptions, y as IgniterJobsBunSQLiteAdapterOptions, z as IgniterJobsEvent, A as IgniterJobsExecutionContext, B as IgniterJobsFailureHook, C as IgniterJobsHookContext, D as IgniterJobsInferSchemaOutput, E as IgniterJobsInvokeOptions, F as IgniterJobsJobLog, G as IgniterJobsProgressHook, H as IgniterJobsQueueManager, J as IgniterJobsScheduleOptions, K as IgniterJobsStartHook, L as IgniterJobsSuccessHook, M as IgniterJobsWorkerMetrics } from './adapter-Cax_40HW.mjs';
+import { I as IgniterJobsQueue, a as IgniterJobsAdapter, b as IgniterJobsScopeDefinition, c as IgniterJobDefinition, d as IgniterJobsWorkerBuilderConfig, e as IgniterJobsTelemetry, f as IgniterJobsEventHandler, g as IgniterJobSearchResult, h as IgniterJobsQueueInfo, i as IgniterJobsWorkerHandle, j as IgniterJobsLimiter, k as IgniterJobsWorkerHandlers, l as IgniterJobsQueueCleanOptions, m as IgniterJobStatus, n as IgniterJobsDispatchParams, o as IgniterJobsInferSchemaInput, p as IgniterJobsScheduleParams, q as IgniterJobsJobStreamAccessor, r as IgniterCronDefinition, s as IgniterJobsScopeEntry, t as IgniterJobsSchema, u as IgniterJobsJobStreamSchemaMap, v as IgniterJobsScopeOptions } from './adapter-DDyMVche.mjs';
+export { w as IgniterJobCounts, x as IgniterJobsAdapterDispatchParams, y as IgniterJobsAdapterJobStreamReadParams, z as IgniterJobsAdapterJobStreamSubscribeParams, A as IgniterJobsAdapterJobStreamWriteParams, B as IgniterJobsAdapterScheduleParams, C as IgniterJobsBullMQAdapterOptions, D as IgniterJobsBunSQLiteAdapterOptions, E as IgniterJobsEvent, F as IgniterJobsExecutionContext, G as IgniterJobsExecutionStreamEmitter, H as IgniterJobsFailureHook, J as IgniterJobsHookContext, K as IgniterJobsInferJobStreamEvent, L as IgniterJobsInferSchemaOutput, M as IgniterJobsInferStreamEmitData, N as IgniterJobsInferStreamReadData, O as IgniterJobsInferStreamType, P as IgniterJobsInvokeOptions, Q as IgniterJobsJobLog, R as IgniterJobsJobStreamDefinition, S as IgniterJobsJobStreamEvent, T as IgniterJobsJobStreamPersistenceConfig, U as IgniterJobsJobStreamReadParams, V as IgniterJobsJobStreamReadResult, W as IgniterJobsProgressHook, X as IgniterJobsQueueManager, Y as IgniterJobsScheduleOptions, Z as IgniterJobsStartHook, _ as IgniterJobsStreamEventsFromDefinition, $ as IgniterJobsSuccessHook, a0 as IgniterJobsWorkerMetrics } from './adapter-DDyMVche.mjs';
 import 'ioredis';
 
 /**
@@ -13,12 +13,12 @@ interface IgniterJobsConfig<TContext = unknown, TQueues extends Record<string, I
     contextFactory: () => TContext | Promise<TContext>;
     queues: TQueues;
     scopeDefinition?: IgniterJobsScopeDefinition<TScope>;
-    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
     workerDefaults?: Partial<IgniterJobsWorkerBuilderConfig>;
     autoStartWorker?: {
         queues: (keyof TQueues)[];
         concurrency?: number;
-        limiter?: IgniterJobsWorkerBuilderConfig['limiter'];
+        limiter?: IgniterJobsWorkerBuilderConfig["limiter"];
     };
     logger?: IgniterLogger;
     telemetry?: IgniterJobsTelemetry;
@@ -33,12 +33,12 @@ interface IgniterJobsBuilderState<TContext, TQueues extends Record<string, Ignit
     contextFactory?: () => TContext | Promise<TContext>;
     queues: TQueues;
     scopeDefinition?: IgniterJobsScopeDefinition<TScope>;
-    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
     workerDefaults?: Partial<IgniterJobsWorkerBuilderConfig>;
     autoStartWorker?: {
         queues: (keyof TQueues)[];
         concurrency?: number;
-        limiter?: IgniterJobsWorkerBuilderConfig['limiter'];
+        limiter?: IgniterJobsWorkerBuilderConfig["limiter"];
     };
 }
 
@@ -49,8 +49,9 @@ interface IgniterJobsBuilderState<TContext, TQueues extends Record<string, Ignit
 
 type IgniterJobsInferInput<TInput> = IgniterJobsInferSchemaInput<TInput>;
 type IgniterJobsInferJobInput<TDef> = TDef extends IgniterJobDefinition<any, infer TInput, any> ? IgniterJobsInferInput<TInput> : unknown;
+type IgniterJobsInferJobResult<TDef> = TDef extends IgniterJobDefinition<any, any, infer TResult, any> ? TResult : unknown;
 type IgniterJobsInferCronResult<TDef> = TDef extends IgniterCronDefinition<any, infer TResult> ? TResult : unknown;
-interface IgniterJobsJobInstanceAccessor {
+interface IgniterJobsJobInstanceAccessor<TDef extends IgniterJobDefinition<any, any, any, any> = IgniterJobDefinition<any, any, any, any>> {
     retrieve(): Promise<IgniterJobSearchResult | null>;
     retry(): Promise<void>;
     remove(): Promise<void>;
@@ -63,15 +64,16 @@ interface IgniterJobsJobInstanceAccessor {
         message: string;
         level: "info" | "warn" | "error";
     }[]>;
+    stream(): IgniterJobsJobStreamAccessor<TDef>;
 }
 interface IgniterJobsJobManyAccessor {
     retry(): Promise<void>;
     remove(): Promise<void>;
 }
-interface IgniterJobsJobAccessor<TInput = unknown, TResult = unknown> {
-    dispatch(params: IgniterJobsDispatchParams<TInput>): Promise<string>;
-    schedule(params: IgniterJobsScheduleParams<TInput>): Promise<string>;
-    get(id: string): IgniterJobsJobInstanceAccessor;
+interface IgniterJobsJobAccessor<TDef extends IgniterJobDefinition<any, any, any, any> = IgniterJobDefinition<any, any, any, any>> {
+    dispatch(params: IgniterJobsDispatchParams<IgniterJobsInferJobInput<TDef>>): Promise<string>;
+    schedule(params: IgniterJobsScheduleParams<IgniterJobsInferJobInput<TDef>>): Promise<string>;
+    get(id: string): IgniterJobsJobInstanceAccessor<TDef>;
     many(ids: string[]): IgniterJobsJobManyAccessor;
     subscribe(handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
 }
@@ -86,7 +88,7 @@ interface IgniterJobsQueueManagerAccessor {
     }): Promise<void>;
     retryAll(): Promise<number>;
 }
-type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<any, any, any>> = {}> = {
+type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<any, any, any, any>> = {}> = {
     get(): IgniterJobsQueueManagerAccessor;
     list(filter?: {
         status?: IgniterJobStatus[];
@@ -95,10 +97,10 @@ type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<
     }): Promise<IgniterJobSearchResult[]>;
     subscribe(handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
     readonly jobs: {
-        [K in keyof TJobs]: IgniterJobsJobAccessor<IgniterJobsInferJobInput<TJobs[K]>, any>;
+        [K in keyof TJobs]: IgniterJobsJobAccessor<TJobs[K]>;
     };
 } & {
-    [K in keyof TJobs]: IgniterJobsJobAccessor<IgniterJobsInferJobInput<TJobs[K]>, any>;
+    [K in keyof TJobs]: IgniterJobsJobAccessor<TJobs[K]>;
 };
 interface IgniterJobsWorkerBuilderAccessor<TQueueNames extends string> {
     create(): IgniterJobsWorkerFluentBuilder<TQueueNames>;
@@ -125,7 +127,7 @@ interface IgniterJobsBaseRuntime<TConfig extends IgniterJobsConfig<any, any, any
 }
 type IgniterJobsRuntime<TConfig extends IgniterJobsConfig<any, any, any> = IgniterJobsConfig<any, any, any>> = IgniterJobsBaseRuntime<TConfig> & {
     [Q in keyof TConfig["queues"]]: TConfig["queues"][Q] extends {
-        jobs: infer TJobs extends Record<string, IgniterJobDefinition<any, any, any>>;
+        jobs: infer TJobs extends Record<string, IgniterJobDefinition<any, any, any, any>>;
     } ? IgniterJobsQueueAccessor<TJobs> : IgniterJobsQueueAccessor;
 };
 
@@ -383,6 +385,11 @@ declare class IgniterJobsManager<TConfig extends IgniterJobsConfig<any, any, any
      */
     private getJobDefinition;
     private getEffectiveJobDefinition;
+    private createExecutionStreamEmitter;
+    private createJobStreamAccessor;
+    private normalizeStreamEmitPayload;
+    private normalizeStreamReadEvent;
+    private getJobStreamSchema;
     /**
      * Resolves the effective scope for a job operation.
      * @internal
@@ -435,7 +442,7 @@ declare class IgniterJobsManager<TConfig extends IgniterJobsConfig<any, any, any
  *   .build()
  * ```
  */
-declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any>> = {}, TCron extends Record<string, IgniterCronDefinition<TContext, any>> = {}, TName extends string = string> {
+declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any, any>> = {}, TCron extends Record<string, IgniterCronDefinition<TContext, any>> = {}, TName extends string = string> {
     private readonly state;
     private constructor();
     /**
@@ -449,7 +456,7 @@ declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, Igniter
      * @param jobName - Unique name of the job inside the queue.
      * @param definition - Job definition (handler, schemas, options, hooks).
      */
-    addJob<TJobName extends string, TInput extends IgniterJobsSchema | unknown, TResult = unknown>(jobName: TJobName, definition: IgniterJobDefinition<TContext, TInput, TResult>): IgniterQueueBuilder<TContext, TJobs & Record<TJobName, IgniterJobDefinition<TContext, TInput, TResult>>, TCron, TName>;
+    addJob<TJobName extends string, TInput extends IgniterJobsSchema | unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined>(jobName: TJobName, definition: IgniterJobDefinition<TContext, TInput, TResult, TStreamEvents>): IgniterQueueBuilder<TContext, TJobs & Record<TJobName, IgniterJobDefinition<TContext, TInput, TResult, TStreamEvents>>, TCron, TName>;
     /**
      * Registers a cron task on the queue.
      *
@@ -605,7 +612,7 @@ declare class IgniterJobsBuilder<TContext, TQueues extends Record<string, Ignite
     /**
      * Applies default job options to all queues.
      */
-    withQueueDefaults(defaults: Partial<IgniterJobDefinition<TContext, any, any>>): IgniterJobsBuilder<TContext, TQueues, TScope>;
+    withQueueDefaults(defaults: Partial<IgniterJobDefinition<TContext, any, any, any>>): IgniterJobsBuilder<TContext, TQueues, TScope>;
     /**
      * Applies default worker options.
      */
@@ -737,4 +744,4 @@ declare class IgniterJobsError extends IgniterError {
     constructor(options: IgniterJobsErrorOptions);
 }
 
-export { IGNITER_JOBS_ERROR_CODES, IgniterCronDefinition, IgniterJobDefinition, IgniterJobSearchResult, IgniterJobStatus, IgniterJobs, IgniterJobsAdapter, type IgniterJobsBaseRuntime, IgniterJobsBuilder, type IgniterJobsBuilderState, type IgniterJobsConfig, IgniterJobsDispatchParams, IgniterJobsError, type IgniterJobsErrorCode, type IgniterJobsErrorOptions, IgniterJobsEventHandler, type IgniterJobsInferCronResult, type IgniterJobsInferInput, type IgniterJobsInferJobInput, IgniterJobsInferSchemaInput, type IgniterJobsJobAccessor, type IgniterJobsJobInstanceAccessor, type IgniterJobsJobManyAccessor, IgniterJobsLimiter, IgniterJobsManager, IgniterJobsQueue, type IgniterJobsQueueAccessor, IgniterJobsQueueCleanOptions, IgniterJobsQueueInfo, type IgniterJobsQueueManagerAccessor, type IgniterJobsRuntime, IgniterJobsScheduleParams, IgniterJobsSchema, IgniterJobsScopeDefinition, IgniterJobsScopeEntry, IgniterJobsScopeOptions, IgniterJobsTelemetry, type IgniterJobsWorkerBuilderAccessor, IgniterJobsWorkerBuilderConfig, type IgniterJobsWorkerFluentBuilder, IgniterJobsWorkerHandle, IgniterJobsWorkerHandlers, IgniterQueue, IgniterQueueBuilder, IgniterWorkerBuilder };
+export { IGNITER_JOBS_ERROR_CODES, IgniterCronDefinition, IgniterJobDefinition, IgniterJobSearchResult, IgniterJobStatus, IgniterJobs, IgniterJobsAdapter, type IgniterJobsBaseRuntime, IgniterJobsBuilder, type IgniterJobsBuilderState, type IgniterJobsConfig, IgniterJobsDispatchParams, IgniterJobsError, type IgniterJobsErrorCode, type IgniterJobsErrorOptions, IgniterJobsEventHandler, type IgniterJobsInferCronResult, type IgniterJobsInferInput, type IgniterJobsInferJobInput, type IgniterJobsInferJobResult, IgniterJobsInferSchemaInput, type IgniterJobsJobAccessor, type IgniterJobsJobInstanceAccessor, type IgniterJobsJobManyAccessor, IgniterJobsJobStreamAccessor, IgniterJobsJobStreamSchemaMap, IgniterJobsLimiter, IgniterJobsManager, IgniterJobsQueue, type IgniterJobsQueueAccessor, IgniterJobsQueueCleanOptions, IgniterJobsQueueInfo, type IgniterJobsQueueManagerAccessor, type IgniterJobsRuntime, IgniterJobsScheduleParams, IgniterJobsSchema, IgniterJobsScopeDefinition, IgniterJobsScopeEntry, IgniterJobsScopeOptions, IgniterJobsTelemetry, type IgniterJobsWorkerBuilderAccessor, IgniterJobsWorkerBuilderConfig, type IgniterJobsWorkerFluentBuilder, IgniterJobsWorkerHandle, IgniterJobsWorkerHandlers, IgniterQueue, IgniterQueueBuilder, IgniterWorkerBuilder };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { IgniterLogger, IgniterError } from '@igniter-js/common';
-import { I as IgniterJobsQueue, a as IgniterJobsAdapter, b as IgniterJobsScopeDefinition, c as IgniterJobDefinition, d as IgniterJobsWorkerBuilderConfig, e as IgniterJobsTelemetry, f as IgniterJobsEventHandler, g as IgniterJobSearchResult, h as IgniterJobsQueueInfo, i as IgniterJobsWorkerHandle, j as IgniterJobsLimiter, k as IgniterJobsWorkerHandlers, l as IgniterJobsQueueCleanOptions, m as IgniterJobStatus, n as IgniterJobsDispatchParams, o as IgniterJobsScheduleParams, p as IgniterJobsInferSchemaInput, q as IgniterCronDefinition, r as IgniterJobsScopeEntry, s as IgniterJobsSchema, t as IgniterJobsScopeOptions } from './adapter-Cax_40HW.js';
-export { u as IgniterJobCounts, v as IgniterJobsAdapterDispatchParams, w as IgniterJobsAdapterScheduleParams, x as IgniterJobsBullMQAdapterOptions, y as IgniterJobsBunSQLiteAdapterOptions, z as IgniterJobsEvent, A as IgniterJobsExecutionContext, B as IgniterJobsFailureHook, C as IgniterJobsHookContext, D as IgniterJobsInferSchemaOutput, E as IgniterJobsInvokeOptions, F as IgniterJobsJobLog, G as IgniterJobsProgressHook, H as IgniterJobsQueueManager, J as IgniterJobsScheduleOptions, K as IgniterJobsStartHook, L as IgniterJobsSuccessHook, M as IgniterJobsWorkerMetrics } from './adapter-Cax_40HW.js';
+import { I as IgniterJobsQueue, a as IgniterJobsAdapter, b as IgniterJobsScopeDefinition, c as IgniterJobDefinition, d as IgniterJobsWorkerBuilderConfig, e as IgniterJobsTelemetry, f as IgniterJobsEventHandler, g as IgniterJobSearchResult, h as IgniterJobsQueueInfo, i as IgniterJobsWorkerHandle, j as IgniterJobsLimiter, k as IgniterJobsWorkerHandlers, l as IgniterJobsQueueCleanOptions, m as IgniterJobStatus, n as IgniterJobsDispatchParams, o as IgniterJobsInferSchemaInput, p as IgniterJobsScheduleParams, q as IgniterJobsJobStreamAccessor, r as IgniterCronDefinition, s as IgniterJobsScopeEntry, t as IgniterJobsSchema, u as IgniterJobsJobStreamSchemaMap, v as IgniterJobsScopeOptions } from './adapter-DDyMVche.js';
+export { w as IgniterJobCounts, x as IgniterJobsAdapterDispatchParams, y as IgniterJobsAdapterJobStreamReadParams, z as IgniterJobsAdapterJobStreamSubscribeParams, A as IgniterJobsAdapterJobStreamWriteParams, B as IgniterJobsAdapterScheduleParams, C as IgniterJobsBullMQAdapterOptions, D as IgniterJobsBunSQLiteAdapterOptions, E as IgniterJobsEvent, F as IgniterJobsExecutionContext, G as IgniterJobsExecutionStreamEmitter, H as IgniterJobsFailureHook, J as IgniterJobsHookContext, K as IgniterJobsInferJobStreamEvent, L as IgniterJobsInferSchemaOutput, M as IgniterJobsInferStreamEmitData, N as IgniterJobsInferStreamReadData, O as IgniterJobsInferStreamType, P as IgniterJobsInvokeOptions, Q as IgniterJobsJobLog, R as IgniterJobsJobStreamDefinition, S as IgniterJobsJobStreamEvent, T as IgniterJobsJobStreamPersistenceConfig, U as IgniterJobsJobStreamReadParams, V as IgniterJobsJobStreamReadResult, W as IgniterJobsProgressHook, X as IgniterJobsQueueManager, Y as IgniterJobsScheduleOptions, Z as IgniterJobsStartHook, _ as IgniterJobsStreamEventsFromDefinition, $ as IgniterJobsSuccessHook, a0 as IgniterJobsWorkerMetrics } from './adapter-DDyMVche.js';
 import 'ioredis';
 
 /**
@@ -13,12 +13,12 @@ interface IgniterJobsConfig<TContext = unknown, TQueues extends Record<string, I
     contextFactory: () => TContext | Promise<TContext>;
     queues: TQueues;
     scopeDefinition?: IgniterJobsScopeDefinition<TScope>;
-    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
     workerDefaults?: Partial<IgniterJobsWorkerBuilderConfig>;
     autoStartWorker?: {
         queues: (keyof TQueues)[];
         concurrency?: number;
-        limiter?: IgniterJobsWorkerBuilderConfig['limiter'];
+        limiter?: IgniterJobsWorkerBuilderConfig["limiter"];
     };
     logger?: IgniterLogger;
     telemetry?: IgniterJobsTelemetry;
@@ -33,12 +33,12 @@ interface IgniterJobsBuilderState<TContext, TQueues extends Record<string, Ignit
     contextFactory?: () => TContext | Promise<TContext>;
     queues: TQueues;
     scopeDefinition?: IgniterJobsScopeDefinition<TScope>;
-    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any>>;
+    queueDefaults?: Partial<IgniterJobDefinition<TContext, any, any, any>>;
     workerDefaults?: Partial<IgniterJobsWorkerBuilderConfig>;
     autoStartWorker?: {
         queues: (keyof TQueues)[];
         concurrency?: number;
-        limiter?: IgniterJobsWorkerBuilderConfig['limiter'];
+        limiter?: IgniterJobsWorkerBuilderConfig["limiter"];
     };
 }
 
@@ -49,8 +49,9 @@ interface IgniterJobsBuilderState<TContext, TQueues extends Record<string, Ignit
 
 type IgniterJobsInferInput<TInput> = IgniterJobsInferSchemaInput<TInput>;
 type IgniterJobsInferJobInput<TDef> = TDef extends IgniterJobDefinition<any, infer TInput, any> ? IgniterJobsInferInput<TInput> : unknown;
+type IgniterJobsInferJobResult<TDef> = TDef extends IgniterJobDefinition<any, any, infer TResult, any> ? TResult : unknown;
 type IgniterJobsInferCronResult<TDef> = TDef extends IgniterCronDefinition<any, infer TResult> ? TResult : unknown;
-interface IgniterJobsJobInstanceAccessor {
+interface IgniterJobsJobInstanceAccessor<TDef extends IgniterJobDefinition<any, any, any, any> = IgniterJobDefinition<any, any, any, any>> {
     retrieve(): Promise<IgniterJobSearchResult | null>;
     retry(): Promise<void>;
     remove(): Promise<void>;
@@ -63,15 +64,16 @@ interface IgniterJobsJobInstanceAccessor {
         message: string;
         level: "info" | "warn" | "error";
     }[]>;
+    stream(): IgniterJobsJobStreamAccessor<TDef>;
 }
 interface IgniterJobsJobManyAccessor {
     retry(): Promise<void>;
     remove(): Promise<void>;
 }
-interface IgniterJobsJobAccessor<TInput = unknown, TResult = unknown> {
-    dispatch(params: IgniterJobsDispatchParams<TInput>): Promise<string>;
-    schedule(params: IgniterJobsScheduleParams<TInput>): Promise<string>;
-    get(id: string): IgniterJobsJobInstanceAccessor;
+interface IgniterJobsJobAccessor<TDef extends IgniterJobDefinition<any, any, any, any> = IgniterJobDefinition<any, any, any, any>> {
+    dispatch(params: IgniterJobsDispatchParams<IgniterJobsInferJobInput<TDef>>): Promise<string>;
+    schedule(params: IgniterJobsScheduleParams<IgniterJobsInferJobInput<TDef>>): Promise<string>;
+    get(id: string): IgniterJobsJobInstanceAccessor<TDef>;
     many(ids: string[]): IgniterJobsJobManyAccessor;
     subscribe(handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
 }
@@ -86,7 +88,7 @@ interface IgniterJobsQueueManagerAccessor {
     }): Promise<void>;
     retryAll(): Promise<number>;
 }
-type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<any, any, any>> = {}> = {
+type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<any, any, any, any>> = {}> = {
     get(): IgniterJobsQueueManagerAccessor;
     list(filter?: {
         status?: IgniterJobStatus[];
@@ -95,10 +97,10 @@ type IgniterJobsQueueAccessor<TJobs extends Record<string, IgniterJobDefinition<
     }): Promise<IgniterJobSearchResult[]>;
     subscribe(handler: IgniterJobsEventHandler): Promise<() => Promise<void>>;
     readonly jobs: {
-        [K in keyof TJobs]: IgniterJobsJobAccessor<IgniterJobsInferJobInput<TJobs[K]>, any>;
+        [K in keyof TJobs]: IgniterJobsJobAccessor<TJobs[K]>;
     };
 } & {
-    [K in keyof TJobs]: IgniterJobsJobAccessor<IgniterJobsInferJobInput<TJobs[K]>, any>;
+    [K in keyof TJobs]: IgniterJobsJobAccessor<TJobs[K]>;
 };
 interface IgniterJobsWorkerBuilderAccessor<TQueueNames extends string> {
     create(): IgniterJobsWorkerFluentBuilder<TQueueNames>;
@@ -125,7 +127,7 @@ interface IgniterJobsBaseRuntime<TConfig extends IgniterJobsConfig<any, any, any
 }
 type IgniterJobsRuntime<TConfig extends IgniterJobsConfig<any, any, any> = IgniterJobsConfig<any, any, any>> = IgniterJobsBaseRuntime<TConfig> & {
     [Q in keyof TConfig["queues"]]: TConfig["queues"][Q] extends {
-        jobs: infer TJobs extends Record<string, IgniterJobDefinition<any, any, any>>;
+        jobs: infer TJobs extends Record<string, IgniterJobDefinition<any, any, any, any>>;
     } ? IgniterJobsQueueAccessor<TJobs> : IgniterJobsQueueAccessor;
 };
 
@@ -383,6 +385,11 @@ declare class IgniterJobsManager<TConfig extends IgniterJobsConfig<any, any, any
      */
     private getJobDefinition;
     private getEffectiveJobDefinition;
+    private createExecutionStreamEmitter;
+    private createJobStreamAccessor;
+    private normalizeStreamEmitPayload;
+    private normalizeStreamReadEvent;
+    private getJobStreamSchema;
     /**
      * Resolves the effective scope for a job operation.
      * @internal
@@ -435,7 +442,7 @@ declare class IgniterJobsManager<TConfig extends IgniterJobsConfig<any, any, any
  *   .build()
  * ```
  */
-declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any>> = {}, TCron extends Record<string, IgniterCronDefinition<TContext, any>> = {}, TName extends string = string> {
+declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, IgniterJobDefinition<TContext, any, any, any>> = {}, TCron extends Record<string, IgniterCronDefinition<TContext, any>> = {}, TName extends string = string> {
     private readonly state;
     private constructor();
     /**
@@ -449,7 +456,7 @@ declare class IgniterQueueBuilder<TContext, TJobs extends Record<string, Igniter
      * @param jobName - Unique name of the job inside the queue.
      * @param definition - Job definition (handler, schemas, options, hooks).
      */
-    addJob<TJobName extends string, TInput extends IgniterJobsSchema | unknown, TResult = unknown>(jobName: TJobName, definition: IgniterJobDefinition<TContext, TInput, TResult>): IgniterQueueBuilder<TContext, TJobs & Record<TJobName, IgniterJobDefinition<TContext, TInput, TResult>>, TCron, TName>;
+    addJob<TJobName extends string, TInput extends IgniterJobsSchema | unknown, TResult = unknown, TStreamEvents extends IgniterJobsJobStreamSchemaMap | undefined = undefined>(jobName: TJobName, definition: IgniterJobDefinition<TContext, TInput, TResult, TStreamEvents>): IgniterQueueBuilder<TContext, TJobs & Record<TJobName, IgniterJobDefinition<TContext, TInput, TResult, TStreamEvents>>, TCron, TName>;
     /**
      * Registers a cron task on the queue.
      *
@@ -605,7 +612,7 @@ declare class IgniterJobsBuilder<TContext, TQueues extends Record<string, Ignite
     /**
      * Applies default job options to all queues.
      */
-    withQueueDefaults(defaults: Partial<IgniterJobDefinition<TContext, any, any>>): IgniterJobsBuilder<TContext, TQueues, TScope>;
+    withQueueDefaults(defaults: Partial<IgniterJobDefinition<TContext, any, any, any>>): IgniterJobsBuilder<TContext, TQueues, TScope>;
     /**
      * Applies default worker options.
      */
@@ -737,4 +744,4 @@ declare class IgniterJobsError extends IgniterError {
     constructor(options: IgniterJobsErrorOptions);
 }
 
-export { IGNITER_JOBS_ERROR_CODES, IgniterCronDefinition, IgniterJobDefinition, IgniterJobSearchResult, IgniterJobStatus, IgniterJobs, IgniterJobsAdapter, type IgniterJobsBaseRuntime, IgniterJobsBuilder, type IgniterJobsBuilderState, type IgniterJobsConfig, IgniterJobsDispatchParams, IgniterJobsError, type IgniterJobsErrorCode, type IgniterJobsErrorOptions, IgniterJobsEventHandler, type IgniterJobsInferCronResult, type IgniterJobsInferInput, type IgniterJobsInferJobInput, IgniterJobsInferSchemaInput, type IgniterJobsJobAccessor, type IgniterJobsJobInstanceAccessor, type IgniterJobsJobManyAccessor, IgniterJobsLimiter, IgniterJobsManager, IgniterJobsQueue, type IgniterJobsQueueAccessor, IgniterJobsQueueCleanOptions, IgniterJobsQueueInfo, type IgniterJobsQueueManagerAccessor, type IgniterJobsRuntime, IgniterJobsScheduleParams, IgniterJobsSchema, IgniterJobsScopeDefinition, IgniterJobsScopeEntry, IgniterJobsScopeOptions, IgniterJobsTelemetry, type IgniterJobsWorkerBuilderAccessor, IgniterJobsWorkerBuilderConfig, type IgniterJobsWorkerFluentBuilder, IgniterJobsWorkerHandle, IgniterJobsWorkerHandlers, IgniterQueue, IgniterQueueBuilder, IgniterWorkerBuilder };
+export { IGNITER_JOBS_ERROR_CODES, IgniterCronDefinition, IgniterJobDefinition, IgniterJobSearchResult, IgniterJobStatus, IgniterJobs, IgniterJobsAdapter, type IgniterJobsBaseRuntime, IgniterJobsBuilder, type IgniterJobsBuilderState, type IgniterJobsConfig, IgniterJobsDispatchParams, IgniterJobsError, type IgniterJobsErrorCode, type IgniterJobsErrorOptions, IgniterJobsEventHandler, type IgniterJobsInferCronResult, type IgniterJobsInferInput, type IgniterJobsInferJobInput, type IgniterJobsInferJobResult, IgniterJobsInferSchemaInput, type IgniterJobsJobAccessor, type IgniterJobsJobInstanceAccessor, type IgniterJobsJobManyAccessor, IgniterJobsJobStreamAccessor, IgniterJobsJobStreamSchemaMap, IgniterJobsLimiter, IgniterJobsManager, IgniterJobsQueue, type IgniterJobsQueueAccessor, IgniterJobsQueueCleanOptions, IgniterJobsQueueInfo, type IgniterJobsQueueManagerAccessor, type IgniterJobsRuntime, IgniterJobsScheduleParams, IgniterJobsSchema, IgniterJobsScopeDefinition, IgniterJobsScopeEntry, IgniterJobsScopeOptions, IgniterJobsTelemetry, type IgniterJobsWorkerBuilderAccessor, IgniterJobsWorkerBuilderConfig, type IgniterJobsWorkerFluentBuilder, IgniterJobsWorkerHandle, IgniterJobsWorkerHandlers, IgniterQueue, IgniterQueueBuilder, IgniterWorkerBuilder };

package/dist/index.js

@@ -146,6 +146,11 @@ var _IgniterJobsPrefix = class _IgniterJobsPrefix {
     if (!params.scope) return base;
     return `${base}:scope:${params.scope.type}:${params.scope.id}`;
   }
+  static buildJobStreamChannel(params) {
+    const base = `${_IgniterJobsPrefix.BASE_PREFIX}:stream:${params.environment}:${params.service}:${params.queue}:${params.jobId}`;
+    if (!params.scope) return base;
+    return `${base}:scope:${params.scope.type}:${params.scope.id}`;
+  }
 };
 _IgniterJobsPrefix.BASE_PREFIX = "igniter:jobs";
 var IgniterJobsPrefix = _IgniterJobsPrefix;
@@ -547,7 +552,8 @@ var IgniterJobsManager = class _IgniterJobsManager {
           },
           state: () => self.adapter.getJobState(id, queueName),
           progress: () => self.adapter.getJobProgress(id, queueName),
-          logs: () => self.adapter.getJobLogs(id, queueName)
+          logs: () => self.adapter.getJobLogs(id, queueName),
+          stream: () => self.createJobStreamAccessor(queueName, jobName, id)
         };
       },
       many(ids) {
@@ -880,10 +886,18 @@ var IgniterJobsManager = class _IgniterJobsManager {
   async buildExecutionContext(ctx, queueName, jobName) {
     const realContext = await this.config.contextFactory();
     const scope = ctx.scope ?? IgniterJobsScopeUtils.extractScopeFromMetadata(ctx.job.metadata);
+    const definition = this.getJobDefinition(queueName, jobName);
+    const stream = this.createExecutionStreamEmitter(
+      queueName,
+      jobName,
+      ctx.job.id,
+      scope,
+      definition
+    );
     return {
       ...ctx,
       context: realContext,
-      job: { ...ctx.job, name: jobName, queue: queueName },
+      job: { ...ctx.job, name: jobName, queue: queueName, stream },
       scope
     };
   }
@@ -921,6 +935,115 @@ var IgniterJobsManager = class _IgniterJobsManager {
       name: jobName
     };
   }
+  createExecutionStreamEmitter(queueName, jobName, jobId, scope, definition) {
+    return {
+      emit: async (type, data) => {
+        const payload = await this.normalizeStreamEmitPayload(
+          queueName,
+          jobName,
+          type,
+          data,
+          definition
+        );
+        return this.adapter.writeJobStreamEvent({
+          queue: queueName,
+          jobName,
+          jobId,
+          scope,
+          persistence: definition?.stream?.persistence,
+          event: {
+            type,
+            data: payload,
+            timestamp: /* @__PURE__ */ new Date(),
+            jobId,
+            jobName,
+            queue: queueName,
+            scope
+          }
+        });
+      }
+    };
+  }
+  createJobStreamAccessor(queueName, jobName, jobId) {
+    const definition = this.getJobDefinition(queueName, jobName);
+    return {
+      subscribe: async (handler) => {
+        return this.adapter.subscribeJobStream({
+          queue: queueName,
+          jobId,
+          handler: async (event) => {
+            const normalized = await this.normalizeStreamReadEvent(
+              queueName,
+              jobName,
+              event,
+              definition
+            );
+            await handler(normalized);
+          }
+        });
+      },
+      read: async ({
+        after,
+        limit
+      } = {}) => {
+        if (!definition?.stream?.persistence?.enabled) {
+          return {
+            items: [],
+            nextCursor: void 0,
+            hasMore: false
+          };
+        }
+        const result = await this.adapter.readJobStream({
+          queue: queueName,
+          jobId,
+          after,
+          limit
+        });
+        return {
+          ...result,
+          items: await Promise.all(
+            result.items.map(
+              (event) => this.normalizeStreamReadEvent(
+                queueName,
+                jobName,
+                event,
+                definition
+              )
+            )
+          )
+        };
+      }
+    };
+  }
+  async normalizeStreamEmitPayload(queueName, jobName, type, data, definition) {
+    const schema = this.getJobStreamSchema(definition, type);
+    if (!schema) return data;
+    return IgniterJobsValidationUtils.validateInput(schema, data);
+  }
+  async normalizeStreamReadEvent(queueName, jobName, event, definition) {
+    const schema = this.getJobStreamSchema(definition, event.type);
+    if (!schema) return event;
+    const normalized = await IgniterJobsValidationUtils.validateInput(
+      schema,
+      event.data
+    );
+    return {
+      ...event,
+      data: normalized
+    };
+  }
+  getJobStreamSchema(definition, type) {
+    const events = definition?.stream?.events;
+    if (!events) return void 0;
+    const schema = events[type];
+    if (!schema) {
+      throw new IgniterJobsError({
+        code: "JOBS_VALIDATION_FAILED",
+        message: `Stream event "${type}" is not registered for this job definition.`
+      });
+    }
+    return schema;
+  }
   /**
    * Resolves the effective scope for a job operation.
    * @internal