gufi-cli 0.1.38 → 0.1.40

package/CLAUDE.md

@@ -55,9 +55,9 @@ gufi config:prod
 }
 ```
 
-## MCP Server - 12 Tools
+## MCP Server - 13 Tools
 
-El servidor MCP está en `src/mcp.ts` y expone **12 tools** para que Claude interactúe con Gufi.
+El servidor MCP está en `src/mcp.ts` y expone **13 tools** para que Claude interactúe con Gufi.
 
 ### Tools organizados por categoría
 
@@ -66,7 +66,7 @@ El servidor MCP está en `src/mcp.ts` y expone **12 tools** para que Claude inte
 | **Context** | `gufi_context` | Schema completo (company, view, package) |
 | | `gufi_whoami` | Usuario, entorno, empresas |
 | | `gufi_docs` | Documentación (`docs/mcp/`) |
-| **Schema** | `gufi_schema_modify` | Operaciones atomicas (add/update/remove) |
+| **Schema** | `gufi_schema_modify` | Operaciones atómicas (add/update/remove) |
 | **Automations** | `gufi_automation` | Scripts: list, get, create |
 | | `gufi_triggers` | Ver/configurar triggers |
 | | `gufi_executions` | Historial de ejecuciones |
@@ -74,6 +74,7 @@ El servidor MCP está en `src/mcp.ts` y expone **12 tools** para que Claude inte
 | **Env** | `gufi_env` | Variables: list, set, delete |
 | **Views** | `gufi_view_pull` | Descargar vista a local |
 | | `gufi_view_push` | Subir cambios a draft |
+| | `gufi_view_test` | Test en headless browser (errores, screenshot) |
 | **Packages** | `gufi_package` | list, get, create, delete, add_module, remove_module, publish |
 
 ### Añadir un nuevo tool MCP

package/README.md

@@ -173,11 +173,12 @@ const { rows } = await api.query(...);  // ERROR!
 ### Llamar automations desde vistas
 
 ```tsx
-await dataProvider.runClickAutomation?.({
-  company_id, module_id, table_id: entityId,
-  function_name: "my_automation",
-  input: { record_id: 123 },
+// 💜 gufi.automation() - Simple y directo
+const result = await gufi.automation('my_automation', {
+  record_id: 123
 });
+
+// La automation tiene acceso a api.stripe.*, api.nayax.*, etc.
 ```
 
 ## Row CRUD (Datos)

package/dist/index.js

@@ -82,11 +82,14 @@ import { doctorCommand } from "./commands/doctor.js";
 import { docsCommand } from "./commands/docs.js";
 import { startMcpServer } from "./mcp.js";
 import { claudeCommand } from "./commands/claude.js";
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 const program = new Command();
 program
     .name("gufi")
     .description("🟣 Gufi CLI - Desarrolla módulos, vistas y automations")
-    .version("0.1.8");
+    .version(pkg.version);
 // ════════════════════════════════════════════════════════════════════
 // 🔐 Auth
 // ════════════════════════════════════════════════════════════════════

package/dist/mcp.js

@@ -552,6 +552,16 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "gufi_integrations",
+        description: "List available integrations (Stripe, Nayax, etc.) and their methods. Use this to see what api.* methods are available in automations. Credentials are passed from automations using env.* variables.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Integration name to get detailed info (optional)" },
+            },
+        },
+    },
     // ─────────────────────────────────────────────────────────────────────────
     // Automations (Business Logic)
     // ─────────────────────────────────────────────────────────────────────────
@@ -713,6 +723,35 @@ Example: gufi_view_push({ view_id: 13, message: "Fixed bug in chart" })`,
             required: [],
         },
     },
+    // 🧪 Test view in headless browser
+    {
+        name: "gufi_view_test",
+        description: getDesc("gufi_view_test"),
+        inputSchema: {
+            type: "object",
+            properties: {
+                view_id: { type: "number", description: "View ID to test" },
+                company_id: { type: "string", description: "Company ID for authentication context" },
+                timeout: { type: "number", description: "Navigation timeout in ms (default: 15000)" },
+                actions: {
+                    type: "array",
+                    description: "Optional actions to perform after page load: [{type:'click',selector:'.btn'}, {type:'fill',selector:'input',value:'text'}, {type:'wait',selector:'.loaded'}, {type:'delay',ms:1000}]",
+                    items: {
+                        type: "object",
+                        properties: {
+                            type: { type: "string", description: "Action type: click, fill, wait, delay" },
+                            selector: { type: "string", description: "CSS selector for click/fill/wait" },
+                            value: { type: "string", description: "Value for fill action" },
+                            ms: { type: "number", description: "Milliseconds for delay action" },
+                        },
+                    },
+                },
+                capture_screenshot: { type: "boolean", description: "Include base64 screenshot (default: true)" },
+                env: ENV_PARAM,
+            },
+            required: ["view_id", "company_id"],
+        },
+    },
     // ─────────────────────────────────────────────────────────────────────────
     // Packages (Marketplace Distribution)
     // ─────────────────────────────────────────────────────────────────────────
@@ -1104,6 +1143,102 @@ const toolHandlers = {
             hint: "Use gufi_docs({ topic: 'fields' }) to read about field types, or gufi_docs({ search: 'currency' }) to search.",
         };
     },
+    async gufi_integrations(params) {
+        const { name } = params;
+        // Static list of available integrations and their methods
+        // Credentials are passed from automations using env.* - no configuration status to check
+        const integrations = {
+            stripe: {
+                name: "stripe",
+                description: "Stripe payment processing - Create checkout sessions, handle payments",
+                category: "payments",
+                docs: "https://stripe.com/docs/api",
+                methods: [
+                    { name: "createCheckoutSession", description: "Create a Stripe Checkout Session for payment", params: ["secretKey", "lineItems", "customerEmail?", "successUrl?", "cancelUrl?"] },
+                ],
+            },
+            nayax: {
+                name: "nayax",
+                description: "Nayax vending machine telemetry - Sync machines, products, sales, alerts",
+                category: "vending",
+                docs: "https://developers.nayax.com/",
+                methods: [
+                    { name: "sync_machines", description: "Sync all machines from Nayax", params: ["token", "tableName"] },
+                    { name: "sync_products", description: "Sync products from Nayax", params: ["token", "tableName"] },
+                    { name: "sync_last_sales", description: "Sync recent sales", params: ["token", "tableName", "machinesTable", "productsTable"] },
+                    { name: "sync_alerts", description: "Sync machine alerts", params: ["token", "tableName", "machinesTable", "productsTable"] },
+                    { name: "sync_machine_products", description: "Sync planograms", params: ["token", "tableName", "machinesTable", "productsTable"] },
+                    { name: "sync_pick_list", description: "Sync low stock items", params: ["token", "tableName", "machinesTable", "productsTable"] },
+                    { name: "sync_single_machine_capacity", description: "Sync and calculate capacity for one machine", params: ["machineId", "token", "machineProductsTable", "machinesTable", "productsTable"] },
+                ],
+            },
+            ourvend: {
+                name: "ourvend",
+                description: "OurVend (RedPanda) vending system - Sync groups, machines, products, sales",
+                category: "vending",
+                docs: "https://ourvend.com/api",
+                methods: [
+                    { name: "sync_groups", description: "Sync machine groups", params: ["user", "password", "tableName"] },
+                    { name: "sync_machines", description: "Sync machines", params: ["user", "password", "tableName", "groupsTable"] },
+                    { name: "sync_products", description: "Sync products", params: ["user", "password", "tableName"] },
+                    { name: "sync_sales", description: "Sync sales", params: ["user", "password", "tableName", "machinesTable", "productsTable", "groupsTable", "dateFrom?", "dateTo?"] },
+                ],
+            },
+            tns: {
+                name: "tns",
+                description: "TNS Colombian accounting - Sync products and categories",
+                category: "accounting",
+                docs: "https://tns.com.co/api",
+                methods: [
+                    { name: "sync_products", description: "Sync products from TNS", params: ["productsTable", "categoriesTable", "env?"] },
+                    { name: "sync_products_from_sales", description: "Sync products that appear in sales", params: ["productsTable", "categoriesTable", "salesTable", "env?"] },
+                    { name: "sync_all_products", description: "Sync all products from catalog", params: ["productsTable", "categoriesTable", "env?"] },
+                ],
+            },
+        };
+        if (name) {
+            const integration = integrations[name];
+            if (!integration) {
+                return {
+                    error: `Integration '${name}' not found`,
+                    available: Object.keys(integrations),
+                };
+            }
+            return {
+                ...integration,
+                methods: integration.methods.map((m) => ({
+                    ...m,
+                    usage: `api.${name}.${m.name}({ ${m.params.map(p => p.replace("?", "")).join(", ")} })`,
+                })),
+                usage_note: "Credentials (tokens, passwords, keys) are passed from automations using env.* variables. Name your env vars however you prefer.",
+                example: `
+// In automation:
+async function my_automation(context, api, logger) {
+  const { env } = context;
+  const result = await api.${name}.${integration.methods[0].name}({
+    ${integration.methods[0].params.filter(p => !p.endsWith("?")).map(p => `${p}: env.MY_${p.toUpperCase()}`).join(",\n    ")}
+  });
+  return result;
+}`,
+            };
+        }
+        // List all integrations
+        return {
+            integrations: Object.values(integrations).map((i) => ({
+                name: i.name,
+                description: i.description,
+                category: i.category,
+                methods: i.methods.map((m) => m.name),
+            })),
+            usage_note: "Credentials are passed from automations using env.* variables. Name your env vars however you prefer.",
+            example: `
+// In automation, use api.{integration}.{method}():
+const result = await api.stripe.createCheckoutSession({
+  secretKey: env.MY_STRIPE_KEY,  // Your env var name
+  lineItems: [{ name: 'Product', amount: 1999, quantity: 1 }],
+});`,
+        };
+    },
     // ─────────────────────────────────────────────────────────────────────────
     // Automations
     // ─────────────────────────────────────────────────────────────────────────
@@ -1498,6 +1633,62 @@ const toolHandlers = {
                 : "Changes saved (no package - goes directly to production)",
         };
     },
+    async gufi_view_test(params) {
+        const { view_id, company_id, timeout, actions, capture_screenshot, env } = params;
+        const result = await apiRequest("/api/cli/view-test", {
+            method: "POST",
+            body: JSON.stringify({
+                view_id,
+                company_id,
+                timeout: timeout || 15000,
+                actions: actions || [],
+                capture_screenshot: capture_screenshot !== false,
+            }),
+        }, company_id, true, env);
+        // Format response for Claude readability
+        const response = {
+            success: result.success,
+            view_id: result.view_id,
+            url: result.url,
+            duration_ms: result.duration_ms,
+        };
+        // Add console output if there are errors/warnings
+        if (result.console?.errors?.length > 0) {
+            response.console_errors = result.console.errors;
+        }
+        if (result.console?.warnings?.length > 0) {
+            response.console_warnings = result.console.warnings;
+        }
+        if (result.console?.logs?.length > 0) {
+            response.console_logs = result.console.logs;
+        }
+        // Add JS/network errors
+        if (result.errors?.length > 0) {
+            response.errors = result.errors;
+        }
+        // Add failed API calls
+        const failedCalls = (result.api_calls || []).filter((c) => c.status >= 400);
+        if (failedCalls.length > 0) {
+            response.failed_api_calls = failedCalls;
+        }
+        // Add DOM info
+        response.dom = result.dom;
+        // Add screenshot (Claude can view base64 images)
+        if (result.screenshot) {
+            response.screenshot = result.screenshot;
+        }
+        // Add hint based on results
+        if (!result.success) {
+            response._hint = `View test failed: ${result.error}. Check console_errors and errors for details.`;
+        }
+        else if (result.errors?.length > 0 || result.console?.errors?.length > 0) {
+            response._hint = "View loaded but has errors. Check console_errors and errors arrays.";
+        }
+        else {
+            response._hint = "View loaded successfully. Check screenshot to verify visual appearance.";
+        }
+        return response;
+    },
     // gufi_view_create removed - views are created from UI, edited via pull/push
     // ─────────────────────────────────────────────────────────────────────────
     // Packages
@@ -1683,46 +1874,19 @@ async function generateViewContextMcp(viewId, includeConcepts, env) {
     }
     const config = view.config || {};
     const viewCompanyId = config.view_company_id;
-    // Try to get featureConfig from marketplace backend
-    let dataSources = {};
-    let inputs = {};
-    try {
-        // Marketplace endpoint is at /api/marketplace/views/:id/feature-config
-        const featureConfigResponse = await apiRequest(`/api/marketplace/views/${viewId}/feature-config`, {}, undefined, true, env);
-        const featureConfig = featureConfigResponse.data || featureConfigResponse;
-        // If we have dataSources from featureConfig, use them
-        if (featureConfig && Array.isArray(featureConfig.dataSources)) {
-            featureConfig.dataSources.forEach((ds) => {
-                if (ds.key && ds.table) {
-                    dataSources[ds.key] = ds.table;
-                }
-            });
-        }
-        // Inputs from featureConfig (if available)
-        if (featureConfig && Array.isArray(featureConfig.inputs)) {
-            featureConfig.inputs.forEach((inp) => {
-                if (inp.key) {
-                    inputs[inp.key] = inp;
-                }
-            });
+    // Extract dataSources and inputs from config
+    const dataSources = {};
+    const inputs = {};
+    Object.entries(config).forEach(([key, value]) => {
+        if (["view_company_id", "category", "is_public", "slug"].includes(key))
+            return;
+        if (key.endsWith("Table") || key.endsWith("table")) {
+            dataSources[key] = value;
         }
-        else if (featureConfig && typeof featureConfig.inputs === 'object') {
-            inputs = featureConfig.inputs;
+        else {
+            inputs[key] = value;
         }
-    }
-    catch (err) {
-        // If featureConfig endpoint fails, fallback to parsing config
-        Object.entries(config).forEach(([key, value]) => {
-            if (["view_company_id", "category", "is_public", "slug"].includes(key))
-                return;
-            if (key.endsWith("Table") || key.endsWith("table")) {
-                dataSources[key] = value;
-            }
-            else {
-                inputs[key] = value;
-            }
-        });
-    }
+    });
     // Load modules and automations if we have view_company_id
     let modules = [];
     let automations = [];

package/package.json

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