@breautek/storm 8.1.4 → 8.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breautek/storm",
-  "version": "8.1.4",
+  "version": "8.3.0",
   "description": "Object-Oriented REST API framework",
   "main": "lib/api.js",
   "types": "lib/api.d.ts",
@@ -51,17 +51,17 @@
     "@types/formidable": "3.4.5",
     "@types/jsonwebtoken": "9.0.7",
     "@types/mysql": "2.15.26",
-    "@types/node": "22.10.1",
+    "@types/node": "22.13.4",
     "@types/uuid": "10.0.0",
     "ajv": "8.17.1",
     "body-parser": "1.20.3",
     "commander": "12.1.0",
     "express": "4.21.2",
-    "form-data": "4.0.1",
+    "form-data": "4.0.2",
     "formidable": "3.5.2",
     "jsonwebtoken": "9.0.2",
     "mysql": "2.18.1",
-    "sql-formatter": "15.4.6",
+    "sql-formatter": "15.4.10",
     "tslib": "2.8.1",
     "uuid": "11.0.3"
   },
@@ -71,7 +71,7 @@
   },
   "devDependencies": {
     "@arashi/interfaces": "1.2.1",
-    "@arashi/logger": "4.0.7",
+    "@arashi/logger": "4.1.3",
     "@totalpave/eslint-plugin": "6.3.2",
     "@types/jest": "29.5.14",
     "@typescript-eslint/eslint-plugin": "7.18.0",
@@ -82,8 +82,8 @@
     "jest-jasmine2": "29.7.0",
     "ts-jest": "29.2.5",
     "ts-node": "10.9.2",
-    "typedoc": "0.27.4",
-    "typedoc-plugin-markdown": "4.3.2",
+    "typedoc": "0.27.7",
+    "typedoc-plugin-markdown": "4.4.2",
     "typescript": "5.6.3"
   }
 }

package/src/Application.ts

@@ -290,6 +290,10 @@ export abstract class Application
         return port;
     }
 
+    public getVersion(): string {
+        return this._getVersion();
+    }
+
     protected _getVersion(): string {
         console.warn(TAG, `_getVersion will be an abstract method in the next major release. Override this method and pass a version string.`);
         return '0.0.0';

package/src/DatabaseConnection.ts

@@ -138,8 +138,24 @@ export abstract class DatabaseConnection<TAPI> implements IDatabaseConnection {
         let params: Record<string, any> = query.getParametersForQuery();
 
         await query.onPreQuery(this);
-        let results: TQueryResult = await this._query<TQueryResult>(queryStr, params);
-        return await (<any>query.onPostProcess(this, <any>results));
+        
+        let out: TQueryResult = null;
+        let e: unknown = null;
+        try {
+            let results: TQueryResult = await this._query<TQueryResult>(queryStr, params);
+            out = await (<any>query.onPostProcess(this, <any>results));
+        }
+        catch (ex) {
+            e = ex;
+        }
+        
+        await query.onPostQuery(this);
+
+        if (e !== null) {
+            throw e;
+        }
+
+        return out;
     }
 
     /**

package/src/IQueryable.ts

@@ -18,6 +18,7 @@ import { IDatabaseConnection } from './IDatabaseConnection';
 
 export interface IQueryable<T> {
     onPreQuery(connection: IDatabaseConnection): Promise<void>;
+    onPostQuery(connection: IDatabaseConnection): Promise<void>;
     getQuery(connection: IDatabaseConnection): string;
     execute(connection: IDatabaseConnection): Promise<T>;
     getParametersForQuery(): Record<string, any>;

package/src/Query.ts

@@ -57,6 +57,22 @@ export abstract class Query<TQueryParameters = any, TQueryResultSet = any, TQuer
         return Promise.resolve();
     }
 
+    /**
+     * Overridable to execute statements after the main query.
+     * Can be used to clean up session variables or temporary tables, etc
+     * 
+     * Unlike {@link onPostProcess}, this hook does not provide the result set,
+     * and will be invoked even if the main query produces an error.
+     * 
+     * @since 8.3.0
+     * 
+     * @param connection 
+     * @returns {void}
+     */
+    public onPostQuery(connection: IDatabaseConnection): Promise<void> {
+        return Promise.resolve();
+    }
+
     /**
      * Override to augment/manipulate the returned result set.
      * 

package/src/Transaction.ts

@@ -60,6 +60,7 @@ export class Transaction implements IQueryable<void> {
     }
     
     public async onPreQuery(connection: IDatabaseConnection): Promise<void> {}
+    public async onPostQuery(connection: IDatabaseConnection): Promise<void> {}
 
     public getQuery(connection: IDatabaseConnection): string {
         return null;