@sidequest/engine 1.13.3 → 1.13.5

package/dist/dependency-registry.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+/**
+ * Enumeration of available dependency tokens for the dependency registry.
+ * Used as keys to register and retrieve dependencies throughout the engine.
+ */
+exports.Dependency = void 0;
+(function (Dependency) {
+    /** Engine configuration */
+    Dependency["Config"] = "config";
+    /** Backend instance */
+    Dependency["Backend"] = "backend";
+})(exports.Dependency || (exports.Dependency = {}));
+/**
+ * A type-safe dependency injection container for managing core engine dependencies.
+ * Provides methods to register, retrieve, and clear dependencies used throughout the engine lifecycle.
+ */
+class DependencyRegistry {
+    /**
+     * Internal storage for registered dependencies.
+     */
+    registry = new Map();
+    /**
+     * Retrieves a registered dependency by its token.
+     * @param token - The dependency token to look up
+     * @returns The registered dependency instance, or undefined if not found
+     */
+    get(token) {
+        return this.registry.get(token);
+    }
+    /**
+     * Registers a dependency instance with the specified token.
+     * @param token - The dependency token to register under
+     * @param instance - The dependency instance to register
+     * @returns The registered instance
+     */
+    register(token, instance) {
+        this.registry.set(token, instance);
+        return instance;
+    }
+    /**
+     * Clears all registered dependencies from the registry.
+     * Useful for cleanup and testing scenarios.
+     */
+    clear() {
+        this.registry.clear();
+    }
+}
+/**
+ * Singleton instance of the dependency registry.
+ * This is the main container used throughout the engine to manage dependencies.
+ */
+const dependencyRegistry = new DependencyRegistry();
+
+exports.dependencyRegistry = dependencyRegistry;
+//# sourceMappingURL=dependency-registry.cjs.map

package/dist/dependency-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-registry.cjs","sources":["../src/dependency-registry.ts"],"sourcesContent":[null],"names":["Dependency"],"mappings":";;AAGA;;;AAGG;AACSA;AAAZ,CAAA,UAAY,UAAU,EAAA;;AAEpB,IAAA,UAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;;AAEjB,IAAA,UAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACrB,CAAC,EALWA,kBAAU,KAAVA,kBAAU,GAAA,EAAA,CAAA,CAAA;AAgBtB;;;AAGG;AACH,MAAM,kBAAkB,CAAA;AACtB;;AAEG;AACK,IAAA,QAAQ,GAAG,IAAI,GAAG,EAAuB;AAEjD;;;;AAIG;AACH,IAAA,GAAG,CAAuB,KAAQ,EAAA;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAA2C;IAC3E;AAEA;;;;;AAKG;IACH,QAAQ,CAAuB,KAAQ,EAAE,QAAoC,EAAA;QAC3E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC;AAClC,QAAA,OAAO,QAAQ;IACjB;AAEA;;;AAGG;IACH,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AACD;AAED;;;AAGG;AACI,MAAM,kBAAkB,GAAG,IAAI,kBAAkB;;;;"}

package/dist/dependency-registry.js

@@ -0,0 +1,54 @@
+/**
+ * Enumeration of available dependency tokens for the dependency registry.
+ * Used as keys to register and retrieve dependencies throughout the engine.
+ */
+var Dependency;
+(function (Dependency) {
+    /** Engine configuration */
+    Dependency["Config"] = "config";
+    /** Backend instance */
+    Dependency["Backend"] = "backend";
+})(Dependency || (Dependency = {}));
+/**
+ * A type-safe dependency injection container for managing core engine dependencies.
+ * Provides methods to register, retrieve, and clear dependencies used throughout the engine lifecycle.
+ */
+class DependencyRegistry {
+    /**
+     * Internal storage for registered dependencies.
+     */
+    registry = new Map();
+    /**
+     * Retrieves a registered dependency by its token.
+     * @param token - The dependency token to look up
+     * @returns The registered dependency instance, or undefined if not found
+     */
+    get(token) {
+        return this.registry.get(token);
+    }
+    /**
+     * Registers a dependency instance with the specified token.
+     * @param token - The dependency token to register under
+     * @param instance - The dependency instance to register
+     * @returns The registered instance
+     */
+    register(token, instance) {
+        this.registry.set(token, instance);
+        return instance;
+    }
+    /**
+     * Clears all registered dependencies from the registry.
+     * Useful for cleanup and testing scenarios.
+     */
+    clear() {
+        this.registry.clear();
+    }
+}
+/**
+ * Singleton instance of the dependency registry.
+ * This is the main container used throughout the engine to manage dependencies.
+ */
+const dependencyRegistry = new DependencyRegistry();
+
+export { Dependency, dependencyRegistry };
+//# sourceMappingURL=dependency-registry.js.map

package/dist/dependency-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-registry.js","sources":["../src/dependency-registry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;AAGG;IACS;AAAZ,CAAA,UAAY,UAAU,EAAA;;AAEpB,IAAA,UAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;;AAEjB,IAAA,UAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACrB,CAAC,EALW,UAAU,KAAV,UAAU,GAAA,EAAA,CAAA,CAAA;AAgBtB;;;AAGG;AACH,MAAM,kBAAkB,CAAA;AACtB;;AAEG;AACK,IAAA,QAAQ,GAAG,IAAI,GAAG,EAAuB;AAEjD;;;;AAIG;AACH,IAAA,GAAG,CAAuB,KAAQ,EAAA;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAA2C;IAC3E;AAEA;;;;;AAKG;IACH,QAAQ,CAAuB,KAAQ,EAAE,QAAoC,EAAA;QAC3E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC;AAClC,QAAA,OAAO,QAAQ;IACjB;AAEA;;;AAGG;IACH,KAAK,GAAA;AACH,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AACD;AAED;;;AAGG;AACI,MAAM,kBAAkB,GAAG,IAAI,kBAAkB;;;;"}

package/dist/engine.cjs

@@ -8,6 +8,7 @@ var os = require('os');
 var url = require('url');
 var util = require('util');
 var constants$1 = require('./constants.cjs');
+var dependencyRegistry = require('./dependency-registry.cjs');
 var constants = require('./job/constants.cjs');
 var cronRegistry = require('./job/cron-registry.cjs');
 var jobBuilder = require('./job/job-builder.cjs');
@@ -22,17 +23,6 @@ require('piscina');
  * The main engine for managing job queues and workers in Sidequest.
  */
 class Engine {
-    /**
-     * Backend instance used by the engine.
-     * This is initialized when the engine is configured or started.
-     */
-    backend;
-    /**
-     * Current configuration of the engine.
-     * This is set when the engine is configured or started.
-     * It contains all the necessary settings for the engine to operate, such as backend, queues, logger options, and job defaults.
-     */
-    config;
     /**
      * Main worker process that runs the Sidequest engine.
      * This is created when the engine is started and handles job processing.
@@ -49,11 +39,11 @@ class Engine {
      * @returns The resolved configuration.
      */
     async configure(config) {
-        if (this.config) {
+        if (this.getConfig()) {
             core.logger("Engine").debug("Sidequest already configured");
-            return this.config;
+            return this.getConfig();
         }
-        this.config = {
+        const nonNullConfig = {
             queues: config?.queues ?? [],
             backend: {
                 driver: config?.backend?.driver ?? "@sidequest/sqlite-backend",
@@ -92,16 +82,17 @@ class Engine {
             jobsFilePath: config?.jobsFilePath?.trim() ?? "",
             jobPollingInterval: config?.jobPollingInterval ?? 100,
         };
+        dependencyRegistry.dependencyRegistry.register(dependencyRegistry.Dependency.Config, nonNullConfig);
         this.validateConfig();
-        core.logger("Engine").debug(`Configuring Sidequest engine: ${util.inspect(this.config)}`);
-        if (this.config.logger) {
-            core.configureLogger(this.config.logger);
+        core.logger("Engine").debug(`Configuring Sidequest engine: ${util.inspect(nonNullConfig)}`);
+        if (nonNullConfig.logger) {
+            core.configureLogger(nonNullConfig.logger);
         }
-        this.backend = new backend.LazyBackend(this.config.backend);
-        if (!this.config.skipMigration) {
-            await this.backend.migrate();
+        const backend$1 = dependencyRegistry.dependencyRegistry.register(dependencyRegistry.Dependency.Backend, new backend.LazyBackend(nonNullConfig.backend));
+        if (!nonNullConfig.skipMigration) {
+            await backend$1.migrate();
         }
-        return this.config;
+        return nonNullConfig;
     }
     /**
      * Validates the engine configuration settings.
@@ -120,17 +111,18 @@ class Engine {
      * - Logs the resolved jobs file path when using manual job resolution
      */
     validateConfig() {
-        if (this.config.maxConcurrentJobs !== undefined && this.config.maxConcurrentJobs < 1) {
+        const config = this.getConfig();
+        if (config.maxConcurrentJobs !== undefined && config.maxConcurrentJobs < 1) {
             throw new Error(`Invalid "maxConcurrentJobs" value: must be at least 1.`);
         }
-        if (this.config.manualJobResolution) {
-            if (this.config.jobsFilePath) {
-                const scriptUrl = manualLoader.resolveScriptPath(this.config.jobsFilePath);
+        if (config.manualJobResolution) {
+            if (config.jobsFilePath) {
+                const scriptUrl = manualLoader.resolveScriptPath(config.jobsFilePath);
                 if (!fs.existsSync(url.fileURLToPath(scriptUrl))) {
                     throw new Error(`The specified jobsFilePath does not exist. Resolved to: ${scriptUrl}`);
                 }
-                core.logger("Engine").info(`Using manual jobs file at: ${this.config.jobsFilePath}`);
-                this.config.jobsFilePath = scriptUrl;
+                core.logger("Engine").info(`Using manual jobs file at: ${config.jobsFilePath}`);
+                config.jobsFilePath = scriptUrl;
             }
             else {
                 // This should throw an error if not found
@@ -147,11 +139,11 @@ class Engine {
             core.logger("Engine").warn("Sidequest engine already started");
             return;
         }
-        await this.configure(config);
-        core.logger("Engine").info(`Starting Sidequest using backend ${this.config.backend.driver}`);
-        if (this.config.queues) {
-            for (const queue of this.config.queues) {
-                await grantQueueConfig.grantQueueConfig(this.backend, queue, this.config.queueDefaults, true);
+        const nonNullConfig = await this.configure(config);
+        core.logger("Engine").info(`Starting Sidequest using backend ${nonNullConfig.backend.driver}`);
+        if (nonNullConfig.queues) {
+            for (const queue of nonNullConfig.queues) {
+                await grantQueueConfig.grantQueueConfig(dependencyRegistry.dependencyRegistry.get(dependencyRegistry.Dependency.Backend), queue, nonNullConfig.queueDefaults, true);
             }
         }
         return new Promise((resolve, reject) => {
@@ -166,7 +158,7 @@ class Engine {
                     this.mainWorker.on("message", (msg) => {
                         if (msg === "ready") {
                             core.logger("Engine").debug("Main worker is ready");
-                            this.mainWorker?.send({ type: "start", sidequestConfig: this.config });
+                            this.mainWorker?.send({ type: "start", sidequestConfig: nonNullConfig });
                             clearTimeout(timeout);
                             resolve();
                         }
@@ -179,7 +171,7 @@ class Engine {
                     });
                 };
                 runWorker();
-                shutdown.gracefulShutdown(this.close.bind(this), "Engine", this.config.gracefulShutdown);
+                shutdown.gracefulShutdown(this.close.bind(this), "Engine", nonNullConfig.gracefulShutdown);
             }
         });
     }
@@ -188,14 +180,14 @@ class Engine {
      * @returns The current configuration, if set.
      */
     getConfig() {
-        return this.config;
+        return dependencyRegistry.dependencyRegistry.get(dependencyRegistry.Dependency.Config);
     }
     /**
      * Gets the backend instance in use by the engine.
      * @returns The backend instance, if set.
      */
     getBackend() {
-        return this.backend;
+        return dependencyRegistry.dependencyRegistry.get(dependencyRegistry.Dependency.Backend);
     }
     /**
      * Closes the engine and releases resources.
@@ -214,19 +206,19 @@ class Engine {
                 await promise;
             }
             try {
-                await this.backend?.close();
+                await dependencyRegistry.dependencyRegistry.get(dependencyRegistry.Dependency.Backend)?.close();
             }
             catch (error) {
                 core.logger("Engine").error("Error closing backend:", error);
             }
-            this.config = undefined;
-            this.backend = undefined;
             this.mainWorker = undefined;
             // Reset the shutting down flag after closing
             // This allows the engine to be reconfigured or restarted later
             shutdown.clearGracefulShutdown();
             core.logger("Engine").debug("Sidequest engine closed.");
             this.shuttingDown = false;
+            // Clear the dependency registry to allow fresh configuration later
+            dependencyRegistry.dependencyRegistry.clear();
         }
     }
     /**
@@ -235,19 +227,21 @@ class Engine {
      * @returns A new JobBuilder instance for the job class.
      */
     build(JobClass) {
-        if (!this.config || !this.backend) {
+        const backend = this.getBackend();
+        const config = this.getConfig();
+        if (!config || !backend) {
             throw new Error("Engine not configured. Call engine.configure() or engine.start() first.");
         }
         if (this.shuttingDown) {
             throw new Error("Engine is shutting down, cannot build job.");
         }
         core.logger("Engine").debug(`Building job for class: ${JobClass.name}`);
-        return new jobBuilder.JobBuilder(this.backend, JobClass, {
-            ...this.config.jobDefaults,
+        return new jobBuilder.JobBuilder(backend, JobClass, {
+            ...config.jobDefaults,
             // We need to do this check again because available at is a getter. It needs to be set at job creation time.
             // If not set, it will use the fallback value which is outdated from config.
-            availableAt: this.config.jobDefaults.availableAt ?? constants.JOB_BUILDER_FALLBACK.availableAt,
-        }, this.config.manualJobResolution);
+            availableAt: config.jobDefaults.availableAt ?? constants.JOB_BUILDER_FALLBACK.availableAt,
+        }, config.manualJobResolution);
     }
 }
 

package/dist/engine.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"engine.cjs","sources":["../src/engine.ts"],"sourcesContent":[null],"names":["logger","cpus","MISC_FALLBACK","JOB_BUILDER_FALLBACK","QUEUE_FALLBACK","inspect","configureLogger","LazyBackend","resolveScriptPath","existsSync","fileURLToPath","findSidequestJobsScriptInParentDirs","grantQueueConfig","fork","DEFAULT_WORKER_PATH","gracefulShutdown","ScheduledJobRegistry","clearGracefulShutdown","JobBuilder"],"mappings":"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"}
+{"version":3,"file":"engine.cjs","sources":["../src/engine.ts"],"sourcesContent":[null],"names":["logger","cpus","MISC_FALLBACK","JOB_BUILDER_FALLBACK","QUEUE_FALLBACK","dependencyRegistry","Dependency","inspect","configureLogger","backend","LazyBackend","resolveScriptPath","existsSync","fileURLToPath","findSidequestJobsScriptInParentDirs","grantQueueConfig","fork","DEFAULT_WORKER_PATH","gracefulShutdown","ScheduledJobRegistry","clearGracefulShutdown","JobBuilder"],"mappings":"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"}

package/dist/engine.d.ts

@@ -1,4 +1,5 @@
-import { BackendConfig, NewQueueData, Backend } from '@sidequest/backend';
+import * as _sidequest_backend from '@sidequest/backend';
+import { BackendConfig, NewQueueData } from '@sidequest/backend';
 import { LoggerOptions, JobClassType } from '@sidequest/core';
 import { JobBuilderDefaults, JobBuilder } from './job/job-builder.js';
 import { QueueDefaults } from './queue/grant-queue-config.js';
@@ -104,17 +105,6 @@ type NonNullableEngineConfig = {
  * The main engine for managing job queues and workers in Sidequest.
  */
 declare class Engine {
-    /**
-     * Backend instance used by the engine.
-     * This is initialized when the engine is configured or started.
-     */
-    private backend?;
-    /**
-     * Current configuration of the engine.
-     * This is set when the engine is configured or started.
-     * It contains all the necessary settings for the engine to operate, such as backend, queues, logger options, and job defaults.
-     */
-    private config?;
     /**
      * Main worker process that runs the Sidequest engine.
      * This is created when the engine is started and handles job processing.
@@ -162,7 +152,7 @@ declare class Engine {
      * Gets the backend instance in use by the engine.
      * @returns The backend instance, if set.
      */
-    getBackend(): Backend | undefined;
+    getBackend(): _sidequest_backend.Backend | undefined;
     /**
      * Closes the engine and releases resources.
      */

package/dist/engine.js

@@ -6,6 +6,7 @@ import { cpus } from 'os';
 import { fileURLToPath } from 'url';
 import { inspect } from 'util';
 import { DEFAULT_WORKER_PATH } from './constants.js';
+import { dependencyRegistry, Dependency } from './dependency-registry.js';
 import { JOB_BUILDER_FALLBACK } from './job/constants.js';
 import { ScheduledJobRegistry } from './job/cron-registry.js';
 import { JobBuilder } from './job/job-builder.js';
@@ -20,17 +21,6 @@ import 'piscina';
  * The main engine for managing job queues and workers in Sidequest.
  */
 class Engine {
-    /**
-     * Backend instance used by the engine.
-     * This is initialized when the engine is configured or started.
-     */
-    backend;
-    /**
-     * Current configuration of the engine.
-     * This is set when the engine is configured or started.
-     * It contains all the necessary settings for the engine to operate, such as backend, queues, logger options, and job defaults.
-     */
-    config;
     /**
      * Main worker process that runs the Sidequest engine.
      * This is created when the engine is started and handles job processing.
@@ -47,11 +37,11 @@ class Engine {
      * @returns The resolved configuration.
      */
     async configure(config) {
-        if (this.config) {
+        if (this.getConfig()) {
             logger("Engine").debug("Sidequest already configured");
-            return this.config;
+            return this.getConfig();
         }
-        this.config = {
+        const nonNullConfig = {
             queues: config?.queues ?? [],
             backend: {
                 driver: config?.backend?.driver ?? "@sidequest/sqlite-backend",
@@ -90,16 +80,17 @@ class Engine {
             jobsFilePath: config?.jobsFilePath?.trim() ?? "",
             jobPollingInterval: config?.jobPollingInterval ?? 100,
         };
+        dependencyRegistry.register(Dependency.Config, nonNullConfig);
         this.validateConfig();
-        logger("Engine").debug(`Configuring Sidequest engine: ${inspect(this.config)}`);
-        if (this.config.logger) {
-            configureLogger(this.config.logger);
+        logger("Engine").debug(`Configuring Sidequest engine: ${inspect(nonNullConfig)}`);
+        if (nonNullConfig.logger) {
+            configureLogger(nonNullConfig.logger);
         }
-        this.backend = new LazyBackend(this.config.backend);
-        if (!this.config.skipMigration) {
-            await this.backend.migrate();
+        const backend = dependencyRegistry.register(Dependency.Backend, new LazyBackend(nonNullConfig.backend));
+        if (!nonNullConfig.skipMigration) {
+            await backend.migrate();
         }
-        return this.config;
+        return nonNullConfig;
     }
     /**
      * Validates the engine configuration settings.
@@ -118,17 +109,18 @@ class Engine {
      * - Logs the resolved jobs file path when using manual job resolution
      */
     validateConfig() {
-        if (this.config.maxConcurrentJobs !== undefined && this.config.maxConcurrentJobs < 1) {
+        const config = this.getConfig();
+        if (config.maxConcurrentJobs !== undefined && config.maxConcurrentJobs < 1) {
             throw new Error(`Invalid "maxConcurrentJobs" value: must be at least 1.`);
         }
-        if (this.config.manualJobResolution) {
-            if (this.config.jobsFilePath) {
-                const scriptUrl = resolveScriptPath(this.config.jobsFilePath);
+        if (config.manualJobResolution) {
+            if (config.jobsFilePath) {
+                const scriptUrl = resolveScriptPath(config.jobsFilePath);
                 if (!existsSync(fileURLToPath(scriptUrl))) {
                     throw new Error(`The specified jobsFilePath does not exist. Resolved to: ${scriptUrl}`);
                 }
-                logger("Engine").info(`Using manual jobs file at: ${this.config.jobsFilePath}`);
-                this.config.jobsFilePath = scriptUrl;
+                logger("Engine").info(`Using manual jobs file at: ${config.jobsFilePath}`);
+                config.jobsFilePath = scriptUrl;
             }
             else {
                 // This should throw an error if not found
@@ -145,11 +137,11 @@ class Engine {
             logger("Engine").warn("Sidequest engine already started");
             return;
         }
-        await this.configure(config);
-        logger("Engine").info(`Starting Sidequest using backend ${this.config.backend.driver}`);
-        if (this.config.queues) {
-            for (const queue of this.config.queues) {
-                await grantQueueConfig(this.backend, queue, this.config.queueDefaults, true);
+        const nonNullConfig = await this.configure(config);
+        logger("Engine").info(`Starting Sidequest using backend ${nonNullConfig.backend.driver}`);
+        if (nonNullConfig.queues) {
+            for (const queue of nonNullConfig.queues) {
+                await grantQueueConfig(dependencyRegistry.get(Dependency.Backend), queue, nonNullConfig.queueDefaults, true);
             }
         }
         return new Promise((resolve, reject) => {
@@ -164,7 +156,7 @@ class Engine {
                     this.mainWorker.on("message", (msg) => {
                         if (msg === "ready") {
                             logger("Engine").debug("Main worker is ready");
-                            this.mainWorker?.send({ type: "start", sidequestConfig: this.config });
+                            this.mainWorker?.send({ type: "start", sidequestConfig: nonNullConfig });
                             clearTimeout(timeout);
                             resolve();
                         }
@@ -177,7 +169,7 @@ class Engine {
                     });
                 };
                 runWorker();
-                gracefulShutdown(this.close.bind(this), "Engine", this.config.gracefulShutdown);
+                gracefulShutdown(this.close.bind(this), "Engine", nonNullConfig.gracefulShutdown);
             }
         });
     }
@@ -186,14 +178,14 @@ class Engine {
      * @returns The current configuration, if set.
      */
     getConfig() {
-        return this.config;
+        return dependencyRegistry.get(Dependency.Config);
     }
     /**
      * Gets the backend instance in use by the engine.
      * @returns The backend instance, if set.
      */
     getBackend() {
-        return this.backend;
+        return dependencyRegistry.get(Dependency.Backend);
     }
     /**
      * Closes the engine and releases resources.
@@ -212,19 +204,19 @@ class Engine {
                 await promise;
             }
             try {
-                await this.backend?.close();
+                await dependencyRegistry.get(Dependency.Backend)?.close();
             }
             catch (error) {
                 logger("Engine").error("Error closing backend:", error);
             }
-            this.config = undefined;
-            this.backend = undefined;
             this.mainWorker = undefined;
             // Reset the shutting down flag after closing
             // This allows the engine to be reconfigured or restarted later
             clearGracefulShutdown();
             logger("Engine").debug("Sidequest engine closed.");
             this.shuttingDown = false;
+            // Clear the dependency registry to allow fresh configuration later
+            dependencyRegistry.clear();
         }
     }
     /**
@@ -233,19 +225,21 @@ class Engine {
      * @returns A new JobBuilder instance for the job class.
      */
     build(JobClass) {
-        if (!this.config || !this.backend) {
+        const backend = this.getBackend();
+        const config = this.getConfig();
+        if (!config || !backend) {
             throw new Error("Engine not configured. Call engine.configure() or engine.start() first.");
         }
         if (this.shuttingDown) {
             throw new Error("Engine is shutting down, cannot build job.");
         }
         logger("Engine").debug(`Building job for class: ${JobClass.name}`);
-        return new JobBuilder(this.backend, JobClass, {
-            ...this.config.jobDefaults,
+        return new JobBuilder(backend, JobClass, {
+            ...config.jobDefaults,
             // We need to do this check again because available at is a getter. It needs to be set at job creation time.
             // If not set, it will use the fallback value which is outdated from config.
-            availableAt: this.config.jobDefaults.availableAt ?? JOB_BUILDER_FALLBACK.availableAt,
-        }, this.config.manualJobResolution);
+            availableAt: config.jobDefaults.availableAt ?? JOB_BUILDER_FALLBACK.availableAt,
+        }, config.manualJobResolution);
     }
 }
 

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sources":["../src/engine.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.js","sources":["../src/engine.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/routines/release-stale-jobs.cjs

@@ -2,6 +2,15 @@
 
 var core = require('@sidequest/core');
 var util = require('util');
+require('../job/constants.cjs');
+require('node-cron');
+require('node:util');
+require('node:fs');
+require('node:url');
+require('node:path');
+require('piscina');
+require('../constants.cjs');
+var jobTransitioner = require('../job/job-transitioner.cjs');
 
 /**
  * Finds and releases stale jobs, making them available for processing again.
@@ -16,8 +25,17 @@ async function releaseStaleJobs(backend, maxStaleMs, maxClaimedMs) {
         core.logger("Engine").info(`Stale jobs found, making them available to process`);
         core.logger("Engine").debug(`Stale jobs: ${util.inspect(staleJobs)}`);
         for (const jobData of staleJobs) {
-            jobData.state = "waiting";
-            await backend.updateJob(jobData);
+            if (jobData.state === "running") {
+                // We need to use the JobTransitioner to properly handle retries and state transitions
+                // This fixes the issue where the release of a stale job incremented the retry count and
+                // did not respect the maxRetries setting.
+                await jobTransitioner.JobTransitioner.apply(backend, jobData, new core.RetryTransition("Stale job released for retry"));
+            }
+            else {
+                // If it's "claimed", then the attempt count was not incremented, so we can just set it back to "waiting"
+                jobData.state = "waiting";
+                await backend.updateJob(jobData);
+            }
         }
     }
     else {

package/dist/routines/release-stale-jobs.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"release-stale-jobs.cjs","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":["logger","inspect"],"mappings":";;;;;AAIA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxBA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAeC,YAAO,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAC3D,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,YAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAClC;IACF;SAAO;QACLD,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}
+{"version":3,"file":"release-stale-jobs.cjs","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":["logger","inspect","JobTransitioner","RetryTransition"],"mappings":";;;;;;;;;;;;;;AAKA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxBA,WAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAAA,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAeC,YAAO,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAC3D,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;;;;AAI/B,gBAAA,MAAMC,+BAAe,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAIC,oBAAe,CAAC,8BAA8B,CAAC,CAAC;YACpG;iBAAO;;AAEL,gBAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,gBAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;YAClC;QACF;IACF;SAAO;QACLH,WAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}

package/dist/routines/release-stale-jobs.js

@@ -1,5 +1,14 @@
-import { logger } from '@sidequest/core';
+import { logger, RetryTransition } from '@sidequest/core';
 import { inspect } from 'util';
+import '../job/constants.js';
+import 'node-cron';
+import 'node:util';
+import 'node:fs';
+import 'node:url';
+import 'node:path';
+import 'piscina';
+import '../constants.js';
+import { JobTransitioner } from '../job/job-transitioner.js';
 
 /**
  * Finds and releases stale jobs, making them available for processing again.
@@ -14,8 +23,17 @@ async function releaseStaleJobs(backend, maxStaleMs, maxClaimedMs) {
         logger("Engine").info(`Stale jobs found, making them available to process`);
         logger("Engine").debug(`Stale jobs: ${inspect(staleJobs)}`);
         for (const jobData of staleJobs) {
-            jobData.state = "waiting";
-            await backend.updateJob(jobData);
+            if (jobData.state === "running") {
+                // We need to use the JobTransitioner to properly handle retries and state transitions
+                // This fixes the issue where the release of a stale job incremented the retry count and
+                // did not respect the maxRetries setting.
+                await JobTransitioner.apply(backend, jobData, new RetryTransition("Stale job released for retry"));
+            }
+            else {
+                // If it's "claimed", then the attempt count was not incremented, so we can just set it back to "waiting"
+                jobData.state = "waiting";
+                await backend.updateJob(jobData);
+            }
         }
     }
     else {

package/dist/routines/release-stale-jobs.js.map

@@ -1 +1 @@
-{"version":3,"file":"release-stale-jobs.js","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAIA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxB,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,OAAO,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAC3D,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,YAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;QAClC;IACF;SAAO;QACL,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}
+{"version":3,"file":"release-stale-jobs.js","sources":["../../src/routines/release-stale-jobs.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;AAKA;;;;;;AAMG;AACI,eAAe,gBAAgB,CAAC,OAAgB,EAAE,UAAkB,EAAE,YAAoB,EAAA;IAC/F,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;AAEnE,IAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QACxB,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA,kDAAA,CAAoD,CAAC;AAC3E,QAAA,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,YAAA,EAAe,OAAO,CAAC,SAAS,CAAC,CAAA,CAAE,CAAC;AAC3D,QAAA,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE;AAC/B,YAAA,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;;;;AAI/B,gBAAA,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,eAAe,CAAC,8BAA8B,CAAC,CAAC;YACpG;iBAAO;;AAEL,gBAAA,OAAO,CAAC,KAAK,GAAG,SAAS;AACzB,gBAAA,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;YAClC;QACF;IACF;SAAO;QACL,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAA,mBAAA,CAAqB,CAAC;IAC/C;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sidequest/engine",
-  "version": "1.13.3",
+  "version": "1.13.5",
   "description": "@sidequest/engine is the core engine of SideQuest, a distributed background job processing system for Node.js and TypeScript.",
   "keywords": [
     "nodejs",
@@ -42,12 +42,12 @@
   },
   "license": "LGPL-3.0-or-later",
   "dependencies": {
-    "@sidequest/backend": "1.13.3",
-    "@sidequest/core": "1.13.3",
+    "@sidequest/backend": "1.13.5",
+    "@sidequest/core": "1.13.5",
     "node-cron": "^4.2.1",
     "piscina": "^5.1.3"
   },
   "peerDependencies": {
-    "sidequest": "1.13.3"
+    "sidequest": "1.13.5"
   }
 }