@futdevpro/nts-dynamo 1.15.151 → 1.15.153

package/src/_modules/test-email-sink/index.ts

@@ -1,11 +1,11 @@
-/**
- * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK modul.
- *
- * A local/test kornyezetben a kanonikus teszt-cim-mintara (`*@e2e.test.futdevpro.local`) meno emailek
- * SMTP helyett DB-be kerulnek, es a `/e2e/sent-mail` read-endpointon olvashatok (verif-link kinyerheto).
- */
-export * from './_collections/test-email-pattern.const';
-export * from './_models/data-models/dynts-sent-test-mail.data-model';
-export * from './_services/dynts-test-email-sink.service';
-export * from './test-email-sink.controller';
-export * from './get-sent-mail-routing-module.util';
+/**
+ * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK modul.
+ *
+ * A local/test kornyezetben a kanonikus teszt-cim-mintara (`*@e2e.test.futdevpro.local`) meno emailek
+ * SMTP helyett DB-be kerulnek, es a `/e2e/sent-mail` read-endpointon olvashatok (verif-link kinyerheto).
+ */
+export * from './_collections/test-email-pattern.const';
+export * from './_models/data-models/dynts-sent-test-mail.data-model';
+export * from './_services/dynts-test-email-sink.service';
+export * from './test-email-sink.controller';
+export * from './get-sent-mail-routing-module.util';

package/src/_modules/test-email-sink/test-email-sink.controller.ts

@@ -1,83 +1,83 @@
-import { Request, Response } from 'express';
-
-import { DyFM_EnvironmentFlag, DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-import { DyNTS_TestEmailSink_Service } from './_services/dynts-test-email-sink.service';
-import { DyNTS_SentTestMail } from './_models/data-models/dynts-sent-test-mail.data-model';
-
-/**
- * A sent-mail read-endpoint konfigja — az authPreProcess a fogyaszto sajat vedelme (pl. az
- * auth-service `validateE2EKey`-e, X-E2E-KEY headerrel). ERŐSEN ajanlott megadni.
- */
-export interface DyNTS_TestEmailSinkController_Config {
-  /** Opcionalis auth preprocess (pl. validateE2EKey). Ha nincs → csak az env-gate ved. */
-  authPreProcess?: (req: Request, res: Response) => Promise<void>;
-}
-
-/**
- * BFR-MASTERPROMPTER-015 (MP-19) — sent-mail READ controller.
- *
- * GET /get?to=<cim>&since=<ISO>&limit=<n> → a sink-elt teszt-emailek (legfrissebb elol), a HTML-bol
- * kinyert `links` tombbel (pl. verifikacios link). KETTOS vedelem: (1) a fogyaszto authPreProcess-e
- * (X-E2E-KEY), (2) beepitett HARD env-gate — prod/dev kornyezetben MINDIG 403, konfigtol fuggetlenul.
- */
-export class DyNTS_TestEmailSink_Controller extends DyNTS_Controller {
-
-  private static config: DyNTS_TestEmailSinkController_Config = {};
-
-  static configure(config: DyNTS_TestEmailSinkController_Config): void {
-    DyNTS_TestEmailSink_Controller.config = config;
-  }
-
-  static getInstance(): DyNTS_TestEmailSink_Controller {
-    return DyNTS_TestEmailSink_Controller.getSingletonInstance();
-  }
-
-  setupEndpoints(): void {
-    const preProcesses: ((req: Request, res: Response) => Promise<void>)[] = [];
-    if (DyNTS_TestEmailSink_Controller.config.authPreProcess) {
-      preProcesses.push(DyNTS_TestEmailSink_Controller.config.authPreProcess);
-    }
-
-    this.endpoints = [
-      new DyNTS_Endpoint_Params({
-        name: 'getSentTestMails',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/get',
-        preProcesses: preProcesses,
-        logRequest: false,
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            // HARD env-gate: a teszt-emailek TARTALMA (verif-linkek!) prod-on sosem olvashato.
-            if (![ DyFM_EnvironmentFlag.local, DyFM_EnvironmentFlag.test ]
-              .includes(DyNTS_global_settings.env_settings.environment)) {
-              res.status(403).send({ error: 'Sent-mail endpoint is not available in this environment.' });
-              return;
-            }
-
-            const mails: DyNTS_SentTestMail[] = await DyNTS_TestEmailSink_Service.findSentMails({
-              to: typeof req.query.to === 'string' ? req.query.to : undefined,
-              sinceIso: typeof req.query.since === 'string' ? req.query.since : undefined,
-              limit: req.query.limit ? parseInt(String(req.query.limit), 10) : undefined,
-            }, issuer);
-
-            res.send({
-              count: mails.length,
-              mails: mails.map((mail: DyNTS_SentTestMail): object => ({
-                to: mail.to,
-                subject: mail.subject,
-                html: mail.html,
-                links: DyNTS_TestEmailSink_Service.extractLinks(mail.html),
-                issuer: mail.issuer,
-                createdAt: mail.__created,
-              })),
-            });
-          },
-        ],
-      }),
-    ];
-  }
-}
+import { Request, Response } from 'express';
+
+import { DyFM_EnvironmentFlag, DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_Controller } from '../../_services/route/controller.service';
+import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+import { DyNTS_TestEmailSink_Service } from './_services/dynts-test-email-sink.service';
+import { DyNTS_SentTestMail } from './_models/data-models/dynts-sent-test-mail.data-model';
+
+/**
+ * A sent-mail read-endpoint konfigja — az authPreProcess a fogyaszto sajat vedelme (pl. az
+ * auth-service `validateE2EKey`-e, X-E2E-KEY headerrel). ERŐSEN ajanlott megadni.
+ */
+export interface DyNTS_TestEmailSinkController_Config {
+  /** Opcionalis auth preprocess (pl. validateE2EKey). Ha nincs → csak az env-gate ved. */
+  authPreProcess?: (req: Request, res: Response) => Promise<void>;
+}
+
+/**
+ * BFR-MASTERPROMPTER-015 (MP-19) — sent-mail READ controller.
+ *
+ * GET /get?to=<cim>&since=<ISO>&limit=<n> → a sink-elt teszt-emailek (legfrissebb elol), a HTML-bol
+ * kinyert `links` tombbel (pl. verifikacios link). KETTOS vedelem: (1) a fogyaszto authPreProcess-e
+ * (X-E2E-KEY), (2) beepitett HARD env-gate — prod/dev kornyezetben MINDIG 403, konfigtol fuggetlenul.
+ */
+export class DyNTS_TestEmailSink_Controller extends DyNTS_Controller {
+
+  private static config: DyNTS_TestEmailSinkController_Config = {};
+
+  static configure(config: DyNTS_TestEmailSinkController_Config): void {
+    DyNTS_TestEmailSink_Controller.config = config;
+  }
+
+  static getInstance(): DyNTS_TestEmailSink_Controller {
+    return DyNTS_TestEmailSink_Controller.getSingletonInstance();
+  }
+
+  setupEndpoints(): void {
+    const preProcesses: ((req: Request, res: Response) => Promise<void>)[] = [];
+    if (DyNTS_TestEmailSink_Controller.config.authPreProcess) {
+      preProcesses.push(DyNTS_TestEmailSink_Controller.config.authPreProcess);
+    }
+
+    this.endpoints = [
+      new DyNTS_Endpoint_Params({
+        name: 'getSentTestMails',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/get',
+        preProcesses: preProcesses,
+        logRequest: false,
+        tasks: [
+          async (req: Request, res: Response, issuer: string): Promise<void> => {
+            // HARD env-gate: a teszt-emailek TARTALMA (verif-linkek!) prod-on sosem olvashato.
+            if (![ DyFM_EnvironmentFlag.local, DyFM_EnvironmentFlag.test ]
+              .includes(DyNTS_global_settings.env_settings.environment)) {
+              res.status(403).send({ error: 'Sent-mail endpoint is not available in this environment.' });
+              return;
+            }
+
+            const mails: DyNTS_SentTestMail[] = await DyNTS_TestEmailSink_Service.findSentMails({
+              to: typeof req.query.to === 'string' ? req.query.to : undefined,
+              sinceIso: typeof req.query.since === 'string' ? req.query.since : undefined,
+              limit: req.query.limit ? parseInt(String(req.query.limit), 10) : undefined,
+            }, issuer);
+
+            res.send({
+              count: mails.length,
+              mails: mails.map((mail: DyNTS_SentTestMail): object => ({
+                to: mail.to,
+                subject: mail.subject,
+                html: mail.html,
+                links: DyNTS_TestEmailSink_Service.extractLinks(mail.html),
+                issuer: mail.issuer,
+                createdAt: mail.__created,
+              })),
+            });
+          },
+        ],
+      }),
+    ];
+  }
+}

package/src/_modules/usage/get-usage-routing-module.util.ts

@@ -1,23 +1,23 @@
-
-import { DyFM_usageModule_settings } from '@futdevpro/fsm-dynamo/usage';
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { 
-  DyNTS_RoutingModule_Settings 
-} from '../../_models/interfaces/routing-module-settings.interface';
-import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
-import { DyNTS_Usage_Controller } from './usage.controller';
-
-export function DyNTS_getUsageRoutingModule(
-  securityOverride?: DyNTS_RouteSecurity
-): DyNTS_RoutingModule {
-  const set: DyNTS_RoutingModule_Settings = {
-    route: DyFM_usageModule_settings.mainRoute,
-    controllers: [ DyNTS_Usage_Controller.getInstance() ],
-  };
-
-  if (securityOverride) {
-    set.securityOverride = securityOverride;
-  }
-
-  return new DyNTS_RoutingModule(set);
+
+import { DyFM_usageModule_settings } from '@futdevpro/fsm-dynamo/usage';
+import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
+import { 
+  DyNTS_RoutingModule_Settings 
+} from '../../_models/interfaces/routing-module-settings.interface';
+import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
+import { DyNTS_Usage_Controller } from './usage.controller';
+
+export function DyNTS_getUsageRoutingModule(
+  securityOverride?: DyNTS_RouteSecurity
+): DyNTS_RoutingModule {
+  const set: DyNTS_RoutingModule_Settings = {
+    route: DyFM_usageModule_settings.mainRoute,
+    controllers: [ DyNTS_Usage_Controller.getInstance() ],
+  };
+
+  if (securityOverride) {
+    set.securityOverride = securityOverride;
+  }
+
+  return new DyNTS_RoutingModule(set);
 }

package/src/_modules/usage/index.ts

@@ -1,15 +1,15 @@
-
-
-//
-// Usage module
-//
-// This module is creates solutions to register and manage usage data
-//
-
-
-// USAGE MODULE
-export * from './usage.controller';
-export * from './usage.data-service';
-export * from './get-usage-routing-module.util';
-export * from '@futdevpro/fsm-dynamo/usage';
-
+
+
+//
+// Usage module
+//
+// This module is creates solutions to register and manage usage data
+//
+
+
+// USAGE MODULE
+export * from './usage.controller';
+export * from './usage.data-service';
+export * from './get-usage-routing-module.util';
+export * from '@futdevpro/fsm-dynamo/usage';
+

package/src/_modules/usage/usage.controller.spec.ts

@@ -1,106 +1,106 @@
-
-import { DyNTS_Usage_Controller } from './usage.controller';
-import { DyNTS_GlobalService } from '../../_services/core/global.service';
-import { DyNTS_AuthService } from '../../_services/core/auth.service';
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-describe('| DyNTS_Usage_Controller', () => {
-  let controller: DyNTS_Usage_Controller;
-  let mockAuthService: jasmine.SpyObj<DyNTS_AuthService>;
-
-  beforeEach(() => {
-    controller = DyNTS_Usage_Controller.getInstance();
-    mockAuthService = jasmine.createSpyObj<DyNTS_AuthService>('AuthService', [
-      'getUsernameFromRequest',
-    ]);
-
-    spyOn(DyNTS_GlobalService, 'getAuthService').and.returnValue(mockAuthService);
-  });
-
-  it('| should be a singleton instance', () => {
-    const instance1 = DyNTS_Usage_Controller.getInstance();
-    const instance2 = DyNTS_Usage_Controller.getInstance();
-
-    expect(instance1).toBe(instance2);
-    expect(instance1).toBeInstanceOf(DyNTS_Usage_Controller);
-  });
-
-  it('| should setup endpoints', () => {
-    controller.setupEndpoints();
-
-    expect(controller.endpoints).toBeDefined();
-    expect(controller.endpoints.length).toBeGreaterThan(0);
-  });
-
-  it('| should have newSession endpoint', () => {
-    controller.setupEndpoints();
-
-    const newSessionEndpoint = controller.endpoints.find(ep => ep.name === 'newSession');
-
-    expect(newSessionEndpoint).toBeDefined();
-    expect(newSessionEndpoint?.type).toBe(DyFM_HttpCallType.get);
-    expect((newSessionEndpoint as any)?.tasks).toBeDefined();
-    expect((newSessionEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-
-  it('| should have updateUsage endpoint', () => {
-    controller.setupEndpoints();
-
-    const updateUsageEndpoint = controller.endpoints.find(ep => ep.name === 'updateUsage');
-
-    expect(updateUsageEndpoint).toBeDefined();
-    expect(updateUsageEndpoint?.type).toBe(DyFM_HttpCallType.post);
-    expect((updateUsageEndpoint as any)?.tasks).toBeDefined();
-    expect((updateUsageEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-
-  it('| should have closeSession endpoint', () => {
-    controller.setupEndpoints();
-
-    const closeSessionEndpoint = controller.endpoints.find(ep => ep.name === 'closeSession');
-
-    expect(closeSessionEndpoint).toBeDefined();
-    expect(closeSessionEndpoint?.type).toBe(DyFM_HttpCallType.get);
-    expect((closeSessionEndpoint as any)?.tasks).toBeDefined();
-    expect((closeSessionEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-
-  it('| should have getUsageData endpoint with authentication', () => {
-    controller.setupEndpoints();
-
-    const getUsageDataEndpoint = controller.endpoints.find(ep => ep.name === 'getUsageData');
-
-    expect(getUsageDataEndpoint).toBeDefined();
-    expect(getUsageDataEndpoint?.type).toBe(DyFM_HttpCallType.get);
-    expect((getUsageDataEndpoint as any)?.preProcesses).toBeDefined();
-    expect((getUsageDataEndpoint as any)?.preProcesses.length).toBeGreaterThan(0);
-    expect((getUsageDataEndpoint as any)?.tasks).toBeDefined();
-    expect((getUsageDataEndpoint as any)?.tasks.length).toBeGreaterThan(0);
-  });
-
-  /**
-   * BFR-FDPPAL-001 — optional-auth mód (`auth_settings.optional: true`): a `getAuthService()`
-   * `undefined`-ot ad; a setupEndpoints NEM halhat meg TypeError-ral (boot-crash / restart-loop),
-   * a védett getUsageData kimarad, a session-endpointok élnek.
-   */
-  describe('| optional-auth mód — nincs auth service (BFR-FDPPAL-001)', () => {
-    beforeEach(() => {
-      (DyNTS_GlobalService.getAuthService as jasmine.Spy).and.returnValue(undefined);
-    });
-
-    it('| setupEndpoints nem dob, a session-endpointok megvannak', () => {
-      expect(() => controller.setupEndpoints()).not.toThrow();
-
-      expect(controller.endpoints.find(ep => ep.name === 'newSession')).toBeDefined();
-      expect(controller.endpoints.find(ep => ep.name === 'updateUsage')).toBeDefined();
-      expect(controller.endpoints.find(ep => ep.name === 'closeSession')).toBeDefined();
-    });
-
-    it('| a védett getUsageData endpoint KIMARAD (auth nélkül nem szolgálható ki)', () => {
-      controller.setupEndpoints();
-
-      expect(controller.endpoints.find(ep => ep.name === 'getUsageData')).toBeUndefined();
-    });
-  });
-});
-
+
+import { DyNTS_Usage_Controller } from './usage.controller';
+import { DyNTS_GlobalService } from '../../_services/core/global.service';
+import { DyNTS_AuthService } from '../../_services/core/auth.service';
+import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
+
+describe('| DyNTS_Usage_Controller', () => {
+  let controller: DyNTS_Usage_Controller;
+  let mockAuthService: jasmine.SpyObj<DyNTS_AuthService>;
+
+  beforeEach(() => {
+    controller = DyNTS_Usage_Controller.getInstance();
+    mockAuthService = jasmine.createSpyObj<DyNTS_AuthService>('AuthService', [
+      'getUsernameFromRequest',
+    ]);
+
+    spyOn(DyNTS_GlobalService, 'getAuthService').and.returnValue(mockAuthService);
+  });
+
+  it('| should be a singleton instance', () => {
+    const instance1 = DyNTS_Usage_Controller.getInstance();
+    const instance2 = DyNTS_Usage_Controller.getInstance();
+
+    expect(instance1).toBe(instance2);
+    expect(instance1).toBeInstanceOf(DyNTS_Usage_Controller);
+  });
+
+  it('| should setup endpoints', () => {
+    controller.setupEndpoints();
+
+    expect(controller.endpoints).toBeDefined();
+    expect(controller.endpoints.length).toBeGreaterThan(0);
+  });
+
+  it('| should have newSession endpoint', () => {
+    controller.setupEndpoints();
+
+    const newSessionEndpoint = controller.endpoints.find(ep => ep.name === 'newSession');
+
+    expect(newSessionEndpoint).toBeDefined();
+    expect(newSessionEndpoint?.type).toBe(DyFM_HttpCallType.get);
+    expect((newSessionEndpoint as any)?.tasks).toBeDefined();
+    expect((newSessionEndpoint as any)?.tasks.length).toBeGreaterThan(0);
+  });
+
+  it('| should have updateUsage endpoint', () => {
+    controller.setupEndpoints();
+
+    const updateUsageEndpoint = controller.endpoints.find(ep => ep.name === 'updateUsage');
+
+    expect(updateUsageEndpoint).toBeDefined();
+    expect(updateUsageEndpoint?.type).toBe(DyFM_HttpCallType.post);
+    expect((updateUsageEndpoint as any)?.tasks).toBeDefined();
+    expect((updateUsageEndpoint as any)?.tasks.length).toBeGreaterThan(0);
+  });
+
+  it('| should have closeSession endpoint', () => {
+    controller.setupEndpoints();
+
+    const closeSessionEndpoint = controller.endpoints.find(ep => ep.name === 'closeSession');
+
+    expect(closeSessionEndpoint).toBeDefined();
+    expect(closeSessionEndpoint?.type).toBe(DyFM_HttpCallType.get);
+    expect((closeSessionEndpoint as any)?.tasks).toBeDefined();
+    expect((closeSessionEndpoint as any)?.tasks.length).toBeGreaterThan(0);
+  });
+
+  it('| should have getUsageData endpoint with authentication', () => {
+    controller.setupEndpoints();
+
+    const getUsageDataEndpoint = controller.endpoints.find(ep => ep.name === 'getUsageData');
+
+    expect(getUsageDataEndpoint).toBeDefined();
+    expect(getUsageDataEndpoint?.type).toBe(DyFM_HttpCallType.get);
+    expect((getUsageDataEndpoint as any)?.preProcesses).toBeDefined();
+    expect((getUsageDataEndpoint as any)?.preProcesses.length).toBeGreaterThan(0);
+    expect((getUsageDataEndpoint as any)?.tasks).toBeDefined();
+    expect((getUsageDataEndpoint as any)?.tasks.length).toBeGreaterThan(0);
+  });
+
+  /**
+   * BFR-FDPPAL-001 — optional-auth mód (`auth_settings.optional: true`): a `getAuthService()`
+   * `undefined`-ot ad; a setupEndpoints NEM halhat meg TypeError-ral (boot-crash / restart-loop),
+   * a védett getUsageData kimarad, a session-endpointok élnek.
+   */
+  describe('| optional-auth mód — nincs auth service (BFR-FDPPAL-001)', () => {
+    beforeEach(() => {
+      (DyNTS_GlobalService.getAuthService as jasmine.Spy).and.returnValue(undefined);
+    });
+
+    it('| setupEndpoints nem dob, a session-endpointok megvannak', () => {
+      expect(() => controller.setupEndpoints()).not.toThrow();
+
+      expect(controller.endpoints.find(ep => ep.name === 'newSession')).toBeDefined();
+      expect(controller.endpoints.find(ep => ep.name === 'updateUsage')).toBeDefined();
+      expect(controller.endpoints.find(ep => ep.name === 'closeSession')).toBeDefined();
+    });
+
+    it('| a védett getUsageData endpoint KIMARAD (auth nélkül nem szolgálható ki)', () => {
+      controller.setupEndpoints();
+
+      expect(controller.endpoints.find(ep => ep.name === 'getUsageData')).toBeUndefined();
+    });
+  });
+});
+