figma-to-code-agent 0.3.0

package/dist/extraction/FigmaAPIClient.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * Figma API Client
+ * Handles communication with Figma REST API
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaAPIClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const FigmaCache_1 = require("./FigmaCache");
+class FigmaAPIClient {
+    constructor(accessToken, enableCache = true) {
+        this.accessToken = accessToken;
+        this.baseURL = 'https://api.figma.com/v1';
+        this.maxRetries = 3;
+        this.baseRetryDelay = 1000; // milliseconds
+        this.cacheMaxAge = 24 * 60 * 60 * 1000; // 24 hours (increased from 5 minutes)
+        if (!accessToken) {
+            throw new Error('Figma access token is required');
+        }
+        this.cache = enableCache ? new FigmaCache_1.FigmaCache() : null;
+        this.axiosInstance = axios_1.default.create({
+            baseURL: this.baseURL,
+            headers: {
+                'X-Figma-Token': this.accessToken,
+            },
+            timeout: 60000, // Increased to 60 seconds
+        });
+    }
+    /**
+     * Get file's complete design data
+     * @param fileKey - Figma file ID
+     * @param options - Optional query parameters
+     * @returns Design file data
+     */
+    async getFile(fileKey, options) {
+        if (!fileKey) {
+            throw new Error('File key is required');
+        }
+        // Check cache first
+        const cacheKey = `file:${fileKey}:${JSON.stringify(options || {})}`;
+        if (this.cache) {
+            const cached = this.cache.get(cacheKey, this.cacheMaxAge);
+            if (cached) {
+                console.log('✓ Using cached Figma file data (cache hit)');
+                return cached;
+            }
+        }
+        console.log('Fetching from Figma API (this may take a moment)...');
+        try {
+            const response = await this.retryRequest(async () => {
+                return await this.axiosInstance.get(`/files/${fileKey}`, {
+                    params: options,
+                });
+            });
+            console.log('✓ Successfully fetched from Figma API');
+            // Cache the result
+            if (this.cache) {
+                this.cache.set(cacheKey, response.data);
+                console.log('✓ Cached for future use');
+            }
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, 'Failed to fetch Figma file');
+        }
+    }
+    /**
+     * Get image resource URLs from file
+     * @param fileKey - Figma file ID
+     * @param nodeIds - List of node IDs to export
+     * @param format - Image format (png, jpg, svg, pdf)
+     * @returns Image URL mapping
+     */
+    async getImages(fileKey, nodeIds, format = 'png') {
+        if (!fileKey) {
+            throw new Error('File key is required');
+        }
+        if (!nodeIds || nodeIds.length === 0) {
+            throw new Error('At least one node ID is required');
+        }
+        // Check cache first
+        const cacheKey = `images:${fileKey}:${nodeIds.join(',')}:${format}`;
+        if (this.cache) {
+            const cached = this.cache.get(cacheKey, this.cacheMaxAge);
+            if (cached) {
+                console.log('✓ Using cached image URLs');
+                return cached;
+            }
+        }
+        try {
+            const response = await this.retryRequest(async () => {
+                return await this.axiosInstance.get(`/images/${fileKey}`, {
+                    params: {
+                        ids: nodeIds.join(','),
+                        format,
+                        scale: 2,
+                    },
+                });
+            });
+            if (response.data.err) {
+                throw new Error(`Figma API error: ${response.data.err}`);
+            }
+            // Cache the result
+            if (this.cache) {
+                this.cache.set(cacheKey, response.data);
+                console.log('✓ Cached image URLs');
+            }
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleError(error, 'Failed to fetch images');
+        }
+    }
+    /**
+     * Download image resource to local file
+     * @param imageUrl - Image URL
+     * @param outputPath - Save path
+     */
+    async downloadImage(imageUrl, outputPath) {
+        if (!imageUrl) {
+            throw new Error('Image URL is required');
+        }
+        if (!outputPath) {
+            throw new Error('Output path is required');
+        }
+        // Check if file already exists (cached locally)
+        if (fs.existsSync(outputPath)) {
+            console.log(`✓ Using cached image: ${path.basename(outputPath)}`);
+            return;
+        }
+        try {
+            // Ensure directory exists
+            const dir = path.dirname(outputPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            console.log(`Downloading image: ${path.basename(outputPath)}...`);
+            const response = await this.retryRequest(async () => {
+                return await axios_1.default.get(imageUrl, {
+                    responseType: 'arraybuffer',
+                    timeout: 60000, // 60 seconds for image download
+                });
+            });
+            fs.writeFileSync(outputPath, response.data);
+            console.log(`✓ Downloaded: ${path.basename(outputPath)}`);
+        }
+        catch (error) {
+            throw this.handleError(error, 'Failed to download image');
+        }
+    }
+    /**
+     * Retry request with exponential backoff and Retry-After header support
+     */
+    async retryRequest(requestFn, retries = this.maxRetries) {
+        try {
+            return await requestFn();
+        }
+        catch (error) {
+            if (retries > 0 && this.isRetryableError(error)) {
+                // Check for Retry-After header (429 rate limit)
+                let delay = this.baseRetryDelay * (this.maxRetries - retries + 1);
+                if (axios_1.default.isAxiosError(error) && error.response?.status === 429) {
+                    const retryAfter = error.response.headers['retry-after'];
+                    if (retryAfter) {
+                        const retryAfterSeconds = parseInt(retryAfter);
+                        const retryAfterMs = retryAfterSeconds * 1000;
+                        // If rate limit is more than 1 minute, don't retry
+                        if (retryAfterSeconds > 60) {
+                            const hours = Math.floor(retryAfterSeconds / 3600);
+                            const minutes = Math.floor((retryAfterSeconds % 3600) / 60);
+                            throw new Error(`Figma API rate limit exceeded. Please try again in ${hours}h ${minutes}m. ` +
+                                `Tip: Use a different Figma token or wait for the rate limit to reset.`);
+                        }
+                        delay = retryAfterMs;
+                        console.log(`Rate limited. Waiting ${retryAfterSeconds}s before retry...`);
+                    }
+                }
+                await this.sleep(delay);
+                return this.retryRequest(requestFn, retries - 1);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if error is retryable (network errors, rate limits, server errors)
+     */
+    isRetryableError(error) {
+        if (axios_1.default.isAxiosError(error)) {
+            const axiosError = error;
+            // Retry on network errors or 5xx server errors or 429 rate limit
+            return (!axiosError.response ||
+                axiosError.response.status >= 500 ||
+                axiosError.response.status === 429);
+        }
+        return false;
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Handle and format errors
+     */
+    handleError(error, message) {
+        if (axios_1.default.isAxiosError(error)) {
+            const axiosError = error;
+            // Authentication error
+            if (axiosError.response?.status === 403) {
+                return new Error('Authentication failed. Please check your Figma access token.');
+            }
+            // Not found error
+            if (axiosError.response?.status === 404) {
+                return new Error('File not found. Please check the file key and ensure you have access to the file.');
+            }
+            // Rate limit error
+            if (axiosError.response?.status === 429) {
+                return new Error('Rate limit exceeded. Please try again later.');
+            }
+            // Other API errors
+            if (axiosError.response) {
+                const errorData = axiosError.response.data;
+                const errorMessage = errorData?.err || errorData?.message || 'Unknown API error';
+                return new Error(`${message}: ${errorMessage}`);
+            }
+            // Network errors
+            if (axiosError.request) {
+                return new Error(`${message}: Network error. Please check your internet connection.`);
+            }
+        }
+        // Generic error
+        return new Error(`${message}: ${error.message || 'Unknown error'}`);
+    }
+}
+exports.FigmaAPIClient = FigmaAPIClient;
+//# sourceMappingURL=FigmaAPIClient.js.map

package/dist/extraction/FigmaAPIClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FigmaAPIClient.js","sourceRoot":"","sources":["../../src/extraction/FigmaAPIClient.ts"],"names":[],"mappings":"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"}

package/dist/extraction/FigmaCache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Simple file-based cache for Figma API responses
+ * Reduces API calls and avoids rate limiting
+ */
+export declare class FigmaCache {
+    private cacheDir;
+    constructor(cacheDir?: string);
+    private ensureCacheDir;
+    private getCacheKey;
+    private getCachePath;
+    /**
+     * Get cached data if exists and not expired
+     */
+    get<T>(key: string, maxAge?: number): T | null;
+    /**
+     * Set cache data
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * Delete cache entry
+     */
+    delete(key: string): void;
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+}
+//# sourceMappingURL=FigmaCache.d.ts.map

package/dist/extraction/FigmaCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FigmaCache.d.ts","sourceRoot":"","sources":["../../src/extraction/FigmaCache.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAiB;IAKrC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IA2B9C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAUnC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/extraction/FigmaCache.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaCache = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+/**
+ * Simple file-based cache for Figma API responses
+ * Reduces API calls and avoids rate limiting
+ */
+class FigmaCache {
+    constructor(cacheDir = '.figma-cache') {
+        this.cacheDir = path.resolve(process.cwd(), cacheDir);
+        this.ensureCacheDir();
+    }
+    ensureCacheDir() {
+        if (!fs.existsSync(this.cacheDir)) {
+            fs.mkdirSync(this.cacheDir, { recursive: true });
+        }
+    }
+    getCacheKey(key) {
+        return crypto.createHash('md5').update(key).digest('hex');
+    }
+    getCachePath(key) {
+        const hash = this.getCacheKey(key);
+        return path.join(this.cacheDir, `${hash}.json`);
+    }
+    /**
+     * Get cached data if exists and not expired
+     */
+    get(key, maxAge) {
+        const cachePath = this.getCachePath(key);
+        if (!fs.existsSync(cachePath)) {
+            return null;
+        }
+        try {
+            const data = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+            // Check expiration
+            if (maxAge && data.timestamp) {
+                const age = Date.now() - data.timestamp;
+                if (age > maxAge) {
+                    this.delete(key);
+                    return null;
+                }
+            }
+            return data.value;
+        }
+        catch (error) {
+            // Invalid cache, delete it
+            this.delete(key);
+            return null;
+        }
+    }
+    /**
+     * Set cache data
+     */
+    set(key, value) {
+        const cachePath = this.getCachePath(key);
+        const data = {
+            timestamp: Date.now(),
+            value,
+        };
+        fs.writeFileSync(cachePath, JSON.stringify(data), 'utf-8');
+    }
+    /**
+     * Delete cache entry
+     */
+    delete(key) {
+        const cachePath = this.getCachePath(key);
+        if (fs.existsSync(cachePath)) {
+            fs.unlinkSync(cachePath);
+        }
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        if (fs.existsSync(this.cacheDir)) {
+            const files = fs.readdirSync(this.cacheDir);
+            for (const file of files) {
+                fs.unlinkSync(path.join(this.cacheDir, file));
+            }
+        }
+    }
+}
+exports.FigmaCache = FigmaCache;
+//# sourceMappingURL=FigmaCache.js.map

package/dist/extraction/FigmaCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FigmaCache.js","sourceRoot":"","sources":["../../src/extraction/FigmaCache.ts"],"names":[],"mappings":"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"}

package/dist/extraction/MCPClient.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MCP (Model Context Protocol) Client
+ * Handles direct communication with Figma Desktop via WebSocket
+ */
+import { FigmaFile } from './types';
+export interface ConnectionStatus {
+    connected: boolean;
+    message?: string;
+}
+export interface DesignChanges {
+    type: 'node_added' | 'node_removed' | 'node_modified';
+    nodeId: string;
+    timestamp: number;
+    data?: any;
+}
+export declare class MCPClient {
+    private readonly wsUrl;
+    private ws;
+    private connected;
+    private messageId;
+    private pendingRequests;
+    private changeCallbacks;
+    private reconnectAttempts;
+    private readonly maxReconnectAttempts;
+    private readonly reconnectDelay;
+    constructor(wsUrl?: string);
+    /**
+     * Connect to Figma Desktop
+     * @returns Connection status
+     */
+    connect(): Promise<ConnectionStatus>;
+    /**
+     * Get current open file data
+     * @returns Design file data
+     */
+    getCurrentFile(): Promise<FigmaFile>;
+    /**
+     * Watch for design file changes
+     * @param callback - Change callback function
+     */
+    watchChanges(callback: (changes: DesignChanges) => void): void;
+    /**
+     * Disconnect from Figma Desktop
+     */
+    disconnect(): void;
+    /**
+     * Send a request and wait for response
+     */
+    private sendRequest;
+    /**
+     * Send a notification (no response expected)
+     */
+    private sendNotification;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleMessage;
+    /**
+     * Handle disconnection and attempt reconnection
+     */
+    private handleDisconnect;
+    /**
+     * Notify all change callbacks
+     */
+    private notifyChangeCallbacks;
+    /**
+     * Generate unique message ID
+     */
+    private generateMessageId;
+    /**
+     * Check if currently connected
+     */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=MCPClient.d.ts.map

package/dist/extraction/MCPClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPClient.d.ts","sourceRoot":"","sources":["../../src/extraction/MCPClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAcD,qBAAa,SAAS;IAgBR,OAAO,CAAC,QAAQ,CAAC,KAAK;IAflC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAMnB;IACJ,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAEV,KAAK,GAAE,MAA8B;IAMlE;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAiD1C;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IAkB1C;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAmB9D;;OAEG;IACH,UAAU,IAAI,IAAI;IAkBlB;;OAEG;YACW,WAAW;IAiCzB;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}