tuain-form-manager 1.5.4 → 1.5.6

package/lib/form-manager.js

@@ -6,13 +6,16 @@ const { customizeFormDefinition } = require('./form-utils');
 const START_OPERATION = 'startOperation';
 
 class FormManager {
-  constructor(rootPath, formsDefinitions, cacheManager, appLogger, errMgr, formClasses = null) {
+  constructor(rootPath, formsDefinitions, cacheManager, appLogger, errMgr, formClasses = null, debugMode = false) {
     this.rootPath = rootPath ?? '';
     this.formsDefinitions = formsDefinitions;
     this.formClasses = formClasses;
     this._formsSignature = null;
     this.logger = appLogger;
     this.errMgr = errMgr;
+    // Controla si el detalle de los errores expone el mensaje/stack de la excepción.
+    // Se propaga a cada instancia de formulario. Default seguro: false (no expone).
+    this.debugMode = debugMode ?? false;
     this.errMgr.addModuleSet('forms-lib', modErrs);
     this.getFormsSignature = () => this._formsSignature;
     this.calculateFormsSignature();
@@ -76,14 +79,15 @@ class FormManager {
         [errorObj, formDefinition] = await this.executeFormStart(requestContext, formDefinition, formCode);
       }
     } catch (err) {
-      const errorDetail = `Excepción no controlada en ${formCode}: ${err.message}\n${err.stack}`;
+      const context = `Excepción no controlada en ${formCode}`;
+      const errorDetail = `${context}: ${err.message}\n${err.stack}`;
       this.logger.log({
         level: 'error',
         label: 'FormManager',
         action: 'getFormDefinition',
         message: errorDetail,
       });
-      errorObj = this.errMgr.get(modErrs.getFormDefinition.formPopulateFail, errorDetail);
+      errorObj = this.errMgr.get(modErrs.getFormDefinition.formPopulateFail, this.debugMode ? errorDetail : context);
     }
     return [errorObj, formDefinition];
   }
@@ -186,6 +190,9 @@ class FormManager {
         errorObj = this.errMgr.get(modErrs.formActionExec.formNotFound, message);
         return [errorObj, null];
       }
+      // Propaga el modo depuración a la instancia del formulario para que sus
+      // manejadores de excepción decidan si exponen el mensaje/stack en el detalle.
+      formCustomObject.debugMode = this.debugMode;
       [errorObj, resultForm] = await formCustomObject.executeFormAction(actionCode);
       message = `END FORM ACTION ${formCode} / ${actionCode} / ${errorObj?.errorCode ?? ''}`;
       this.logger.log({
@@ -196,6 +203,7 @@ class FormManager {
       });
       return [errorObj, resultForm];
     } catch (err) {
+      const context = `Excepción no controlada. END BY EXCEPTION FORM ACTION ${formCode} / ${actionCode}`;
       message =
         `Excepción no controlada: ${err.message}\n${err.stack}` +
         `------ END BY EXCEPTION FORM ACTION ${formCode} / ${actionCode} ------`;
@@ -205,7 +213,7 @@ class FormManager {
         action: 'executeFormAction',
         message,
       });
-      errorObj = this.errMgr.get(modErrs.formActionExec.formNotFound, message);
+      errorObj = this.errMgr.get(modErrs.formActionExec.formNotFound, this.debugMode ? message : context);
       return [errorObj, null];
     }
   }

package/lib/form.js

@@ -73,6 +73,9 @@ class Form {
   constructor(logger, errMgr, requestContext, formDefinition, requestData) {
     this.logger = logger;
     this.errMgr = errMgr;
+    // Lo inyecta FormManager tras instanciar. Controla si el detalle del error
+    // expone el mensaje/stack de la excepción. Default seguro: false (no expone).
+    this.debugMode = false;
     this._errorObject = null;
     this._formDefinition = formDefinition;
 
@@ -745,9 +748,10 @@ class Form {
     try {
       errorObj = await callback(fieldCode, fieldValue);
     } catch (err) {
-      message = `Excepción en validación de ${fieldCode}: ${err.message} / ${err.stack}`;
+      const context = `Excepción en validación de ${fieldCode}`;
+      message = `${context}: ${err.message} / ${err.stack}`;
       this.logger.log({ level: 'error', label: 'fieldValidation', action: fieldCode, message });
-      errorObj = this.errMgr.get(modErrs.fieldValidation.exceptionNotHandled, message);
+      errorObj = this.errMgr.get(modErrs.fieldValidation.exceptionNotHandled, this.debugMode ? message : context);
     }
     return errorObj;
   }
@@ -773,9 +777,10 @@ class Form {
     try {
       errorObj = await callback(actionCode);
     } catch (err) {
-      message = `Excepción en acción de ${actionCode}: ${err.message} / ${err.stack}`;
+      const context = `Excepción en acción de ${actionCode}`;
+      message = `${context}: ${err.message} / ${err.stack}`;
       this.logger.log({ level: 'error', label: 'executeFormAction', action: actionCode, message });
-      errorObj = this.errMgr.get(modErrs.formActionExec.exceptionNotHandled, message);
+      errorObj = this.errMgr.get(modErrs.formActionExec.exceptionNotHandled, this.debugMode ? message : context);
     }
     return [errorObj, this.getExportData()];
   }
@@ -838,6 +843,22 @@ class Form {
     return responseTable.fields[fieldCode];
   }
 
+  setTableRecords(tableCode, records = [], options = {}) {
+    const responseTable = this.getResponseTable(tableCode);
+    if (!responseTable || !records || !Array.isArray(records)) {
+      return;
+    }
+    const idField = options?.idField ?? Object.keys(records?.[0] ?? {})?.[0];
+    const tableDef = this.getTableDefinition(tableCode);
+    const columns = tableDef?.fields.map((flds) => flds.fieldCode) ?? [];
+    const tableRecords = records.map((record, index) => ({
+      tableRecordId: record[idField] ?? index,
+      recordData: columns.map((fieldCode) => ({ fieldCode, fieldValue: record[fieldCode] ?? '' })),
+    }));
+    this.setTableConstraints(tableCode, options);
+    Object.assign(responseTable, { tableRecords });
+  }
+
   fillTable(records, mapping) {
     const { tableCode, recordIdField, recordColumnsNames, recordItemAttributes } = mapping;
     const responseTable = this.getResponseTable(tableCode);
@@ -1037,9 +1058,10 @@ class Form {
       });
       errorObject = await tableActionCallback(tableCode, actionCode, tableRecordId, tableRecordData ?? {});
     } catch (err) {
-      message = `Excepción no soportada en acción ${actionCode} sobre la tabla ${tableCode} : ${err.message} / ${err.stack}`;
+      const context = `Excepción no soportada en acción ${actionCode} sobre la tabla ${tableCode}`;
+      message = `${context} : ${err.message} / ${err.stack}`;
       this.logger.log({ level: 'error', label: 'tableAction', action: actionCode, message });
-      errorObject = this.errMgr.get(modErrs.tableActionExec.noCallback, message);
+      errorObject = this.errMgr.get(modErrs.tableActionExec.noCallback, this.debugMode ? message : context);
     }
     return errorObject;
   }
@@ -1070,9 +1092,10 @@ class Form {
       }
       errorObject = await tablePopulateCallback(tableCode, this.actionSubject);
     } catch (err) {
-      message = `Excepción no soportada en el poblamiento de la tabla ${tableCode} en ${this.formCode}: ${err} / ${err.stack}`;
+      const context = `Excepción no soportada en el poblamiento de la tabla ${tableCode} en ${this.formCode}`;
+      message = `${context}: ${err} / ${err.stack}`;
       this.logger.log({ level: 'error', label: 'executeTablePopulate', action: tableCode, message });
-      errorObject = this.errMgr.get(modErrs.tablePopulate.exceptionNotHandled, message);
+      errorObject = this.errMgr.get(modErrs.tablePopulate.exceptionNotHandled, this.debugMode ? message : context);
     }
     return errorObject;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuain-form-manager",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "Component library to perform operations on Tuain Development Framework forms to interchange information on web or mobile applications based on the data interchange of abstract forms making trnasformation on the data upon actions required on both sides (front and back)",
   "main": "index.js",
   "scripts": {