@futdevpro/fsm-dynamo 1.16.37 → 1.16.38

package/build/_collections/constants/global-settings.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACrB,MAAM,gEAAgE,CAAC;AAIxE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBAMlC,CAAC"}
+{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,oBAAoB,EACrB,MAAM,gEAAgE,CAAC;AAIxE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,oBAUlC,CAAC"}

package/build/_collections/constants/global-settings.const.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_global_settings = void 0;
+const environment_flag_enum_1 = require("../../_enums/environment-flag.enum");
 /**
  * Default global settings for the application.
  *
@@ -13,5 +14,8 @@ exports.DyFM_global_settings = {
     systemShortCodeName: 'DyFM_UNKNOWN_SYSTEM',
     baseUrl: '/api',
     log_settings: {},
+    // FAIL-SAFE: amig senki nem allitja at, PROD-nak szamit. Igy egy elmaradt bootstrap NEM
+    // gyujtja fel a teszt-jelzeseket egy eles feluleten — a hiba iranya a "csendes", nem a "hangos".
+    environmentFlag: environment_flag_enum_1.DyFM_EnvironmentFlag.prod,
 };
 //# sourceMappingURL=global-settings.const.js.map

package/build/_collections/constants/global-settings.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":";;;AAQA;;;;;;;GAOG;AACU,QAAA,oBAAoB,GAAyB;IACxD,mBAAmB,EAAE,qBAAqB;IAE1C,OAAO,EAAE,MAAM;IAEf,YAAY,EAAE,EAAE;CACjB,CAAC"}
+{"version":3,"file":"global-settings.const.js","sourceRoot":"","sources":["../../../src/_collections/constants/global-settings.const.ts"],"names":[],"mappings":";;;AAEA,8EAA0E;AAO1E;;;;;;;GAOG;AACU,QAAA,oBAAoB,GAAyB;IACxD,mBAAmB,EAAE,qBAAqB;IAE1C,OAAO,EAAE,MAAM;IAEf,YAAY,EAAE,EAAE;IAEhB,wFAAwF;IACxF,iGAAiG;IACjG,eAAe,EAAE,4CAAoB,CAAC,IAAI;CAC3C,CAAC"}

package/build/_models/interfaces/environment/global-settings.interface.d.ts

@@ -1,3 +1,4 @@
+import { DyFM_EnvironmentFlag } from '../../../_enums/environment-flag.enum';
 import { DyFM_GlobalLog_Settings } from './global-log-settings.interface';
 /**
  *
@@ -39,5 +40,25 @@ export interface DyFM_Global_Settings {
      * 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;
 }
 //# sourceMappingURL=global-settings.interface.d.ts.map

package/build/_models/interfaces/environment/global-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_models/interfaces/environment/global-settings.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,uBAAuB,CAAC;IAEtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC"}
+{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_models/interfaces/environment/global-settings.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,uBAAuB,CAAC;IAEtC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,EAAE,oBAAoB,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.16.37",
+  "version": "01.16.38",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -287,7 +287,7 @@
     "uuid": "11.1.0"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "1.15.22",
+    "@futdevpro/dynamo-eslint": "1.15.25",
     "@types/jasmine": "~4.3.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",

package/src/_collections/constants/global-settings.const.spec.ts

@@ -0,0 +1,32 @@
+import { DyFM_EnvironmentFlag } from '../../_enums/environment-flag.enum';
+import { DyFM_global_settings } from './global-settings.const';
+
+
+/**
+ * `DyFM_global_settings.environmentFlag` — FAIL-SAFE default guard.
+ *
+ * @description MIÉRT: ez a mező a bedrock UI környezet-forrása (pl. a „TEST" ribbon a
+ *   `@futdevpro/ngx-dynamo`-ban). A default IRÁNYA biztonsági kérdés, nem ízlés:
+ *
+ *   - `prod` default → egy elmaradt bootstrap esetén a teszt-jelzés **nem** jelenik meg.
+ *     A hiba „csendes": egy teszt-rendszer jelöletlen marad.
+ *   - `test` default → egy elmaradt bootstrap esetén az ÉLES felületen villogna a „TEST"
+ *     szalag minden valódi felhasználónak. Ez nagyságrendekkel rosszabb.
+ *
+ *   Ezért a default `prod`, és ezt a guard rögzíti — hogy egy későbbi „legyen inkább test,
+ *   úgy hangosabb" ötlet ne mehessen át némán.
+ */
+describe('| DyFM_global_settings.environmentFlag (fail-safe default)', (): void => {
+
+  it('| a default PROD — ismeretlen kornyezetben NEM gyullad fel a teszt-jelzes', (): void => {
+    expect(DyFM_global_settings.environmentFlag).toBe(DyFM_EnvironmentFlag.prod);
+  });
+
+  it('| a mezo LETEZIK a globalis settingsben (a bedrock UI innen olvassa)', (): void => {
+    expect(Object.keys(DyFM_global_settings)).toContain('environmentFlag');
+  });
+
+  it('| az ertek a DyFM_EnvironmentFlag keszletbol valo', (): void => {
+    expect(Object.values(DyFM_EnvironmentFlag)).toContain(DyFM_global_settings.environmentFlag);
+  });
+});

package/src/_collections/constants/global-settings.const.ts

@@ -1,5 +1,6 @@
 
 
+import { DyFM_EnvironmentFlag } from '../../_enums/environment-flag.enum';
 import {
   DyFM_Global_Settings
 } from '../../_models/interfaces/environment/global-settings.interface';
@@ -18,7 +19,11 @@ export const DyFM_global_settings: DyFM_Global_Settings = {
   systemShortCodeName: 'DyFM_UNKNOWN_SYSTEM',
 
   baseUrl: '/api',
-  
+
   log_settings: {},
+
+  // FAIL-SAFE: amig senki nem allitja at, PROD-nak szamit. Igy egy elmaradt bootstrap NEM
+  // gyujtja fel a teszt-jelzeseket egy eles feluleten — a hiba iranya a "csendes", nem a "hangos".
+  environmentFlag: DyFM_EnvironmentFlag.prod,
 };
 

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

@@ -1,4 +1,5 @@
 
+import { DyFM_EnvironmentFlag } from '../../../_enums/environment-flag.enum';
 import { DyFM_GlobalLog_Settings } from './global-log-settings.interface';
 
 /**
@@ -44,4 +45,25 @@ export interface DyFM_Global_Settings {
    * 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;
 }