gufi-cli 0.1.8 → 0.1.9

package/CLAUDE.md

@@ -604,10 +604,10 @@ SELECT id, name, code FROM marketplace.views WHERE package_id = 14;
 
 ### Estructura de Archivos de una View
 
-Cuando descargas una view con `gufi pull`, obtienes:
+Cuando descargas una view con `gufi view:pull <id>`, obtienes:
 
 ```
-~/gufi-dev/mi-vista/
+~/gufi-dev/view_<id>/
 ├── index.tsx              # Entry point - exporta featureConfig y default
 ├── types.ts               # Interfaces TypeScript
 │
@@ -1032,6 +1032,46 @@ export default function MiVista({ gufi }) {
 - Permisos dinámicos expandibles (ej: warehouses individuales)
 - Integridad total: UI siempre refleja el estado real
 
+### 💜 DevPermissionSwitcher AUTOMÁTICO (LivePreviewPage)
+
+**¡Ya no necesitas incluir DevPermissionSwitcher en tu código!** LivePreviewPage detecta automáticamente si tu vista tiene `featureConfig.permissions` y muestra el botón DEV.
+
+**Cómo funciona:**
+1. Declara permisos en `metadata/permissions.ts`
+2. Expórtalos en `featureConfig`:
+   ```typescript
+   // core/dataProvider.ts
+   import { permissions } from '../metadata/permissions';
+
+   export const featureConfig = {
+     dataSources,
+     inputs: featureInputs,
+     permissions,  // 💜 Solo añadir esto
+   };
+   ```
+3. LivePreviewPage lo detecta y muestra el botón DEV automáticamente
+
+**Usar devPermissions del contexto:**
+```typescript
+export default function MiVista({ gufi }) {
+  // 💜 LivePreviewPage provee devPermissions automáticamente
+  const effectiveDevPermissions = gufi?.context?.devPermissions || [];
+
+  const permissionsConfig = {
+    userPermissions: gufi?.context?.userPermissions || [],
+    isDevMode: gufi?.context?.isPreview || gufi?.context?.isDev,
+    devPermissions: effectiveDevPermissions,
+  };
+
+  // Usar helpers de permisos normalmente
+  const canSend = hasPermission(permissionsConfig, 'send_orders');
+}
+```
+
+**Cuándo incluir DevPermissionSwitcher manualmente:**
+- Solo si la vista se ejecuta fuera de LivePreviewPage (ej: vista nativa del frontend)
+- Para vistas del marketplace en Developer Center → **NO necesario**, es automático
+
 **Principio clave**: Inicializar con `[]` vacío, luego usar `useEffect` para otorgar todos los permisos cuando los valores dinámicos (como warehouses) terminen de cargar. Esto garantiza integridad UI.
 
 ---
@@ -1629,11 +1669,13 @@ gufi rows:create m360_t16192 --file datos.json
 ### Desarrollo de Views
 
 ```bash
-# Ver tus views del Marketplace
+# Ver tus views del Marketplace (muestra ID de cada vista)
 gufi views
+#   📦 Gestión de Tareas (ID: 14)
+#      └─ 13 Tasks Manager (custom)
 
-# Descargar view para editar localmente
-gufi view:pull "Stock Overview"
+# Descargar view por ID (se guarda en ~/gufi-dev/view_<id>/)
+gufi view:pull 13
 
 # Auto-sync al guardar archivos
 gufi view:watch
@@ -1670,7 +1712,7 @@ gufi view:status
 | Ver estructura de una company | `gufi modules <company_id>` |
 | Ver/editar JSON de módulo | `gufi module <id> -c <company>` |
 | Ver/editar código de automation | `gufi automation <nombre> -c <company>` |
-| Desarrollar una vista | `gufi pull`, `gufi watch`, `gufi logs` |
+| Desarrollar una vista | `gufi view:pull <id>`, `gufi view:watch`, `gufi view:logs` |
 
 ### Errores comunes
 

package/dist/commands/companies.js

@@ -370,11 +370,12 @@ export async function companyCreateCommand(name) {
             method: "POST",
             body: JSON.stringify({ name }),
         });
-        const company = result.data || result;
+        // API returns { company: {...}, message: "..." }
+        const company = result.company || result.data || result;
         console.log(chalk.green("  ✓ Company creada!\n"));
         console.log(chalk.white(`  ID: ${company.id}`));
         console.log(chalk.white(`  Nombre: ${company.name}`));
-        console.log(chalk.white(`  Schema: company_${company.id}`));
+        console.log(chalk.white(`  Schema: ${company.schema || 'company_' + company.id}`));
         console.log(chalk.gray("\n  💡 Usa: gufi modules " + company.id + " para ver módulos\n"));
     }
     catch (err) {

package/dist/commands/list.js

@@ -29,11 +29,11 @@ export async function listCommand() {
             else {
                 views.forEach((view, i) => {
                     const prefix = i === views.length - 1 ? "└─" : "├─";
-                    console.log(chalk.white(`     ${prefix} ${view.name}`) + chalk.gray(` (${view.view_type}, ID: ${view.pk_id})`));
+                    console.log(`     ${prefix} ${chalk.cyan(view.pk_id)} ${view.name} ${chalk.gray(`(${view.view_type})`)}`);
                 });
             }
         }
-        console.log(chalk.gray("\n  Usa: gufi pull <view-id> para descargar una vista\n"));
+        console.log(chalk.gray("\n  Usa: ") + chalk.cyan("gufi view:pull <id>") + chalk.gray(" para descargar una vista\n"));
     }
     catch (error) {
         spinner.fail(chalk.red(error.message));

package/dist/commands/pull.js

@@ -13,17 +13,17 @@ export async function pullCommand(viewIdentifier) {
     }
     console.log(chalk.magenta("\n  🟣 Gufi Pull\n"));
     let viewId;
-    let viewName;
+    let viewKey;
     let packageId;
-    // If view ID provided directly
+    // 💜 Solo acepta ID numérico
     if (viewIdentifier && /^\d+$/.test(viewIdentifier)) {
         viewId = parseInt(viewIdentifier);
         const spinner = ora("Obteniendo vista...").start();
         try {
             const view = await getView(viewId);
-            viewName = view.name || `vista-${viewId}`;
+            viewKey = `view_${viewId}`;
             packageId = view.package_id;
-            spinner.succeed(`Vista: ${viewName}`);
+            spinner.succeed(`Vista ${chalk.cyan(viewId)}: ${view.name || "sin nombre"}`);
         }
         catch (error) {
             spinner.fail(chalk.red(`No se encontró la vista ${viewId}`));
@@ -56,22 +56,14 @@ export async function pullCommand(viewIdentifier) {
                 process.exit(0);
             }
             console.log(chalk.gray("  Vistas disponibles:\n"));
-            views.forEach((view, i) => {
-                const name = view.name || `Vista ${view.pk_id}`;
-                console.log(`  ${chalk.cyan(i + 1)}. ${name} ${chalk.gray(`(${view.view_type})`)}`);
+            views.forEach((view) => {
+                console.log(`     ${chalk.cyan(view.pk_id)} ${view.name || "sin nombre"} ${chalk.gray(`(${view.view_type})`)}`);
             });
-            // If viewIdentifier matches a name
-            let selectedView = viewIdentifier
-                ? views.find(v => v.name && v.name.toLowerCase().includes(viewIdentifier.toLowerCase()))
-                : views[0];
-            if (!selectedView) {
-                console.log(chalk.yellow(`\n  No se encontró vista "${viewIdentifier}"\n`));
-                console.log(chalk.gray("  Uso: gufi pull <nombre-vista> o gufi pull <view-id>\n"));
-                process.exit(1);
+            if (viewIdentifier) {
+                console.log(chalk.yellow(`\n  "${viewIdentifier}" no es un ID válido.\n`));
             }
-            viewId = selectedView.pk_id;
-            viewName = selectedView.name || `vista-${selectedView.pk_id}`;
-            console.log(chalk.gray(`\n  Descargando: ${viewName}\n`));
+            console.log(chalk.gray("\n  Uso: ") + chalk.cyan("gufi view:pull <id>") + chalk.gray(" (ej: gufi view:pull 13)\n"));
+            process.exit(0);
         }
         catch (error) {
             spinner.fail(chalk.red(error.message));
@@ -81,7 +73,7 @@ export async function pullCommand(viewIdentifier) {
     // Pull the view
     const pullSpinner = ora("Descargando archivos...").start();
     try {
-        const result = await pullView(viewId, viewName, packageId);
+        const result = await pullView(viewId, viewKey, packageId);
         pullSpinner.succeed(chalk.green(`${result.fileCount} archivos descargados`));
         console.log(chalk.gray(`\n  📁 ${result.dir}\n`));
         console.log(chalk.gray("  Comandos útiles:"));

package/dist/index.js

@@ -44,7 +44,7 @@ const program = new Command();
 program
     .name("gufi")
     .description("🟣 Gufi CLI - Desarrolla módulos, vistas y automations")
-    .version("0.1.7");
+    .version("0.1.8");
 // ════════════════════════════════════════════════════════════════════
 // 🔐 Auth
 // ════════════════════════════════════════════════════════════════════

package/dist/lib/sync.d.ts

@@ -12,12 +12,15 @@ export interface ViewMeta {
         mtime: number;
     }>;
 }
-export declare function getViewDir(viewName: string): string;
+export declare function getViewDir(viewKey: string): string;
 export declare function loadViewMeta(viewDir: string): ViewMeta | null;
 /**
  * Pull view files from Gufi to local directory
+ * @param viewId - The view ID
+ * @param viewKey - The unique identifier in view_<id> format (e.g., view_123)
+ * @param packageId - The package ID
  */
-export declare function pullView(viewId: number, viewName: string, packageId: number): Promise<{
+export declare function pullView(viewId: number, viewKey: string, packageId: number): Promise<{
     dir: string;
     fileCount: number;
 }>;

package/dist/lib/sync.js

@@ -37,8 +37,9 @@ function getLanguage(filePath) {
     };
     return langMap[ext] || "text";
 }
-export function getViewDir(viewName) {
-    return path.join(GUFI_DEV_DIR, viewName.toLowerCase().replace(/\s+/g, "-"));
+// 💜 viewKey is now always in view_<id> format (e.g., view_123)
+export function getViewDir(viewKey) {
+    return path.join(GUFI_DEV_DIR, viewKey.toLowerCase());
 }
 export function loadViewMeta(viewDir) {
     const metaPath = path.join(viewDir, META_FILE);
@@ -57,9 +58,12 @@ function saveViewMeta(viewDir, meta) {
 }
 /**
  * Pull view files from Gufi to local directory
+ * @param viewId - The view ID
+ * @param viewKey - The unique identifier in view_<id> format (e.g., view_123)
+ * @param packageId - The package ID
  */
-export async function pullView(viewId, viewName, packageId) {
-    const viewDir = getViewDir(viewName);
+export async function pullView(viewId, viewKey, packageId) {
+    const viewDir = getViewDir(viewKey);
     ensureDir(viewDir);
     const files = await getViewFiles(viewId);
     const fileMeta = {};
@@ -74,14 +78,14 @@ export async function pullView(viewId, viewName, packageId) {
     }
     const meta = {
         viewId,
-        viewName,
+        viewName: viewKey, // 💜 Store viewKey as viewName for backwards compat
         packageId,
         lastSync: new Date().toISOString(),
         files: fileMeta,
     };
     saveViewMeta(viewDir, meta);
     // Update current view in config
-    setCurrentView({ id: viewId, name: viewName, packageId, localPath: viewDir });
+    setCurrentView({ id: viewId, name: viewKey, packageId, localPath: viewDir });
     return { dir: viewDir, fileCount: files.length };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gufi-cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "CLI for developing Gufi Marketplace views locally with Claude Code",
   "bin": {
     "gufi": "./bin/gufi.js"