@futdevpro/fsm-dynamo 1.16.38 → 1.16.40

package/build/_modules/crypto/_services/artifact-signature.control-service.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_ArtifactSignature_ControlService = void 0;
+const dyfm_base64UrlAlphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+const dyfm_checksumPattern = /^[a-f0-9]{64}$/u;
+const dyfm_keyIdPattern = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,119}$/u;
+const dyfm_signatureEvidenceKeys = [
+    'algorithm',
+    'contractVersion',
+    'encoding',
+    'hash',
+    'keyId',
+    'namedCurve',
+    'publicKeyFingerprint',
+    'signature',
+    'signedAt',
+    'subjectChecksum',
+];
+/** Cross-runtime ECDSA artifact signing and verification using the platform Web Crypto implementation. */
+class DyFM_ArtifactSignature_ControlService {
+    /** Signs exact bytes with server-only PKCS#8 material and verifies the configured public/private pair. */
+    async sign(set) {
+        this.validateSubject(set.subjectBytes);
+        this.validateChecksum(set.subjectChecksum, 'SUBJECT_CHECKSUM_INVALID');
+        this.validateKeyId(set.keyId);
+        this.validateTimestamp(set.signedAt);
+        const subtle = this.getSubtleCrypto();
+        const subjectBytes = new Uint8Array(set.subjectBytes);
+        const actualChecksum = await this.checksum(subjectBytes);
+        if (actualChecksum !== set.subjectChecksum) {
+            throw this.buildError('SUBJECT_CHECKSUM_MISMATCH');
+        }
+        const privateKeyBytes = this.decodeBase64UrlStrict(set.privateKeyPkcs8Base64Url);
+        if (privateKeyBytes.byteLength < 64 || privateKeyBytes.byteLength > 512) {
+            throw this.buildError('PRIVATE_KEY_LENGTH_INVALID');
+        }
+        const publicKeyJwk = this.validatePublicJwk(set.publicKeyJwk);
+        const publicKeyFingerprint = await this.getPublicKeyFingerprint(publicKeyJwk);
+        let privateKey;
+        let publicKey;
+        try {
+            privateKey = await subtle.importKey('pkcs8', privateKeyBytes, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign']);
+            publicKey = await subtle.importKey('jwk', publicKeyJwk, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['verify']);
+        }
+        catch {
+            throw this.buildError('KEY_IMPORT_FAILED');
+        }
+        finally {
+            privateKeyBytes.fill(0);
+        }
+        let signatureBytes;
+        try {
+            signatureBytes = new Uint8Array(await subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, privateKey, subjectBytes));
+        }
+        catch {
+            throw this.buildError('SIGN_FAILED');
+        }
+        if (signatureBytes.byteLength !== 64) {
+            throw this.buildError('SIGNATURE_ENCODING_INVALID');
+        }
+        const isPairValid = await subtle.verify({ name: 'ECDSA', hash: 'SHA-256' }, publicKey, signatureBytes, subjectBytes);
+        if (!isPairValid) {
+            throw this.buildError('KEY_PAIR_MISMATCH');
+        }
+        return Object.freeze({
+            contractVersion: 'dyfm-artifact-signature/1',
+            subjectChecksum: actualChecksum,
+            algorithm: 'ECDSA',
+            namedCurve: 'P-256',
+            hash: 'SHA-256',
+            encoding: 'ieee-p1363',
+            keyId: set.keyId,
+            publicKeyFingerprint: publicKeyFingerprint,
+            signedAt: set.signedAt,
+            signature: this.encodeBase64Url(signatureBytes),
+        });
+    }
+    /** Verifies exact bytes and content-free evidence with an allowlisted public JWK. */
+    async verify(set) {
+        const evidenceCode = this.getEvidenceValidationCode(set.evidence);
+        if (evidenceCode) {
+            return this.result(set.evidence, false, evidenceCode);
+        }
+        if (!(set.subjectBytes instanceof Uint8Array) || !set.subjectBytes.byteLength) {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|SUBJECT_INVALID');
+        }
+        const subjectBytes = new Uint8Array(set.subjectBytes);
+        const actualChecksum = await this.checksum(subjectBytes);
+        if (actualChecksum !== set.evidence.subjectChecksum) {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|SUBJECT_CHECKSUM_MISMATCH');
+        }
+        let publicKeyJwk;
+        let signatureBytes;
+        try {
+            publicKeyJwk = this.validatePublicJwk(set.publicKeyJwk);
+            signatureBytes = this.decodeBase64UrlStrict(set.evidence.signature);
+        }
+        catch {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|PUBLIC_INPUT_INVALID');
+        }
+        if (signatureBytes.byteLength !== 64) {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|SIGNATURE_ENCODING_INVALID');
+        }
+        const publicKeyFingerprint = await this.getPublicKeyFingerprint(publicKeyJwk);
+        if (publicKeyFingerprint !== set.evidence.publicKeyFingerprint) {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|PUBLIC_KEY_FINGERPRINT_MISMATCH');
+        }
+        try {
+            const publicKey = await this.getSubtleCrypto().importKey('jwk', publicKeyJwk, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['verify']);
+            const isVerified = await this.getSubtleCrypto().verify({ name: 'ECDSA', hash: 'SHA-256' }, publicKey, signatureBytes, subjectBytes);
+            return this.result(set.evidence, isVerified, isVerified ? 'DYFM|ARTIFACT_SIGNATURE|VERIFIED' : 'DYFM|ARTIFACT_SIGNATURE|SIGNATURE_MISMATCH');
+        }
+        catch {
+            return this.result(set.evidence, false, 'DYFM|ARTIFACT_SIGNATURE|VERIFY_FAILED');
+        }
+    }
+    /** Calculates the canonical SHA-256 fingerprint of a public P-256 JWK. */
+    async getPublicKeyFingerprint(publicKeyJwkValue) {
+        const publicKeyJwk = this.validatePublicJwk(publicKeyJwkValue);
+        const canonicalJwk = JSON.stringify({
+            crv: publicKeyJwk.crv,
+            kty: publicKeyJwk.kty,
+            x: publicKeyJwk.x,
+            y: publicKeyJwk.y,
+        });
+        return this.checksum(new TextEncoder().encode(canonicalJwk));
+    }
+    async checksum(bytes) {
+        const digest = await this.getSubtleCrypto().digest('SHA-256', bytes);
+        return [...new Uint8Array(digest)]
+            .map((value) => value.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    decodeBase64UrlStrict(value) {
+        if (!value || !/^[A-Za-z0-9_-]+$/u.test(value) || value.length % 4 === 1) {
+            throw this.buildError('BASE64URL_INVALID');
+        }
+        const bytes = [];
+        for (let index = 0; index < value.length; index += 4) {
+            const first = dyfm_base64UrlAlphabet.indexOf(value[index]);
+            const second = dyfm_base64UrlAlphabet.indexOf(value[index + 1]);
+            const third = index + 2 < value.length
+                ? dyfm_base64UrlAlphabet.indexOf(value[index + 2])
+                : 0;
+            const fourth = index + 3 < value.length
+                ? dyfm_base64UrlAlphabet.indexOf(value[index + 3])
+                : 0;
+            const combined = (first << 18) | (second << 12) | (third << 6) | fourth;
+            bytes.push((combined >>> 16) & 255);
+            if (index + 2 < value.length) {
+                bytes.push((combined >>> 8) & 255);
+            }
+            if (index + 3 < value.length) {
+                bytes.push(combined & 255);
+            }
+        }
+        const decoded = new Uint8Array(bytes);
+        if (this.encodeBase64Url(decoded) !== value) {
+            throw this.buildError('BASE64URL_NON_CANONICAL');
+        }
+        return decoded;
+    }
+    encodeBase64Url(bytes) {
+        let encoded = '';
+        for (let index = 0; index < bytes.length; index += 3) {
+            const remaining = bytes.length - index;
+            const combined = (bytes[index] << 16)
+                | ((remaining > 1 ? bytes[index + 1] : 0) << 8)
+                | (remaining > 2 ? bytes[index + 2] : 0);
+            encoded += dyfm_base64UrlAlphabet[(combined >>> 18) & 63];
+            encoded += dyfm_base64UrlAlphabet[(combined >>> 12) & 63];
+            if (remaining > 1) {
+                encoded += dyfm_base64UrlAlphabet[(combined >>> 6) & 63];
+            }
+            if (remaining > 2) {
+                encoded += dyfm_base64UrlAlphabet[combined & 63];
+            }
+        }
+        return encoded;
+    }
+    getEvidenceValidationCode(evidence) {
+        if (!evidence || typeof evidence !== 'object') {
+            return 'DYFM|ARTIFACT_SIGNATURE|EVIDENCE_INVALID';
+        }
+        const keys = Object.keys(evidence).sort();
+        if (JSON.stringify(keys) !== JSON.stringify(dyfm_signatureEvidenceKeys)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|EVIDENCE_SHAPE_INVALID';
+        }
+        if (evidence.contractVersion !== 'dyfm-artifact-signature/1'
+            || evidence.algorithm !== 'ECDSA'
+            || evidence.namedCurve !== 'P-256'
+            || evidence.hash !== 'SHA-256'
+            || evidence.encoding !== 'ieee-p1363') {
+            return 'DYFM|ARTIFACT_SIGNATURE|EVIDENCE_CONTRACT_INVALID';
+        }
+        if (!dyfm_checksumPattern.test(evidence.subjectChecksum)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|SUBJECT_CHECKSUM_INVALID';
+        }
+        if (!dyfm_checksumPattern.test(evidence.publicKeyFingerprint)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|PUBLIC_KEY_FINGERPRINT_INVALID';
+        }
+        if (!dyfm_keyIdPattern.test(evidence.keyId)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|KEY_ID_INVALID';
+        }
+        if (!this.isCanonicalTimestamp(evidence.signedAt)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|SIGNED_AT_INVALID';
+        }
+        if (!/^[A-Za-z0-9_-]{86}$/u.test(evidence.signature)) {
+            return 'DYFM|ARTIFACT_SIGNATURE|SIGNATURE_ENCODING_INVALID';
+        }
+        return '';
+    }
+    getSubtleCrypto() {
+        if (!globalThis.crypto?.subtle) {
+            throw this.buildError('WEB_CRYPTO_UNAVAILABLE');
+        }
+        return globalThis.crypto.subtle;
+    }
+    isCanonicalTimestamp(value) {
+        const timestamp = Date.parse(value);
+        return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+    }
+    result(evidence, isVerified, code) {
+        return Object.freeze({
+            contractVersion: 'dyfm-artifact-signature-verification/1',
+            isVerified: isVerified,
+            code: code,
+            subjectChecksum: typeof evidence?.subjectChecksum === 'string' ? evidence.subjectChecksum : '',
+            keyId: typeof evidence?.keyId === 'string' ? evidence.keyId : '',
+        });
+    }
+    validateChecksum(value, code) {
+        if (!dyfm_checksumPattern.test(value)) {
+            throw this.buildError(code);
+        }
+    }
+    validateKeyId(value) {
+        if (!dyfm_keyIdPattern.test(value)) {
+            throw this.buildError('KEY_ID_INVALID');
+        }
+    }
+    validatePublicJwk(value) {
+        if (!value
+            || typeof value !== 'object'
+            || value.kty !== 'EC'
+            || value.crv !== 'P-256'
+            || typeof value.x !== 'string'
+            || typeof value.y !== 'string'
+            || Object.prototype.hasOwnProperty.call(value, 'd')) {
+            throw this.buildError('PUBLIC_KEY_INVALID');
+        }
+        const xBytes = this.decodeBase64UrlStrict(value.x);
+        const yBytes = this.decodeBase64UrlStrict(value.y);
+        if (xBytes.byteLength !== 32 || yBytes.byteLength !== 32) {
+            throw this.buildError('PUBLIC_KEY_COORDINATE_INVALID');
+        }
+        return Object.freeze({
+            kty: 'EC',
+            crv: 'P-256',
+            x: value.x,
+            y: value.y,
+            ext: true,
+            key_ops: ['verify'],
+        });
+    }
+    validateSubject(value) {
+        if (!(value instanceof Uint8Array) || !value.byteLength) {
+            throw this.buildError('SUBJECT_INVALID');
+        }
+    }
+    validateTimestamp(value) {
+        if (!this.isCanonicalTimestamp(value)) {
+            throw this.buildError('SIGNED_AT_INVALID');
+        }
+    }
+    buildError(code) {
+        return new TypeError(`DYFM|ARTIFACT_SIGNATURE|${code}`);
+    }
+}
+exports.DyFM_ArtifactSignature_ControlService = DyFM_ArtifactSignature_ControlService;
+//# sourceMappingURL=artifact-signature.control-service.js.map

package/build/_modules/crypto/_services/artifact-signature.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-signature.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/crypto/_services/artifact-signature.control-service.ts"],"names":[],"mappings":"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"}

package/build/_modules/crypto/index.d.ts

@@ -1,2 +1,4 @@
 export * from './_collections/crypto.util';
+export * from './_models/artifact-signature.interface';
+export * from './_services/artifact-signature.control-service';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/crypto/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":"AAaA,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":"AAaA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,gDAAgD,CAAC"}

package/build/_modules/crypto/index.js

@@ -10,4 +10,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./_collections/crypto.util"), exports);
+tslib_1.__exportStar(require("./_models/artifact-signature.interface"), exports);
+tslib_1.__exportStar(require("./_services/artifact-signature.control-service"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/crypto/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":";AAGA;;;;;;;IAOI;;;AAGJ,qEAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/crypto/index.ts"],"names":[],"mappings":";AAGA;;;;;;;IAOI;;;AAGJ,qEAA2C;AAC3C,iFAAuD;AACvD,yFAA+D"}

package/build/_modules/socket/_models/sck-socket-event.control-model.d.ts

@@ -1,6 +1,7 @@
 import { DyFM_SocketEvent_Key } from '../_enums/sck-event-key.enum';
 export type DyFM_SocketEventPreprocessTask<T = any, R = any> = (content?: T, issuer?: string) => Promise<R>;
-export type DyFM_SocketEventTask<T> = (content?: T, issuer?: string) => Promise<void>;
+/** Executes an event task with optional server-owned transport context. */
+export type DyFM_SocketEventTask<T> = (content?: T, issuer?: string, transportContext?: unknown) => Promise<void>;
 /**
  * Describes a socket.io event with pre-processing and task handling.
  *
@@ -64,10 +65,7 @@ export declare class DyFM_SocketEvent<T> {
      * @returns
      */
     private getPreLog;
-    /**
-     *
-     * @returns
-     */
-    executeEventTasks(content?: T, issuer?: string): Promise<void>;
+    /** Executes the ordered preprocessors and tasks for one received event. */
+    executeEventTasks(content?: T, issuer?: string, transportContext?: unknown): Promise<void>;
 }
 //# sourceMappingURL=sck-socket-event.control-model.d.ts.map

package/build/_modules/socket/_models/sck-socket-event.control-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sck-socket-event.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/socket/_models/sck-socket-event.control-model.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,8BAA8B,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IACzD,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/C,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,8BAA8B,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC1D,KAAK,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAElC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG9B,GAAG,EAAE;QACH;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;;WAGG;QACH,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;QACxC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,8BAA8B,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1D;;WAEG;QACH,KAAK,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;WAEG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAwCH;;;OAGG;YACW,SAAS;IAevB;;;OAGG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BrE"}
+{"version":3,"file":"sck-socket-event.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/socket/_models/sck-socket-event.control-model.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,MAAM,8BAA8B,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IACzD,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/C,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CACpC,OAAO,CAAC,EAAE,CAAC,EACX,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,OAAO,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,YAAY,CAAC,EAAE,8BAA8B,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC1D,KAAK,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAElC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG9B,GAAG,EAAE;QACH;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;;WAGG;QACH,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;QACxC;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,8BAA8B,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1D;;WAEG;QACH,KAAK,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;WAEG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAwCH;;;OAGG;YACW,SAAS;IAevB,2EAA2E;IACrE,iBAAiB,CACrB,OAAO,CAAC,EAAE,CAAC,EACX,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,IAAI,CAAC;CAoCjB"}

package/build/_modules/socket/_models/sck-socket-event.control-model.js

@@ -70,7 +70,7 @@ class DyFM_SocketEvent {
     async getPreLog(content) {
         try {
             if (this.logEventContent && this.eventKey !== sck_event_key_enum_1.DyFM_SocketEvent_Key.incomingNewConnection) {
-                log_util_1.DyFM_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
+                log_util_1.DyFM_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
           \ncontent:`, content);
             }
             else {
@@ -81,11 +81,8 @@ class DyFM_SocketEvent {
             log_util_1.DyFM_Log.error(`PreLog failed... (socket:  ${this.serviceName})`, error);
         }
     }
-    /**
-     *
-     * @returns
-     */
-    async executeEventTasks(content, issuer) {
+    /** Executes the ordered preprocessors and tasks for one received event. */
+    async executeEventTasks(content, issuer, transportContext) {
         try {
             if (this.logEvent || this.logEventContent) {
                 await this.getPreLog(content);
@@ -94,7 +91,12 @@ class DyFM_SocketEvent {
                 content = await preProcess(content);
             });
             await array_util_1.DyFM_Array.asyncForEach(this.tasks, async (task) => {
-                await task(content, issuer);
+                if (transportContext === undefined) {
+                    await task(content, issuer);
+                }
+                else {
+                    await task(content, issuer, transportContext);
+                }
             });
         }
         catch (error) {

package/build/_modules/socket/_models/sck-socket-event.control-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"sck-socket-event.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/socket/_models/sck-socket-event.control-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sck-socket-event.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/socket/_models/sck-socket-event.control-model.ts"],"names":[],"mappings":";;;AACA,iGAA6F;AAC7F,uEAAoE;AACpE,mEAAgE;AAChE,uEAA2F;AAC3F,6FAAiF;AAEjF,qEAAoE;AAWpE;;;;;;;;;;;;;GAaG;AACH,MAAa,gBAAgB;IAC3B,IAAI,CAAU;IACd,QAAQ,CAAgC;IACxC,WAAW,CAAU;IAErB,YAAY,CAA8C;IAC1D,KAAK,CAA6B;IAElC,QAAQ,CAAW;IACnB,eAAe,CAAW;IAEjB,aAAa,CAAU;IAEhC,YACE,GAkCC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;YACrC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC7B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC;YAE7D,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAE7B,IAAI,CAAC,aAAa,GAAG,IAAA,8CAAiC,GAAE,CAAC;YAEzD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC/B,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,yCAAoB,CAAC,SAAS,EAAE,CAAC;gBAC5D,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACxB,CAAC;iBAAM,IACJ;gBACC,yCAAoB,CAAC,qBAAqB;gBAC1C,yCAAoB,CAAC,qBAAqB;gBAC1C,yCAAoB,CAAC,UAAU;aACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACtC,CAAC;gBACD,IAAI,CAAC,QAAQ,GAAG,4CAAoB,CAAC,YAAY,CAAC,gBAAgB;oBAChE,4CAAoB,CAAC,YAAY,CAAC,iBAAiB,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,4CAAoB,CAAC,YAAY,CAAC,gBAAgB,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe;gBACxC,4CAAoB,CAAC,YAAY,CAAC,mBAAmB,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mBAAQ,CAAC,KAAK,CACZ,uCAAuC,IAAI,CAAC,WAAW,MAAM,GAAG,CAAC,QAAQ,EAAE,EAC3E,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,SAAS,CAAC,OAAU;QAChC,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,QAAQ,KAAK,yCAAoB,CAAC,qBAAqB,EAAE,CAAC;gBACzF,mBAAQ,CAAC,GAAG,CACV,0BAA0B,IAAI,CAAC,WAAW,YAAY,IAAI,CAAC,QAAQ;qBACxD,EAAE,OAAO,CACrB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,mBAAQ,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,WAAW,YAAY,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mBAAQ,CAAC,KAAK,CAAC,8BAA8B,IAAI,CAAC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,iBAAiB,CACrB,OAAW,EACX,MAAe,EACf,gBAA0B;QAE1B,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YAED,MAAM,uBAAU,CAAC,YAAY,CAC3B,IAAI,CAAC,YAAY,EACjB,KAAK,EAAE,UAAoD,EAAE,EAAE;gBAC7D,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CACF,CAAC;YAEF,MAAM,uBAAU,CAAC,YAAY,CAC3B,IAAI,CAAC,KAAK,EACV,KAAK,EAAE,IAA6B,EAAiB,EAAE;gBACrD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;oBACnC,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,gCAAU,EAAE,CAAC;gBAChC,KAAK,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,mBAAQ,CAAC,KAAK,CACZ,2CAA2C,IAAI,CAAC,WAAW,SAAS,IAAI,CAAC,QAAQ,GAAG,EACpF,KAAK,EACL,UAAU,EACV,OAAO,CACR,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF;AApJD,4CAoJC"}

package/eslint.config.js

@@ -1,4 +1,4 @@
-const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
-
-module.exports = ntsPackageConfig;
-
+const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
+
+module.exports = ntsPackageConfig;
+

package/nodemon.json

@@ -1,23 +1,23 @@
-{
-  "exec": "title Test Build of Dynamo-FSM && npm run nodemon-run",
-  "restartable": "rs",
-  "delay": "3000",
-  "ext": ".ts,json",
-  "verbose": false,
-  "legacyWatch": false,
-  "watch": [
-    "./src/*",
-    "package.json",
-    "tsconfig.json"
-  ],
-  "ignore": [
-    "./node_modules",
-    "./build"
-  ],
-  "events": {
-    "start": "echo 🚀 Starting nodemon...",
-    "restart": "echo 🔄 Restarting due to changes...",
-    "crash": "echo 💥 Application crashed!",
-    "exit": "echo 🛑 Application stopped!"
-  }
+{
+  "exec": "title Test Build of Dynamo-FSM && npm run nodemon-run",
+  "restartable": "rs",
+  "delay": "3000",
+  "ext": ".ts,json",
+  "verbose": false,
+  "legacyWatch": false,
+  "watch": [
+    "./src/*",
+    "package.json",
+    "tsconfig.json"
+  ],
+  "ignore": [
+    "./node_modules",
+    "./build"
+  ],
+  "events": {
+    "start": "echo 🚀 Starting nodemon...",
+    "restart": "echo 🔄 Restarting due to changes...",
+    "crash": "echo 💥 Application crashed!",
+    "exit": "echo 🛑 Application stopped!"
+  }
 }