@tryghost/job-manager 3.0.3 → 3.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2013-2026 Ghost Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -7,6 +7,7 @@ A manager for background jobs in Ghost, supporting one-off tasks and recurring j
 Background job orchestration for Ghost, supporting one-off and recurring jobs in-process or offloaded workers.
 
 ## Table of Contents
+
 - [Quick Start](#quick-start)
 - [Job Types](#job-types)
 - [Background Job Requirements](#background-job-requirements)
@@ -17,20 +18,20 @@ Background job orchestration for Ghost, supporting one-off and recurring jobs in
 
 ```js
 const JobManager = require('@tryghost/job-manager');
-const jobManager = new JobManager({JobModel: models.Job});
+const jobManager = new JobManager({ JobModel: models.Job });
 
 // Simple one-off job
 jobManager.addJob({
     name: 'hello-world',
     job: () => console.log('Hello World'),
-    offloaded: false
+    offloaded: false,
 });
 
 // Recurring job every 5 minutes
 jobManager.addJob({
     name: 'check-emails',
     at: 'every 5 minutes',
-    job: './jobs/check-emails.js'
+    job: './jobs/check-emails.js',
 });
 ```
 
@@ -39,14 +40,14 @@ jobManager.addJob({
 Ghost supports two types of jobs:
 
 1. **Inline Jobs**
-   - Run in the main Ghost process
-   - Best for quick, simple tasks
-   - Cannot be scheduled or recurring
+    - Run in the main Ghost process
+    - Best for quick, simple tasks
+    - Cannot be scheduled or recurring
 
 2. **Offloaded Jobs**
-   - Run in a separate process
-   - Good for CPU-intensive tasks
-   - Can be scheduled or recurring
+    - Run in a separate process
+    - Good for CPU-intensive tasks
+    - Can be scheduled or recurring
 
 ## Background Job Requirements
 
@@ -61,30 +62,31 @@ Offloaded jobs must:
 ## Advanced Usage
 
 Below is a sample code to wire up job manger and initialize jobs. This is the simplest way to interact with the job manager - these jobs do not persist after reboot:
+
 ```js
 const JobManager = require('@tryghost/job-manager');
 
-const jobManager = new JobManager({JobModel: models.Job});
+const jobManager = new JobManager({ JobModel: models.Job });
 
 // register a job "function" with queued execution in current event loop
 jobManager.addJob({
     job: (word) => console.log(word),
     name: 'hello',
-    offloaded: false
+    offloaded: false,
 });
 
 // register a job "module" with queued execution in current even loop
 jobManager.addJob({
-    job:'./path/to/email-module.js',
-    data: {email: 'send@here.com'},
-    offloaded: false
+    job: './path/to/email-module.js',
+    data: { email: 'send@here.com' },
+    offloaded: false,
 });
 
 // register recurring job which needs execution outside of current event loop
 jobManager.addJob({
     at: 'every 5 minutes',
     job: './path/to/jobs/check-emails.js',
-    name: 'email-checker'
+    name: 'email-checker',
 });
 
 // register recurring job with cron syntax running every 5 minutes
@@ -93,20 +95,20 @@ jobManager.addJob({
 jobManager.addJob({
     at: '0 1/5 * * * *',
     job: './path/to/jobs/check-emails.js',
-    name: 'email-checker-cron'
+    name: 'email-checker-cron',
 });
 
 // register a job to run immediately running outside of current even loop
 jobManager.addJob({
     job: './path/to/jobs/check-emails.js',
-    name: 'email-checker-now'
+    name: 'email-checker-now',
 });
 
 // register a one-off job to be executed immediately within current event loop
 jobManager.addOneOffJob({
     name: 'members-migrations',
     offloaded: false,
-    job: stripeService.migrations.execute.bind(stripeService.migrations)
+    job: stripeService.migrations.execute.bind(stripeService.migrations),
 });
 
 // register a one-off job to be executed immediately outside of current event loop
@@ -115,12 +117,12 @@ jobManager.addOneOffJob({
     job: './path/to/jobs/backup.js',
 });
 
-// optionally await completion of the one-off job in case 
+// optionally await completion of the one-off job in case
 // there are state changes expected to execute the rest of the process
 //  NOTE: if multiple jobs are submitted using the same name, the first completion will resolve
 await jobManager.awaitOneOffCompletion('members-migrations');
 
-// check if previously registered one-off job has been executed 
+// check if previously registered one-off job has been executed
 // successfully - it exists and doesn't have a "failed" state.
 //  NOTE: this is stored in memory and cleared on reboot
 const backupSuccessful = await jobManager.hasExecutedSuccessfully('generate-backup-2022-09-15');
@@ -139,16 +141,20 @@ For more examples of JobManager initialization check [test/examples](https://git
 ## Technical Details
 
 ### Process Isolation
+
 Background jobs run in separate processes, meaning:
+
 - No shared memory with Ghost
 - Must import own dependencies
 - Should avoid heavy dependencies
 - Should handle graceful shutdown
 
 ### Job Lifecycle
+
 Offloaded jobs are running on dedicated worker threads which makes their lifecycle a bit different from inline jobs:
+
 1. When **starting** a job it's only sharing ENV variables with its parent process. The job itself is run on an independent JavaScript execution thread. The script has to re-initialize any modules it will use. For example, it should take care of: model layer initialization, cache initialization, etc.
-2. When **finishing** work in a job prefer to signal successful termination by sending 'done' message to the parent thread: `parentPort.postMessage('done')` ([example use](https://github.com/TryGhost/Utils/blob/0e423f6c5c69b08d81d470f49de95654d8cc90e3/packages/job-manager/test/jobs/graceful.js#L33-L37)). Finishing work this way terminates the thread through [worker.terminate()]((https://nodejs.org/dist/latest-v14.x/docs/api/worker_threads.html#worker_threads_worker_terminate)), which logs termination in parent process and flushes any pipes opened in thread.
+2. When **finishing** work in a job prefer to signal successful termination by sending 'done' message to the parent thread: `parentPort.postMessage('done')` ([example use](https://github.com/TryGhost/Utils/blob/0e423f6c5c69b08d81d470f49de95654d8cc90e3/packages/job-manager/test/jobs/graceful.js#L33-L37)). Finishing work this way terminates the thread through [worker.terminate()](<(https://nodejs.org/dist/latest-v14.x/docs/api/worker_threads.html#worker_threads_worker_terminate)>), which logs termination in parent process and flushes any pipes opened in thread.
 3. Jobs that have iterative nature, or need cleanup before interrupting work should allow for **graceful shutdown** by listening on `'cancel'` message coming from parent thread ([example use](https://github.com/TryGhost/Utils/blob/0e423f6c5c69b08d81d470f49de95654d8cc90e3/packages/job-manager/test/jobs/graceful.js#L12-L16)).
 4. When **exceptions** happen and expected outcome is to terminate current job, leave the exception unhandled allowing it to bubble up to the job manager. Unhandled exceptions [terminate current thread](https://nodejs.org/dist/latest-v14.x/docs/api/worker_threads.html#worker_threads_event_error) and allow for next scheduled job execution to happen.
 

package/lib/JobManager.js

@@ -4,7 +4,7 @@ const setTimeoutPromise = util.promisify(setTimeout);
 const fastq = require('fastq');
 const later = require('@breejs/later');
 const Bree = require('bree');
-const {UnhandledJobError, IncorrectUsageError} = require('@tryghost/errors');
+const { UnhandledJobError, IncorrectUsageError } = require('@tryghost/errors');
 const logging = require('@tryghost/logging');
 const isCronExpression = require('./is-cron-expression');
 const assembleBreeJob = require('./assemble-bree-job');
@@ -23,7 +23,7 @@ const ALL_STATUSES = {
     started: 'started',
     finished: 'finished',
     failed: 'failed',
-    queued: 'queued'
+    queued: 'queued',
 };
 
 /**
@@ -37,9 +37,6 @@ const ALL_STATUSES = {
 class JobManager {
     #domainEvents;
     #completionPromises = new Map();
-    #config;
-    #JobModel;
-    #events;
 
     /**
      * @param {Object} options
@@ -47,30 +44,25 @@ class JobManager {
      * @param {Function} [options.workerMessageHandler] - custom message handler coming from workers
      * @param {Object} [options.JobModel] - a model which can persist job data in the storage
      * @param {Object} [options.domainEvents] - domain events emitter
-     * @param {Object} [options.config] - config
-     * @param {Object} [options.events] - events instance (for testing)
      */
-    constructor({errorHandler, workerMessageHandler, JobModel, domainEvents, config, events = null}) {
+    constructor({ errorHandler, workerMessageHandler, JobModel, domainEvents }) {
         this.inlineQueue = fastq(this, worker, 3);
         this._jobMessageHandler = this._jobMessageHandler.bind(this);
         this._jobErrorHandler = this._jobErrorHandler.bind(this);
         this.#domainEvents = domainEvents;
-        this.#config = config;
-        this.#JobModel = JobModel;
-        this.#events = events;
 
         const combinedMessageHandler = workerMessageHandler
-            ? ({name, message}) => {
-                workerMessageHandler({name, message});
-                this._jobMessageHandler({name, message});
-            }
+            ? ({ name, message }) => {
+                  workerMessageHandler({ name, message });
+                  this._jobMessageHandler({ name, message });
+              }
             : this._jobMessageHandler;
 
         const combinedErrorHandler = errorHandler
             ? (error, workerMeta) => {
-                errorHandler(error, workerMeta);
-                this._jobErrorHandler(error, workerMeta);
-            }
+                  errorHandler(error, workerMeta);
+                  this._jobErrorHandler(error, workerMeta);
+              }
             : this._jobErrorHandler;
 
         this.bree = new Bree({
@@ -79,15 +71,15 @@ class JobManager {
             outputWorkerMetadata: true,
             logger: logging,
             errorHandler: combinedErrorHandler,
-            workerMessageHandler: combinedMessageHandler
+            workerMessageHandler: combinedMessageHandler,
         });
 
         this.bree.on('worker created', (name) => {
-            this._jobMessageHandler({name, message: ALL_STATUSES.started});
+            this._jobMessageHandler({ name, message: ALL_STATUSES.started });
         });
 
         if (JobModel) {
-            this._jobsRepository = new JobsRepository({JobModel});
+            this._jobsRepository = new JobsRepository({ JobModel });
         }
     }
 
@@ -95,12 +87,12 @@ class JobManager {
         return async (error, result) => {
             if (error) {
                 await this._jobErrorHandler(error, {
-                    name: jobName
+                    name: jobName,
                 });
             } else {
                 await this._jobMessageHandler({
                     name: jobName,
-                    message: 'done'
+                    message: 'done',
                 });
             }
 
@@ -109,7 +101,7 @@ class JobManager {
         };
     }
 
-    async _jobMessageHandler({name, message}) {
+    async _jobMessageHandler({ name, message }) {
         if (name) {
             if (message === ALL_STATUSES.started) {
                 if (this._jobsRepository) {
@@ -118,7 +110,7 @@ class JobManager {
                     if (job) {
                         await this._jobsRepository.update(job.id, {
                             status: ALL_STATUSES.started,
-                            started_at: new Date()
+                            started_at: new Date(),
                         });
                     }
                 }
@@ -129,7 +121,7 @@ class JobManager {
                     if (job) {
                         await this._jobsRepository.update(job.id, {
                             status: ALL_STATUSES.finished,
-                            finished_at: new Date()
+                            finished_at: new Date(),
                         });
                     }
                 }
@@ -169,7 +161,7 @@ class JobManager {
 
             if (job) {
                 await this._jobsRepository.update(job.id, {
-                    status: ALL_STATUSES.failed
+                    status: ALL_STATUSES.failed,
                 });
             }
         }
@@ -205,7 +197,7 @@ class JobManager {
      * @prop {Object} [GhostJob.data] - data to be passed into the job
      * @prop {Boolean} [GhostJob.offloaded] - creates an "offloaded" job running in a worker thread by default. If set to "false" runs an "inline" job on the same event loop
      */
-    async addJob({name, at, job, data, offloaded = true}) {
+    async addJob({ name, at, job, data, offloaded = true }) {
         if (offloaded) {
             logging.info('Adding offloaded job to the inline job queue');
             let schedule;
@@ -215,7 +207,7 @@ class JobManager {
                     name = path.parse(job).name;
                 } else {
                     throw new IncorrectUsageError({
-                        message: 'Name parameter should be present if job is a function'
+                        message: 'Name parameter should be present if job is a function',
                     });
                 }
             }
@@ -229,11 +221,13 @@ class JobManager {
 
                 if ((schedule.error && schedule.error !== -1) || schedule.schedules.length === 0) {
                     throw new IncorrectUsageError({
-                        message: 'Invalid schedule format'
+                        message: 'Invalid schedule format',
                     });
                 }
 
-                logging.info(`Scheduling job ${name} at ${at}. Next run on: ${later.schedule(schedule).next()}`);
+                logging.info(
+                    `Scheduling job ${name} at ${at}. Next run on: ${later.schedule(schedule).next()}`,
+                );
             } else if (at !== undefined) {
                 logging.info(`Scheduling job ${name} at ${at}`);
             } else {
@@ -244,7 +238,9 @@ class JobManager {
             await this.bree.add(breeJob);
             return this.bree.start(name);
         } else {
-            logging.info(`Adding one-off job to inlineQueue with current length = ${this.inlineQueue.length()} called '${name || 'anonymous'}'`);
+            logging.info(
+                `Adding one-off job to inlineQueue with current length = ${this.inlineQueue.length()} called '${name || 'anonymous'}'`,
+            );
 
             this.inlineQueue.push(async () => {
                 try {
@@ -252,7 +248,7 @@ class JobManager {
                     //       distinguish between states when the job fails immediately
                     await this._jobMessageHandler({
                         name: name,
-                        message: ALL_STATUSES.started
+                        message: ALL_STATUSES.started,
                     });
 
                     if (typeof job === 'function') {
@@ -263,10 +259,12 @@ class JobManager {
                 } catch (err) {
                     // NOTE: each job should be written in a safe way and handle all errors internally
                     //       if the error is caught here jobs implementation should be changed
-                    logging.error(new UnhandledJobError({
-                        context: (typeof job === 'function') ? 'function' : job,
-                        err
-                    }));
+                    logging.error(
+                        new UnhandledJobError({
+                            context: typeof job === 'function' ? 'function' : job,
+                            err,
+                        }),
+                    );
 
                     throw err;
                 }
@@ -275,39 +273,39 @@ class JobManager {
     }
 
     /**
-    * Adds a job that could ever be executed once. In case the job fails
-    * can be "added" again, effectively restarting the failed job.
-    *
-    * @param {Object} GhostJob - job options
-    * @prop {Function | String} GhostJob.job - function or path to a module defining a job
-    * @prop {String} GhostJob.name - unique job name, if not provided takes function name or job script filename
-    * @prop {String | Date} [GhostJob.at] - Date, cron or human readable schedule format. Manage will do immediate execution if not specified. Not supported for "inline" jobs
-    * @prop {Object} [GhostJob.data] - data to be passed into the job
-    * @prop {Boolean} [GhostJob.offloaded] - creates an "offloaded" job running in a worker thread by default. If set to "false" runs an "inline" job on the same event loop
-    */
-    async addOneOffJob({name, job, data, offloaded = true}) {
+     * Adds a job that could ever be executed once. In case the job fails
+     * can be "added" again, effectively restarting the failed job.
+     *
+     * @param {Object} GhostJob - job options
+     * @prop {Function | String} GhostJob.job - function or path to a module defining a job
+     * @prop {String} GhostJob.name - unique job name, if not provided takes function name or job script filename
+     * @prop {String | Date} [GhostJob.at] - Date, cron or human readable schedule format. Manage will do immediate execution if not specified. Not supported for "inline" jobs
+     * @prop {Object} [GhostJob.data] - data to be passed into the job
+     * @prop {Boolean} [GhostJob.offloaded] - creates an "offloaded" job running in a worker thread by default. If set to "false" runs an "inline" job on the same event loop
+     */
+    async addOneOffJob({ name, job, data, offloaded = true }) {
         if (!name) {
             throw new IncorrectUsageError({
-                message: `The name parameter is required for a one off job.`
+                message: `The name parameter is required for a one off job.`,
             });
         }
 
         const persistedJob = await this._jobsRepository.read(name);
 
-        if (persistedJob && (persistedJob.get('status') !== ALL_STATUSES.failed)) {
+        if (persistedJob && persistedJob.get('status') !== ALL_STATUSES.failed) {
             throw new IncorrectUsageError({
-                message: `A "${name}" one off job has already been executed.`
+                message: `A "${name}" one off job has already been executed.`,
             });
         }
 
-        if (persistedJob && (persistedJob.get('status') === ALL_STATUSES.failed)) {
+        if (persistedJob && persistedJob.get('status') === ALL_STATUSES.failed) {
             await this._jobsRepository.update(persistedJob.id, {
-                status: ALL_STATUSES.queued
+                status: ALL_STATUSES.queued,
             });
         } else {
             await this._jobsRepository.add({
                 name,
-                status: ALL_STATUSES.queued
+                status: ALL_STATUSES.queued,
             });
         }
 
@@ -316,7 +314,7 @@ class JobManager {
         //       For example, it failed and the process was restarted.
         //       If we want to be able to restart within the same instance,
         //       we'd need to handle job restart/removal in Bree first
-        this.addJob({name, job, data, offloaded});
+        this.addJob({ name, job, data, offloaded });
     }
 
     /**
@@ -330,7 +328,7 @@ class JobManager {
             if (!persistedJob) {
                 return false;
             } else {
-                return (persistedJob.get('status') !== ALL_STATUSES.failed);
+                return persistedJob.get('status') !== ALL_STATUSES.failed;
             }
         } else {
             return false;
@@ -346,7 +344,10 @@ class JobManager {
     async awaitOneOffCompletion(name) {
         const persistedJob = await this._jobsRepository.read(name);
 
-        if (!persistedJob || ![ALL_STATUSES.finished, ALL_STATUSES.failed].includes(persistedJob.get('status'))) {
+        if (
+            !persistedJob ||
+            ![ALL_STATUSES.finished, ALL_STATUSES.failed].includes(persistedJob.get('status'))
+        ) {
             // NOTE: can implement exponential backoff here if that's ever needed
             await setTimeoutPromise(500);
 
@@ -365,7 +366,7 @@ class JobManager {
         const promise = new Promise((resolve, reject) => {
             this.#completionPromises.set(name, [
                 ...(this.#completionPromises.get(name) ?? []),
-                {resolve, reject}
+                { resolve, reject },
             ]);
         });
 
@@ -386,7 +387,7 @@ class JobManager {
 
             this.#completionPromises.set(name, [
                 ...(this.#completionPromises.get(name) ?? []),
-                {resolve, reject}
+                { resolve, reject },
             ]);
         });
     }
@@ -417,7 +418,7 @@ class JobManager {
 
         logging.warn('Waiting for busy job in inline job queue');
 
-        const {default: pWaitFor} = await import('p-wait-for');
+        const { default: pWaitFor } = await import('p-wait-for');
         await pWaitFor(() => this.inlineQueue.idle() === true, options);
 
         logging.warn('Inline job queue finished');

package/lib/JobsRepository.js

@@ -10,7 +10,7 @@ class JobsRepository {
      * @param {Object} options - The options object.
      * @param {Object} options.JobModel - The Job model for database operations.
      */
-    constructor({JobModel}) {
+    constructor({ JobModel }) {
         // NOTE: We ought to clean this up. We want to use bookshelf models for all db operations,
         //  but we use knex directly in a few places still largely for performance reasons.
         this._JobModel = JobModel;
@@ -36,7 +36,7 @@ class JobsRepository {
      * @returns {Promise<Object|null>} The job object if found, null otherwise.
      */
     async read(name) {
-        const job = await this._JobModel.findOne({name});
+        const job = await this._JobModel.findOne({ name });
         return job;
     }
 
@@ -49,7 +49,7 @@ class JobsRepository {
      * @returns {Promise<void>}
      */
     async update(id, data) {
-        await this._JobModel.edit(data, {id});
+        await this._JobModel.edit(data, { id });
     }
 
     /**
@@ -61,11 +61,11 @@ class JobsRepository {
      */
     async delete(id) {
         try {
-            await this._JobModel.destroy({id});
+            await this._JobModel.destroy({ id });
         } catch (error) {
             logging.error(`Error deleting job ${id}:`, error);
         }
     }
 }
 
-module.exports = JobsRepository;
+module.exports = JobsRepository;

package/lib/assemble-bree-job.js

@@ -12,28 +12,28 @@ const assemble = (at, job, data, name) => {
     const breeJob = {
         name: name,
         // NOTE: both function and path syntaxes work with 'path' parameter
-        path: job
+        path: job,
     };
 
     if (data) {
         Object.assign(breeJob, {
             worker: {
-                workerData: data
-            }
+                workerData: data,
+            },
         });
     }
 
     if (at instanceof Date) {
         Object.assign(breeJob, {
-            date: at
+            date: at,
         });
     } else if (at && isCronExpression(at)) {
         Object.assign(breeJob, {
-            cron: at
+            cron: at,
         });
     } else if (at !== undefined) {
         Object.assign(breeJob, {
-            interval: at
+            interval: at,
         });
     }
 

package/lib/is-cron-expression.js

@@ -28,8 +28,8 @@ const isCronExpression = (expression) => {
     let cronResult = cronValidate(expression, {
         preset: 'default', // second field not supported in default preset
         override: {
-            useSeconds: true // override preset option
-        }
+            useSeconds: true, // override preset option
+        },
     });
 
     return cronResult.isValid();

package/package.json

@@ -1,43 +1,41 @@
 {
   "name": "@tryghost/job-manager",
-  "version": "3.0.3",
-  "author": "Ghost Foundation",
+  "version": "3.1.0",
   "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "index.js",
-  "scripts": {
-    "dev": "echo \"Implement me!\"",
-    "test:unit": "NODE_ENV=testing vitest run --coverage",
-    "test": "yarn test:unit",
-    "lint:code": "eslint *.js lib/ --ext .js --cache",
-    "lint": "yarn lint:code && yarn lint:test",
-    "lint:test": "eslint -c test/.eslintrc.js test/ --ext .js --cache"
+  "author": "Ghost Foundation",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TryGhost/framework.git",
+    "directory": "packages/job-manager"
   },
   "files": [
     "index.js",
     "lib"
   ],
-  "devDependencies": {
-    "@sinonjs/fake-timers": "15.1.1",
-    "date-fns": "4.1.0",
-    "rewire": "9.0.1",
-    "sinon": "21.0.2"
+  "main": "index.js",
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
     "@breejs/later": "4.2.0",
-    "@tryghost/errors": "^3.0.3",
-    "@tryghost/logging": "^4.0.3",
     "bree": "9.2.9",
     "cron-validate": "1.5.3",
     "fastq": "1.20.1",
     "p-wait-for": "6.0.0",
-    "workerpool": "10.0.1"
+    "workerpool": "10.0.2",
+    "@tryghost/errors": "3.1.0",
+    "@tryghost/logging": "4.1.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/TryGhost/framework.git",
-    "directory": "packages/job-manager"
+  "devDependencies": {
+    "@sinonjs/fake-timers": "15.3.2",
+    "date-fns": "4.1.0",
+    "rewire": "9.0.1",
+    "sinon": "21.1.2"
+  },
+  "scripts": {
+    "dev": "echo \"Implement me!\"",
+    "test:unit": "NODE_ENV=testing vitest run --coverage",
+    "test": "pnpm run test:unit",
+    "lint": "oxlint -c ../../.oxlintrc.json ."
   }
-}
+}