@futdevpro/fsm-dynamo 1.15.18 → 1.15.21

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

@@ -1,97 +1,97 @@
-import { DyFM_BasicProperty_Type } from '../../../_enums/basic-property-type.enum';
-import { DyFM_DataProperties } from '../../../_models/control-models/data-property-params.control-model';
-import { DyFM_GeoIpLocation } from '../../location/_models/loc-geo-ip-location.interface';
-import { DyFM_UsageData } from './usg-data.control-model';
-import { DyFM_UsageSession, DyFM_usageSession_dataParams } from './usg-session.data-model';
-
-describe('| DyFM_UsageSession', () => {
-  it('| should create an instance with default values', () => {
-    const session = new DyFM_UsageSession();
-    expect(session.date).toBeUndefined();
-    expect(session.sessionStart).toBeUndefined();
-    expect(session.sessionEnd).toBeUndefined();
-    expect(session.address).toBeUndefined();
-    expect(session.issuer).toBeUndefined();
-    expect(session.locationData).toBeUndefined();
-    expect(session.usageData).toEqual([]);
-    expect(session.totalSessionTime).toBeUndefined();
-    expect(session.loggedInAs).toBeUndefined();
-  });
-
-  it('| should assign values from the provided set', () => {
-    const set: DyFM_UsageSession = {
-      date: '2023-10-01',
-      sessionStart: new Date('2023-10-01T10:00:00Z'),
-      sessionEnd: new Date('2023-10-01T12:00:00Z'),
-      address: '123 Main St',
-      issuer: 'Issuer Name',
-      locationData: {} as DyFM_GeoIpLocation,
-      usageData: [{} as DyFM_UsageData],
-      totalSessionTime: 7200,
-      loggedInAs: 'user@example.com'
-    };
-
-    const session = new DyFM_UsageSession(set);
-    expect(session.date).toBe('2023-10-01');
-    expect(session.sessionStart).toEqual(new Date('2023-10-01T10:00:00Z'));
-    expect(session.sessionEnd).toEqual(new Date('2023-10-01T12:00:00Z'));
-    expect(session.address).toBe('123 Main St');
-    expect(session.issuer).toBe('Issuer Name');
-    /* expect(session.locationData).toEqual({}); */
-    expect(session.usageData).toEqual([{}]);
-    expect(session.totalSessionTime).toBe(7200);
-    expect(session.loggedInAs).toBe('user@example.com');
-  });
-
-  it('| should set the date based on sessionStart if date is not provided', () => {
-    const sessionStart = new Date('2023-10-01T10:00:00Z');
-    const set: DyFM_UsageSession = {
-      sessionStart
-    };
-
-    const session = new DyFM_UsageSession(set);
-    expect(session.date).toBe('2023-10-01');
-  });
-});
-
-describe('| DyFM_usageSession_dataParams', () => {
-  it('| should have the correct dataName', () => {
-    expect(DyFM_usageSession_dataParams.dataName).toBe('usage_session');
-  });
-
-  it('| should have the correct properties configuration', () => {
-    const properties: DyFM_DataProperties<DyFM_UsageSession> = DyFM_usageSession_dataParams.properties;
-    expect(properties.date.key).toBe('date');
-    expect(properties.date.type).toBe(DyFM_BasicProperty_Type.string);
-    expect(properties.date.required).toBe(true);
-    expect(properties.date.index).toBe(true);
-
-    expect(properties.sessionStart.key).toBe('sessionStart');
-    expect(properties.sessionStart.type).toBe(DyFM_BasicProperty_Type.date);
-    expect(properties.sessionStart.required).toBe(true);
-    expect(properties.sessionStart.index).toBe(true);
-
-    expect(properties.sessionEnd.key).toBe('sessionEnd');
-    expect(properties.sessionEnd.type).toBe(DyFM_BasicProperty_Type.date);
-
-    expect(properties.address.key).toBe('address');
-    expect(properties.address.type).toBe(DyFM_BasicProperty_Type.string);
-
-    expect(properties.issuer.key).toBe('issuer');
-    expect(properties.issuer.type).toBe(DyFM_BasicProperty_Type.string);
-
-    expect(properties.locationData.key).toBe('locationData');
-    expect(properties.locationData.type).toBe(DyFM_BasicProperty_Type.object);
-    expect(properties.locationData.nonBasicType).toBe('IpApiLocation');
-
-    expect(properties.usageData.key).toBe('usageData');
-    expect(properties.usageData.type).toBe(DyFM_BasicProperty_Type.array);
-    expect(properties.usageData.nonBasicType).toBe('UsageData[]');
-
-    expect(properties.totalSessionTime.key).toBe('totalSessionTime');
-    expect(properties.totalSessionTime.type).toBe(DyFM_BasicProperty_Type.number);
-
-    expect(properties.loggedInAs.key).toBe('loggedInAs');
-    expect(properties.loggedInAs.type).toBe(DyFM_BasicProperty_Type.string);
-  });
-});
+import { DyFM_BasicProperty_Type } from '../../../_enums/basic-property-type.enum';
+import { DyFM_DataProperties } from '../../../_models/control-models/data-property-params.control-model';
+import { DyFM_GeoIpLocation } from '../../location/_models/loc-geo-ip-location.interface';
+import { DyFM_UsageData } from './usg-data.control-model';
+import { DyFM_UsageSession, DyFM_usageSession_dataParams } from './usg-session.data-model';
+
+describe('| DyFM_UsageSession', () => {
+  it('| should create an instance with default values', () => {
+    const session = new DyFM_UsageSession();
+    expect(session.date).toBeUndefined();
+    expect(session.sessionStart).toBeUndefined();
+    expect(session.sessionEnd).toBeUndefined();
+    expect(session.address).toBeUndefined();
+    expect(session.issuer).toBeUndefined();
+    expect(session.locationData).toBeUndefined();
+    expect(session.usageData).toEqual([]);
+    expect(session.totalSessionTime).toBeUndefined();
+    expect(session.loggedInAs).toBeUndefined();
+  });
+
+  it('| should assign values from the provided set', () => {
+    const set: DyFM_UsageSession = {
+      date: '2023-10-01',
+      sessionStart: new Date('2023-10-01T10:00:00Z'),
+      sessionEnd: new Date('2023-10-01T12:00:00Z'),
+      address: '123 Main St',
+      issuer: 'Issuer Name',
+      locationData: {} as DyFM_GeoIpLocation,
+      usageData: [{} as DyFM_UsageData],
+      totalSessionTime: 7200,
+      loggedInAs: 'user@example.com'
+    };
+
+    const session = new DyFM_UsageSession(set);
+    expect(session.date).toBe('2023-10-01');
+    expect(session.sessionStart).toEqual(new Date('2023-10-01T10:00:00Z'));
+    expect(session.sessionEnd).toEqual(new Date('2023-10-01T12:00:00Z'));
+    expect(session.address).toBe('123 Main St');
+    expect(session.issuer).toBe('Issuer Name');
+    /* expect(session.locationData).toEqual({}); */
+    expect(session.usageData).toEqual([{}]);
+    expect(session.totalSessionTime).toBe(7200);
+    expect(session.loggedInAs).toBe('user@example.com');
+  });
+
+  it('| should set the date based on sessionStart if date is not provided', () => {
+    const sessionStart = new Date('2023-10-01T10:00:00Z');
+    const set: DyFM_UsageSession = {
+      sessionStart
+    };
+
+    const session = new DyFM_UsageSession(set);
+    expect(session.date).toBe('2023-10-01');
+  });
+});
+
+describe('| DyFM_usageSession_dataParams', () => {
+  it('| should have the correct dataName', () => {
+    expect(DyFM_usageSession_dataParams.dataName).toBe('usage_session');
+  });
+
+  it('| should have the correct properties configuration', () => {
+    const properties: DyFM_DataProperties<DyFM_UsageSession> = DyFM_usageSession_dataParams.properties;
+    expect(properties.date.key).toBe('date');
+    expect(properties.date.type).toBe(DyFM_BasicProperty_Type.string);
+    expect(properties.date.required).toBe(true);
+    expect(properties.date.index).toBe(true);
+
+    expect(properties.sessionStart.key).toBe('sessionStart');
+    expect(properties.sessionStart.type).toBe(DyFM_BasicProperty_Type.date);
+    expect(properties.sessionStart.required).toBe(true);
+    expect(properties.sessionStart.index).toBe(true);
+
+    expect(properties.sessionEnd.key).toBe('sessionEnd');
+    expect(properties.sessionEnd.type).toBe(DyFM_BasicProperty_Type.date);
+
+    expect(properties.address.key).toBe('address');
+    expect(properties.address.type).toBe(DyFM_BasicProperty_Type.string);
+
+    expect(properties.issuer.key).toBe('issuer');
+    expect(properties.issuer.type).toBe(DyFM_BasicProperty_Type.string);
+
+    expect(properties.locationData.key).toBe('locationData');
+    expect(properties.locationData.type).toBe(DyFM_BasicProperty_Type.object);
+    expect(properties.locationData.nonBasicType).toBe('IpApiLocation');
+
+    expect(properties.usageData.key).toBe('usageData');
+    expect(properties.usageData.type).toBe(DyFM_BasicProperty_Type.array);
+    expect(properties.usageData.nonBasicType).toBe('UsageData[]');
+
+    expect(properties.totalSessionTime.key).toBe('totalSessionTime');
+    expect(properties.totalSessionTime.type).toBe(DyFM_BasicProperty_Type.number);
+
+    expect(properties.loggedInAs.key).toBe('loggedInAs');
+    expect(properties.loggedInAs.type).toBe(DyFM_BasicProperty_Type.string);
+  });
+});

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

@@ -1,72 +1,72 @@
-
-import {
-  DyFM_DataModel_Params
-} from '../../../_models/control-models/data-model-params.control-model';
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_GeoIpLocation } from '../../location/_models/loc-geo-ip-location.interface';
-
-import { DyFM_UsageData } from './usg-data.control-model';
-
-/**
- * Represents a user session including all tracked data.
- *
- * @example
- * ```ts
- * const session = new DyFM_UsageSession({ sessionStart: new Date() });
- * ```
- */
-export class DyFM_UsageSession extends DyFM_Metadata {
-  /** ISO date string of the session */
-  date?: string;
-  /** Start time of the session */
-  sessionStart?: Date;
-  /** End time of the session */
-  sessionEnd?: Date;
-  /** IP address or identifier */
-  address?: string;
-  /** Issuer of the session (e.g., user agent) */
-  issuer?: string;
-  /** Geolocation data if available */
-  locationData?: DyFM_GeoIpLocation;
-
-  /** Actions performed within the session */
-  usageData?: DyFM_UsageData[] = [];
-  /** Total session time in seconds */
-  totalSessionTime?: number;
-  /** Identifier of the logged in user */
-  loggedInAs?: string;
-
-  constructor(
-    set?: DyFM_UsageSession
-  ) {
-    super(set);
-
-    if (set) {
-      if (!set.date && set.sessionStart) {
-        set.date = set.sessionStart.toISOString().substring(0, 10);
-      }
-
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyFM_usageSession_dataParams: DyFM_DataModel_Params<DyFM_UsageSession> = 
-  new DyFM_DataModel_Params<DyFM_UsageSession>({
-    dataName: 'usage_session',
-    properties: {
-      date: { key: 'date', type: 'string',
-        required: true, index: true,
-      },
-      sessionStart: { key: 'sessionStart', type: 'Date',
-        required: true, index: true,
-      },
-      sessionEnd: { key: 'sessionEnd', type: 'Date' },
-      address: { key: 'address', type: 'string' },
-      issuer: { key: 'issuer', type: 'string' },
-      locationData: { key: 'locationData', type: 'IpApiLocation' },
-      usageData: { key: 'usageData', type: 'UsageData[]' },
-      totalSessionTime: { key: 'totalSessionTime', type: 'number' },
-      loggedInAs: { key: 'loggedInAs', type: 'string' },
-    },
-  });
+
+import {
+  DyFM_DataModel_Params
+} from '../../../_models/control-models/data-model-params.control-model';
+import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
+import { DyFM_GeoIpLocation } from '../../location/_models/loc-geo-ip-location.interface';
+
+import { DyFM_UsageData } from './usg-data.control-model';
+
+/**
+ * Represents a user session including all tracked data.
+ *
+ * @example
+ * ```ts
+ * const session = new DyFM_UsageSession({ sessionStart: new Date() });
+ * ```
+ */
+export class DyFM_UsageSession extends DyFM_Metadata {
+  /** ISO date string of the session */
+  date?: string;
+  /** Start time of the session */
+  sessionStart?: Date;
+  /** End time of the session */
+  sessionEnd?: Date;
+  /** IP address or identifier */
+  address?: string;
+  /** Issuer of the session (e.g., user agent) */
+  issuer?: string;
+  /** Geolocation data if available */
+  locationData?: DyFM_GeoIpLocation;
+
+  /** Actions performed within the session */
+  usageData?: DyFM_UsageData[] = [];
+  /** Total session time in seconds */
+  totalSessionTime?: number;
+  /** Identifier of the logged in user */
+  loggedInAs?: string;
+
+  constructor(
+    set?: DyFM_UsageSession
+  ) {
+    super(set);
+
+    if (set) {
+      if (!set.date && set.sessionStart) {
+        set.date = set.sessionStart.toISOString().substring(0, 10);
+      }
+
+      Object.assign(this, set);
+    }
+  }
+}
+
+export const DyFM_usageSession_dataParams: DyFM_DataModel_Params<DyFM_UsageSession> = 
+  new DyFM_DataModel_Params<DyFM_UsageSession>({
+    dataName: 'usage_session',
+    properties: {
+      date: { key: 'date', type: 'string',
+        required: true, index: true,
+      },
+      sessionStart: { key: 'sessionStart', type: 'Date',
+        required: true, index: true,
+      },
+      sessionEnd: { key: 'sessionEnd', type: 'Date' },
+      address: { key: 'address', type: 'string' },
+      issuer: { key: 'issuer', type: 'string' },
+      locationData: { key: 'locationData', type: 'IpApiLocation' },
+      usageData: { key: 'usageData', type: 'UsageData[]' },
+      totalSessionTime: { key: 'totalSessionTime', type: 'number' },
+      loggedInAs: { key: 'loggedInAs', type: 'string' },
+    },
+  });

package/src/_modules/usage/index.ts

@@ -1,11 +1,11 @@
-
-// COLLECTIONS
-export * from './_collections/usg-module-settings.const';
-
-// MODELS
-export * from './_models/usg-session.data-model';
-export * from './_models/usg-data.control-model';
-export * from './_models/usg-daily-usage-data.control-model';
-export * from './_models/usg-action.control-model';
-
-
+
+// COLLECTIONS
+export * from './_collections/usg-module-settings.const';
+
+// MODELS
+export * from './_models/usg-session.data-model';
+export * from './_models/usg-data.control-model';
+export * from './_models/usg-daily-usage-data.control-model';
+export * from './_models/usg-action.control-model';
+
+

package/src/index.ts

@@ -1,102 +1,102 @@
-
-// COLLECTIONS
-// collections/CONSTANTS
-export * from './_collections/constants/data-sizes.const';
-export * from './_collections/constants/error-defaults.const';
-export * from './_collections/constants/global-settings.const';
-export * from './_collections/constants/numbers.const';
-export * from './_collections/constants/times.const';
-
-// collections/UTILS
-export * from './_collections/utils/array.util';
-export * from './_collections/utils/async.util';
-export * from './_collections/utils/data.util';
-export * from './_collections/utils/extract-error-message.util';
-export * from './_collections/utils/json-error-helper.util';
-export * from './_collections/utils/log.util';
-export * from './_collections/utils/round-list.util';
-export * from './_collections/utils/object.util';
-export * from './_collections/utils/require-env.util';
-export * from './_collections/utils/stack.util';
-export * from './_collections/utils/string.util';
-export * from './_collections/utils/string-case.util';
-export * from './_collections/utils/time.util';
-export * from './_collections/utils/type-cloning-facility.util';
-export * from './_collections/utils/utilities.util';
-export * from './_collections/utils/uuid.util';
-
-// collections/utils/MATH
-export * from './_collections/utils/math/box-bounds.util';
-export * from './_collections/utils/math/math.util';
-export * from './_collections/utils/math/random.util';
-export * from './_collections/utils/math/trigonometry.util';
-export * from './_collections/utils/math/vector2.util';
-
-//  collections/utils/REGEX
-export * from './_collections/utils/regex/password-regex.util';
-export * from './_collections/utils/regex/regex.util';
-export * from './_collections/utils/regex/username-regex.util';
-
-
-// ENUMS
-export * from './_enums/basic-property-type.enum';
-export * from './_enums/data-model-type.enum';
-export * from './_enums/environment-flag.enum';
-export * from './_enums/error-level.enum';
-export * from './_enums/log-style.enum';
-export * from './_enums/server-connection-status.enum';
-
-// enums/HTTP
-export * from './_enums/http/http-call-type.enum';
-export * from './_enums/http/http-event-type.enum';
-export * from './_enums/http/http-response-type.enum';
-
-// enums/PIPE
-export * from './_enums/time/day-of-week.enum';
-export * from './_enums/time/month.enum';
-export * from './_enums/time/relative-date.enum';
-
-
-// MODELS
-// models/CONTROL MODELS
-export * from './_models/control-models/data-model-params.control-model';
-export * from './_models/control-models/data-property-params.control-model';
-export * from './_models/control-models/error.control-model';
-export * from './_models/control-models/poll.control-model';
-export * from './_models/control-models/range-value.control-model';
-export * from './_models/control-models/server-status.control-model';
-export * from './_models/control-models/service-endpoint-settings-base.control-model';
-
-// models/control-models/HTTP
-export * from './_models/control-models/http/http-error-response.control-model';
-export * from './_models/control-models/http/http-headers.control-model';
-export * from './_models/control-models/http/http-response.model-base';
-
-// models/DATA MODELS
-export * from './_models/data-models/errors.data-model';
-export * from './_models/data-models/metadata.data-model';
-
-// models/INTERFACES
-export * from './_models/interfaces/box-bounds.interface';
-export * from './_models/interfaces/error-defaults.interface';
-export * from './_models/interfaces/paged.interface';
-export * from './_models/interfaces/random-weight.interface';
-export * from './_models/interfaces/route-settings.interface';
-export * from './_models/interfaces/search-query.interface';
-export * from './_models/interfaces/search-result.interface';
-export * from './_models/interfaces/server-error-statistics.interface';
-export * from './_models/interfaces/vector2.interface';
-
-// models/interfaces/ENVIRONMENT
-export * from './_models/interfaces/environment/global-log-settings.interface';
-export * from './_models/interfaces/environment/global-settings.interface';
-
-// models/TYPES
-export * from './_models/types/db-filter.type';
-export * from './_models/types/db-sort.type';
-export * from './_models/types/ds-filter.type';
-export * from './_models/types/ds-sort.type';
-
-
-
-
+
+// COLLECTIONS
+// collections/CONSTANTS
+export * from './_collections/constants/data-sizes.const';
+export * from './_collections/constants/error-defaults.const';
+export * from './_collections/constants/global-settings.const';
+export * from './_collections/constants/numbers.const';
+export * from './_collections/constants/times.const';
+
+// collections/UTILS
+export * from './_collections/utils/array.util';
+export * from './_collections/utils/async.util';
+export * from './_collections/utils/data.util';
+export * from './_collections/utils/extract-error-message.util';
+export * from './_collections/utils/json-error-helper.util';
+export * from './_collections/utils/log.util';
+export * from './_collections/utils/round-list.util';
+export * from './_collections/utils/object.util';
+export * from './_collections/utils/require-env.util';
+export * from './_collections/utils/stack.util';
+export * from './_collections/utils/string.util';
+export * from './_collections/utils/string-case.util';
+export * from './_collections/utils/time.util';
+export * from './_collections/utils/type-cloning-facility.util';
+export * from './_collections/utils/utilities.util';
+export * from './_collections/utils/uuid.util';
+
+// collections/utils/MATH
+export * from './_collections/utils/math/box-bounds.util';
+export * from './_collections/utils/math/math.util';
+export * from './_collections/utils/math/random.util';
+export * from './_collections/utils/math/trigonometry.util';
+export * from './_collections/utils/math/vector2.util';
+
+//  collections/utils/REGEX
+export * from './_collections/utils/regex/password-regex.util';
+export * from './_collections/utils/regex/regex.util';
+export * from './_collections/utils/regex/username-regex.util';
+
+
+// ENUMS
+export * from './_enums/basic-property-type.enum';
+export * from './_enums/data-model-type.enum';
+export * from './_enums/environment-flag.enum';
+export * from './_enums/error-level.enum';
+export * from './_enums/log-style.enum';
+export * from './_enums/server-connection-status.enum';
+
+// enums/HTTP
+export * from './_enums/http/http-call-type.enum';
+export * from './_enums/http/http-event-type.enum';
+export * from './_enums/http/http-response-type.enum';
+
+// enums/PIPE
+export * from './_enums/time/day-of-week.enum';
+export * from './_enums/time/month.enum';
+export * from './_enums/time/relative-date.enum';
+
+
+// MODELS
+// models/CONTROL MODELS
+export * from './_models/control-models/data-model-params.control-model';
+export * from './_models/control-models/data-property-params.control-model';
+export * from './_models/control-models/error.control-model';
+export * from './_models/control-models/poll.control-model';
+export * from './_models/control-models/range-value.control-model';
+export * from './_models/control-models/server-status.control-model';
+export * from './_models/control-models/service-endpoint-settings-base.control-model';
+
+// models/control-models/HTTP
+export * from './_models/control-models/http/http-error-response.control-model';
+export * from './_models/control-models/http/http-headers.control-model';
+export * from './_models/control-models/http/http-response.model-base';
+
+// models/DATA MODELS
+export * from './_models/data-models/errors.data-model';
+export * from './_models/data-models/metadata.data-model';
+
+// models/INTERFACES
+export * from './_models/interfaces/box-bounds.interface';
+export * from './_models/interfaces/error-defaults.interface';
+export * from './_models/interfaces/paged.interface';
+export * from './_models/interfaces/random-weight.interface';
+export * from './_models/interfaces/route-settings.interface';
+export * from './_models/interfaces/search-query.interface';
+export * from './_models/interfaces/search-result.interface';
+export * from './_models/interfaces/server-error-statistics.interface';
+export * from './_models/interfaces/vector2.interface';
+
+// models/interfaces/ENVIRONMENT
+export * from './_models/interfaces/environment/global-log-settings.interface';
+export * from './_models/interfaces/environment/global-settings.interface';
+
+// models/TYPES
+export * from './_models/types/db-filter.type';
+export * from './_models/types/db-sort.type';
+export * from './_models/types/ds-filter.type';
+export * from './_models/types/ds-sort.type';
+
+
+
+

package/tsconfig.app.json

@@ -1,12 +1,12 @@
-/* To learn more about this file see: https://angular.io/config/tsconfig. */
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "types": [
-      "_assets/html.d"
-    ]
-  },
-  "include": [
-    "src/_assets"
-  ]
-}
+/* To learn more about this file see: https://angular.io/config/tsconfig. */
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": [
+      "_assets/html.d"
+    ]
+  },
+  "include": [
+    "src/_assets"
+  ]
+}