@futdevpro/nts-dynamo 1.14.2 → 1.14.4

package/src/_services/base/data.service.ts

@@ -1212,12 +1212,34 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
       if (!data) {
         if (isSubObjectOf?.required) {
           throw new DyFM_Error({
-            ...this._getDefaultErrorSettings('validateDataByPropertyParams', new Error('Data is required')),
+            ...this._getDefaultErrorSettings(
+              'validateDataByPropertyParams', 
+              new Error(
+                `validateData failed, data is required! ` +
+                  `(${isSubObjectOf?.key ? `${isSubObjectOf.key}.` : ''}${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
+            )
+          ),
             errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP1`,
           });
         } else {
           return;
         }
+      } else if (isSubObjectOf?.forbidden) {
+        throw new DyFM_Error({
+          ...this._getDefaultErrorSettings(
+            'validateDataByPropertyParams', 
+            new Error(
+              `validateData failed, data is forbidden! ` +
+                `(${isSubObjectOf?.key ? `${isSubObjectOf.key}.` : ''}${this.dataParams.dataName})` +
+              (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
+            )
+          ),
+          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP2`,
+          additionalContent: {
+            data: data,
+          },
+        });
       }
 
       Object.values(properties).forEach(
@@ -1268,7 +1290,8 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
           'validateProperty',
           new Error(
             `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is missing! ` +
-            `(index or required in "${this.dataParams.dataName}" dataParams) `
+            `(index or required in "${this.dataParams.dataName}" dataParams) ` +
+            (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
           )
         ),
 
@@ -1280,6 +1303,28 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
           data: data,
         },
       });
+    } else if (
+      propertyParams.forbidden && 
+      propertyValue !== undefined
+    ) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings(
+          'validateProperty',
+          new Error(
+            `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is forbidden! ` +
+            `(${this.dataParams.dataName}) ` +
+            (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
+          )
+        ),
+
+        status: 522, 
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP2`,
+        userMessage: this.defaultValidationErrorUserMsg,
+        __localStack: this.dataParams.stackLocation,
+        additionalContent: {
+          data: data,
+        },
+      });
     }
 
     // specific Date validation
@@ -1299,12 +1344,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid date! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP2`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP3`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
             additionalContent: {
@@ -1321,12 +1367,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid number! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP3`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP4`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
             additionalContent: {
@@ -1343,12 +1390,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid string! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP4`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP5`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
             additionalContent: {
@@ -1365,12 +1413,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid boolean! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP5`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP6`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
           });
@@ -1384,12 +1433,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid object! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  That failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VD6`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP7`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
           });
@@ -1407,12 +1457,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid array! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP7`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP8`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
           });
@@ -1436,12 +1487,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               'validateProperty',
               new Error(
                 `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid function! ` +
-                `(${this.dataParams.dataName})`
+                `(${this.dataParams.dataName})` +
+                (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
               )
             ),
 
             status: 522, 
-            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP7`,
+            errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP9`,
             userMessage: this.defaultValidationErrorUserMsg,
             __localStack: this.dataParams.stackLocation,
           });
@@ -1455,12 +1507,13 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
             new Error(
               `validateProperty failed, "${this.getPropertyKey(propertyParams, isSubObjectOf)}" is not a valid property type! ` +
               `(type: ${propertyParams.type}, nonBasicType: ${propertyParams.nonBasicType}) ` +
-              `(${this.dataParams.dataName})`
+              `(${this.dataParams.dataName})` +
+              (data as any)?.name ? `\n  The failed data's name: ${(data as any).name}` : ''
             )
           ),
 
           status: 522, 
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP8`,
+          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DS0-VP10`,
           userMessage: this.defaultValidationErrorUserMsg,
           __localStack: this.dataParams.stackLocation,
         });

package/src/_services/base/db.service.ts

@@ -131,7 +131,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
             dataModel: this.dataModel,
           },
           message: 
-            `createData failed, Create new "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+            `createData failed, Create new "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       }
@@ -182,7 +183,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('modifyData', error, issuer),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FU0`,
           additionalContent: { data },
-          message: `modifyData "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `modifyData "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       });
@@ -214,7 +217,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('getDataById', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GI0`,
           additionalContent: { id },
-          message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)`, 
+          message: 
+            `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -254,7 +259,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
           message: 
             `get "${this.dataParams.dataName}" by ` +
-            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)`, 
+            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` + 
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -271,6 +277,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('getDataListByIds', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDL0`,
           additionalContent: { ids },
+          message: 
+            `get "${this.dataParams.dataName}" by IDs was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -316,7 +325,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
           message: 
             `get "${this.dataParams.dataName}" by ` +
-            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)`, 
+            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -382,7 +392,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLDS1`,
           additionalContent: { dependencyIds },
           message: 
-            `get "${this.dataParams.dataName}" by "${dependencyKey}" was unsuccessful (NTS DB)`,
+            `get "${this.dataParams.dataName}" by "${dependencyKey}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -409,7 +420,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('getAll', error),
           
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GA0`,
-          message: `get all "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `get all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -439,7 +452,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-MD0`,
           additionalContent: { id },
-          message: `mark deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `mark deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       }
@@ -464,8 +479,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
         message: 
           `markDeleted "${this.dataParams.dataName}" by ` +
-          `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful ` +
-          `(NTS DB)`, 
+          `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+          `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         issuer,
       });
     });
@@ -485,7 +500,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...this._getDefaultErrorSettings('restoreDeletedById', error, issuer),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-RD0`,
         additionalContent: { id },
-        message: `restoreDeleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+        message: 
+          `restoreDeleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+          `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         issuer,
       });
     });
@@ -509,8 +526,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
         message: 
           `restoreDeleted "${this.dataParams.dataName}" by ` +
-          `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful ` +
-          `(NTS DB)`, 
+          `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+          `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         issuer,
       });
     });
@@ -525,7 +542,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         throw new DyFM_Error({ 
           ...this._getDefaultErrorSettings('getDeletedData', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDD0`,
-          message: `get deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `get deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -551,7 +570,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('deleteDataById', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DD0`,
           additionalContent: { id },
-          message: `delete "${this.dataParams.dataName}" was unsuccessful (NTS DB)`,
+          message: 
+            `delete "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
   }
@@ -589,7 +610,8 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
           message: 
             `delete "${this.dataParams.dataName}" by ` +
-            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)`, 
+            `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
   }
@@ -605,7 +627,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
       throw new DyFM_Error({ 
         ...this._getDefaultErrorSettings('deleteAllData', error),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DAD0`,
-        message: `delete all "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+        message: 
+          `delete all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+          `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
       });
     });
   }
@@ -723,7 +747,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('searchData', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-SD1`,
           additionalContent: { filterBy, narrowByDependencyIds },
-          message: `search "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `search "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
       
@@ -776,7 +802,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findOne', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FO0`,
           additionalContent: { filterBy },
-          message: `findOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)`,
+          message: 
+            `findOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -821,7 +849,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('find', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-F0`,
           additionalContent: { filterBy },
-          message: `find "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `find "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -889,7 +919,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findWithPaging', error),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-WP0`,
           additionalContent: { filterBy, page, pageSize, sort },
-          message: `findWithPaging "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `findWithPaging "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
         });
       });
 
@@ -931,7 +963,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FIU0`,
           additionalContent: { id, update },
-          message: `findByIdAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `findByIdAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       });
@@ -1015,7 +1049,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('updateOne', error, issuer),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UO0`,
           additionalContent: { filterBy, update },
-          message: `updateOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `updateOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       });
@@ -1096,7 +1132,9 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('updateMany', error, issuer),
           errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UM0`,
           additionalContent: { filterBy, update },
-          message: `updateMany "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
+          message: 
+            `updateMany "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+            `\n  error: ${DyFM_Error.getErrorMessage(error)}`,
           issuer,
         });
       });
@@ -1236,6 +1274,10 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         return;
       }
 
+      if (property.forbidden) {
+        return;
+      }
+
       if (!property.key) {
         throw new DyFM_Error({
           ...this._getDefaultErrorSettings(