@futdevpro/nts-dynamo 1.15.137 → 1.15.140

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

@@ -18,12 +18,21 @@ interface DyNTS_DisconnectRecord {
   socket: SocketIO.Socket | undefined;
 }
 
+interface DyNTS_TransportContextRecord {
+  content: unknown;
+  issuer: string | undefined;
+  transportContext: unknown;
+}
+
 type DyNTS_SocketHandler = (...args: unknown[]) => Promise<void>;
 
+const DyNTS_transportContextEventKey: string = 'transport-context-test';
+
 class DyNTS_SocketServer_LifecycleMock extends
   DyNTS_SocketServerService<DyNTS_SocketPresence, { issuerId: string }> {
 
   readonly disconnectRecords: DyNTS_DisconnectRecord[] = [];
+  readonly transportContextRecords: DyNTS_TransportContextRecord[] = [];
 
   /** A lifecycle teszt singletonjat adja vissza. */
   static getInstance(): DyNTS_SocketServer_LifecycleMock {
@@ -39,7 +48,7 @@ class DyNTS_SocketServer_LifecycleMock extends
   }
 
   /** A socket payloadot megorzo egyetlen custom disconnect taskot adja. */
-  getIncomingEvents(): DyFM_SocketEvent<SocketIO.Socket>[] {
+  getIncomingEvents(): DyFM_SocketEvent<unknown>[] {
     return [
       new DyFM_SocketEvent<SocketIO.Socket>({
         eventKey: DyFM_SocketEvent_Key.disconnect,
@@ -52,6 +61,22 @@ class DyNTS_SocketServer_LifecycleMock extends
           },
         ],
       }),
+      new DyFM_SocketEvent<unknown>({
+        eventKey: DyNTS_transportContextEventKey,
+        tasks: [
+          async (
+            content: unknown,
+            issuer: string | undefined,
+            transportContext: unknown
+          ): Promise<void> => {
+            this.transportContextRecords.push({
+              content: content,
+              issuer: issuer,
+              transportContext: transportContext,
+            });
+          },
+        ],
+      }),
     ];
   }
 
@@ -169,6 +194,20 @@ describe('| DyNTS_SocketServerService', (): void => {
       DyFM_SocketEvent_Key.subscribe
     )({ issuerId: 'beta' });
 
+    const transportContent: object = { commandId: 'command-1' };
+
+    await getRegisteredHandler(
+      firstSocket.on.calls.allArgs(),
+      DyNTS_transportContextEventKey
+    )(transportContent);
+    expect(service.transportContextRecords).toEqual([
+      {
+        content: transportContent,
+        issuer: 'alpha',
+        transportContext: firstSocket,
+      },
+    ]);
+
     await getRegisteredHandler(
       explicitSocket.on.calls.allArgs(),
       DyFM_SocketEvent_Key.unsubscribe

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

@@ -461,7 +461,7 @@ export abstract class DyNTS_SocketServerService<
                   if (event.eventKey === DyFM_SocketEvent_Key.disconnect) {
                     await this.executeDisconnectTasks(socket, issuer);
                   } else {
-                    await event.executeEventTasks(content, issuer);
+                    await event.executeEventTasks(content, issuer, socket);
                   }
                 } catch (error) {
                   if (error instanceof DyFM_Error) {

package/src/_services/core/mongo-transaction.control-service.spec.ts

@@ -0,0 +1,165 @@
+import { ClientSession } from 'mongoose';
+
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_MongoTransaction_ControlService } from './mongo-transaction.control-service';
+
+describe('| DyNTS_MongoTransaction_ControlService', (): void => {
+  let session: jasmine.SpyObj<ClientSession>;
+
+  beforeEach((): void => {
+    session = jasmine.createSpyObj<ClientSession>('ClientSession', [ 'withTransaction', 'endSession' ]);
+    session.endSession.and.resolveTo();
+  });
+
+  it('| commits and returns the task result with the same session', async (): Promise<void> => {
+    session.withTransaction.and.callFake(
+      async <T>(task: (taskSession: ClientSession) => Promise<T>): Promise<T> => task(session)
+    );
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      async (): Promise<ClientSession> => session
+    );
+    let receivedSession: ClientSession | null = null;
+
+    const result: string = await service.execute<string>({
+      transactionName: 'pipeline-transition',
+      issuer: 'pipeline-service',
+      maxCommitTimeMs: 3_000,
+      task: async (taskSession: ClientSession): Promise<string> => {
+        receivedSession = taskSession;
+
+        return 'committed';
+      },
+    });
+
+    expect(result).toBe('committed');
+    expect(receivedSession).toBe(session);
+    expect(session.withTransaction).toHaveBeenCalled();
+    expect(session.withTransaction.calls.mostRecent().args[1]).toEqual({
+      readConcern: { level: 'snapshot' },
+      writeConcern: { w: 'majority' },
+      readPreference: 'primary',
+      maxCommitTimeMS: 3_000,
+    });
+    expect(session.endSession).toHaveBeenCalledTimes(1);
+  });
+
+  it('| preserves a committed undefined task value through the internal result wrapper', async (): Promise<void> => {
+    session.withTransaction.and.callFake(
+      async <T>(task: (taskSession: ClientSession) => Promise<T>): Promise<T> => task(session)
+    );
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      async (): Promise<ClientSession> => session
+    );
+
+    const result: undefined = await service.execute<undefined>({
+      transactionName: 'content-free-cleanup',
+      issuer: 'retention-service',
+      task: async (): Promise<undefined> => undefined,
+    });
+
+    expect(result).toBeUndefined();
+    expect(session.endSession).toHaveBeenCalledTimes(1);
+  });
+
+  it('| wraps a transaction failure without task content and closes the session', async (): Promise<void> => {
+    session.withTransaction.and.rejectWith(new Error('duplicate payload secret-value'));
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      async (): Promise<ClientSession> => session
+    );
+
+    let capturedError: DyFM_Error | null = null;
+
+    try {
+      await service.execute<string>({
+        transactionName: 'pipeline-transition',
+        issuer: 'pipeline-service',
+        task: async (): Promise<string> => 'not-returned',
+      });
+    } catch (error: unknown) {
+      capturedError = error instanceof DyFM_Error ? error : null;
+    }
+
+    expect(capturedError).toBeInstanceOf(DyFM_Error);
+    expect(capturedError?._errorCode).toBe('DyNTS|MONGO_TRANSACTION|FAILED');
+    expect(capturedError?._message).not.toContain('secret-value');
+    expect(capturedError?.additionalContent).toEqual({
+      transactionName: 'pipeline-transition',
+      causeName: 'Error',
+    });
+    expect(session.endSession).toHaveBeenCalledTimes(1);
+  });
+
+  it('| fails before session creation when required settings are missing', async (): Promise<void> => {
+    const sessionFactory: jasmine.Spy<() => Promise<ClientSession>> = jasmine.createSpy('sessionFactory');
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      sessionFactory
+    );
+
+    await expectAsync(service.execute<string>({
+      transactionName: '',
+      issuer: 'pipeline-service',
+      task: async (): Promise<string> => 'not-returned',
+    })).toBeRejectedWith(jasmine.objectContaining({
+      _errorCode: 'DyNTS|MONGO_TRANSACTION|SETTINGS_INVALID',
+    }));
+    expect(sessionFactory).not.toHaveBeenCalled();
+  });
+
+  it('| rejects a non-positive commit budget before creating a session', async (): Promise<void> => {
+    const sessionFactory: jasmine.Spy<() => Promise<ClientSession>> = jasmine.createSpy('sessionFactory');
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      sessionFactory
+    );
+
+    await expectAsync(service.execute<string>({
+      transactionName: 'pipeline-transition',
+      issuer: 'pipeline-service',
+      maxCommitTimeMs: 0,
+      task: async (): Promise<string> => 'not-returned',
+    })).toBeRejectedWith(jasmine.objectContaining({
+      _errorCode: 'DyNTS|MONGO_TRANSACTION|COMMIT_TIME_INVALID',
+    }));
+    expect(sessionFactory).not.toHaveBeenCalled();
+  });
+
+  it('| reports session creation failure without attempting cleanup', async (): Promise<void> => {
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      async (): Promise<ClientSession> => Promise.reject(new Error('mongo unavailable'))
+    );
+
+    await expectAsync(service.execute<string>({
+      transactionName: 'pipeline-transition',
+      issuer: 'pipeline-service',
+      task: async (): Promise<string> => 'not-returned',
+    })).toBeRejectedWith(jasmine.objectContaining({
+      _errorCode: 'DyNTS|MONGO_TRANSACTION|SESSION_FAILED',
+    }));
+    expect(session.endSession).not.toHaveBeenCalled();
+  });
+
+  it('| preserves a stable no-result failure and tolerates cleanup errors', async (): Promise<void> => {
+    session.withTransaction.and.resolveTo(undefined);
+    session.endSession.and.rejectWith(new Error('cleanup failed'));
+    const service: DyNTS_MongoTransaction_ControlService = new DyNTS_MongoTransaction_ControlService(
+      async (): Promise<ClientSession> => session
+    );
+
+    await expectAsync(service.execute<string>({
+      transactionName: 'pipeline-transition',
+      issuer: 'pipeline-service',
+      task: async (): Promise<string> => 'not-returned',
+    })).toBeRejectedWith(jasmine.objectContaining({
+      _errorCode: 'DyNTS|MONGO_TRANSACTION|NO_COMMIT_RESULT',
+    }));
+  });
+
+  it('| exposes the singleton production entry point', (): void => {
+    const first: DyNTS_MongoTransaction_ControlService = DyNTS_MongoTransaction_ControlService.getInstance();
+    const second: DyNTS_MongoTransaction_ControlService = DyNTS_MongoTransaction_ControlService.getInstance();
+
+    expect(first).toBe(second);
+    expect(first).toBeInstanceOf(DyNTS_MongoTransaction_ControlService);
+    expect(DyFM_Error).toBeDefined();
+  });
+});

package/src/_services/core/mongo-transaction.control-service.ts

@@ -0,0 +1,148 @@
+import mongoose, { ClientSession } from 'mongoose';
+
+import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import {
+  DyNTS_MongoTransaction_Settings
+} from '../../_models/interfaces/mongo-transaction-settings.interface';
+import { DyNTS_SingletonService } from '../base/singleton.service';
+
+interface DyNTS_MongoTransactionErrorContext<T> {
+  settings?: Partial<DyNTS_MongoTransaction_Settings<T>>;
+  causeName?: string;
+}
+
+/** Executes reusable Mongo transactions with majority durability and content-free failures. */
+export class DyNTS_MongoTransaction_ControlService extends DyNTS_SingletonService {
+  /** Returns the process-wide transaction service. */
+  public static getInstance(): DyNTS_MongoTransaction_ControlService {
+    return DyNTS_MongoTransaction_ControlService.getSingletonInstance();
+  }
+
+  private readonly sessionFactory: () => Promise<ClientSession>;
+
+  /** Creates the service; tests may inject a session factory without changing production behavior. */
+  constructor(sessionFactory: () => Promise<ClientSession> = (): Promise<ClientSession> => mongoose.startSession()) {
+    super();
+    this.sessionFactory = sessionFactory;
+  }
+
+  /** Runs one task atomically and always closes its session. */
+  public async execute<T>(settings: DyNTS_MongoTransaction_Settings<T>): Promise<T> {
+    this.validateSettings(settings);
+
+    let session: ClientSession;
+
+    try {
+      session = await this.sessionFactory();
+    } catch (error: unknown) {
+      throw this.buildError(
+        'DyNTS|MONGO_TRANSACTION|SESSION_FAILED',
+        'Mongo transaction session creation failed.',
+        { settings: settings, causeName: this.getErrorName(error) }
+      );
+    }
+
+    try {
+      const wrappedResult: { value: T } | undefined = await session.withTransaction(
+        async (): Promise<{ value: T }> => ({ value: await settings.task(session) }),
+        this.buildOptions(settings.maxCommitTimeMs)
+      );
+
+      if (!wrappedResult) {
+        throw this.buildError(
+          'DyNTS|MONGO_TRANSACTION|NO_COMMIT_RESULT',
+          'Mongo transaction finished without a committed result.',
+          { settings: settings }
+        );
+      }
+
+      return wrappedResult.value;
+    } catch (error: unknown) {
+      if (error instanceof DyFM_Error && error._errorCode?.startsWith('DyNTS|MONGO_TRANSACTION|')) {
+        throw error;
+      }
+
+      throw this.buildError(
+        'DyNTS|MONGO_TRANSACTION|FAILED',
+        'Mongo transaction failed and was not committed.',
+        { settings: settings, causeName: this.getErrorName(error) }
+      );
+    } finally {
+      await this.closeSession(session, settings);
+    }
+  }
+
+  private validateSettings<T>(settings: DyNTS_MongoTransaction_Settings<T>): void {
+    if (!settings?.transactionName?.trim() || !settings.issuer?.trim() || typeof settings.task !== 'function') {
+      throw this.buildError(
+        'DyNTS|MONGO_TRANSACTION|SETTINGS_INVALID',
+        'Transaction name, issuer and task are required.',
+        { settings: settings }
+      );
+    }
+
+    if (
+      settings.maxCommitTimeMs !== undefined
+      && (!Number.isSafeInteger(settings.maxCommitTimeMs) || settings.maxCommitTimeMs <= 0)
+    ) {
+      throw this.buildError(
+        'DyNTS|MONGO_TRANSACTION|COMMIT_TIME_INVALID',
+        'Mongo transaction maxCommitTimeMs must be a positive safe integer.',
+        { settings: settings }
+      );
+    }
+  }
+
+  private buildOptions(maxCommitTimeMs?: number): mongoose.mongo.TransactionOptions {
+    const options: mongoose.mongo.TransactionOptions = {
+      readConcern: { level: 'snapshot' },
+      writeConcern: { w: 'majority' },
+      readPreference: 'primary',
+    };
+
+    if (maxCommitTimeMs !== undefined) {
+      options.maxCommitTimeMS = maxCommitTimeMs;
+    }
+
+    return options;
+  }
+
+  private async closeSession<T>(
+    session: ClientSession,
+    settings: DyNTS_MongoTransaction_Settings<T>
+  ): Promise<void> {
+    try {
+      await session.endSession();
+    } catch (error: unknown) {
+      DyFM_Log.warn(
+        `[dynts-mongo-transaction] session cleanup failed · transaction=${settings.transactionName}`,
+        error instanceof Error ? error.name : 'unknown-error'
+      );
+    }
+  }
+
+  private buildError<T>(
+    errorCode: string,
+    message: string,
+    context: DyNTS_MongoTransactionErrorContext<T>
+  ): DyFM_Error {
+    return new DyFM_Error({
+      status: 500,
+      errorCode: errorCode,
+      message: message,
+      userMessage: 'The operation could not be committed. No partial change was accepted.',
+      issuer: context.settings?.issuer,
+      issuerService: this.constructor.name,
+      additionalContent: {
+        transactionName: context.settings?.transactionName ?? 'unknown',
+        causeName: context.causeName ?? 'unknown',
+      },
+      error: context.causeName ? new Error(context.causeName) : undefined,
+    });
+  }
+
+  private getErrorName(error: unknown): string {
+    return error instanceof Error ? error.name : 'unknown-error';
+  }
+}

package/src/index.ts

@@ -56,6 +56,7 @@ export * from './_models/interfaces/security-headers-settings.interface';
 export * from './_models/interfaces/app-version-header-settings.interface';
 export * from './_models/interfaces/db-query-options.interface';
 export * from './_models/interfaces/migration-entry.interface';
+export * from './_models/interfaces/mongo-transaction-settings.interface';
 export * from './_collections/security-headers.util';
 export * from './_collections/app-version-header.util';
 export * from './_collections/signed-url.util';
@@ -94,6 +95,7 @@ export * from './_services/core/memory-guard.service';
 
 export * from './_services/core/service-collection.service';
 export * from './_services/core/migration-runner.service';
+export * from './_services/core/mongo-transaction.control-service';
 
 // services/BASE
 export * from './_services/base/api.service-base';
@@ -112,4 +114,3 @@ export * from './_services/route/routing-module.service';
 
 // services/SHARED
 export * from './_services/shared.static-service';
-

package/build/_collections/app-version-header.util.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=app-version-header.util.spec.d.ts.map

package/build/_collections/app-version-header.util.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-version-header.util.spec.d.ts","sourceRoot":"","sources":["../../src/_collections/app-version-header.util.spec.ts"],"names":[],"mappings":""}

package/build/_collections/app-version-header.util.spec.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const app_version_header_util_1 = require("./app-version-header.util");
-/**
- * FR-292 — a deployolt app-verzió minden válaszon.
- *
- * A garanciák, amiket ez a spec ŐRIZ:
- *  - ISMERETLEN verziónál NINCS header (a `unknown-version` hamis „új verzió"-riasztást adna),
- *  - a verzió a hívás pillanatában olvasódik (az app-params KÉSŐBB tölti be — egy induláskor
- *    befagyasztott érték örökre `unknown` maradna),
- *  - a CORS expose-lista BŐVÜL, nem felülíródik (különben más headerek olvashatatlanná válnának),
- *  - a bővítés IDEMPOTENS (kétszeri felszerelés nem duplikál).
- */
-describe('| FR-292 app-version response header', () => {
-    /** Minimal Express-válasz stub — csak a header-tárolás kell hozzá. */
-    function makeRes() {
-        const headers = {};
-        return {
-            headers: headers,
-            setHeader: (name, value) => { headers[name] = value; },
-            getHeader: (name) => headers[name],
-        };
-    }
-    describe('| DyNTS_resolveExposeHeaders', () => {
-        it('| ures listabol a header neve lesz', () => {
-            expect((0, app_version_header_util_1.DyNTS_resolveExposeHeaders)(undefined, 'X-App-Version')).toBe('X-App-Version');
-            expect((0, app_version_header_util_1.DyNTS_resolveExposeHeaders)('', 'X-App-Version')).toBe('X-App-Version');
-        });
-        it('| a MEGLEVO listat megtartja es hozzafuz (nem felulir)', () => {
-            expect((0, app_version_header_util_1.DyNTS_resolveExposeHeaders)('Content-Length, Content-Type', 'X-App-Version'))
-                .toBe('Content-Length, Content-Type, X-App-Version');
-        });
-        it('| idempotens — ha mar benne van, nem duplikal (kis-nagybetu fuggetlenul)', () => {
-            expect((0, app_version_header_util_1.DyNTS_resolveExposeHeaders)('Content-Type, X-App-Version', 'X-App-Version'))
-                .toBe('Content-Type, X-App-Version');
-            expect((0, app_version_header_util_1.DyNTS_resolveExposeHeaders)('content-type, x-app-version', 'X-App-Version'))
-                .toBe('content-type, x-app-version');
-        });
-    });
-    describe('| DyNTS_createAppVersionHeaderMiddleware', () => {
-        it('| kiirja a verziot ES exposeolja a CORS-nak', () => {
-            const res = makeRes();
-            let nextCalled = false;
-            (0, app_version_header_util_1.DyNTS_createAppVersionHeaderMiddleware)(() => '01.15.460')({}, res, (() => { nextCalled = true; }));
-            expect(res.headers[app_version_header_util_1.DYNTS_APP_VERSION_HEADER]).toBe('01.15.460');
-            expect(res.headers['Access-Control-Expose-Headers']).toContain(app_version_header_util_1.DYNTS_APP_VERSION_HEADER);
-            expect(nextCalled).toBe(true);
-        });
-        it('| ISMERETLEN verzional nem ir headert — de a lancot TOVABBENGEDI', () => {
-            for (const version of [undefined, '', 'unknown-version']) {
-                const res = makeRes();
-                let nextCalled = false;
-                (0, app_version_header_util_1.DyNTS_createAppVersionHeaderMiddleware)(() => version)({}, res, (() => { nextCalled = true; }));
-                expect(res.headers[app_version_header_util_1.DYNTS_APP_VERSION_HEADER]).withContext(String(version)).toBeUndefined();
-                expect(nextCalled).withContext(String(version)).toBe(true);
-            }
-        });
-        /**
-         * A verziót a HÍVÁSKOR kell olvasni: a `systemVersion` az app-params betöltésekor áll be,
-         * ami a middleware felszerelése UTÁN történik. Ha a middleware befagyasztaná az értéket,
-         * a fejléc örökre hiányozna — pont a friss deployon.
-         */
-        it('| a verziot HIVASKOR olvassa, nem felszereleskor', () => {
-            let current = 'unknown-version';
-            const middleware = (0, app_version_header_util_1.DyNTS_createAppVersionHeaderMiddleware)(() => current);
-            const firstRes = makeRes();
-            middleware({}, firstRes, (() => undefined));
-            expect(firstRes.headers[app_version_header_util_1.DYNTS_APP_VERSION_HEADER]).toBeUndefined();
-            current = '01.15.461'; // app-params betoltodott
-            const secondRes = makeRes();
-            middleware({}, secondRes, (() => undefined));
-            expect(secondRes.headers[app_version_header_util_1.DYNTS_APP_VERSION_HEADER]).toBe('01.15.461');
-        });
-        it('| egyedi header-nev is hasznalhato', () => {
-            const res = makeRes();
-            (0, app_version_header_util_1.DyNTS_createAppVersionHeaderMiddleware)(() => '1.2.3', 'X-Custom-Version')({}, res, (() => undefined));
-            expect(res.headers['X-Custom-Version']).toBe('1.2.3');
-            expect(res.headers['Access-Control-Expose-Headers']).toBe('X-Custom-Version');
-        });
-    });
-});
-//# sourceMappingURL=app-version-header.util.spec.js.map

package/build/_collections/app-version-header.util.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-version-header.util.spec.js","sourceRoot":"","sources":["../../src/_collections/app-version-header.util.spec.ts"],"names":[],"mappings":"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"}

package/build/_collections/archive.util.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=archive.util.spec.d.ts.map

package/build/_collections/archive.util.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"archive.util.spec.d.ts","sourceRoot":"","sources":["../../src/_collections/archive.util.spec.ts"],"names":[],"mappings":""}

package/build/_collections/archive.util.spec.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const archive_util_1 = require("./archive.util");
-describe('| DyNTS_getArchivedDBName', () => {
-    it('| should append the archive suffix to the database name', () => {
-        const dbName = 'TestDB';
-        const expectedArchivedName = `${dbName}_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should return only the archive suffix when the database name is an empty string', () => {
-        const dbName = '';
-        const expectedArchivedName = `_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should handle database names with special characters', () => {
-        const dbName = 'Test_DB-123!';
-        const expectedArchivedName = `${dbName}_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should handle database names with spaces', () => {
-        const dbName = 'Test DB Name';
-        const expectedArchivedName = `${dbName}_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should handle database names with numbers', () => {
-        const dbName = 'DB123';
-        const expectedArchivedName = `${dbName}_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should handle very long database names', () => {
-        const dbName = 'A'.repeat(100);
-        const expectedArchivedName = `${dbName}_${archive_util_1.DyNTS_archiveSuffix}`;
-        expect((0, archive_util_1.DyNTS_getArchivedDBName)(dbName)).toBe(expectedArchivedName);
-    });
-    it('| should use the correct archive suffix constant', () => {
-        expect(archive_util_1.DyNTS_archiveSuffix).toBe('archived');
-        const dbName = 'TestDB';
-        const result = (0, archive_util_1.DyNTS_getArchivedDBName)(dbName);
-        expect(result).toContain('archived');
-        expect(result).toBe('TestDB_archived');
-    });
-});
-describe('| DyNTS_archiveSuffix', () => {
-    it('| should have the correct value', () => {
-        expect(archive_util_1.DyNTS_archiveSuffix).toBe('archived');
-    });
-    it('| should be a string', () => {
-        expect(typeof archive_util_1.DyNTS_archiveSuffix).toBe('string');
-    });
-});
-//# sourceMappingURL=archive.util.spec.js.map

package/build/_collections/archive.util.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"archive.util.spec.js","sourceRoot":"","sources":["../../src/_collections/archive.util.spec.ts"],"names":[],"mappings":";;AAAA,iDAA8E;AAE9E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,QAAQ,CAAC;QACxB,MAAM,oBAAoB,GAAG,GAAG,MAAM,IAAI,kCAAmB,EAAE,CAAC;QAChE,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,MAAM,oBAAoB,GAAG,IAAI,kCAAmB,EAAE,CAAC;QACvD,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,cAAc,CAAC;QAC9B,MAAM,oBAAoB,GAAG,GAAG,MAAM,IAAI,kCAAmB,EAAE,CAAC;QAChE,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,cAAc,CAAC;QAC9B,MAAM,oBAAoB,GAAG,GAAG,MAAM,IAAI,kCAAmB,EAAE,CAAC;QAChE,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,OAAO,CAAC;QACvB,MAAM,oBAAoB,GAAG,GAAG,MAAM,IAAI,kCAAmB,EAAE,CAAC;QAChE,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,oBAAoB,GAAG,GAAG,MAAM,IAAI,kCAAmB,EAAE,CAAC;QAChE,MAAM,CAAC,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,kCAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC;QACxB,MAAM,MAAM,GAAG,IAAA,sCAAuB,EAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,kCAAmB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,OAAO,kCAAmB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/_collections/client-safe-error.util.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=client-safe-error.util.spec.d.ts.map

package/build/_collections/client-safe-error.util.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-safe-error.util.spec.d.ts","sourceRoot":"","sources":["../../src/_collections/client-safe-error.util.spec.ts"],"names":[],"mappings":""}