@nsshunt/stsappframework 3.1.110 → 3.1.112

package/dist/index.js

@@ -41,4 +41,5 @@ __exportStar(require("./stsTransportLoggerWinston"), exports);
 __exportStar(require("./ipcMessageProcessorPrimary"), exports);
 __exportStar(require("./ipcMessageProcessorWorker"), exports);
 __exportStar(require("./ipcMessageManager"), exports);
+__exportStar(require("./testHelpers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA6B;AAC7B,mDAAgC;AAChC,6CAA0B;AAC1B,kDAA+B;AAC/B,kDAA+B;AAC/B,sDAAmC;AACnC,sDAAmC;AACnC,sDAAmC;AACnC,sDAAmC;AACnC,yDAAsC;AACtC,yDAAsC;AACtC,oDAAiC;AACjC,uDAAoC;AACpC,wDAAqC;AACrC,wDAAqC;AACrC,yDAAsC;AACtC,6DAA0C;AAC1C,iEAA8C;AAC9C,oEAAiD;AACjD,kEAA+C;AAC/C,mEAAgD;AAChD,8EAA2D;AAC3D,wDAAqC;AACrC,8DAA2C;AAC3C,+DAA4C;AAC5C,8DAA2C;AAC3C,sDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA6B;AAC7B,mDAAgC;AAChC,6CAA0B;AAC1B,kDAA+B;AAC/B,kDAA+B;AAC/B,sDAAmC;AACnC,sDAAmC;AACnC,sDAAmC;AACnC,sDAAmC;AACnC,yDAAsC;AACtC,yDAAsC;AACtC,oDAAiC;AACjC,uDAAoC;AACpC,wDAAqC;AACrC,wDAAqC;AACrC,yDAAsC;AACtC,6DAA0C;AAC1C,iEAA8C;AAC9C,oEAAiD;AACjD,kEAA+C;AAC/C,mEAAgD;AAChD,8EAA2D;AAC3D,wDAAqC;AACrC,8DAA2C;AAC3C,+DAA4C;AAC5C,8DAA2C;AAC3C,sDAAmC;AACnC,gDAA6B"}

package/dist/testHelpers.js

@@ -0,0 +1,285 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestHelper = void 0;
+/* eslint @typescript-eslint/no-explicit-any: 0 */ // --> OFF
+const chalk_1 = __importDefault(require("chalk"));
+const tough = __importStar(require("tough-cookie"));
+const https_1 = __importDefault(require("https"));
+const crypto_1 = __importDefault(require("crypto"));
+const axios_1 = __importDefault(require("axios"));
+const testcontainers_1 = require("testcontainers");
+const stsconfig_1 = require("@nsshunt/stsconfig");
+let goptions = (0, stsconfig_1.$Options)();
+const stsutils_1 = require("@nsshunt/stsutils");
+const authutilsnode_1 = require("./authutilsnode");
+class TestHelper {
+    //#regexBase64URL = /^[A-Za-z0-9_-]+$/ // Base64URL  - https://base64.guru/standards/base64url
+    #regexURLSafeStringComponent = /[-a-zA-Z0-9@:%._+~#=]{1,256}/; // URL safe string component
+    //#regexBase64 = /(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?/ // Base64 - https://stackoverflow.com/questions/475074/regex-to-parse-or-validate-base64-data
+    #regexSTSBase64 = /SES_(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?/; // Base64
+    #regexJWT = /[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+/; // JWT (Base64URL.Base64URL.Base64URL)
+    #authUtilsNode = new authutilsnode_1.AuthUtilsNode(stsutils_1.defaultLogger);
+    #databaseContainer;
+    #stsAuthContainer;
+    #network;
+    #authEndpoint = '';
+    #authPort = '';
+    #authHost = '';
+    #httpsAgent = null;
+    constructor() {
+        this.#authEndpoint = 'https://localhost:3002'; //@@
+    }
+    LogDebugMessage(message) {
+        stsutils_1.defaultLogger.debug(message);
+    }
+    #GetHttpsAgent = () => {
+        if (this.#httpsAgent === null) {
+            // https://nodejs.org/api/http.html#class-httpagent
+            this.#httpsAgent = new https_1.default.Agent({
+                keepAlive: goptions.keepAlive,
+                maxSockets: goptions.maxSockets,
+                maxTotalSockets: goptions.maxTotalSockets,
+                maxFreeSockets: goptions.maxFreeSockets,
+                timeout: goptions.timeout,
+                rejectUnauthorized: false
+            });
+        }
+        return this.#httpsAgent;
+    };
+    StartNetwork = async () => {
+        this.#network = await new testcontainers_1.Network().start();
+    };
+    StopNetwork = async () => {
+        await this.#network.stop();
+    };
+    get network() {
+        return this.#network;
+    }
+    get authPort() {
+        return this.#authPort;
+    }
+    get authHost() {
+        return this.#authHost;
+    }
+    get authEndpoint() {
+        return this.#authEndpoint;
+    }
+    get getHttpsAgent() {
+        return this.#GetHttpsAgent();
+    }
+    CreateRandomString = () => {
+        const charset = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_~.'; //    /[0-9A-Za-z\-_~.]/
+        let random = '';
+        const randomValues = Array.from(crypto_1.default.getRandomValues(new Uint8Array(43)));
+        randomValues.forEach(v => (random += charset[v % charset.length]));
+        return random;
+    };
+    Login = async (username, password) => {
+        const client_id = process.env.CLIENT_ID;
+        const nonce = crypto_1.default.randomBytes(43).toString('base64'); //CreateRandomString();
+        const response_type = 'code';
+        const redirect_uri = process.env.REDIRECT_URI;
+        const response_mode = 'query';
+        const scope = process.env.SCOPE;
+        const state = crypto_1.default.randomBytes(43).toString('base64'); // CreateRandomString();
+        const code_verifier = this.CreateRandomString();
+        const code_challenge = crypto_1.default.createHash('sha256').update(code_verifier).digest('base64');
+        const code_challenge_method = 'S256';
+        const authoriseOptions = {
+            email: username,
+            password,
+            client_id,
+            nonce,
+            response_type,
+            redirect_uri,
+            response_mode,
+            scope,
+            state,
+            code_challenge,
+            code_challenge_method
+        };
+        const url = `${this.#authEndpoint}${goptions.asapiroot}/login`;
+        const headers = { 'Content-Type': 'application/json' };
+        const retVal = await (0, axios_1.default)({
+            url,
+            method: 'post',
+            data: authoriseOptions,
+            headers: headers,
+            httpsAgent: this.#GetHttpsAgent()
+        });
+        //const cookieString = retVal.headers['set-cookie'];
+        /*
+        const api = request(this.#endpoint);
+        const retVal: any = await (api as any)
+            .post(`${goptions.asapiroot}/login`)
+            .send(authoriseOptions)
+        //.expect('set-cookie', /consent_cookie=.*; Max-Age=86; Path=\/; Expires=.*; HttpOnly; Secure; SameSite=Strict/);
+
+        const cookieString = retVal.header['set-cookie'];
+
+        if (cookieString) {
+            retVal.cookie = new Cookie(cookieString[0]);
+        }
+        */
+        return retVal;
+    };
+    /*
+    GetAuthServerAPITokenFromServer = async (): Promise<string> => {
+        return await this.#authUtilsNode.GetAPITokenFromAuthServer(STSClientID.STSTestingService,
+            "eN9u0mHZLGWZrdnE1zit2vL6xwUFW466sTZcbkXDml5KWxlvKaZ1uiOZmA==",
+            goptions.asapiidentifier, this.#authEndpoint)
+    }
+    */
+    ValidateJWT = async (token) => {
+        return await this.#authUtilsNode.ValidateJWT(token, goptions.asapiidentifier, this.#authEndpoint);
+    };
+    StartDatabase = async () => {
+        this.#databaseContainer = await new testcontainers_1.GenericContainer("postgres")
+            .withExposedPorts(5432)
+            .withEnvironment({
+            POSTGRES_PASSWORD: "postgres",
+            //UV_THREADPOOL_SIZE: "64"
+        })
+            .withNetwork(this.#network)
+            .withNetworkAliases("database")
+            .start();
+        const httpPort = this.#databaseContainer.getMappedPort(5432);
+        const host = this.#databaseContainer.getHost();
+        const networkIpAddress = this.#databaseContainer.getIpAddress(this.#network.getName());
+        process.env.DB_HOST = `${host}:${httpPort}`;
+        (0, stsconfig_1.$ResetOptions)();
+        goptions = (0, stsconfig_1.$Options)();
+        this.LogDebugMessage(chalk_1.default.green(`httpPort: [${httpPort}]`));
+        this.LogDebugMessage(chalk_1.default.green(`host: [${host}]`));
+        this.LogDebugMessage(chalk_1.default.green(`networkIpAddress: [${networkIpAddress}]`));
+        this.LogDebugMessage(chalk_1.default.green(`connectionString: [${goptions.connectionString}]`));
+        this.LogDebugMessage(chalk_1.default.green(`defaultDatabaseConnectionString: [${goptions.defaultDatabaseConnectionString}]`));
+    };
+    StopDatabase = async () => {
+        if (this.#databaseContainer) {
+            await this.#databaseContainer.stop();
+            this.LogDebugMessage(chalk_1.default.yellow(`Used the following parameters for the database during testing:`));
+            this.LogDebugMessage(chalk_1.default.yellow(`connectionString: [${goptions.connectionString}]`));
+            this.LogDebugMessage(chalk_1.default.yellow(`defaultDatabaseConnectionString: [${goptions.defaultDatabaseConnectionString}]`));
+        }
+    };
+    // Note: .withCopyFilesToContainer and .withCopyContentToContainer have a defect in that Jest will not close. A file handle/stream is left open
+    // within the underlying code.
+    InitializeDatabase = async () => {
+        const stsAuthContainerInit = await new testcontainers_1.GenericContainer("serza/stsauth:latest")
+            .withEnvironment({
+            DB_USER: "postgres",
+            DB_PASSWORD: "postgres",
+            DB_HOST: "database:5432", // "192.168.14.101",
+            POOL_SIZE: "50",
+            MAX_CPU: "2",
+            DEBUG: "proc*",
+            HTTPS_SERVER_KEY_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.key",
+            HTTPS_SERVER_CERT_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.cert",
+            AS_ENDPOINT: "https://stscore.stsmda.org"
+        })
+            .withCommand(["node", "dist/app", "create"])
+            .withNetwork(this.#network)
+            .withNetworkAliases("stsauthrunnerinit")
+            .withWaitStrategy(testcontainers_1.Wait.forLogMessage(`User registered: {"status":200,"detail":{"id":"USR_STSGlobalAdminUser@stsmda.com","name":"STSGlobalAdminUser@stsmda.com","email":"STSGlobalAdminUser@stsmda.com","roles":[]}}`))
+            .start();
+        await (0, stsutils_1.Sleep)(500);
+        await stsAuthContainerInit.stop();
+    };
+    StartAuthService = async () => {
+        this.#stsAuthContainer = await new testcontainers_1.GenericContainer("serza/stsauth:latest")
+            .withExposedPorts(3002)
+            .withEnvironment({
+            DB_USER: "postgres",
+            DB_PASSWORD: "postgres",
+            DB_HOST: "database:5432",
+            POOL_SIZE: "50",
+            MAX_CPU: "2",
+            DEBUG: "proc*",
+            HTTPS_SERVER_KEY_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.key",
+            HTTPS_SERVER_CERT_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.cert",
+            AS_ENDPOINT: "https://stscore.stsmda.org"
+        })
+            .withNetwork(this.#network)
+            .withNetworkAliases("stsauthrunner")
+            .withWaitStrategy(testcontainers_1.Wait.forHttp("/stsauth/v1.0/latency", 3002).usingTls().allowInsecure())
+            .start();
+        const httpAuthPort = this.#stsAuthContainer.getMappedPort(3002);
+        await (0, stsutils_1.Sleep)(200);
+        this.LogDebugMessage(chalk_1.default.green(`-------------------------------------------------------------------------------------------`));
+        this.LogDebugMessage(chalk_1.default.green(`                                 *** STSAuth Started ***: [${httpAuthPort}]`));
+        this.LogDebugMessage(chalk_1.default.green(`-------------------------------------------------------------------------------------------`));
+        this.#authHost = 'https://localhost';
+        this.#authPort = httpAuthPort;
+        this.#authEndpoint = `${this.#authHost}:${this.#authPort}`;
+    };
+    StopAuthService = async () => {
+        if (this.#stsAuthContainer) {
+            await this.#stsAuthContainer.stop();
+            await (0, stsutils_1.Sleep)(200);
+        }
+    };
+    TestLoginAndVerify = async () => {
+        expect.assertions(4);
+        const retVal = await this.Login('user01@stsmda.com.au', 'user01password');
+        expect(retVal.status).toEqual(200);
+        this.LogDebugMessage(chalk_1.default.red(`${JSON.stringify(retVal.data)}`));
+        this.LogDebugMessage(chalk_1.default.magenta(`${JSON.stringify(retVal.headers)}`));
+        this.LogDebugMessage(chalk_1.default.yellow(`${JSON.stringify(retVal.headers['set-cookie'])}`));
+        const cookies = retVal.headers['set-cookie'];
+        this.LogDebugMessage(chalk_1.default.yellow(`${cookies[0]}`));
+        this.LogDebugMessage(chalk_1.default.green(`${JSON.stringify(tough.Cookie.parse(cookies[0]))}`));
+        const cookie = tough.Cookie.parse(cookies[0]);
+        const desiredCookieResultAxios = {
+            key: 'consent_cookie',
+            value: expect.stringMatching(this.#regexURLSafeStringComponent),
+            path: '/',
+            secure: true,
+            httpOnly: true,
+            sameSite: 'strict',
+        };
+        const cookieResult = JSON.parse(JSON.stringify(cookie));
+        expect(cookieResult).toMatchObject(desiredCookieResultAxios);
+        const cookieExpireDate = new Date(cookie.expires);
+        expect(cookieExpireDate.getTime()).toBeGreaterThan(new Date().getTime());
+        const desiredResult = {
+            sessionId: expect.stringMatching(this.#regexSTSBase64),
+            id_token: expect.stringMatching(this.#regexJWT),
+            consentRequired: [
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.create',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.read',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.update',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.delete'
+            ]
+        };
+        expect(retVal.data.detail).toMatchObject(desiredResult);
+    };
+}
+exports.TestHelper = TestHelper;
+//# sourceMappingURL=testHelpers.js.map

package/dist/testHelpers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsshunt/stsappframework",
-  "version": "3.1.110",
+  "version": "3.1.112",
   "description": "",
   "main": "dist/index.js",
   "types": "./types/index.d.ts",
@@ -31,14 +31,17 @@
     "@types/cookie-parser": "^1.4.7",
     "@types/debug": "^4.1.12",
     "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.12",
     "@types/jsonwebtoken": "^9.0.6",
     "@types/uuid": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "^7.8.0",
     "@typescript-eslint/parser": "^7.8.0",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
+    "testcontainers": "^10.9.0",
     "typescript": "^5.4.5",
-    "vite": "^5.2.11"
+    "vite": "^5.2.11",
+    "vitest": "^1.6.0"
   },
   "dependencies": {
     "@grpc/grpc-js": "^1.10.7",
@@ -46,7 +49,7 @@
     "@influxdata/influxdb-client": "^1.33.2",
     "@influxdata/influxdb-client-apis": "^1.33.2",
     "@nsshunt/stsconfig": "^1.25.127",
-    "@nsshunt/stsdatamanagement": "^1.18.34",
+    "@nsshunt/stsdatamanagement": "^1.18.37",
     "@nsshunt/stsobservability": "^1.0.28",
     "@nsshunt/stsutils": "^1.16.59",
     "@socket.io/cluster-adapter": "^0.2.2",
@@ -77,7 +80,6 @@
     "tiny-emitter": "^2.1.0",
     "tough-cookie": "^4.1.4",
     "uuid": "^9.0.1",
-    "vitest": "^1.5.3",
     "winston": "^3.13.0"
   }
 }

package/src/index.ts

@@ -25,3 +25,4 @@ export * from './stsTransportLoggerWinston'
 export * from './ipcMessageProcessorPrimary'
 export * from './ipcMessageProcessorWorker'
 export * from './ipcMessageManager'
+export * from './testHelpers'

package/src/testHelpers.ts

@@ -0,0 +1,329 @@
+/* eslint @typescript-eslint/no-explicit-any: 0 */  // --> OFF
+import chalk from 'chalk'
+
+import * as tough from 'tough-cookie'
+
+import https from 'https'
+import crypto from 'crypto';
+
+import axios from 'axios';
+
+import { GenericContainer, Network, Wait } from "testcontainers";
+
+import { $Options, $ResetOptions } from '@nsshunt/stsconfig'
+let goptions = $Options()
+
+import { Sleep, defaultLogger } from '@nsshunt/stsutils'
+
+import { AuthUtilsNode } from './authutilsnode'
+
+export class TestHelper {
+    //#regexBase64URL = /^[A-Za-z0-9_-]+$/ // Base64URL  - https://base64.guru/standards/base64url
+    #regexURLSafeStringComponent = /[-a-zA-Z0-9@:%._+~#=]{1,256}/ // URL safe string component
+    //#regexBase64 = /(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?/ // Base64 - https://stackoverflow.com/questions/475074/regex-to-parse-or-validate-base64-data
+    #regexSTSBase64 = /SES_(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?/ // Base64
+    #regexJWT = /[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+/ // JWT (Base64URL.Base64URL.Base64URL)
+
+    #authUtilsNode = new AuthUtilsNode(defaultLogger);
+
+    #databaseContainer: any;
+    #stsAuthContainer: any;
+    #network: any;
+    #authEndpoint = '';
+    #authPort = '';
+    #authHost = '';
+    #httpsAgent: https.Agent | null = null;
+
+    constructor() {
+        this.#authEndpoint = 'https://localhost:3002'; //@@
+    }
+
+    LogDebugMessage(message: any) {
+        defaultLogger.debug(message);
+    }
+
+    #GetHttpsAgent = () =>
+    {
+        if (this.#httpsAgent === null) {
+            // https://nodejs.org/api/http.html#class-httpagent
+            this.#httpsAgent = new https.Agent({ 
+                keepAlive: goptions.keepAlive,
+                maxSockets: goptions.maxSockets,
+                maxTotalSockets: goptions.maxTotalSockets,
+                maxFreeSockets: goptions.maxFreeSockets,
+                timeout: goptions.timeout,
+                rejectUnauthorized: false
+            });
+        }
+        return this.#httpsAgent;
+    }
+
+    StartNetwork = async () => {
+        this.#network = await new Network().start();
+    }
+
+    StopNetwork = async () => {
+        await this.#network.stop();
+    }
+
+    get network() {
+        return this.#network;
+    }
+
+    get authPort() {
+        return this.#authPort;
+    }
+
+    get authHost() {
+        return this.#authHost;
+    }
+
+    get authEndpoint() {
+        return this.#authEndpoint;
+    }
+
+    get getHttpsAgent() {
+        return this.#GetHttpsAgent();
+    }
+
+    CreateRandomString = () => {
+        const charset = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz-_~.'; //    /[0-9A-Za-z\-_~.]/
+        let random = '';
+        const randomValues: number[] = Array.from(crypto.getRandomValues(new Uint8Array(43)));
+        randomValues.forEach(v => (random += charset[v % charset.length]));
+        return random;
+    }
+
+    Login = async (username: string, password: string) => {
+        const client_id = process.env.CLIENT_ID as string;
+        const nonce = crypto.randomBytes(43).toString('base64'); //CreateRandomString();
+        const response_type = 'code';
+        const redirect_uri = process.env.REDIRECT_URI as string;
+        const response_mode = 'query';
+        const scope = process.env.SCOPE as string;
+        const state = crypto.randomBytes(43).toString('base64'); // CreateRandomString();
+        const code_verifier = this.CreateRandomString();
+        const code_challenge = crypto.createHash('sha256').update(code_verifier).digest('base64');
+        const code_challenge_method = 'S256';
+
+        const authoriseOptions: any = {
+            email: username,
+            password,
+            client_id,
+            nonce,
+            response_type,
+            redirect_uri,
+            response_mode,
+            scope,
+            state,
+            code_challenge,
+            code_challenge_method
+        }
+
+        const url = `${this.#authEndpoint}${goptions.asapiroot}/login`;
+        const headers = { 'Content-Type': 'application/json'};
+
+        const retVal = await axios({
+            url
+            ,method: 'post'
+            ,data: authoriseOptions
+            ,headers: headers
+            ,httpsAgent: this.#GetHttpsAgent()
+        });
+
+        //const cookieString = retVal.headers['set-cookie'];
+
+        /*
+        const api = request(this.#endpoint);
+        const retVal: any = await (api as any)
+            .post(`${goptions.asapiroot}/login`)
+            .send(authoriseOptions)
+        //.expect('set-cookie', /consent_cookie=.*; Max-Age=86; Path=\/; Expires=.*; HttpOnly; Secure; SameSite=Strict/);
+
+        const cookieString = retVal.header['set-cookie'];
+
+        if (cookieString) {
+            retVal.cookie = new Cookie(cookieString[0]);
+        }
+        */
+
+        return retVal;
+    }
+
+    /*
+    GetAuthServerAPITokenFromServer = async (): Promise<string> => {
+        return await this.#authUtilsNode.GetAPITokenFromAuthServer(STSClientID.STSTestingService, 
+            "eN9u0mHZLGWZrdnE1zit2vL6xwUFW466sTZcbkXDml5KWxlvKaZ1uiOZmA==", 
+            goptions.asapiidentifier, this.#authEndpoint)
+    }
+    */
+
+    ValidateJWT = async (token: string): Promise<string> => {
+        return await this.#authUtilsNode.ValidateJWT(token, goptions.asapiidentifier, this.#authEndpoint);
+    }
+
+    StartDatabase = async () => {
+        this.#databaseContainer = await new GenericContainer("postgres")
+            .withExposedPorts(5432)
+            .withEnvironment({
+                POSTGRES_PASSWORD: "postgres",
+                //UV_THREADPOOL_SIZE: "64"
+            })
+            .withNetwork(this.#network)
+            .withNetworkAliases("database")
+            .start();
+
+        const httpPort = this.#databaseContainer.getMappedPort(5432);
+        const host = this.#databaseContainer.getHost();
+        const networkIpAddress = this.#databaseContainer.getIpAddress(this.#network.getName());
+        
+        process.env.DB_HOST = `${host}:${httpPort}`;
+
+        $ResetOptions();
+        goptions = $Options()
+
+        this.LogDebugMessage(chalk.green(`httpPort: [${httpPort}]`));
+        this.LogDebugMessage(chalk.green(`host: [${host}]`));
+        this.LogDebugMessage(chalk.green(`networkIpAddress: [${networkIpAddress}]`));
+        this.LogDebugMessage(chalk.green(`connectionString: [${goptions.connectionString}]`));
+        this.LogDebugMessage(chalk.green(`defaultDatabaseConnectionString: [${goptions.defaultDatabaseConnectionString }]`));
+    }
+
+    StopDatabase = async () => {
+        if (this.#databaseContainer) {
+            await this.#databaseContainer.stop();
+
+            this.LogDebugMessage(chalk.yellow(`Used the following parameters for the database during testing:`));
+            this.LogDebugMessage(chalk.yellow(`connectionString: [${goptions.connectionString}]`));
+            this.LogDebugMessage(chalk.yellow(`defaultDatabaseConnectionString: [${goptions.defaultDatabaseConnectionString }]`));
+        }
+    }
+
+    // Note: .withCopyFilesToContainer and .withCopyContentToContainer have a defect in that Jest will not close. A file handle/stream is left open
+    // within the underlying code.
+    InitializeDatabase = async () => {
+        const stsAuthContainerInit = await new GenericContainer("serza/stsauth:latest")
+            .withEnvironment({
+                DB_USER: "postgres",
+                DB_PASSWORD: "postgres",
+                DB_HOST: "database:5432", // "192.168.14.101",
+                POOL_SIZE: "50",
+                MAX_CPU: "2",
+                DEBUG: "proc*",
+                HTTPS_SERVER_KEY_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.key",
+                HTTPS_SERVER_CERT_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.cert",
+                AS_ENDPOINT: "https://stscore.stsmda.org"
+            })
+            .withCommand(["node", "dist/app", "create"])
+            .withNetwork(this.#network)
+            .withNetworkAliases("stsauthrunnerinit")
+            .withWaitStrategy(Wait.forLogMessage(`User registered: {"status":200,"detail":{"id":"USR_STSGlobalAdminUser@stsmda.com","name":"STSGlobalAdminUser@stsmda.com","email":"STSGlobalAdminUser@stsmda.com","roles":[]}}`))
+            .start();
+
+        await Sleep(500);
+
+        await stsAuthContainerInit.stop();
+    }
+
+    StartAuthService = async () => {
+        this.#stsAuthContainer = await new GenericContainer("serza/stsauth:latest")
+            .withExposedPorts(3002)
+            .withEnvironment({
+                DB_USER: "postgres",
+                DB_PASSWORD: "postgres",
+                DB_HOST: "database:5432", 
+                POOL_SIZE: "50",
+                MAX_CPU: "2",
+                DEBUG: "proc*",
+                HTTPS_SERVER_KEY_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.key",
+                HTTPS_SERVER_CERT_PATH: "/var/lib/sts/stsglobalresources/keys-tmp/server.cert",
+                AS_ENDPOINT: "https://stscore.stsmda.org"
+            })
+            .withNetwork(this.#network)
+            .withNetworkAliases("stsauthrunner")
+            .withWaitStrategy(Wait.forHttp("/stsauth/v1.0/latency", 3002).usingTls().allowInsecure())
+            .start();
+
+        const httpAuthPort = this.#stsAuthContainer.getMappedPort(3002);
+
+        await Sleep(200);
+        this.LogDebugMessage(chalk.green(`-------------------------------------------------------------------------------------------`));
+        this.LogDebugMessage(chalk.green(`                                 *** STSAuth Started ***: [${httpAuthPort}]`));
+        this.LogDebugMessage(chalk.green(`-------------------------------------------------------------------------------------------`));
+
+        this.#authHost = 'https://localhost'
+        this.#authPort = httpAuthPort;
+        this.#authEndpoint = `${this.#authHost}:${this.#authPort}`;
+    }
+
+    StopAuthService = async () => {
+        if (this.#stsAuthContainer) {
+            await this.#stsAuthContainer.stop();
+            await Sleep(200);
+        }
+    }
+
+    TestLoginAndVerify = async () => {
+        expect.assertions(4);
+
+        const retVal = await this.Login('user01@stsmda.com.au', 'user01password');
+        expect(retVal.status).toEqual(200);
+
+        this.LogDebugMessage(chalk.red(`${JSON.stringify(retVal.data)}`));
+        this.LogDebugMessage(chalk.magenta(`${JSON.stringify(retVal.headers)}`));
+        this.LogDebugMessage(chalk.yellow(`${JSON.stringify(retVal.headers['set-cookie'])}`));
+
+        const cookies = retVal.headers['set-cookie'] as string[];
+        this.LogDebugMessage(chalk.yellow(`${cookies[0]}`));
+        this.LogDebugMessage(chalk.green(`${JSON.stringify(tough.Cookie.parse(cookies[0]))}`));
+
+        const cookie = tough.Cookie.parse(cookies[0]) as tough.Cookie;
+
+        const desiredCookieResultAxios = {
+            key: 'consent_cookie',
+            value: expect.stringMatching(this.#regexURLSafeStringComponent),
+            path: '/',
+            secure: true,
+            httpOnly: true,
+            sameSite: 'strict',
+        }
+
+        const cookieResult = JSON.parse(JSON.stringify(cookie));
+        expect(cookieResult).toMatchObject(desiredCookieResultAxios);
+
+        const cookieExpireDate = new Date(cookie.expires);
+        expect(cookieExpireDate.getTime()).toBeGreaterThan(new Date().getTime());
+
+        const desiredResult = {
+            sessionId: expect.stringMatching(this.#regexSTSBase64),
+            id_token: expect.stringMatching(this.#regexJWT),
+            consentRequired: [
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.create',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.read',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.update',
+                'api://d8277fce-bb48-44c2-bbf1-257fe13a444b/res01.delete'
+            ]
+        }
+        expect(retVal.data.detail).toMatchObject(desiredResult);
+    }
+
+    /*
+    TestValidateJWT = async () => {
+        expect.assertions(1);
+
+        const access_token = await this.GetAuthServerAPITokenFromServer();
+        this.LogDebugMessage(chalk.green(`access_token: [${access_token}]`));
+
+        const retVal = await this.ValidateJWT(access_token);
+        // https://jestjs.io/docs/expect#tomatchobjectobject
+        const desiredJWT = {
+            scope: 'offline_access session.read session.update',
+            iss: 'https://stsmda.com.au/stsauth/',
+            aud: 'https://stsmda.com.au/stsauthapi/v1.0/',
+            sub: 'session'
+        };
+
+        expect(retVal).toMatchObject(desiredJWT);
+    }
+    */
+}

package/types/index.d.ts

@@ -25,4 +25,5 @@ export * from './stsTransportLoggerWinston';
 export * from './ipcMessageProcessorPrimary';
 export * from './ipcMessageProcessorWorker';
 export * from './ipcMessageManager';
+export * from './testHelpers';
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,6CAA6C,CAAA;AAC3D,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/types/testHelpers.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import https from 'https';
+export declare class TestHelper {
+    #private;
+    constructor();
+    LogDebugMessage(message: any): void;
+    StartNetwork: () => Promise<void>;
+    StopNetwork: () => Promise<void>;
+    get network(): any;
+    get authPort(): string;
+    get authHost(): string;
+    get authEndpoint(): string;
+    get getHttpsAgent(): https.Agent;
+    CreateRandomString: () => string;
+    Login: (username: string, password: string) => Promise<import("axios").AxiosResponse<any, any>>;
+    ValidateJWT: (token: string) => Promise<string>;
+    StartDatabase: () => Promise<void>;
+    StopDatabase: () => Promise<void>;
+    InitializeDatabase: () => Promise<void>;
+    StartAuthService: () => Promise<void>;
+    StopAuthService: () => Promise<void>;
+    TestLoginAndVerify: () => Promise<void>;
+}
+//# sourceMappingURL=testHelpers.d.ts.map

package/types/testHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHelpers.d.ts","sourceRoot":"","sources":["../src/testHelpers.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,qBAAa,UAAU;;;IAqBnB,eAAe,CAAC,OAAO,EAAE,GAAG;IAoB5B,YAAY,sBAEX;IAED,WAAW,sBAEV;IAED,IAAI,OAAO,QAEV;IAED,IAAI,QAAQ,WAEX;IAED,IAAI,QAAQ,WAEX;IAED,IAAI,YAAY,WAEf;IAED,IAAI,aAAa,gBAEhB;IAED,kBAAkB,eAMjB;IAED,KAAK,aAAoB,MAAM,YAAY,MAAM,sDAsDhD;IAUD,WAAW,UAAiB,MAAM,KAAG,QAAQ,MAAM,CAAC,CAEnD;IAED,aAAa,sBAyBZ;IAED,YAAY,sBAQX;IAID,kBAAkB,sBAsBjB;IAED,gBAAgB,sBA6Bf;IAED,eAAe,sBAKd;IAED,kBAAkB,sBA0CjB;CAqBJ"}