devlens-mcp 0.4.2 → 0.5.2

package/dist/bin/setup.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * DevLens MCP — Interactive Setup
+ *
+ * Configures npm authentication for Azure Artifacts and
+ * registers DevLens in Cursor / Claude Desktop / Claude Code.
+ *
+ * Usage:
+ *   npx devlens-mcp-setup           (after npm is configured)
+ *   node dist/bin/setup.js           (from source)
+ *   devlens-mcp setup                (if globally installed)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = require("path");
+const readline_1 = require("readline");
+const child_process_1 = require("child_process");
+const AZURE_REGISTRY = "https://pkgs.dev.azure.com/JioOmni/_packaging/devlens/npm/registry/";
+const AZURE_FEED_URL = "https://dev.azure.com/JioOmni/OmniAI/_artifacts/feed/devlens";
+const PAT_URL = "https://dev.azure.com/JioOmni/_usersSettings/tokens";
+const HOME = process.env.HOME || process.env.USERPROFILE || "~";
+const IDE_TARGETS = [
+    {
+        name: "Cursor (global)",
+        configPath: (0, path_1.resolve)(HOME, ".cursor", "mcp.json"),
+        configKey: "mcpServers",
+    },
+    {
+        name: "Claude Desktop (macOS)",
+        configPath: (0, path_1.resolve)(HOME, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+        configKey: "mcpServers",
+    },
+    {
+        name: "Claude Code",
+        configPath: (0, path_1.resolve)(HOME, ".claude", "mcp.json"),
+        configKey: "mcpServers",
+    },
+];
+function prompt(question) {
+    const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((answer) => {
+        rl.question(question, (val) => {
+            rl.close();
+            answer(val.trim());
+        });
+    });
+}
+function log(msg) {
+    console.log(msg);
+}
+function success(msg) {
+    console.log(`  [OK] ${msg}`);
+}
+function warn(msg) {
+    console.log(`  [!!] ${msg}`);
+}
+function info(msg) {
+    console.log(`  [..] ${msg}`);
+}
+function banner() {
+    log("");
+    log("  ╔══════════════════════════════════════════╗");
+    log("  ║         DevLens MCP — Setup Wizard       ║");
+    log("  ╚══════════════════════════════════════════╝");
+    log("");
+}
+function checkNodeVersion() {
+    const [major] = process.versions.node.split(".").map(Number);
+    if (major < 18) {
+        warn(`Node.js ${process.versions.node} detected — v18+ required.`);
+        return false;
+    }
+    success(`Node.js ${process.versions.node}`);
+    return true;
+}
+function checkAdb() {
+    try {
+        (0, child_process_1.execFileSync)("adb", ["version"], { stdio: "pipe" });
+        success("Android SDK (adb) found");
+        return true;
+    }
+    catch {
+        info("Android SDK (adb) not found — Android features will be unavailable");
+        return false;
+    }
+}
+function checkXcrun() {
+    if (process.platform !== "darwin")
+        return false;
+    try {
+        (0, child_process_1.execFileSync)("xcrun", ["simctl", "help"], { stdio: "pipe" });
+        success("Xcode simctl found");
+        return true;
+    }
+    catch {
+        info("Xcode simctl not found — iOS features will be unavailable");
+        return false;
+    }
+}
+async function configureNpmAuth(pat) {
+    const base64Pat = Buffer.from(pat).toString("base64");
+    const npmrcPath = (0, path_1.resolve)(HOME, ".npmrc");
+    let npmrcContent = "";
+    if ((0, fs_1.existsSync)(npmrcPath)) {
+        npmrcContent = (0, fs_1.readFileSync)(npmrcPath, "utf-8");
+    }
+    const registryKey = `//pkgs.dev.azure.com/JioOmni/_packaging/devlens/npm/registry/`;
+    const lines = npmrcContent.split("\n").filter((line) => {
+        return !line.includes("pkgs.dev.azure.com/JioOmni/_packaging/devlens");
+    });
+    lines.push(`${registryKey}:username=JioOmni`, `${registryKey}:_password=${base64Pat}`, `${registryKey}:email=npm@jio.com`, "");
+    (0, fs_1.writeFileSync)(npmrcPath, lines.join("\n"));
+    success(`npm credentials saved to ${npmrcPath}`);
+    return true;
+}
+function devlensServerConfig() {
+    return {
+        command: "devlens-mcp",
+        args: [],
+        env: {
+            METRO_PORT: "8081",
+        },
+    };
+}
+function configureIde(target, figmaToken) {
+    const dir = (0, path_1.dirname)(target.configPath);
+    let config = {};
+    if ((0, fs_1.existsSync)(target.configPath)) {
+        try {
+            config = JSON.parse((0, fs_1.readFileSync)(target.configPath, "utf-8"));
+        }
+        catch {
+            config = {};
+        }
+    }
+    if (!config[target.configKey]) {
+        config[target.configKey] = {};
+    }
+    const serverConfig = devlensServerConfig();
+    if (figmaToken) {
+        serverConfig.env.FIGMA_TOKEN = figmaToken;
+    }
+    if (config[target.configKey].devlens) {
+        info(`${target.name}: DevLens already configured — updating`);
+    }
+    config[target.configKey].devlens = serverConfig;
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(target.configPath, JSON.stringify(config, null, 2) + "\n");
+    success(`${target.name}: configured`);
+    return true;
+}
+function createProjectNpmrc(projectDir) {
+    const dir = projectDir || process.cwd();
+    const npmrcPath = (0, path_1.resolve)(dir, ".npmrc");
+    if ((0, fs_1.existsSync)(npmrcPath)) {
+        const content = (0, fs_1.readFileSync)(npmrcPath, "utf-8");
+        if (content.includes("pkgs.dev.azure.com/JioOmni/_packaging/devlens")) {
+            success(`Project .npmrc already configured at ${npmrcPath}`);
+            return;
+        }
+    }
+    const content = [
+        `registry=${AZURE_REGISTRY}`,
+        "always-auth=true",
+        "",
+    ].join("\n");
+    (0, fs_1.writeFileSync)(npmrcPath, content);
+    success(`Project .npmrc created at ${npmrcPath}`);
+}
+async function main() {
+    banner();
+    log("  Step 1/6 — Checking prerequisites");
+    log("  ──────────────────────────────────");
+    const nodeOk = checkNodeVersion();
+    if (!nodeOk) {
+        log("\n  Please install Node.js 18+ and try again.");
+        process.exit(1);
+    }
+    checkAdb();
+    checkXcrun();
+    log("");
+    log("  Step 2/6 — Azure Artifacts authentication");
+    log("  ──────────────────────────────────────────");
+    log(`  Create a PAT at: ${PAT_URL}`);
+    log("  Required scope: Packaging → Read");
+    log("");
+    const pat = await prompt("  Paste your Azure DevOps PAT: ");
+    if (!pat || pat.length < 20) {
+        warn("Invalid PAT. Please generate one and try again.");
+        process.exit(1);
+    }
+    await configureNpmAuth(pat);
+    log("");
+    log("  Step 3/6 — Installing DevLens globally");
+    log("  ───────────────────────────────────────");
+    try {
+        (0, child_process_1.execFileSync)("npm", [
+            "install",
+            "-g",
+            "devlens-mcp@latest",
+            "--registry",
+            AZURE_REGISTRY,
+        ], { stdio: "inherit" });
+        const version = (0, child_process_1.execFileSync)("devlens-mcp", ["--version"], {
+            encoding: "utf-8",
+        }).trim();
+        success(`devlens-mcp installed globally (${version})`);
+    }
+    catch (err) {
+        warn("Global install failed — check PAT permissions");
+        process.exit(1);
+    }
+    log("");
+    log("  Step 4/6 — Project npm configuration");
+    log("  ────────────────────────────────────");
+    createProjectNpmrc();
+    log("");
+    log("  Step 5/6 — IDE configuration");
+    log("  ────────────────────────────");
+    const figmaToken = await prompt("  Figma token (optional, press Enter to skip): ");
+    const configuredIdes = [];
+    for (const target of IDE_TARGETS) {
+        const parentDir = (0, path_1.dirname)(target.configPath);
+        const parentExists = (0, fs_1.existsSync)(parentDir) || (0, fs_1.existsSync)((0, path_1.dirname)(parentDir));
+        if (target.name.includes("macOS") && process.platform !== "darwin") {
+            continue;
+        }
+        if (parentExists ||
+            target.name.includes("Cursor")) {
+            configureIde(target, figmaToken || undefined);
+            configuredIdes.push(target.name);
+        }
+    }
+    if (configuredIdes.length === 0) {
+        warn("No supported IDEs detected. You can configure manually later.");
+    }
+    log("");
+    log("  Step 6/6 — Verification");
+    log("  ───────────────────────");
+    try {
+        const version = (0, child_process_1.execFileSync)("devlens-mcp", ["--version"], {
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        success(`DevLens CLI works: ${version}`);
+    }
+    catch {
+        warn("Could not verify devlens-mcp command.");
+        info("Try running: devlens-mcp --version");
+    }
+    log("");
+    log("  ╔══════════════════════════════════════════╗");
+    log("  ║            Setup Complete!                ║");
+    log("  ╚══════════════════════════════════════════╝");
+    log("");
+    log("  What's next:");
+    log("  1. Restart Cursor / Claude Desktop");
+    log("  2. Start your React Native app (npx react-native start)");
+    log("  3. Start an emulator/simulator");
+    log("  4. Ask the AI: \"List running devices\"");
+    log("");
+    log(`  Feed: ${AZURE_FEED_URL}`);
+    log("");
+}
+main().catch((err) => {
+    console.error("Setup failed:", err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/bin/setup.js.map

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

package/dist/src/figma/figma-api.d.ts

@@ -0,0 +1,108 @@
+import { FigmaRateLimitError } from "./figma-types.js";
+import type { FigmaClient } from "./figma-client.js";
+export { FigmaRateLimitError };
+export interface PrototypeConnection {
+    sourceNodeId: string;
+    sourceNodeName: string;
+    destinationNodeId: string;
+    trigger: string;
+    action: string;
+    transitionType?: string;
+    transitionDuration?: number;
+    transitionEasing?: string;
+}
+export interface PrototypeFlowSummary {
+    hasPrototype: boolean;
+    startingNodeId?: string;
+    startingNodeName?: string;
+    screenCount: number;
+    connections: PrototypeConnection[];
+    allScreenIds: string[];
+    allScreenNames: Map<string, string>;
+}
+export interface FigmaFileData {
+    name: string;
+    document: FigmaNode;
+    schemaVersion: number;
+}
+export interface FigmaNode {
+    id: string;
+    name: string;
+    type: string;
+    children?: FigmaNode[];
+    prototypeStartNodeID?: string;
+    flowStartingPoints?: Array<{
+        nodeId: string;
+        name: string;
+    }>;
+    transitionNodeID?: string;
+    transitionDuration?: number;
+    transitionEasing?: {
+        type: string;
+    };
+    reactions?: FigmaReaction[];
+    absoluteBoundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface FigmaReaction {
+    trigger: {
+        type: string;
+    };
+    actions?: Array<{
+        type: string;
+        destinationId?: string;
+        navigation?: string;
+        transition?: {
+            type: string;
+            duration: number;
+            easing?: {
+                type: string;
+            };
+        };
+    }>;
+}
+/**
+ * Fetch Figma file data including prototype information.
+ * Uses depth=2 by default to keep payload manageable while still
+ * capturing top-level frames and their direct children.
+ */
+export declare function fetchFileData(fileKey: string, token?: string, client?: FigmaClient): Promise<FigmaFileData>;
+/**
+ * Fetch full file data (no depth limit) for thorough prototype
+ * connection extraction.
+ */
+export declare function fetchFileDataFull(fileKey: string, token?: string, client?: FigmaClient): Promise<FigmaFileData>;
+/**
+ * Quick boolean check: does this file have prototype connections?
+ */
+export declare function hasPrototypeConnections(fileData: FigmaFileData): boolean;
+/**
+ * Walk the Figma node tree and extract all prototype connections
+ * (reactions that navigate to other frames).
+ */
+export declare function extractPrototypeFlows(fileData: FigmaFileData): PrototypeFlowSummary;
+/**
+ * Batch-export node images via the Figma images endpoint.
+ * Returns a map of nodeId -> image URL.
+ */
+export declare function exportNodeScreenshots(fileKey: string, nodeIds: readonly string[], scale?: number, token?: string, client?: FigmaClient): Promise<Map<string, string>>;
+/**
+ * Resolve a Figma design URL (or fileKey+nodeId) to a PNG buffer.
+ * Shared helper extracted from the inline implementations in
+ * screenshot-tools and vqa-tools.
+ */
+export declare function resolveFigmaImage(params: {
+    figmaUrl?: string;
+    fileKey?: string;
+    nodeId?: string;
+    scale: number;
+    client?: FigmaClient;
+}): Promise<{
+    buffer: Buffer;
+    error?: string;
+}>;
+//# sourceMappingURL=figma-api.d.ts.map

package/dist/src/figma/figma-api.d.ts.map

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

package/dist/src/figma/figma-api.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaRateLimitError = void 0;
+exports.fetchFileData = fetchFileData;
+exports.fetchFileDataFull = fetchFileDataFull;
+exports.hasPrototypeConnections = hasPrototypeConnections;
+exports.extractPrototypeFlows = extractPrototypeFlows;
+exports.exportNodeScreenshots = exportNodeScreenshots;
+exports.resolveFigmaImage = resolveFigmaImage;
+const url_parser_js_1 = require("./url-parser.js");
+const figma_types_js_1 = require("./figma-types.js");
+Object.defineProperty(exports, "FigmaRateLimitError", { enumerable: true, get: function () { return figma_types_js_1.FigmaRateLimitError; } });
+const API_BASE = "https://api.figma.com/v1";
+const REQUEST_TIMEOUT_MS = 20_000;
+function getFigmaToken() {
+    const token = process.env.FIGMA_TOKEN;
+    if (!token) {
+        throw new Error("FIGMA_TOKEN environment variable is not set.\n" +
+            'Set it in your MCP config: "env": { "FIGMA_TOKEN": "figd_xxxxx" }\n' +
+            "Generate at: https://www.figma.com/developers/api#access-tokens");
+    }
+    return token;
+}
+async function figmaFetch(path, token) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+        const response = await fetch(`${API_BASE}${path}`, {
+            headers: { "X-Figma-Token": token },
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (response.status === 429) {
+            const info = (0, figma_types_js_1.parseRateLimitHeaders)(response);
+            if (info) {
+                throw new figma_types_js_1.FigmaRateLimitError(`Figma API rate limited (retry-after: ${info.retryAfterSeconds}s)`, info);
+            }
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`Figma API ${response.status}: ${body || response.statusText}`);
+        }
+        return (await response.json());
+    }
+    catch (err) {
+        clearTimeout(timeout);
+        throw err;
+    }
+}
+/**
+ * Fetch Figma file data including prototype information.
+ * Uses depth=2 by default to keep payload manageable while still
+ * capturing top-level frames and their direct children.
+ */
+async function fetchFileData(fileKey, token, client) {
+    const t = token ?? getFigmaToken();
+    if (client) {
+        return client.fetchFileData(fileKey, t);
+    }
+    return figmaFetch(`/files/${fileKey}?depth=2`, t);
+}
+/**
+ * Fetch full file data (no depth limit) for thorough prototype
+ * connection extraction.
+ */
+async function fetchFileDataFull(fileKey, token, client) {
+    const t = token ?? getFigmaToken();
+    if (client) {
+        return client.fetchFileDataFull(fileKey, t);
+    }
+    return figmaFetch(`/files/${fileKey}`, t);
+}
+/**
+ * Quick boolean check: does this file have prototype connections?
+ */
+function hasPrototypeConnections(fileData) {
+    const summary = extractPrototypeFlows(fileData);
+    return summary.hasPrototype;
+}
+/**
+ * Walk the Figma node tree and extract all prototype connections
+ * (reactions that navigate to other frames).
+ */
+function extractPrototypeFlows(fileData) {
+    const connections = [];
+    const screenNames = new Map();
+    const screenIds = new Set();
+    let startingNodeId;
+    let startingNodeName;
+    function walkNode(node) {
+        if (node.type === "FRAME" || node.type === "COMPONENT") {
+            screenNames.set(node.id, node.name);
+        }
+        if (node.flowStartingPoints && node.flowStartingPoints.length > 0) {
+            const sp = node.flowStartingPoints[0];
+            startingNodeId = sp.nodeId;
+            startingNodeName = sp.name;
+        }
+        if (node.prototypeStartNodeID && !startingNodeId) {
+            startingNodeId = node.prototypeStartNodeID;
+        }
+        if (node.reactions) {
+            for (const reaction of node.reactions) {
+                if (!reaction.actions)
+                    continue;
+                for (const action of reaction.actions) {
+                    if (action.destinationId) {
+                        screenIds.add(node.id);
+                        screenIds.add(action.destinationId);
+                        connections.push({
+                            sourceNodeId: node.id,
+                            sourceNodeName: node.name,
+                            destinationNodeId: action.destinationId,
+                            trigger: reaction.trigger.type,
+                            action: action.type,
+                            transitionType: action.transition?.type,
+                            transitionDuration: action.transition?.duration,
+                            transitionEasing: action.transition?.easing?.type,
+                        });
+                    }
+                }
+            }
+        }
+        if (node.transitionNodeID) {
+            screenIds.add(node.id);
+            screenIds.add(node.transitionNodeID);
+            connections.push({
+                sourceNodeId: node.id,
+                sourceNodeName: node.name,
+                destinationNodeId: node.transitionNodeID,
+                trigger: "ON_CLICK",
+                action: "NAVIGATE",
+                transitionDuration: node.transitionDuration,
+                transitionEasing: node.transitionEasing?.type,
+            });
+        }
+        if (node.children) {
+            for (const child of node.children) {
+                walkNode(child);
+            }
+        }
+    }
+    walkNode(fileData.document);
+    if (!startingNodeName && startingNodeId) {
+        startingNodeName = screenNames.get(startingNodeId);
+    }
+    return {
+        hasPrototype: connections.length > 0,
+        startingNodeId,
+        startingNodeName,
+        screenCount: screenIds.size,
+        connections,
+        allScreenIds: [...screenIds],
+        allScreenNames: screenNames,
+    };
+}
+/**
+ * Batch-export node images via the Figma images endpoint.
+ * Returns a map of nodeId -> image URL.
+ */
+async function exportNodeScreenshots(fileKey, nodeIds, scale = 2, token, client) {
+    const t = token ?? getFigmaToken();
+    if (client) {
+        return client.exportImages(fileKey, [...nodeIds], scale, t);
+    }
+    const idsParam = nodeIds
+        .map((id) => encodeURIComponent((0, url_parser_js_1.normalizeNodeId)(id)))
+        .join(",");
+    const data = await figmaFetch(`/images/${fileKey}?ids=${idsParam}&format=png&scale=${scale}`, t);
+    if (data.err) {
+        throw new Error(`Figma image export error: ${data.err}`);
+    }
+    const result = new Map();
+    for (const [id, url] of Object.entries(data.images)) {
+        if (url)
+            result.set(id, url);
+    }
+    return result;
+}
+/**
+ * Resolve a Figma design URL (or fileKey+nodeId) to a PNG buffer.
+ * Shared helper extracted from the inline implementations in
+ * screenshot-tools and vqa-tools.
+ */
+async function resolveFigmaImage(params) {
+    const figmaToken = process.env.FIGMA_TOKEN;
+    if (!figmaToken) {
+        return {
+            buffer: Buffer.alloc(0),
+            error: "FIGMA_TOKEN environment variable is not set. Required for Figma image resolution.",
+        };
+    }
+    let fileKey = params.fileKey;
+    let nodeId = params.nodeId;
+    if (params.figmaUrl) {
+        const parsed = (0, url_parser_js_1.parseFigmaUrl)(params.figmaUrl);
+        if (!parsed) {
+            return {
+                buffer: Buffer.alloc(0),
+                error: `Could not parse Figma URL: ${params.figmaUrl}`,
+            };
+        }
+        fileKey = parsed.fileKey;
+        nodeId = parsed.nodeId;
+    }
+    if (!fileKey || !nodeId) {
+        return {
+            buffer: Buffer.alloc(0),
+            error: "Provide either figmaUrl, or both fileKey and nodeId.",
+        };
+    }
+    // Use FigmaClient if provided — gets caching, rate limiting, retry for free
+    if (params.client) {
+        const result = await params.client.resolveImage({
+            fileKey,
+            nodeId,
+            scale: params.scale,
+            token: figmaToken,
+        });
+        if ("error" in result) {
+            return { buffer: Buffer.alloc(0), error: result.error };
+        }
+        return { buffer: result.buffer };
+    }
+    // Legacy path — direct fetch (no caching/rate limiting)
+    const normalizedNodeId = (0, url_parser_js_1.normalizeNodeId)(nodeId);
+    const apiUrl = `${API_BASE}/images/${fileKey}?ids=${encodeURIComponent(normalizedNodeId)}&format=png&scale=${params.scale}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+        const apiResponse = await fetch(apiUrl, {
+            headers: { "X-Figma-Token": figmaToken },
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (apiResponse.status === 429) {
+            const info = (0, figma_types_js_1.parseRateLimitHeaders)(apiResponse);
+            if (info) {
+                let msg = `Figma API rate limit exceeded. Try again in ${info.retryAfterSeconds}s.`;
+                if (info.rateLimitType === "low") {
+                    msg = `Your Figma seat has limited API access (View/Collab: ~6 req/month). ` +
+                        `Upgrade to Full/Dev seat for 10-20 req/min.`;
+                    if (info.upgradeLink)
+                        msg += `\nUpgrade: ${info.upgradeLink}`;
+                }
+                return { buffer: Buffer.alloc(0), error: msg };
+            }
+        }
+        if (!apiResponse.ok) {
+            return {
+                buffer: Buffer.alloc(0),
+                error: `Figma API error (${apiResponse.status})`,
+            };
+        }
+        const apiData = (await apiResponse.json());
+        if (apiData.err) {
+            return {
+                buffer: Buffer.alloc(0),
+                error: `Figma API: ${apiData.err}`,
+            };
+        }
+        const imageUrl = Object.values(apiData.images)[0];
+        if (!imageUrl) {
+            return {
+                buffer: Buffer.alloc(0),
+                error: `No image returned for node ${normalizedNodeId}`,
+            };
+        }
+        const imgResponse = await fetch(imageUrl);
+        if (!imgResponse.ok) {
+            return {
+                buffer: Buffer.alloc(0),
+                error: `Failed to download Figma image: ${imgResponse.status}`,
+            };
+        }
+        return { buffer: Buffer.from(await imgResponse.arrayBuffer()) };
+    }
+    catch (err) {
+        clearTimeout(timeout);
+        const msg = err instanceof Error ? err.message : String(err);
+        return { buffer: Buffer.alloc(0), error: `Figma fetch failed: ${msg}` };
+    }
+}
+//# sourceMappingURL=figma-api.js.map