@orion-js/dogs 4.5.0 → 4.6.1

package/dist/index.cjs

@@ -74,6 +74,7 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_MAX_TRIES_REACHED_RETENTION_MS: () => DEFAULT_MAX_TRIES_REACHED_RETENTION_MS,
   EventJob: () => EventJob,
   HistoryRecordSchema: () => HistoryRecordSchema,
   JobRecordSchema: () => JobRecordSchema,
@@ -114,15 +115,32 @@ var JobRecordSchema = (0, import_schema.schemaWithName)("JobRecord", {
   nextRunAt: { type: "date" },
   lastRunAt: { type: "date", optional: true },
   lockedUntil: { type: "date", optional: true },
+  /**
+   * Identifies the execution that currently owns the lock. Mutations from an execution must match
+   * this value so a stale execution cannot modify a newer claim.
+   */
+  lockId: { type: "string", optional: true },
   tries: { type: "number", optional: true },
   params: { type: "blackbox", optional: true },
   /**
    * Status of the job. Optional for backwards compatibility with existing records.
    * Records without this field are treated as 'pending'.
    */
-  status: { type: JobStatusEnum, optional: true }
+  status: { type: JobStatusEnum, optional: true },
+  /**
+   * Date when the job reached its maximum tries. Used as the stable anchor when
+   * maxTriesReachedRetentionMs changes between worker restarts.
+   */
+  maxTriesReachedAt: { type: "date", optional: true },
+  /**
+   * Date when MongoDB should remove a terminal event job through the TTL index.
+   */
+  expiresAt: { type: "date", optional: true }
 });
 
+// src/types/StartConfig.ts
+var DEFAULT_MAX_TRIES_REACHED_RETENTION_MS = 1e3 * 60 * 60 * 24 * 7;
+
 // src/repos/JobsRepo.ts
 var _jobs_dec, _JobsRepo_decorators, _init;
 _JobsRepo_decorators = [(0, import_mongodb.Repository)()], _jobs_dec = [(0, import_mongodb.MongoCollection)({
@@ -154,6 +172,13 @@ _JobsRepo_decorators = [(0, import_mongodb.Repository)()], _jobs_dec = [(0, impo
         unique: true,
         sparse: true
       }
+    },
+    {
+      keys: {
+        expiresAt: 1
+      },
+      name: "jobs_dogs_records_expires_at_ttl",
+      expireAfterSeconds: 0
     }
   ]
 })];
@@ -162,6 +187,7 @@ var JobsRepo = class {
     __publicField(this, "jobs", __runInitializers(_init, 8, this)), __runInitializers(_init, 11, this);
   }
   async getJobAndLock(jobNames, lockTime) {
+    const executionId = (0, import_helpers.generateId)();
     const lockedUntil = new Date(Date.now() + lockTime);
     const job = await this.jobs.findOneAndUpdate(
       {
@@ -175,7 +201,7 @@ var JobsRepo = class {
         ]
       },
       {
-        $set: { lockedUntil, lastRunAt: /* @__PURE__ */ new Date() },
+        $set: { lockId: executionId, lockedUntil, lastRunAt: /* @__PURE__ */ new Date() },
         $inc: { tries: 1 }
       },
       {
@@ -196,7 +222,8 @@ var JobsRepo = class {
     }
     return {
       jobId: job._id,
-      executionId: (0, import_helpers.generateId)(),
+      executionId,
+      lockId: executionId,
       name: job.jobName,
       params: job.params,
       type: job.type,
@@ -207,8 +234,11 @@ var JobsRepo = class {
       wasStale
     };
   }
-  async setJobRecordPriority(jobId, priority) {
-    await this.jobs.updateOne(jobId, { $set: { priority } });
+  async setJobRecordPriority(jobId, priority, lockId) {
+    const result = await this.jobs.updateOne(lockId ? { _id: jobId, lockId } : jobId, {
+      $set: { priority }
+    });
+    return result.matchedCount > 0;
   }
   async scheduleNextRun(options) {
     const updator = {
@@ -217,43 +247,89 @@ var JobsRepo = class {
         priority: options.priority,
         ...options.resetTries ? { tries: 0 } : {}
       },
-      $unset: { lockedUntil: "" }
+      $unset: { lockId: "", lockedUntil: "" }
     };
-    await this.jobs.updateOne(options.jobId, updator);
+    const result = await this.jobs.updateOne(
+      options.lockId ? { _id: options.jobId, lockId: options.lockId } : options.jobId,
+      updator
+    );
+    return result.matchedCount > 0;
   }
-  async deleteEventJob(jobId) {
-    await this.jobs.deleteOne({ _id: jobId, type: "event" });
+  async deleteEventJob(jobId, lockId) {
+    const result = await this.jobs.deleteOne({
+      _id: jobId,
+      type: "event",
+      ...lockId ? { lockId } : {}
+    });
+    return result.deletedCount > 0;
   }
   /**
    * Marks an event job as having reached its maximum tries limit.
-   * The job will remain in the database but won't be picked up for execution.
+   * The job won't be picked up for execution and MongoDB will delete it after
+   * the configured retention period.
    */
-  async markJobAsMaxTriesReached(jobId) {
-    await this.jobs.updateOne(
-      { _id: jobId, type: "event" },
+  async markJobAsMaxTriesReached(jobId, retentionMs = DEFAULT_MAX_TRIES_REACHED_RETENTION_MS, lockId) {
+    const maxTriesReachedAt = /* @__PURE__ */ new Date();
+    const result = await this.jobs.updateOne(
+      { _id: jobId, type: "event", ...lockId ? { lockId } : {} },
       {
-        $set: { status: "maxTriesReached" },
-        $unset: { lockedUntil: "" }
+        $set: {
+          status: "maxTriesReached",
+          maxTriesReachedAt,
+          ...retentionMs === null ? {} : { expiresAt: new Date(maxTriesReachedAt.getTime() + retentionMs) }
+        },
+        $unset: {
+          lockId: "",
+          lockedUntil: "",
+          ...retentionMs === null ? { expiresAt: "" } : {}
+        }
       }
     );
+    return result.matchedCount > 0;
   }
-  async extendLockTime(jobId, extraTime) {
-    await this.updateLockTime(jobId, extraTime);
+  /**
+   * Applies the current retention configuration to existing maxTriesReached
+   * event jobs. The collection definition ensures the TTL index. Legacy records
+   * use lastRunAt as their retention anchor when available.
+   */
+  async ensureMaxTriesReachedRetention(retentionMs) {
+    const selector = {
+      type: "event",
+      status: "maxTriesReached"
+    };
+    if (retentionMs === null) {
+      await this.jobs.updateMany(selector, { $unset: { expiresAt: "" } });
+      return;
+    }
+    const now = /* @__PURE__ */ new Date();
+    const retentionAnchor = {
+      $ifNull: ["$maxTriesReachedAt", { $ifNull: ["$lastRunAt", now] }]
+    };
+    await this.jobs.rawCollection.updateMany(selector, [
+      {
+        $set: {
+          maxTriesReachedAt: retentionAnchor,
+          expiresAt: { $add: [retentionAnchor, retentionMs] }
+        }
+      }
+    ]);
+  }
+  async extendLockTime(jobId, extraTime, lockId) {
+    return this.updateLockTime(jobId, extraTime, lockId);
   }
   /**
    * Updates the lock time for a job to the specified duration from now.
    * Can be used to both extend or shorten the lock time.
    */
-  async updateLockTime(jobId, lockDuration) {
+  async updateLockTime(jobId, lockDuration, lockId) {
     const lockedUntil = new Date(Date.now() + lockDuration);
-    await this.jobs.updateOne(
-      {
-        _id: jobId
-      },
+    const result = await this.jobs.updateOne(
+      { _id: jobId, ...lockId ? { lockId } : {} },
       {
         $set: { lockedUntil }
       }
     );
+    return result.matchedCount > 0;
   }
   async unlockAllJobs() {
     const result = await this.jobs.updateMany(
@@ -261,7 +337,7 @@ var JobsRepo = class {
         lockedUntil: { $exists: true }
       },
       {
-        $unset: { lockedUntil: "" }
+        $unset: { lockId: "", lockedUntil: "" }
       }
     );
     return result.modifiedCount;
@@ -567,11 +643,15 @@ var Executor = class {
   getEffectiveLockTime(job, jobToRun) {
     return job.lockTime ?? jobToRun.lockTime;
   }
-  getContext(job, jobToRun, onStale) {
+  getContext(job, jobToRun, onStale, isExecutionActive) {
     var _a;
     const effectiveLockTime = this.getEffectiveLockTime(job, jobToRun);
     let staleTimeout = setTimeout(() => onStale(), effectiveLockTime);
     (_a = staleTimeout.unref) == null ? void 0 : _a.call(staleTimeout);
+    const contextLogger = import_logger3.logger.addMetadata({
+      jobName: jobToRun.name,
+      jobId: jobToRun.jobId
+    });
     return {
       definition: job,
       record: jobToRun,
@@ -579,15 +659,26 @@ var Executor = class {
       clearStaleTimeout: () => clearTimeout(staleTimeout),
       extendLockTime: async (extraTime) => {
         var _a2;
+        if (!isExecutionActive()) {
+          contextLogger.warn(`Will not extend lock for stale execution "${jobToRun.executionId}"`);
+          return;
+        }
         clearTimeout(staleTimeout);
+        let didExtend = false;
+        try {
+          didExtend = await this.jobsRepo.extendLockTime(jobToRun.jobId, extraTime, jobToRun.lockId);
+        } catch (error) {
+          onStale();
+          throw error;
+        }
+        if (!didExtend) {
+          onStale();
+          return;
+        }
         staleTimeout = setTimeout(() => onStale(), extraTime);
         (_a2 = staleTimeout.unref) == null ? void 0 : _a2.call(staleTimeout);
-        await this.jobsRepo.extendLockTime(jobToRun.jobId, extraTime);
       },
-      logger: import_logger3.logger.addMetadata({
-        jobName: jobToRun.name,
-        jobId: jobToRun.jobId
-      })
+      logger: contextLogger
     };
   }
   getJobDefinition(jobToRun, jobs) {
@@ -611,7 +702,7 @@ var Executor = class {
    * Handles when a job has reached its maximum retry attempts.
    * Marks the job in the database and invokes the onMaxTriesReached callback when provided.
    */
-  async handleMaxTriesReached(jobToRun, onMaxTriesReached) {
+  async handleMaxTriesReached(jobToRun, retentionMs, onMaxTriesReached) {
     const jobLogger = import_logger3.logger.addMetadata({
       jobName: jobToRun.name,
       jobId: jobToRun.jobId
@@ -619,8 +710,16 @@ var Executor = class {
     jobLogger.warn(
       `Job "${jobToRun.name}" has exceeded max tries (${jobToRun.tries}). Marking as maxTriesReached.`
     );
-    await this.jobsRepo.markJobAsMaxTriesReached(jobToRun.jobId);
-    if (!onMaxTriesReached) return;
+    const didMark = await this.jobsRepo.markJobAsMaxTriesReached(
+      jobToRun.jobId,
+      retentionMs,
+      jobToRun.lockId
+    );
+    if (!didMark) {
+      jobLogger.warn(`Could not mark job "${jobToRun.name}" because its lock is no longer owned`);
+      return false;
+    }
+    if (!onMaxTriesReached) return true;
     try {
       await onMaxTriesReached(jobToRun);
     } catch (callbackError) {
@@ -628,30 +727,33 @@ var Executor = class {
         error: callbackError
       });
     }
+    return true;
   }
   async onError(error, job, jobToRun, context) {
     const scheduleRecurrent = async () => {
       if (job.type === "recurrent") {
-        await this.jobsRepo.scheduleNextRun({
+        return this.jobsRepo.scheduleNextRun({
           jobId: jobToRun.jobId,
           nextRunAt: getNextRunDate(job),
           resetTries: true,
-          priority: job.priority
+          priority: job.priority,
+          lockId: jobToRun.lockId
         });
       }
+      return true;
     };
     const handleRetry = async (nextRunAt) => {
-      await this.jobsRepo.scheduleNextRun({
+      return this.jobsRepo.scheduleNextRun({
         jobId: jobToRun.jobId,
         nextRunAt,
         resetTries: false,
-        priority: job.type === "recurrent" ? job.priority : jobToRun.priority
+        priority: job.type === "recurrent" ? job.priority : jobToRun.priority,
+        lockId: jobToRun.lockId
       });
     };
     if (!job.onError) {
       context.logger.error(`Error executing job "${jobToRun.name}"`, { error });
-      await scheduleRecurrent();
-      return;
+      return scheduleRecurrent();
     }
     context.logger.info(`Error executing job "${jobToRun.name}"`, { error });
     const result = await job.onError(
@@ -660,12 +762,12 @@ var Executor = class {
       context
     );
     if (result.action === "dismiss") {
-      await scheduleRecurrent();
-      return;
+      return scheduleRecurrent();
     }
     if (result.action === "retry") {
-      await handleRetry(getNextRunDate(result));
+      return handleRetry(getNextRunDate(result));
     }
+    return true;
   }
   async saveExecution(options) {
     const { startedAt, status, errorMessage, result, job, jobToRun } = options;
@@ -695,57 +797,94 @@ var Executor = class {
   async afterExecutionSuccess(job, jobToRun, context) {
     if (job.type === "recurrent") {
       context.logger.debug(`Scheduling next run for recurrent job "${jobToRun.name}"`);
-      await this.jobsRepo.scheduleNextRun({
+      return this.jobsRepo.scheduleNextRun({
         jobId: jobToRun.jobId,
         nextRunAt: getNextRunDate(job),
         resetTries: true,
-        priority: job.priority
+        priority: job.priority,
+        lockId: jobToRun.lockId
       });
     }
     if (job.type === "event") {
       context.logger.debug(`Removing event job after success "${jobToRun.name}"`);
-      await this.jobsRepo.deleteEventJob(jobToRun.jobId);
+      return this.jobsRepo.deleteEventJob(jobToRun.jobId, jobToRun.lockId);
     }
+    return false;
   }
-  async executeJob(config, jobToRun, respawnWorker) {
+  async executeJob(config, jobToRun, onExecutionStale) {
     const job = this.getJobDefinition(jobToRun, config.jobs);
     if (!job) return;
     if (job.type === "event") {
       const effectiveMaxTries = this.getEffectiveMaxTries(job, config.maxTries);
       if (typeof effectiveMaxTries === "number" && jobToRun.tries > effectiveMaxTries) {
-        await this.handleMaxTriesReached(jobToRun, config.onMaxTriesReached);
+        await this.handleMaxTriesReached(
+          jobToRun,
+          config.maxTriesReachedRetentionMs,
+          config.onMaxTriesReached
+        );
         return;
       }
     }
     const effectiveLockTime = this.getEffectiveLockTime(job, jobToRun);
     if (effectiveLockTime !== jobToRun.lockTime) {
-      await this.jobsRepo.updateLockTime(jobToRun.jobId, effectiveLockTime);
+      const didUpdateLock = await this.jobsRepo.updateLockTime(
+        jobToRun.jobId,
+        effectiveLockTime,
+        jobToRun.lockId
+      );
+      if (!didUpdateLock) {
+        import_logger3.logger.warn(`Will not execute job "${jobToRun.name}" because its lock is no longer owned`);
+        return;
+      }
     }
     const tracer = import_api.trace.getTracer("orionjs.dogs", "1.0");
     await tracer.startActiveSpan(`job.${jobToRun.name}.${jobToRun.executionId}`, async (span) => {
       try {
         const startedAt = /* @__PURE__ */ new Date();
-        const onStale = async () => {
-          if (job.onStale) {
-            context.logger.info(`Job "${jobToRun.name}" is stale`);
-            job.onStale(jobToRun.params, context);
-          } else {
-            context.logger.error(`Job "${jobToRun.name}" is stale`);
-          }
-          await this.jobsRepo.setJobRecordPriority(jobToRun.jobId, 0);
-          void respawnWorker();
-          void this.saveExecution({
-            startedAt,
-            status: "stale",
-            result: null,
-            errorMessage: null,
-            job,
-            jobToRun
-          }).catch((error) => {
-            context.logger.error("Error saving stale execution history", { error });
+        let executionStatus = "running";
+        let staleHandlingPromise;
+        let context;
+        const markAsStale = () => {
+          if (executionStatus === "stale") return staleHandlingPromise;
+          executionStatus = "stale";
+          context.clearStaleTimeout();
+          staleHandlingPromise = (async () => {
+            context.logger.warn(`Job "${jobToRun.name}" is stale`);
+            if (job.onStale) {
+              void Promise.resolve(job.onStale(jobToRun.params, context)).catch((error) => {
+                context.logger.error(`Error in onStale callback for job "${jobToRun.name}"`, {
+                  error
+                });
+              });
+            }
+            try {
+              await this.jobsRepo.setJobRecordPriority(jobToRun.jobId, 0, jobToRun.lockId);
+            } catch (error) {
+              context.logger.error(`Error lowering priority for stale job "${jobToRun.name}"`, {
+                error
+              });
+            } finally {
+              onExecutionStale();
+            }
+            await this.saveExecution({
+              startedAt,
+              status: "stale",
+              result: null,
+              errorMessage: null,
+              job,
+              jobToRun
+            });
+          })().catch((error) => {
+            context.logger.error("Error handling stale execution", { error });
           });
+          return staleHandlingPromise;
         };
-        const context = this.getContext(job, jobToRun, onStale);
+        context = this.getContext(
+          job,
+          jobToRun,
+          () => void markAsStale(),
+          () => executionStatus === "running"
+        );
         const extraContext = {
           controllerType: "job",
           jobName: jobToRun.name,
@@ -761,6 +900,18 @@ var Executor = class {
             });
             const result = await job.resolve(jobToRun.params, context);
             context.clearStaleTimeout();
+            if (executionStatus === "stale") {
+              await staleHandlingPromise;
+              context.logger.warn(
+                `Ignoring late success from stale execution "${jobToRun.executionId}"`
+              );
+              return;
+            }
+            const stillOwnsJob = await this.afterExecutionSuccess(job, jobToRun, context);
+            if (!stillOwnsJob) {
+              await markAsStale();
+              return;
+            }
             void this.saveExecution({
               startedAt,
               status: "success",
@@ -771,9 +922,21 @@ var Executor = class {
             }).catch((error) => {
               context.logger.error("Error saving successful execution history", { error });
             });
-            await this.afterExecutionSuccess(job, jobToRun, context);
           } catch (error) {
             context.clearStaleTimeout();
+            if (executionStatus === "stale") {
+              await staleHandlingPromise;
+              context.logger.warn(
+                `Ignoring late error from stale execution "${jobToRun.executionId}"`,
+                { error }
+              );
+              return;
+            }
+            const stillOwnsJob = await this.onError(error, job, jobToRun, context);
+            if (!stillOwnsJob) {
+              await markAsStale();
+              return;
+            }
             void this.saveExecution({
               startedAt,
               status: "error",
@@ -784,7 +947,6 @@ var Executor = class {
             }).catch((saveError) => {
               context.logger.error("Error saving failed execution history", { error: saveError });
             });
-            await this.onError(error, job, jobToRun, context);
           }
         });
       } catch (error) {
@@ -844,86 +1006,131 @@ var WorkerService = class {
     }
     workersInstance.runningJobsByName.set(jobName, currentExecutions - 1);
   }
-  async withJobAcquisitionLock(workersInstance, callback) {
-    const previousLock = workersInstance.jobAcquisitionLock;
-    let releaseLock;
-    workersInstance.jobAcquisitionLock = new Promise((resolve) => {
-      releaseLock = resolve;
-    });
-    await previousLock;
-    try {
-      return await callback();
-    } finally {
-      releaseLock();
+  releaseExecutionCapacity(workersInstance, execution, nextStatus) {
+    if (execution.status !== "running") return;
+    execution.status = nextStatus;
+    workersInstance.activeExecutions.delete(execution.job.executionId);
+    this.releaseJobExecution(workersInstance, execution.job.name);
+    execution.releaseCapacity();
+    if (nextStatus === "stale") {
+      workersInstance.staleExecutions.set(execution.job.executionId, execution);
     }
   }
-  async getJobAndReserveExecution(config, workersInstance, jobNames) {
-    return this.withJobAcquisitionLock(workersInstance, async () => {
-      const availableJobNames = this.getAvailableJobNames(config, workersInstance, jobNames);
-      if (availableJobNames.length === 0) return;
-      const jobToRun = await this.jobsRepo.getJobAndLock(availableJobNames, config.defaultLockTime);
-      if (!jobToRun) return;
-      this.reserveJobExecution(workersInstance, jobToRun.name);
-      return jobToRun;
+  startExecution(config, workersInstance, jobToRun) {
+    let releaseCapacity;
+    const capacityPromise = new Promise((resolve) => {
+      releaseCapacity = resolve;
+    });
+    const execution = {
+      job: jobToRun,
+      promise: Promise.resolve(),
+      capacityPromise,
+      releaseCapacity,
+      status: "running"
+    };
+    this.reserveJobExecution(workersInstance, jobToRun.name);
+    workersInstance.activeExecutions.set(jobToRun.executionId, execution);
+    import_logger4.logger.debug(`Starting job execution "${jobToRun.executionId}"`, jobToRun);
+    const executionPromise = this.executor.executeJob(config, jobToRun, () => {
+      this.releaseExecutionCapacity(workersInstance, execution, "stale");
+    });
+    execution.promise = executionPromise;
+    void executionPromise.catch((error) => {
+      import_logger4.logger.error(`Unhandled error executing job "${jobToRun.name}"`, { error });
+    }).finally(() => {
+      if (execution.status === "running") {
+        this.releaseExecutionCapacity(workersInstance, execution, "finished");
+      } else if (execution.status === "stale") {
+        workersInstance.staleExecutions.delete(jobToRun.executionId);
+      }
     });
   }
-  async runWorkerLoop(config, workersInstance, workerInstance, jobNames, executeConfig) {
-    const jobToRun = await this.getJobAndReserveExecution(config, workersInstance, jobNames);
-    if (!jobToRun) {
-      import_logger4.logger.debug("No job to run");
-      return false;
-    }
-    import_logger4.logger.debug(`Got job [w${workerInstance.workerIndex}] to run:`, jobToRun);
-    try {
-      await this.executor.executeJob(executeConfig, jobToRun, workerInstance.respawn);
-    } finally {
-      this.releaseJobExecution(workersInstance, jobToRun.name);
-    }
-    return true;
+  async waitForPollOrStop(config, workersInstance) {
+    await Promise.race([(0, import_helpers2.sleep)(config.pollInterval), workersInstance.stopSignal]);
   }
-  async startWorker(config, workersInstance, workerInstance) {
-    const names = this.getJobNames(config.jobs);
-    import_logger4.logger.debug(
-      `Running worker loop [w${workerInstance.workerIndex}] for jobs "${names.join(", ")}"...`
+  async waitForCapacityOrStop(workersInstance) {
+    const capacityPromises = Array.from(
+      workersInstance.activeExecutions.values(),
+      (execution) => execution.capacityPromise
     );
+    if (capacityPromises.length === 0) return;
+    await Promise.race([...capacityPromises, workersInstance.stopSignal]);
+  }
+  async runSchedulerLoop(config, workersInstance) {
+    const jobNames = this.getJobNames(config.jobs);
     const executeConfig = {
       jobs: config.jobs,
       maxTries: config.maxTries,
+      maxTriesReachedRetentionMs: config.maxTriesReachedRetentionMs,
       onMaxTriesReached: config.onMaxTriesReached
     };
-    while (true) {
-      if (!workerInstance.running) {
-        import_logger4.logger.info(`Got signal to stop. Stopping worker [w${workerInstance.workerIndex}]...`);
-        return;
-      }
+    import_logger4.logger.debug(`Running scheduler loop for jobs "${jobNames.join(", ")}"...`);
+    while (workersInstance.running) {
+      let didMiss = false;
+      let allJobNamesAtCapacity = false;
       try {
-        const didRun = await this.runWorkerLoop(
-          config,
-          workersInstance,
-          workerInstance,
-          names,
-          executeConfig
-        );
-        if (!didRun) await (0, import_helpers2.sleep)(config.pollInterval);
-        if (didRun) await (0, import_helpers2.sleep)(config.cooldownPeriod);
+        while (workersInstance.activeExecutions.size < config.workersCount) {
+          const availableJobNames = this.getAvailableJobNames(config, workersInstance, jobNames);
+          if (availableJobNames.length === 0) {
+            allJobNamesAtCapacity = workersInstance.activeExecutions.size > 0;
+            break;
+          }
+          const jobToRun = await this.jobsRepo.getJobAndLock(
+            availableJobNames,
+            config.defaultLockTime
+          );
+          if (!jobToRun) {
+            import_logger4.logger.debug("No job to run");
+            didMiss = true;
+            break;
+          }
+          this.startExecution(executeConfig, workersInstance, jobToRun);
+          if (!workersInstance.running) break;
+        }
       } catch (error) {
-        import_logger4.logger.error("Error in job runner.", { error });
-        await (0, import_helpers2.sleep)(config.pollInterval);
+        import_logger4.logger.error("Error in job scheduler.", { error });
+        didMiss = true;
+      }
+      if (!workersInstance.running) return;
+      const concurrencyIsFull = workersInstance.activeExecutions.size >= config.workersCount && workersInstance.activeExecutions.size > 0;
+      if (concurrencyIsFull || allJobNamesAtCapacity) {
+        await this.waitForCapacityOrStop(workersInstance);
+      } else if (didMiss || workersInstance.activeExecutions.size === 0) {
+        await this.waitForPollOrStop(config, workersInstance);
       }
     }
   }
   createWorkersInstanceDefinition(config) {
+    let signalStop;
+    const stopSignal = new Promise((resolve) => {
+      signalStop = resolve;
+    });
     const workersInstance = {
       running: true,
       workersCount: config.workersCount,
-      workers: [],
+      activeExecutions: /* @__PURE__ */ new Map(),
+      staleExecutions: /* @__PURE__ */ new Map(),
       runningJobsByName: /* @__PURE__ */ new Map(),
-      jobAcquisitionLock: Promise.resolve(),
+      schedulerPromise: Promise.resolve(),
+      stopSignal,
+      signalStop,
+      get runningExecutions() {
+        return this.activeExecutions.size;
+      },
       stop: async () => {
-        import_logger4.logger.info("Stopping workers...");
-        workersInstance.running = false;
-        const stopingPromises = workersInstance.workers.map((worker) => worker.stop());
-        await Promise.all(stopingPromises);
+        if (workersInstance.stopPromise) return workersInstance.stopPromise;
+        workersInstance.stopPromise = (async () => {
+          import_logger4.logger.info("Stopping job scheduler...");
+          workersInstance.running = false;
+          workersInstance.signalStop();
+          await workersInstance.schedulerPromise;
+          const activeCapacity = Array.from(
+            workersInstance.activeExecutions.values(),
+            (execution) => execution.capacityPromise
+          );
+          await Promise.all(activeCapacity);
+        })();
+        return workersInstance.stopPromise;
       }
     };
     return workersInstance;
@@ -937,54 +1144,37 @@ var WorkerService = class {
       })
     );
   }
-  async startANewWorker(config, workersInstance, workerIndex = workersInstance.workers.length) {
-    if (!workersInstance.running) {
-      return;
-    }
-    const workerInstance = {
-      running: true,
-      workerIndex,
-      stop: async () => {
-        import_logger4.logger.info(`Stopping worker [w${workerIndex}]...`);
-        workerInstance.running = false;
-        await workerInstance.promise;
-      },
-      respawn: async () => {
-        import_logger4.logger.info(`Respawning worker [w${workerIndex}]...`);
-        workerInstance.running = false;
-        await this.startANewWorker(config, workersInstance, workerIndex);
-      }
-    };
-    const workerPromise = this.startWorker(config, workersInstance, workerInstance);
-    workerInstance.promise = workerPromise;
-    workersInstance.workers[workerIndex] = workerInstance;
-  }
-  async runWorkers(config, workersInstance) {
+  async runScheduler(config, workersInstance) {
+    import_logger4.logger.debug("Will ensure maxTriesReached retention and TTL index");
+    void this.jobsRepo.ensureMaxTriesReachedRetention(config.maxTriesReachedRetentionMs).catch((error) => import_logger4.logger.error("Error ensuring maxTriesReached retention", { error }));
     import_logger4.logger.debug("Will ensure records for recurrent jobs");
     await this.ensureRecords(config);
-    const workersCount = config.workersCount;
-    const workerWord = workersCount === 1 ? "worker" : "workers";
-    import_logger4.logger.info(`Starting ${workersCount} ${workerWord}`);
-    for (let workerIndex = 0; workerIndex < workersCount; workerIndex++) {
-      this.startANewWorker(config, workersInstance, workerIndex);
-    }
+    import_logger4.logger.info(`Starting job scheduler with concurrency ${config.workersCount}`);
+    await this.runSchedulerLoop(config, workersInstance);
   }
   /**
-   * Starts the job workers with the provided configuration.
-   * @param userConfig - Configuration for the workers. Required field: jobs
+   * Starts one job scheduler with the provided concurrency configuration.
+   * @param userConfig - Configuration for the scheduler. Required field: jobs
    */
   startWorkers(userConfig) {
+    const maxTriesReachedRetentionMs = userConfig.maxTriesReachedRetentionMs === void 0 ? DEFAULT_MAX_TRIES_REACHED_RETENTION_MS : userConfig.maxTriesReachedRetentionMs;
+    if (maxTriesReachedRetentionMs !== null && (!Number.isFinite(maxTriesReachedRetentionMs) || maxTriesReachedRetentionMs < 0)) {
+      throw new Error("maxTriesReachedRetentionMs must be null, zero, or a positive number");
+    }
     const config = {
-      cooldownPeriod: 100,
       pollInterval: 3e3,
       workersCount: 4,
       defaultLockTime: 30 * 1e3,
-      ...userConfig
+      ...userConfig,
+      maxTriesReachedRetentionMs
     };
     setNameToJobs(config.jobs);
     const workersInstance = this.createWorkersInstanceDefinition(config);
-    import_logger4.logger.debug("Starting workers", config);
-    this.runWorkers(config, workersInstance);
+    import_logger4.logger.debug("Starting job scheduler", config);
+    workersInstance.schedulerPromise = this.runScheduler(config, workersInstance).catch((error) => {
+      workersInstance.running = false;
+      import_logger4.logger.error("Job scheduler stopped after an unexpected error.", { error });
+    });
     return workersInstance;
   }
 };
@@ -1151,6 +1341,7 @@ var scheduleJobs = (jobs) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_MAX_TRIES_REACHED_RETENTION_MS,
   EventJob,
   HistoryRecordSchema,
   JobRecordSchema,