@futdevpro/fsm-dynamo 1.20.9 → 1.20.12

package/src/_modules/ai/_modules/open-ai/_models/oai-client-options.interface.ts

@@ -1,81 +0,0 @@
-
-
-
-export interface DyFM_OAI_ClientOptions {
-  /**
-   * Defaults to process.env['OPENAI_API_KEY'].
-   */
-  apiKey?: string;
-
-  /**
-   * Defaults to process.env['OPENAI_ORG_ID'].
-   */
-  organization?: string;
-
-  /**
-   * Defaults to process.env['OPENAI_PROJECT_ID'].
-   */
-  project?: string;
-
-  /**
-   * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
-   *
-   * Defaults to process.env['OPENAI_BASE_URL'].
-   */
-  baseURL?: string;
-
-  /**
-   * The maximum amount of time (in milliseconds) that the client should wait for a response
-   * from the server before timing out a single request.
-   *
-   * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
-   * much longer than this timeout before the promise succeeds or fails.
-   */
-  timeout?: number;
-
-  /**
-   * An HTTP agent used to manage HTTP(S) connections.
-   *
-   * If not provided, an agent will be constructed by default in the Node.js environment,
-   * otherwise no agent is used.
-   */
-  httpAgent?: any;
-
-  /**
-   * Specify a custom `fetch` function implementation.
-   *
-   * If not provided, we use `node-fetch` on Node.js and otherwise expect that `fetch` is
-   * defined globally.
-   */
-  fetch?: any;
-
-  /**
-   * The maximum number of times that the client will retry a request in case of a
-   * temporary failure, like a network error or a 5XX error from the server.
-   *
-   * @default 2
-   */
-  maxRetries?: number;
-
-  /**
-   * Default headers to include with every request to the API.
-   *
-   * These can be removed in individual requests by explicitly setting the
-   * header to `undefined` or `null` in request options.
-   */
-  defaultHeaders?: any;
-
-  /**
-   * Default query parameters to include with every request to the API.
-   *
-   * These can be removed in individual requests by explicitly setting the
-   * param to `undefined` in request options.
-   */
-  defaultQuery?: any;
-
-  /**
-   * By default, client-side use of this library is not allowed, as it risks exposing your secret API credentials to attackers.
-   * Only set this option to `true` if you understand the risks and have appropriate mitigations in place.
-   */
-  dangerouslyAllowBrowser?: boolean;
-}

package/src/_modules/ai/_modules/open-ai/_models/oai-embedding-info.interface.ts

@@ -1,13 +0,0 @@
-import { DyFM_DAI_EmbeddingInfo } from '../../document-ai/_models/dai-embedding-info.interface';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_OAI_EmbeddingModel, DyFM_OAI_Model } from '../_enums/oai-model.enum';
-import { DyFM_OAI_EmbeddingModelDimensions } from '../_collections/oai-embedding-model-dimensions.const';
-
-/**
- * OpenAI implementation of the generic embedding info
- * Provides OpenAI-specific embedding model information
- */
-export interface DyFM_OAI_EmbeddingInfo extends DyFM_DAI_EmbeddingInfo {
-  provider: DyFM_AI_Provider.OpenAI;
-  model: DyFM_OAI_EmbeddingModel;
-}

package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.spec.ts

@@ -1,22 +0,0 @@
-import { DyFM_OAI_Settings } from './oai-settings.control-model';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-describe('| DyFM_OAI_Settings', (): void => {
-  it('| should create an instance with default values', (): void => {
-    const settings = new DyFM_OAI_Settings();
-
-    expect(settings).toBeTruthy();
-    expect(settings.provider).toBe(DyFM_AI_Provider.OpenAI);
-    expect(settings.defaultSettings).toBeTruthy();
-    expect(settings.config).toBeTruthy();
-  });
-
-  it('| should create an instance with custom values', (): void => {
-    const settings = new DyFM_OAI_Settings({
-      provider: DyFM_AI_Provider.OpenAI,
-    });
-
-    expect(settings.provider).toBe(DyFM_AI_Provider.OpenAI);
-  });
-});
-

package/src/_modules/ai/_modules/open-ai/_models/oai-settings.control-model.ts

@@ -1,25 +0,0 @@
-import { DyFM_AI_Settings } from '../../../_models/ai-settings.interface';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_OAI_ClientOptions } from './oai-client-options.interface';
-import { DyFM_OAI_CallSettings } from './oai-call-settings.control-model';
-
-/**
- * OpenAI implementation of the generic AI Settings
- * Extends the generic AI_Settings with OpenAI-specific functionality
- */
-export class DyFM_OAI_Settings extends DyFM_AI_Settings {
-
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
-  override defaultSettings?: DyFM_OAI_CallSettings = new DyFM_OAI_CallSettings();
-  override config?: DyFM_OAI_ClientOptions = {};
-
-  constructor(
-    set?: DyFM_OAI_Settings
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}

package/src/_modules/ai/_modules/open-ai/_models/oai-user-provider-config.control-model.ts

@@ -1,21 +0,0 @@
-import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-/**
- * OpenAI-specifikus user provider konfiguracio
- */
-export class DyFM_OAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
-  organization?: string;
-  project?: string;
-
-  constructor(
-    set?: DyFM_OAI_UserProviderConfig
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}

package/src/_modules/ai/_modules/open-ai/index.ts

@@ -1,28 +0,0 @@
-
-
-
-/* try {
-  //require.resolve('openai');
-  import('openai');
-} catch {
-  console.log(
-    '❌ OpenAI package not found, please install it with: pnpm add openai'
-  );
-} */
-
-// COLLECTIONS
-export * from './_collections/oai-embedding-model-dimensions.const';
-export * from './_collections/oai-models.const';
-
-// ENUMS
-export * from './_enums/oai-model.enum';
-
-// MODELS
-export * from './_models/oai-call-settings.control-model';
-export * from './_models/oai-client-options.interface';
-export * from './_models/oai-embedding-info.interface';
-export * from './_models/oai-settings.control-model';
-export * from './_models/oai-user-provider-config.control-model';
-
-
-

package/src/_modules/ai/index.ts

@@ -1,27 +0,0 @@
-// COLLECTIONS
-export * from './_collections/ai-model-ref.util';
-export * from './_collections/ai-model-registry.util';
-
-// ENUMS
-export * from './_enums/ai-provider.enum';
-export * from './_enums/ai-model-type.enum';
-export * from './_enums/ai-message-role.enum';
-
-// MODELS
-export * from './_models/ai-call-settings.interface';
-export * from './_models/ai-config.interface';
-export * from './_models/ai-embedding-request.interface';
-export * from './_models/ai-embedding-response.interface';
-export * from './_models/ai-llm-request.interface';
-export * from './_models/ai-llm-response.interface';
-export * from './_models/ai-message.interface';
-export * from './_models/ai-model-capabilities.interface';
-export * from './_models/ai-model-info.interface';
-export * from './_models/ai-model-settings-schema.interface';
-export * from './_models/ai-provider-capabilities.interface';
-export * from './_models/ai-settings.interface';
-export * from './_models/ai-tool.interface';
-export * from './_models/ai-tool-call.interface';
-export * from './_models/ai-tool-result.interface';
-export * from './_models/ai-tool-handler.type';
-export * from './_models/ai-user-provider-config.control-model';

package/src/_modules/ci-tools/_enums/cit-ci-result-code.enum.ts

@@ -1,11 +0,0 @@
-
-export enum DyFM_CIT_CIResultCode {
-  unknown = 'unknown',
-  success = 'success',
-  failed = 'failed',
-  warning = 'warning',
-  missing = 'missing',
-}
-
-export const DyFM_CIT_allCIResultCodes: DyFM_CIT_CIResultCode[] = 
-  Object.values(DyFM_CIT_CIResultCode);

package/src/_modules/ci-tools/_enums/cit-ci-step-result-code.enum.ts

@@ -1,10 +0,0 @@
-export enum DyFM_CIT_CIStepResultCode {
-  unknown = 'unknown',
-  success = 'success',
-  skipped = 'skipped',
-  failure = 'failure',
-  cancelled = 'cancelled',
-}
-
-export const DyFM_CIT_allCIStepResultCodes: DyFM_CIT_CIStepResultCode[] = 
-  Object.values(DyFM_CIT_CIStepResultCode);

package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.spec.ts

@@ -1,58 +0,0 @@
-import { DyFM_CIT_CIResultInfo } from './cit-ci-result-info.data-models';
-import { DyFM_CIT_CIResultCode } from '../_enums/cit-ci-result-code.enum';
-import { DyFM_CIT_CIStepResultCode } from '../_enums/cit-ci-step-result-code.enum';
-import { DyFM_CIT_CIStepResult } from './cit-ci-step-result.interface';
-
-describe('| DyFM_CIT_CIResultInfo', (): void => {
-  it('| should create an instance without initial data', (): void => {
-    const resultInfo = new DyFM_CIT_CIResultInfo();
-
-    expect(resultInfo).toBeTruthy();
-    expect(resultInfo.__created).toBeInstanceOf(Date);
-    expect(resultInfo.__lastModified).toBeInstanceOf(Date);
-    expect(resultInfo.stepResults).toEqual([]);
-  });
-
-  it('| should create an instance with initial data', (): void => {
-    const stepResults: DyFM_CIT_CIStepResult[] = [
-      { stepName: 'build', resultCode: DyFM_CIT_CIStepResultCode.success, duration: 100 },
-      { stepName: 'test', resultCode: DyFM_CIT_CIStepResultCode.success, duration: 200 },
-    ];
-
-    const initialData: DyFM_CIT_CIResultInfo = {
-      project: 'myProject',
-      system: 'mySystem',
-      version: '1.0.0',
-      environment: 'development',
-      branch: 'main',
-      result: DyFM_CIT_CIResultCode.success,
-      stepResults: stepResults,
-      linkToAction: 'https://example.com',
-      duration: '10 seconds',
-      error: 'Error message',
-      errorDetails: { error: 'Error object' },
-    };
-
-    const resultInfo = new DyFM_CIT_CIResultInfo(initialData);
-
-    expect(resultInfo.project).toBe('myProject');
-    expect(resultInfo.system).toBe('mySystem');
-    expect(resultInfo.version).toBe('1.0.0');
-    expect(resultInfo.environment).toBe('development');
-    expect(resultInfo.branch).toBe('main');
-    expect(resultInfo.result).toBe(DyFM_CIT_CIResultCode.success);
-    expect(resultInfo.stepResults).toEqual(stepResults);
-    expect(resultInfo.linkToAction).toBe('https://example.com');
-    expect(resultInfo.duration).toBe('10 seconds');
-    expect(resultInfo.error).toBe('Error message');
-    expect(resultInfo.errorDetails).toEqual({ error: 'Error object' });
-  });
-
-  it('| should have dataParams defined', (): void => {
-    const { DyFM_CIT_ciResultInfo_dataParams } = require('./cit-ci-result-info.data-models');
-
-    expect(DyFM_CIT_ciResultInfo_dataParams).toBeTruthy();
-    expect(DyFM_CIT_ciResultInfo_dataParams.dataName).toBe('ci_result_info');
-  });
-});
-

package/src/_modules/ci-tools/_models/cit-ci-result-info.data-models.ts

@@ -1,77 +0,0 @@
-import { DyFM_CIT_CIStepResultCode } from '../_enums/cit-ci-step-result-code.enum';
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
-
-import { DyFM_CIT_CIResultCode } from '../_enums/cit-ci-result-code.enum';
-import { DyFM_CIT_CIStepResult } from './cit-ci-step-result.interface';
-
-/**
- * This data model is used to store the result of a CI/CD pipeline.
- * 
- * @example
- * ```ts
- * const resultInfo: DyFM_CIT_CIResultInfo = new DyFM_CIT_CIResultInfo({
- *   project: 'myProject',
- *   system: 'mySystem',
- *   version: '1.0.0',
- *   environment: 'development',
- *   branch: 'main',
- *   result: DyFM_CIT_CIResultCode.success,
- *   stepResults: [
- *     { stepName: 'build', resultCode: DyFM_CIT_CIStepResultCode.success },
- *     { stepName: 'test', resultCode: DyFM_CIT_CIStepResultCode.success },
- *   ],
- *   linkToAction: 'https://example.com',
- *   duration: '10 seconds',
- *   error: 'Error message',
- *   errorDetails: { error: 'Error object' },
- * });
- * ```
- */
-export class DyFM_CIT_CIResultInfo extends DyFM_Metadata {
-  project: string;
-  system: string;
-  version: string;
-  environment: string;
-  branch: string;
-
-  result: DyFM_CIT_CIResultCode;
-  stepResults?: DyFM_CIT_CIStepResult[] = [];
-  linkToAction?: string;
-  /* detailedResult: string; */
-  duration?: string;
-
-  error?: string;
-  errorDetails?: any;
-
-  constructor(
-    set?: DyFM_CIT_CIResultInfo
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyFM_CIT_ciResultInfo_dataParams = new DyFM_DataModel_Params<DyFM_CIT_CIResultInfo>({
-  dataName: 'ci_result_info',
-  addArchive: true,
-  properties: {
-    project: { type: 'string' },
-    system: { type: 'string' },
-    version: { type: 'string' },
-    environment: { type: 'string' },
-    branch: { type: 'string' },
-
-    result: { type: 'string' },
-    stepResults: { type: 'DyFM_CIT_CIStepResult[]' },
-    linkToAction: { type: 'string' },
-    /* detailedResult: { type: 'string' }, */
-    duration: { type: 'string' },
-
-    error: { type: 'string' },
-    errorDetails: { type: 'any' },
-  },
-});

package/src/_modules/ci-tools/_models/cit-ci-step-result.interface.ts

@@ -1,12 +0,0 @@
-
-
-import { DyFM_CIT_CIStepResultCode } from '../_enums/cit-ci-step-result-code.enum';
-
-export interface DyFM_CIT_CIStepResult {
-  stepName: string;
-  resultCode: DyFM_CIT_CIStepResultCode;
-  duration: number;
-  message?: string;
-  details?: string;
-  error?: any;
-}

package/src/_modules/ci-tools/index.ts

@@ -1,8 +0,0 @@
-
-// ENUMS
-export * from './_enums/cit-ci-result-code.enum';
-export * from './_enums/cit-ci-step-result-code.enum';
-
-// MODELS
-export * from './_models/cit-ci-result-info.data-models';
-export * from './_models/cit-ci-step-result.interface';

package/src/_modules/crypto/_collections/crypto-v1.util.ts

@@ -1,225 +0,0 @@
-import * as CryptoJS from 'crypto-js';
-import { 
-  DyFM_Error, 
-  DyFM_Error_Settings 
-} from '../../../_models/control-models/error.control-model';
-import { DyFM_Object } from '../../../_collections/utils/object.util';
-
-
-/**
- * A utility class for secure encryption and decryption of data
- * Uses AES-256-CBC with deterministic IV and salt for consistent results
- */
-export class DyFM_Crypto {
-  private static readonly defaultErrorUserMsg = 
-    `We encountered an unhandled Authentication Error, ` +
-    `\nplease contact the responsible development team.`;
-
-  /**
-   * Validates the encryption key
-   */
-  private static validateKey(key: string): void {
-    if (!key || typeof key !== 'string') {
-      throw new DyFM_Error({
-        status: 401,
-        message: 'Encryption key is required and must be a string',
-        errorCode: 'DyFM-CRY-KEY-REQ'
-      });
-    }
-    
-    if (key.trim().length === 0) {
-      throw new DyFM_Error({
-        status: 401,
-        message: 'Encryption key cannot be empty or whitespace-only',
-        errorCode: 'DyFM-CRY-KEY-EMPTY'
-      });
-    }
-  }
-
-  /**
-   * Safely serializes data to JSON
-   */
-  private static safeSerialize<T>(data: T): string {
-    try {
-      return JSON.stringify(data);
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('safeSerialize', error),
-        errorCode: 'DyFM-CRY-SER',
-        message: 'Failed to serialize data'
-      });
-    }
-  }
-
-  /**
-   * Safely deserializes JSON data
-   */
-  private static safeDeserialize<T>(data: string): T {
-    try {
-      let parsed = DyFM_Object.failableSafeParseJSON(data);
-      
-      // Handle double-stringified JSON
-      if (typeof parsed === 'string') {
-        try {
-          parsed = DyFM_Object.failableSafeParseJSON(parsed);
-        } catch {
-          // If second parse fails, return the string as is
-          return parsed as T;
-        }
-      }
-
-      // Handle primitive values
-      if (typeof parsed === 'string' || typeof parsed === 'number' || typeof parsed === 'boolean') {
-        return parsed as T;
-      }
-
-      return parsed as T;
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('safeDeserialize', error),
-        errorCode: 'DyFM-CRY-DES',
-        message: 'Failed to deserialize data'
-      });
-    }
-  }
-
-  /**
-   * Derives a 256-bit key from the passphrase using SHA256
-   */
-  private static deriveKey(key: string): CryptoJS.lib.WordArray {
-    return CryptoJS.SHA256(key);
-  }
-
-  /**
-   * Creates a deterministic IV from the key only
-   */
-  private static createDeterministicIV(key: string): CryptoJS.lib.WordArray {
-    const hash = CryptoJS.SHA256(key + ':iv');
-    return CryptoJS.lib.WordArray.create(hash.words.slice(0, 4)); // Use first 16 bytes (128 bits)
-  }
-
-  /**
-   * Encrypts data using AES-256-CBC with deterministic key and IV
-   * @param data The data to encrypt
-   * @param key The encryption key
-   * @returns URL-safe encrypted string
-   * @throws {DyFM_Error} if encryption fails
-   */
-  static encrypt<T>(data: T, key: string): string {
-    try {
-      // Validate key
-      this.validateKey(key);
-
-      // Validate data
-      if (data === undefined || data === null) {
-        throw new DyFM_Error({
-          status: 401,
-          message: 'Data cannot be undefined or null',
-          errorCode: 'DyFM-CRY-DATA-NULL'
-        });
-      }
-
-      // Convert data to string
-      const dataStr = this.safeSerialize(data);
-
-      // Derive key and IV
-      const aesKey = this.deriveKey(key);
-      const iv = this.createDeterministicIV(key);
-
-      // Encrypt the data with deterministic key and IV
-      const encrypted = CryptoJS.AES.encrypt(dataStr, aesKey, {
-        iv: iv,
-        mode: CryptoJS.mode.CBC,
-        padding: CryptoJS.pad.Pkcs7
-      });
-
-      // Convert to URL-safe base64
-      const base64 = encrypted.ciphertext.toString(CryptoJS.enc.Base64);
-      return base64
-        .replace(/\+/g, '-')
-        .replace(/\//g, '_')
-        .replace(/=+$/, '');
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('encrypt', error),
-        errorCode: 'DyFM-CRY-ENC',
-      });
-    }
-  }
-
-  /**
-   * Decrypts data that was encrypted using encrypt()
-   * @param encryptedData The encrypted data
-   * @param key The decryption key
-   * @returns The decrypted data
-   * @throws {DyFM_Error} if decryption fails
-   */
-  static decrypt<T>(encryptedData: string, key: string): T {
-    try {
-      // Validate key
-      this.validateKey(key);
-
-      // Validate encrypted data
-      if (!encryptedData || typeof encryptedData !== 'string') {
-        throw new DyFM_Error({
-          status: 401,
-          message: 'Encrypted data is required and must be a string',
-          errorCode: 'DyFM-CRY-DATA-REQ'
-        });
-      }
-
-      // Convert from URL-safe base64
-      let base64 = encryptedData
-        .replace(/-/g, '+')
-        .replace(/_/g, '/');
-
-      // Add padding if needed
-      const padLength = 4 - (base64.length % 4);
-      if (padLength < 4) {
-        base64 += '='.repeat(padLength);
-      }
-
-      // Derive key and IV
-      const aesKey = this.deriveKey(key);
-      const iv = this.createDeterministicIV(key);
-
-      // Decrypt the data
-      const encryptedWA = CryptoJS.enc.Base64.parse(base64);
-      const decrypted = CryptoJS.AES.decrypt({ ciphertext: encryptedWA }, aesKey, {
-        iv: iv,
-        mode: CryptoJS.mode.CBC,
-        padding: CryptoJS.pad.Pkcs7
-      });
-
-      // Parse JSON
-      const decryptedStr = decrypted.toString(CryptoJS.enc.Utf8);
-      
-      if (!decryptedStr) {
-        throw new DyFM_Error({
-          status: 401,
-          message: 'Failed to decrypt data - invalid key or corrupted data',
-          errorCode: 'DyFM-CRY-DEC-FAIL'
-        });
-      }
-
-      return this.safeDeserialize<T>(decryptedStr);
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('decrypt', error),
-        errorCode: 'DyFM-CRY-DRY',
-      });
-    }
-  }
-
-  /**
-   * Gets default error settings
-   */
-  private static getDefaultErrorSettings(operation: string, error?: any): DyFM_Error_Settings {
-    return {
-      status: (error as DyFM_Error)?.___status ?? (error as any)?.status ?? 401,
-      message: `Crypto operation "${operation}" failed; ` + DyFM_Error.getAnyMessage(error),
-      error: error,
-      errorCode: 'DyFM-CRY-ERR'
-    };
-  }
-}