@futdevpro/fsm-dynamo 1.16.37 → 1.16.39

package/build/_models/data-models/metadata.data-model.js

@@ -1,122 +1,122 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_Metadata = void 0;
-/**
- * This class is the base class for all data models.
- * It contains the metadata for the data model.
- *
- * @example
- * ```ts
- * const metadata: DyFM_Metadata = new DyFM_Metadata({
- *   _id: '123',
- * });
- * ```
- */
-class DyFM_Metadata {
-    _id;
-    __created;
-    __createdBy;
-    __lastModified;
-    __lastModifiedBy;
-    __v;
-    _deleted;
-    _deletedBy;
-    _archived;
-    //_archivedBy?: string;
-    //_archiveId?: string;
-    _originalId;
-    constructor(set, init) {
-        // a metadata-init logika a statikus applyMetadata-ban el — igy a `DyFM_Error extends Error`
-        // (ami NEM tudja super()-rel hivni ezt a constructort) ugyanezt a target-en futtathatja.
-        DyFM_Metadata.applyMetadata(this, set, init);
-    }
-    /**
-     * Applies the metadata fields onto a target object.
-     *
-     * Kiemelt statikus a constructor-torzsbol: a viselkedes BIT-RE azonos a korabbi
-     * constructorral, de igy a `DyFM_Error extends Error implements DyFM_Metadata` is meg
-     * tudja hivni (az Error-bol orokolt osztaly nem tud `super(set, init)`-tel a
-     * DyFM_Metadata constructorba lepni, ezert target-alapon kell elerni az init-logikat).
-     *
-     * @param target - The object the metadata fields are written onto (`this`)
-     * @param set - The source metadata to copy from
-     * @param init - Optional id + issuer defaults
-     */
-    static applyMetadata(target, set, init) {
-        if (set) {
-            if (!set._id && set._id !== undefined) {
-                set._id = undefined;
-            }
-            target._id = set._id;
-            target.__created = set.__created;
-            target.__createdBy = set.__createdBy;
-            target.__lastModified = set.__lastModified;
-            target.__lastModifiedBy = set.__lastModifiedBy;
-            target.__v = set.__v;
-            if (set._archived) {
-                target._archived = set._archived;
-                target._originalId = set._originalId;
-            }
-        }
-        if (!target.__created) {
-            target.__created = new Date();
-        }
-        if (!target.__lastModified) {
-            target.__lastModified = new Date();
-        }
-        if (!target.__v) {
-            target.__v = 0;
-        }
-        if (init) {
-            if (!target._id && init?.id) {
-                target._id = init.id;
-            }
-            if (init?.issuer) {
-                if (!target.__createdBy) {
-                    target.__createdBy = init.issuer;
-                }
-                if (!target.__lastModifiedBy) {
-                    target.__lastModifiedBy = init.issuer;
-                }
-            }
-        }
-    }
-    /**
-     * Updates the metadata of a data model
-     * @param data - The data model to update
-     * @param issuer - The issuer of the data model
-     * @param id - The id of the data model
-     * @returns The updated data model
-     *
-     * @example
-     * ```ts
-     * const metadata: DyFM_Metadata = new DyFM_Metadata({
-     *   _id: '123',
-     * });
-     * const updatedMetadata = DyFM_Metadata.updateMetadata(metadata, 'user', '456');
-     * ```
-     */
-    static updateMetadata(data, issuer, id) {
-        if (!data) {
-            return data;
-        }
-        if (data._deleted) {
-            throw new Error('Cannot update metadata of deleted data');
-        }
-        if (!data._id && id) {
-            data._id = id;
-        }
-        if (!data.__created) {
-            data.__created = new Date();
-        }
-        if (!data.__createdBy) {
-            data.__createdBy = issuer;
-        }
-        data.__lastModified = new Date();
-        data.__lastModifiedBy = issuer;
-        data.__v = data.__v ? data.__v + 1 : 1;
-        return data;
-    }
-}
-exports.DyFM_Metadata = DyFM_Metadata;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_Metadata = void 0;
+/**
+ * This class is the base class for all data models.
+ * It contains the metadata for the data model.
+ *
+ * @example
+ * ```ts
+ * const metadata: DyFM_Metadata = new DyFM_Metadata({
+ *   _id: '123',
+ * });
+ * ```
+ */
+class DyFM_Metadata {
+    _id;
+    __created;
+    __createdBy;
+    __lastModified;
+    __lastModifiedBy;
+    __v;
+    _deleted;
+    _deletedBy;
+    _archived;
+    //_archivedBy?: string;
+    //_archiveId?: string;
+    _originalId;
+    constructor(set, init) {
+        // a metadata-init logika a statikus applyMetadata-ban el — igy a `DyFM_Error extends Error`
+        // (ami NEM tudja super()-rel hivni ezt a constructort) ugyanezt a target-en futtathatja.
+        DyFM_Metadata.applyMetadata(this, set, init);
+    }
+    /**
+     * Applies the metadata fields onto a target object.
+     *
+     * Kiemelt statikus a constructor-torzsbol: a viselkedes BIT-RE azonos a korabbi
+     * constructorral, de igy a `DyFM_Error extends Error implements DyFM_Metadata` is meg
+     * tudja hivni (az Error-bol orokolt osztaly nem tud `super(set, init)`-tel a
+     * DyFM_Metadata constructorba lepni, ezert target-alapon kell elerni az init-logikat).
+     *
+     * @param target - The object the metadata fields are written onto (`this`)
+     * @param set - The source metadata to copy from
+     * @param init - Optional id + issuer defaults
+     */
+    static applyMetadata(target, set, init) {
+        if (set) {
+            if (!set._id && set._id !== undefined) {
+                set._id = undefined;
+            }
+            target._id = set._id;
+            target.__created = set.__created;
+            target.__createdBy = set.__createdBy;
+            target.__lastModified = set.__lastModified;
+            target.__lastModifiedBy = set.__lastModifiedBy;
+            target.__v = set.__v;
+            if (set._archived) {
+                target._archived = set._archived;
+                target._originalId = set._originalId;
+            }
+        }
+        if (!target.__created) {
+            target.__created = new Date();
+        }
+        if (!target.__lastModified) {
+            target.__lastModified = new Date();
+        }
+        if (!target.__v) {
+            target.__v = 0;
+        }
+        if (init) {
+            if (!target._id && init?.id) {
+                target._id = init.id;
+            }
+            if (init?.issuer) {
+                if (!target.__createdBy) {
+                    target.__createdBy = init.issuer;
+                }
+                if (!target.__lastModifiedBy) {
+                    target.__lastModifiedBy = init.issuer;
+                }
+            }
+        }
+    }
+    /**
+     * Updates the metadata of a data model
+     * @param data - The data model to update
+     * @param issuer - The issuer of the data model
+     * @param id - The id of the data model
+     * @returns The updated data model
+     *
+     * @example
+     * ```ts
+     * const metadata: DyFM_Metadata = new DyFM_Metadata({
+     *   _id: '123',
+     * });
+     * const updatedMetadata = DyFM_Metadata.updateMetadata(metadata, 'user', '456');
+     * ```
+     */
+    static updateMetadata(data, issuer, id) {
+        if (!data) {
+            return data;
+        }
+        if (data._deleted) {
+            throw new Error('Cannot update metadata of deleted data');
+        }
+        if (!data._id && id) {
+            data._id = id;
+        }
+        if (!data.__created) {
+            data.__created = new Date();
+        }
+        if (!data.__createdBy) {
+            data.__createdBy = issuer;
+        }
+        data.__lastModified = new Date();
+        data.__lastModifiedBy = issuer;
+        data.__v = data.__v ? data.__v + 1 : 1;
+        return data;
+    }
+}
+exports.DyFM_Metadata = DyFM_Metadata;
 //# sourceMappingURL=metadata.data-model.js.map

package/build/_models/data-models/metadata.data-model.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata.data-model.spec.d.ts.map

package/build/_models/data-models/metadata.data-model.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.data-model.spec.d.ts","sourceRoot":"","sources":["../../../src/_models/data-models/metadata.data-model.spec.ts"],"names":[],"mappings":""}

package/build/_models/data-models/metadata.data-model.spec.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const metadata_data_model_1 = require("./metadata.data-model");
+describe('| DyFM_Metadata', () => {
+    it('| should create an instance without initial data', () => {
+        const instance = new metadata_data_model_1.DyFM_Metadata();
+        expect(instance).toBeTruthy();
+        expect(instance.__created).toBeInstanceOf(Date);
+        expect(instance.__lastModified).toBeInstanceOf(Date);
+        expect(instance.__v).toBe(0);
+    });
+    it('| should create an instance with initial data', () => {
+        const initialData = {
+            _id: 'test-id',
+            __created: new Date('2023-01-01'),
+            __createdBy: 'user1',
+            __lastModified: new Date('2023-01-02'),
+            __lastModifiedBy: 'user2',
+            __v: 1
+        };
+        const instance = new metadata_data_model_1.DyFM_Metadata(initialData);
+        expect(instance._id).toBe('test-id');
+        expect(instance.__created).toEqual(new Date('2023-01-01'));
+        expect(instance.__createdBy).toBe('user1');
+        expect(instance.__lastModified).toEqual(new Date('2023-01-02'));
+        expect(instance.__lastModifiedBy).toBe('user2');
+        expect(instance.__v).toBe(1);
+    });
+    it('| should set default values when not provided', () => {
+        const instance = new metadata_data_model_1.DyFM_Metadata({});
+        expect(instance.__created).toBeInstanceOf(Date);
+        expect(instance.__lastModified).toBeInstanceOf(Date);
+        expect(instance.__v).toBe(0);
+    });
+    it('| should handle init parameter with id and issuer', () => {
+        const instance = new metadata_data_model_1.DyFM_Metadata(undefined, {
+            id: 'init-id',
+            issuer: 'init-user'
+        });
+        expect(instance._id).toBe('init-id');
+        expect(instance.__createdBy).toBe('init-user');
+        expect(instance.__lastModifiedBy).toBe('init-user');
+    });
+    it('| should not override existing _id with init id', () => {
+        const instance = new metadata_data_model_1.DyFM_Metadata({ _id: 'existing-id' }, { id: 'init-id', issuer: 'user' });
+        expect(instance._id).toBe('existing-id');
+    });
+    it('| should not override existing __createdBy with init issuer', () => {
+        const instance = new metadata_data_model_1.DyFM_Metadata({ __createdBy: 'existing-user' }, { issuer: 'init-user' });
+        expect(instance.__createdBy).toBe('existing-user');
+    });
+    it('| should handle archived data', () => {
+        const archivedDate = new Date('2023-01-01');
+        const instance = new metadata_data_model_1.DyFM_Metadata({
+            _archived: archivedDate,
+            _originalId: 'original-id'
+        });
+        expect(instance._archived).toEqual(archivedDate);
+        expect(instance._originalId).toBe('original-id');
+    });
+    it('| should handle deleted data', () => {
+        const deletedDate = new Date('2023-01-01');
+        const instance = new metadata_data_model_1.DyFM_Metadata({
+            _deleted: deletedDate,
+            _deletedBy: 'deleter'
+        });
+        instance._deleted = deletedDate;
+        instance._deletedBy = 'deleter';
+        expect(instance._deleted).toEqual(deletedDate);
+        expect(instance._deletedBy).toBe('deleter');
+    });
+    it('| should set _id to undefined when _id is falsy but not undefined', () => {
+        // Test case for line 40-42: if (!set._id && set._id !== undefined)
+        // This happens when _id is null, empty string, 0, false, etc.
+        const instance1 = new metadata_data_model_1.DyFM_Metadata({ _id: null });
+        expect(instance1._id).toBeUndefined();
+        const instance2 = new metadata_data_model_1.DyFM_Metadata({ _id: '' });
+        expect(instance2._id).toBeUndefined();
+        const instance3 = new metadata_data_model_1.DyFM_Metadata({ _id: 0 });
+        expect(instance3._id).toBeUndefined();
+    });
+    describe('| updateMetadata', () => {
+        it('| should update metadata correctly', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata();
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater', 'new-id');
+            expect(updated._id).toBe('new-id');
+            expect(updated.__createdBy).toBe('updater');
+            expect(updated.__lastModifiedBy).toBe('updater');
+            expect(updated.__lastModified).toBeInstanceOf(Date);
+            expect(updated.__v).toBe(1);
+        });
+        it('| should increment version on update', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ __v: 5 });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated.__v).toBe(6);
+        });
+        it('| should set version to 1 if not present', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ __v: undefined });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated.__v).toBe(1);
+        });
+        it('| should not override existing _id if id not provided', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ _id: 'existing-id' });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated._id).toBe('existing-id');
+        });
+        it('| should set _id if not present and id provided', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ _id: undefined });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater', 'new-id');
+            expect(updated._id).toBe('new-id');
+        });
+        it('| should throw error when updating deleted data', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ _deleted: new Date() });
+            data._deleted = new Date();
+            expect(() => {
+                metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            }).toThrowError('Cannot update metadata of deleted data');
+        });
+        it('| should return data as-is if data is null', () => {
+            const result = metadata_data_model_1.DyFM_Metadata.updateMetadata(null, 'updater');
+            expect(result).toBeNull();
+        });
+        it('| should set __created if not present', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ __created: undefined });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated.__created).toBeInstanceOf(Date);
+        });
+        it('| should set __createdBy if not present', () => {
+            const data = new metadata_data_model_1.DyFM_Metadata({ __createdBy: undefined });
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated.__createdBy).toBe('updater');
+        });
+        it('| should set __created if not present (branch coverage)', () => {
+            // Test case for line 114-116: if (!data.__created)
+            const data = new metadata_data_model_1.DyFM_Metadata();
+            data.__created = undefined;
+            const updated = metadata_data_model_1.DyFM_Metadata.updateMetadata(data, 'updater');
+            expect(updated.__created).toBeInstanceOf(Date);
+        });
+    });
+});
+//# sourceMappingURL=metadata.data-model.spec.js.map

package/build/_models/data-models/metadata.data-model.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.data-model.spec.js","sourceRoot":"","sources":["../../../src/_models/data-models/metadata.data-model.spec.ts"],"names":[],"mappings":"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"}

package/build/_models/interfaces/box-bounds.interface.d.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;
+}
 //# sourceMappingURL=box-bounds.interface.d.ts.map

package/build/_models/interfaces/box-bounds.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=box-bounds.interface.js.map

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

@@ -1,66 +1,66 @@
-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;
+}
 //# sourceMappingURL=global-log-settings.interface.d.ts.map

package/build/_models/interfaces/environment/global-log-settings.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=global-log-settings.interface.js.map

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/build/_models/interfaces/environment/global-settings.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=global-settings.interface.js.map

package/build/_models/interfaces/error-defaults.interface.d.ts

@@ -1,17 +1,17 @@
-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;
+}
 //# sourceMappingURL=error-defaults.interface.d.ts.map

package/build/_models/interfaces/error-defaults.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=error-defaults.interface.js.map