ingresseflow-bridge 1.1.0 → 1.2.0

package/dist/index.js

@@ -179,10 +179,44 @@ server.tool('figjam_create_stickies', 'Cria múltiplos post-its de uma vez no Fi
     const result = await sendToPlugin('CREATE_STICKIES', { stickies });
     return { content: [{ type: 'text', text: JSON.stringify(result) }] };
 });
-server.tool('figjam_read_board', 'Lê todo o conteúdo do FigJam atual. Retorna nós com texto, posição e tipo.', {}, async () => {
-    const result = await sendToPlugin('READ_BOARD', {});
+server.tool('figjam_read_board', 'Lê o conteúdo do FigJam. Por padrão faz recursão dentro de sections/frames/groups. Retorna id, type, name, x, y, width, height, parentId, depth, text (se STICKY/TEXT/SHAPE_WITH_TEXT/CONNECTOR) e hasImage=true para nós com fill de imagem.', {
+    recursive: z.boolean().default(true).describe('Descer dentro de containers (section, frame, group)'),
+    maxDepth: z.number().default(10).describe('Profundidade máxima de recursão'),
+    filterTypes: z.array(z.string()).optional().describe('Filtra os nós retornados por tipo (ex.: ["STICKY","RECTANGLE","FRAME"]). A recursão continua mesmo em nós filtrados.'),
+}, async ({ recursive, maxDepth, filterTypes }) => {
+    const result = await sendToPlugin('READ_BOARD', { recursive, maxDepth, filterTypes });
     return { content: [{ type: 'text', text: JSON.stringify(result) }] };
 });
+server.tool('figjam_export_node', 'Exporta um nó (frame, image, section, qualquer SceneNode com exportAsync) como PNG/JPG/SVG/PDF e retorna a imagem renderizada para que Claude consiga visualizar prints/screenshots colados no canvas.', {
+    nodeId: z.string().describe('ID do nó a exportar'),
+    format: z.enum(['PNG', 'JPG', 'SVG', 'PDF']).default('PNG'),
+    scale: z.number().default(1).describe('Escala da exportação (1=original, 2=2x). Ignorado em SVG/PDF.'),
+}, async ({ nodeId, format, scale }) => {
+    const result = await sendToPlugin('EXPORT_NODE', { nodeId, format, scale });
+    const mimeMap = {
+        PNG: 'image/png',
+        JPG: 'image/jpeg',
+        SVG: 'image/svg+xml',
+        PDF: 'application/pdf',
+    };
+    const mimeType = mimeMap[result.format] ?? 'image/png';
+    // Image formats Claude can render get image content; SVG/PDF fall back to text.
+    if (result.format === 'PNG' || result.format === 'JPG') {
+        return {
+            content: [
+                { type: 'image', data: result.base64, mimeType },
+                { type: 'text', text: JSON.stringify({
+                        nodeId, format: result.format,
+                        width: result.width, height: result.height,
+                        byteLength: result.byteLength,
+                    }) },
+            ],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+});
 server.tool('figjam_get_selection', 'Retorna os nós atualmente selecionados no Figma.', {}, async () => {
     const result = await sendToPlugin('GET_SELECTION', {});
     return { content: [{ type: 'text', text: JSON.stringify(result) }] };
@@ -297,7 +331,7 @@ server.tool('figjam_delete_nodes', 'Remove nós do canvas pelo ID.', {
 // Generic forwarder — lets new plugin operations be invoked without bridge updates.
 // Useful for evolving the plugin independently: any new op type added in code.ts
 // becomes immediately accessible via this tool.
-server.tool('figjam_execute', 'Encaminha uma operação arbitrária para o plugin (escape hatch para ops novas que ainda não têm tool dedicada). Tipos válidos atuais: PING, CREATE_STICKY, CREATE_STICKIES, CREATE_SECTION, CREATE_SHAPE, CREATE_SHAPES, CREATE_CONNECTOR, CREATE_CONNECTORS, CREATE_FLOW, SET_CONNECTOR_LABELS, MOVE_NODES, DELETE_NODES, READ_BOARD, GET_SELECTION.', {
+server.tool('figjam_execute', 'Encaminha uma operação arbitrária para o plugin (escape hatch para ops novas que ainda não têm tool dedicada). Tipos válidos atuais: PING, CREATE_STICKY, CREATE_STICKIES, CREATE_SECTION, CREATE_SHAPE, CREATE_SHAPES, CREATE_CONNECTOR, CREATE_CONNECTORS, CREATE_FLOW, SET_CONNECTOR_LABELS, MOVE_NODES, DELETE_NODES, READ_BOARD, GET_SELECTION, EXPORT_NODE.', {
     type: z.string().describe('Nome da operação no plugin (ex.: CREATE_SHAPE)'),
     payload: z.record(z.unknown()).optional().describe('Payload da operação'),
 }, async ({ type, payload }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ingresseflow-bridge",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Bridge MCP server for IngresseFlow — connects Claude Code to FigJam via Figma Desktop plugin",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -216,14 +216,57 @@ server.tool(
 
 server.tool(
   'figjam_read_board',
-  'Lê todo o conteúdo do FigJam atual. Retorna nós com texto, posição e tipo.',
-  {},
-  async () => {
-    const result = await sendToPlugin('READ_BOARD', {});
+  'Lê o conteúdo do FigJam. Por padrão faz recursão dentro de sections/frames/groups. Retorna id, type, name, x, y, width, height, parentId, depth, text (se STICKY/TEXT/SHAPE_WITH_TEXT/CONNECTOR) e hasImage=true para nós com fill de imagem.',
+  {
+    recursive:   z.boolean().default(true).describe('Descer dentro de containers (section, frame, group)'),
+    maxDepth:    z.number().default(10).describe('Profundidade máxima de recursão'),
+    filterTypes: z.array(z.string()).optional().describe('Filtra os nós retornados por tipo (ex.: ["STICKY","RECTANGLE","FRAME"]). A recursão continua mesmo em nós filtrados.'),
+  },
+  async ({ recursive, maxDepth, filterTypes }) => {
+    const result = await sendToPlugin('READ_BOARD', { recursive, maxDepth, filterTypes });
     return { content: [{ type: 'text', text: JSON.stringify(result) }] };
   }
 );
 
+server.tool(
+  'figjam_export_node',
+  'Exporta um nó (frame, image, section, qualquer SceneNode com exportAsync) como PNG/JPG/SVG/PDF e retorna a imagem renderizada para que Claude consiga visualizar prints/screenshots colados no canvas.',
+  {
+    nodeId: z.string().describe('ID do nó a exportar'),
+    format: z.enum(['PNG', 'JPG', 'SVG', 'PDF']).default('PNG'),
+    scale:  z.number().default(1).describe('Escala da exportação (1=original, 2=2x). Ignorado em SVG/PDF.'),
+  },
+  async ({ nodeId, format, scale }) => {
+    const result = await sendToPlugin('EXPORT_NODE', { nodeId, format, scale }) as {
+      base64: string; format: string; width: number; height: number; byteLength: number;
+    };
+    const mimeMap: Record<string, string> = {
+      PNG: 'image/png',
+      JPG: 'image/jpeg',
+      SVG: 'image/svg+xml',
+      PDF: 'application/pdf',
+    };
+    const mimeType = mimeMap[result.format] ?? 'image/png';
+
+    // Image formats Claude can render get image content; SVG/PDF fall back to text.
+    if (result.format === 'PNG' || result.format === 'JPG') {
+      return {
+        content: [
+          { type: 'image', data: result.base64, mimeType },
+          { type: 'text',  text: JSON.stringify({
+              nodeId, format: result.format,
+              width: result.width, height: result.height,
+              byteLength: result.byteLength,
+            }) },
+        ],
+      };
+    }
+    return {
+      content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+  }
+);
+
 server.tool(
   'figjam_get_selection',
   'Retorna os nós atualmente selecionados no Figma.',
@@ -407,7 +450,7 @@ server.tool(
 // becomes immediately accessible via this tool.
 server.tool(
   'figjam_execute',
-  'Encaminha uma operação arbitrária para o plugin (escape hatch para ops novas que ainda não têm tool dedicada). Tipos válidos atuais: PING, CREATE_STICKY, CREATE_STICKIES, CREATE_SECTION, CREATE_SHAPE, CREATE_SHAPES, CREATE_CONNECTOR, CREATE_CONNECTORS, CREATE_FLOW, SET_CONNECTOR_LABELS, MOVE_NODES, DELETE_NODES, READ_BOARD, GET_SELECTION.',
+  'Encaminha uma operação arbitrária para o plugin (escape hatch para ops novas que ainda não têm tool dedicada). Tipos válidos atuais: PING, CREATE_STICKY, CREATE_STICKIES, CREATE_SECTION, CREATE_SHAPE, CREATE_SHAPES, CREATE_CONNECTOR, CREATE_CONNECTORS, CREATE_FLOW, SET_CONNECTOR_LABELS, MOVE_NODES, DELETE_NODES, READ_BOARD, GET_SELECTION, EXPORT_NODE.',
   {
     type:    z.string().describe('Nome da operação no plugin (ex.: CREATE_SHAPE)'),
     payload: z.record(z.unknown()).optional().describe('Payload da operação'),