@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

package/src/_modules/pipe/index.ts

@@ -1,30 +0,0 @@
-
-
-// COLLECTIONS
-export * from './_collections/pip-transforms.const';
-
-// collections/UTILS
-export * from './_collections/utils/pip-country-pipe.util';
-export * from './_collections/utils/pip-custom-pipe.util';
-export * from './_collections/utils/pip-division-pipe.util';
-export * from './_collections/utils/pip-json-pipe.util';
-export * from './_collections/utils/pip-list-pipe.util';
-export * from './_collections/utils/pip-multi-pipe-pipe.util';
-export * from './_collections/utils/pip-obj-key-pipe.util';
-export * from './_collections/utils/pip-obj-key-pipe.util';
-export * from './_collections/utils/pip-range-pipe.util';
-export * from './_collections/utils/pip-region-pipe.util';
-export * from './_collections/utils/pip-replace-pipe.util';
-export * from './_collections/utils/pip-slider-pipe.util';
-export * from './_collections/utils/pip-smart-replace-pipe.util';
-
-// ENUMS
-export * from './_enums/pip.enum';
-export * from './_enums/pip-range-pipe-setting.enum';
-
-// MODELS
-export * from './_models/pip-multi-pipe-settings.type';
-export * from './_models/pip-transforms.interface';
-
-
-

package/src/_modules/security/_collections/stored-secret.util.spec.ts

@@ -1,81 +0,0 @@
-import { DyFM_StoredSecret } from '../_models/stored-secret.control-model';
-import { DyFM_StoredSecret_Util } from './stored-secret.util';
-
-describe('| DyFM_StoredSecret_Util', () => {
-
-  // valid-formatumu teszt-kulcsok (a DyFM_SECRET_PATTERNS-hez igazitva)
-  const openAiKey: string = 'sk-abcdefghij1234567890abcdefghij1234567890';
-  const anthropicKey: string = 'sk-ant-abcdefghij1234567890abcdefghij1234567890';
-  const githubPat: string = 'ghp_abcdefghij1234567890abcdefghij1234567890';
-
-  describe('| detectKind', () => {
-    it('| OpenAI kulcsot felismer', () => {
-      expect(DyFM_StoredSecret_Util.detectKind(openAiKey)).toBe('openai-key');
-    });
-
-    it('| Anthropic kulcsot felismer (a sk-ant- specifikusabb mint a sk-)', () => {
-      expect(DyFM_StoredSecret_Util.detectKind(anthropicKey)).toBe('anthropic-key');
-    });
-
-    it('| GitHub PAT-ot felismer', () => {
-      expect(DyFM_StoredSecret_Util.detectKind(githubPat)).toBe('github-pat');
-    });
-
-    it('| ismeretlen formatumra undefined', () => {
-      expect(DyFM_StoredSecret_Util.detectKind('not-a-known-secret-format')).toBeUndefined();
-    });
-
-    it('| ures inputra undefined', () => {
-      expect(DyFM_StoredSecret_Util.detectKind('')).toBeUndefined();
-    });
-  });
-
-  describe('| derivePreview', () => {
-    it('| normal kulcsbol maskedPreview + keyLength + kind', () => {
-      const preview = DyFM_StoredSecret_Util.derivePreview(openAiKey);
-      expect(preview.maskedPreview).toBe('sk-a...7890');
-      expect(preview.keyLength).toBe(openAiKey.length);
-      expect(preview.kind).toBe('openai-key');
-      // a nyers kulcs SOHA nem jelenik meg teljes egeszeben a preview-ban
-      expect(preview.maskedPreview).not.toContain('abcdefghij');
-    });
-
-    it('| tul rovid secret -> opaque preview, de keyLength megvan', () => {
-      const preview = DyFM_StoredSecret_Util.derivePreview('short');
-      expect(preview.maskedPreview).toBe('...');
-      expect(preview.keyLength).toBe(5);
-    });
-
-    it('| 0/0 reveal -> opaque', () => {
-      const preview = DyFM_StoredSecret_Util.derivePreview(openAiKey, { prefix: 0, suffix: 0 });
-      expect(preview.maskedPreview).toBe('...');
-    });
-
-    it('| ures input -> opaque + keyLength 0', () => {
-      const preview = DyFM_StoredSecret_Util.derivePreview('');
-      expect(preview.maskedPreview).toBe('...');
-      expect(preview.keyLength).toBe(0);
-      expect(preview.kind).toBeUndefined();
-    });
-  });
-
-  describe('| build', () => {
-    it('| osszeallit egy DyFM_StoredSecret-et a masked-reszekkel + encryptedValue-val', () => {
-      const secret: DyFM_StoredSecret = DyFM_StoredSecret_Util.build({
-        rawSecret: anthropicKey,
-        encryptedValue: 'ENCRYPTED-BLOB-xyz',
-        label: 'Anthropic Prod',
-      });
-
-      expect(secret.label).toBe('Anthropic Prod');
-      expect(secret.kind).toBe('anthropic-key');
-      expect(secret.maskedPreview).toBe('sk-a...7890');
-      expect(secret.keyLength).toBe(anthropicKey.length);
-      expect(secret.encryptedValue).toBe('ENCRYPTED-BLOB-xyz');
-      expect(secret.isActive).toBe(true);
-      // a nyers kulcs NINCS eltarolva a modellben (csak az encryptedValue + a masked-resz)
-      expect(JSON.stringify(secret)).not.toContain('abcdefghij');
-    });
-  });
-
-});

package/src/_modules/security/_collections/stored-secret.util.ts

@@ -1,96 +0,0 @@
-import {
-  DyFM_SECRET_PATTERNS,
-  DyFM_SecretMask_PartialReveal_Interface,
-} from '../../../_collections/utils/secret-mask.util';
-import { DyFM_StoredSecret } from '../_models/stored-secret.control-model';
-
-/** A levezetett, decrypt-nelkul megjelenitheto resz (a DyFM_StoredSecret masked-mezoi). */
-export interface DyFM_StoredSecret_Preview_Interface {
-  maskedPreview: string;
-  keyLength: number;
-  kind: string | undefined;
-}
-
-/** Default reveal — az elso 4 + utolso 4 karakter (egysegben a secret-mask util default-javal). */
-const DEFAULT_REVEAL: DyFM_SecretMask_PartialReveal_Interface = { prefix: 4, suffix: 4 };
-
-/**
- * A DyFM_StoredSecret masked-reszenek levezetese egy USER-SAJAT nyers secret-bol — ENCRYPT/DECRYPT
- * NELKUL megjelenitheto azonosito-reszt allit elo (`<prefix>...<suffix>` + a detektalt `kind` +
- * a `keyLength`). A nyers ertek titkositasa NEM itt tortenik (a host/auth adja a kulcsot); ez a
- * util csak a lathato reszt szamolja, hogy a UI / a fogyasztok visszafejtes nelkul azonositsanak.
- */
-export class DyFM_StoredSecret_Util {
-
-  /**
-   * A secret fajtajanak detektalasa a kanonikus `DyFM_SECRET_PATTERNS`-szel (egysegesitett a
-   * masking-util kind-jeivel, pl. 'openai-key', 'anthropic-key', 'github-pat'). Az elso illeszkedo
-   * kind, vagy undefined ha egyik sem ismeri fel.
-   */
-  static detectKind(rawSecret: string): string | undefined {
-    if (!rawSecret) {
-      return undefined;
-    }
-    for (const pattern of DyFM_SECRET_PATTERNS) {
-      // a patternek global flag-esek (stateful lastIndex) — minden teszt elott nullazzuk
-      pattern.regex.lastIndex = 0;
-      if (pattern.regex.test(rawSecret)) {
-        pattern.regex.lastIndex = 0;
-        return pattern.kind;
-      }
-    }
-    return undefined;
-  }
-
-  /**
-   * A decrypt-nelkul megjelenitheto preview levezetese. Tul rovid secret-nel (vagy 0/0 reveal-nel)
-   * nem reveal-junk semmit (kulonben az egesz secret osszetapadhatna) — ilyenkor tisztan opaque
-   * `...` preview. A `keyLength` ettol fuggetlenul mindig a nyers hossz.
-   */
-  static derivePreview(
-    rawSecret: string,
-    reveal: DyFM_SecretMask_PartialReveal_Interface = DEFAULT_REVEAL,
-  ): DyFM_StoredSecret_Preview_Interface {
-    const kind: string | undefined = this.detectKind(rawSecret);
-    const keyLength: number = rawSecret ? rawSecret.length : 0;
-    const p: number = Math.max(0, reveal.prefix);
-    const s: number = Math.max(0, reveal.suffix);
-
-    if (!rawSecret || (p === 0 && s === 0) || rawSecret.length <= p + s + 4) {
-      return { maskedPreview: '...', keyLength: keyLength, kind: kind };
-    }
-
-    const head: string = rawSecret.slice(0, p);
-    const tail: string = rawSecret.slice(rawSecret.length - s);
-
-    return {
-      maskedPreview: `${head}...${tail}`,
-      keyLength: keyLength,
-      kind: kind,
-    };
-  }
-
-  /**
-   * Egy DyFM_StoredSecret osszeallitasa a USER-SAJAT nyers secret-bol — a masked-reszt levezeti,
-   * az `encryptedValue`-t a HIVO adja (a host/auth titkositja a `FDP_PRIVATE_API_KEY_CRYPT_KEY`-jel;
-   * a nyers ertek itt csak a preview-levezeteshez kell, NEM tarolodik el nyersen).
-   */
-  static build(set: {
-    rawSecret: string,
-    encryptedValue: string,
-    label?: string,
-    reveal?: DyFM_SecretMask_PartialReveal_Interface,
-  }): DyFM_StoredSecret {
-    const preview: DyFM_StoredSecret_Preview_Interface =
-      this.derivePreview(set.rawSecret, set.reveal ?? DEFAULT_REVEAL);
-
-    return new DyFM_StoredSecret({
-      label: set.label,
-      kind: preview.kind,
-      maskedPreview: preview.maskedPreview,
-      keyLength: preview.keyLength,
-      encryptedValue: set.encryptedValue,
-      isActive: true,
-    });
-  }
-}

package/src/_modules/security/_models/stored-secret.control-model.ts

@@ -1,55 +0,0 @@
-/**
- * Univerzalis tarolt-secret forma (bedrock SSOT) a USER-SAJAT private API-kulcsok / titkos
- * ertekek tarolasara — minden FDP-rendszer ugyanezt hasznalja, igy kozos eredetet kapnak
- * (auth per-user AI-kulcs, Organizer user-kulcs, jovobeli).
- *
- * FONTOS scope: ez a forma a USER altal megadott sajat kulcsokra valo (ezek titkositva
- * tarolodnak a `FDP_PRIVATE_API_KEY_CRYPT_KEY`-jel). Az FDP SAJAT rendszer-api-kulcsai NEM
- * ezen at mennek — azok env-var-ok (nem titkositott DB-tarolas).
- *
- * A lenyeg: a secret-bol tarolaskor levezetheto egy ENCRYPT/DECRYPT NELKUL megjelenitheto
- * azonosito-resz — egy `label` (a user altal beallithato nev) + egy `maskedPreview`
- * (`<prefix>...<suffix>`) + a `kind` (detektalt fajta) + a `keyLength`. Igy a UI / a fogyasztok
- * visszafejtes nelkul azonositjak MELYIK kulcs ez, anelkul hogy a nyers ertek valaha
- * kliensre / logba kerulne.
- *
- * Az `encryptedValue` a titkositott nyers secret — KIZAROLAG szerver-oldalon. A titkositas
- * kulcsa NEM ennek a bedrock-modellnek a felelossege (a host/auth adja a kulcsot a DyFM_Crypto-nak);
- * itt csak a mar titkositott string tarolodik. A masked-mezoket a `DyFM_StoredSecret_Util`
- * szamolja a nyers ertekbol.
- *
- * Embeddable control-model (NEM extends DyFM_Metadata) — provider-config-okba / kulcs-listakba agyazhato.
- */
-export class DyFM_StoredSecret {
-  /**
-   * A user altal BEALLITHATO megjelenitendo nev (settable feature; a host/UI allitja be, pl.
-   * "OpenAI Production"). Decrypt nelkul megjelenitheto; tisztan ember-baratti azonositas.
-   */
-  label?: string;
-
-  /** A secret detektalt fajtaja a masking-patternek alapjan (pl. 'openai-key', 'anthropic-key', 'github-pat'). */
-  kind?: string;
-
-  /** Decrypt NELKUL megjelenitheto elonezet: `<prefix>...<suffix>` (pl. `sk-a...7890`). */
-  maskedPreview?: string;
-
-  /** A nyers secret hossza karakterben — decrypt nelkul megjelenitheto / validalashoz hasznos. */
-  keyLength?: number;
-
-  /**
-   * A titkositott nyers secret — KIZAROLAG szerver-oldalon. SOHA nem kerul kliensre / logba.
-   * A titkositas kulcsa NEM ennek a bedrock-modellnek a felelossege (a host/auth adja); itt csak
-   * a mar titkositott string tarolodik.
-   */
-  encryptedValue?: string;
-
-  isActive?: boolean;
-  expiresAt?: Date;
-  lastUsedAt?: Date;
-
-  constructor(set?: DyFM_StoredSecret) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}

package/src/_modules/security/index.ts

@@ -1,9 +0,0 @@
-// security ("out + security alapok") modul — a titkos-ertek tarolas/maszkolas bedrock SSOT-ja.
-// Erre epit minden FDP-rendszer (auth per-user AI-kulcs, Organizer MCP-kulcs, rendszer-kulcsok):
-// kozos forma (DyFM_StoredSecret) + decrypt-nelkuli preview-derive + a meglevo secret-maszkolas.
-
-export * from './_models/stored-secret.control-model';
-export * from './_collections/stored-secret.util';
-
-// a mar letezo univerzalis secret-maszkolas (log/output-redaction) is innen elerheto, egy helyrol
-export * from '../../_collections/utils/secret-mask.util';

package/src/_modules/socket/_enums/sck-event-key.enum.ts

@@ -1,21 +0,0 @@
-
-/**
- * Names of socket.io events used by the framework.
- */
-export enum DyFM_SocketEvent_Key {
-  /** incoming connection in socket.io */
-  incomingNewConnection = 'connection',
-  /** outgoing connection in socket.io */
-  outgoingNewConnection = 'connect',
-
-  subscribe = 'subscribe',
-  subscriptionSuccessful = 'subscriptionSuccessful',
-  unsubscribe = 'unsubscribe',
-  unsubscribeSuccessful = 'unsubscribeSuccessful',
-  disconnect = 'disconnect',
-  
-  ping = 'ping',
-  event = 'event',
-  error = 'error',
-}
-

package/src/_modules/socket/_models/sck-client-params.control-model.spec.ts

@@ -1,67 +0,0 @@
-
-import { second } from '../../../_collections/constants/times.const';
-import { DyFM_SocketClient_Params } from './sck-client-params.control-model';
-
-describe('| DyFM_SocketClient_Params', () => {
-  xit('should assign provided values to the instance', () => {
-    const params: DyFM_SocketClient_Params = {
-      name: 'testName',
-      service: 'testService',
-      address: '127.0.0.1',
-      port: 8080,
-      reconnectDelay: second * 5,
-      reconnect: false,
-      socketOptions: { autoConnect: false }
-    };
-
-    const instance = new DyFM_SocketClient_Params(params);
-
-    expect(instance.name).toBe(params.name);
-    expect(instance.service).toBe(params.service);
-    expect(instance.address).toBe(params.address);
-    expect(instance.port).toBe(params.port);
-    expect(instance.reconnectDelay).toBe(params.reconnectDelay);
-    expect(instance.reconnect).toBe(params.reconnect);
-    expect(instance.socketOptions).toEqual(params.socketOptions);
-  });
-
-  it('| should set default values for reconnectDelay and reconnect', () => {
-    const params: DyFM_SocketClient_Params = {};
-
-    const instance = new DyFM_SocketClient_Params(params);
-
-    expect(instance.reconnectDelay).toBe(second * 30);
-    expect(instance.reconnect).toBe(true);
-  });
-
-  it('| should set reconnect to false if socketOptions.autoConnect is true', () => {
-    const params: DyFM_SocketClient_Params = {
-      socketOptions: { autoConnect: true }
-    };
-
-    const instance = new DyFM_SocketClient_Params(params);
-
-    expect(instance.reconnect).toBe(false);
-  });
-
-  it('| should set reconnect to false if socketOptions.reconnection is true', () => {
-    const params: DyFM_SocketClient_Params = {
-      socketOptions: { reconnection: true }
-    };
-
-    const instance = new DyFM_SocketClient_Params(params);
-
-    expect(instance.reconnect).toBe(false);
-  });
-
-  it('| should set reconnect to true if reconnectDelay is provided and socketOptions do not override', () => {
-    const params: DyFM_SocketClient_Params = {
-      reconnectDelay: second * 5,
-      socketOptions: { autoConnect: false, reconnection: false }
-    };
-
-    const instance = new DyFM_SocketClient_Params(params);
-
-    expect(instance.reconnect).toBe(true);
-  });
-});

package/src/_modules/socket/_models/sck-client-params.control-model.ts

@@ -1,50 +0,0 @@
-
-import * as SocketIOClient from 'socket.io-client';
-
-import { second } from '../../../_collections/constants/times.const';
-import { DyFM_Log } from '../../../_collections/utils/log.util';
-
-/**
- * Configuration parameters for a socket client.
- *
- * @example
- * ```ts
- * new DyFM_SocketClient_Params({
- *   name: 'demo',
- *   address: 'http://localhost',
- *   port: 3000
- * });
- * ```
- */
-export class DyFM_SocketClient_Params {
-  name?: string;
-  service?: string;
-  address?: string;
-  port?: number;
-  reconnectDelay?: number = second * 30;
-  reconnect?: boolean = true;
-  socketOptions?: Partial<SocketIOClient.ManagerOptions & SocketIOClient.SocketOptions>;
-
-  constructor(
-    set: DyFM_SocketClient_Params
-  ) {
-    Object.assign(this, set);
-
-    this.reconnect = !!this.reconnectDelay;
-
-    if (
-      this.socketOptions?.autoConnect || 
-      this.socketOptions?.reconnection ||
-      this.socketOptions?.reconnectionDelay
-    ) {
-      DyFM_Log.warn(
-        'autoConnect or reconnection is set to true in socketOptions, so reconnect is set to false',
-        '\nThis means that the reconnection will use the socket.io reconnection logic, ',
-        'not the Dynamo implementations.'
-      );
-      this.reconnect = false;
-    }
-  }
-}
-
-

package/src/_modules/socket/_models/sck-socket-event.control-model.spec.ts

@@ -1,89 +0,0 @@
-
-import { DyFM_global_settings } from '../../../_collections/constants/global-settings.const';
-import { DyFM_Log } from '../../../_collections/utils/log.util';
-import { DyFM_SocketEvent_Key } from '../_enums/sck-event-key.enum';
-import { DyFM_SocketEvent, DyFM_SocketEventPreprocessTask, DyFM_SocketEventTask } from './sck-socket-event.control-model';
-
-describe('| DyFM_SocketEvent', () => {
-  let socketEvent: DyFM_SocketEvent<any>;
-
-  beforeEach(() => {
-    socketEvent = new DyFM_SocketEvent({
-      eventKey: DyFM_SocketEvent_Key.outgoingNewConnection,
-      preProcesses: [],
-      tasks: [],
-    });
-  });
-
-  it('| should initialize with default values', () => {
-    expect(socketEvent.name).toBe(DyFM_SocketEvent_Key.outgoingNewConnection);
-    expect(socketEvent.serviceName).toBe('UnknownSocketService');
-    expect(socketEvent.preProcesses).toEqual([]);
-    expect(socketEvent.tasks).toEqual([]);
-    expect(socketEvent.logEvent).toBe(DyFM_global_settings.log_settings.socket_mainEvents);
-    expect(socketEvent.logEventContent).toBe(DyFM_global_settings.log_settings.socket_eventContent);
-  });
-
-  it('| should execute preProcesses and tasks', async () => {
-    const mockPreProcess: DyFM_SocketEventPreprocessTask<any, any> = jasmine.createSpy('preProcess').and.callFake(async (content) => content);
-    const mockTask: DyFM_SocketEventTask<any> = jasmine.createSpy('task').and.callFake(async () => {});
-
-    socketEvent.preProcesses = [mockPreProcess];
-    socketEvent.tasks = [mockTask];
-
-    await socketEvent.executeEventTasks('testContent', 'testIssuer');
-
-    expect(mockPreProcess).toHaveBeenCalledWith('testContent');
-    expect(mockTask).toHaveBeenCalledWith('testContent', 'testIssuer');
-  });
-
-  it('| should forward an optional transport context to event tasks', async (): Promise<void> => {
-    const transportContext: object = { connectionId: 'socket-1' };
-    const mockTask: DyFM_SocketEventTask<string> = jasmine
-      .createSpy('task')
-      .and.resolveTo();
-    const contextualEvent: DyFM_SocketEvent<string> = new DyFM_SocketEvent({
-      eventKey: 'contextual-event',
-      tasks: [ mockTask ],
-    });
-
-    await contextualEvent.executeEventTasks(
-      'testContent',
-      'testIssuer',
-      transportContext,
-    );
-
-    expect(mockTask).toHaveBeenCalledWith(
-      'testContent',
-      'testIssuer',
-      transportContext,
-    );
-  });
-
-  it('| should log event if logEvent is true', async () => {
-    spyOn(DyFM_Log, 'log');
-    socketEvent.logEvent = true;
-
-    await socketEvent.executeEventTasks('testContent', 'testIssuer');
-
-    expect(DyFM_Log.log).toHaveBeenCalled();
-  });
-
-  it('| should handle errors in executeEventTasks gracefully', async () => {
-    const mockTask: DyFM_SocketEventTask<any> = jasmine.createSpy('task').and.callFake(async () => {
-      throw new Error('Task Error');
-    });
-
-    socketEvent.tasks = [mockTask];
-    spyOn(DyFM_Log, 'error');
-
-    await socketEvent.executeEventTasks('testContent', 'testIssuer');
-
-    expect(DyFM_Log.error).toHaveBeenCalledWith(
-      `Socket Event tasks failed to execute on UnknownSocketService.... (${DyFM_SocketEvent_Key.outgoingNewConnection})`,
-      jasmine.any(Error),
-      'content:',
-      'testContent'
-    );
-  });
-});

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

@@ -1,185 +0,0 @@
-
-import { DyFM_global_settings } from '../../../_collections/constants/global-settings.const';
-import { DyFM_Array } from '../../../_collections/utils/array.util';
-import { DyFM_Log } from '../../../_collections/utils/log.util';
-import { DyFM_getConstructionStackLocation } from '../../../_collections/utils/stack.util';
-import { DyFM_Error } from '../../../_models/control-models/error.control-model';
-
-import { DyFM_SocketEvent_Key } from '../_enums/sck-event-key.enum';
-
-export type DyFM_SocketEventPreprocessTask<T = any, R = any> = 
-  (content?: T, issuer?: string) => Promise<R>;
-/** 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.
- *
- * Use this model to define how incoming socket events should be processed
- * and what actions should be executed once the data is prepared.
- *
- * @example
- * ```ts
- * const event = new DyFM_SocketEvent<string>({
- *   eventKey: DyFM_SocketEvent_Key.subscribe,
- *   tasks: [async msg => console.log(msg)]
- * });
- * ```
- */
-export class DyFM_SocketEvent<T>{
-  name?: string;
-  eventKey: DyFM_SocketEvent_Key | string;
-  serviceName?: string;
-  
-  preProcesses?: DyFM_SocketEventPreprocessTask<any, any>[];
-  tasks?: DyFM_SocketEventTask<T>[];
-
-  logEvent?: boolean;
-  logEventContent?: boolean;
-
-  readonly stackLocation?: string;
-
-  constructor(
-    set: {
-      /**
-       * naming the socket will help to follow eveFM on service,
-       * if not set, the eventKey will be used
-       */
-      name?: string,
-      /**
-       * define socket event type such as; 
-       * connection, connect, disconnect, message, error, or anything else
-       */
-      eventKey: DyFM_SocketEvent_Key | string,
-      /**
-       * serviceName is the name of the service that will be used for logging
-       */
-      serviceName?: string,
-      /**
-       * preProcesses are the functions the service needs to run before the actual function,
-       * these can be used for authentications, or translating data
-       * 
-       * the last function in the array should return the content in the type(T) of the socket<T>
-       */
-      preProcesses?: DyFM_SocketEventPreprocessTask<any, any>[],
-      /**
-       * tasks are the functions the service needs to run
-       */
-      tasks?: DyFM_SocketEventTask<T>[],
-      /**
-       * logEvent will create a log for the event triggered
-       */
-      logEvent?: boolean,
-      /**
-       * logEventContent will create a log for the event triggered with the content
-       */
-      logEventContent?: boolean,
-    }
-  ) {
-    try {
-      this.name = set.name ?? set.eventKey;
-      this.eventKey = set.eventKey;
-      this.serviceName = set.serviceName ?? 'UnknownSocketService';
-
-      this.preProcesses = set.preProcesses ?? [];
-      this.tasks = set.tasks ?? [];
-
-      this.stackLocation = DyFM_getConstructionStackLocation();
-
-      if (set.logEvent !== undefined) {
-        this.logEvent = set.logEvent;
-      } else if (this.eventKey === DyFM_SocketEvent_Key.subscribe) {
-        this.logEvent = false;
-      } else if (
-        ([ 
-          DyFM_SocketEvent_Key.incomingNewConnection, 
-          DyFM_SocketEvent_Key.outgoingNewConnection,
-          DyFM_SocketEvent_Key.disconnect,
-        ] as string[]).includes(this.eventKey)
-      ) {
-        this.logEvent = DyFM_global_settings.log_settings.socket_allEvents || 
-          DyFM_global_settings.log_settings.socket_mainEvents;
-      } else {
-        this.logEvent = DyFM_global_settings.log_settings.socket_allEvents;
-      }
-      this.logEventContent = set.logEventContent ??
-        DyFM_global_settings.log_settings.socket_eventContent;
-    } catch (error) {
-      DyFM_Log.error(
-        `\nSocket Event params setup failed (${this.serviceName}): ${set.eventKey}`, 
-        error
-      );
-
-      throw error;
-    }
-  }
-
-  /**
-   * 
-   * @returns 
-   */
-  private async getPreLog(content: T): Promise<void> {
-    try {
-      if (this.logEventContent && this.eventKey !== DyFM_SocketEvent_Key.incomingNewConnection) {
-        DyFM_Log.log(
-          `--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
-          \ncontent:`, content
-        );
-      } else {
-        DyFM_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey}...`);
-      }
-    } catch (error) {
-      DyFM_Log.error(`PreLog failed... (socket:  ${this.serviceName})`, error);
-    }
-  }
-
-  /** Executes the ordered preprocessors and tasks for one received event. */
-  async executeEventTasks(
-    content?: T,
-    issuer?: string,
-    transportContext?: unknown,
-  ): Promise<void> {
-    try {        
-      if (this.logEvent || this.logEventContent) {
-        await this.getPreLog(content);
-      }
-
-      await DyFM_Array.asyncForEach(
-        this.preProcesses, 
-        async (preProcess: DyFM_SocketEventPreprocessTask<any, any>) => {
-          content = await preProcess(content);
-        }
-      );
-
-      await DyFM_Array.asyncForEach(
-        this.tasks,
-        async (task: DyFM_SocketEventTask<T>): Promise<void> => {
-          if (transportContext === undefined) {
-            await task(content, issuer);
-          } else {
-            await task(content, issuer, transportContext);
-          }
-        },
-      );
-    } catch (error) {
-      if (error instanceof DyFM_Error) {
-        error.logShort('Socket Event tasks failed to execute');
-      } else {
-        DyFM_Log.error(
-          `Socket Event tasks failed to execute on ${this.serviceName}.... (${this.eventKey})`, 
-          error, 
-          'content:', 
-          content
-        );
-      }
-    }
-  }
-}
-
-
-
-