@futdevpro/fsm-dynamo 1.15.17 → 1.15.20

package/src/_modules/socket/index.ts

@@ -1,14 +1,14 @@
-
-
-
-// ENUMS
-export * from './_enums/sck-event-key.enum';
-
-
-// MODELS
-export * from './_models/sck-client-params.control-model';
-export * from './_models/sck-socket-event.control-model';
-
-
-// SERVICES
-export * from './_services/sck-client.service-base';
+
+
+
+// ENUMS
+export * from './_enums/sck-event-key.enum';
+
+
+// MODELS
+export * from './_models/sck-client-params.control-model';
+export * from './_models/sck-socket-event.control-model';
+
+
+// SERVICES
+export * from './_services/sck-client.service-base';

package/src/_modules/test/_collections/tst-module-settings.const.ts

@@ -1,67 +1,67 @@
-import {
-  DyFM_EndpointTypesContainer,
-  DyFM_ServiceEndpointTypesSettings
-} from '../../../_models/control-models/service-endpoint-settings-base.control-model';
-import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
-
-/**
- * Routes used by the test module.
- */
-export enum DyFM_TestRoute {
-  testGet = 'test-get',
-  testPost = 'test-post',
-  testPut = 'test-put',
-  testPatch = 'test-patch',
-  testDelete = 'test-delete',
-  getServerStatus = 'get-server-status',
-}
-
-/**
- * Default route settings for the test module.
- */
-export const DyFM_testModule_settings: DyFM_Route_Settings<DyFM_TestRoute> = {
-  mainRoute: '/test',
-  endPoints: {
-    ...Object.fromEntries(
-      Object.values(DyFM_TestRoute).map((route) => [route, `/${route}`])
-    ),
-  },
-};
-
-/**
- * Map of routes with their full path.
- */
-export const DyFM_fullTestRoute = {
-  [DyFM_TestRoute.testGet]: DyFM_testModule_settings.mainRoute + 
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testGet],
-  [DyFM_TestRoute.testPost]: DyFM_testModule_settings.mainRoute +
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPost],
-  [DyFM_TestRoute.testPut]: DyFM_testModule_settings.mainRoute +
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPut],
-  [DyFM_TestRoute.testPatch]: DyFM_testModule_settings.mainRoute +
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPatch],
-  [DyFM_TestRoute.testDelete]: DyFM_testModule_settings.mainRoute +
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testDelete],
-  [DyFM_TestRoute.getServerStatus]: DyFM_testModule_settings.mainRoute +
-    DyFM_testModule_settings.endPoints[DyFM_TestRoute.getServerStatus],
-};
-
-export interface DyFM_Test_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
-  [DyFM_TestRoute.testGet]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
-  [DyFM_TestRoute.testPost]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-  [DyFM_TestRoute.testPut]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-  [DyFM_TestRoute.testPatch]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-  [DyFM_TestRoute.testDelete]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
-  [DyFM_TestRoute.getServerStatus]: DyFM_EndpointTypesContainer<{
-    status: 'ready',
-    version: string,
-    upTime: number,
-  }>;
-}
-
-interface DyFM_Test_Result {
-  url: string;
-  result: string;
-  request: any;
-}
-
+import {
+  DyFM_EndpointTypesContainer,
+  DyFM_ServiceEndpointTypesSettings
+} from '../../../_models/control-models/service-endpoint-settings-base.control-model';
+import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
+
+/**
+ * Routes used by the test module.
+ */
+export enum DyFM_TestRoute {
+  testGet = 'test-get',
+  testPost = 'test-post',
+  testPut = 'test-put',
+  testPatch = 'test-patch',
+  testDelete = 'test-delete',
+  getServerStatus = 'get-server-status',
+}
+
+/**
+ * Default route settings for the test module.
+ */
+export const DyFM_testModule_settings: DyFM_Route_Settings<DyFM_TestRoute> = {
+  mainRoute: '/test',
+  endPoints: {
+    ...Object.fromEntries(
+      Object.values(DyFM_TestRoute).map((route) => [route, `/${route}`])
+    ),
+  },
+};
+
+/**
+ * Map of routes with their full path.
+ */
+export const DyFM_fullTestRoute = {
+  [DyFM_TestRoute.testGet]: DyFM_testModule_settings.mainRoute + 
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testGet],
+  [DyFM_TestRoute.testPost]: DyFM_testModule_settings.mainRoute +
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPost],
+  [DyFM_TestRoute.testPut]: DyFM_testModule_settings.mainRoute +
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPut],
+  [DyFM_TestRoute.testPatch]: DyFM_testModule_settings.mainRoute +
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testPatch],
+  [DyFM_TestRoute.testDelete]: DyFM_testModule_settings.mainRoute +
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.testDelete],
+  [DyFM_TestRoute.getServerStatus]: DyFM_testModule_settings.mainRoute +
+    DyFM_testModule_settings.endPoints[DyFM_TestRoute.getServerStatus],
+};
+
+export interface DyFM_Test_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
+  [DyFM_TestRoute.testGet]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
+  [DyFM_TestRoute.testPost]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+  [DyFM_TestRoute.testPut]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+  [DyFM_TestRoute.testPatch]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+  [DyFM_TestRoute.testDelete]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
+  [DyFM_TestRoute.getServerStatus]: DyFM_EndpointTypesContainer<{
+    status: 'ready',
+    version: string,
+    upTime: number,
+  }>;
+}
+
+interface DyFM_Test_Result {
+  url: string;
+  result: string;
+  request: any;
+}
+

package/src/_modules/test/index.ts

@@ -1,5 +1,5 @@
-
-// COLLECTIONS
-export * from './_collections/tst-module-settings.const';
-
-
+
+// COLLECTIONS
+export * from './_collections/tst-module-settings.const';
+
+

package/src/_modules/usage/_collections/usg-module-settings.const.ts

@@ -1,33 +1,33 @@
-
-import { DyFM_RelativeDate } from '../../../_enums/time/relative-date.enum';
-import {
-  DyFM_EndpointTypesContainer, DyFM_ServiceEndpointTypesSettings
-} from '../../../_models/control-models/service-endpoint-settings-base.control-model';
-import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
-import { DyFM_DailyUsageData } from '../_models/usg-daily-usage-data.control-model';
-import { DyFM_UsageData } from '../_models/usg-data.control-model';
-import { DyFM_UsageSession } from '../_models/usg-session.data-model';
-
-export enum DyFM_UsageRoute {
-  newSession = 'newSession',
-  closeSession = 'closeSession',
-  updateUsage = 'updateUsage',
-  getUsageData = 'getUsageData',
-}
-
-export const DyFM_usageModule_settings: DyFM_Route_Settings<DyFM_UsageRoute> = {
-  mainRoute: '/usage',
-  endPoints: {
-    [DyFM_UsageRoute.newSession]: '/new-session',
-    [DyFM_UsageRoute.closeSession]: '/close-session/:sessionId',
-    [DyFM_UsageRoute.updateUsage]:  '/update/:sessionId',
-    [DyFM_UsageRoute.getUsageData]: '/get/:range',
-  },
-};
-
-export interface DyFM_Usage_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
-  [DyFM_UsageRoute.newSession]: DyFM_EndpointTypesContainer<DyFM_UsageSession>;
-  [DyFM_UsageRoute.closeSession]: DyFM_EndpointTypesContainer<DyFM_UsageSession, [ string ]>;
-  [DyFM_UsageRoute.updateUsage]: DyFM_EndpointTypesContainer<DyFM_UsageSession, [ string, DyFM_UsageData[], DyFM_UsageData[] ]>;
-  [DyFM_UsageRoute.getUsageData]: DyFM_EndpointTypesContainer<DyFM_DailyUsageData[], [ DyFM_RelativeDate ]>;
-}
+
+import { DyFM_RelativeDate } from '../../../_enums/time/relative-date.enum';
+import {
+  DyFM_EndpointTypesContainer, DyFM_ServiceEndpointTypesSettings
+} from '../../../_models/control-models/service-endpoint-settings-base.control-model';
+import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
+import { DyFM_DailyUsageData } from '../_models/usg-daily-usage-data.control-model';
+import { DyFM_UsageData } from '../_models/usg-data.control-model';
+import { DyFM_UsageSession } from '../_models/usg-session.data-model';
+
+export enum DyFM_UsageRoute {
+  newSession = 'newSession',
+  closeSession = 'closeSession',
+  updateUsage = 'updateUsage',
+  getUsageData = 'getUsageData',
+}
+
+export const DyFM_usageModule_settings: DyFM_Route_Settings<DyFM_UsageRoute> = {
+  mainRoute: '/usage',
+  endPoints: {
+    [DyFM_UsageRoute.newSession]: '/new-session',
+    [DyFM_UsageRoute.closeSession]: '/close-session/:sessionId',
+    [DyFM_UsageRoute.updateUsage]:  '/update/:sessionId',
+    [DyFM_UsageRoute.getUsageData]: '/get/:range',
+  },
+};
+
+export interface DyFM_Usage_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
+  [DyFM_UsageRoute.newSession]: DyFM_EndpointTypesContainer<DyFM_UsageSession>;
+  [DyFM_UsageRoute.closeSession]: DyFM_EndpointTypesContainer<DyFM_UsageSession, [ string ]>;
+  [DyFM_UsageRoute.updateUsage]: DyFM_EndpointTypesContainer<DyFM_UsageSession, [ string, DyFM_UsageData[], DyFM_UsageData[] ]>;
+  [DyFM_UsageRoute.getUsageData]: DyFM_EndpointTypesContainer<DyFM_DailyUsageData[], [ DyFM_RelativeDate ]>;
+}

package/src/_modules/usage/_models/usg-action.control-model.spec.ts

@@ -1,27 +1,27 @@
-
-import { DyFM_UsageAction } from './usg-action.control-model';
-
-describe('| DyFM_UsageAction', () => {
-
-  it('| should create an instance with default values', () => {
-    const action = new DyFM_UsageAction();
-    expect(action.action).toBeUndefined();
-    expect(action.time).toBeUndefined();
-  });
-
-  it('| should create an instance with provided values', () => {
-    const date = new Date();
-    const action = new DyFM_UsageAction({ action: 'testAction', time: date });
-    expect(action.action).toBe('testAction');
-    expect(action.time).toBe(date);
-  });
-
-  it('| should assign properties from another DyFM_UsageAction instance', () => {
-    const date = new Date();
-    const sourceAction = new DyFM_UsageAction({ action: 'sourceAction', time: date });
-    const newAction = new DyFM_UsageAction(sourceAction);
-    expect(newAction.action).toBe('sourceAction');
-    expect(newAction.time).toBe(date);
-  });
-
-});
+
+import { DyFM_UsageAction } from './usg-action.control-model';
+
+describe('| DyFM_UsageAction', () => {
+
+  it('| should create an instance with default values', () => {
+    const action = new DyFM_UsageAction();
+    expect(action.action).toBeUndefined();
+    expect(action.time).toBeUndefined();
+  });
+
+  it('| should create an instance with provided values', () => {
+    const date = new Date();
+    const action = new DyFM_UsageAction({ action: 'testAction', time: date });
+    expect(action.action).toBe('testAction');
+    expect(action.time).toBe(date);
+  });
+
+  it('| should assign properties from another DyFM_UsageAction instance', () => {
+    const date = new Date();
+    const sourceAction = new DyFM_UsageAction({ action: 'sourceAction', time: date });
+    const newAction = new DyFM_UsageAction(sourceAction);
+    expect(newAction.action).toBe('sourceAction');
+    expect(newAction.time).toBe(date);
+  });
+
+});

package/src/_modules/usage/_models/usg-action.control-model.ts

@@ -1,28 +1,28 @@
-
-
-/**
- * Represents a single user action during a session.
- *
- * @example
- * ```ts
- * const action = new DyFM_UsageAction({
- *   action: 'click',
- *   time: new Date()
- * });
- * ```
- */
-export class DyFM_UsageAction {
-  /** Type of the action performed */
-  action?: string;
-  /** Timestamp of when the action happened */
-  time?: Date;
-
-  constructor(
-    set?: DyFM_UsageAction
-  ) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
+
+
+/**
+ * Represents a single user action during a session.
+ *
+ * @example
+ * ```ts
+ * const action = new DyFM_UsageAction({
+ *   action: 'click',
+ *   time: new Date()
+ * });
+ * ```
+ */
+export class DyFM_UsageAction {
+  /** Type of the action performed */
+  action?: string;
+  /** Timestamp of when the action happened */
+  time?: Date;
+
+  constructor(
+    set?: DyFM_UsageAction
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+

package/src/_modules/usage/_models/usg-daily-usage-data.control-model.spec.ts

@@ -1,36 +1,36 @@
-
-import { DyFM_DailyUsageData } from './usg-daily-usage-data.control-model';
-import { DyFM_UsageSession } from './usg-session.data-model';
-
-describe('| DyFM_DailyUsageData', () => {
-  it('| should create an instance with default values', () => {
-    const instance = new DyFM_DailyUsageData();
-    expect(instance.date).toBeUndefined();
-    expect(instance.totalVisitTime).toBe(0);
-    expect(instance.averageVisitTime).toBe(0);
-    expect(instance.visitorsHun).toBe(0);
-    expect(instance.visitorsElse).toBe(0);
-    expect(instance.visitations).toEqual([]);
-  });
-
-  it('| should create an instance with provided values', () => {
-    const usageSession: DyFM_UsageSession = { /* mock session data */ };
-    const data: DyFM_DailyUsageData = {
-      date: '2023-10-01',
-      totalVisitTime: 120,
-      averageVisitTime: 30,
-      visitorsHun: 10,
-      visitorsElse: 5,
-      visitations: [usageSession]
-    };
-
-    const instance = new DyFM_DailyUsageData(data);
-
-    expect(instance.date).toBe('2023-10-01');
-    expect(instance.totalVisitTime).toBe(120);
-    expect(instance.averageVisitTime).toBe(30);
-    expect(instance.visitorsHun).toBe(10);
-    expect(instance.visitorsElse).toBe(5);
-    expect(instance.visitations).toEqual([usageSession]);
-  });
-});
+
+import { DyFM_DailyUsageData } from './usg-daily-usage-data.control-model';
+import { DyFM_UsageSession } from './usg-session.data-model';
+
+describe('| DyFM_DailyUsageData', () => {
+  it('| should create an instance with default values', () => {
+    const instance = new DyFM_DailyUsageData();
+    expect(instance.date).toBeUndefined();
+    expect(instance.totalVisitTime).toBe(0);
+    expect(instance.averageVisitTime).toBe(0);
+    expect(instance.visitorsHun).toBe(0);
+    expect(instance.visitorsElse).toBe(0);
+    expect(instance.visitations).toEqual([]);
+  });
+
+  it('| should create an instance with provided values', () => {
+    const usageSession: DyFM_UsageSession = { /* mock session data */ };
+    const data: DyFM_DailyUsageData = {
+      date: '2023-10-01',
+      totalVisitTime: 120,
+      averageVisitTime: 30,
+      visitorsHun: 10,
+      visitorsElse: 5,
+      visitations: [usageSession]
+    };
+
+    const instance = new DyFM_DailyUsageData(data);
+
+    expect(instance.date).toBe('2023-10-01');
+    expect(instance.totalVisitTime).toBe(120);
+    expect(instance.averageVisitTime).toBe(30);
+    expect(instance.visitorsHun).toBe(10);
+    expect(instance.visitorsElse).toBe(5);
+    expect(instance.visitations).toEqual([usageSession]);
+  });
+});

package/src/_modules/usage/_models/usg-daily-usage-data.control-model.ts

@@ -1,35 +1,35 @@
-
-import { DyFM_UsageSession } from './usg-session.data-model';
-
-
-/**
- * Aggregated usage information for a specific day.
- *
- * @example
- * ```ts
- * const daily = new DyFM_DailyUsageData({ date: '2024-07-20' });
- * ```
- */
-export class DyFM_DailyUsageData {
-  /** ISO date string of the day */
-  date?: string;
-  /** Total time spent on the site that day */
-  totalVisitTime?: number = 0;
-  /** Average time of a single visit */
-  averageVisitTime?: number = 0;
-  /** Number of visitors from Hungary */
-  visitorsHun?: number = 0;
-  /** Number of visitors from other countries */
-  visitorsElse?: number = 0;
-
-  /** Sessions belonging to the day */
-  visitations?: DyFM_UsageSession[] = [];
-
-  constructor(
-    set?: DyFM_DailyUsageData
-  ) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+
+import { DyFM_UsageSession } from './usg-session.data-model';
+
+
+/**
+ * Aggregated usage information for a specific day.
+ *
+ * @example
+ * ```ts
+ * const daily = new DyFM_DailyUsageData({ date: '2024-07-20' });
+ * ```
+ */
+export class DyFM_DailyUsageData {
+  /** ISO date string of the day */
+  date?: string;
+  /** Total time spent on the site that day */
+  totalVisitTime?: number = 0;
+  /** Average time of a single visit */
+  averageVisitTime?: number = 0;
+  /** Number of visitors from Hungary */
+  visitorsHun?: number = 0;
+  /** Number of visitors from other countries */
+  visitorsElse?: number = 0;
+
+  /** Sessions belonging to the day */
+  visitations?: DyFM_UsageSession[] = [];
+
+  constructor(
+    set?: DyFM_DailyUsageData
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/usage/_models/usg-data.control-model.spec.ts

@@ -1,41 +1,41 @@
-
-import { DyFM_UsageData, DyFM_UsageD } from './usg-data.control-model';
-import { DyFM_UsageAction } from './usg-action.control-model';
-
-describe('| DyFM_UsageData', () => {
-  it('| should create an instance with default values', () => {
-    const usageData = new DyFM_UsageData();
-    expect(usageData.page).toBeUndefined();
-    expect(usageData.opened).toBeUndefined();
-    expect(usageData.timeSpentOnPage).toBeUndefined();
-    expect(usageData.actions).toEqual([]);
-  });
-
-  it('| should create an instance with provided values', () => {
-    const actions: DyFM_UsageAction[] = [{ /* mock action data */ }];
-    const set: DyFM_UsageData = {
-      page: 'HomePage',
-      opened: new Date('2023-10-01T10:00:00Z'),
-      timeSpentOnPage: 120,
-      actions: actions
-    };
-    const usageData = new DyFM_UsageData(set);
-
-    expect(usageData.page).toBe('HomePage');
-    expect(usageData.opened).toEqual(new Date('2023-10-01T10:00:00Z'));
-    expect(usageData.timeSpentOnPage).toBe(120);
-    expect(usageData.actions).toEqual(actions);
-  });
-
-  it('| should create an instance with partial provided values', () => {
-    const set: Partial<DyFM_UsageData> = {
-      page: 'ContactPage'
-    };
-    const usageData = new DyFM_UsageData(set as DyFM_UsageData);
-
-    expect(usageData.page).toBe('ContactPage');
-    expect(usageData.opened).toBeUndefined();
-    expect(usageData.timeSpentOnPage).toBeUndefined();
-    expect(usageData.actions).toEqual([]);
-  });
-});
+
+import { DyFM_UsageData, DyFM_UsageD } from './usg-data.control-model';
+import { DyFM_UsageAction } from './usg-action.control-model';
+
+describe('| DyFM_UsageData', () => {
+  it('| should create an instance with default values', () => {
+    const usageData = new DyFM_UsageData();
+    expect(usageData.page).toBeUndefined();
+    expect(usageData.opened).toBeUndefined();
+    expect(usageData.timeSpentOnPage).toBeUndefined();
+    expect(usageData.actions).toEqual([]);
+  });
+
+  it('| should create an instance with provided values', () => {
+    const actions: DyFM_UsageAction[] = [{ /* mock action data */ }];
+    const set: DyFM_UsageData = {
+      page: 'HomePage',
+      opened: new Date('2023-10-01T10:00:00Z'),
+      timeSpentOnPage: 120,
+      actions: actions
+    };
+    const usageData = new DyFM_UsageData(set);
+
+    expect(usageData.page).toBe('HomePage');
+    expect(usageData.opened).toEqual(new Date('2023-10-01T10:00:00Z'));
+    expect(usageData.timeSpentOnPage).toBe(120);
+    expect(usageData.actions).toEqual(actions);
+  });
+
+  it('| should create an instance with partial provided values', () => {
+    const set: Partial<DyFM_UsageData> = {
+      page: 'ContactPage'
+    };
+    const usageData = new DyFM_UsageData(set as DyFM_UsageData);
+
+    expect(usageData.page).toBe('ContactPage');
+    expect(usageData.opened).toBeUndefined();
+    expect(usageData.timeSpentOnPage).toBeUndefined();
+    expect(usageData.actions).toEqual([]);
+  });
+});

package/src/_modules/usage/_models/usg-data.control-model.ts

@@ -1,35 +1,35 @@
-
-import { DyFM_UsageAction } from './usg-action.control-model';
-
-export type DyFM_UsageD = DyFM_UsageData;
-/**
- * Detailed usage information for a single page visit.
- *
- * @example
- * ```ts
- * const data = new DyFM_UsageData({
- *   page: '/home',
- *   opened: new Date(),
- *   timeSpentOnPage: 120
- * });
- * ```
- */
-export class DyFM_UsageData {
-  /** URL or identifier of the visited page */
-  page?: string;
-  /** When the page was opened */
-  opened?: Date;
-  /** Time spent on the page in seconds */
-  timeSpentOnPage?: number;
-  /** List of actions performed on the page */
-  actions?: DyFM_UsageAction[] = [];
-
-  constructor(
-    set?: DyFM_UsageData
-  ) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
+
+import { DyFM_UsageAction } from './usg-action.control-model';
+
+export type DyFM_UsageD = DyFM_UsageData;
+/**
+ * Detailed usage information for a single page visit.
+ *
+ * @example
+ * ```ts
+ * const data = new DyFM_UsageData({
+ *   page: '/home',
+ *   opened: new Date(),
+ *   timeSpentOnPage: 120
+ * });
+ * ```
+ */
+export class DyFM_UsageData {
+  /** URL or identifier of the visited page */
+  page?: string;
+  /** When the page was opened */
+  opened?: Date;
+  /** Time spent on the page in seconds */
+  timeSpentOnPage?: number;
+  /** List of actions performed on the page */
+  actions?: DyFM_UsageAction[] = [];
+
+  constructor(
+    set?: DyFM_UsageData
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+