viewgate-mcp 1.0.15 → 1.0.17

package/dist/index.js

@@ -228,7 +228,7 @@ function createMcpServer(apiKey, personalKey) {
                             figmaReference: ann.figmaReference,
                             backendEndpoints: ann.backendEndpoints || [ann.backendEndpoint].filter(Boolean),
                             _ia_fix_instruction: `### 🎨 DESIGN CONTEXT (Figma)
-${ann.figmaReference ? `A design reference is available: ${ann.figmaReference}. Use the 'get_figma_preview' tool to fetch design details and image previews before implementing.` : 'No explicit figma design linked.'}
+${ann.figmaReference ? `A design reference is available: ${Array.isArray(ann.figmaReference) ? (ann.figmaReference[0]?.link || ann.figmaReference[0]) : (ann.figmaReference.link || ann.figmaReference)}. Use the 'get_figma_preview' tool to fetch design details and image previews before implementing.` : 'No explicit figma design linked.'}
 
 ### 🔬 SURGICAL FIX PROTOCOL (Language: ${data.preferredLanguage || 'en'})
 1. **PRIMARY**: Search for \`data-vg-id="${ann.reference?.vgId}"\`.
@@ -431,31 +431,54 @@ Instruction: ${ann.message}`
                         };
                     }
                     // 2. Parse Figma URL
-                    const fileKeyMatch = url.match(/(file|design)\/([a-zA-Z0-9]+)/);
-                    if (!fileKeyMatch) {
+                    let fileKey = "";
+                    try {
+                        if (url.includes("/file/") || url.includes("/design/")) {
+                            const parts = url.split(/\/(?:file|design)\//)[1].split("/");
+                            fileKey = parts[0].split(/[?#]/)[0];
+                        }
+                    }
+                    catch (e) {
+                        throw new Error("Could not parse Figma File Key from URL.");
+                    }
+                    if (!fileKey) {
                         throw new Error("Invalid Figma URL format. File key not found.");
                     }
-                    const fileKey = fileKeyMatch[2];
                     // Extract node-id if present
-                    const urlObj = new URL(url.replace(/#/g, '?')); // Handle hash-based node-id
-                    let nodeId = urlObj.searchParams.get('node-id') || urlObj.searchParams.get('m');
-                    if (!nodeId && url.includes('node-id=')) {
-                        nodeId = url.split('node-id=')[1].split('&')[0].replace('%3A', ':');
+                    let nodeId = "";
+                    try {
+                        const urlObj = new URL(url.replace(/#/g, "?")); // Handle hash-based node-id
+                        nodeId = urlObj.searchParams.get("node-id") || urlObj.searchParams.get("m") || "";
+                        if (!nodeId && url.includes("node-id=")) {
+                            nodeId = url.split("node-id=")[1].split("&")[0];
+                        }
+                        // Normalización y limpieza
+                        if (nodeId) {
+                            nodeId = decodeURIComponent(nodeId).replace(/-/g, ":");
+                        }
+                    }
+                    catch (e) {
+                        // Silent fail for nodeId, might just fetch full file
                     }
                     // 3. Fetch Data from Figma
-                    // First get file info
-                    const figmaApiUrl = `https://api.figma.com/v1/files/${fileKey}${nodeId ? `?ids=${nodeId}` : ''}`;
+                    // Use /nodes endpoint if nodeId exists, otherwise /files
+                    const encodedNodeId = nodeId ? encodeURIComponent(nodeId) : "";
+                    const figmaApiUrl = nodeId
+                        ? `https://api.figma.com/v1/files/${fileKey}/nodes?ids=${encodedNodeId}`
+                        : `https://api.figma.com/v1/files/${fileKey}`;
                     const figmaResponse = await fetch(figmaApiUrl, {
                         headers: { 'X-Figma-Token': figmaToken }
                     });
                     if (!figmaResponse.ok) {
-                        throw new Error(`Figma API returned ${figmaResponse.status}: ${await figmaResponse.text()}`);
+                        const errorText = await figmaResponse.text();
+                        throw new Error(`Figma API returned ${figmaResponse.status}: ${errorText} (URL: ${figmaApiUrl})`);
                     }
-                    const figmaData = (await figmaResponse.json());
+                    const rawData = (await figmaResponse.json());
                     // 4. Optionally fetch image preview if a node is specified
                     let imageUrl = null;
                     if (nodeId) {
-                        const imageResponse = await fetch(`https://api.figma.com/v1/images/${fileKey}?ids=${nodeId}&scale=2&format=png`, {
+                        const encodedIds = encodeURIComponent(nodeId);
+                        const imageResponse = await fetch(`https://api.figma.com/v1/images/${fileKey}?ids=${encodedIds}&scale=2&format=png`, {
                             headers: { 'X-Figma-Token': figmaToken }
                         });
                         if (imageResponse.ok) {
@@ -463,14 +486,15 @@ Instruction: ${ann.message}`
                             imageUrl = imageData.images?.[nodeId];
                         }
                     }
+                    const nodeInfo = nodeId ? rawData.nodes?.[nodeId] : null;
                     return {
                         content: [{
                                 type: "text",
                                 text: JSON.stringify({
-                                    fileName: figmaData.name,
-                                    lastModified: figmaData.lastModified,
+                                    fileName: rawData.name || "Unknown File",
+                                    lastModified: rawData.lastModified,
                                     previewUrl: imageUrl,
-                                    nodeName: nodeId ? (figmaData.nodes?.[nodeId]?.document?.name || 'Selected Component') : 'Full File',
+                                    nodeName: nodeInfo ? (nodeInfo.document?.name || 'Selected Component') : 'Full File',
                                     note: "Design context successfully retrieved from Figma."
                                 }, null, 2)
                             }]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viewgate-mcp",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "main": "dist/index.js",
   "bin": {
     "viewgate-mcp": "./dist/index.js"