@futdevpro/fsm-dynamo 1.9.9 → 1.9.12

package/src/_collections/utils/time.util.ts

@@ -1,219 +1,219 @@
-
-import { day, hour, minute, month, second, week, year } from '../constants/times.const';
-import { DynamoFM_Month } from '../../_enums/time/month.enum';
-import { DynamoFM_DayOfWeek } from '../../_enums/time/day-of-week.enum';
-import { DynamoFM_RelativeDate } from '../../_enums/time/relative-date.enum';
-
-export type DFM_Time = DynamoFM_Time;
-export type DFM_T = DynamoFM_Time;
-export class DynamoFM_Time {
-
-  static readonly second = second;
-  static readonly minute = minute;
-  static readonly hour = hour;
-  static readonly day = day;
-  static readonly week = week;
-  static readonly month = month;
-  static readonly year = year;
-
-  static getAge(birthDate: Date | number | string): number {
-    return this.getYear(+new Date() - +new Date(birthDate));
-  }
-
-  /**
-   * returns the date as a number of years
-   * @param date 
-   * @returns 
-   */
-  static getYear(date: Date | number | string): number {
-    if (typeof date === 'string') {
-      date = new Date(date);
-    }
-    
-    return (+date  / year);
-  }
-
-  /**
-   * returns the date as a number of hours
-   * @param date 
-   * @returns 
-   */
-  static getHour(date: Date | number | string): number {
-    if (typeof date === 'string') {
-      date = new Date(date);
-    }
-
-    return (+date  / hour);
-  }
-
-  /**
-   * calculates the birthdate from the age 
-   * (with current date so this wont be accurate for days or months, only years)
-   * @param date 
-   * @returns 
-   */
-  static getDateByAge(age: number): Date {
-    return new Date(+new Date() - (year * age));
-  }
-
-  /**
-   * returns the date x before the current date
-   * @param relativeDate 
-   * @returns 
-   */
-  static getDateByRelativeDate(
-    relativeDate: DynamoFM_RelativeDate, 
-    comparedTo?: Date
-  ): Date {
-    switch (relativeDate) {
-      case DynamoFM_RelativeDate.lastDay:
-        return this.oneDayAgo(comparedTo);
-
-      case DynamoFM_RelativeDate.lastWeek:
-        return this.oneWeekAgo(comparedTo);
-
-      case DynamoFM_RelativeDate.lastMonth:
-        return this.oneMonthAgo(comparedTo);
-
-      case DynamoFM_RelativeDate.lastYear:
-        return this.oneYearAgo(comparedTo);
-
-      case DynamoFM_RelativeDate.last10Years:
-        return this.tenYearsAgo(comparedTo);
-
-      case DynamoFM_RelativeDate.allTime:
-        return new Date(0);
-
-      default:
-        return new Date(0);
-    }
-  }
-
-  /**
-   * returns the date one hour ago
-   * @returns 
-   */
-  static oneHourAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - hour);
-  }
-
-  /**
-   * returns the date one day ago
-   * @returns 
-   */
-  static oneDayAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - day);
-  }
-
-  /**
-   * returns the date one week ago
-   * @returns 
-   */
-  static oneWeekAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - week);
-  }
-
-  /**
-   * returns the date one month ago
-   * @returns 
-   */
-  static oneMonthAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - month);
-  }
-  
-  /**
-   * returns the date one year ago
-   * @returns 
-   */
-  static oneYearAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - year);
-  }
-  
-  /**
-   * returns the date ten years ago
-   * @returns 
-   */
-  static tenYearsAgo(comparedTo: Date = new Date()): Date {
-    return new Date(+comparedTo - (10 * year));
-  }
-
-  /**
-   * returns the DynamoFM_DayOfWeek type of the current day
-   * @returns 
-   */
-  static getTodayOfWeek(): DynamoFM_DayOfWeek {
-    return DynamoFM_DayOfWeek[
-      new Date().toLocaleString('en-us', { weekday: 'long' }).toLocaleLowerCase()
-    ];
-  }
-
-  /**
-   * returns the days of the week from today to the end of the week in DynamoFM_DayOfWeek format
-   * @returns 
-   */
-  static getDaysOfWeekFromToday(): DynamoFM_DayOfWeek[] {
-    const today: DynamoFM_DayOfWeek = this.getTodayOfWeek();
-    const daysOfWeek: DynamoFM_DayOfWeek[] = Object.values(DynamoFM_DayOfWeek);
-    const todayIndex: number = daysOfWeek.indexOf(today);
-
-    return daysOfWeek.slice(todayIndex).concat(daysOfWeek.slice(0, todayIndex));
-  }
-
-  /**
-   * returns the days of the week to today to the end of the week in DynamoFM_DayOfWeek format
-   * @returns 
-   */
-  static getDaysOfWeekToToday(): DynamoFM_DayOfWeek[] {
-    const today: DynamoFM_DayOfWeek = this.getTodayOfWeek();
-    const daysOfWeek: DynamoFM_DayOfWeek[] = Object.values(DynamoFM_DayOfWeek);
-    const todayIndex: number = daysOfWeek.indexOf(today);
-
-    return daysOfWeek.slice(0, todayIndex).reverse().concat(daysOfWeek.slice(todayIndex).reverse());
-  }
-
-  /**
-   * returns the DynamoFM_Month type of the current month
-   * @returns 
-   */
-  static getCurrentMonth(): DynamoFM_Month {
-    return DynamoFM_Month[
-      new Date().toLocaleString('en-us', { month: 'long' }).toLocaleLowerCase()
-    ];
-  }
-
-  /**
-   * returns the number of days in the month
-   * @param inYear this value is important for february if you want to know if it is a leap year
-   * @returns 
-   */
-  static getMonthLength(month: DynamoFM_Month, inYear?: number): number {
-    switch (month) {
-      case DynamoFM_Month.january:
-      case DynamoFM_Month.march:
-      case DynamoFM_Month.may:
-      case DynamoFM_Month.june:
-      case DynamoFM_Month.august:
-      case DynamoFM_Month.october:
-        return 31;
-
-      case DynamoFM_Month.april:
-      case DynamoFM_Month.july:
-      case DynamoFM_Month.september:
-      case DynamoFM_Month.november:
-      case DynamoFM_Month.december:
-        return 30;
-
-      case DynamoFM_Month.february:
-        return this.isLeapYear(inYear ?? new Date().getFullYear()) ? 29 : 28;
-    }
-  }
-
-  /**
-   * returns year is leap or not
-   * @param year 
-   * @returns 
-   */
-  static isLeapYear(year: number): boolean {
-    return year % 4 === 0;
-  }
-}
+
+import { day, hour, minute, month, second, week, year } from '../constants/times.const';
+import { DynamoFM_Month } from '../../_enums/time/month.enum';
+import { DynamoFM_DayOfWeek } from '../../_enums/time/day-of-week.enum';
+import { DynamoFM_RelativeDate } from '../../_enums/time/relative-date.enum';
+
+export type DFM_Time = DynamoFM_Time;
+export type DFM_T = DynamoFM_Time;
+export class DynamoFM_Time {
+
+  static readonly second = second;
+  static readonly minute = minute;
+  static readonly hour = hour;
+  static readonly day = day;
+  static readonly week = week;
+  static readonly month = month;
+  static readonly year = year;
+
+  static getAge(birthDate: Date | number | string): number {
+    return this.getYear(+new Date() - +new Date(birthDate));
+  }
+
+  /**
+   * returns the date as a number of years
+   * @param date 
+   * @returns 
+   */
+  static getYear(date: Date | number | string): number {
+    if (typeof date === 'string') {
+      date = new Date(date);
+    }
+    
+    return (+date  / year);
+  }
+
+  /**
+   * returns the date as a number of hours
+   * @param date 
+   * @returns 
+   */
+  static getHour(date: Date | number | string): number {
+    if (typeof date === 'string') {
+      date = new Date(date);
+    }
+
+    return (+date  / hour);
+  }
+
+  /**
+   * calculates the birthdate from the age 
+   * (with current date so this wont be accurate for days or months, only years)
+   * @param date 
+   * @returns 
+   */
+  static getDateByAge(age: number): Date {
+    return new Date(+new Date() - (year * age));
+  }
+
+  /**
+   * returns the date x before the current date
+   * @param relativeDate 
+   * @returns 
+   */
+  static getDateByRelativeDate(
+    relativeDate: DynamoFM_RelativeDate, 
+    comparedTo?: Date
+  ): Date {
+    switch (relativeDate) {
+      case DynamoFM_RelativeDate.lastDay:
+        return this.oneDayAgo(comparedTo);
+
+      case DynamoFM_RelativeDate.lastWeek:
+        return this.oneWeekAgo(comparedTo);
+
+      case DynamoFM_RelativeDate.lastMonth:
+        return this.oneMonthAgo(comparedTo);
+
+      case DynamoFM_RelativeDate.lastYear:
+        return this.oneYearAgo(comparedTo);
+
+      case DynamoFM_RelativeDate.last10Years:
+        return this.tenYearsAgo(comparedTo);
+
+      case DynamoFM_RelativeDate.allTime:
+        return new Date(0);
+
+      default:
+        return new Date(0);
+    }
+  }
+
+  /**
+   * returns the date one hour ago
+   * @returns 
+   */
+  static oneHourAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - hour);
+  }
+
+  /**
+   * returns the date one day ago
+   * @returns 
+   */
+  static oneDayAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - day);
+  }
+
+  /**
+   * returns the date one week ago
+   * @returns 
+   */
+  static oneWeekAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - week);
+  }
+
+  /**
+   * returns the date one month ago
+   * @returns 
+   */
+  static oneMonthAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - month);
+  }
+  
+  /**
+   * returns the date one year ago
+   * @returns 
+   */
+  static oneYearAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - year);
+  }
+  
+  /**
+   * returns the date ten years ago
+   * @returns 
+   */
+  static tenYearsAgo(comparedTo: Date = new Date()): Date {
+    return new Date(+comparedTo - (10 * year));
+  }
+
+  /**
+   * returns the DynamoFM_DayOfWeek type of the current day
+   * @returns 
+   */
+  static getTodayOfWeek(): DynamoFM_DayOfWeek {
+    return DynamoFM_DayOfWeek[
+      new Date().toLocaleString('en-us', { weekday: 'long' }).toLocaleLowerCase()
+    ];
+  }
+
+  /**
+   * returns the days of the week from today to the end of the week in DynamoFM_DayOfWeek format
+   * @returns 
+   */
+  static getDaysOfWeekFromToday(): DynamoFM_DayOfWeek[] {
+    const today: DynamoFM_DayOfWeek = this.getTodayOfWeek();
+    const daysOfWeek: DynamoFM_DayOfWeek[] = Object.values(DynamoFM_DayOfWeek);
+    const todayIndex: number = daysOfWeek.indexOf(today);
+
+    return daysOfWeek.slice(todayIndex).concat(daysOfWeek.slice(0, todayIndex));
+  }
+
+  /**
+   * returns the days of the week to today to the end of the week in DynamoFM_DayOfWeek format
+   * @returns 
+   */
+  static getDaysOfWeekToToday(): DynamoFM_DayOfWeek[] {
+    const today: DynamoFM_DayOfWeek = this.getTodayOfWeek();
+    const daysOfWeek: DynamoFM_DayOfWeek[] = Object.values(DynamoFM_DayOfWeek);
+    const todayIndex: number = daysOfWeek.indexOf(today);
+
+    return daysOfWeek.slice(0, todayIndex).reverse().concat(daysOfWeek.slice(todayIndex).reverse());
+  }
+
+  /**
+   * returns the DynamoFM_Month type of the current month
+   * @returns 
+   */
+  static getCurrentMonth(): DynamoFM_Month {
+    return DynamoFM_Month[
+      new Date().toLocaleString('en-us', { month: 'long' }).toLocaleLowerCase()
+    ];
+  }
+
+  /**
+   * returns the number of days in the month
+   * @param inYear this value is important for february if you want to know if it is a leap year
+   * @returns 
+   */
+  static getMonthLength(month: DynamoFM_Month, inYear?: number): number {
+    switch (month) {
+      case DynamoFM_Month.january:
+      case DynamoFM_Month.march:
+      case DynamoFM_Month.may:
+      case DynamoFM_Month.june:
+      case DynamoFM_Month.august:
+      case DynamoFM_Month.october:
+        return 31;
+
+      case DynamoFM_Month.april:
+      case DynamoFM_Month.july:
+      case DynamoFM_Month.september:
+      case DynamoFM_Month.november:
+      case DynamoFM_Month.december:
+        return 30;
+
+      case DynamoFM_Month.february:
+        return this.isLeapYear(inYear ?? new Date().getFullYear()) ? 29 : 28;
+    }
+  }
+
+  /**
+   * returns year is leap or not
+   * @param year 
+   * @returns 
+   */
+  static isLeapYear(year: number): boolean {
+    return year % 4 === 0;
+  }
+}

package/src/_collections/utils/type-cloning-facility.util.ts

@@ -1,121 +1,121 @@
-
-export type DynamoFM_TCF = DynamoFM_TypeCloningFacility;
-export type DFM_TypeCloningFacility = DynamoFM_TypeCloningFacility;
-export type DFM_TCF = DynamoFM_TCF;
-
-/** 
- * 
- * This functions should be able to clone any object, 
- * even if it contains circular references.
- * 
- * if the object has a clone() function, it will be used.
- * if the object has any getter or setter, it will be ignored, 
- * therefore it should have a clone() function.
- * 
- * WARNING: this function will clone all connected objects!
- * 
- * */
-export class DynamoFM_TypeCloningFacility {
-
-  static clone<T>(
-    object: T, 
-    skip: string[] = [], 
-    affectedObjects: ObjectCollector[] = [],
-    debug: boolean = false
-  ): T {
-    const result: T = {} as T;
-
-    for (const key in object) {
-      if (debug) {
-        console.log('clone DEBUG; key:', key);
-      }
-
-      if (typeof object === 'object'/* object.hasOwnProperty(key) */) {
-        const type = typeof object[key];
-
-        if (skip.includes(key)) {
-          continue;
-
-        } else if (type === 'object') {
-          const alreadyAffected = affectedObjects?.find(
-            (affectedObject): boolean => affectedObject.id === object[key]
-          );
-
-          if (alreadyAffected) {
-            result[key] = alreadyAffected.clonedObject;
-            
-          } else {
-            const newAffectedObject: ObjectCollector = {
-              id: object[key]
-            };
-
-            affectedObjects.push(newAffectedObject);
-            
-            if (Array.isArray(object[key])) {
-              newAffectedObject.clonedObject = this.cloneArray(
-                object[key] as unknown[], 
-                skip, 
-                affectedObjects,
-                debug
-              );
-
-            } else if (
-              (object[key] as any)?.clone && 
-              typeof (object[key] as any)?.clone === 'function'
-            ) {
-              newAffectedObject.clonedObject = (object[key] as any).clone();
-
-            } else {
-              newAffectedObject.clonedObject = this.clone(
-                object[key], 
-                skip, 
-                affectedObjects,
-                debug
-              );
-            }
-
-            result[key] = newAffectedObject.clonedObject;
-          }
-        } else {
-          result[key] = object[key];
-        }
-      }
-    }
-
-    return result;
-  }
-
-  static cloneArray<T>(
-    array: T[],
-    skip: string[] = [], 
-    affectedObjects: ObjectCollector[] = [],
-    debug: boolean = false
-  ): T[] {
-    const result: T[] = [];
-
-    array.forEach((element, index): void => {
-      if (debug) {
-        console.log('cloneArrayDEBUG; index', index);
-      }
-
-      if (typeof element === 'object') {
-        result.push(this.clone(element, skip, affectedObjects, debug));
-
-      } else {
-        result.push(element);
-      }
-    });
-
-    return result;
-  }
-
-  storeCirculation // TODO stringifyable -------------------------------------------------------------------------------------------------------------------------------------------
-
-  restoreCirculation // TODO stringified -------------------------------------------------------------------------------------------------------------------------------------------
-}
-
-interface ObjectCollector {
-  id;
-  clonedObject?;
-}
-
+
+export type DynamoFM_TCF = DynamoFM_TypeCloningFacility;
+export type DFM_TypeCloningFacility = DynamoFM_TypeCloningFacility;
+export type DFM_TCF = DynamoFM_TCF;
+
+/** 
+ * 
+ * This functions should be able to clone any object, 
+ * even if it contains circular references.
+ * 
+ * if the object has a clone() function, it will be used.
+ * if the object has any getter or setter, it will be ignored, 
+ * therefore it should have a clone() function.
+ * 
+ * WARNING: this function will clone all connected objects!
+ * 
+ * */
+export class DynamoFM_TypeCloningFacility {
+
+  static clone<T>(
+    object: T, 
+    skip: string[] = [], 
+    affectedObjects: ObjectCollector[] = [],
+    debug: boolean = false
+  ): T {
+    const result: T = {} as T;
+
+    for (const key in object) {
+      if (debug) {
+        console.log('clone DEBUG; key:', key);
+      }
+
+      if (typeof object === 'object'/* object.hasOwnProperty(key) */) {
+        const type = typeof object[key];
+
+        if (skip.includes(key)) {
+          continue;
+
+        } else if (type === 'object') {
+          const alreadyAffected = affectedObjects?.find(
+            (affectedObject): boolean => affectedObject.id === object[key]
+          );
+
+          if (alreadyAffected) {
+            result[key] = alreadyAffected.clonedObject;
+            
+          } else {
+            const newAffectedObject: ObjectCollector = {
+              id: object[key]
+            };
+
+            affectedObjects.push(newAffectedObject);
+            
+            if (Array.isArray(object[key])) {
+              newAffectedObject.clonedObject = this.cloneArray(
+                object[key] as unknown[], 
+                skip, 
+                affectedObjects,
+                debug
+              );
+
+            } else if (
+              (object[key] as any)?.clone && 
+              typeof (object[key] as any)?.clone === 'function'
+            ) {
+              newAffectedObject.clonedObject = (object[key] as any).clone();
+
+            } else {
+              newAffectedObject.clonedObject = this.clone(
+                object[key], 
+                skip, 
+                affectedObjects,
+                debug
+              );
+            }
+
+            result[key] = newAffectedObject.clonedObject;
+          }
+        } else {
+          result[key] = object[key];
+        }
+      }
+    }
+
+    return result;
+  }
+
+  static cloneArray<T>(
+    array: T[],
+    skip: string[] = [], 
+    affectedObjects: ObjectCollector[] = [],
+    debug: boolean = false
+  ): T[] {
+    const result: T[] = [];
+
+    array.forEach((element, index): void => {
+      if (debug) {
+        console.log('cloneArrayDEBUG; index', index);
+      }
+
+      if (typeof element === 'object') {
+        result.push(this.clone(element, skip, affectedObjects, debug));
+
+      } else {
+        result.push(element);
+      }
+    });
+
+    return result;
+  }
+
+  storeCirculation // TODO stringifyable -------------------------------------------------------------------------------------------------------------------------------------------
+
+  restoreCirculation // TODO stringified -------------------------------------------------------------------------------------------------------------------------------------------
+}
+
+interface ObjectCollector {
+  id;
+  clonedObject?;
+}
+