Validation.gs

/**
 * @file Validation.gs
 * @description Módulo responsável por validações globais e centralizadas.
 * Implementa validação de payloads, tipos de dados e regras de negócio padrão.
 *
 * @module    Validation
 * @namespace Validation
 * @author    EnSiSanar Dev Team
 * @version   1.1.0
 * @since     2026-04-16
 * @requires  Logger_System
 */

const Validation = {
  _MODULE_NAME: 'Validation',

  init: function() {
    try {
      Logger_System.info(`[${this._MODULE_NAME}] inicializado com sucesso.`);
    } catch (e) {
      Logger.log(`[Validation.init] Erro ao inicializar: ${e.message}`);
    }
  },

  validatePayload: function (data, required) {
    if (!data || typeof data !== 'object') {
      return { valid: false, message: 'Payload ausente ou inválido.' };
    }
    for (const key of required) {
      if (data[key] === undefined || data[key] === null || data[key] === '') {
        return { valid: false, message: 'Campo obrigatório ausente: ' + key };
      }
    }
    return { valid: true };
  },

  sanitizeString: function(str) {
    if (!str || typeof str !== 'string') return '';
    return str.trim().replace(/<[^>]*>?/gm, ''); // Limpa tags HTML básicas
  }
};

function initValidation() {
  Validation.init();
}