@futdevpro/nts-dynamo 1.9.39 → 1.9.41

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AAGpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AAKtD,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AAGvE,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC;AAClE,cAAc,sDAAsD,CAAC;AACrE,cAAc,wDAAwD,CAAC;AAGvE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAI/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sCAAsC,CAAC;AAIrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AAGpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AAKtD,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AAGvE,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC;AAClE,cAAc,sDAAsD,CAAC;AACrE,cAAc,wDAAwD,CAAC;AAGvE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAK/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}

package/build/index.js

@@ -26,17 +26,23 @@ tslib_1.__exportStar(require("./_models/control-models/endpoint-params.control-m
 tslib_1.__exportStar(require("./_models/types/db-filter.type"), exports);
 tslib_1.__exportStar(require("./_models/types/db-update.type"), exports);
 // SERVICES
+// services/CORE
 tslib_1.__exportStar(require("./_services/core/api.service"), exports);
-tslib_1.__exportStar(require("./_services/server/app.server"), exports);
 tslib_1.__exportStar(require("./_services/core/auth.service"), exports);
-tslib_1.__exportStar(require("./_services/route/controller.service"), exports);
-tslib_1.__exportStar(require("./_services/base/data.service"), exports);
-tslib_1.__exportStar(require("./_services/base/db.service"), exports);
 tslib_1.__exportStar(require("./_services/core/email.service"), exports);
 tslib_1.__exportStar(require("./_services/core/global.service"), exports);
+tslib_1.__exportStar(require("./_services/core/service-collection.service"), exports);
+// services/BASE
+tslib_1.__exportStar(require("./_services/base/archive-data.service"), exports);
+tslib_1.__exportStar(require("./_services/base/data.service"), exports);
+tslib_1.__exportStar(require("./_services/base/db.service"), exports);
+tslib_1.__exportStar(require("./_services/base/singleton.service"), exports);
+// services/SERVER
+tslib_1.__exportStar(require("./_services/server/app.server"), exports);
+// services/ROUTE
+tslib_1.__exportStar(require("./_services/route/controller.service"), exports);
 tslib_1.__exportStar(require("./_services/route/controller.service"), exports);
 tslib_1.__exportStar(require("./_services/route/routing-module.service"), exports);
-tslib_1.__exportStar(require("./_services/core/service-collection.service"), exports);
+// services/SHARED
 tslib_1.__exportStar(require("./_services/shared.static-service"), exports);
-tslib_1.__exportStar(require("./_services/base/singleton.service"), exports);
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,uEAA6C;AAC7C,8EAAoD;AAEpD,aAAa;AACb,4EAAkD;AAClD,gFAAsD;AAGtD,6CAA6C;AAC7C,oBAAoB;AACpB,iGAAuE;AACvE,gGAAsE;AACtE,yFAA+D;AAC/D,iGAAuE;AAEvE,wBAAwB;AACxB,iGAAuE;AACvE,4FAAkE;AAClE,+FAAqE;AACrE,iGAAuE;AAEvE,eAAe;AACf,yEAA+C;AAC/C,yEAA+C;AAG/C,WAAW;AACX,uEAA6C;AAC7C,wEAA8C;AAC9C,wEAA8C;AAC9C,+EAAqD;AACrD,wEAA8C;AAC9C,sEAA4C;AAC5C,yEAA+C;AAC/C,0EAAgD;AAChD,+EAAqD;AACrD,mFAAyD;AACzD,sFAA4D;AAC5D,4EAAkD;AAClD,6EAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,uEAA6C;AAC7C,8EAAoD;AAEpD,aAAa;AACb,4EAAkD;AAClD,gFAAsD;AAGtD,6CAA6C;AAC7C,oBAAoB;AACpB,iGAAuE;AACvE,gGAAsE;AACtE,yFAA+D;AAC/D,iGAAuE;AAEvE,wBAAwB;AACxB,iGAAuE;AACvE,4FAAkE;AAClE,+FAAqE;AACrE,iGAAuE;AAEvE,eAAe;AACf,yEAA+C;AAC/C,yEAA+C;AAG/C,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAC9C,yEAA+C;AAC/C,0EAAgD;AAChD,sFAA4D;AAE5D,gBAAgB;AAChB,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAE9C,iBAAiB;AACjB,+EAAqD;AACrD,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.09.39",
+  "version": "01.09.41",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "scripts": {
     "prep": "npm i rimraf nodemon -g",
@@ -90,11 +90,11 @@
   },
   "homepage": "https:/futdevpro.hu/projects/dynamo",
   "DISABLED": {
-    "@futdevpro/fsm-dynamo": "file:../tgz-collection/dynamo-fsm/futdevpro-fsm-dynamo-01.09.21.tgz",
+    "@futdevpro/fsm-dynamo": "file:../tgz-collection/dynamo-fsm/futdevpro-fsm-dynamo-01.09.38.tgz",
     "empty": ""
   },
   "peerDependencies": {
-    "@futdevpro/fsm-dynamo": "~1.9.32",
+    "@futdevpro/fsm-dynamo": "~1.9.38",
 
     "@types/express": "~4.17.17",
     "@types/geoip-lite": "~1.4.1",

package/src/_collections/archive.util.ts

@@ -0,0 +1,9 @@
+
+
+
+export const DyNTS_archiveSuffix = 'Archived';
+
+export function DyNTS_getArchivedDBName(dbName: string): string {
+  return `${dbName}${DyNTS_archiveSuffix}`;
+}
+

package/src/_collections/global-settings.const.ts

@@ -7,6 +7,7 @@ export const DyNTS_global_settings: DyNTS_Global_Settings = {
   baseUrl: '/api',
   defaultRouteSecurity: DyNTS_RouteSecurity.open,
   defaultSocketSecurity: DyNTS_SocketSecurity.open,
+  autoResolveEndpointCirculationErrors: true,
 
   log_settings: {
     highDetailedLogs: false,

package/src/_models/control-models/endpoint-params.control-model.ts

@@ -2,7 +2,7 @@
 
 import { Request, Response } from 'express';
 
-import { DyFM_Array, DyFM_Error, DyFM_errorFlag, DyFM_Log } from '@futdevpro/fsm-dynamo';
+import { DyFM_Array, DyFM_Error, DyFM_errorFlag, DyFM_Log, DyFM_Shared } from '@futdevpro/fsm-dynamo';
 import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
 import { DyNTS_HttpCallType } from '../../_enums/http/http-call-type.enum';
 import { DyNTS_global_settings } from '../../_collections/global-settings.const';
@@ -23,16 +23,17 @@ export class DyNTS_Endpoint_Params {
   /* TODO: ENCRYPTION !!EZTET
   useEncryptionKey?: string; */
 
-  private pathParams: string[];
+  private readonly pathParams: string[];
 
-  private preProcesses: ((req: Request, res: Response) => Promise<void>)[];
-  private tasks: ((req: Request, res: Response, issuer?: string) => Promise<void>)[];
+  private readonly preProcesses: ((req: Request, res: Response) => Promise<void>)[];
+  private readonly tasks: ((req: Request, res: Response, issuer?: string) => Promise<void>)[];
 
-  private logRequest: boolean;
-  private logRequestsParams: boolean;
-  private logRequestsContent: boolean;
-  private logResponseContent: boolean;
-  private stack: string;
+  private readonly logRequest: boolean;
+  private readonly logRequestsParams: boolean;
+  private readonly logRequestsContent: boolean;
+  private readonly logResponseContent: boolean;
+  private readonly stack: string;
+  private readonly autoResolveCirculation: boolean;
 
   constructor(
     set: {
@@ -85,6 +86,10 @@ export class DyNTS_Endpoint_Params {
        * log settings for response content
        */
       logResponseContent?: boolean,
+      /**
+       * auto resolve circulation errors
+       */
+      autoResolveCirculation?: boolean,
     }
   ) {
     try {
@@ -101,6 +106,8 @@ export class DyNTS_Endpoint_Params {
         set.logRequestsContent ?? DyNTS_global_settings.log_settings.requestsContent;
       this.logResponseContent = 
         set.logResponseContent ?? DyNTS_global_settings.log_settings.responseContent;
+      this.autoResolveCirculation = 
+        set.autoResolveCirculation ?? DyNTS_global_settings.autoResolveEndpointCirculationErrors;
 
       if (!this.endpoint) {
         throw new DyFM_Error({
@@ -233,7 +240,8 @@ export class DyNTS_Endpoint_Params {
     req: Request, 
     res: Response, 
     error: Error | DyFM_Error, 
-    issuer: string
+    issuer: string,
+    autoSecondTry?: boolean
   ): Promise<void> {
     try {
       let msg: string = `Endpoint caught an error. '${this.name}' (${this.endpoint})`;
@@ -284,10 +292,27 @@ export class DyNTS_Endpoint_Params {
 
       try {
         JSON.stringify(error);
-      } catch (error) {
-        DyFM_Log.H_error(
-          'DyNTS_Endpoint_Params: error object is not serializable!', error
-        );
+      } catch (stringifyError) {
+        if (this.autoResolveCirculation) {
+          try {
+            error = DyFM_Shared.resolveCirculation(error);
+            JSON.stringify(error);
+          } catch (resolveError) {
+            DyFM_Log.H_error(
+              'DyNTS_Endpoint_Params: error object is not serializable, and not resolvable!'
+            );
+
+            error = new DyFM_Error({
+              error: new Error('UNRESOLVABLE UNSERIALIZABLE ERROR'),
+            });
+          }
+        } else {
+          DyFM_Log.H_error('DyNTS_Endpoint_Params: error object is not serializable!');
+
+          error = new DyFM_Error({
+            error: new Error('UNSERIALIZABLE ERROR'),
+          });
+        }
       }
 
       res.status((error as DyFM_Error)?.___status ?? 501);
@@ -310,19 +335,37 @@ export class DyNTS_Endpoint_Params {
 
       DyFM_Log.error('');
           
-    } catch (error) {
-      this.multiLevelError(error);
+    } catch (errorLvl2) {
+      this.multiLevelError(
+        errorLvl2,
+        { 
+          req: req, 
+          res: res, 
+          error: error, 
+          issuer: issuer, 
+          autoSecondTry: autoSecondTry, 
+        }
+      );
     }
   }
 
-  private multiLevelError(error: any): void {
+  private multiLevelError(
+    errorLvl2: any, 
+    errorInputs: { 
+      req: Request, 
+      res: Response, 
+      error: Error | DyFM_Error, 
+      issuer: string,
+      autoSecondTry: boolean
+    }
+  ): void {
     if (DyNTS_global_settings.log_settings.highDetailedLogs) {
       DyFM_Log.H_error(
         `\n\nDYNAMO MULTILEVEL ERROR:DyNTS_EndpointParams: error: ` +
           `(${this.name}, ${this.endpoint})` +
         `\n(DYNAMO MULTILEVEL ERROR means, that the ERROR HANDLING is ALSO FAILED, ` +
           `and the error message was not sent.)` + 
-        `\nERROR:`, error, 
+        `\nERROR:`, errorLvl2, 
         '\n'
       );
     } else {
@@ -334,16 +377,50 @@ export class DyNTS_Endpoint_Params {
       );
     }
 
+    try {
+      JSON.stringify(errorInputs.error);
+    } catch (errorLvl2Replication) {
+      DyFM_Log.error('  ...response object is not serializable!');
+      let resolvedError: any;
+
+      try {
+        resolvedError = DyFM_Shared.resolveCirculation(errorInputs.error);
+      } catch (errorLvl3) {
+        DyFM_Log.error('  ...response object is not resolvable!');
+        DyFM_Log.error('  ...', errorLvl3);
+      }
+      
+      if (resolvedError) {
+        if (this.autoResolveCirculation && !errorInputs.autoSecondTry) {
+          this.error(
+            errorInputs.req, 
+            errorInputs.res, 
+            resolvedError,
+            errorInputs.issuer,
+            true
+          );
+
+          DyFM_Log.warn('  ...automatic circulation error resolution was successful!');
+
+          return;
+        } else {
+          DyFM_Log.error(
+            '  ...response object is resolvable! (use DyFM_Shared.resolveCirculation)'
+          );
+        }
+      }
+    }
+
     if (
       DyNTS_global_settings.log_settings.highDetailedLogs ||
-      !(error instanceof DyFM_Error)
+      !(errorLvl2 instanceof DyFM_Error)
     ) {
       DyFM_Log.H_error(
         `Endpoint "${this.endpoint}" caught an error and FAILED TO RESOLVE. (${this.name})`,
-        '\n    ERROR:', error
+        '\n    ERROR:', errorLvl2
       );
     } else {
-      error.logSimple(
+      errorLvl2.logSimple(
         `Endpoint "${this.endpoint}" caught an error and FAILED TO RESOLVE. (${this.name})`
       );
     }

package/src/_models/interfaces/global-settings.interface.ts

@@ -30,6 +30,11 @@ export interface DyNTS_Global_Settings {
    */
   systemShortCodeName?: string;
 
+  /**
+   * 
+   */
+  autoResolveEndpointCirculationErrors: boolean;
+
   /**
    * this setting will set which logs will be shown
    */

package/src/_modules/socket/_models/socket-client-service-params.control-model.ts

@@ -15,6 +15,7 @@ export class DyNTS_SocketClientService_Params extends DyFM_SocketClient_Params {
   ) {
     super(set);
 
-    DyFM_Log.H_info('T1000 (test this with custom address!)', this.address);
+    DyFM_Log.H_info(
+      'DyNTS_SocketClientService_Params (test this with custom address!)', this.address);
   }
 }

package/src/_modules/socket/_models/socket-presence.control-model.ts

@@ -105,7 +105,7 @@ export class DyNTS_SocketPresence {
       if (!socket.connected) {
         DyFM_Log.warn(
           `Emitting event '${event}' on socket(${this.serviceName})-(${index}) failed!` +
-          `\nERROR: socket[${socket.id}] is not connected! (it will be removed...)`
+          `\n  ERROR: socket[${socket.id}] is not connected! (it will be removed...)`
         );
 
         /* errors.push(

package/src/_modules/socket/_services/app-extended.server.ts

@@ -119,7 +119,7 @@ import { DyNTS_global_settings } from '../../../_collections/global-settings.con
  */
 export abstract class DyNTS_AppExtended extends DyNTS_App {
   
-  private systemControlsExt: DyNTS_AppExtSysControls = new DyNTS_AppExtSysControls();
+  private readonly systemControlsExt: DyNTS_AppExtSysControls = new DyNTS_AppExtSysControls();
   override get started(): boolean { return this.systemControlsExt.appExtended.started; }
   private httpsSocketSettingUpCount: number = 0;
   private httpSocketSettingUpCount: number = 0;
@@ -138,12 +138,12 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
    * ];
    */
   protected socketServices: DyNTS_SocketServerService<any>[];
-  private allSocketServers: SocketIO.Server[] = [];
+  private readonly allSocketServers: SocketIO.Server[] = [];
 
   constructor(){
-    super(true);
+    super(/* true */);
 
-    this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
+    /* this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
       if (
         DyNTS_global_settings.log_settings.highDetailedLogs ||
         !(error instanceof DyFM_Error)
@@ -159,13 +159,15 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
           `(DyNTS_AppExtended constructor catch)`
         );
       }
-    });
+    }); */
   }
 
-  private async asyncConstructExt(): Promise<void> {
+  protected override async asyncConstruct(extended = true): Promise<void> {
     if (this.fnLogs && this.deepLog) console.log('\nfn:. asyncConstruct-extended');
 
     try {
+      await super.asyncConstruct(true);
+
       this.systemControlsExt.appExtended.init = true;
     
       this.socketServices = this.getSocketServices();
@@ -194,7 +196,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
       DyFM_Log.H_success(`"${this.params.name}" started successfully.`);
       
     } catch (error) {
-      if (
+      /* if (
         DyNTS_global_settings.log_settings.highDetailedLogs ||
         !(error instanceof DyFM_Error)
       ) {
@@ -206,7 +208,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
         error.logSimple(
           `Extended Application: "${this.params?.name}" start failed. (asyncConstructExt catch)`
         );
-      }
+      } */
 
       throw new DyFM_Error({
         errorCode: 'NTS-AES-001',

package/src/_modules/socket/_services/socket-server.service.ts

@@ -678,13 +678,13 @@ export abstract class DyNTS_SocketServerService<
       if (DyNTS_global_settings.log_settings.socket_eventContent) {
         DyFM_Log.success(
           ` <--=  emitted socket(${this.params.name}) event: "${event}", ` +
-          `\n  presenceId: "${id}", sockets: ${presence.sockets.length}` +
-          `\n  content:`, content
+          `\n         presenceId: "${id}", sockets: ${presence.sockets.length}` +
+          `\n         content:`, content
         );
       } else {
         DyFM_Log.success(
           ` <--=  emitted socket(${this.params.name}) event: "${event}", ` +
-          `\n  presenceId: ${id}, sockets: ${presence.sockets.length}`
+          `\n         presenceId: ${id}, sockets: ${presence.sockets.length}`
         );
       }
     } catch (error) {

package/src/_services/base/archive-data.service.ts

@@ -0,0 +1,207 @@
+
+import { 
+  DyFM_Metadata, DyFM_DataModel_Params, DyFM_Error
+} from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_DataService } from './data.service';
+import { DyNTS_getArchivedDBName } from '../../_collections/archive.util';
+import { DyNTS_GlobalService } from '../core/global.service';
+import { DyNTS_DBService } from './db.service';
+import { DyNTS_DBFilterSimple } from '../../_models/types/db-filter.type';
+
+// TODO: 3 type of archiving service system: 
+// 1.: within list (data have a list that have elements to archive)
+// 2.: separate db elements needs to be archived
+// 3.: from separate db elements to archive list elements
+
+export class DyNTS_ArchiveDataService<T extends DyFM_Metadata> extends DyNTS_DataService<T> {
+
+  originalDBService: DyNTS_DBService<T>;
+
+  constructor(
+    /**
+     * Initial data, this will be used by functions on default
+     */
+    data: T,
+    /**
+     * DB data prams will be used to connect to usable dbService on GlobalService
+     */
+    dataParams: DyFM_DataModel_Params,
+    /**
+     * Initial set for issuer to be able to follow the issuer's activity
+     */
+    issuer: string
+  ) {
+    const originalDataParams = { ...dataParams };
+    
+    dataParams = { 
+      ...dataParams,
+      dataName: DyNTS_getArchivedDBName(dataParams.dataName),
+    };
+    
+    super(data, dataParams, issuer);
+
+    this.originalDBService = DyNTS_GlobalService.getDBService<T>(originalDataParams);
+  }
+
+  async archiveDataById(id: string): Promise<T> {
+    try {
+      if (!id) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'archiveDataById',
+            new Error('archiveDataById failed, id is missing!')
+          ),
+
+          errorCode: 'NTS-ADS-ADI1',
+        });
+      }
+      
+      const data = await this.originalDBService.getDataById(id);
+
+      if (!data) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'archiveDataById',
+            new Error('archiveDataById failed, data not found!')
+          ),
+
+          errorCode: 'NTS-ADS-ADI2',
+          additionalContent: { 
+            id: id,
+          },
+        });
+      }
+
+      return await this.archiveData(data);
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings(
+          'archiveDataById',
+          error
+        ),
+
+        errorCode: 'NTS-ADS-ADI0',
+      });
+    }      
+  }
+
+  async getDataByOriginalId(originalId: string, dontSetToService?: boolean): Promise<T> {
+    try {
+      return await this.findData(
+        {
+          _originalId: originalId,
+        } as DyNTS_DBFilterSimple<T>, 
+        dontSetToService
+      );
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings(
+          'getDataByOriginalId',
+          error
+        ),
+
+        errorCode: 'NTS-ADS-GDOI0',
+      });
+    }
+  }
+
+  async archiveData(data?: T, dontSetToService?: boolean): Promise<T> {
+    try {
+      data = this.ensureData(data);
+      
+      if (data?._originalId) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'archiveData',
+            new Error(
+              `archiveData failed, originalId is already exists! (${this.dataParams.dataName})`
+            )
+          ),
+
+          errorCode: 'NTS-ADS-AD1',
+        });
+      }
+
+      if (data?._archived) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'archiveData',
+            new Error(
+              `archiveData failed, data is already archived! (${this.dataParams.dataName})`
+            )
+          ),
+
+          errorCode: 'NTS-ADS-AD2',
+        });
+      }
+
+      if (!data?._id) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'archiveData',
+            new Error(`archiveData failed, id is missing! (${this.dataParams.dataName})`)
+          ),
+
+          errorCode: 'NTS-ADS-AD3',
+        });
+      }
+
+      await this.originalDBService.deleteDataById(data._id);
+
+      data._originalId = data._id;
+      data._archived = new Date();
+      delete data._id;
+
+      return await this.saveData(data, dontSetToService);
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings(
+          'archiveData',
+          error
+        ),
+
+        errorCode: 'NTS-ADS-AD0',
+      });
+    }
+  }
+
+  override async saveData(data?: T, dontSetToService?: boolean): Promise<T> {
+    try {
+      data = this.ensureData(data);
+  
+      if (!data?._originalId) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'saveData',
+            new Error(`saveData failed, originalId is missing! (${this.dataParams.dataName})`)
+          ),
+  
+          errorCode: 'NTS-ADS-SD1',
+        });
+      }
+  
+      if (!data?._archived) {
+        throw new DyFM_Error({
+          ...this.getDefaultErrorSettings(
+            'saveData',
+            new Error(`saveData failed, data is not archived! (${this.dataParams.dataName})`)
+          ),
+  
+          errorCode: 'NTS-ADS-SD2',
+        });
+      }
+      
+      return await super.saveData(data, dontSetToService);
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings(
+          'saveData',
+          error
+        ),
+
+        errorCode: 'NTS-ADS-SD0',
+      });
+    }
+  }
+}