@igniter-js/jobs 0.1.14 → 0.1.15

package/dist/index.mjs

@@ -144,6 +144,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;
@@ -545,7 +550,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) {
@@ -878,10 +884,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
     };
   }
@@ -919,6 +933,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