g360-cli 1.4.0 → 1.6.0

package/src/commands/signature.js

@@ -1,55 +1,252 @@
-import chalk from 'chalk';
-import fs from 'fs-extra';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export async function signature(command, options) {
-  const { path: targetPath = '.', force = false } = options;
-
-  if (command === 'install') {
-    console.log(chalk.bold.cyan('\n🔖 Instalando g360-signature\n'));
-
-    const targetDir = path.resolve(process.cwd(), targetPath);
-    const indexHtmlPath = path.join(targetDir, 'index.html');
-
-    if (!fs.existsSync(indexHtmlPath)) {
-      console.error(chalk.red('❌ No se encontro archivo index.html en el directorio actual'));
-      return;
-    }
-
-    let htmlContent = fs.readFileSync(indexHtmlPath, 'utf8');
-
-    const scriptTag = '    <script type="module" src="https://unpkg.com/g360-signature@latest/index.js"></script>';
-    const signatureComponent = `
-    <!-- Firma Oficial G360 -->
-    <g360-signature mode="powered" style="position: fixed; bottom: 16px; right: 16px; z-index: 99999;"></g360-signature>
-`;
-
-    // Si --force es true, eliminamos cualquier instancia existente para una reinstalación limpia.
-    // De lo contrario, si ya está instalado y no se fuerza, salimos.
-    if (force) {
-      htmlContent = htmlContent.replace(new RegExp(scriptTag.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), '');
-      htmlContent = htmlContent.replace(new RegExp(signatureComponent.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), '');
-      htmlContent = htmlContent.replace(/\n\s*\n/g, '\n'); // Limpiar posibles líneas vacías extra
-    } else if (htmlContent.includes('g360-signature')) {
-      console.log(chalk.yellow('⚠️  g360-signature ya se encuentra instalado'));
-      console.log(chalk.gray('Usa --force para reinstalar'));
-      return;
-    }
-
-    if (!htmlContent.includes(scriptTag)) {
-      htmlContent = htmlContent.replace('</body>', `${scriptTag}\n  </body>`);
-    }
-
-    if (!htmlContent.includes('<g360-signature')) {
-      htmlContent = htmlContent.replace('</body>', `${signatureComponent}\n  </body>`);
-    }
-
-    fs.writeFileSync(indexHtmlPath, htmlContent, 'utf8');
-
-    console.log(chalk.green('✅ g360-signature instalado exitosamente!'));
-    console.log(chalk.gray('\nEl componente ha sido agregado en el pie de pagina de tu proyecto\n'));
-  }
-}
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SIGNATURE_ASSETS = path.join(__dirname, '..', 'assets', 'signature');
+
+const POSITIONS = {
+  'bottom-right': 'position: fixed; bottom: 16px; right: 16px; z-index: 99999;',
+  'bottom-left': 'position: fixed; bottom: 16px; left: 16px; z-index: 99999;',
+  'bottom-center': 'position: fixed; bottom: 16px; left: 50%; transform: translateX(-50%); z-index: 99999;',
+  'footer-right': 'position: static; float: right;',
+  'footer-left': 'position: static; float: left;',
+};
+
+const FLET_POSITIONS = {
+  'sidebar': 'En el sidebar como footer',
+  'footer': 'En el footer de la pagina',
+  'fixed-bottom': 'Fijo abajo a la derecha',
+  'header': 'En el header/cabecera',
+};
+
+export async function signature(command, options) {
+  const {
+    path: targetPath = '.',
+    force = false,
+    mode = 'powered',
+    version = null,
+    position = 'bottom-right',
+    interactive = false,
+  } = options;
+
+  if (command === 'install') {
+    console.log(chalk.bold.cyan('\n🔖 Instalando g360-signature\n'));
+
+    const targetDir = path.resolve(process.cwd(), targetPath);
+    const projectType = detectProjectType(targetDir);
+
+    if (!projectType) {
+      console.error(chalk.red('❌ No se detecto un proyecto web o Flet en el directorio actual'));
+      console.log(chalk.gray('Proyectos soportados: web (HTML), Flet (Python)'));
+      return;
+    }
+
+    // Modo interactivo: guiar al usuario
+    if (interactive) {
+      const selectedPosition = await interactivePosition(projectType);
+      if (selectedPosition) {
+        options.position = selectedPosition;
+      }
+    }
+
+    if (projectType === 'flet') {
+      await installFlet(targetDir, { force, mode, version, position: options.position });
+    } else if (projectType === 'web') {
+      await installWeb(targetDir, { force, mode, version, position: options.position });
+    }
+
+    console.log(chalk.green('\n✅ g360-signature instalado exitosamente!'));
+    showUsageTips(projectType, options.position);
+  }
+
+  if (command === 'positions') {
+    showPositions();
+  }
+}
+
+function detectProjectType(dir) {
+  const pyprojectPath = path.join(dir, 'pyproject.toml');
+  if (fs.existsSync(pyprojectPath)) {
+    const content = fs.readFileSync(pyprojectPath, 'utf8');
+    if (content.includes('flet')) return 'flet';
+  }
+  const mainPy = path.join(dir, 'src', 'main.py');
+  if (fs.existsSync(mainPy)) {
+    const content = fs.readFileSync(mainPy, 'utf8');
+    if (content.includes('flet')) return 'flet';
+  }
+  const indexHtml = path.join(dir, 'index.html');
+  if (fs.existsSync(indexHtml)) return 'web';
+  return null;
+}
+
+function showPositions() {
+  console.log(chalk.bold.cyan('\n📍 Posiciones disponibles para Web:\n'));
+  Object.entries(POSITIONS).forEach(([key, value]) => {
+    console.log(chalk.white(`  ${key.padEnd(18)} ${chalk.gray(value)}`));
+  });
+
+  console.log(chalk.bold.cyan('\n📍 Posiciones disponibles para Flet:\n'));
+  Object.entries(FLET_POSITIONS).forEach(([key, value]) => {
+    console.log(chalk.white(`  ${key.padEnd(18)} ${chalk.gray(value)}`));
+  });
+
+  console.log(chalk.gray('\nEjemplo: g360 signature install --position bottom-left\n'));
+}
+
+async function interactivePosition(projectType) {
+  console.log(chalk.bold.cyan('\n📍 Selecciona la posicion de la firma:\n'));
+
+  const options = projectType === 'flet'
+    ? Object.entries(FLET_POSITIONS)
+    : Object.entries(POSITIONS);
+
+  options.forEach(([key, value], index) => {
+    console.log(chalk.white(`  ${index + 1}. ${key.padEnd(18)} ${chalk.gray(value)}`));
+  });
+
+  console.log(chalk.gray('\n  Presiona Enter para usar la posicion por defecto (bottom-right)'));
+  console.log(chalk.gray('  O escribe el nombre de la posicion\n'));
+
+  // En modo no-interactivo, retornar default
+  return null;
+}
+
+function showUsageTips(projectType, position) {
+  console.log(chalk.bold.cyan('\n💡 Tips de uso:\n'));
+
+  if (projectType === 'web') {
+    console.log(chalk.white('  Web Component:'));
+    console.log(chalk.gray('    <g360-signature mode="powered"></g360-signature>'));
+    console.log(chalk.gray('    <g360-signature mode="own" version="1.0"></g360-signature>\n'));
+  } else {
+    console.log(chalk.white('  Flet Widget:'));
+    console.log(chalk.gray('    from core.components.g360_signature import G360Signature, g360_footer'));
+    console.log(chalk.gray('    page.add(g360_footer(version="1.0"))'));
+    console.log(chalk.gray('    page.add(G360Signature(mode="own"))\n'));
+  }
+
+  console.log(chalk.white('  Cambiar posicion:'));
+  console.log(chalk.gray('    g360 signature install --position bottom-left\n'));
+
+  console.log(chalk.white('  Ver todas las posiciones:'));
+  console.log(chalk.gray('    g360 signature positions\n'));
+}
+
+async function installWeb(targetDir, { force, mode, version, position }) {
+  console.log(chalk.gray('Detectado: Proyecto Web'));
+
+  const indexHtmlPath = path.join(targetDir, 'index.html');
+  let htmlContent = fs.readFileSync(indexHtmlPath, 'utf8');
+
+  const hasLocalIndex = fs.existsSync(path.join(targetDir, 'g360-signature', 'index.js'));
+  const scriptSrc = hasLocalIndex
+    ? '    <script src="g360-signature/index.js"></script>'
+    : '    <script src="https://unpkg.com/g360-signature@latest/index.js"></script>';
+
+  const versionAttr = version ? ` version="${version}"` : '';
+  const positionStyle = POSITIONS[position] || POSITIONS['bottom-right'];
+
+  const signatureComponent = `
+    <!-- Firma Oficial G360 -->
+    <g360-signature mode="${mode}"${versionAttr} style="${positionStyle}"></g360-signature>
+`;
+
+  if (force) {
+    htmlContent = htmlContent.replace(/\n.*g360-signature.*\n/g, '\n');
+    htmlContent = htmlContent.replace(/<script[^>]*unpkg\.com\/g360-signature[^>]*><\/script>/g, '');
+    htmlContent = htmlContent.replace(/<script[^>]*g360-signature\/index\.js[^>]*><\/script>/g, '');
+    htmlContent = htmlContent.replace(/\n\s*\n/g, '\n');
+  } else if (htmlContent.includes('g360-signature')) {
+    console.log(chalk.yellow('⚠️  g360-signature ya se encuentra instalado'));
+    console.log(chalk.gray('Usa --force para reinstalar'));
+    return;
+  }
+
+  if (!hasLocalIndex) {
+    const sigDir = path.join(targetDir, 'g360-signature');
+    fs.copySync(SIGNATURE_ASSETS, sigDir);
+    console.log(chalk.gray('  Archivos copiados a g360-signature/'));
+  }
+
+  if (!htmlContent.includes('g360-signature/index.js') && !htmlContent.includes('unpkg.com/g360-signature')) {
+    htmlContent = htmlContent.replace('</body>', `${scriptSrc}\n  </body>`);
+  }
+  if (!htmlContent.includes('<g360-signature')) {
+    htmlContent = htmlContent.replace('</body>', `${signatureComponent}\n  </body>`);
+  }
+
+  fs.writeFileSync(indexHtmlPath, htmlContent, 'utf8');
+  console.log(chalk.gray('  index.html actualizado'));
+}
+
+async function installFlet(targetDir, { force, mode, version, position }) {
+  console.log(chalk.gray('Detectado: Proyecto Flet'));
+
+  const fletDestDir = path.join(targetDir, 'src', 'core', 'components');
+  if (!fs.existsSync(fletDestDir)) {
+    fs.mkdirSync(fletDestDir, { recursive: true });
+  }
+
+  const widgetDest = path.join(fletDestDir, 'g360_signature.py');
+
+  if (fs.existsSync(widgetDest) && !force) {
+    console.log(chalk.yellow('⚠️  g360-signature ya se encuentra instalado'));
+    console.log(chalk.gray('Usa --force para reinstalar'));
+    return;
+  }
+
+  const widgetSrc = path.join(SIGNATURE_ASSETS, 'g360_flet', 'g360_signature.py');
+  fs.copySync(widgetSrc, widgetDest);
+  console.log(chalk.gray('  Widget copiado a src/core/components/g360_signature.py'));
+
+  const initPath = path.join(fletDestDir, '__init__.py');
+  if (!fs.existsSync(initPath)) {
+    fs.writeFileSync(initPath, '', 'utf8');
+  }
+
+  // Insertar en main.py
+  const mainPyPath = path.join(targetDir, 'src', 'main.py');
+  if (fs.existsSync(mainPyPath)) {
+    let mainContent = fs.readFileSync(mainPyPath, 'utf8');
+
+    const importLine = 'from core.components.g360_signature import G360Signature, g360_footer';
+    const versionAttr = version ? `, version="${version}"` : '';
+
+    // Codigo de insercion segun posicion
+    let footerCode;
+    switch (position) {
+      case 'sidebar':
+        footerCode = `\n    # Firma G360 en sidebar\n    sidebar.controls.append(g360_footer(${versionAttr.trim() ? versionAttr : ''}))\n`;
+        break;
+      case 'header':
+        footerCode = `\n    # Firma G360 en header\n    header.controls.append(G360Signature(mode="${mode}"${versionAttr}))\n`;
+        break;
+      case 'fixed-bottom':
+        footerCode = `\n    # Firma G360 fija abajo\n    page.overlay.append(G360Signature(mode="${mode}"${versionAttr}))\n`;
+        break;
+      default: // footer
+        footerCode = `\n    # Firma G360\n    page.add(g360_footer(${versionAttr.trim() ? versionAttr : ''}))\n`;
+    }
+
+    if (!mainContent.includes('g360_signature')) {
+      mainContent = mainContent.replace(
+        /(from\s+core\.\w+.*\n)/,
+        `$1${importLine}\n`
+      );
+
+      if (mainContent.includes('page.add')) {
+        const lastAdd = mainContent.lastIndexOf('page.add');
+        const endOfLine = mainContent.indexOf('\n', lastAdd);
+        mainContent = mainContent.slice(0, endOfLine + 1) + footerCode + mainContent.slice(endOfLine + 1);
+      } else {
+        mainContent += footerCode;
+      }
+
+      fs.writeFileSync(mainPyPath, mainContent, 'utf8');
+      console.log(chalk.gray('  main.py actualizado'));
+    }
+  }
+}

package/src/lib/asset-validator.js

@@ -0,0 +1,145 @@
+import Ajv from 'ajv';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { logger } from './logger.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * @typedef {Object} ValidationResult
+ * @property {boolean} valid - Indica si la validación fue exitosa
+ * @property {string[]} errors - Lista de errores encontrados
+ */
+
+/**
+ * Módulo de validación de assets con JSON Schema
+ * @namespace assetValidator
+ */
+export const assetValidator = {
+  /**
+   * Instancia de AJV para validación de schemas
+   * @type {Ajv}
+   */
+  ajv: new Ajv({ allErrors: true }),
+
+  /**
+   * Cache de schemas compilados
+   * @type {Map<string, any>}
+   */
+  schemaCache: new Map(),
+
+  /**
+   * Carga y compila un schema JSON
+   * @param {string} schemaName - Nombre del schema a cargar
+   * @returns {Promise<any>} Schema compilado
+   * @private
+   */
+  async loadSchema(schemaName) {
+    if (this.schemaCache.has(schemaName)) {
+      return this.schemaCache.get(schemaName);
+    }
+
+    const schemaPath = path.join(__dirname, '../schemas', `${schemaName}.json`);
+    
+    if (!fs.existsSync(schemaPath)) {
+      throw new Error(`Schema not found: ${schemaName}`);
+    }
+
+    const schema = await fs.readJson(schemaPath);
+    const compiled = this.ajv.compile(schema);
+    
+    this.schemaCache.set(schemaName, compiled);
+    return compiled;
+  },
+
+  /**
+   * Valida un objeto contra un schema específico
+   * @param {string} schemaName - Nombre del schema a usar
+   * @param {Object} data - Datos a validar
+   * @returns {Promise<ValidationResult>} Resultado de la validación
+   * @example
+   * const result = await assetValidator.validate('skills-schema', skillsData);
+   * if (result.valid) {
+   *   console.log('Skills válidos');
+   * } else {
+   *   console.error('Errores:', result.errors);
+   * }
+   */
+  async validate(schemaName, data) {
+    try {
+      const validate = await this.loadSchema(schemaName);
+      const valid = validate(data);
+
+      if (valid) {
+        logger.debug(`Validation passed for schema: ${schemaName}`);
+        return { valid: true, errors: [] };
+      }
+
+      const errors = validate.errors.map(err => 
+        `${err.instancePath} ${err.message}`
+      );
+
+      logger.warn(`Validation failed for schema: ${schemaName}`, { errors });
+      return { valid: false, errors };
+    } catch (error) {
+      logger.error(`Error validating against schema: ${schemaName}`, { error: error.message });
+      return { 
+        valid: false, 
+        errors: [`Validation error: ${error.message}`] 
+      };
+    }
+  },
+
+  /**
+   * Valida la configuración de skills
+   * @param {Object} skillsData - Datos de skills a validar
+   * @returns {Promise<ValidationResult>} Resultado de la validación
+   * @example
+   * const result = await assetValidator.validateSkills(skillsConfig);
+   */
+  async validateSkills(skillsData) {
+    return this.validate('skills-schema', skillsData);
+  },
+
+  /**
+   * Valida la configuración de snippets
+   * @param {Object} snippetsData - Datos de snippets a validar
+   * @returns {Promise<ValidationResult>} Resultado de la validación
+   * @example
+   * const result = await assetValidator.validateSnippets(snippetsConfig);
+   */
+  async validateSnippets(snippetsData) {
+    return this.validate('snippets-schema', snippetsData);
+  },
+
+  /**
+   * Valida un asset individual
+   * @param {string} assetType - Tipo de asset ('skill' | 'snippet')
+   * @param {Object} assetData - Datos del asset a validar
+   * @returns {Promise<ValidationResult>} Resultado de la validación
+   * @example
+   * const result = await assetValidator.validateAsset('skill', skillData);
+   */
+  async validateAsset(assetType, assetData) {
+    const schemaName = assetType === 'skill' ? 'skills-schema' : 'snippets-schema';
+    
+    // Para validación individual, envolvemos el asset en la estructura esperada
+    const wrapper = assetType === 'skill' 
+      ? { skills: [assetData] }
+      : { snippets: [assetData] };
+
+    const result = await this.validate(schemaName, wrapper);
+    
+    return result;
+  },
+
+  /**
+   * Limpia el cache de schemas
+   * @returns {void}
+   */
+  clearCache() {
+    this.schemaCache.clear();
+    logger.debug('Schema cache cleared');
+  }
+};

package/src/lib/auditor.js

@@ -2,7 +2,37 @@ import fs from 'fs-extra';
 import path from 'path';
 import chalk from 'chalk';
 
+/**
+ * @typedef {Object} AuditIssue
+ * @property {string} file - Archivo donde se encontró el issue
+ * @property {string} message - Mensaje descriptivo del issue
+ * @property {string} severity - Severidad del issue ('error' | 'warning')
+ */
+
+/**
+ * @typedef {Object} AuditResult
+ * @property {number} passed - Cantidad de checks que pasaron
+ * @property {number} failed - Cantidad de checks que fallaron
+ * @property {number} warnings - Cantidad de advertencias
+ * @property {number} total - Cantidad total de checks
+ * @property {AuditIssue[]} issues - Lista de issues encontrados
+ */
+
+/**
+ * Módulo de auditoría para proyectos G360
+ * @namespace auditor
+ */
 export const auditor = {
+  /**
+   * Ejecuta auditoría completa del proyecto
+   * @param {string} projectDir - Directorio del proyecto a auditar
+   * @param {Object} options - Opciones de auditoría
+   * @param {boolean} [options.verbose=false] - Mostrar información detallada
+   * @returns {Promise<AuditResult>} Resultado de la auditoría
+   * @example
+   * const result = await auditor.audit('/my/project', { verbose: true });
+   * console.log(`Passed: ${result.passed}, Failed: ${result.failed}`);
+   */
   async audit(projectDir, options = {}) {
     const { verbose = false } = options;
     const results = {
@@ -41,6 +71,12 @@ export const auditor = {
     return results;
   },
 
+  /**
+   * Verifica si existe el manifiesto del proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @returns {Object} Resultado del check
+   * @private
+   */
   checkManifest(projectDir) {
     const manifestPath = path.join(projectDir, 'g360-manifest.json');
     if (fs.existsSync(manifestPath)) {
@@ -67,6 +103,12 @@ export const auditor = {
     return { status: 'warn', issue: { file: 'g360-manifest.json', message: 'No manifest found - run "g360 bring" to initialize' } };
   },
 
+  /**
+   * Verifica la estructura del proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @returns {Object} Resultado del check
+   * @private
+   */
   checkStructure(projectDir) {
     const g360Dir = path.join(projectDir, 'g360');
     if (fs.existsSync(g360Dir)) {
@@ -94,6 +136,12 @@ export const auditor = {
     return { status: 'warn', issue: { file: 'g360/', message: 'No G360 assets found - run "g360 bring" to initialize assets' } };
   },
 
+  /**
+   * Verifica la configuración del proyecto
+   * @param {string} projectDir - Directorio del proyecto
+   * @returns {Object} Resultado del check
+   * @private
+   */
   checkConfig(projectDir) {
     const configPath = path.join(projectDir, 'g360', 'config');
     if (fs.existsSync(configPath)) {