@futdevpro/fsm-dynamo 1.15.21 → 1.15.23

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

@@ -1,300 +1,300 @@
-import { DyFM_Log } from '../../_collections/utils/log.util';
-import { DyFM_Object } from '../../_collections/utils/object.util';
-import { DyFM_getConstructionStackLocation } from '../../_collections/utils/stack.util';
-import { DyFM_getBasicPropertyType } from '../../_collections/utils/utilities.util';
-import { DyFM_BasicProperty_Type } from '../../_enums/basic-property-type.enum';
-import { DyFM_DataModel_Type } from '../../_enums/data-model-type.enum';
-import { DyFM_Metadata } from '../data-models/metadata.data-model';
-import { DyFM_DataProperties, DyFM_DataProperty_Params } from './data-property-params.control-model';
-import { DyFM_Error } from './error.control-model';
-
-/* export type DyFM_Data_S<T extends DyFM_Metadata> = DyFM_DataModel_Settings<T>;
-export type DyFM_Data_Settings<T extends DyFM_Metadata> = DyFM_DataModel_Settings<T>; */
-export class DyFM_DataModel_Settings<T extends DyFM_Metadata> extends DyFM_Metadata {
-  /** this will be used as db table name, therefore it should be in snake_case,
-   * this also will be used in logs and errors
-   */
-  dataName!: string;
-  modelType?: DyFM_DataModel_Type;
-  
-  addArchive?: boolean;
-
-  /**
-   * If true, the Dynamo NTS will throw an error when trying to modify the data model.
-   * 
-   * @default false
-   */
-  forbidModify?: boolean;
-
-  /**
-   * If true, the Dynamo NTS will throw an error when trying to delete the data model.
-   * 
-   * @default false
-   */
-  forbidDelete?: boolean;
-
-  /**
-   * from these settings we will set the data model properties for the DB.
-   * metadata properties will be added automatically to the data model.
-   */
-  properties!: DyFM_DataProperties<T>;
-}
-
-/* export type DyFM_Data_P<T extends DyFM_Metadata> = DyFM_DataModel_Params<T>;
- * 
- * @example
- * ```ts
- * const params: DyFM_DataModel_Params<DyFM_Metadata> = new DyFM_DataModel_Params({
- *   dataName: 'User',
- *   properties: {
- *     name: { type: DyFM_BasicProperty_Type.string },
- *     age: { type: DyFM_BasicProperty_Type.number },
- *   },
- * });
- */
-export class DyFM_DataModel_Params<T extends DyFM_Metadata> extends DyFM_DataModel_Settings<T> {
-  
-  /* override properties?: DyFM_DataProperties<T>; */
-  readonly stackLocation?: string;
-
-  constructor(
-    set: DyFM_DataModel_Settings<T>
-  ) {
-    super(set);
-
-    try {
-      if (set) {
-        Object.assign(this, set);
-      }
-  
-      this.stackLocation = DyFM_getConstructionStackLocation();
-  
-      if (!this.properties || typeof this.properties !== 'object') {
-        DyFM_Log.error(
-          'DyFM_DataModel_Params.constructor: ' +
-          `Properties are missing in "${this.dataName}" model.` +
-          `\nstackLocation: ${this.stackLocation}\n`
-        );
-  
-        this.properties = {} as DyFM_DataProperties<T>;
-      }
-  
-      const keys: string[] = Object.keys(this.properties);
-      keys.forEach((key: string): void => {
-        if (!key) {
-          DyFM_Log.error(
-            'DyFM_DataModel_Params.constructor: ' +
-            `A property key is missing in "${this.dataName}" model.` +
-            `\nstackLocation: ${this.stackLocation}\n`
-          );
-        }
-        
-        const propertyParams: DyFM_DataProperty_Params<any, T> = new DyFM_DataProperty_Params({
-          ...this.properties[key],
-          key: key,
-        }, this);
-        const basicType: DyFM_BasicProperty_Type = DyFM_getBasicPropertyType(propertyParams.type);
-        if (basicType !== propertyParams.type) {
-          propertyParams.nonBasicType = propertyParams.type;
-          propertyParams.type = basicType;
-        }
-        this.properties[key] = propertyParams;
-  
-        if (propertyParams.subObjectParams) {
-          this.setKeysForSubObjectParams(propertyParams);
-        }
-      });
-  
-      keys.forEach((key: string): void => {
-        const property: DyFM_DataProperty_Params<any, T> = this.properties[key];
-        /* if (property.vectorizeTo) {
-          if (!this.properties[property.vectorizeTo]) {
-            throw new Error(
-              `Vectorize to property "${property.vectorizeTo}" is not found in ` +
-              `"${this.dataName}" model.`
-            );
-          }
-  
-          this.properties[property.vectorizeTo].vectorizeFrom ??= key;
-        } */
-  
-        if (property.vectorizedFrom) {
-          property.vectorizedFrom.forEach((fromKey: string): void => {
-            if (!this.properties[fromKey]) {
-              DyFM_Log.error(
-                `Vectorized from property "${fromKey}" is not found in ` +
-                `"${this.dataName}" model.` +
-                `\nstackLocation: ${this.stackLocation}\n`
-              );
-            }
-  
-            /* if (!this.properties[fromKey].vectorizeUseIndex) {
-              DyFM_Log.error(
-                `Vectorized from property "${fromKey}" has no vectorizeUseIndex in ` +
-                `"${this.dataName}" model.` +
-                `\nstackLocation: ${this.stackLocation}\n`
-              );
-            } */
-  
-            /* if (
-              (this.properties[fromKey] as DyFM_DataProperty_Params<any>)?.type !== DyFM_BasicProperty_Type.string
-            ) {
-              DyFM_Log.error(
-                `Vectorized from property "${property.vectorizedFrom}" is not a string property in ` +
-                `"${this.dataName}" model.` +
-                `\nstackLocation: ${this.stackLocation}\n`
-              );
-            } */
-          });
-  
-          /* this.properties[property.vectorizedFrom].vectorizeTo ??= key; */
-  
-          if (property.type !== DyFM_BasicProperty_Type.array) {
-            DyFM_Log.error(
-              `Vectorized from property "${property.vectorizedFrom}" is not a number[] property in ` +
-              `"${this.dataName}" model.` +
-              `\nstackLocation: ${this.stackLocation}\n`
-            );
-          }
-
-          if (property.nonBasicType !== 'number[]') {
-            DyFM_Log.error(
-              `Vectorized from property "${property.vectorizedFrom}" is not a number[] property in ` +
-              `"${this.dataName}" model.` +
-              `\nstackLocation: ${this.stackLocation}\n`
-            );
-          }
-  
-          if (!property.vectorizeUseIndex) {
-            DyFM_Log.error(
-              'vectorizeUseIndex is required if vectorizedFrom is set. ' +
-              `"${this.dataName}" model.` +
-              `\nstackLocation: ${this.stackLocation}\n`
-            );
-          }
-  
-          if (property.index) {
-            /** {@link DyFM_DataProperty_Params.vectorizeUseIndex} */
-            DyFM_Log.warn(
-              `index is not recommended to be set for vectorized properties in ` +
-              `"${this.dataName}" model. ` +
-              `\n(you should set it in the Atlas and vectorizeUseIndex, ` +
-              `more info at DyFM_DataProperty_Params.vectorizeUseIndex))` +
-              `\nstackLocation: ${this.stackLocation}\n`
-            );
-          }
-  
-          /* if (!this.properties[property.vectorizeUseIndex]) {
-            throw new Error(
-              `vectorizeUseIndex property "${property.vectorizeUseIndex}" is not found in ` +
-              `"${this.dataName}" model.` +
-              `\nstackLocation: ${this.stackLocation}\n`
-            );
-          }
-  
-          if (!(this.properties[property.vectorizeUseIndex] as DyFM_DataProperty_Params<any>).index) {
-            throw new Error(
-              `vectorizeUseIndex property "${property.vectorizeUseIndex}" is not an ` +
-              `index property in "${this.dataName}" model.` +
-              `\nstackLocation: ${this.stackLocation}`
-            );
-          } */
-        }
-      });
-  
-      if (!this?.modelType || this?.modelType == DyFM_DataModel_Type.data) {
-        this.modelType = DyFM_DataModel_Type.data;
-      }
-  
-      /* if (!this.dbName && this?.modelType == DyFM_DataModel_Type.data) {
-        // upper case first letter
-        this.dbName = this.dataName.charAt(0).toUpperCase() + this.dataName.slice(1);
-        
-        this.dbName.split('').forEach((char: string, index: number): void => {
-          if (
-            index > 0 && 
-            this.dbName[index - 1] === '_' && 
-            char === char.toUpperCase()
-          ) {
-            this.dbName = this.dbName.slice(0, index) + 
-                          char.toLowerCase() + 
-                          this.dbName.slice(index + 1);
-          }
-        });
-      } */
-  
-      if (!this.dataName) {
-        DyFM_Log.error(
-          'DyFM_DataModel_Params.constructor: ' +
-          `dataName is missing in "${this.dataName}" model.` +
-          `\nstackLocation: ${this.stackLocation}\n`
-        );
-        this.dataName = 'UNNAMED_MODEL';
-      }
-  
-      // check for any Uppercase letters in dbName (not needed cos can be DyNAny_something_like_this)
-      /* if (RegExp(/[A-Z]/).exec(this.dataName)) {
-        DyFM_Log.warn(
-          'DyFM_DataModel_Params.constructor: ' +
-          `dbName should be in snake_case in "${this.dataName}" model.` +
-          'For future compatibility.' +
-          `\nstackLocation: ${this.stackLocation}\n`
-        );
-      } */
-  
-      if (this.dataName.includes('-')) {
-        DyFM_Log.warn(
-          'DyFM_DataModel_Params.constructor: ' +
-          `dataName should be in snake_case in "${this.dataName}" model.` +
-          'For future compatibility.' +
-          `\nstackLocation: ${this.stackLocation}\n`
-        );
-      }
-
-      DyFM_Object.cleanObject(this);
-    } catch (error) {
-      DyFM_Error.logSimple('DyFM_DataModel_Params.constructor error:', error);
-      DyFM_Log.warn(
-        'Due to the error, the Params contruction failed, therefore the model is not constructed properly. ' +
-        `("${this.dataName}" model)` +
-        `\nstackLocation: ${this.stackLocation}`
-      );
-      /* DyFM_Log.error(
-        'DyFM_DataModel_Params.constructor: ' +
-        `An error occurred while constructing the "${this.dataName}" model.` +
-        `\nstackLocation: ${this.stackLocation}\n`
-      ); */
-    }
-  }
-
-  constructed?(): boolean { 
-    return true; 
-  }
-
-  setKeysForSubObjectParams?(property: DyFM_DataProperty_Params<any, T>): void {
-    if (property.subObjectParams) {
-      Object.keys(property.subObjectParams).forEach((key: string): void => {
-        if (!key) {
-          DyFM_Log.error(
-            'DyFM_DataModel_Params.setKeysForSubObjectParams: ' +
-            `A subObjectParams key is missing in "${this.dataName}" model.` +
-            `\nstackLocation: ${this.stackLocation}\n`
-          );
-        }
-
-        const subObjectPropertyParams: DyFM_DataProperty_Params<any, T> = property.subObjectParams[key];
-
-        subObjectPropertyParams.key = key;
-        const basicType: DyFM_BasicProperty_Type = DyFM_getBasicPropertyType(subObjectPropertyParams.type);
-        if (basicType !== subObjectPropertyParams.type) {
-          subObjectPropertyParams.nonBasicType = subObjectPropertyParams.type;
-          subObjectPropertyParams.type = basicType;
-        }
-
-        if (subObjectPropertyParams.subObjectParams) {
-          this.setKeysForSubObjectParams(subObjectPropertyParams);
-        }
-      });
-    }
-  }
-}
+import { DyFM_Log } from '../../_collections/utils/log.util';
+import { DyFM_Object } from '../../_collections/utils/object.util';
+import { DyFM_getConstructionStackLocation } from '../../_collections/utils/stack.util';
+import { DyFM_getBasicPropertyType } from '../../_collections/utils/utilities.util';
+import { DyFM_BasicProperty_Type } from '../../_enums/basic-property-type.enum';
+import { DyFM_DataModel_Type } from '../../_enums/data-model-type.enum';
+import { DyFM_Metadata } from '../data-models/metadata.data-model';
+import { DyFM_DataProperties, DyFM_DataProperty_Params } from './data-property-params.control-model';
+import { DyFM_Error } from './error.control-model';
+
+/* export type DyFM_Data_S<T extends DyFM_Metadata> = DyFM_DataModel_Settings<T>;
+export type DyFM_Data_Settings<T extends DyFM_Metadata> = DyFM_DataModel_Settings<T>; */
+export class DyFM_DataModel_Settings<T extends DyFM_Metadata> extends DyFM_Metadata {
+  /** this will be used as db table name, therefore it should be in snake_case,
+   * this also will be used in logs and errors
+   */
+  dataName!: string;
+  modelType?: DyFM_DataModel_Type;
+  
+  addArchive?: boolean;
+
+  /**
+   * If true, the Dynamo NTS will throw an error when trying to modify the data model.
+   * 
+   * @default false
+   */
+  forbidModify?: boolean;
+
+  /**
+   * If true, the Dynamo NTS will throw an error when trying to delete the data model.
+   * 
+   * @default false
+   */
+  forbidDelete?: boolean;
+
+  /**
+   * from these settings we will set the data model properties for the DB.
+   * metadata properties will be added automatically to the data model.
+   */
+  properties!: DyFM_DataProperties<T>;
+}
+
+/* export type DyFM_Data_P<T extends DyFM_Metadata> = DyFM_DataModel_Params<T>;
+ * 
+ * @example
+ * ```ts
+ * const params: DyFM_DataModel_Params<DyFM_Metadata> = new DyFM_DataModel_Params({
+ *   dataName: 'User',
+ *   properties: {
+ *     name: { type: DyFM_BasicProperty_Type.string },
+ *     age: { type: DyFM_BasicProperty_Type.number },
+ *   },
+ * });
+ */
+export class DyFM_DataModel_Params<T extends DyFM_Metadata> extends DyFM_DataModel_Settings<T> {
+  
+  /* override properties?: DyFM_DataProperties<T>; */
+  readonly stackLocation?: string;
+
+  constructor(
+    set: DyFM_DataModel_Settings<T>
+  ) {
+    super(set);
+
+    try {
+      if (set) {
+        Object.assign(this, set);
+      }
+  
+      this.stackLocation = DyFM_getConstructionStackLocation();
+  
+      if (!this.properties || typeof this.properties !== 'object') {
+        DyFM_Log.error(
+          'DyFM_DataModel_Params.constructor: ' +
+          `Properties are missing in "${this.dataName}" model.` +
+          `\nstackLocation: ${this.stackLocation}\n`
+        );
+  
+        this.properties = {} as DyFM_DataProperties<T>;
+      }
+  
+      const keys: string[] = Object.keys(this.properties);
+      keys.forEach((key: string): void => {
+        if (!key) {
+          DyFM_Log.error(
+            'DyFM_DataModel_Params.constructor: ' +
+            `A property key is missing in "${this.dataName}" model.` +
+            `\nstackLocation: ${this.stackLocation}\n`
+          );
+        }
+        
+        const propertyParams: DyFM_DataProperty_Params<any, T> = new DyFM_DataProperty_Params({
+          ...this.properties[key],
+          key: key,
+        }, this);
+        const basicType: DyFM_BasicProperty_Type = DyFM_getBasicPropertyType(propertyParams.type);
+        if (basicType !== propertyParams.type) {
+          propertyParams.nonBasicType = propertyParams.type;
+          propertyParams.type = basicType;
+        }
+        this.properties[key] = propertyParams;
+  
+        if (propertyParams.subObjectParams) {
+          this.setKeysForSubObjectParams(propertyParams);
+        }
+      });
+  
+      keys.forEach((key: string): void => {
+        const property: DyFM_DataProperty_Params<any, T> = this.properties[key];
+        /* if (property.vectorizeTo) {
+          if (!this.properties[property.vectorizeTo]) {
+            throw new Error(
+              `Vectorize to property "${property.vectorizeTo}" is not found in ` +
+              `"${this.dataName}" model.`
+            );
+          }
+  
+          this.properties[property.vectorizeTo].vectorizeFrom ??= key;
+        } */
+  
+        if (property.vectorizedFrom) {
+          property.vectorizedFrom.forEach((fromKey: string): void => {
+            if (!this.properties[fromKey]) {
+              DyFM_Log.error(
+                `Vectorized from property "${fromKey}" is not found in ` +
+                `"${this.dataName}" model.` +
+                `\nstackLocation: ${this.stackLocation}\n`
+              );
+            }
+  
+            /* if (!this.properties[fromKey].vectorizeUseIndex) {
+              DyFM_Log.error(
+                `Vectorized from property "${fromKey}" has no vectorizeUseIndex in ` +
+                `"${this.dataName}" model.` +
+                `\nstackLocation: ${this.stackLocation}\n`
+              );
+            } */
+  
+            /* if (
+              (this.properties[fromKey] as DyFM_DataProperty_Params<any>)?.type !== DyFM_BasicProperty_Type.string
+            ) {
+              DyFM_Log.error(
+                `Vectorized from property "${property.vectorizedFrom}" is not a string property in ` +
+                `"${this.dataName}" model.` +
+                `\nstackLocation: ${this.stackLocation}\n`
+              );
+            } */
+          });
+  
+          /* this.properties[property.vectorizedFrom].vectorizeTo ??= key; */
+  
+          if (property.type !== DyFM_BasicProperty_Type.array) {
+            DyFM_Log.error(
+              `Vectorized from property "${property.vectorizedFrom}" is not a number[] property in ` +
+              `"${this.dataName}" model.` +
+              `\nstackLocation: ${this.stackLocation}\n`
+            );
+          }
+
+          if (property.nonBasicType !== 'number[]') {
+            DyFM_Log.error(
+              `Vectorized from property "${property.vectorizedFrom}" is not a number[] property in ` +
+              `"${this.dataName}" model.` +
+              `\nstackLocation: ${this.stackLocation}\n`
+            );
+          }
+  
+          if (!property.vectorizeUseIndex) {
+            DyFM_Log.error(
+              'vectorizeUseIndex is required if vectorizedFrom is set. ' +
+              `"${this.dataName}" model.` +
+              `\nstackLocation: ${this.stackLocation}\n`
+            );
+          }
+  
+          if (property.index) {
+            /** {@link DyFM_DataProperty_Params.vectorizeUseIndex} */
+            DyFM_Log.warn(
+              `index is not recommended to be set for vectorized properties in ` +
+              `"${this.dataName}" model. ` +
+              `\n(you should set it in the Atlas and vectorizeUseIndex, ` +
+              `more info at DyFM_DataProperty_Params.vectorizeUseIndex))` +
+              `\nstackLocation: ${this.stackLocation}\n`
+            );
+          }
+  
+          /* if (!this.properties[property.vectorizeUseIndex]) {
+            throw new Error(
+              `vectorizeUseIndex property "${property.vectorizeUseIndex}" is not found in ` +
+              `"${this.dataName}" model.` +
+              `\nstackLocation: ${this.stackLocation}\n`
+            );
+          }
+  
+          if (!(this.properties[property.vectorizeUseIndex] as DyFM_DataProperty_Params<any>).index) {
+            throw new Error(
+              `vectorizeUseIndex property "${property.vectorizeUseIndex}" is not an ` +
+              `index property in "${this.dataName}" model.` +
+              `\nstackLocation: ${this.stackLocation}`
+            );
+          } */
+        }
+      });
+  
+      if (!this?.modelType || this?.modelType == DyFM_DataModel_Type.data) {
+        this.modelType = DyFM_DataModel_Type.data;
+      }
+  
+      /* if (!this.dbName && this?.modelType == DyFM_DataModel_Type.data) {
+        // upper case first letter
+        this.dbName = this.dataName.charAt(0).toUpperCase() + this.dataName.slice(1);
+        
+        this.dbName.split('').forEach((char: string, index: number): void => {
+          if (
+            index > 0 && 
+            this.dbName[index - 1] === '_' && 
+            char === char.toUpperCase()
+          ) {
+            this.dbName = this.dbName.slice(0, index) + 
+                          char.toLowerCase() + 
+                          this.dbName.slice(index + 1);
+          }
+        });
+      } */
+  
+      if (!this.dataName) {
+        DyFM_Log.error(
+          'DyFM_DataModel_Params.constructor: ' +
+          `dataName is missing in "${this.dataName}" model.` +
+          `\nstackLocation: ${this.stackLocation}\n`
+        );
+        this.dataName = 'UNNAMED_MODEL';
+      }
+  
+      // check for any Uppercase letters in dbName (not needed cos can be DyNAny_something_like_this)
+      /* if (RegExp(/[A-Z]/).exec(this.dataName)) {
+        DyFM_Log.warn(
+          'DyFM_DataModel_Params.constructor: ' +
+          `dbName should be in snake_case in "${this.dataName}" model.` +
+          'For future compatibility.' +
+          `\nstackLocation: ${this.stackLocation}\n`
+        );
+      } */
+  
+      if (this.dataName.includes('-')) {
+        DyFM_Log.warn(
+          'DyFM_DataModel_Params.constructor: ' +
+          `dataName should be in snake_case in "${this.dataName}" model.` +
+          'For future compatibility.' +
+          `\nstackLocation: ${this.stackLocation}\n`
+        );
+      }
+
+      DyFM_Object.cleanObject(this);
+    } catch (error) {
+      DyFM_Error.logSimple('DyFM_DataModel_Params.constructor error:', error);
+      DyFM_Log.warn(
+        'Due to the error, the Params contruction failed, therefore the model is not constructed properly. ' +
+        `("${this.dataName}" model)` +
+        `\nstackLocation: ${this.stackLocation}`
+      );
+      /* DyFM_Log.error(
+        'DyFM_DataModel_Params.constructor: ' +
+        `An error occurred while constructing the "${this.dataName}" model.` +
+        `\nstackLocation: ${this.stackLocation}\n`
+      ); */
+    }
+  }
+
+  constructed?(): boolean { 
+    return true; 
+  }
+
+  setKeysForSubObjectParams?(property: DyFM_DataProperty_Params<any, T>): void {
+    if (property.subObjectParams) {
+      Object.keys(property.subObjectParams).forEach((key: string): void => {
+        if (!key) {
+          DyFM_Log.error(
+            'DyFM_DataModel_Params.setKeysForSubObjectParams: ' +
+            `A subObjectParams key is missing in "${this.dataName}" model.` +
+            `\nstackLocation: ${this.stackLocation}\n`
+          );
+        }
+
+        const subObjectPropertyParams: DyFM_DataProperty_Params<any, T> = property.subObjectParams[key];
+
+        subObjectPropertyParams.key = key;
+        const basicType: DyFM_BasicProperty_Type = DyFM_getBasicPropertyType(subObjectPropertyParams.type);
+        if (basicType !== subObjectPropertyParams.type) {
+          subObjectPropertyParams.nonBasicType = subObjectPropertyParams.type;
+          subObjectPropertyParams.type = basicType;
+        }
+
+        if (subObjectPropertyParams.subObjectParams) {
+          this.setKeysForSubObjectParams(subObjectPropertyParams);
+        }
+      });
+    }
+  }
+}