@breautek/storm 9.7.5 → 9.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breautek/storm",
-  "version": "9.7.5",
+  "version": "9.8.0",
   "description": "Object-Oriented REST API framework",
   "main": "lib/api.js",
   "types": "lib/api.d.ts",
@@ -17,7 +17,6 @@
     "unit": "jest",
     "test": "npm run-script lint && jest",
     "coverage": "codecov",
-    "clean": "rm -r ./lib && rm -r ./docs",
     "prepublishOnly": "npm run-script build-lib",
     "changelog": "auto-changelog --output CHANGELOG.md -p --release-summary --ignore-commit-pattern chore",
     "preversion": "npm test",
@@ -56,7 +55,7 @@
     "form-data": "4.0.6",
     "formidable": "3.5.4",
     "jsonwebtoken": "9.0.3",
-    "mysql2": "3.23.2",
+    "mysql2": "3.24.2",
     "prom-client": "15.1.3",
     "sql-formatter": "15.8.2",
     "tslib": "2.8.1"
@@ -67,14 +66,14 @@
   },
   "devDependencies": {
     "@arashi/interfaces": "1.2.1",
-    "@arashi/logger": "4.1.5",
+    "@arashi/logger": "4.1.7",
     "@jest/types": "30.4.1",
-    "@totalpave/eslint-plugin": "7.1.1",
+    "@totalpave/eslint-plugin": "7.1.2",
     "@types/body-parser": "1.19.6",
     "@types/jest": "30.0.0",
     "@types/jsonwebtoken": "9.0.10",
     "@types/mysql": "2.15.27",
-    "@types/node": "26.1.2",
+    "@types/node": "26.3.0",
     "auto-changelog": "2.6.0",
     "jest": "30.4.2",
     "jest-jasmine2": "30.4.2",

package/pnpm-workspace.yaml

@@ -1,6 +1,10 @@
 allowBuilds:
   unrs-resolver: true
 
+minimumReleaseAgeExclude:
+  - '@totalpave/eslint-plugin@7.1.2'
+  - '@types/node@26.3.0'
+
 onlyBuiltDependencies:
   - unrs-resolver
 

package/src/Application.ts

@@ -40,6 +40,9 @@ import { StormError } from './StormError';
 import { PrometheusServer } from './PrometheusServer';
 import { MetricStore } from './MetricStore';
 import * as OS from 'node:os';
+import { IHandlerAttachBridge } from './IHandlerAttachBridge';
+import { RawHandlerAttacher } from './RawHandlerAttacher';
+import { HandlerAttacher } from './HandlerAttacher';
 
 export interface IStormCLIArgs {
     bind?: string;
@@ -193,6 +196,9 @@ export abstract class Application
         this.$getLogger().trace(TAG, 'Starting server...');
         this.$server = Express();
         this.$server.set('trust proxy', 'loopback');
+
+        await this._attachRawHandlers(new RawHandlerAttacher(this, this.$server));
+
         this.$server.use(BodyParser.json({
             type : 'application/json',
             limit : this.getRequestSizeLimit()
@@ -212,7 +218,7 @@ export abstract class Application
 
         this.$getLogger().trace(TAG, 'Attaching handlers...');
         await this.$attachHandlers();
-        await this._attachHandlers();
+        await this._attachHandlers(new HandlerAttacher(this, this.$server));
 
         await this._onBeforeReadyAsync();
 
@@ -401,11 +407,17 @@ export abstract class Application
      * 
      * @param path The URL API path. E.g. /api/myService/myCommand/
      * @param Handler
+     * @deprecated - Use {@link IHandlerAttachBridge} instead
      */
     public attachHandler(path: string, handler: Handler): void {
         this.attachHandlerInstance(path, handler);
     }
 
+    /**
+     * @deprecated - Use {@link IHandlerAttachBridge} instead
+     * @param path 
+     * @param handler 
+     */
     public attachHandlerInstance(path: string, handler: Handler): void {
         this.$server.get(path, (request: Express.Request, response: Express.Response) => {
             let r: Request = new Request(request);
@@ -455,7 +467,9 @@ export abstract class Application
      * Subclasses are expected to attach the API handlers for their service. This will be invoked during application startup.
      * @returns Promise<void>
      */
-    protected abstract _attachHandlers(): Promise<void>;
+    protected abstract _attachHandlers(attacher: IHandlerAttachBridge): Promise<void>;
+
+    protected async _attachRawHandlers(attacher: IHandlerAttachBridge): Promise<void> {}
 
     /**
      * @deprecated Supply the configs via --config and --local-config arguments

package/src/HandlerAttacher.ts

@@ -0,0 +1,37 @@
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import Express = require('express');
+import {Application} from './Application';
+import { Handler } from './Handler';
+import { IHandlerAttachBridge } from './IHandlerAttachBridge';
+import {Request} from './Request';
+import {Response} from './Response';
+
+export class HandlerAttacher implements IHandlerAttachBridge {
+    private $server: Express.Application;
+    private $app: Application;
+
+    public constructor(app: Application, server: Express.Application) {
+        this.$server = server;
+        this.$app = app;
+    }
+
+    public attach(path: string, handler: Handler): void {
+        this.$server.get(path, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.get(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.post(path, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.post(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.put(path, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.put(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.delete(path, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.delete(r, new Response(this.$app, response, r.getURL()));
+        });
+    }
+}

package/src/IHandlerAttachBridge.ts

@@ -0,0 +1,6 @@
+
+import { Handler } from './Handler';
+
+export interface IHandlerAttachBridge {
+    attach(path: string, handler: Handler): void;
+}

package/src/RawHandlerAttacher.ts

@@ -0,0 +1,44 @@
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import Express = require('express');
+import {Application} from './Application';
+import { Handler } from './Handler';
+import { IHandlerAttachBridge } from './IHandlerAttachBridge';
+import {Request} from './Request';
+import {Response} from './Response';
+import * as BodyParser from 'body-parser';
+
+export class RawHandlerAttacher implements IHandlerAttachBridge {
+    private $server: Express.Application;
+    private $app: Application;
+    private $parser: ReturnType<typeof BodyParser.raw>;
+
+    public constructor(app: Application, server: Express.Application) {
+        this.$server = server;
+        this.$app = app;
+
+        this.$parser = BodyParser.raw({
+            type: '*/*',
+            limit: app.getRequestSizeLimit()
+        });
+    }
+
+    public attach(path: string, handler: Handler): void {
+        this.$server.get(path, this.$parser, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.get(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.post(path, this.$parser, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.post(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.put(path, this.$parser, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.put(r, new Response(this.$app, response, r.getURL()));
+        });
+        this.$server.delete(path, this.$parser, (request: Express.Request, response: Express.Response) => {
+            let r: Request = new Request(request);
+            void handler.delete(r, new Response(this.$app, response, r.getURL()));
+        });
+    }
+}