@rapidrest/core 1.0.2 → 1.1.0

package/package.json

@@ -1,96 +1,96 @@
-{
-  "name": "@rapidrest/core",
-  "version": "1.0.2",
-  "description": "A collection of common utilities and core functionality for rapidly building RESTful applications.",
-  "repository": "https://github.com/rapidrest/core.git",
-  "author": "RapidREST <rapidrests@gmail.com>",
-  "license": "MIT",
-  "contributors": [
-    "Jean-Philippe Steinmetz",
-    "Arthur Thompson",
-    "Thomas Buscaglia"
-  ],
-  "scripts": {
-    "build": "rimraf dist && tsc",
-    "deploy-docs": "ts-node tools/gh-pages-publish",
-    "docs": "typedoc --plugin typedoc-plugin-markdown --out docs/reference src",
-    "lint": "eslint ./src ./test",
-    "local-audit": "yarn install && yarn npm audit -A -R \"$@\"",
-    "checkup": "yarn dlx @yarnpkg/doctor \"$@\"",
-    "dependency-check": "yarn dlx depcheck \"$@\"",
-    "report-coverage": "cat ./coverage/lcov.info | coveralls",
-    "test": "node --loader ts-node/esm ./node_modules/vitest/vitest.mjs run",
-    "test:prod": "npm run lint && node --loader ts-node/esm ./node_modules/vitest/vitest.mjs run",
-    "postversion": "git push && git push --tags"
-  },
-  "dependencies": {
-    "form-data": "^4.0.5",
-    "handlebars": "^4.7.8",
-    "js-yaml": "^4.1.1",
-    "jsonwebtoken": "^9.0.3",
-    "jszip": "^3.10.1",
-    "mkdirp": "^3.0.1",
-    "readline": "^1.3.0",
-    "triple-beam": "^1.4.1",
-    "uuid": "^13.0.0",
-    "validator": "^13.15.26"
-  },
-  "peerDependencies": {
-    "axios": "1.x",
-    "reflect-metadata": "0.2.x",
-    "winston": "3.x",
-    "winston-transport": "4.x"
-  },
-  "devDependencies": {
-    "@slack/bolt": "^4.6.0",
-    "@slack/web-api": "^7.13.0",
-    "@types/eslint": "^9.6.1",
-    "@types/express": "^5.0.6",
-    "@types/js-yaml": "^4.0.9",
-    "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "^25.2.0",
-    "@types/nodemailer": "^7.0.9",
-    "@types/triple-beam": "^1.3.5",
-    "@types/validator": "^13.15.10",
-    "@typescript-eslint/eslint-plugin": "^8.54.0",
-    "@typescript-eslint/parser": "^8.54.0",
-    "axios": "^1.13.4",
-    "coveralls": "^3.1.1",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^62.5.0",
-    "mkdirp": "^3.0.1",
-    "nconf": "^0.13.0",
-    "nock": "^14.0.10",
-    "nodemailer": "^7.0.13",
-    "prettier": "^3.8.1",
-    "reflect-metadata": "^0.2.2",
-    "rimraf": "^6.1.2",
-    "ts-node": "^10.9.2",
-    "twilio": "^5.12.0",
-    "typedoc": "^0.28.16",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "winston": "^3.19.0",
-    "winston-transport": "^4.9.0"
-  },
-  "resolutions": {
-    "cross-spawn": "^7.0.5"
-  },
-  "packageManager": "yarn@4.5.0",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "main": "dist/lib/index.js",
-  "type": "module",
-  "typings": "dist/types/index.d.ts",
-  "files": [
-    "dist",
-    "docs"
-  ]
-}
+{
+    "name": "@rapidrest/core",
+    "version": "1.1.0",
+    "description": "A collection of common utilities and core functionality for rapidly building RESTful applications.",
+    "repository": "https://github.com/rapidrest/core.git",
+    "author": "RapidREST <rapidrests@gmail.com>",
+    "license": "MIT",
+    "contributors": [
+        "Jean-Philippe Steinmetz",
+        "Arthur Thompson",
+        "Thomas Buscaglia"
+    ],
+    "scripts": {
+        "build": "rimraf dist && tsc",
+        "deploy-docs": "ts-node tools/gh-pages-publish",
+        "docs": "typedoc --plugin typedoc-plugin-markdown --out docs/reference src",
+        "lint": "eslint ./src ./test",
+        "local-audit": "yarn install && yarn npm audit -A -R \"$@\"",
+        "checkup": "yarn dlx @yarnpkg/doctor \"$@\"",
+        "dependency-check": "yarn dlx depcheck \"$@\"",
+        "report-coverage": "cat ./coverage/lcov.info | coveralls",
+        "test": "node --loader ts-node/esm ./node_modules/vitest/vitest.mjs run",
+        "test:prod": "npm run lint && node --loader ts-node/esm ./node_modules/vitest/vitest.mjs run",
+        "postversion": "git push && git push --tags"
+    },
+    "dependencies": {
+        "form-data": "^4.0.5",
+        "handlebars": "^4.7.8",
+        "js-yaml": "^4.1.1",
+        "jsonwebtoken": "^9.0.3",
+        "jszip": "^3.10.1",
+        "mkdirp": "^3.0.1",
+        "readline": "^1.3.0",
+        "triple-beam": "^1.4.1",
+        "uuid": "^13.0.0",
+        "validator": "^13.15.26"
+    },
+    "peerDependencies": {
+        "axios": "1.x",
+        "reflect-metadata": "0.2.x",
+        "winston": "3.x",
+        "winston-transport": "4.x"
+    },
+    "devDependencies": {
+        "@slack/bolt": "^4.6.0",
+        "@slack/web-api": "^7.13.0",
+        "@types/eslint": "^9.6.1",
+        "@types/express": "^5.0.6",
+        "@types/js-yaml": "^4.0.9",
+        "@types/jsonwebtoken": "^9.0.10",
+        "@types/node": "^25.2.0",
+        "@types/nodemailer": "^7.0.9",
+        "@types/triple-beam": "^1.3.5",
+        "@types/validator": "^13.15.10",
+        "@typescript-eslint/eslint-plugin": "^8.54.0",
+        "@typescript-eslint/parser": "^8.54.0",
+        "axios": "^1.13.4",
+        "coveralls": "^3.1.1",
+        "eslint": "^9.39.2",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-import": "^2.32.0",
+        "eslint-plugin-jsdoc": "^62.5.0",
+        "mkdirp": "^3.0.1",
+        "nconf": "^0.13.0",
+        "nock": "^14.0.10",
+        "nodemailer": "^7.0.13",
+        "prettier": "^3.8.1",
+        "reflect-metadata": "^0.2.2",
+        "rimraf": "^6.1.2",
+        "ts-node": "^10.9.2",
+        "twilio": "^5.12.0",
+        "typedoc": "^0.28.16",
+        "typedoc-plugin-markdown": "^4.9.0",
+        "typescript": "^5.9.3",
+        "vitest": "^4.0.18",
+        "winston": "^3.19.0",
+        "winston-transport": "^4.9.0"
+    },
+    "resolutions": {
+        "cross-spawn": "^7.0.5"
+    },
+    "packageManager": "yarn@4.5.0",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/"
+    },
+    "main": "dist/lib/index.js",
+    "type": "module",
+    "typings": "dist/types/index.d.ts",
+    "files": [
+        "dist",
+        "docs"
+    ]
+}

package/dist/lib/threads/ThreadLogger.js

@@ -1,42 +0,0 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
-///////////////////////////////////////////////////////////////////////////////
-import { parentPort, threadId } from "worker_threads";
-/**
- * Provides a Winston transport for forwarding logs from this thread to the parent's logger instance.
- *
- * Constructor requires two properties to be set in the `opts` argument:
- * - `parentPort`
- * - `threadId`
- */
-class ThreadLogger {
-    log(data) {
-        if (typeof data !== "object") {
-            data = {
-                level: "info",
-                message: data,
-            };
-        }
-        // Prefix the thread ID to the message
-        data.message = `[Thread-${threadId}]: ${data.message}`;
-        // Forward the log to the parent thread
-        parentPort?.postMessage({
-            type: "_WorkerLog",
-            data,
-        });
-    }
-    debug(message) {
-        this.log({ level: "debug", message });
-    }
-    error(message) {
-        this.log({ level: "error", message });
-    }
-    info(message) {
-        this.log({ level: "info", message });
-    }
-    warn(message) {
-        this.log({ level: "warn", message });
-    }
-}
-module.exports = ThreadLogger;
-//# sourceMappingURL=ThreadLogger.js.map

package/dist/lib/threads/ThreadLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadLogger.js","sourceRoot":"","sources":["../../../src/threads/ThreadLogger.js"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,YAAY;IACd,GAAG,CAAC,IAAI;QACJ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG;gBACH,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,OAAO,GAAG,WAAW,QAAQ,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAEvD,uCAAuC;QACvC,UAAU,EAAE,WAAW,CAAC;YACpB,IAAI,EAAE,YAAY;YAClB,IAAI;SACP,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO;QACT,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,OAAO;QACR,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,OAAO;QACR,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;CACJ;AAED,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC"}

package/dist/lib/threads/ThreadWorkerEntry.js

@@ -1,76 +0,0 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
-///////////////////////////////////////////////////////////////////////////////
-import { parentPort, workerData } from "worker_threads";
-import Logger from "./ThreadLogger";
-const logger = new Logger();
-logger.debug(`Starting ThreadWorkerEntry...`);
-logger.debug(`WorkerData: ${JSON.stringify(workerData)}`);
-// Register for parent messages
-if (workerData) {
-    let worker = null;
-    try {
-        // Load the TypeScript environment if enabled
-        if (workerData.allowTs) {
-            require("ts-node").register();
-        }
-        // Import the worker class and initialize
-        logger.debug(`Loading worker: ${workerData.worker}`);
-        const mod = require(workerData.worker);
-        if (typeof mod.default !== "function") {
-            throw new Error(`No default export found for worker: ${workerPath}`);
-        }
-        logger.debug(`Initializing worker...`);
-        const clazz = mod.default;
-        const args = workerData.args || [];
-        worker = new clazz(logger, ...args);
-        void worker.start();
-        parentPort.on("message", async (msg) => {
-            try {
-                switch (msg.type) {
-                    case "_StartWorker":
-                        await worker?.start();
-                        break;
-                    case "_StopWorker":
-                        logger.debug(`Stopping worker...`);
-                        await worker?.stop();
-                        process.exit(0);
-                        break;
-                    default:
-                        await worker?.onMessage(msg);
-                        break;
-                }
-            }
-            catch (error) {
-                parentPort?.postMessage({
-                    type: "_WorkerError",
-                    data: error,
-                });
-            }
-        });
-        parentPort.on("close", async () => {
-            logger.debug(`Stopping worker...`);
-            await worker?.stop();
-            process.exit(0);
-        });
-        // Notify the coordinator that we're ready
-        parentPort?.postMessage({ type: "_WorkerOnline" });
-        logger.debug(`Worker is online!`);
-    }
-    catch (error) {
-        parentPort?.postMessage({
-            type: "_WorkerError",
-            data: error,
-        });
-        logger.error(`An error occurred initializing worker.`);
-        logger.error(error);
-    }
-}
-else {
-    logger.error(`WorkerData is missing.`);
-    parentPort?.postMessage({
-        type: "_WorkerError",
-        data: new Error("WorkerData is missing."),
-    });
-}
-//# sourceMappingURL=ThreadWorkerEntry.js.map

package/dist/lib/threads/ThreadWorkerEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadWorkerEntry.js","sourceRoot":"","sources":["../../../src/threads/ThreadWorkerEntry.js"],"names":[],"mappings":"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"}

package/dist/types/threads/ThreadLogger.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/threads/ThreadWorkerEntry.d.ts

@@ -1 +0,0 @@
-export {};