@orion-js/dogs 4.6.6 → 4.6.8

package/dist/services/Executor.d.ts

@@ -1,5 +1,6 @@
 import { Blackbox } from '@orion-js/schema';
 import { EventJobDefinition, JobDefinition, JobsDefinition } from '../types/JobsDefinition';
+import { WorkerExecutionGuard, WorkerExecutionGuardLease } from '../types/StartConfig';
 import { ExecutionContext, JobToRun } from '../types/Worker';
 /**
  * Configuration for job execution including max tries settings.
@@ -9,6 +10,8 @@ export interface ExecuteJobConfig {
     maxTries?: number;
     maxTriesReachedRetentionMs?: number | null;
     onMaxTriesReached?: (job: JobToRun) => Promise<void>;
+    executionGuard?: WorkerExecutionGuard;
+    executionGuardRetryDelayMs?: number;
 }
 export declare class Executor {
     private readonly jobsRepo;
@@ -40,5 +43,8 @@ export declare class Executor {
         jobToRun: JobToRun;
     }): Promise<void>;
     afterExecutionSuccess(job: JobDefinition, jobToRun: JobToRun, context: ExecutionContext): Promise<boolean>;
+    handleExecutionGuardAcquisitionFailure(error: unknown, config: ExecuteJobConfig, jobToRun: JobToRun, context: ExecutionContext): Promise<void>;
+    releaseExecutionGuardLease(lease: WorkerExecutionGuardLease, jobToRun: JobToRun, context: ExecutionContext): Promise<void>;
+    runGuardedResolver(job: JobDefinition, jobToRun: JobToRun, context: ExecutionContext, lease: WorkerExecutionGuardLease): Promise<any>;
     executeJob(config: ExecuteJobConfig, jobToRun: JobToRun, onExecutionStale: () => void): Promise<void>;
 }

package/dist/types/StartConfig.d.ts

@@ -2,6 +2,18 @@ import { JobsDefinition } from './JobsDefinition';
 import { JobToRun } from './Worker';
 export type LogLevels = 'debug' | 'info' | 'warn' | 'error' | 'none';
 export declare const DEFAULT_MAX_TRIES_REACHED_RETENTION_MS: number;
+/**
+ * A lease held for the duration of one job resolver execution.
+ */
+export interface WorkerExecutionGuardLease {
+    release(): Promise<void>;
+}
+/**
+ * Acquires infrastructure protection for a claimed job before its resolver starts.
+ */
+export interface WorkerExecutionGuard {
+    acquire(job: JobToRun): Promise<WorkerExecutionGuardLease>;
+}
 export interface StartWorkersConfig {
     /**
      * Object map of the jobs that this scheduler will execute.
@@ -24,6 +36,12 @@ export interface StartWorkersConfig {
      * configured retention period expires.
      */
     onMaxTriesReached?: (job: JobToRun) => Promise<void>;
+    /**
+     * Optional infrastructure guard acquired after a job is claimed and before its resolver starts.
+     * The returned lease is held until the resolver's Promise settles, including late stale
+     * executions. Acquisition failures safely requeue the job without consuming a business try.
+     */
+    executionGuard?: WorkerExecutionGuard;
     /**
      * Time in milliseconds to wait between each look without results for a job
      * to run at the database. Default is 3000.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orion-js/dogs",
-  "version": "4.6.6",
+  "version": "4.6.8",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",