@futdevpro/nts-dynamo 1.15.157 → 1.15.160

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

@@ -1,83 +0,0 @@
-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 +0,0 @@
-
-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 +0,0 @@
-
-
-//
-// 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 +0,0 @@
-
-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();
-    });
-  });
-});
-

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

@@ -1,140 +0,0 @@
-
-import { Request, Response } from 'express';
-
-import { DyFM_HttpCallType, DyFM_Log, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
-import {
-  DyFM_usageModule_settings, DyFM_UsageSession
-} from '@futdevpro/fsm-dynamo/usage';
-
-import {
-  DyNTS_Endpoint_Params
-} from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_AuthService } from '../../_services/core/auth.service';
-import { DyNTS_GlobalService } from '../../_services/core/global.service';
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-import { DyNTS_Usage_DataService } from './usage.data-service';
-
-export class DyNTS_Usage_Controller extends DyNTS_Controller {
-
-  static getInstance(): DyNTS_Usage_Controller {
-    return DyNTS_Usage_Controller.getSingletonInstance();
-  }
-
-  // SERVICES
-  private authService: DyNTS_AuthService;
-
-  setupEndpoints(): void {
-    this.authService = DyNTS_GlobalService.getAuthService();
-
-    this.endpoints = [
-      new DyNTS_Endpoint_Params({
-        name: 'newSession',
-        type: DyFM_HttpCallType.get,
-        endpoint: DyFM_usageModule_settings.endPoints.newSession,
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            let username: string;
-            
-            try {
-              // BFR-FDPPAL-001: optional-auth módban nincs auth service — a session issuer ilyenkor 'unknown'
-              username = this.authService?.getUsernameFromRequest(req) ?? 'unknown';
-            } catch {
-              username = 'unknown';
-            }
-            const usageService = new DyNTS_Usage_DataService({
-              usageSession: new DyFM_UsageSession({
-                sessionStart: new Date(),
-                issuer: username,
-              }),
-              issuer,
-            });
-
-            await usageService.getLocationDataFromRequest(req);
-            await usageService.saveData();
-
-            res.send(
-              usageService.data
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'updateUsage',
-        type: DyFM_HttpCallType.post,
-        endpoint: DyFM_usageModule_settings.endPoints.updateUsage,
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            const usageService = new DyNTS_Usage_DataService({
-              usageSession: { _id: req.params.sessionId },
-              usageData: req.body,
-              issuer,
-            });
-
-            await usageService.updateUsageData(req);
-
-            res.send(
-              usageService.data
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'closeSession',
-        type: DyFM_HttpCallType.get,
-        endpoint: DyFM_usageModule_settings.endPoints.closeSession,
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            const usageService = new DyNTS_Usage_DataService({
-              usageSession: { _id: req.params.sessionId },
-              issuer,
-            });
-
-            await usageService.closeSession(req);
-
-            res.send(
-              usageService.data
-            );
-          },
-        ],
-      }),
-
-    ];
-
-    // BFR-FDPPAL-001: optional-auth módban (`auth_settings.optional: true`) a `getAuthService()`
-    // `undefined`-ot ad — a védett usage-lekérdezést ilyenkor KIHAGYJUK (az usage-adat auth nélkül
-    // nem szolgálható ki), de a boot nem halhat meg TypeError-ral; a session-endpointok élnek.
-    if (this.authService) {
-      this.endpoints.push(
-        new DyNTS_Endpoint_Params({
-          name: 'getUsageData',
-          type: DyFM_HttpCallType.get,
-          endpoint: DyFM_usageModule_settings.endPoints.getUsageData,
-          preProcesses: [ this.authService.authenticate_tokenPerm_accUsageData ],
-          tasks: [
-            async (req: Request, res: Response, issuer: string): Promise<void> => {
-              const range: DyFM_RelativeDate = req.params.range as DyFM_RelativeDate;
-
-              const usageService = new DyNTS_Usage_DataService({
-                issuer: issuer,
-              });
-
-              await usageService.getUsage(range);
-
-              res.send(
-                usageService.simplifiedDailyUsage
-              );
-            },
-          ],
-        }),
-      );
-    } else {
-      DyFM_Log.warn(
-        'DyNTS_Usage_Controller: no auth service (optional-auth mode) - ' +
-        'the protected "getUsageData" endpoint is SKIPPED; session endpoints remain available.'
-      );
-    }
-  }
-}
-