@futdevpro/fsm-dynamo 1.16.38 → 1.16.40

package/src/_models/interfaces/box-bounds.interface.ts

@@ -1,8 +1,8 @@
-import { DyFM_Vector2 } from './vector2.interface';
-
-export interface DyFM_BoxBounds {
-  pos: DyFM_Vector2;
-  size: DyFM_Vector2;
-  center: DyFM_Vector2;
-  centerMargin: DyFM_Vector2;
+import { DyFM_Vector2 } from './vector2.interface';
+
+export interface DyFM_BoxBounds {
+  pos: DyFM_Vector2;
+  size: DyFM_Vector2;
+  center: DyFM_Vector2;
+  centerMargin: DyFM_Vector2;
 }

package/src/_models/interfaces/environment/global-log-settings.interface.ts

@@ -1,86 +1,86 @@
-
-export interface DyFM_GlobalLog_Settings {
-  /**
-   * this setting will set which logs will be shown
-   */
-  highDetailedLogs?: boolean;
-
-  deep?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the application
-   */
-  setup?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the database
-   */
-  dbSetup?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  request?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsParams?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsContent?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  responseContent?: boolean;
-  
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_allEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_mainEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_eventContent?: boolean;
-
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_events?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestContents?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestSettings?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_responseContents?: boolean;
-
-
-  /**
-   * this is an application wide default setting for detailed error logs
-   */
-  detailedErrors?: boolean;
-
-  server_debug?: boolean;
-
-  functions?: boolean;
-}
+
+export interface DyFM_GlobalLog_Settings {
+  /**
+   * this setting will set which logs will be shown
+   */
+  highDetailedLogs?: boolean;
+
+  deep?: boolean;
+
+  /**
+   * this setting will enable debug logs for setting up the application
+   */
+  setup?: boolean;
+
+  /**
+   * this setting will enable debug logs for setting up the database
+   */
+  dbSetup?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  request?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsParams?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsContent?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  responseContent?: boolean;
+  
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_allEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_mainEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_eventContent?: boolean;
+
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_events?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestContents?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestSettings?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_responseContents?: boolean;
+
+
+  /**
+   * this is an application wide default setting for detailed error logs
+   */
+  detailedErrors?: boolean;
+
+  server_debug?: boolean;
+
+  functions?: boolean;
+}

package/src/_models/interfaces/environment/global-settings.interface.ts

@@ -1,69 +1,69 @@
-
-import { DyFM_EnvironmentFlag } from '../../../_enums/environment-flag.enum';
-import { DyFM_GlobalLog_Settings } from './global-log-settings.interface';
-
-/**
- * 
- * @param logRequestsContent only will log if the specific logRequest is also true
- * 
- * @param logEventContent only will log if the specific socket event is also set to log
- * 
- */
-export interface DyFM_Global_Settings {
-  systemShortCodeName: string;
-  
-  /**
-   * this will be used as the main baseUrl for the application,
-   * this is not required, but we suggest to use at least a '/api' as base route
-   */
-  baseUrl: string;
-
-  /**
-   * this setting will set which logs will be shown
-   */
-  log_settings: DyFM_GlobalLog_Settings;
-
-  /**
-   * FR-015 Phase 2 — isomorphic env-var overrides surface.
-   *
-   * On Node, `DyFM_requireEnv(name, ...)` reads `process.env[name]` directly.
-   * On browser there is no `process.env` at runtime, so consumers populate
-   * this map at app bootstrap from `environment.ts`:
-   *
-   * ```ts
-   * import { DyFM_global_settings } from '@futdevpro/fsm-dynamo';
-   * import { environment } from './environments/environment';
-   *
-   * DyFM_global_settings.envOverrides = {
-   *   FDP_CORE_FE_AUTH_KEY: environment.authKey,
-   *   FDP_EXTRA_AUTH_STORAGE_KEY: environment.extraAuthStorageKey,
-   *   DyNM_STORAGE_ENCRYPTION_KEY: environment.storageEncryptionKey,
-   * };
-   * ```
-   *
-   * `DyFM_requireEnv` checks `process.env` first, then this map, then
-   * the caller's optional `fallback`, then throws a structured DyFM_Error.
-   */
-  envOverrides?: Record<string, string>;
-
-  /**
-   * The RESOLVED runtime environment of the application.
-   *
-   * **Why this exists:** the fleet already knows how to resolve the environment
-   * (`FDP_environmentFromHostname` / `FDP_setupFEEnvSettings` in `@futdevpro/fdp-templates`,
-   * called from every app's `main.ts`), but the RESULT was never stored anywhere — each app
-   * kept it in a local `const`. Bedrock UI (e.g. the "TEST" ribbon in `@futdevpro/ngx-dynamo`)
-   * therefore had NO readable source. This field is that source.
-   *
-   * **Layering:** `ngx-dynamo` must not depend on `fdp-templates` (the dependency runs the other
-   * way), so the shared lower layer — this package — owns the field.
-   *
-   * **FAIL-SAFE default: `prod`.** An unknown/unset environment must never light up a test
-   * indicator on a production surface. A missing setup degrades to "silently production-like",
-   * not to "warns everyone".
-   *
-   * Populated at app bootstrap; on the frontend `FDP_setupFEEnvSettings()` writes it as a side
-   * effect, so consumers need no extra call.
-   */
-  environmentFlag: DyFM_EnvironmentFlag;
-}
+
+import { DyFM_EnvironmentFlag } from '../../../_enums/environment-flag.enum';
+import { DyFM_GlobalLog_Settings } from './global-log-settings.interface';
+
+/**
+ * 
+ * @param logRequestsContent only will log if the specific logRequest is also true
+ * 
+ * @param logEventContent only will log if the specific socket event is also set to log
+ * 
+ */
+export interface DyFM_Global_Settings {
+  systemShortCodeName: string;
+  
+  /**
+   * this will be used as the main baseUrl for the application,
+   * this is not required, but we suggest to use at least a '/api' as base route
+   */
+  baseUrl: string;
+
+  /**
+   * this setting will set which logs will be shown
+   */
+  log_settings: DyFM_GlobalLog_Settings;
+
+  /**
+   * FR-015 Phase 2 — isomorphic env-var overrides surface.
+   *
+   * On Node, `DyFM_requireEnv(name, ...)` reads `process.env[name]` directly.
+   * On browser there is no `process.env` at runtime, so consumers populate
+   * this map at app bootstrap from `environment.ts`:
+   *
+   * ```ts
+   * import { DyFM_global_settings } from '@futdevpro/fsm-dynamo';
+   * import { environment } from './environments/environment';
+   *
+   * DyFM_global_settings.envOverrides = {
+   *   FDP_CORE_FE_AUTH_KEY: environment.authKey,
+   *   FDP_EXTRA_AUTH_STORAGE_KEY: environment.extraAuthStorageKey,
+   *   DyNM_STORAGE_ENCRYPTION_KEY: environment.storageEncryptionKey,
+   * };
+   * ```
+   *
+   * `DyFM_requireEnv` checks `process.env` first, then this map, then
+   * the caller's optional `fallback`, then throws a structured DyFM_Error.
+   */
+  envOverrides?: Record<string, string>;
+
+  /**
+   * The RESOLVED runtime environment of the application.
+   *
+   * **Why this exists:** the fleet already knows how to resolve the environment
+   * (`FDP_environmentFromHostname` / `FDP_setupFEEnvSettings` in `@futdevpro/fdp-templates`,
+   * called from every app's `main.ts`), but the RESULT was never stored anywhere — each app
+   * kept it in a local `const`. Bedrock UI (e.g. the "TEST" ribbon in `@futdevpro/ngx-dynamo`)
+   * therefore had NO readable source. This field is that source.
+   *
+   * **Layering:** `ngx-dynamo` must not depend on `fdp-templates` (the dependency runs the other
+   * way), so the shared lower layer — this package — owns the field.
+   *
+   * **FAIL-SAFE default: `prod`.** An unknown/unset environment must never light up a test
+   * indicator on a production surface. A missing setup degrades to "silently production-like",
+   * not to "warns everyone".
+   *
+   * Populated at app bootstrap; on the frontend `FDP_setupFEEnvSettings()` writes it as a side
+   * effect, so consumers need no extra call.
+   */
+  environmentFlag: DyFM_EnvironmentFlag;
+}

package/src/_models/interfaces/error-defaults.interface.ts

@@ -1,18 +1,18 @@
-
-export interface DyFM_Error_Defaults {
-  errorCode: string;
-  message: string;
-  userMessage: string;
-  issuer: string;
-  issuerService: string;
-  issuerSystem: string;
-  systemVersion: string;
-  /**
-   * BFR-FDPTOKENSERVICE-013 — globális kill-switch az `ErrorCode:` userMessage-utótagra.
-   * `false`-ra állítva SOHA nem kerül belső hibakód a `__userMessage`-be (végfelhasználói felület);
-   * `undefined`/`true` mellett a per-error `addECToUserMsg` flag dönt (visszafelé-kompatibilis).
-   * A kód a `_errorCode` mezőben változatlanul elérhető — a support onnan olvassa.
-   */
-  addECToUserMsg?: boolean;
-}
-
+
+export interface DyFM_Error_Defaults {
+  errorCode: string;
+  message: string;
+  userMessage: string;
+  issuer: string;
+  issuerService: string;
+  issuerSystem: string;
+  systemVersion: string;
+  /**
+   * BFR-FDPTOKENSERVICE-013 — globális kill-switch az `ErrorCode:` userMessage-utótagra.
+   * `false`-ra állítva SOHA nem kerül belső hibakód a `__userMessage`-be (végfelhasználói felület);
+   * `undefined`/`true` mellett a per-error `addECToUserMsg` flag dönt (visszafelé-kompatibilis).
+   * A kód a `_errorCode` mezőben változatlanul elérhető — a support onnan olvassa.
+   */
+  addECToUserMsg?: boolean;
+}
+

package/src/_models/interfaces/paged.interface.ts

@@ -1,12 +1,12 @@
-
-
-
-export interface DyFM_Paged<T> {
-  pageIndex: number;
-  pageSize: number;
-  total: number;
-  totalPageCount?: number;
-  items: T[];
-}
-
-
+
+
+
+export interface DyFM_Paged<T> {
+  pageIndex: number;
+  pageSize: number;
+  total: number;
+  totalPageCount?: number;
+  items: T[];
+}
+
+

package/src/_models/interfaces/random-weight.interface.ts

@@ -1,7 +1,7 @@
-
-
-export interface DyFM_RandomWeight<T> {
-  chance: number;
-  result: T;
-}
-
+
+
+export interface DyFM_RandomWeight<T> {
+  chance: number;
+  result: T;
+}
+

package/src/_models/interfaces/route-settings.interface.ts

@@ -1,15 +1,15 @@
-
-export type DyFM_Route_S<T> = DyFM_Route_Settings<T>;
-export interface DyFM_Route_Settings<T> {
-  mainRoute: string;
-
-  /**
-   * Mapping of route keys to their endpoint paths.
-   *
-   * The generic type is not fully enforced here, so make sure
-   * that the keys correspond to the enum provided for <T>.
-   */
-  endPoints: {
-    [key in T as string]: string
-  };
-}
+
+export type DyFM_Route_S<T> = DyFM_Route_Settings<T>;
+export interface DyFM_Route_Settings<T> {
+  mainRoute: string;
+
+  /**
+   * Mapping of route keys to their endpoint paths.
+   *
+   * The generic type is not fully enforced here, so make sure
+   * that the keys correspond to the enum provided for <T>.
+   */
+  endPoints: {
+    [key in T as string]: string
+  };
+}

package/src/_models/interfaces/search-query.interface.ts

@@ -1,23 +1,23 @@
-
-
-import { DyFM_DSFilter } from '../types/ds-filter.type';
-import { DyFM_DSSort } from '../types/ds-sort.type';
-
-export interface DyFM_SearchQuery<T> {
-  filterBy?: DyFM_DSFilter<T>; //DyFM_DBFilterSimple<T>; //DyFM_DBFilter<T>;
-  /**
-   * The sort order to load.
-   * The last sort will apply last, so it will be the strongest sort.
-   */
-  sortBy?: DyFM_DSSort[];
-  /**
-   * The page index number to load.
-   * 0-indexed.
-   */
-  page?: number;
-  /**
-   * The page size to load.
-   */
-  pageSize?: number;
-}
-
+
+
+import { DyFM_DSFilter } from '../types/ds-filter.type';
+import { DyFM_DSSort } from '../types/ds-sort.type';
+
+export interface DyFM_SearchQuery<T> {
+  filterBy?: DyFM_DSFilter<T>; //DyFM_DBFilterSimple<T>; //DyFM_DBFilter<T>;
+  /**
+   * The sort order to load.
+   * The last sort will apply last, so it will be the strongest sort.
+   */
+  sortBy?: DyFM_DSSort[];
+  /**
+   * The page index number to load.
+   * 0-indexed.
+   */
+  page?: number;
+  /**
+   * The page size to load.
+   */
+  pageSize?: number;
+}
+

package/src/_models/interfaces/search-result.interface.ts

@@ -1,6 +1,6 @@
-
-
-export interface DyFM_SearchResult<T> {
-  results: T[];
-  totalItems: number;
+
+
+export interface DyFM_SearchResult<T> {
+  results: T[];
+  totalItems: number;
 }

package/src/_models/interfaces/server-error-statistics.interface.ts

@@ -1,24 +1,24 @@
-
-
-export interface DyFM_Error_Statistics {
-  range?: string;
-
-  allErrors?: number;
-  allAllErrors?: number;
-
-  serverErrors?: number;
-  clientErrors?: number;
-  allServerErrors?: number;
-  allClientErrors?: number;
-
-  infoErrors?: number;
-  warningErrors?: number;
-  errorErrors?: number;
-  criticalErrors?: number;
-
-  allInfoErrors?: number;
-  allWarningErrors?: number;
-  allErrorErrors?: number;
-  allCriticalErrors?: number;
-}
-
+
+
+export interface DyFM_Error_Statistics {
+  range?: string;
+
+  allErrors?: number;
+  allAllErrors?: number;
+
+  serverErrors?: number;
+  clientErrors?: number;
+  allServerErrors?: number;
+  allClientErrors?: number;
+
+  infoErrors?: number;
+  warningErrors?: number;
+  errorErrors?: number;
+  criticalErrors?: number;
+
+  allInfoErrors?: number;
+  allWarningErrors?: number;
+  allErrorErrors?: number;
+  allCriticalErrors?: number;
+}
+

package/src/_models/interfaces/vector2.interface.ts

@@ -1,21 +1,21 @@
-
-
-
-
-
-/**
- * Represents a 2D vector with x and y coordinates
- * 
- * @see {@link DyFM_Vector2_Util} for utility functions
- * 
- * @example
- * ```ts
- * const vector: DyFM_Vector2 = { x: 10, y: 20 };
- * ```
- */
-export interface DyFM_Vector2 {
-  /** horizontal coordinate */
-  x: number;
-  /** vertical coordinate */
-  y: number;
+
+
+
+
+
+/**
+ * Represents a 2D vector with x and y coordinates
+ * 
+ * @see {@link DyFM_Vector2_Util} for utility functions
+ * 
+ * @example
+ * ```ts
+ * const vector: DyFM_Vector2 = { x: 10, y: 20 };
+ * ```
+ */
+export interface DyFM_Vector2 {
+  /** horizontal coordinate */
+  x: number;
+  /** vertical coordinate */
+  y: number;
 }