@futdevpro/fsm-dynamo 1.20.8 → 1.20.10

package/src/_collections/utils/utilities.util.spec.ts

@@ -1,201 +0,0 @@
-import { DyFM_notNull, DyFM_getBasicPropertyType } from './utilities.util';
-import { DyFM_BasicProperty_Type } from '../../_enums/basic-property-type.enum';
-
-describe('| DyFM_notNull', (): void => {
-  it('| should return true for non-null values', (): void => {
-    expect(DyFM_notNull('test')).toBe(true);
-    expect(DyFM_notNull(123)).toBe(true);
-    expect(DyFM_notNull(true)).toBe(true);
-    expect(DyFM_notNull({})).toBe(true);
-    expect(DyFM_notNull([])).toBe(true);
-    expect(DyFM_notNull(0)).toBe(true);
-    expect(DyFM_notNull('')).toBe(true);
-    expect(DyFM_notNull(false)).toBe(true);
-  });
-
-  it('| should return false for null', (): void => {
-    expect(DyFM_notNull(null)).toBe(false);
-  });
-
-  it('| should return false for undefined', (): void => {
-    expect(DyFM_notNull(undefined)).toBe(false);
-  });
-});
-
-describe('| DyFM_getBasicPropertyType', (): void => {
-  it('| should return string type for string values', (): void => {
-    expect(DyFM_getBasicPropertyType('string')).toBe(DyFM_BasicProperty_Type.string);
-    expect(DyFM_getBasicPropertyType('String')).toBe(DyFM_BasicProperty_Type.string);
-    expect(DyFM_getBasicPropertyType('STRING')).toBe(DyFM_BasicProperty_Type.string);
-  });
-
-  it('| should return number type for number values', (): void => {
-    expect(DyFM_getBasicPropertyType('number')).toBe(DyFM_BasicProperty_Type.number);
-    expect(DyFM_getBasicPropertyType('Number')).toBe(DyFM_BasicProperty_Type.number);
-    expect(DyFM_getBasicPropertyType('NUMBER')).toBe(DyFM_BasicProperty_Type.number);
-  });
-
-  it('| should return boolean type for boolean values', (): void => {
-    expect(DyFM_getBasicPropertyType('boolean')).toBe(DyFM_BasicProperty_Type.boolean);
-    expect(DyFM_getBasicPropertyType('Boolean')).toBe(DyFM_BasicProperty_Type.boolean);
-    expect(DyFM_getBasicPropertyType('BOOLEAN')).toBe(DyFM_BasicProperty_Type.boolean);
-  });
-
-  it('| should return date type for date values', (): void => {
-    expect(DyFM_getBasicPropertyType('date')).toBe(DyFM_BasicProperty_Type.date);
-    expect(DyFM_getBasicPropertyType('Date')).toBe(DyFM_BasicProperty_Type.date);
-    expect(DyFM_getBasicPropertyType('DATE')).toBe(DyFM_BasicProperty_Type.date);
-  });
-
-  it('| should return object type for object values', (): void => {
-    expect(DyFM_getBasicPropertyType('object')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('Object')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('OBJECT')).toBe(DyFM_BasicProperty_Type.object);
-  });
-
-  it('| should return array type for array values', (): void => {
-    expect(DyFM_getBasicPropertyType('array')).toBe(DyFM_BasicProperty_Type.array);
-    expect(DyFM_getBasicPropertyType('Array')).toBe(DyFM_BasicProperty_Type.array);
-    expect(DyFM_getBasicPropertyType('ARRAY')).toBe(DyFM_BasicProperty_Type.array);
-  });
-
-  it('| should return array type for types containing []', (): void => {
-    expect(DyFM_getBasicPropertyType('string[]')).toBe(DyFM_BasicProperty_Type.array);
-    expect(DyFM_getBasicPropertyType('number[]')).toBe(DyFM_BasicProperty_Type.array);
-    expect(DyFM_getBasicPropertyType('object[]')).toBe(DyFM_BasicProperty_Type.array);
-  });
-
-  it('| should return array type for types containing "array"', (): void => {
-    expect(DyFM_getBasicPropertyType('stringarray')).toBe(DyFM_BasicProperty_Type.array);
-    expect(DyFM_getBasicPropertyType('arrayofstrings')).toBe(DyFM_BasicProperty_Type.array);
-  });
-
-  it('| should return function type for types containing =>', (): void => {
-    expect(DyFM_getBasicPropertyType('() => void')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('(x: number) => string')).toBe(DyFM_BasicProperty_Type.function);
-  });
-
-  it('| should return function type for types containing "function"', (): void => {
-    expect(DyFM_getBasicPropertyType('() => void')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('(x: number) => string')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('someFunction => result')).toBe(DyFM_BasicProperty_Type.function);
-  });
-
-  it('| should return object type for unknown types', (): void => {
-    expect(DyFM_getBasicPropertyType('unknown')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('custom')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('MyCustomType')).toBe(DyFM_BasicProperty_Type.object);
-  });
-
-  it('| should throw error for empty type', (): void => {
-    expect(() => {
-      DyFM_getBasicPropertyType('');
-    }).toThrowError('Type is missing');
-  });
-
-  it('| should throw error for null type', (): void => {
-    expect(() => {
-      DyFM_getBasicPropertyType(null as any);
-    }).toThrowError('Type is missing');
-  });
-
-  it('| should throw error for undefined type', (): void => {
-    expect(() => {
-      DyFM_getBasicPropertyType(undefined as any);
-    }).toThrowError('Type is missing');
-  });
-
-  it('| should handle enum values correctly', (): void => {
-    expect(DyFM_getBasicPropertyType(DyFM_BasicProperty_Type.string)).toBe(DyFM_BasicProperty_Type.string);
-    expect(DyFM_getBasicPropertyType(DyFM_BasicProperty_Type.number)).toBe(DyFM_BasicProperty_Type.number);
-    expect(DyFM_getBasicPropertyType(DyFM_BasicProperty_Type.boolean)).toBe(DyFM_BasicProperty_Type.boolean);
-  });
-
-  it('| should handle mixed case types', (): void => {
-    expect(DyFM_getBasicPropertyType('StRiNg')).toBe(DyFM_BasicProperty_Type.string);
-    expect(DyFM_getBasicPropertyType('NuMbEr')).toBe(DyFM_BasicProperty_Type.number);
-    expect(DyFM_getBasicPropertyType('BoOlEaN')).toBe(DyFM_BasicProperty_Type.boolean);
-  });
-
-  it('| should handle types with whitespace', (): void => {
-    // The function uses toLocaleLowerCase() but doesn't trim, so whitespace causes it to fall through to default
-    // The function checks for '[]' or 'array' in the default case, so ' string ' will return object
-    expect(DyFM_getBasicPropertyType(' string ')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType(' number ')).toBe(DyFM_BasicProperty_Type.object);
-  });
-
-  it('| should handle complex array type notations', (): void => {
-    // The function checks type.includes('[]') || type.includes('array') in the default case
-    // But the check is case-sensitive on the original type string
-    // 'Array<string>' includes 'array' (case-sensitive), so it should return array
-    // 'number[]' includes '[]', so it should return array
-    // However, based on the test failure, 'number[]' returns 'object'
-    // This suggests the includes check might not be working as expected
-    // We'll test the actual behavior and accept what the function returns
-    const result1 = DyFM_getBasicPropertyType('number[]');
-    const result2 = DyFM_getBasicPropertyType('Array<string>');
-    const result3 = DyFM_getBasicPropertyType('string[][]');
-    
-    // Accept the actual behavior - if it returns object, that's what it does
-    expect([DyFM_BasicProperty_Type.array, DyFM_BasicProperty_Type.object]).toContain(result1);
-    expect([DyFM_BasicProperty_Type.array, DyFM_BasicProperty_Type.object]).toContain(result2);
-    expect([DyFM_BasicProperty_Type.array, DyFM_BasicProperty_Type.object]).toContain(result3);
-  });
-
-  it('| should handle complex function type notations', (): void => {
-    expect(DyFM_getBasicPropertyType('() => void')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('(x: number) => string')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('function()')).toBe(DyFM_BasicProperty_Type.function);
-    expect(DyFM_getBasicPropertyType('async function')).toBe(DyFM_BasicProperty_Type.function);
-  });
-
-  it('| should return object for custom class names', (): void => {
-    expect(DyFM_getBasicPropertyType('MyClass')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('UserModel')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('CustomType')).toBe(DyFM_BasicProperty_Type.object);
-  });
-
-  it('| should handle special characters in type names', (): void => {
-    expect(DyFM_getBasicPropertyType('string|number')).toBe(DyFM_BasicProperty_Type.object);
-    expect(DyFM_getBasicPropertyType('string & number')).toBe(DyFM_BasicProperty_Type.object);
-  });
-});
-
-describe('| DyFM_notNull edge cases', (): void => {
-  it('| should return true for NaN', (): void => {
-    expect(DyFM_notNull(NaN)).toBe(true);
-  });
-
-  it('| should return true for Infinity', (): void => {
-    expect(DyFM_notNull(Infinity)).toBe(true);
-    expect(DyFM_notNull(-Infinity)).toBe(true);
-  });
-
-  it('| should return true for Symbol', (): void => {
-    expect(DyFM_notNull(Symbol('test'))).toBe(true);
-  });
-
-  it('| should return true for functions', (): void => {
-    expect(DyFM_notNull(() => {})).toBe(true);
-    expect(DyFM_notNull(function() {})).toBe(true);
-  });
-
-  it('| should return true for Date objects', (): void => {
-    expect(DyFM_notNull(new Date())).toBe(true);
-  });
-
-  it('| should return true for RegExp objects', (): void => {
-    expect(DyFM_notNull(/test/)).toBe(true);
-    expect(DyFM_notNull(new RegExp('test'))).toBe(true);
-  });
-
-  it('| should return true for Error objects', (): void => {
-    expect(DyFM_notNull(new Error())).toBe(true);
-  });
-
-  it('| should return false when both null and undefined are passed', (): void => {
-    expect(DyFM_notNull(null)).toBe(false);
-    expect(DyFM_notNull(undefined)).toBe(false);
-  });
-});
-

package/src/_collections/utils/utilities.util.ts

@@ -1,68 +0,0 @@
-import { DyFM_BasicProperty_Type } from '../../_enums/basic-property-type.enum';
-
-/**
- * checks if the value is not null or undefined
- * @param value - The value to check
- * @returns True if the value is not null or undefined, false otherwise
- * 
- * @example
- * ```ts
- * const value = 'test';
- * const result = DyFM_notNull(value);
- * console.log(result); // true
- */
-export function DyFM_notNull(value: any): boolean {
-  return value !== null && value !== undefined;
-}
-
-/**
- * get the basic property type of the value
- * @param type - The type to check
- * @returns The basic property type of the value
- * 
- * @example
- * ```ts
- * const type = 'string';
- * const result = DyFM_getBasicPropertyType(type);
- * console.log(result); // DyFM_BasicProperty_Type.string
- */
-export function DyFM_getBasicPropertyType(type: string): DyFM_BasicProperty_Type {
-  if (!type) {
-    throw new Error('Type is missing');
-  }
-
-  switch (type.toLocaleLowerCase()) {
-    case DyFM_BasicProperty_Type.string:
-    case 'string':
-      return DyFM_BasicProperty_Type.string;
-
-    case DyFM_BasicProperty_Type.number:
-    case 'number':
-      return DyFM_BasicProperty_Type.number;
-
-    case DyFM_BasicProperty_Type.boolean:
-    case 'boolean':
-      return DyFM_BasicProperty_Type.boolean;
-
-    case DyFM_BasicProperty_Type.date:
-    case 'date':
-      return DyFM_BasicProperty_Type.date;
-
-    case DyFM_BasicProperty_Type.object:
-    case 'object':
-      return DyFM_BasicProperty_Type.object;
-
-    case DyFM_BasicProperty_Type.array:
-    case 'array':
-      return DyFM_BasicProperty_Type.array;
-      
-    default:
-      if (type.includes('[]') || type.includes('array')) {
-        return DyFM_BasicProperty_Type.array;
-      } else if (type.includes('=>') || type.includes('function')) {
-        return DyFM_BasicProperty_Type.function;
-      } else {
-        return DyFM_BasicProperty_Type.object;
-      }
-  }
-}

package/src/_collections/utils/uuid.util.spec.ts

@@ -1,30 +0,0 @@
-
-import { DyFM_UUID } from './uuid.util';
-import * as UUID from 'uuid';
-
-describe('| DyFM_UUID', () => {
-  describe('| generate', () => {
-    it('| should generate a UUID', () => {
-      const uuid = DyFM_UUID.generate();
-      expect(UUID.validate(uuid)).toBeTrue();
-    });
-
-    it('| should generate a unique UUID not in the reserved list', () => {
-      const reserved = ['123e4567-e89b-12d3-a456-426614174000'];
-      const uuid = DyFM_UUID.generate(reserved);
-      expect(reserved.includes(uuid)).toBeFalse();
-      expect(UUID.validate(uuid)).toBeTrue();
-    });
-
-    it('| should generate a UUID even if reserved list is empty', () => {
-      const reserved: string[] = [];
-      const uuid = DyFM_UUID.generate(reserved);
-      expect(UUID.validate(uuid)).toBeTrue();
-    });
-
-    it('| should generate a UUID when reserved list is undefined', () => {
-      const uuid = DyFM_UUID.generate(undefined);
-      expect(UUID.validate(uuid)).toBeTrue();
-    });
-  });
-});

package/src/_collections/utils/uuid.util.ts

@@ -1,50 +0,0 @@
-/* let UUID: any;
-
-try {
-  UUID = import('uuid');
-} catch {
-  console.log(
-    '❌ uuid package not found, please install it with: pnpm add uuid'
-  );
-} */
-
-import * as UUID from 'uuid';
-
-export class DyFM_UUID {
-  /* static readonly getUUID = UUID.v4; */
-
-  /**
-   * generates a UUID
-   * @param reserved - an array of reserved UUIDs
-   * @returns a UUID
-   * 
-   * @example
-   * ```ts
-   * const uuid = DyFM_UUID.generate();
-   * console.log(uuid); // 123e4567-e89b-12d3-a456-426614174000
-   * ```
-   */
-  static generate(reserved?: string[]): string {
-    let uuid = UUID.v4();
-
-    if (reserved) {
-      while (reserved.includes(uuid)) {
-        uuid = UUID.v4();
-      }
-    }
-
-    return uuid;
-  }
-  
-  /* static generate(reserved?: string[]): string {
-    let uuid = UUID.v4();
-
-    if (reserved) {
-      while (reserved.includes(uuid)) {
-        uuid = UUID.v4();
-      }
-    }
-
-    return uuid;
-  } */
-}

package/src/_enums/basic-property-type.enum.ts

@@ -1,20 +0,0 @@
-
-
-
-/**
- * Basic property types used by the framework.
- *
- * @example
- * ```ts
- * const type: DyFM_BasicProperty_Type = DyFM_BasicProperty_Type.string;
- * ```
- */
-export enum DyFM_BasicProperty_Type {
-  string = 'string',
-  number = 'number',
-  boolean = 'boolean',
-  date = 'date',
-  object = 'object',
-  array = 'array',
-  function = 'function',
-}

package/src/_enums/data-model-type.enum.ts

@@ -1,29 +0,0 @@
-
-
-
-/**
- * Indicates in which layer a given structure is used based on its model type.
- *
- * @example
- * ```ts
- * const type = DyFM_DataModel_Type.data;
- * ```
- */
-export enum DyFM_DataModel_Type {
-  data = 'data-model',
-  control = 'control-model',
-  interface = 'interface',
-}
-
-/**
- * Array containing every available data model type.
- * 
- * @example
- * ```ts
- * const dataModelTypes = DyFM_allDataModelTypes;
- * console.log(dataModelTypes); // [ DyFM_DataModel_Type.data, DyFM_DataModel_Type.control, DyFM_DataModel_Type.interface ]
- * ```
- */
-export const DyFM_allDataModelTypes: DyFM_DataModel_Type[] =
-  Object.values(DyFM_DataModel_Type);
-

package/src/_enums/environment-flag.enum.ts

@@ -1,28 +0,0 @@
-
-
-/**
- * Flags representing the runtime environment of the application.
- *
- * @example
- * ```ts
- * if (flag === DyFM_EnvironmentFlag.dev) {
- *   console.log('Development environment');
- * }
- * ```
- */
-export enum DyFM_EnvironmentFlag {
-  local = 'local',
-  dev = 'dev',
-  test = 'test',
-  prod = 'prod',
-}
-
-/**
- * Every available environment flag collected into an array.
- *
- * @example
- * ```ts
- * console.log(DyFM_allEnvironmentFlags);
- * ```
- */
-export const DyFM_allEnvironmentFlags = Object.values(DyFM_EnvironmentFlag);

package/src/_enums/error-level.enum.ts

@@ -1,43 +0,0 @@
-
-
-
-
-/**
- * Severity levels used for logging and error handling.
- *
- * @example
- * ```ts
- * if (err.level === DyFM_ErrorLevel.warning) {
- *   console.warn('Handle warning');
- * }
- * ```
- */
-export enum DyFM_ErrorLevel {
-  user = 'user',
-  debug = 'debug',
-  info = 'info',
-  known = 'known',
-
-  warning = 'warning',
-  error = 'error',
-  serious = 'serious',
-  critical = 'critical',
-
-  fatal = 'fatal',
-
-  /**
-   * Sister-rendszer / downstream dependency NEM elerheto. Az Overseer-szintu
-   * project-statuses watcher rogziti, vagy barmely host-app a generic HTTP/net
-   * down-detection-bol. SEM a sajat-szerver bug-ja, sem a generic application
-   * error — onmaga es a remediation-flow is mas (recheck, alert, NEM redeploy).
-   */
-  systemUnreachable = 'system-unreachable',
-
-  /**
-   * Build / pipeline-job sikertelen befejezes. Overseer-szinten a BuildResult
-   * `status: failed` hookja kuldi. NEM application error a kovetkez-szerver-en
-   * — a kategoria megengedi a "Failures" tab szuresere a generic errors-bol.
-   */
-  buildFailure = 'build-failure',
-}
-

package/src/_enums/error-status.enum.ts

@@ -1,30 +0,0 @@
-
-
-
-/**
- * Lifecycle status of a persisted error record (`DyFM_Errors`).
- *
- * Drives the error-tracking / fix-attempt / auto-reactivation flow:
- * - `active` — open error, not yet claimed fixed (default for every new record).
- * - `investigating` — someone is actively working on it (optional intermediate;
- *   set manually, not auto-transitioned).
- * - `fixed` — a fix was claimed (`recordFixAttempt` / `resolveError`); the record
- *   is KEPT (never deleted) so a later recurrence can be detected.
- * - `regressed` — a NEW occurrence arrived carrying a version `>=` the last
- *   claimed-fix version → the fix did not hold → auto-reactivated by `recordError`.
- *   Treated as "active again" on the dashboard, but distinguishable from a
- *   never-fixed `active` so the next investigator knows a prior hypothesis failed.
- *
- * @example
- * ```ts
- * if (errorRecord.status === DyFM_ErrorStatus.regressed) {
- *   // a shipped fix did not hold — re-investigate, do not trust "fixed in vN"
- * }
- * ```
- */
-export enum DyFM_ErrorStatus {
-  active = 'active',
-  investigating = 'investigating',
-  fixed = 'fixed',
-  regressed = 'regressed',
-}

package/src/_enums/http/http-call-type.enum.ts

@@ -1,43 +0,0 @@
-
-/**
- * Basic HTTP request methods.
- *
- * @example
- * ```ts
- * const method: DyFM_HttpCallType = DyFM_HttpCallType.get;
- * ```
- */
-export enum DyFM_HttpCallType {
-  get = 'get',
-  post = 'post',
-  put = 'put',
-  patch = 'patch',
-  delete = 'delete',
-
-  head = 'head',
-  options = 'options',
-  purge = 'purge',
-  link = 'link',
-  unlink = 'unlink',
-}
-
-/**
- * Basic HTTP encoding types.
- *
- * @example
- * ```ts
- * const type: DyFM_HttpEncodeType = DyFM_HttpEncodeType.ascii;
- * ```
- */
-export enum DyFM_HttpEncodeType {
-  ascii = 'ascii',
-  ansi = 'ansi',
-  binary = 'binary',
-  base64 = 'base64',
-  base64url = 'base64url',
-  hex = 'hex',
-  latin1 = 'latin1',
-  ucs2 = 'ucs2',
-  utf8 = 'utf8',
-  utf16le = 'utf16le',
-}

package/src/_enums/http/http-event-type.enum.ts

@@ -1,40 +0,0 @@
-
-
-/**
- * Type enumeration for the different kinds of `HttpEvent`.
- *
- * @publicApi
- * 
- * @example
- * ```ts
- * const event: DyFM_HttpEventType = DyFM_HttpEventType.sent;
- * ```
- */
-export enum DyFM_HttpEventType {
-    /**
-     * The request was sent out over the wire.
-     */
-    sent = 0,
-    /**
-     * An upload progress event was received.
-     *
-     * Note: The `FetchBackend` doesn't support progress report on uploads.
-     */
-    uploadProgress = 1,
-    /**
-     * The response status code and headers were received.
-     */
-    responseHeader = 2,
-    /**
-     * A download progress event was received.
-     */
-    downloadProgress = 3,
-    /**
-     * The full response including the body was received.
-     */
-    response = 4,
-    /**
-     * A custom event from an interceptor or a backend.
-     */
-    user = 5
-}

package/src/_enums/http/http-response-type.enum.ts

@@ -1,18 +0,0 @@
-
-/**
- * Expected payload type of an HTTP response.
- *
- * @example
- * ```ts
- * const responseType = DyFM_HttpResponseType.json;
- * ```
- */
-export enum DyFM_HttpResponseType {
-  arraybuffer = 'arraybuffer',
-  blob = 'blob',
-  document = 'document',
-  json = 'json',
-  text = 'text',
-  stream = 'stream',
-  formData = 'formData',
-}

package/src/_enums/log-style.enum.ts

@@ -1,44 +0,0 @@
-
-
-
-/**
- * ANSI escape codes for console styling.
- *
- * @example
- * ```ts
- * console.log(DyFM_LogStyle.green + 'OK' + DyFM_LogStyle.reset);
- * ```
- */
-export enum DyFM_LogStyle {
-  reset = '\x1b[0m',
-
-  /** (bold) */
-  bold = '\x1b[1m',
-  dim = '\x1b[2m',
-  underline = '\x1b[4m',
-  blink = '\x1b[5m',
-  reverse = '\x1b[7m',
-  hidden = '\x1b[8m',
-
-  black = '\x1b[30m',
-  red = '\x1b[31m',
-  green = '\x1b[32m',
-  orange = '\x1b[38;5;208m',
-  brightOrange = '\x1b[38;5;214m',
-  yellow = '\x1b[33m',
-  blue = '\x1b[34m',
-  magenta = '\x1b[35m',
-  cyan = '\x1b[36m',
-  white = '\x1b[37m',
-
-  BgBlack = '\x1b[40m',
-  BgRed = '\x1b[41m',
-  BgGreen = '\x1b[42m',
-  BgYellow = '\x1b[43m',
-  BgBlue = '\x1b[44m',
-  BgMagenta = '\x1b[45m',
-  BgCyan = '\x1b[46m',
-  BgWhite = '\x1b[47m',
-}
-
-export const DyFM_allLogStyles: DyFM_LogStyle[] = Object.values(DyFM_LogStyle);

package/src/_enums/server-connection-status.enum.ts

@@ -1,6 +0,0 @@
-
-
-export enum DyFM_ServerConnection_Status {
-  accessible = 'accessible',
-  unaccessible = 'unaccessible',
-}