@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/server/server-status/db-readiness-probe.control-service.ts

@@ -1,158 +0,0 @@
-import { DyNTS_DbReadinessProbeCode_Type } from './db-readiness-probe-code.type-enum';
-import {
-  DyNTS_DbReadinessProbeRequest_Interface,
-  DyNTS_DbReadinessProbeResult_Interface
-} from './db-readiness-probe.interface';
-import { DyNTS_DbReadinessProbeStage_Type } from './db-readiness-probe-stage.type-enum';
-
-interface DyNTS_DbReadinessProbeResultSet_Interface {
-  readyState: number;
-  stage: DyNTS_DbReadinessProbeStage_Type;
-  code: DyNTS_DbReadinessProbeCode_Type;
-  ready?: boolean;
-  pingOk?: boolean;
-}
-
-/**
- * Performs exactly one foreground readiness check against a caller-owned Mongoose connection.
- *
- * The probe owns no timer, listener, retry or process hook. It never logs or returns driver content.
- * Timeout configuration and cancellation remain the caller's responsibility.
- */
-export class DyNTS_DbReadinessProbe_ControlService {
-  /** Runs one bounded, content-free probe against the supplied connection. */
-  public static async probe(
-    request: DyNTS_DbReadinessProbeRequest_Interface,
-  ): Promise<DyNTS_DbReadinessProbeResult_Interface> {
-    let stage: DyNTS_DbReadinessProbeStage_Type = DyNTS_DbReadinessProbeStage_Type.input;
-    let readyState: number = -1;
-
-    try {
-      const abortSignal: AbortSignal | undefined = request.abortSignal;
-
-      if (abortSignal?.aborted) {
-        return this.createResult({
-          readyState: -1,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.cancelled,
-        });
-      }
-
-      const connection: DyNTS_DbReadinessProbeRequest_Interface['connection'] = request.connection;
-
-      if (!connection || typeof connection !== 'object') {
-        return this.createResult({
-          readyState: -1,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.connectionUnavailable,
-        });
-      }
-
-      stage = DyNTS_DbReadinessProbeStage_Type.state;
-      readyState = this.normalizeReadyState(connection.readyState);
-
-      if (readyState === 0) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.disconnected,
-        });
-      }
-
-      if (readyState === 2) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.connecting,
-        });
-      }
-
-      if (readyState === 3) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.disconnecting,
-        });
-      }
-
-      if (readyState !== 1) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.stateUnknown,
-        });
-      }
-
-      stage = DyNTS_DbReadinessProbeStage_Type.ping;
-
-      if (abortSignal?.aborted) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.cancelled,
-        });
-      }
-
-      const database: DyNTS_DbReadinessProbeRequest_Interface['connection']['db'] = connection.db;
-
-      if (!database || typeof database.admin !== 'function') {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.databaseUnavailable,
-        });
-      }
-
-      const admin: ReturnType<typeof database.admin> = database.admin();
-
-      if (!admin || typeof admin.ping !== 'function') {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.databaseUnavailable,
-        });
-      }
-
-      await admin.ping();
-
-      if (abortSignal?.aborted) {
-        return this.createResult({
-          readyState: readyState,
-          stage: stage,
-          code: DyNTS_DbReadinessProbeCode_Type.cancelled,
-        });
-      }
-
-      return this.createResult({
-        readyState: readyState,
-        stage: DyNTS_DbReadinessProbeStage_Type.complete,
-        code: DyNTS_DbReadinessProbeCode_Type.ready,
-        ready: true,
-        pingOk: true,
-      });
-    } catch {
-      const code: DyNTS_DbReadinessProbeCode_Type = stage === DyNTS_DbReadinessProbeStage_Type.ping
-        ? DyNTS_DbReadinessProbeCode_Type.pingFailed
-        : DyNTS_DbReadinessProbeCode_Type.probeFailed;
-
-      return this.createResult({ readyState: readyState, stage: stage, code: code });
-    }
-  }
-
-  private static normalizeReadyState(value: number): number {
-    return Number.isInteger(value) && value >= 0 && value <= 3 ? value : -1;
-  }
-
-  private static createResult(
-    set: DyNTS_DbReadinessProbeResultSet_Interface,
-  ): DyNTS_DbReadinessProbeResult_Interface {
-    return {
-      contractVersion: 'dynts-db-readiness/1',
-      ready: set.ready ?? false,
-      readyState: set.readyState,
-      pingOk: set.pingOk ?? false,
-      stage: set.stage,
-      code: set.code,
-    };
-  }
-}

package/src/_modules/server/server-status/db-readiness-probe.interface.ts

@@ -1,20 +0,0 @@
-import { Connection } from 'mongoose';
-
-import { DyNTS_DbReadinessProbeCode_Type } from './db-readiness-probe-code.type-enum';
-import { DyNTS_DbReadinessProbeStage_Type } from './db-readiness-probe-stage.type-enum';
-
-/** Input for one caller-owned, foreground database-readiness probe. */
-export interface DyNTS_DbReadinessProbeRequest_Interface {
-  connection: Connection;
-  abortSignal?: AbortSignal;
-}
-
-/** Versioned, content-free and strictly allowlisted database-readiness result. */
-export interface DyNTS_DbReadinessProbeResult_Interface {
-  contractVersion: 'dynts-db-readiness/1';
-  ready: boolean;
-  readyState: number;
-  pingOk: boolean;
-  stage: DyNTS_DbReadinessProbeStage_Type;
-  code: DyNTS_DbReadinessProbeCode_Type;
-}

package/src/_modules/server/server-status/server-status-snapshot.control-service.spec.ts

@@ -1,70 +0,0 @@
-
-import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
-import { DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
-
-class TestServerStatus extends DyFM_ServerStatus {
-  constructor(set?: Partial<TestServerStatus>) {
-    super();
-    Object.assign(this, set);
-  }
-}
-
-class TestServerStatusSnapshotControlService extends DyNTS_ServerStatusSnapshot_ControlService<TestServerStatus> {
-  async saveSnapshot(snapshot: TestServerStatus, issuer: string): Promise<TestServerStatus> {
-    return snapshot;
-  }
-
-  static getInstance(): TestServerStatusSnapshotControlService {
-    return (TestServerStatusSnapshotControlService as any).getSingletonInstance();
-  }
-}
-
-describe('| DyNTS_ServerStatusSnapshot_ControlService', () => {
-  let service: TestServerStatusSnapshotControlService;
-
-  beforeEach(() => {
-    service = new TestServerStatusSnapshotControlService();
-  });
-
-  describe('| constructor', () => {
-    it('| should create instance', () => {
-      expect(service).toBeDefined();
-      expect(service).toBeInstanceOf(TestServerStatusSnapshotControlService);
-    });
-  });
-
-  describe('| saveSnapshot', () => {
-    it('| should save snapshot', async () => {
-      const snapshot: TestServerStatus = new TestServerStatus({
-        status: 'ready',
-        systemName: 'Test System',
-      });
-
-      const result = await service.saveSnapshot(snapshot, 'test-issuer');
-
-      expect(result).toBeDefined();
-      expect(result.status).toBe('ready');
-      expect(result.systemName).toBe('Test System');
-    });
-
-    it('| should handle snapshot with all properties', async () => {
-      const snapshot: TestServerStatus = new TestServerStatus({
-        status: 'ready',
-        systemName: 'Test System',
-        systemShortCode: 'TEST',
-        uptime: 1000,
-        memoryUsage: process.memoryUsage(),
-        cpuUsage: process.cpuUsage(),
-      });
-
-      const result = await service.saveSnapshot(snapshot, 'test-issuer');
-
-      expect(result).toBeDefined();
-      expect(result.status).toBe('ready');
-      expect(result.systemName).toBe('Test System');
-      expect(result.systemShortCode).toBe('TEST');
-      expect(result.uptime).toBe(1000);
-    });
-  });
-});
-

package/src/_modules/server/server-status/server-status-snapshot.control-service.ts

@@ -1,17 +0,0 @@
-
-
-
-
-/* import { ServerStatus_ControlService } from './server-status.control-service'; */
-
-import { DyFM_Error, DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
-import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
-
-export abstract class DyNTS_ServerStatusSnapshot_ControlService<
-  T_ServerStatusSnapshot extends DyFM_ServerStatus
-> {
-  abstract saveSnapshot(
-    snapshot: T_ServerStatusSnapshot, 
-    issuer: string
-  ): Promise<T_ServerStatusSnapshot>;
-}

package/src/_modules/server/server-status/server-status-snapshot.data-service.spec.ts

@@ -1,77 +0,0 @@
-
-import { DyNTS_ServerStatusSnapshot_DataService } from './server-status-snapshot.data-service';
-import { DyFM_ServerStatus, DyFM_DataModel_Params } from '@futdevpro/fsm-dynamo';
-import { DyNTS_GlobalService } from '../../../_services/core/global.service';
-import { DyNTS_DBService } from '../../../_services/base/db.service';
-
-class TestServerStatus extends DyFM_ServerStatus {
-  testProperty?: string;
-}
-
-const testDataParams = new DyFM_DataModel_Params<TestServerStatus>({
-  dataName: 'test_server_status',
-  properties: {},
-});
-
-describe('| DyNTS_ServerStatusSnapshot_DataService', () => {
-  let service: DyNTS_ServerStatusSnapshot_DataService<TestServerStatus>;
-  let mockDBService: jasmine.SpyObj<DyNTS_DBService<TestServerStatus>>;
-
-  beforeEach(() => {
-    mockDBService = jasmine.createSpyObj('DyNTS_DBService', [
-      'getAll',
-      'getDataById',
-      'createData',
-      'modifyData',
-    ]);
-
-    spyOn(DyNTS_GlobalService, 'getDBService').and.returnValue(mockDBService);
-
-    const testData = new TestServerStatus({
-      status: 'ready',
-      systemName: 'test-system',
-    });
-
-    service = new DyNTS_ServerStatusSnapshot_DataService<TestServerStatus>(
-      testData,
-      testDataParams,
-      'test-issuer'
-    );
-  });
-
-  it('| should create service instance', () => {
-    expect(service).toBeDefined();
-    expect(service.data).toBeDefined();
-  });
-
-  describe('| saveSnapshot', () => {
-    it('| should save snapshot', async () => {
-      const snapshot = new TestServerStatus({
-        status: 'ready',
-        systemName: 'test-system',
-        uptime: 1000,
-      });
-      const savedSnapshot = { ...snapshot, _id: 'snapshot-id' };
-      spyOn(service, 'saveData').and.returnValue(Promise.resolve(savedSnapshot));
-
-      const result = await service.saveSnapshot(snapshot, 'test-issuer');
-
-      expect(result).toBe(savedSnapshot);
-      expect(service.issuer).toBe('test-issuer');
-      expect(service.saveData).toHaveBeenCalledWith(snapshot);
-    });
-
-    it('| should throw error when save fails', async () => {
-      const snapshot = new TestServerStatus({
-        status: 'ready',
-        systemName: 'test-system',
-      });
-      spyOn(service, 'saveData').and.returnValue(Promise.reject(new Error('Save failed')));
-
-      await expectAsync(
-        service.saveSnapshot(snapshot, 'test-issuer')
-      ).toBeRejected();
-    });
-  });
-});
-

package/src/_modules/server/server-status/server-status-snapshot.data-service.ts

@@ -1,37 +0,0 @@
-
-
-
-
-/* import { ServerStatus_ControlService } from './server-status.control-service'; */
-
-import { DyFM_Error, DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
-import { DyNTS_DataService } from '../../../_services/base/data.service';
-import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-
-export class DyNTS_ServerStatusSnapshot_DataService<
-  T_ServerStatusSnapshot extends DyFM_ServerStatus
-> extends DyNTS_DataService<
-  T_ServerStatusSnapshot
-> implements DyNTS_ServerStatusSnapshot_ControlService<
-  T_ServerStatusSnapshot
-> {
-
-  async saveSnapshot(
-    snapshot: T_ServerStatusSnapshot, 
-    issuer: string
-  ): Promise<T_ServerStatusSnapshot> {
-    try {
-      this.issuer = issuer;
-
-      return await this.saveData(snapshot);
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('saveSnapshot', error),
-
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSSDS-SS0`,
-      });
-    }
-  }
-
-}