@futdevpro/nts-dynamo 1.15.73 → 1.15.75

package/src/_services/core/memory-guard.service.spec.ts

@@ -215,6 +215,7 @@ describe('| DyNTS_MemoryGuard (FR-193)', (): void => {
   it('| exitOnSustainedCritical: N egymás utáni critical poll → gracefulExit (process.exit)', (): void => {
     DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
     DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
+    DyNTS_global_settings.memoryGuard!.bootGraceMs = 0;   // nincs grace → azonnal élesedik
     const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
     guard.install();
     mockHeap(guard, 1000, 970);  // 97% critical
@@ -224,4 +225,21 @@ describe('| DyNTS_MemoryGuard (FR-193)', (): void => {
     poll(guard);
     expect(exitSpy).toHaveBeenCalledTimes(1);  // a 3. critical → exit
   });
+
+  it('| BOOT-GRACE: a grace alatt a sustained-critical NEM lép ki; a grace után IGEN', (): void => {
+    DyNTS_global_settings.memoryGuard!.exitOnSustainedCritical = true;
+    DyNTS_global_settings.memoryGuard!.sustainedCriticalPolls = 3;
+    DyNTS_global_settings.memoryGuard!.bootGraceMs = 60000;   // 60s grace
+    const exitSpy: jasmine.Spy = spyOn(guard as any, 'gracefulExit').and.stub();
+    guard.install();
+    mockHeap(guard, 1000, 970);  // 97% critical
+    spyOn(guard as any, 'recentGcFraction').and.returnValue(0.0);
+    // A grace ALATT (installedAt épp most): hiába N+ critical poll, NINCS exit.
+    poll(guard); poll(guard); poll(guard); poll(guard);
+    expect(exitSpy).not.toHaveBeenCalled();
+    // A grace UTÁN (installedAt 61s-cel ezelőttre állítva): a következő critical poll már kilép.
+    (guard as any).installedAt = Date.now() - 61000;
+    poll(guard);
+    expect(exitSpy).toHaveBeenCalledTimes(1);
+  });
 });

package/src/_services/core/memory-guard.service.ts

@@ -80,6 +80,8 @@ export interface DyNTS_MemoryGuard_Config {
   sustainedCriticalPolls?: number;
   /** A graceful-exit kódja. Default: 137. */
   exitCode?: number;
+  /** Boot-grace ms az `exitOnSustainedCritical`-hez (a guard-install utáni ennyi ms-ben NEM lép ki). Default: 60000. */
+  bootGraceMs?: number;
   /** Hook, amit a `critical` küszöb átlépésekor hívunk (pl. terhelés-dobás). */
   onCritical?: (event: DyNTS_MemoryGuard_Event) => void;
 }
@@ -109,6 +111,9 @@ export class DyNTS_MemoryGuard extends DyNTS_SingletonServiceBase {
   private exitOnSustainedCritical: boolean = false;
   private sustainedCriticalPolls: number = 3;
   private exitCode: number = 137;
+  private bootGraceMs: number = 60000;
+  /** A guard-install időbélyege (a boot-grace számításához; 0 = még nem telepített). */
+  private installedAt: number = 0;
   private onCritical?: (event: DyNTS_MemoryGuard_Event) => void;
 
   private readonly history: DyNTS_MemoryGuard_Event[] = [];
@@ -149,6 +154,8 @@ export class DyNTS_MemoryGuard extends DyNTS_SingletonServiceBase {
       this.exitOnSustainedCritical = config?.exitOnSustainedCritical ?? g.exitOnSustainedCritical ?? false;
       this.sustainedCriticalPolls = config?.sustainedCriticalPolls ?? g.sustainedCriticalPolls ?? 3;
       this.exitCode = config?.exitCode ?? g.exitCode ?? 137;
+      this.bootGraceMs = config?.bootGraceMs ?? g.bootGraceMs ?? 60000;
+      this.installedAt = Date.now();
       this.onCritical = config?.onCritical;
 
       this.installed = true;
@@ -167,7 +174,7 @@ export class DyNTS_MemoryGuard extends DyNTS_SingletonServiceBase {
         `warn ${this.warnPct}%/${Math.round(this.gcWarnFraction * 100)}%GC, ` +
         `crit ${this.critPct}%/${Math.round(this.gcCritFraction * 100)}%GC (heap limit ` +
         `${Math.round(this.getHeapLimitBytes() / BYTES_PER_MB)}MB)` +
-        (this.exitOnSustainedCritical ? `, graceful-exit@${this.sustainedCriticalPolls} critical polls` : ''),
+        (this.exitOnSustainedCritical ? `, graceful-exit@${this.sustainedCriticalPolls} critical polls (boot-grace ${this.bootGraceMs}ms)` : ''),
       );
     } catch (err: unknown) {
       // Telepítési hiba SEM lehet fatal — a guard hiánya nem ér annyit, hogy a
@@ -217,10 +224,13 @@ export class DyNTS_MemoryGuard extends DyNTS_SingletonServiceBase {
       }
       // Egyébként marad a jelenlegi állapot (hiszterézis-sáv) — nincs re-emit.
 
-      // Sustained-critical streak + opcionális graceful-exit (állapot-váltástól FÜGGETLENÜL számolva).
+      // Sustained-critical streak + opcionális graceful-exit (állapot-váltástól FÜGGETLENÜL számolva). A boot-grace
+      // alatt (install + bootGraceMs) NEM lép ki — a nehéz-boot (pool-hidratáló) appok eleve GC-thrash-elnek a boot
+      // alatt, így a sustained-exit boot-loop-ot okozna; a grace UTÁN a tartós critical a VALÓDI runtime-OOM-ot kezeli.
       if (next === 'critical') {
         this.criticalStreak += 1;
-        if (this.exitOnSustainedCritical && this.criticalStreak >= this.sustainedCriticalPolls) {
+        const pastBootGrace: boolean = (Date.now() - this.installedAt) >= this.bootGraceMs;
+        if (this.exitOnSustainedCritical && pastBootGrace && this.criticalStreak >= this.sustainedCriticalPolls) {
           this.gracefulExit({ pct: pct, gcFraction: gcFraction, limitBytes: limitBytes, mu: mu });
           return;
         }
@@ -465,6 +475,7 @@ export class DyNTS_MemoryGuard extends DyNTS_SingletonServiceBase {
     this.peakRssMb = 0;
     this.gcEvents = [];
     this.criticalStreak = 0;
+    this.installedAt = 0;
     this.onCritical = undefined;
   }
 }

package/src/_services/core/service-collection.service.spec.ts

@@ -1,46 +1,46 @@
-
-import { DyNTS_Service_Collection } from './service-collection.service';
-
-class TestService {
-  name: string;
-  constructor(name: string) {
-    this.name = name;
-  }
-}
-
-describe('| DyNTS_Service_Collection', () => {
-  it('| should be a singleton instance', () => {
-    class TestCollection extends DyNTS_Service_Collection<TestService> {
-      static getInstance(): TestCollection {
-        return TestCollection.getSingletonInstance();
-      }
-    }
-
-    const instance1 = TestCollection.getInstance();
-    const instance2 = TestCollection.getInstance();
-
-    expect(instance1).toBe(instance2);
-    expect(instance1).toBeInstanceOf(TestCollection);
-  });
-
-  it('| should allow dynamic property assignment', () => {
-    class TestCollection extends DyNTS_Service_Collection<TestService> {
-      static getInstance(): TestCollection {
-        return TestCollection.getSingletonInstance();
-      }
-    }
-
-    const collection = TestCollection.getInstance();
-    const service1 = new TestService('service1');
-    const service2 = new TestService('service2');
-
-    collection['service1'] = service1;
-    collection['service2'] = service2;
-
-    expect(collection['service1']).toBe(service1);
-    expect(collection['service2']).toBe(service2);
-    expect(collection['service1'].name).toBe('service1');
-    expect(collection['service2'].name).toBe('service2');
-  });
-});
-
+
+import { DyNTS_Service_Collection } from './service-collection.service';
+
+class TestService {
+  name: string;
+  constructor(name: string) {
+    this.name = name;
+  }
+}
+
+describe('| DyNTS_Service_Collection', () => {
+  it('| should be a singleton instance', () => {
+    class TestCollection extends DyNTS_Service_Collection<TestService> {
+      static getInstance(): TestCollection {
+        return TestCollection.getSingletonInstance();
+      }
+    }
+
+    const instance1 = TestCollection.getInstance();
+    const instance2 = TestCollection.getInstance();
+
+    expect(instance1).toBe(instance2);
+    expect(instance1).toBeInstanceOf(TestCollection);
+  });
+
+  it('| should allow dynamic property assignment', () => {
+    class TestCollection extends DyNTS_Service_Collection<TestService> {
+      static getInstance(): TestCollection {
+        return TestCollection.getSingletonInstance();
+      }
+    }
+
+    const collection = TestCollection.getInstance();
+    const service1 = new TestService('service1');
+    const service2 = new TestService('service2');
+
+    collection['service1'] = service1;
+    collection['service2'] = service2;
+
+    expect(collection['service1']).toBe(service1);
+    expect(collection['service2']).toBe(service2);
+    expect(collection['service1'].name).toBe('service1');
+    expect(collection['service2'].name).toBe('service2');
+  });
+});
+

package/src/_services/core/service-collection.service.ts

@@ -1,6 +1,6 @@
-
-import { DyNTS_SingletonServiceBase } from '../base/singleton.service-base';
-
-export class DyNTS_Service_Collection<T> extends DyNTS_SingletonServiceBase {
-  [service: string]: T;
-}
+
+import { DyNTS_SingletonServiceBase } from '../base/singleton.service-base';
+
+export class DyNTS_Service_Collection<T> extends DyNTS_SingletonServiceBase {
+  [service: string]: T;
+}

package/src/_services/route/controller.service.spec.ts

@@ -1,53 +1,53 @@
-
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_Controller } from './controller.service';
-
-class TestController extends DyNTS_Controller {
-  setupEndpoints(): void {
-    this.endpoints = [
-      new DyNTS_Endpoint_Params({
-        name: 'testEndpoint',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/test-endpoint',
-        preProcesses: [],
-        tasks: [
-          async (req: any, res: any) => {
-            res.send({ message: 'Test successful' });
-          },
-        ],
-      }),
-    ];
-  }
-
-  static getInstance(): TestController {
-    return new TestController();
-  }
-}
-
-describe('| DyNTS_Controller', () => {
-  let controller: TestController;
-
-  beforeEach(() => {
-    controller = TestController.getInstance();
-    controller.setupEndpoints();
-  });
-
-  it('| should initialize endpoints correctly', () => {
-    expect(controller.endpoints.length).toBe(1);
-    expect(controller.endpoints[0].name).toBe('testEndpoint');
-    expect(controller.endpoints[0].endpoint).toBe('/test-endpoint');
-  });
-
-  /* it('| should execute task and send response', async () => {
-    const req = {};
-    const res = {
-      send: jasmine.createSpy('send'),
-    };
-
-    await controller.endpoints[0].tasks[0](req, res);
-
-    expect(res.send).toHaveBeenCalledWith({ message: 'Test successful' });
-  }); */
-});
+
+import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
+import { DyNTS_Controller } from './controller.service';
+
+class TestController extends DyNTS_Controller {
+  setupEndpoints(): void {
+    this.endpoints = [
+      new DyNTS_Endpoint_Params({
+        name: 'testEndpoint',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/test-endpoint',
+        preProcesses: [],
+        tasks: [
+          async (req: any, res: any) => {
+            res.send({ message: 'Test successful' });
+          },
+        ],
+      }),
+    ];
+  }
+
+  static getInstance(): TestController {
+    return new TestController();
+  }
+}
+
+describe('| DyNTS_Controller', () => {
+  let controller: TestController;
+
+  beforeEach(() => {
+    controller = TestController.getInstance();
+    controller.setupEndpoints();
+  });
+
+  it('| should initialize endpoints correctly', () => {
+    expect(controller.endpoints.length).toBe(1);
+    expect(controller.endpoints[0].name).toBe('testEndpoint');
+    expect(controller.endpoints[0].endpoint).toBe('/test-endpoint');
+  });
+
+  /* it('| should execute task and send response', async () => {
+    const req = {};
+    const res = {
+      send: jasmine.createSpy('send'),
+    };
+
+    await controller.endpoints[0].tasks[0](req, res);
+
+    expect(res.send).toHaveBeenCalledWith({ message: 'Test successful' });
+  }); */
+});

package/src/_services/route/controller.service.ts

@@ -1,148 +1,148 @@
-
-
-import {
-  DyNTS_Endpoint_Params
-} from '../../_models/control-models/endpoint-params.control-model';
-
-import { DyNTS_SingletonService } from '../base/singleton.service';
-
-/**
- * Basic controller for endpoint handlings
- * 
- * (You'll need to add them to a {@link DyNTS_RoutingModule} through it's constructor)
- * 
- * You can add default endpoints to the controller by using the {@link DyNTS_DefaultEndpoints_Util} utility class
- * 
- * @example
- * this.endpoints = [
- *   ...DyNTS_DefaultEndpoints_Util.getAllDefaultEndpoints({
- *     entityName: 'UserMatchStatistics',
- *     dataServiceClass: UserMatchStatistics_DataService,
- *     endpoints: {
- *       get: '/get/user-match-statistics/:userId',
- *       search: '/search/user-match-statistics',
- *       modify: '/modify/user-match-statistics',
- *       patch: '/patch/user-match-statistics/:userId',
- *       delete: '/delete/user-match-statistics/:userId',
- *     },
- *     authService: this.authService,
- *   }),
- * ];
- * 
- * @example
- * export class UserMatchStatisticsController extends DyNTS_Controller {
- *
- * static getInstance(): UserMatchStatisticsController {
- *   return UserMatchStatisticsController.getSingletonInstance();
- * }
- *
- *   // SERVICES
- *   private authService: AuthService;
- *
- *   setupEndpoints(): void {
- *     this.authService = AuthService.getInstance();
- *
- *     this.endpoints = [
- *       new DyNTS_Endpoint_Params({
- *         name: 'getUserMatchStatistics',
- *         type: DyFM_HttpCallType.get,
- *         endpoint: '/get/user-match-statistics/:userId',
- *         preProcesses: [ this.authService.authenticate_tokenSelf ],
- *         tasks: [ 
- *           async (req: Request, res: Response) => {
- *             const userMatchStatistics = new UserMatchStatisticsService({ 
- *               data: { userId: req.params.userId }
- *             });
- * 
- *             await userMatchStatistics.getDataByDependencyId();
- *             
- *             res.send(
- *               userMatchStatistics.data
- *             );
- *           }
- *         ]
- *       }),
- *     ];
- *   }
- * }
- */
-export abstract class DyNTS_Controller extends DyNTS_SingletonService {
-
-  /**
-   * setup this in the setupEndpoints(), which will be called on the construcion
-   * 
-   * @example
-   * 
-   * this.endpoints = [
-   *   new DyNTS_Endpoint_Params({
-   *     name: 'getUserMatchStatistics',
-   *     type: DyFM_HttpCallType.get,
-   *     endpoint: '/get/user-match-statistics/:userId',
-   *     preProcesses: [ this.authService.authenticate_tokenSelf ],
-   *     tasks: [ 
-   *       async (req: Request, res: Response) => {
-   *         const userMatchStatistics = new UserMatchStatisticsService({ 
-   *           data: { userId: req.params.userId }
-   *         });
-   * 
-   *         await userMatchStatistics.getDataByDependencyId();
-   *         
-   *         res.send(
-   *           userMatchStatistics.data
-   *         );
-   *       }
-   *     ]
-   *   }),
-   * ];
-   */
-  endpoints: DyNTS_Endpoint_Params[];
-
-  /* protected constructor(){
-    super();
-    
-    try {
-      this.setupEndpoints();
-    } catch (error) {
-      throw new DyFM_Error({
-        message: 'DynamoNTSController setup failed. Please check the setupEndpoints() method.',
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-COS-000',
-        issuerService: this?.constructor?.name,
-        error: error,
-        level: DyFM_ErrorLevel.critical,
-      });
-    }
-  } */
-
-  /**
-   * You must setup endpoints and required services in this function
-   * 
-   * @example
-   * 
-   * setupEndpoints(): void {
-   *   this.authService = AuthService.getInstance();
-   *
-   *   this.endpoints = [
-   *     new DyNTS_Endpoint_Params({
-   *       name: 'getUserMatchStatistics',
-   *       type: DyFM_HttpCallType.get,
-   *       endpoint: '/get/user-match-statistics/:userId',
-   *       preProcesses: [ this.authService.authenticate_tokenSelf ],
-   *       tasks: [ 
-   *         async (req: Request, res: Response) => {
-   *           const userMatchStatistics = new UserMatchStatisticsService({ 
-   *             data: { userId: req.params.userId }
-   *           });
-   *
-   *           await userMatchStatistics.getDataByDependencyId();
-   *             
-   *           res.send(
-   *             userMatchStatistics.data
-   *           );
-   *         }
-   *       ]
-   *     }),
-   *   ];
-   * }
-   */
-  abstract setupEndpoints(): void
-}
+
+
+import {
+  DyNTS_Endpoint_Params
+} from '../../_models/control-models/endpoint-params.control-model';
+
+import { DyNTS_SingletonService } from '../base/singleton.service';
+
+/**
+ * Basic controller for endpoint handlings
+ * 
+ * (You'll need to add them to a {@link DyNTS_RoutingModule} through it's constructor)
+ * 
+ * You can add default endpoints to the controller by using the {@link DyNTS_DefaultEndpoints_Util} utility class
+ * 
+ * @example
+ * this.endpoints = [
+ *   ...DyNTS_DefaultEndpoints_Util.getAllDefaultEndpoints({
+ *     entityName: 'UserMatchStatistics',
+ *     dataServiceClass: UserMatchStatistics_DataService,
+ *     endpoints: {
+ *       get: '/get/user-match-statistics/:userId',
+ *       search: '/search/user-match-statistics',
+ *       modify: '/modify/user-match-statistics',
+ *       patch: '/patch/user-match-statistics/:userId',
+ *       delete: '/delete/user-match-statistics/:userId',
+ *     },
+ *     authService: this.authService,
+ *   }),
+ * ];
+ * 
+ * @example
+ * export class UserMatchStatisticsController extends DyNTS_Controller {
+ *
+ * static getInstance(): UserMatchStatisticsController {
+ *   return UserMatchStatisticsController.getSingletonInstance();
+ * }
+ *
+ *   // SERVICES
+ *   private authService: AuthService;
+ *
+ *   setupEndpoints(): void {
+ *     this.authService = AuthService.getInstance();
+ *
+ *     this.endpoints = [
+ *       new DyNTS_Endpoint_Params({
+ *         name: 'getUserMatchStatistics',
+ *         type: DyFM_HttpCallType.get,
+ *         endpoint: '/get/user-match-statistics/:userId',
+ *         preProcesses: [ this.authService.authenticate_tokenSelf ],
+ *         tasks: [ 
+ *           async (req: Request, res: Response) => {
+ *             const userMatchStatistics = new UserMatchStatisticsService({ 
+ *               data: { userId: req.params.userId }
+ *             });
+ * 
+ *             await userMatchStatistics.getDataByDependencyId();
+ *             
+ *             res.send(
+ *               userMatchStatistics.data
+ *             );
+ *           }
+ *         ]
+ *       }),
+ *     ];
+ *   }
+ * }
+ */
+export abstract class DyNTS_Controller extends DyNTS_SingletonService {
+
+  /**
+   * setup this in the setupEndpoints(), which will be called on the construcion
+   * 
+   * @example
+   * 
+   * this.endpoints = [
+   *   new DyNTS_Endpoint_Params({
+   *     name: 'getUserMatchStatistics',
+   *     type: DyFM_HttpCallType.get,
+   *     endpoint: '/get/user-match-statistics/:userId',
+   *     preProcesses: [ this.authService.authenticate_tokenSelf ],
+   *     tasks: [ 
+   *       async (req: Request, res: Response) => {
+   *         const userMatchStatistics = new UserMatchStatisticsService({ 
+   *           data: { userId: req.params.userId }
+   *         });
+   * 
+   *         await userMatchStatistics.getDataByDependencyId();
+   *         
+   *         res.send(
+   *           userMatchStatistics.data
+   *         );
+   *       }
+   *     ]
+   *   }),
+   * ];
+   */
+  endpoints: DyNTS_Endpoint_Params[];
+
+  /* protected constructor(){
+    super();
+    
+    try {
+      this.setupEndpoints();
+    } catch (error) {
+      throw new DyFM_Error({
+        message: 'DynamoNTSController setup failed. Please check the setupEndpoints() method.',
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-COS-000',
+        issuerService: this?.constructor?.name,
+        error: error,
+        level: DyFM_ErrorLevel.critical,
+      });
+    }
+  } */
+
+  /**
+   * You must setup endpoints and required services in this function
+   * 
+   * @example
+   * 
+   * setupEndpoints(): void {
+   *   this.authService = AuthService.getInstance();
+   *
+   *   this.endpoints = [
+   *     new DyNTS_Endpoint_Params({
+   *       name: 'getUserMatchStatistics',
+   *       type: DyFM_HttpCallType.get,
+   *       endpoint: '/get/user-match-statistics/:userId',
+   *       preProcesses: [ this.authService.authenticate_tokenSelf ],
+   *       tasks: [ 
+   *         async (req: Request, res: Response) => {
+   *           const userMatchStatistics = new UserMatchStatisticsService({ 
+   *             data: { userId: req.params.userId }
+   *           });
+   *
+   *           await userMatchStatistics.getDataByDependencyId();
+   *             
+   *           res.send(
+   *             userMatchStatistics.data
+   *           );
+   *         }
+   *       ]
+   *     }),
+   *   ];
+   * }
+   */
+  abstract setupEndpoints(): void
+}