figmanage 1.0.1 → 1.2.0

package/dist/operations/webhooks.js

@@ -0,0 +1,38 @@
+import { publicClient } from '../clients/public-api.js';
+export async function listWebhooks(config, params) {
+    const res = await publicClient(config).get(`/v2/teams/${params.team_id}/webhooks`);
+    return res.data?.webhooks || [];
+}
+export async function createWebhook(config, params) {
+    const body = {
+        team_id: params.team_id,
+        event_type: params.event_type,
+        endpoint: params.endpoint,
+        passcode: params.passcode,
+    };
+    if (params.description)
+        body.description = params.description;
+    const res = await publicClient(config).post('/v2/webhooks', body);
+    const { passcode: _, ...safe } = res.data || {};
+    return safe;
+}
+export async function updateWebhook(config, params) {
+    const body = {};
+    if (params.event_type)
+        body.event_type = params.event_type;
+    if (params.endpoint)
+        body.endpoint = params.endpoint;
+    if (params.passcode)
+        body.passcode = params.passcode;
+    if (params.description)
+        body.description = params.description;
+    if (params.status)
+        body.status = params.status;
+    const res = await publicClient(config).put(`/v2/webhooks/${params.webhook_id}`, body);
+    const { passcode: _, ...safe } = res.data || {};
+    return safe;
+}
+export async function deleteWebhook(config, params) {
+    await publicClient(config).delete(`/v2/webhooks/${params.webhook_id}`);
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/analytics.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { internalClient } from '../clients/internal-api.js';
-import { defineTool, toolResult, toolError, figmaId, requireOrgId } from './register.js';
+import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { libraryUsage, componentUsage } from '../operations/analytics.js';
 // -- library_usage --
 defineTool({
     toolset: 'analytics',
@@ -14,11 +14,8 @@ defineTool({
             },
         }, async ({ library_file_key, days }) => {
             try {
-                const lookback = days ?? 30;
-                const end_ts = Math.floor(Date.now() / 1000);
-                const start_ts = end_ts - (lookback * 86400);
-                const res = await internalClient(config).get(`/api/dsa/library/${library_file_key}/team_usage`, { params: { start_ts, end_ts } });
-                return toolResult(JSON.stringify(res.data, null, 2));
+                const result = await libraryUsage(config, { library_file_key, days });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to fetch library usage: ${e.response?.status || e.message}`);
@@ -39,15 +36,8 @@ defineTool({
             },
         }, async ({ component_key, org_id }) => {
             try {
-                let orgId;
-                try {
-                    orgId = requireOrgId(config, org_id);
-                }
-                catch (e) {
-                    return toolError(e.message);
-                }
-                const res = await internalClient(config).get(`/api/design_systems/component/${component_key}/file_usage`, { params: { org_id: orgId, fv: 4 } });
-                return toolResult(JSON.stringify(res.data, null, 2));
+                const result = await componentUsage(config, { component_key, org_id });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to fetch component usage: ${e.response?.status || e.message}`);

package/dist/tools/branching.js

@@ -1,8 +1,6 @@
 import { z } from 'zod';
-import { hasCookie } from '../auth/client.js';
-import { publicClient } from '../clients/public-api.js';
-import { internalClient } from '../clients/internal-api.js';
 import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { listBranches, createBranch, deleteBranch } from '../operations/branching.js';
 // -- list_branches --
 defineTool({
     toolset: 'branching',
@@ -15,28 +13,10 @@ defineTool({
             },
         }, async ({ file_key }) => {
             try {
-                let branches;
-                if (hasCookie(config)) {
-                    const res = await internalClient(config).get(`/api/files/${file_key}`);
-                    const f = res.data?.meta || res.data;
-                    branches = f.branches || [];
-                }
-                else {
-                    const res = await publicClient(config).get(`/v1/files/${file_key}`, {
-                        params: { branch_data: 'true', depth: '0' },
-                    });
-                    branches = res.data?.branches || [];
-                }
-                if (branches.length === 0)
+                const result = await listBranches(config, { file_key });
+                if (result.length === 0)
                     return toolResult('No branches found.');
-                const mapped = branches.map((b) => ({
-                    key: b.key,
-                    name: b.name,
-                    thumbnail_url: b.thumbnail_url || null,
-                    last_modified: b.last_modified || null,
-                    link_access: b.link_access || null,
-                }));
-                return toolResult(JSON.stringify(mapped, null, 2));
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list branches: ${e.response?.status || e.message}`);
@@ -58,15 +38,8 @@ defineTool({
             },
         }, async ({ file_key, name }) => {
             try {
-                const res = await internalClient(config).post(`/api/multiplayer/${file_key}/branch_create?name=${encodeURIComponent(name)}`);
-                const meta = res.data?.meta || res.data || {};
-                const file = meta.file || meta;
-                const branchKey = file.key || file.file_key || null;
-                return toolResult(JSON.stringify({
-                    key: branchKey,
-                    name,
-                    main_file_key: file_key,
-                }, null, 2));
+                const result = await createBranch(config, { file_key, name });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to create branch: ${e.response?.status || e.message}`);
@@ -89,9 +62,7 @@ defineTool({
             },
         }, async ({ branch_key }) => {
             try {
-                await internalClient(config).delete('/api/files_batch', {
-                    data: { files: [{ key: branch_key }], trashed: true },
-                });
+                await deleteBranch(config, { branch_key });
                 return toolResult(`Archived branch ${branch_key}`);
             }
             catch (e) {

package/dist/tools/comments.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { publicClient } from '../clients/public-api.js';
 import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { listComments, formatCommentsAsMarkdown, postComment, deleteComment, listCommentReactions, } from '../operations/comments.js';
 // -- list_comments --
 defineTool({
     toolset: 'comments',
@@ -14,40 +14,11 @@ defineTool({
             },
         }, async ({ file_key, as_md }) => {
             try {
-                const res = await publicClient(config).get(`/v1/files/${file_key}/comments`);
-                const comments = res.data?.comments || [];
+                const comments = await listComments(config, { file_key });
                 if (as_md) {
-                    const threads = new Map();
-                    for (const c of comments) {
-                        const parentId = c.parent_id || c.id;
-                        if (!threads.has(parentId))
-                            threads.set(parentId, []);
-                        threads.get(parentId).push(c);
-                    }
-                    const lines = [];
-                    for (const [, thread] of threads) {
-                        thread.sort((a, b) => new Date(a.created_at).getTime() - new Date(b.created_at).getTime());
-                        for (const c of thread) {
-                            const indent = c.parent_id ? '  ' : '';
-                            const resolved = c.resolved_at ? ' [resolved]' : '';
-                            lines.push(`${indent}- **${c.user.handle}** (${c.created_at})${resolved}: ${c.message}`);
-                        }
-                        lines.push('');
-                    }
-                    return toolResult(lines.join('\n'));
+                    return toolResult(formatCommentsAsMarkdown(comments));
                 }
-                const mapped = comments.map((c) => ({
-                    id: c.id,
-                    parent_id: c.parent_id || null,
-                    message: c.message,
-                    author: c.user?.handle,
-                    author_id: c.user?.id,
-                    created_at: c.created_at,
-                    resolved_at: c.resolved_at || null,
-                    node_id: c.client_meta?.node_id || c.client_meta?.node_offset?.node_id || null,
-                    order_id: c.order_id,
-                }));
-                return toolResult(JSON.stringify(mapped, null, 2));
+                return toolResult(JSON.stringify(comments, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list comments: ${e.response?.status || e.message}`);
@@ -71,20 +42,8 @@ defineTool({
             },
         }, async ({ file_key, message, comment_id, node_id }) => {
             try {
-                const body = { message };
-                if (comment_id)
-                    body.comment_id = comment_id;
-                if (node_id)
-                    body.client_meta = { node_id, node_offset: { x: 0, y: 0 } };
-                const res = await publicClient(config).post(`/v1/files/${file_key}/comments`, body);
-                const c = res.data;
-                return toolResult(JSON.stringify({
-                    id: c.id,
-                    message: c.message,
-                    author: c.user?.handle,
-                    created_at: c.created_at,
-                    parent_id: c.parent_id || null,
-                }, null, 2));
+                const result = await postComment(config, { file_key, message, comment_id, node_id });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to post comment: ${e.response?.status || e.message}`);
@@ -107,7 +66,7 @@ defineTool({
             },
         }, async ({ file_key, comment_id }) => {
             try {
-                await publicClient(config).delete(`/v1/files/${file_key}/comments/${comment_id}`);
+                await deleteComment(config, { file_key, comment_id });
                 return toolResult(`Deleted comment ${comment_id}`);
             }
             catch (e) {
@@ -129,14 +88,8 @@ defineTool({
             },
         }, async ({ file_key, comment_id }) => {
             try {
-                const res = await publicClient(config).get(`/v1/files/${file_key}/comments/${comment_id}/reactions`);
-                const reactions = res.data?.reactions || [];
-                const mapped = reactions.map((r) => ({
-                    emoji: r.emoji,
-                    user: r.user?.handle,
-                    created_at: r.created_at,
-                }));
-                return toolResult(JSON.stringify(mapped, null, 2));
+                const reactions = await listCommentReactions(config, { file_key, comment_id });
+                return toolResult(JSON.stringify(reactions, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list reactions: ${e.response?.status || e.message}`);

package/dist/tools/components.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { publicClient } from '../clients/public-api.js';
 import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { listFileComponents, listFileStyles, listTeamComponents, listTeamStyles, } from '../operations/components.js';
 // -- list_file_components --
 defineTool({
     toolset: 'components',
@@ -13,8 +13,7 @@ defineTool({
             },
         }, async ({ file_key }) => {
             try {
-                const res = await publicClient(config).get(`/v1/files/${file_key}/components`);
-                const components = res.data?.meta?.components || [];
+                const components = await listFileComponents(config, { file_key });
                 return toolResult(JSON.stringify(components, null, 2));
             }
             catch (e) {
@@ -35,8 +34,7 @@ defineTool({
             },
         }, async ({ file_key }) => {
             try {
-                const res = await publicClient(config).get(`/v1/files/${file_key}/styles`);
-                const styles = res.data?.meta?.styles || [];
+                const styles = await listFileStyles(config, { file_key });
                 return toolResult(JSON.stringify(styles, null, 2));
             }
             catch (e) {
@@ -59,13 +57,8 @@ defineTool({
             },
         }, async ({ team_id, page_size, cursor }) => {
             try {
-                const params = { page_size };
-                if (cursor)
-                    params.after = cursor;
-                const res = await publicClient(config).get(`/v1/teams/${team_id}/components`, { params });
-                const components = res.data?.meta?.components || [];
-                const pagination = res.data?.pagination || null;
-                return toolResult(JSON.stringify({ components, pagination }, null, 2));
+                const result = await listTeamComponents(config, { team_id, page_size, cursor });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list team components: ${e.response?.status || e.message}`);
@@ -87,13 +80,8 @@ defineTool({
             },
         }, async ({ team_id, page_size, cursor }) => {
             try {
-                const params = { page_size };
-                if (cursor)
-                    params.after = cursor;
-                const res = await publicClient(config).get(`/v1/teams/${team_id}/styles`, { params });
-                const styles = res.data?.meta?.styles || [];
-                const pagination = res.data?.pagination || null;
-                return toolResult(JSON.stringify({ styles, pagination }, null, 2));
+                const result = await listTeamStyles(config, { team_id, page_size, cursor });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list team styles: ${e.response?.status || e.message}`);