figmanage 1.0.1 → 1.2.0

package/dist/tools/export.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 { exportNodes, getImageFills } from '../operations/export.js';
 // -- export_nodes --
 defineTool({
     toolset: 'export',
@@ -16,22 +16,8 @@ defineTool({
             },
         }, async ({ file_key, node_ids, format, scale }) => {
             try {
-                const params = {
-                    ids: node_ids.join(','),
-                    format: format || 'png',
-                };
-                if (scale)
-                    params.scale = String(Math.min(Math.max(scale, 0.01), 4));
-                const res = await publicClient(config).get(`/v1/images/${file_key}`, { params });
-                const images = res.data?.images || {};
-                const err = res.data?.err;
-                if (err)
-                    return toolError(`Export error: ${err}`);
-                const results = Object.entries(images).map(([nodeId, url]) => ({
-                    node_id: nodeId,
-                    url,
-                }));
-                return toolResult(JSON.stringify(results, null, 2));
+                const result = await exportNodes(config, { file_key, node_ids, format, scale });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to export nodes: ${e.response?.status || e.message}`);
@@ -51,12 +37,7 @@ defineTool({
             },
         }, async ({ file_key }) => {
             try {
-                const res = await publicClient(config).get(`/v1/files/${file_key}/images`);
-                const images = res.data?.meta?.images || res.data?.images || {};
-                const results = Object.entries(images).map(([ref, url]) => ({
-                    image_ref: ref,
-                    url,
-                }));
+                const results = await getImageFills(config, { file_key });
                 if (results.length === 0)
                     return toolResult('No image fills in this file.');
                 return toolResult(JSON.stringify(results, null, 2));

package/dist/tools/files.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { internalClient } from '../clients/internal-api.js';
-import { defineTool, toolResult, toolError, figmaId, resolveOrgId } from './register.js';
+import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { createFile, renameFile, moveFiles, duplicateFile, trashFiles, restoreFiles, favoriteFile, setLinkAccess, } from '../operations/files.js';
 // -- create_file --
 defineTool({
     toolset: 'files',
@@ -16,18 +16,8 @@ defineTool({
             },
         }, async ({ project_id, editor_type, org_id }) => {
             try {
-                const res = await internalClient(config).post('/api/files/create', {
-                    folder_id: project_id,
-                    org_id: resolveOrgId(config, org_id),
-                    editor_type: editor_type || 'design',
-                });
-                const f = res.data?.meta?.fig_file || res.data?.meta || res.data;
-                return toolResult(JSON.stringify({
-                    key: f.key,
-                    name: f.name,
-                    editor_type: f.editor_type,
-                    url: `https://www.figma.com/design/${f.key}`,
-                }, null, 2));
+                const result = await createFile(config, { project_id, editor_type, org_id });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to create file: ${e.response?.status || e.message}`);
@@ -49,10 +39,7 @@ defineTool({
             },
         }, async ({ file_key, name }) => {
             try {
-                await internalClient(config).put(`/api/files/${file_key}`, {
-                    key: file_key,
-                    name,
-                });
+                await renameFile(config, { file_key, name });
                 return toolResult(`Renamed to "${name}"`);
             }
             catch (e) {
@@ -75,19 +62,10 @@ defineTool({
             },
         }, async ({ file_keys, destination_project_id }) => {
             try {
-                const files = file_keys.map(key => ({
-                    key,
-                    folder_id: destination_project_id,
-                    is_multi_move: file_keys.length > 1,
-                    restore_files: false,
-                }));
-                const res = await internalClient(config).put('/api/files_batch', { files });
-                const data = res.data?.meta || res.data;
-                const succeeded = Object.keys(data.success || {}).length;
-                const failed = Object.keys(data.errors || {}).length;
-                let msg = `Moved ${succeeded} file(s) to project ${destination_project_id}`;
-                if (failed > 0)
-                    msg += `. ${failed} failed: ${JSON.stringify(data.errors)}`;
+                const result = await moveFiles(config, { file_keys, destination_project_id });
+                let msg = `Moved ${result.succeeded} file(s) to project ${destination_project_id}`;
+                if (result.failed > 0)
+                    msg += `. ${result.failed} failed: ${JSON.stringify(result.errors)}`;
                 return toolResult(msg);
             }
             catch (e) {
@@ -110,16 +88,8 @@ defineTool({
             },
         }, async ({ file_key, project_id }) => {
             try {
-                const res = await internalClient(config).post(`/api/multiplayer/${file_key}/copy`, null, {
-                    headers: { 'Content-Length': '0' },
-                    params: project_id ? { folder_id: project_id } : undefined,
-                });
-                const f = res.data?.meta?.fig_file || res.data?.meta || res.data;
-                return toolResult(JSON.stringify({
-                    key: f.key,
-                    name: f.name,
-                    url: `https://www.figma.com/design/${f.key}`,
-                }, null, 2));
+                const result = await duplicateFile(config, { file_key, project_id });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to duplicate file: ${e.response?.status || e.message}`);
@@ -141,13 +111,8 @@ defineTool({
             },
         }, async ({ file_keys }) => {
             try {
-                const files = file_keys.map(key => ({ key }));
-                const res = await internalClient(config).delete('/api/files_batch', {
-                    data: { files, trashed: true },
-                });
-                const data = res.data?.meta || res.data;
-                const succeeded = Object.keys(data.success || {}).length;
-                return toolResult(`Trashed ${succeeded} file(s)`);
+                const result = await trashFiles(config, { file_keys });
+                return toolResult(`Trashed ${result.succeeded} file(s)`);
             }
             catch (e) {
                 return toolError(`Failed to trash files: ${e.response?.status || e.message}`);
@@ -168,14 +133,10 @@ defineTool({
             },
         }, async ({ file_keys }) => {
             try {
-                const files = file_keys.map(key => ({ key }));
-                const res = await internalClient(config).post('/api/files_batch/restore', { files });
-                const data = res.data?.meta || res.data;
-                const succeeded = Object.keys(data?.success || {}).length || file_keys.length;
-                const failed = Object.keys(data?.errors || {}).length;
-                let msg = `Restored ${succeeded} file(s)`;
-                if (failed > 0)
-                    msg += `. ${failed} failed: ${JSON.stringify(data.errors)}`;
+                const result = await restoreFiles(config, { file_keys });
+                let msg = `Restored ${result.succeeded} file(s)`;
+                if (result.failed > 0)
+                    msg += `. ${result.failed} failed: ${JSON.stringify(result.errors)}`;
                 return toolResult(msg);
             }
             catch (e) {
@@ -198,13 +159,8 @@ defineTool({
             },
         }, async ({ file_key, favorited }) => {
             try {
-                const isFavorited = favorited !== false;
-                await internalClient(config).put('/api/favorited_resources', {
-                    resource_type: 'file',
-                    resource_id_or_key: file_key,
-                    is_favorited: isFavorited,
-                });
-                return toolResult(`${isFavorited ? 'Favorited' : 'Unfavorited'} file ${file_key}`);
+                const result = await favoriteFile(config, { file_key, favorited });
+                return toolResult(`${result.favorited ? 'Favorited' : 'Unfavorited'} file ${file_key}`);
             }
             catch (e) {
                 return toolError(`Failed to toggle favorite: ${e.response?.status || e.message}`);
@@ -226,11 +182,8 @@ defineTool({
             },
         }, async ({ file_key, link_access }) => {
             try {
-                const res = await internalClient(config).put(`/api/files/${file_key}`, {
-                    link_access: link_access || 'inherit',
-                });
-                const newAccess = res.data?.meta?.link_access || link_access || 'inherit';
-                return toolResult(`Set link access to "${newAccess}" on file ${file_key}`);
+                const result = await setLinkAccess(config, { file_key, link_access });
+                return toolResult(`Set link access to "${result.link_access}" on file ${file_key}`);
             }
             catch (e) {
                 return toolError(`Failed to set link access: ${e.response?.status || e.message}`);

package/dist/tools/libraries.js

@@ -1,5 +1,5 @@
-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 { listOrgLibraries } from '../operations/libraries.js';
 // -- list_org_libraries --
 defineTool({
     toolset: 'libraries',
@@ -12,15 +12,8 @@ defineTool({
             },
         }, async ({ 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/libraries', { params: { org_id: orgId, include_sharing_group_info: true } });
-                return toolResult(JSON.stringify(res.data, null, 2));
+                const result = await listOrgLibraries(config, { org_id });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list org libraries: ${e.response?.status || e.message}`);

package/dist/tools/navigate.js

@@ -1,9 +1,6 @@
 import { z } from 'zod';
-import { publicClient } from '../clients/public-api.js';
-import { internalClient } from '../clients/internal-api.js';
-import { hasCookie, hasPat } from '../auth/client.js';
-import { defineTool, toolResult, toolError, figmaId, requireOrgId } from './register.js';
-import { checkAuth, formatAuthStatus } from '../auth/health.js';
+import { defineTool, toolResult, toolError, figmaId } from './register.js';
+import { checkAuthStatus, listOrgs, switchOrg, listTeams, listProjects, listFiles, listRecentFiles, search, getFileInfo, listFavorites, } from '../operations/navigate.js';
 // -- check_auth --
 defineTool({
     toolset: 'navigate',
@@ -11,8 +8,8 @@ defineTool({
     register(server, config) {
         server.registerTool('check_auth', { description: 'Check authentication status for both PAT and session cookie' }, async () => {
             try {
-                const status = await checkAuth(config);
-                return toolResult(formatAuthStatus(status, config));
+                const result = await checkAuthStatus(config);
+                return toolResult(result.formatted);
             }
             catch (e) {
                 return toolError(`Auth check failed: ${e.message}`);
@@ -29,63 +26,15 @@ defineTool({
             description: 'List all Figma workspaces (orgs) you belong to. Shows which is currently active.',
         }, async () => {
             try {
-                const api = internalClient(config);
-                const res = await api.get('/api/user/state');
-                let orgs = (res.data?.meta?.orgs || [])
-                    .filter((o) => o && o.id)
-                    .map((o) => ({ id: String(o.id), name: o.name || String(o.id) }));
-                // Fallback: meta.orgs is empty for non-admin users.
-                // Extract unique org_ids from meta.roles instead.
-                if (orgs.length === 0) {
-                    const roles = res.data?.meta?.roles || [];
-                    const orgIds = [...new Set(roles
-                            .map((r) => r.org_id)
-                            .filter((id) => id != null)
-                            .map(String))];
-                    // Also include config.orgId if not already covered
-                    if (config.orgId && !orgIds.includes(config.orgId)) {
-                        orgIds.push(config.orgId);
-                    }
-                    // Resolve names via domain lookup
-                    orgs = await Promise.all(orgIds.map(async (id) => {
-                        let name = id;
-                        try {
-                            const domRes = await api.get(`/api/orgs/${id}/domains`);
-                            const domains = domRes.data?.meta || [];
-                            if (Array.isArray(domains) && domains.length > 0) {
-                                name = domains[0].domain || id;
-                            }
-                        }
-                        catch { /* domain lookup optional */ }
-                        return { id, name };
-                    }));
-                }
-                // Merge with any existing registry entries (preserves names from setup)
-                if (config.orgs && config.orgs.length > 0) {
-                    for (const existing of config.orgs) {
-                        if (!orgs.find(o => o.id === existing.id)) {
-                            orgs.push(existing);
-                        }
-                        else {
-                            // Prefer stored name over ID-only fallback
-                            const entry = orgs.find(o => o.id === existing.id);
-                            if (entry.name === entry.id && existing.name !== existing.id) {
-                                entry.name = existing.name;
-                            }
-                        }
-                    }
+                const orgs = await listOrgs(config);
+                // Side effect: update config org registry
+                if (orgs.length > 0) {
+                    config.orgs = orgs.map(o => ({ id: o.id, name: o.name }));
                 }
-                if (orgs.length > 0)
-                    config.orgs = orgs;
                 if (orgs.length === 0) {
                     return toolResult('No workspaces found. You may be on a free/starter plan.');
                 }
-                const result = orgs.map(o => ({
-                    id: o.id,
-                    name: o.name,
-                    active: o.id === config.orgId,
-                }));
-                return toolResult(JSON.stringify(result, null, 2));
+                return toolResult(JSON.stringify(orgs, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list orgs: ${e.response?.status || e.message}`);
@@ -105,42 +54,10 @@ defineTool({
             },
         }, async ({ org }) => {
             try {
-                // Ensure we have an org list
-                if (!config.orgs || config.orgs.length === 0) {
-                    const res = await internalClient(config).get('/api/user/state');
-                    const orgs = (res.data?.meta?.orgs || []).map((o) => ({
-                        id: String(o.id),
-                        name: o.name,
-                    }));
-                    if (orgs.length > 0)
-                        config.orgs = orgs;
-                }
-                if (!config.orgs || config.orgs.length === 0) {
-                    return toolError('No workspaces found. You may be on a free/starter plan.');
-                }
-                // Try exact ID match first
-                let match = config.orgs.find(o => o.id === org);
-                // Then case-insensitive substring match on name
-                if (!match) {
-                    const lower = org.toLowerCase();
-                    const matches = config.orgs.filter(o => o.name.toLowerCase().includes(lower));
-                    if (matches.length === 1) {
-                        match = matches[0];
-                    }
-                    else if (matches.length > 1) {
-                        const names = matches.map(o => `${o.name} (${o.id})`).join(', ');
-                        return toolError(`Ambiguous: "${org}" matches multiple workspaces: ${names}. Be more specific or use the org ID.`);
-                    }
-                }
-                if (!match) {
-                    const available = config.orgs.map(o => `${o.name} (${o.id})`).join(', ');
-                    return toolError(`No workspace matching "${org}". Available: ${available}`);
-                }
-                const previousId = config.orgId;
-                const previousOrg = config.orgs.find(o => o.id === previousId);
-                const previousLabel = previousOrg ? `${previousOrg.name} (${previousId})` : (previousId || 'none');
-                config.orgId = match.id;
-                return toolResult(`Switched workspace: ${previousLabel} -> ${match.name} (${match.id})`);
+                const result = await switchOrg(config, { org });
+                // Side effect: update config org ID
+                config.orgId = result.current.id;
+                return toolResult(`Switched workspace: ${result.previous} -> ${result.current.name} (${result.current.id})`);
             }
             catch (e) {
                 return toolError(`Failed to switch org: ${e.response?.status || e.message}`);
@@ -157,21 +74,7 @@ defineTool({
             description: 'List all teams you belong to. Returns team IDs and names.',
         }, async () => {
             try {
-                if (config.orgId) {
-                    const res = await internalClient(config).get(`/api/orgs/${config.orgId}/teams`);
-                    const data = res.data?.meta || res.data;
-                    const teams = (data.teams || (Array.isArray(data) ? data : [])).map((t) => ({
-                        id: String(t.id),
-                        name: t.name,
-                    }));
-                    return toolResult(JSON.stringify(teams, null, 2));
-                }
-                // Fallback: get teams from user/state
-                const res = await internalClient(config).get('/api/user/state');
-                const teams = (res.data?.meta?.teams || []).map((t) => ({
-                    id: String(t.id),
-                    name: t.name,
-                }));
+                const teams = await listTeams(config);
                 return toolResult(JSON.stringify(teams, null, 2));
             }
             catch (e) {
@@ -192,23 +95,8 @@ defineTool({
             },
         }, async ({ team_id }) => {
             try {
-                if (hasCookie(config)) {
-                    const res = await internalClient(config).get(`/api/teams/${team_id}/folders`);
-                    const rows = res.data?.meta?.folder_rows || res.data || [];
-                    const projects = (Array.isArray(rows) ? rows : []).map((p) => ({
-                        id: String(p.id),
-                        name: p.name || p.path,
-                    }));
-                    return toolResult(JSON.stringify(projects, null, 2));
-                }
-                else {
-                    const res = await publicClient(config).get(`/v1/teams/${team_id}/projects`);
-                    const projects = (res.data.projects || []).map((p) => ({
-                        id: String(p.id),
-                        name: p.name,
-                    }));
-                    return toolResult(JSON.stringify(projects, null, 2));
-                }
+                const projects = await listProjects(config, { team_id });
+                return toolResult(JSON.stringify(projects, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list projects: ${e.response?.status || e.message}`);
@@ -230,47 +118,8 @@ defineTool({
             },
         }, async ({ project_id, page_size, page_token }) => {
             try {
-                // Prefer public API when PAT available -- returns keys compatible
-                // with all public endpoints (versions, comments, export).
-                if (hasPat(config)) {
-                    const res = await publicClient(config).get(`/v1/projects/${project_id}/files`);
-                    const files = (res.data.files || []).map((f) => ({
-                        key: f.key,
-                        name: f.name,
-                        last_modified: f.last_modified,
-                        thumbnail_url: f.thumbnail_url,
-                    }));
-                    return toolResult(JSON.stringify({ files }, null, 2));
-                }
-                else {
-                    const pageSize = Math.min(page_size || 25, 100);
-                    const params = new URLSearchParams({
-                        folderId: project_id,
-                        sort_column: 'touched_at',
-                        sort_order: 'desc',
-                        page_size: String(pageSize),
-                        file_type: '',
-                    });
-                    if (page_token)
-                        params.set('before', page_token);
-                    const res = await internalClient(config).get(`/api/folders/${project_id}/paginated_files?${params}`);
-                    const meta = res.data?.meta || res.data;
-                    const files = (meta.files || meta.results || []).map((f) => ({
-                        key: f.key,
-                        name: f.name,
-                        last_modified: f.touched_at || f.updated_at || f.last_modified,
-                        editor_type: f.editor_type,
-                    }));
-                    const pagination = res.data?.pagination;
-                    const result = { files };
-                    if (pagination?.next_page || files.length === pageSize) {
-                        result.pagination = {
-                            has_more: true,
-                            hint: `To get the next page, call list_files again with page_token="${pagination?.next_page || files[files.length - 1]?.last_modified || ''}"`,
-                        };
-                    }
-                    return toolResult(JSON.stringify(result, null, 2));
-                }
+                const result = await listFiles(config, { project_id, page_size, page_token });
+                return toolResult(JSON.stringify(result, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to list files: ${e.response?.status || e.message}`);
@@ -287,16 +136,7 @@ defineTool({
             description: 'List your recently viewed/edited files across all teams.',
         }, async () => {
             try {
-                const res = await internalClient(config).get('/api/recent_files');
-                const files = (res.data?.meta?.recent_files || []).map((f) => ({
-                    key: f.key,
-                    name: f.name,
-                    team_id: f.team_id,
-                    folder_id: f.folder_id,
-                    editor_type: f.editor_type,
-                    last_touched: f.touched_at,
-                    url: f.url || `https://www.figma.com/design/${f.key}`,
-                }));
+                const files = await listRecentFiles(config);
                 return toolResult(JSON.stringify(files, null, 2));
             }
             catch (e) {
@@ -319,40 +159,7 @@ defineTool({
             },
         }, async ({ query, sort, org_id }) => {
             try {
-                let orgId;
-                try {
-                    orgId = requireOrgId(config, org_id);
-                }
-                catch (e) {
-                    return toolError(e.message);
-                }
-                const params = {
-                    query,
-                    sort: sort || 'relevancy',
-                    desc: 'true',
-                    is_global: 'true',
-                    org_id: orgId,
-                    current_org_id: orgId,
-                    plan_type: 'org',
-                };
-                const res = await internalClient(config).get('/api/search/file_browser_preview', { params });
-                const meta = res.data?.meta;
-                // Response is an array of category objects; files are in the first entry
-                const categories = Array.isArray(meta) ? meta : [];
-                const fileCategory = categories.find((c) => c.search_model_type === 'files') || categories[0];
-                const rawResults = fileCategory?.results || [];
-                const results = rawResults.map((r) => {
-                    const m = r.model || r;
-                    return {
-                        key: m.key,
-                        name: m.name,
-                        editor_type: m.editor_type,
-                        team_id: m.team_id ? String(m.team_id) : undefined,
-                        folder_id: m.folder_id ? String(m.folder_id) : undefined,
-                        last_modified: m.touched_at,
-                        url: m.url || `https://www.figma.com/design/${m.key}`,
-                    };
-                });
+                const results = await search(config, { query, sort, org_id });
                 if (results.length === 0) {
                     return toolResult('No results. Try list_recent_files or browse via list_projects + list_files.');
                 }
@@ -376,32 +183,8 @@ defineTool({
             },
         }, async ({ file_key }) => {
             try {
-                // Prefer public API for consistent key format.
-                if (hasPat(config)) {
-                    const res = await publicClient(config).get(`/v1/files/${file_key}/meta`);
-                    const f = res.data.file || res.data;
-                    return toolResult(JSON.stringify({
-                        key: f.key || file_key,
-                        name: f.name,
-                        last_modified: f.lastModified || f.last_modified,
-                        editor_type: f.editorType || f.editor_type,
-                        url: `https://www.figma.com/design/${file_key}`,
-                    }, null, 2));
-                }
-                else {
-                    const res = await internalClient(config).get(`/api/files/${file_key}`);
-                    const f = res.data?.meta || res.data;
-                    return toolResult(JSON.stringify({
-                        key: f.key || file_key,
-                        name: f.name,
-                        updated_at: f.updated_at,
-                        editor_type: f.editor_type,
-                        folder_id: f.folder_id ? String(f.folder_id) : undefined,
-                        team_id: f.team_id ? String(f.team_id) : undefined,
-                        link_access: f.link_access,
-                        url: f.url || `https://www.figma.com/design/${file_key}`,
-                    }, null, 2));
-                }
+                const info = await getFileInfo(config, { file_key });
+                return toolResult(JSON.stringify(info, null, 2));
             }
             catch (e) {
                 return toolError(`Failed to get file info: ${e.response?.status || e.message}`);
@@ -418,13 +201,7 @@ defineTool({
             description: 'List your starred/favorited files. Note: may not work on all account types.',
         }, async () => {
             try {
-                const res = await internalClient(config).get('/api/user/favorited_resources');
-                const data = res.data?.meta || res.data;
-                const favorites = (Array.isArray(data) ? data : data.favorites || data.resources || []).map((f) => ({
-                    key: f.key || f.file_key || f.id,
-                    name: f.name,
-                    type: f.resource_type || f.type,
-                }));
+                const favorites = await listFavorites(config);
                 return toolResult(JSON.stringify(favorites, null, 2));
             }
             catch (e) {