devlens-mcp 0.4.2 → 0.5.2

package/dist/src/figma/figma-rate-limiter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Adaptive token-bucket rate limiter for the Figma API.
+ * Starts conservative (10 req/min), auto-adapts when 429 headers
+ * reveal the user's plan tier and seat type.
+ */
+import { type FigmaRateLimitInfo, type RateLimiterStatus } from "./figma-types.js";
+export declare class FigmaRateLimiter {
+    private budget;
+    private tokens;
+    private lastRefill;
+    private pausedUntil;
+    private consecutiveSuccesses;
+    private planCap;
+    private detectedPlanTier?;
+    private detectedSeatType?;
+    private totalRequests;
+    private throttledRequests;
+    constructor(config?: {
+        initialBudget?: number;
+    });
+    /**
+     * Wait until a request is allowed. Blocks if paused or no tokens.
+     * Throws FigmaRateLimitError for View/Collab seats (budget = 0).
+     */
+    acquire(): Promise<void>;
+    /**
+     * Called when a 429 response is received. Adapts budget and pauses.
+     */
+    onRateLimited(info: FigmaRateLimitInfo): void;
+    /**
+     * Called on successful API response. Gradually increases budget.
+     */
+    onSuccess(): void;
+    /**
+     * Check if currently rate-limited without blocking.
+     */
+    isLimited(): boolean;
+    /**
+     * Get status for logging/observability.
+     */
+    getStatus(): RateLimiterStatus;
+    private refillTokens;
+    private msUntilNextToken;
+    private sleep;
+}
+//# sourceMappingURL=figma-rate-limiter.d.ts.map

package/dist/src/figma/figma-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/figma/figma-rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAgB1B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,OAAO,CAAY;IAE3B,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAK;gBAElB,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAM/C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAmC7C;;OAEG;IACH,SAAS,IAAI,IAAI;IAUjB;;OAEG;IACH,SAAS,IAAI,OAAO;IAKpB;;OAEG;IACH,SAAS,IAAI,iBAAiB;IAc9B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,KAAK;CAGd"}

package/dist/src/figma/figma-rate-limiter.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Adaptive token-bucket rate limiter for the Figma API.
+ * Starts conservative (10 req/min), auto-adapts when 429 headers
+ * reveal the user's plan tier and seat type.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaRateLimiter = void 0;
+const figma_types_js_1 = require("./figma-types.js");
+/** Plan-tier caps (requests per minute) */
+const PLAN_CAPS = {
+    starter: 10,
+    pro: 15,
+    org: 20,
+    organization: 20,
+    enterprise: 30,
+};
+const DEFAULT_BUDGET = 10;
+const BUDGET_INCREASE_THRESHOLD = 20; // consecutive successes before increasing
+const BUDGET_INCREASE_STEP = 2;
+const BUDGET_DECREASE_FACTOR = 0.7; // multiply by this on 429
+class FigmaRateLimiter {
+    budget;
+    tokens;
+    lastRefill;
+    pausedUntil = 0;
+    consecutiveSuccesses = 0;
+    planCap = Infinity;
+    detectedPlanTier;
+    detectedSeatType;
+    totalRequests = 0;
+    throttledRequests = 0;
+    constructor(config) {
+        this.budget = config?.initialBudget ?? DEFAULT_BUDGET;
+        this.tokens = this.budget;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Wait until a request is allowed. Blocks if paused or no tokens.
+     * Throws FigmaRateLimitError for View/Collab seats (budget = 0).
+     */
+    async acquire() {
+        this.totalRequests++;
+        this.refillTokens();
+        // If paused (after a 429), wait it out
+        const now = Date.now();
+        if (this.pausedUntil > now) {
+            const waitMs = this.pausedUntil - now;
+            if (waitMs > 300_000) {
+                // More than 5 minutes — likely a View/Collab seat
+                throw new figma_types_js_1.FigmaRateLimitError("Figma API rate limit: long pause required (likely View/Collab seat).", {
+                    retryAfterSeconds: Math.ceil(waitMs / 1000),
+                    planTier: this.detectedPlanTier,
+                    rateLimitType: this.detectedSeatType,
+                });
+            }
+            this.throttledRequests++;
+            await this.sleep(waitMs);
+        }
+        // Wait for a token
+        while (this.tokens < 1) {
+            this.throttledRequests++;
+            const refillWait = this.msUntilNextToken();
+            await this.sleep(refillWait);
+            this.refillTokens();
+        }
+        this.tokens--;
+    }
+    /**
+     * Called when a 429 response is received. Adapts budget and pauses.
+     */
+    onRateLimited(info) {
+        this.consecutiveSuccesses = 0;
+        // Detect plan tier from headers
+        if (info.planTier && !this.detectedPlanTier) {
+            this.detectedPlanTier = info.planTier.toLowerCase();
+            const cap = PLAN_CAPS[this.detectedPlanTier];
+            if (cap) {
+                this.planCap = cap;
+                this.budget = Math.min(this.budget, cap);
+            }
+        }
+        if (info.rateLimitType && !this.detectedSeatType) {
+            this.detectedSeatType = info.rateLimitType.toLowerCase();
+            if (this.detectedSeatType === "low") {
+                // View/Collab seat — extremely limited (6 req/month)
+                this.budget = 0;
+                this.planCap = 0;
+                this.tokens = 0;
+                const pauseMs = info.retryAfterSeconds * 1000;
+                this.pausedUntil = Date.now() + pauseMs;
+                return; // Skip normal budget decrease
+            }
+        }
+        // Decrease budget
+        this.budget = Math.max(1, Math.floor(this.budget * BUDGET_DECREASE_FACTOR));
+        // Pause for the Retry-After duration
+        const pauseMs = info.retryAfterSeconds * 1000;
+        this.pausedUntil = Date.now() + pauseMs;
+        this.tokens = 0;
+    }
+    /**
+     * Called on successful API response. Gradually increases budget.
+     */
+    onSuccess() {
+        this.consecutiveSuccesses++;
+        if (this.consecutiveSuccesses >= BUDGET_INCREASE_THRESHOLD) {
+            this.consecutiveSuccesses = 0;
+            const newBudget = this.budget + BUDGET_INCREASE_STEP;
+            this.budget = Math.min(newBudget, this.planCap);
+        }
+    }
+    /**
+     * Check if currently rate-limited without blocking.
+     */
+    isLimited() {
+        this.refillTokens();
+        return Date.now() < this.pausedUntil || this.tokens < 1;
+    }
+    /**
+     * Get status for logging/observability.
+     */
+    getStatus() {
+        this.refillTokens();
+        return {
+            budget: this.budget,
+            tokens: Math.floor(this.tokens),
+            pausedUntil: this.pausedUntil,
+            detectedPlanTier: this.detectedPlanTier,
+            detectedSeatType: this.detectedSeatType,
+            totalRequests: this.totalRequests,
+            throttledRequests: this.throttledRequests,
+            isLimited: this.isLimited(),
+        };
+    }
+    refillTokens() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const refillAmount = (elapsed / 60_000) * this.budget;
+        this.tokens = Math.min(this.budget, this.tokens + refillAmount);
+        this.lastRefill = now;
+    }
+    msUntilNextToken() {
+        if (this.budget <= 0)
+            return 60_000;
+        return Math.ceil(60_000 / this.budget);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, Math.min(ms, 60_000)));
+    }
+}
+exports.FigmaRateLimiter = FigmaRateLimiter;
+//# sourceMappingURL=figma-rate-limiter.js.map

package/dist/src/figma/figma-rate-limiter.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * 429-aware retry wrapper for Figma API requests.
+ * Respects Retry-After headers, delegates to the rate limiter,
+ * and uses exponential backoff for 5xx errors.
+ */
+import type { FigmaRateLimiter } from "./figma-rate-limiter.js";
+export interface FigmaRetryOptions {
+    rateLimiter: FigmaRateLimiter;
+    maxAttempts?: number;
+    onRetry?: (attempt: number, delayMs: number, reason: string) => void;
+}
+/**
+ * Execute a fetch with rate limiting + retry.
+ * - 429: parse Retry-After, pause via rate limiter, retry
+ * - 5xx: exponential backoff (1s, 2s, 4s)
+ * - 4xx (non-429): throw immediately
+ */
+export declare function figmaRetry(fn: () => Promise<Response>, options: FigmaRetryOptions): Promise<Response>;
+//# sourceMappingURL=figma-retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figma-retry.d.ts","sourceRoot":"","sources":["../../../src/figma/figma-retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAoDnB"}

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

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * 429-aware retry wrapper for Figma API requests.
+ * Respects Retry-After headers, delegates to the rate limiter,
+ * and uses exponential backoff for 5xx errors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.figmaRetry = figmaRetry;
+const figma_types_js_1 = require("./figma-types.js");
+/**
+ * Execute a fetch with rate limiting + retry.
+ * - 429: parse Retry-After, pause via rate limiter, retry
+ * - 5xx: exponential backoff (1s, 2s, 4s)
+ * - 4xx (non-429): throw immediately
+ */
+async function figmaRetry(fn, options) {
+    const { rateLimiter, maxAttempts = 3, onRetry } = options;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        await rateLimiter.acquire();
+        const response = await fn();
+        if (response.status === 429) {
+            const info = (0, figma_types_js_1.parseRateLimitHeaders)(response);
+            if (info) {
+                rateLimiter.onRateLimited(info);
+                // View/Collab seats or extremely long waits — don't retry
+                if (info.retryAfterSeconds > 300 || info.rateLimitType === "low") {
+                    throw new figma_types_js_1.FigmaRateLimitError(`Figma API rate limited (retry-after: ${info.retryAfterSeconds}s)`, info);
+                }
+                if (attempt < maxAttempts) {
+                    const delayMs = info.retryAfterSeconds * 1000;
+                    onRetry?.(attempt, delayMs, `429 rate limited, retry-after ${info.retryAfterSeconds}s`);
+                    await sleep(delayMs);
+                    continue;
+                }
+            }
+            // All retries exhausted
+            throw new figma_types_js_1.FigmaRateLimitError(`Figma API rate limited after ${maxAttempts} attempts`, info ?? { retryAfterSeconds: 60 });
+        }
+        if (response.status >= 500 && attempt < maxAttempts) {
+            const delayMs = 1000 * Math.pow(2, attempt - 1); // 1s, 2s, 4s
+            onRetry?.(attempt, delayMs, `server error ${response.status}`);
+            await sleep(delayMs);
+            continue;
+        }
+        // Success or non-retryable error
+        if (response.ok) {
+            rateLimiter.onSuccess();
+        }
+        return response;
+    }
+    // Should not reach here, but TypeScript needs it
+    throw new Error("figmaRetry: exhausted all attempts");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=figma-retry.js.map

package/dist/src/figma/figma-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-retry.js","sourceRoot":"","sources":["../../../src/figma/figma-retry.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAiBH,gCAuDC;AAtED,qDAA8E;AAS9E;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAC9B,EAA2B,EAC3B,OAA0B;IAE1B,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1D,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;QAE5B,MAAM,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC;QAE5B,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAA,sCAAqB,EAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,IAAI,EAAE,CAAC;gBACT,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAEhC,0DAA0D;gBAC1D,IAAI,IAAI,CAAC,iBAAiB,GAAG,GAAG,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;oBACjE,MAAM,IAAI,oCAAmB,CAC3B,wCAAwC,IAAI,CAAC,iBAAiB,IAAI,EAClE,IAAI,CACL,CAAC;gBACJ,CAAC;gBAED,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;oBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;oBAC9C,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,iCAAiC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;oBACxF,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,MAAM,IAAI,oCAAmB,CAC3B,gCAAgC,WAAW,WAAW,EACtD,IAAI,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAClC,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa;YAC9D,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,iCAAiC;QACjC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,WAAW,CAAC,SAAS,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iDAAiD;IACjD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -39,5 +39,5 @@ export interface FigmaLayoutNode {
  * @param token    FIGMA_TOKEN
  * @returns        Parsed FigmaLayoutNode tree
  */
-export declare function fetchFigmaStructure(fileKey: string, nodeId: string, token: string): Promise<FigmaLayoutNode>;
+export declare function fetchFigmaStructure(fileKey: string, nodeId: string, token: string, client?: import("./figma-client.js").FigmaClient): Promise<FigmaLayoutNode>;
 //# sourceMappingURL=figma-structure.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"figma-structure.d.ts","sourceRoot":"","sources":["../../../src/figma/figma-structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,eAAe,CAAC;IAClE,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IAGtB,mBAAmB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAG7E,sBAAsB,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACjD,oBAAoB,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAE/C,yBAAyB;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAyCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAmC1B"}
+{"version":3,"file":"figma-structure.d.ts","sourceRoot":"","sources":["../../../src/figma/figma-structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,eAAe,CAAC;IAClE,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IAGpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IAGtB,mBAAmB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAG7E,sBAAsB,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACjD,oBAAoB,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAE/C,yBAAyB;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAyCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,mBAAmB,EAAE,WAAW,GAC/C,OAAO,CAAC,eAAe,CAAC,CAmD1B"}

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

@@ -46,7 +46,17 @@ function parseNode(raw) {
  * @param token    FIGMA_TOKEN
  * @returns        Parsed FigmaLayoutNode tree
  */
-async function fetchFigmaStructure(fileKey, nodeId, token) {
+async function fetchFigmaStructure(fileKey, nodeId, token, client) {
+    // Use FigmaClient path if provided — gets caching + rate limiting
+    if (client) {
+        const data = (await client.fetchStructure(fileKey, nodeId, token));
+        const nodeData = data.nodes?.[nodeId];
+        if (!nodeData?.document) {
+            throw new Error(`Node "${nodeId}" not found in Figma file "${fileKey}". Check the node ID.`);
+        }
+        return parseNode(nodeData.document);
+    }
+    // Legacy direct fetch path
     const apiUrl = `https://api.figma.com/v1/files/${fileKey}/nodes?ids=${encodeURIComponent(nodeId)}`;
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 20000);

package/dist/src/figma/figma-structure.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Shared types, error classes, and header parsers for the Figma API resilience layer.
+ */
+export interface FigmaClientConfig {
+    /** Disk cache directory. Default: ~/.devlens/cache */
+    cacheDir?: string;
+    /** Memory cache max size in bytes. Default: 50MB */
+    memoryCacheMaxBytes?: number;
+    /** Default metadata TTL in ms. Default: 24h */
+    metadataTtlMs?: number;
+    /** Default image buffer TTL in ms. Default: 24h */
+    imageTtlMs?: number;
+    /** Initial rate limit budget (requests per minute). Default: 10 */
+    rateLimitBudget?: number;
+    /** Max retry attempts on 429/5xx. Default: 3 */
+    maxRetries?: number;
+}
+export interface FigmaRateLimitInfo {
+    retryAfterSeconds: number;
+    /** X-Figma-Plan-Tier header (e.g., "starter", "pro", "org", "enterprise") */
+    planTier?: string;
+    /** X-Figma-Rate-Limit-Type header ("low" = View/Collab seat, "high" = Full/Dev seat) */
+    rateLimitType?: string;
+    /** X-Figma-Upgrade-Link header */
+    upgradeLink?: string;
+}
+export declare class FigmaRateLimitError extends Error {
+    readonly info: FigmaRateLimitInfo;
+    constructor(message: string, info: FigmaRateLimitInfo);
+}
+/**
+ * Parse 429 response headers into structured rate limit info.
+ * Returns null if the response is not a 429.
+ */
+export declare function parseRateLimitHeaders(response: Response): FigmaRateLimitInfo | null;
+export interface RateLimiterStatus {
+    budget: number;
+    tokens: number;
+    pausedUntil: number;
+    detectedPlanTier?: string;
+    detectedSeatType?: string;
+    totalRequests: number;
+    throttledRequests: number;
+    isLimited: boolean;
+}
+export interface CacheStats {
+    memoryEntries: number;
+    diskEntries: number;
+    memoryBytes: number;
+    hitRate: number;
+    hits: number;
+    misses: number;
+}
+//# sourceMappingURL=figma-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figma-types.d.ts","sourceRoot":"","sources":["../../../src/figma/figma-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,IAAI,EAAE,kBAAkB;gBADxC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,kBAAkB;CAK3C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GACjB,kBAAkB,GAAG,IAAI,CAY3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Shared types, error classes, and header parsers for the Figma API resilience layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaRateLimitError = void 0;
+exports.parseRateLimitHeaders = parseRateLimitHeaders;
+class FigmaRateLimitError extends Error {
+    info;
+    constructor(message, info) {
+        super(message);
+        this.info = info;
+        this.name = "FigmaRateLimitError";
+    }
+}
+exports.FigmaRateLimitError = FigmaRateLimitError;
+/**
+ * Parse 429 response headers into structured rate limit info.
+ * Returns null if the response is not a 429.
+ */
+function parseRateLimitHeaders(response) {
+    if (response.status !== 429)
+        return null;
+    const retryAfter = response.headers.get("retry-after");
+    const retryAfterSeconds = retryAfter ? parseInt(retryAfter, 10) : 60;
+    return {
+        retryAfterSeconds: isNaN(retryAfterSeconds) ? 60 : retryAfterSeconds,
+        planTier: response.headers.get("x-figma-plan-tier") ?? undefined,
+        rateLimitType: response.headers.get("x-figma-rate-limit-type") ?? undefined,
+        upgradeLink: response.headers.get("x-figma-upgrade-link") ?? undefined,
+    };
+}
+//# sourceMappingURL=figma-types.js.map

package/dist/src/figma/figma-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-types.js","sourceRoot":"","sources":["../../../src/figma/figma-types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyCH,sDAcC;AA5BD,MAAa,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,IAAwB;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAoB;QAGxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,QAAkB;IAElB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,iBAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAErE,OAAO;QACL,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB;QACpE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS;QAChE,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,SAAS;QAC3E,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,SAAS;KACvE,CAAC;AACJ,CAAC"}

package/dist/src/figma/url-parser.d.ts

@@ -0,0 +1,40 @@
+export type PrototypeUrlType = "figma-design" | "figma-proto" | "web";
+export interface ParsedFigmaUrl {
+    fileKey: string;
+    nodeId?: string;
+    fileName?: string;
+}
+export interface ParsedPrototypeUrl {
+    type: PrototypeUrlType;
+    originalUrl: string;
+    fileKey?: string;
+    nodeId?: string;
+    baseUrl?: string;
+}
+/**
+ * Parse a Figma design URL (supports /design/, /branch/, and both
+ * dash-separated and colon-separated node IDs).
+ */
+export declare function parseFigmaUrl(url: string): ParsedFigmaUrl | undefined;
+/**
+ * Normalise a node ID to colon-separated format ("10-200" -> "10:200").
+ */
+export declare function normalizeNodeId(nodeId: string): string;
+/**
+ * Detect the prototype URL type and extract relevant identifiers.
+ */
+export declare function parsePrototypeUrl(url: string): ParsedPrototypeUrl;
+/**
+ * Convert a Figma file key (and optional starting node) to a
+ * public prototype URL.
+ */
+export declare function toPrototypeUrl(fileKey: string, startNodeId?: string): string;
+/**
+ * Check whether a URL already points to a Figma prototype viewer.
+ */
+export declare function isPrototypeUrl(url: string): boolean;
+/**
+ * Normalise a web URL to its origin (scheme + host).
+ */
+export declare function discoverBaseUrl(url: string): string;
+//# sourceMappingURL=url-parser.d.ts.map

package/dist/src/figma/url-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.d.ts","sourceRoot":"","sources":["../../../src/figma/url-parser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,aAAa,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GACV,cAAc,GAAG,SAAS,CA6B5B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CA0BjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOnD"}

package/dist/src/figma/url-parser.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFigmaUrl = parseFigmaUrl;
+exports.normalizeNodeId = normalizeNodeId;
+exports.parsePrototypeUrl = parsePrototypeUrl;
+exports.toPrototypeUrl = toPrototypeUrl;
+exports.isPrototypeUrl = isPrototypeUrl;
+exports.discoverBaseUrl = discoverBaseUrl;
+const FIGMA_DESIGN_REGEX = /figma\.com\/design\/([^/]+)\/([^?/]*)\??(?:.*node-id=(\d+-\d+))?/;
+const FIGMA_BRANCH_REGEX = /figma\.com\/design\/[^/]+\/branch\/([^/]+)\/([^?/]*)\??(?:.*node-id=(\d+-\d+))?/;
+const FIGMA_PROTO_REGEX = /figma\.com\/proto\/([^/]+)\/([^?/]*)\??(?:.*node-id=(\d+-\d+))?/;
+/**
+ * Parse a Figma design URL (supports /design/, /branch/, and both
+ * dash-separated and colon-separated node IDs).
+ */
+function parseFigmaUrl(url) {
+    const branchMatch = url.match(FIGMA_BRANCH_REGEX);
+    if (branchMatch) {
+        return {
+            fileKey: branchMatch[1],
+            nodeId: branchMatch[3]?.replace("-", ":"),
+            fileName: decodeURIComponent(branchMatch[2] || ""),
+        };
+    }
+    const designMatch = url.match(FIGMA_DESIGN_REGEX);
+    if (designMatch) {
+        return {
+            fileKey: designMatch[1],
+            nodeId: designMatch[3]?.replace("-", ":"),
+            fileName: decodeURIComponent(designMatch[2] || ""),
+        };
+    }
+    const protoMatch = url.match(FIGMA_PROTO_REGEX);
+    if (protoMatch) {
+        return {
+            fileKey: protoMatch[1],
+            nodeId: protoMatch[3]?.replace("-", ":"),
+            fileName: decodeURIComponent(protoMatch[2] || ""),
+        };
+    }
+    return undefined;
+}
+/**
+ * Normalise a node ID to colon-separated format ("10-200" -> "10:200").
+ */
+function normalizeNodeId(nodeId) {
+    return nodeId.replace("-", ":");
+}
+/**
+ * Detect the prototype URL type and extract relevant identifiers.
+ */
+function parsePrototypeUrl(url) {
+    if (FIGMA_PROTO_REGEX.test(url)) {
+        const parsed = parseFigmaUrl(url);
+        return {
+            type: "figma-proto",
+            originalUrl: url,
+            fileKey: parsed?.fileKey,
+            nodeId: parsed?.nodeId,
+        };
+    }
+    if (FIGMA_DESIGN_REGEX.test(url) || FIGMA_BRANCH_REGEX.test(url)) {
+        const parsed = parseFigmaUrl(url);
+        return {
+            type: "figma-design",
+            originalUrl: url,
+            fileKey: parsed?.fileKey,
+            nodeId: parsed?.nodeId,
+        };
+    }
+    return {
+        type: "web",
+        originalUrl: url,
+        baseUrl: discoverBaseUrl(url),
+    };
+}
+/**
+ * Convert a Figma file key (and optional starting node) to a
+ * public prototype URL.
+ */
+function toPrototypeUrl(fileKey, startNodeId) {
+    let url = `https://www.figma.com/proto/${fileKey}/Prototype`;
+    if (startNodeId) {
+        const dashId = startNodeId.replace(":", "-");
+        url += `?node-id=${dashId}&starting-point-node-id=${dashId}`;
+    }
+    return url;
+}
+/**
+ * Check whether a URL already points to a Figma prototype viewer.
+ */
+function isPrototypeUrl(url) {
+    return FIGMA_PROTO_REGEX.test(url);
+}
+/**
+ * Normalise a web URL to its origin (scheme + host).
+ */
+function discoverBaseUrl(url) {
+    try {
+        const u = new URL(url);
+        return u.origin;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/src/figma/url-parser.js.map

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

package/dist/src/platform/device-manager.d.ts

@@ -23,6 +23,11 @@ export declare class DeviceManager {
     private checkDeviceHealth;
     private discoverAndroidDevices;
     private discoverIosDevices;
+    /**
+     * Get Device instances for multiple device IDs simultaneously.
+     * Used by multi-device tools for parallel operations.
+     */
+    getMultipleDevices(deviceIds: string[]): Promise<Device[]>;
     private getAdbPath;
 }
 //# sourceMappingURL=device-manager.d.ts.map

package/dist/src/platform/device-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-manager.d.ts","sourceRoot":"","sources":["../../../src/platform/device-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAkC;IAElD,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkB9C,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqDnD;;;OAGG;YACW,iBAAiB;YAgCjB,sBAAsB;YAkDtB,kBAAkB;IAsChC,OAAO,CAAC,UAAU;CAQnB"}
+{"version":3,"file":"device-manager.d.ts","sourceRoot":"","sources":["../../../src/platform/device-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAkC;IAElD,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAkB9C,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqDnD;;;OAGG;YACW,iBAAiB;YAgCjB,sBAAsB;YAkDtB,kBAAkB;IAsChC;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBhE,OAAO,CAAC,UAAU;CAQnB"}