@quave/agenda 1.0.0

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@quave/agenda",
+  "version": "1.0.0",
+  "description": "Light weight job scheduler for Node.js (Quave-managed fork of agenda)",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      },
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./test/shared/index.ts",
+      "import": "./test/shared/index.ts",
+      "default": "./test/shared/index.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "test/shared",
+    "test/fixtures"
+  ],
+  "scripts": {
+    "build": "tsc -b && npm run build:cjs",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc -b && tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --config ../../eslint.config.js",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepublishOnly": "npm run clean && npm run build",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'})+'\\n')\""
+  },
+  "keywords": [
+    "job",
+    "jobs",
+    "cron",
+    "delayed",
+    "scheduler",
+    "runner"
+  ],
+  "author": "Quave",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quavedev/npm-packages.git",
+    "directory": "packages/agenda"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cron-parser": "^5.6.1",
+    "date.js": "~0.3.3",
+    "debug": "^4.4.3",
+    "human-interval": "~2.0.1",
+    "luxon": "^3.7.2"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.13",
+    "@types/human-interval": "^1.0.2",
+    "@types/luxon": "^3.7.2",
+    "@vitest/coverage-v8": "^4.1.9",
+    "tsx": "^4.23.0",
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "node": ">=14.13.1"
+  }
+}

package/test/fixtures/forkHelper.js

@@ -0,0 +1,40 @@
+/**
+ * Minimal fork helper used by test/job-unit.test.ts to exercise the
+ * fork-mode code paths of Job.run(). The real-world equivalent would load the
+ * job definition and execute it; this helper just simulates the possible
+ * child process outcomes based on the job name it receives.
+ *
+ * argv[2] = job name, argv[3] = job id, argv[4] = definition file path
+ */
+
+const jobName = process.argv[2] || '';
+
+if (jobName.includes('fail-raw')) {
+	// send a non-JSON message so the parent stores it verbatim
+	if (process.send) {
+		process.send('plain child error message');
+	}
+	// give the message time to flush before exiting non-zero
+	setTimeout(() => process.exit(3), 25);
+} else if (jobName.includes('fail-json')) {
+	if (process.send) {
+		process.send(JSON.stringify({ message: 'structured child error', stack: 'child-stack' }));
+	}
+	setTimeout(() => process.exit(2), 25);
+} else if (jobName.includes('fail-object')) {
+	// IPC delivers this to the parent as a deserialized object (not a string)
+	if (process.send) {
+		process.send({ message: 'object child error' });
+	}
+	setTimeout(() => process.exit(5), 25);
+} else if (jobName.includes('wait')) {
+	// stay alive until the parent sends a cancel message
+	process.on('message', message => {
+		if (message === 'cancel') {
+			process.exit(4);
+		}
+	});
+	setTimeout(() => process.exit(0), 10000);
+} else {
+	process.exit(0);
+}

package/test/fixtures/someJobDefinition.ts

@@ -0,0 +1,12 @@
+import type { Agenda } from '../../src/index.js';
+
+export default (agenda: Agenda, _definitionOnly = false) => {
+	agenda.define('some job', async job => {
+		console.log('HELLO from a sub worker');
+		if (job.attrs.data?.failIt === 'error') {
+			throw new Error('intended error :-)');
+		} else if (job.attrs.data?.failIt === 'die') {
+			process.exit(2);
+		}
+	});
+};