@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/src/_collections/client-safe-error.util.ts

@@ -1,107 +1,107 @@
-import { DyFM_EnvironmentFlag, DyFM_Error } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from './global-settings.const';
-
-/**
- * Kliens-safe error-body SSOT (BFR-FDPAUTHSERVICE-002 — error-response info-disclosure fix).
- *
- * A DyFM_Error HTTP-response-ba szerializálásakor a belső diagnosztikai mezők NEM mehetnek ki a
- * kliensre — env-FÜGGETLENÜL (a korábbi prod-only strip a test/dev környezetben TELJES leaket
- * hagyott: `__localStack` stack-trace, `___systemVersion`, issuer-lánc). A strip-szabályok:
- *
- *   1. MINDIG ki (env-független, kliens sehol nem fogyasztja → 0 regresszió):
- *      `__localStack`, `stack`, `___systemVersion`, `___issuer`, `___issuerSystem`,
- *      `___issuerService`, `confidentialContent`, `error`, `errors` (a nyers belső error-lánc
- *      stack-eket hordoz), `_messages` (QA2-005: technikai message-lánc — belső URL-ek, DB-hibák).
- *   2. CSAK prod-ban ki: `additionalContent` — test/dev környezetben a diagnosztikai state-snapshot
- *      szándékosan kimegy (a hibafelület-debug erre épül), prod-ban nem. KIVÉTEL (QA2-005):
- *      az `additionalContent.requestDebug` (FR-071 header-lista/belső-IP snapshot) env-FÜGGETLENÜL
- *      strip-elve — csak az error-store-ba perzisztálódik.
- *   3. MARAD (kliens-kompatibilitás — a FDP-kliens error-interceptorok fogyasztják):
- *      `_message`, `_errorCodes`, `__userMessage`, `___status`, `level`. QA2-005: a `_message`
- *      TARTALMA a user-safe `__userMessage`-re cserélve (a technikai üzenet — belső BE-BE URL,
- *      nyers Mongo E11000 — nem hagyhatja el a szervert; a mező-ALAK a kliens-kompat miatt marad).
- *
- * NEM-DyFM error (plain Error / axios-error / bármi más): minimál `{ message }` shape — a plain
- * Error eddig is üres `{}`-ként szerializálódott (non-enumerable mezők), az axios-jellegű error-ok
- * viszont enumerable config/request mezőkben auth-headert is szivárogtathatnak → fail-safe minimál.
- *
- * ⚠️ A metódus MUTÁLJA a kapott DyFM_Error-t (a meglévő endpoint-strip precedensét követve) —
- * a hívási pont a response-küldés, ahol az error-objektum életciklusa véget ér.
- */
-export class DyNTS_ClientSafeError_Util {
-
-  /** A MINDIG strip-elendő DyFM-mezők (env-független — kliens-fogyasztás nélküli leak-vektorok). */
-  private static readonly alwaysStripKeys: string[] = [
-    '__localStack',
-    'stack',
-    '___systemVersion',
-    '___issuer',
-    '___issuerSystem',
-    '___issuerService',
-    'confidentialContent',
-    'error',
-    'errors',
-    // QA2-005 (dynamo-builder MP-23 QA-gate, 2026-07-18): a technikai message-LÁNC — belső BE-BE
-    // URL-eket (pl. http://auth-service:39005/...), nyers DB-driver-hibákat (Mongo E11000) hordoz;
-    // a kliens nem fogyasztja (a display-lánc `__userMessage` → `_message`), az error-store-ban marad.
-    '_messages',
-  ];
-
-  /** QA2-005 — generikus `_message` fallback, ha az errornak nincs `__userMessage`-e. */
-  private static readonly genericClientMessage: string =
-    'An internal error occurred.\nPlease contact the responsible development team.';
-
-  /**
-   * Az error kliens-safe formára hozása a HTTP-response-küldés előtt.
-   * DyFM_Error: in-place strip (1-3. szabályok szerint); nem-DyFM object: minimál `{ message }`.
-   */
-  static toClientSafe(error: unknown): unknown {
-    // DyFM_Error: célzott mező-strip, a kliens-fogyasztott mezők megtartásával
-    if (DyFM_Error.isDyFMError(error)) {
-      const dyError: Record<string, unknown> = error as unknown as Record<string, unknown>;
-
-      for (const key of DyNTS_ClientSafeError_Util.alwaysStripKeys) {
-        delete dyError[key];
-      }
-
-      // ═══════════════════════════════════════════════════════════════════════
-      // QA2-005 — info-disclosure vágás env-FÜGGETLENÜL (test-env-ben SEM mehet ki):
-      //   a) `_message` (technikai üzenet): belső BE-BE URL-t / nyers Mongo-hibát hordozhat →
-      //      a response-ban a user-safe `__userMessage`-dzsel helyettesítjük. A mező ALAKJA
-      //      megmarad (a kliens-interceptorok / `DyFM_extractErrorMessage` fallback-lánca és a
-      //      `_message`-jelenlét-heurisztikák változatlanul működnek); a TELJES technikai üzenet
-      //      az error-store-ban marad (a globalErrorHandler a strip ELŐTT perzisztál).
-      //   b) `additionalContent.requestDebug` (FR-071 request-snapshot: header-kulcs-lista,
-      //      belső IP, params/query): csak az error-store-ba — a response-ból mindig kimarad;
-      //      az additionalContent TÖBBI (app-szintű diagnosztikai) mezője non-prod env-ben marad.
-      // ═══════════════════════════════════════════════════════════════════════
-      const userMessage: unknown = dyError['__userMessage'];
-
-      dyError['_message'] = (typeof userMessage === 'string' && userMessage)
-        ? userMessage
-        : DyNTS_ClientSafeError_Util.genericClientMessage;
-
-      const additionalContent: unknown = dyError['additionalContent'];
-
-      if (additionalContent && typeof additionalContent === 'object') {
-        delete (additionalContent as Record<string, unknown>)['requestDebug'];
-      }
-
-      // prod: a diagnosztikai state-snapshot sem megy ki; test/dev: szándékosan marad (debug-UX)
-      if (DyNTS_global_settings.env_settings.environment === DyFM_EnvironmentFlag.prod) {
-        delete dyError['additionalContent'];
-      }
-
-      return error;
-    }
-
-    // nem-DyFM object-error (plain/axios/egyéb): fail-safe minimál shape — a nyers objektum
-    // enumerable mezői (pl. axios config.headers) szivárogtathatnak
-    if (error && typeof error === 'object') {
-      return { message: (error as Error).message ?? 'Internal server error' };
-    }
-
-    return error;
-  }
-}
+import { DyFM_EnvironmentFlag, DyFM_Error } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from './global-settings.const';
+
+/**
+ * Kliens-safe error-body SSOT (BFR-FDPAUTHSERVICE-002 — error-response info-disclosure fix).
+ *
+ * A DyFM_Error HTTP-response-ba szerializálásakor a belső diagnosztikai mezők NEM mehetnek ki a
+ * kliensre — env-FÜGGETLENÜL (a korábbi prod-only strip a test/dev környezetben TELJES leaket
+ * hagyott: `__localStack` stack-trace, `___systemVersion`, issuer-lánc). A strip-szabályok:
+ *
+ *   1. MINDIG ki (env-független, kliens sehol nem fogyasztja → 0 regresszió):
+ *      `__localStack`, `stack`, `___systemVersion`, `___issuer`, `___issuerSystem`,
+ *      `___issuerService`, `confidentialContent`, `error`, `errors` (a nyers belső error-lánc
+ *      stack-eket hordoz), `_messages` (QA2-005: technikai message-lánc — belső URL-ek, DB-hibák).
+ *   2. CSAK prod-ban ki: `additionalContent` — test/dev környezetben a diagnosztikai state-snapshot
+ *      szándékosan kimegy (a hibafelület-debug erre épül), prod-ban nem. KIVÉTEL (QA2-005):
+ *      az `additionalContent.requestDebug` (FR-071 header-lista/belső-IP snapshot) env-FÜGGETLENÜL
+ *      strip-elve — csak az error-store-ba perzisztálódik.
+ *   3. MARAD (kliens-kompatibilitás — a FDP-kliens error-interceptorok fogyasztják):
+ *      `_message`, `_errorCodes`, `__userMessage`, `___status`, `level`. QA2-005: a `_message`
+ *      TARTALMA a user-safe `__userMessage`-re cserélve (a technikai üzenet — belső BE-BE URL,
+ *      nyers Mongo E11000 — nem hagyhatja el a szervert; a mező-ALAK a kliens-kompat miatt marad).
+ *
+ * NEM-DyFM error (plain Error / axios-error / bármi más): minimál `{ message }` shape — a plain
+ * Error eddig is üres `{}`-ként szerializálódott (non-enumerable mezők), az axios-jellegű error-ok
+ * viszont enumerable config/request mezőkben auth-headert is szivárogtathatnak → fail-safe minimál.
+ *
+ * ⚠️ A metódus MUTÁLJA a kapott DyFM_Error-t (a meglévő endpoint-strip precedensét követve) —
+ * a hívási pont a response-küldés, ahol az error-objektum életciklusa véget ér.
+ */
+export class DyNTS_ClientSafeError_Util {
+
+  /** A MINDIG strip-elendő DyFM-mezők (env-független — kliens-fogyasztás nélküli leak-vektorok). */
+  private static readonly alwaysStripKeys: string[] = [
+    '__localStack',
+    'stack',
+    '___systemVersion',
+    '___issuer',
+    '___issuerSystem',
+    '___issuerService',
+    'confidentialContent',
+    'error',
+    'errors',
+    // QA2-005 (dynamo-builder MP-23 QA-gate, 2026-07-18): a technikai message-LÁNC — belső BE-BE
+    // URL-eket (pl. http://auth-service:39005/...), nyers DB-driver-hibákat (Mongo E11000) hordoz;
+    // a kliens nem fogyasztja (a display-lánc `__userMessage` → `_message`), az error-store-ban marad.
+    '_messages',
+  ];
+
+  /** QA2-005 — generikus `_message` fallback, ha az errornak nincs `__userMessage`-e. */
+  private static readonly genericClientMessage: string =
+    'An internal error occurred.\nPlease contact the responsible development team.';
+
+  /**
+   * Az error kliens-safe formára hozása a HTTP-response-küldés előtt.
+   * DyFM_Error: in-place strip (1-3. szabályok szerint); nem-DyFM object: minimál `{ message }`.
+   */
+  static toClientSafe(error: unknown): unknown {
+    // DyFM_Error: célzott mező-strip, a kliens-fogyasztott mezők megtartásával
+    if (DyFM_Error.isDyFMError(error)) {
+      const dyError: Record<string, unknown> = error as unknown as Record<string, unknown>;
+
+      for (const key of DyNTS_ClientSafeError_Util.alwaysStripKeys) {
+        delete dyError[key];
+      }
+
+      // ═══════════════════════════════════════════════════════════════════════
+      // QA2-005 — info-disclosure vágás env-FÜGGETLENÜL (test-env-ben SEM mehet ki):
+      //   a) `_message` (technikai üzenet): belső BE-BE URL-t / nyers Mongo-hibát hordozhat →
+      //      a response-ban a user-safe `__userMessage`-dzsel helyettesítjük. A mező ALAKJA
+      //      megmarad (a kliens-interceptorok / `DyFM_extractErrorMessage` fallback-lánca és a
+      //      `_message`-jelenlét-heurisztikák változatlanul működnek); a TELJES technikai üzenet
+      //      az error-store-ban marad (a globalErrorHandler a strip ELŐTT perzisztál).
+      //   b) `additionalContent.requestDebug` (FR-071 request-snapshot: header-kulcs-lista,
+      //      belső IP, params/query): csak az error-store-ba — a response-ból mindig kimarad;
+      //      az additionalContent TÖBBI (app-szintű diagnosztikai) mezője non-prod env-ben marad.
+      // ═══════════════════════════════════════════════════════════════════════
+      const userMessage: unknown = dyError['__userMessage'];
+
+      dyError['_message'] = (typeof userMessage === 'string' && userMessage)
+        ? userMessage
+        : DyNTS_ClientSafeError_Util.genericClientMessage;
+
+      const additionalContent: unknown = dyError['additionalContent'];
+
+      if (additionalContent && typeof additionalContent === 'object') {
+        delete (additionalContent as Record<string, unknown>)['requestDebug'];
+      }
+
+      // prod: a diagnosztikai state-snapshot sem megy ki; test/dev: szándékosan marad (debug-UX)
+      if (DyNTS_global_settings.env_settings.environment === DyFM_EnvironmentFlag.prod) {
+        delete dyError['additionalContent'];
+      }
+
+      return error;
+    }
+
+    // nem-DyFM object-error (plain/axios/egyéb): fail-safe minimál shape — a nyers objektum
+    // enumerable mezői (pl. axios config.headers) szivárogtathatnak
+    if (error && typeof error === 'object') {
+      return { message: (error as Error).message ?? 'Internal server error' };
+    }
+
+    return error;
+  }
+}

package/src/_collections/default-fallback-cache-max-age.const.spec.ts

@@ -1,11 +1,11 @@
-import { DyNTS_defaultFallbackCacheMaxAge } from './default-fallback-cache-max-age.const';
-
-describe('| DyNTS_defaultFallbackCacheMaxAge', () => {
-  it('| should export default fallback cache max-age as 0', () => {
-    expect(DyNTS_defaultFallbackCacheMaxAge).toBe(0);
-  });
-
-  it('| should be a number', () => {
-    expect(typeof DyNTS_defaultFallbackCacheMaxAge).toBe('number');
-  });
-});
+import { DyNTS_defaultFallbackCacheMaxAge } from './default-fallback-cache-max-age.const';
+
+describe('| DyNTS_defaultFallbackCacheMaxAge', () => {
+  it('| should export default fallback cache max-age as 0', () => {
+    expect(DyNTS_defaultFallbackCacheMaxAge).toBe(0);
+  });
+
+  it('| should be a number', () => {
+    expect(typeof DyNTS_defaultFallbackCacheMaxAge).toBe('number');
+  });
+});

package/src/_collections/default-fallback-cache-max-age.const.ts

@@ -1,2 +1,2 @@
-/** SPA fallback (pl. index.html) alapértelmezett cache max-age másodpercben (0 = ne cache-eljük). */
-export const DyNTS_defaultFallbackCacheMaxAge: number = 0;
+/** SPA fallback (pl. index.html) alapértelmezett cache max-age másodpercben (0 = ne cache-eljük). */
+export const DyNTS_defaultFallbackCacheMaxAge: number = 0;

package/src/_collections/default-not-found-page.const.spec.ts

@@ -1,19 +1,19 @@
-import { DyNTS_defaultNotFoundPageHtml } from './default-not-found-page.const';
-
-describe('| DyNTS_defaultNotFoundPageHtml', () => {
-  it('| should export a non-empty HTML string', () => {
-    expect(typeof DyNTS_defaultNotFoundPageHtml).toBe('string');
-    expect(DyNTS_defaultNotFoundPageHtml.length).toBeGreaterThan(0);
-  });
-
-  it('| should contain DOCTYPE and Page not found', () => {
-    expect(DyNTS_defaultNotFoundPageHtml).toContain('<!DOCTYPE html>');
-    expect(DyNTS_defaultNotFoundPageHtml).toContain('Page not found');
-    expect(DyNTS_defaultNotFoundPageHtml).toContain('</html>');
-  });
-
-  it('| should be valid for 404 response as text/html', () => {
-    expect(DyNTS_defaultNotFoundPageHtml).toContain('lang="en"');
-    expect(DyNTS_defaultNotFoundPageHtml).toContain('<title>');
-  });
-});
+import { DyNTS_defaultNotFoundPageHtml } from './default-not-found-page.const';
+
+describe('| DyNTS_defaultNotFoundPageHtml', () => {
+  it('| should export a non-empty HTML string', () => {
+    expect(typeof DyNTS_defaultNotFoundPageHtml).toBe('string');
+    expect(DyNTS_defaultNotFoundPageHtml.length).toBeGreaterThan(0);
+  });
+
+  it('| should contain DOCTYPE and Page not found', () => {
+    expect(DyNTS_defaultNotFoundPageHtml).toContain('<!DOCTYPE html>');
+    expect(DyNTS_defaultNotFoundPageHtml).toContain('Page not found');
+    expect(DyNTS_defaultNotFoundPageHtml).toContain('</html>');
+  });
+
+  it('| should be valid for 404 response as text/html', () => {
+    expect(DyNTS_defaultNotFoundPageHtml).toContain('lang="en"');
+    expect(DyNTS_defaultNotFoundPageHtml).toContain('<title>');
+  });
+});

package/src/_collections/default-not-found-page.const.ts

@@ -1,22 +1,22 @@
-/**
- * Alapértelmezett "Page not found" (404) HTML, amit a static client default fallbackjaként
- * szolgálunk ki, ha nincs fallbackPath (nem-SPA mód) és a kérés nem egy létező static fájlra mutat.
- */
-export const DyNTS_defaultNotFoundPageHtml: string =
-  '<!DOCTYPE html>\n' +
-  '<html lang="en">\n' +
-  '<head>\n' +
-  '  <meta charset="utf-8">\n' +
-  '  <meta name="viewport" content="width=device-width, initial-scale=1">\n' +
-  '  <title>Page not found</title>\n' +
-  '  <style>\n' +
-  '    body { font-family: system-ui, sans-serif; margin: 2rem; text-align: center; }\n' +
-  '    h1 { font-size: 1.5rem; color: #333; }\n' +
-  '    p { color: #666; }\n' +
-  '  </style>\n' +
-  '</head>\n' +
-  '<body>\n' +
-  '  <h1>Page not found</h1>\n' +
-  '  <p>The requested resource could not be found.</p>\n' +
-  '</body>\n' +
-  '</html>\n';
+/**
+ * Alapértelmezett "Page not found" (404) HTML, amit a static client default fallbackjaként
+ * szolgálunk ki, ha nincs fallbackPath (nem-SPA mód) és a kérés nem egy létező static fájlra mutat.
+ */
+export const DyNTS_defaultNotFoundPageHtml: string =
+  '<!DOCTYPE html>\n' +
+  '<html lang="en">\n' +
+  '<head>\n' +
+  '  <meta charset="utf-8">\n' +
+  '  <meta name="viewport" content="width=device-width, initial-scale=1">\n' +
+  '  <title>Page not found</title>\n' +
+  '  <style>\n' +
+  '    body { font-family: system-ui, sans-serif; margin: 2rem; text-align: center; }\n' +
+  '    h1 { font-size: 1.5rem; color: #333; }\n' +
+  '    p { color: #666; }\n' +
+  '  </style>\n' +
+  '</head>\n' +
+  '<body>\n' +
+  '  <h1>Page not found</h1>\n' +
+  '  <p>The requested resource could not be found.</p>\n' +
+  '</body>\n' +
+  '</html>\n';

package/src/_collections/default-socket-path.const.spec.ts

@@ -1,12 +1,12 @@
-import { DyNTS_defaultSocketPath } from './default-socket-path.const';
-
-describe('| DyNTS_defaultSocketPath', () => {
-  it('| should export default socket path as \'/socket\'', () => {
-    expect(DyNTS_defaultSocketPath).toBe('/socket');
-  });
-
-  it('| should be a non-empty string', () => {
-    expect(typeof DyNTS_defaultSocketPath).toBe('string');
-    expect(DyNTS_defaultSocketPath.length).toBeGreaterThan(0);
-  });
-});
+import { DyNTS_defaultSocketPath } from './default-socket-path.const';
+
+describe('| DyNTS_defaultSocketPath', () => {
+  it('| should export default socket path as \'/socket\'', () => {
+    expect(DyNTS_defaultSocketPath).toBe('/socket');
+  });
+
+  it('| should be a non-empty string', () => {
+    expect(typeof DyNTS_defaultSocketPath).toBe('string');
+    expect(DyNTS_defaultSocketPath.length).toBeGreaterThan(0);
+  });
+});

package/src/_collections/default-socket-path.const.ts

@@ -1,2 +1,2 @@
-/** Default Socket.IO path, ha a portSettings.socketPath nincs megadva. */
-export const DyNTS_defaultSocketPath: string = '/socket';
+/** Default Socket.IO path, ha a portSettings.socketPath nincs megadva. */
+export const DyNTS_defaultSocketPath: string = '/socket';