figma-inspect-cli 0.1.0

package/dist/cli/usage.d.ts

@@ -0,0 +1,2 @@
+export declare const usage = "Usage:\n  figma-inspect --list-team-projects [--json]\n  figma-inspect --list-project-files --project-id <id> [--json]\n  figma-inspect --list-team-project-files [--json]\n  figma-inspect --export-team-index --output-dir <dir> [--screen-similarity-threshold <number>] [--screen-size-tolerance <px>]\n  figma-inspect --list-team-component-sets [--json]\n  figma-inspect --list-file-pages --file-key <key> [--json]\n  figma-inspect --list-file-component-sets --file-key <key> [--json]\n  figma-inspect --inspect-component-set-properties (--url <figma-url> | --file-key <key> --node-id <id> (--component-set-key <key> | --component-set-name <name>)) [--json]\n  figma-inspect --inspect-component-set (--url <figma-url> | --file-key <key> --node-id <id> (--component-set-key <key> | --component-set-name <name>)) [--json]\n  figma-inspect --inspect-team-component-set (--component-set-key <key> | --component-set-name <name>) [--json]\n  figma-inspect --inspect-file-node (--url <figma-url> | --file-key <key> --node-id <id>) [--json]\n  figma-inspect --build-component-set-spec --input <path> --variables <path> [--team-components <path>] [--json]\n  figma-inspect --build-component-set-pseudocode --input <path> --variables <path> [--output-dir <dir>] [--team-components <path>] [--json]\n  figma-inspect --verify-component-contract --contract-dir <dir> [--component-name <name>] [--json]\n  figma-inspect --verify-node-contract --contract-dir <dir> [--node-name <name>] [--json]\n  figma-inspect --export-contract --output-dir <dir> --variables <path> (--url <figma-url> | --file-key <key> --node-id <id>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-assets] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]\n  figma-inspect --export-component-set --output-dir <dir> --variables <path> (--url <figma-url> | --component-set-key <key> | --component-set-name <name>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-assets] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]\n  figma-inspect --export-node-contract --output-dir <dir> --variables <path> (--url <figma-url> | --file-key <key> --node-id <id>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]\n\nEnvironment:\n  FIGMA_API_TOKEN  Figma personal access token (required for --verify-component-contract, --verify-node-contract, and all API commands below)\n  FIGMA_TEAM_ID    Figma team id (required for team-scoped commands, --export-team-index, --export-component-set, and --export-contract when the target is a COMPONENT_SET)\n  FIGMA_CACHE      Set to 0 to disable the on-disk response cache (enabled by default)\n\nOptions:\n  --list-team-projects            List projects in a Figma team\n  --list-project-files            List files in a Figma project\n  --list-team-project-files       List files in all team projects\n  --export-team-index             Write a deterministic team inventory index as YAML: team.index.yaml plus one sibling *.index.yaml per Figma file\n  --list-team-component-sets      List published component sets in a Figma team\n  --list-file-pages               List pages in a Figma file\n  --list-file-component-sets      List component sets in a Figma file\n  --inspect-component-set-properties List nested component sets exposed in a component set\n  --inspect-component-set         Print raw YAML for a COMPONENT_SET node in a file tree\n  --inspect-team-component-set    Find a published component set by name or key and print its raw YAML\n  --inspect-file-node             Print raw YAML for a file node\n  --build-component-set-spec      Build an AI-friendly spec from a local COMPONENT_SET JSON file; prints YAML by default\n  --build-component-set-pseudocode Build component contracts from a local COMPONENT_SET JSON file; writes <ComponentName>.component-set.{visuals,geometry,meta}.yaml and <ComponentName>.component-set.structure.dsl\n  --verify-component-contract     Compare lock files to live Figma via the API; validates local contract schema\n  --verify-node-contract          Compare frame/component node lock files to live Figma via the API; validates local node contract schema\n  --export-contract               Export contract files for a Figma URL or node ref; auto-detects COMPONENT_SET, FRAME, or standalone COMPONENT\n  --export-component-set          Export component contract files for a published team component set as YAML; writes <ComponentName>.component-set.lock.yaml; with --export-assets also writes <ComponentName>.assets/*.svg and stores asset paths in meta.yaml\n  --export-node-contract          Export FRAME or standalone COMPONENT node contract files as YAML; writes <Name>.frame.* or <Name>.component.* plus lock\n  --export-preview                Export one root node preview image next to contract artifacts; writes <Name>.<node-type>.preview.png by default\n  --preview-format <format>       Preview export format; supports png or svg (default: png)\n  --preview-scale <scale>         PNG preview scale for the Figma Images API (default: 2)\n  --export-assets                 Export one SVG asset per component variant via the Figma Images API (with --export-component-set or --export-contract targeting a COMPONENT_SET; variant props only, no TEXT layers)\n  --export-nested-assets          Export selected nested nodes as sidecar assets and write <Name>.<kind>.nested-assets.yaml\n  --asset-node-id <id>            Nested asset node id to export; repeatable; URL-style ids such as 208-43935 are accepted\n  --asset-include-regex <regex>   Select nested asset nodes whose name or path matches the regex\n  --asset-node-types <csv>        Comma-separated Figma node types allowed for regex selection (default: common visual nodes)\n  --asset-max <number>            Maximum nested asset nodes to export after selection\n  --asset-format <format>         Asset export format; svg for --export-assets, svg or png for --export-nested-assets (repeatable; default: svg)\n  --asset-scale <scale>           PNG nested asset scale for the Figma Images API (default: 2)\n  --screen-similarity-threshold <number> Screen similarity threshold for --export-team-index (default: 0.9)\n  --screen-size-tolerance <px>     Screen frame size tolerance in pixels for --export-team-index (default: 2)\n  --input <path>                  Input JSON file path (required with --build-component-set-spec and --build-component-set-pseudocode)\n  --output-dir <dir>              Output directory (optional with --build-component-set-pseudocode; defaults to the input file directory)\n  --contract-dir <dir>            Contract directory (required with --verify-component-contract and --verify-node-contract)\n  --component-name <name>         Component name (optional with --verify-component-contract; defaults to all lock files in --contract-dir)\n  --node-name <name>              Node contract base name (optional with --verify-node-contract; defaults to all frame/component lock files in --contract-dir)\n  --output-dir <dir>              Output directory (required with export commands and --export-team-index)\n  --variables <path>              Variables export JSON (required with --build-component-set-spec, --build-component-set-pseudocode, and export commands)\n  --team-components <path>        Team component sets JSON (optional with --build-component-set-spec and --build-component-set-pseudocode)\n  --url <figma-url>               Figma node URL; supports /design/<fileKey>/... and /file/<fileKey>/... with node-id\n  --project-id <id>               Project id (required with --list-project-files)\n  --file-key <key>                File key (required with --list-file-pages and --list-file-component-sets; also used with node inspect commands unless --url is set)\n  --node-id <id>                  Node id (required with node inspect commands unless --url is set)\n  --component-set-key <key>       Component set key (required with --inspect-component-set-properties and --inspect-component-set unless --component-set-name is set; also works with --inspect-team-component-set and --export-component-set)\n  --component-set-name <n>        Component set name (required with --inspect-component-set-properties and --inspect-component-set unless --component-set-key is set; also works with --inspect-team-component-set and --export-component-set)\n  --json                          Print or write JSON instead of the default YAML\n  --help, -h                      Show this help message\n";
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,wwRAyEjB,CAAC"}

package/dist/cli/usage.js

@@ -0,0 +1,75 @@
+export const usage = `Usage:
+  figma-inspect --list-team-projects [--json]
+  figma-inspect --list-project-files --project-id <id> [--json]
+  figma-inspect --list-team-project-files [--json]
+  figma-inspect --export-team-index --output-dir <dir> [--screen-similarity-threshold <number>] [--screen-size-tolerance <px>]
+  figma-inspect --list-team-component-sets [--json]
+  figma-inspect --list-file-pages --file-key <key> [--json]
+  figma-inspect --list-file-component-sets --file-key <key> [--json]
+  figma-inspect --inspect-component-set-properties (--url <figma-url> | --file-key <key> --node-id <id> (--component-set-key <key> | --component-set-name <name>)) [--json]
+  figma-inspect --inspect-component-set (--url <figma-url> | --file-key <key> --node-id <id> (--component-set-key <key> | --component-set-name <name>)) [--json]
+  figma-inspect --inspect-team-component-set (--component-set-key <key> | --component-set-name <name>) [--json]
+  figma-inspect --inspect-file-node (--url <figma-url> | --file-key <key> --node-id <id>) [--json]
+  figma-inspect --build-component-set-spec --input <path> --variables <path> [--team-components <path>] [--json]
+  figma-inspect --build-component-set-pseudocode --input <path> --variables <path> [--output-dir <dir>] [--team-components <path>] [--json]
+  figma-inspect --verify-component-contract --contract-dir <dir> [--component-name <name>] [--json]
+  figma-inspect --verify-node-contract --contract-dir <dir> [--node-name <name>] [--json]
+  figma-inspect --export-contract --output-dir <dir> --variables <path> (--url <figma-url> | --file-key <key> --node-id <id>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-assets] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]
+  figma-inspect --export-component-set --output-dir <dir> --variables <path> (--url <figma-url> | --component-set-key <key> | --component-set-name <name>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-assets] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]
+  figma-inspect --export-node-contract --output-dir <dir> --variables <path> (--url <figma-url> | --file-key <key> --node-id <id>) [--export-preview] [--preview-format png|svg] [--preview-scale <scale>] [--export-nested-assets (--asset-node-id <id> | --asset-include-regex <regex>)] [--asset-format svg|png] [--asset-scale <scale>] [--asset-node-types <csv>] [--asset-max <number>] [--json]
+
+Environment:
+  FIGMA_API_TOKEN  Figma personal access token (required for --verify-component-contract, --verify-node-contract, and all API commands below)
+  FIGMA_TEAM_ID    Figma team id (required for team-scoped commands, --export-team-index, --export-component-set, and --export-contract when the target is a COMPONENT_SET)
+  FIGMA_CACHE      Set to 0 to disable the on-disk response cache (enabled by default)
+
+Options:
+  --list-team-projects            List projects in a Figma team
+  --list-project-files            List files in a Figma project
+  --list-team-project-files       List files in all team projects
+  --export-team-index             Write a deterministic team inventory index as YAML: team.index.yaml plus one sibling *.index.yaml per Figma file
+  --list-team-component-sets      List published component sets in a Figma team
+  --list-file-pages               List pages in a Figma file
+  --list-file-component-sets      List component sets in a Figma file
+  --inspect-component-set-properties List nested component sets exposed in a component set
+  --inspect-component-set         Print raw YAML for a COMPONENT_SET node in a file tree
+  --inspect-team-component-set    Find a published component set by name or key and print its raw YAML
+  --inspect-file-node             Print raw YAML for a file node
+  --build-component-set-spec      Build an AI-friendly spec from a local COMPONENT_SET JSON file; prints YAML by default
+  --build-component-set-pseudocode Build component contracts from a local COMPONENT_SET JSON file; writes <ComponentName>.component-set.{visuals,geometry,meta}.yaml and <ComponentName>.component-set.structure.dsl
+  --verify-component-contract     Compare lock files to live Figma via the API; validates local contract schema
+  --verify-node-contract          Compare frame/component node lock files to live Figma via the API; validates local node contract schema
+  --export-contract               Export contract files for a Figma URL or node ref; auto-detects COMPONENT_SET, FRAME, or standalone COMPONENT
+  --export-component-set          Export component contract files for a published team component set as YAML; writes <ComponentName>.component-set.lock.yaml; with --export-assets also writes <ComponentName>.assets/*.svg and stores asset paths in meta.yaml
+  --export-node-contract          Export FRAME or standalone COMPONENT node contract files as YAML; writes <Name>.frame.* or <Name>.component.* plus lock
+  --export-preview                Export one root node preview image next to contract artifacts; writes <Name>.<node-type>.preview.png by default
+  --preview-format <format>       Preview export format; supports png or svg (default: png)
+  --preview-scale <scale>         PNG preview scale for the Figma Images API (default: 2)
+  --export-assets                 Export one SVG asset per component variant via the Figma Images API (with --export-component-set or --export-contract targeting a COMPONENT_SET; variant props only, no TEXT layers)
+  --export-nested-assets          Export selected nested nodes as sidecar assets and write <Name>.<kind>.nested-assets.yaml
+  --asset-node-id <id>            Nested asset node id to export; repeatable; URL-style ids such as 208-43935 are accepted
+  --asset-include-regex <regex>   Select nested asset nodes whose name or path matches the regex
+  --asset-node-types <csv>        Comma-separated Figma node types allowed for regex selection (default: common visual nodes)
+  --asset-max <number>            Maximum nested asset nodes to export after selection
+  --asset-format <format>         Asset export format; svg for --export-assets, svg or png for --export-nested-assets (repeatable; default: svg)
+  --asset-scale <scale>           PNG nested asset scale for the Figma Images API (default: 2)
+  --screen-similarity-threshold <number> Screen similarity threshold for --export-team-index (default: 0.9)
+  --screen-size-tolerance <px>     Screen frame size tolerance in pixels for --export-team-index (default: 2)
+  --input <path>                  Input JSON file path (required with --build-component-set-spec and --build-component-set-pseudocode)
+  --output-dir <dir>              Output directory (optional with --build-component-set-pseudocode; defaults to the input file directory)
+  --contract-dir <dir>            Contract directory (required with --verify-component-contract and --verify-node-contract)
+  --component-name <name>         Component name (optional with --verify-component-contract; defaults to all lock files in --contract-dir)
+  --node-name <name>              Node contract base name (optional with --verify-node-contract; defaults to all frame/component lock files in --contract-dir)
+  --output-dir <dir>              Output directory (required with export commands and --export-team-index)
+  --variables <path>              Variables export JSON (required with --build-component-set-spec, --build-component-set-pseudocode, and export commands)
+  --team-components <path>        Team component sets JSON (optional with --build-component-set-spec and --build-component-set-pseudocode)
+  --url <figma-url>               Figma node URL; supports /design/<fileKey>/... and /file/<fileKey>/... with node-id
+  --project-id <id>               Project id (required with --list-project-files)
+  --file-key <key>                File key (required with --list-file-pages and --list-file-component-sets; also used with node inspect commands unless --url is set)
+  --node-id <id>                  Node id (required with node inspect commands unless --url is set)
+  --component-set-key <key>       Component set key (required with --inspect-component-set-properties and --inspect-component-set unless --component-set-name is set; also works with --inspect-team-component-set and --export-component-set)
+  --component-set-name <n>        Component set name (required with --inspect-component-set-properties and --inspect-component-set unless --component-set-key is set; also works with --inspect-team-component-set and --export-component-set)
+  --json                          Print or write JSON instead of the default YAML
+  --help, -h                      Show this help message
+`;
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEpB,CAAC"}

package/dist/figma-api/cache/cached-request.d.ts

@@ -0,0 +1,8 @@
+export declare class CachedFigmaRequest {
+    private readonly token;
+    private readonly store;
+    constructor(token: string);
+    request(url: string | URL, fetchImpl: typeof fetch): Promise<unknown>;
+    private resolveCurrentFileVersion;
+}
+//# sourceMappingURL=cached-request.d.ts.map

package/dist/figma-api/cache/cached-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-request.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/cached-request.ts"],"names":[],"mappings":"AAsDA,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAEX,KAAK,EAAE,MAAM;IAIpC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;YAwC7D,yBAAyB;CAyCxC"}

package/dist/figma-api/cache/cached-request.js

@@ -0,0 +1,100 @@
+import { fetchFigmaResponse } from "../fetch-with-retry.js";
+import { FigmaApiError } from "../figma-api-error.js";
+import { formatFigmaError } from "../format-figma-error.js";
+import { ENTRY_TTL_MS, FILE_VERSION_MAX_AGE_MS } from "./constants.js";
+import { extractVersionMetadata } from "./extract-metadata.js";
+import { FigmaCacheStore } from "./store.js";
+import { buildFileProbeUrl, extractFileKey, normalizeRequestUrl, } from "./url.js";
+function isExpired(cachedAt, ttlMs, now = Date.now()) {
+    return now - cachedAt >= ttlMs;
+}
+async function fetchFromNetwork(url, token, fetchImpl) {
+    const response = await fetchFigmaResponse(url, token, fetchImpl);
+    if (!response.ok) {
+        throw new FigmaApiError(await formatFigmaError(response));
+    }
+    const body = await response.json();
+    const metadata = extractVersionMetadata(body);
+    return {
+        body,
+        version: metadata.version,
+        lastModified: metadata.lastModified,
+        etag: response.headers.get("etag") ?? undefined,
+    };
+}
+function buildCacheEntry(url, fetched, cachedAt = Date.now()) {
+    return {
+        url,
+        cachedAt,
+        version: fetched.version,
+        lastModified: fetched.lastModified,
+        etag: fetched.etag,
+        body: fetched.body,
+    };
+}
+export class CachedFigmaRequest {
+    token;
+    store;
+    constructor(token) {
+        this.token = token;
+        this.store = new FigmaCacheStore(token);
+    }
+    async request(url, fetchImpl) {
+        const canonicalUrl = normalizeRequestUrl(url);
+        const entry = await this.store.readEntry(canonicalUrl);
+        if (entry && !isExpired(entry.cachedAt, ENTRY_TTL_MS)) {
+            return entry.body;
+        }
+        const fileKey = extractFileKey(canonicalUrl);
+        if (entry && fileKey && entry.version !== undefined) {
+            const currentVersion = await this.resolveCurrentFileVersion(fileKey, fetchImpl);
+            if (currentVersion === entry.version) {
+                await this.store.writeEntry(canonicalUrl, {
+                    ...entry,
+                    cachedAt: Date.now(),
+                });
+                return entry.body;
+            }
+        }
+        const fetched = await fetchFromNetwork(url, this.token, fetchImpl);
+        await this.store.writeEntry(canonicalUrl, buildCacheEntry(canonicalUrl, fetched));
+        if (fileKey && fetched.version !== undefined) {
+            await this.store.writeFileVersion(fileKey, {
+                version: fetched.version,
+                lastModified: fetched.lastModified,
+                checkedAt: Date.now(),
+            });
+        }
+        return fetched.body;
+    }
+    async resolveCurrentFileVersion(fileKey, fetchImpl) {
+        const fileVersion = await this.store.readFileVersion(fileKey);
+        if (fileVersion &&
+            !isExpired(fileVersion.checkedAt, FILE_VERSION_MAX_AGE_MS)) {
+            return fileVersion.version;
+        }
+        const probeUrl = buildFileProbeUrl(fileKey);
+        const probeEntry = await this.store.readEntry(probeUrl);
+        if (probeEntry?.version !== undefined &&
+            !isExpired(probeEntry.cachedAt, ENTRY_TTL_MS)) {
+            await this.store.writeFileVersion(fileKey, {
+                version: probeEntry.version,
+                lastModified: probeEntry.lastModified,
+                checkedAt: Date.now(),
+            });
+            return probeEntry.version;
+        }
+        const fetched = await fetchFromNetwork(probeUrl, this.token, fetchImpl);
+        await this.store.writeEntry(probeUrl, buildCacheEntry(probeUrl, fetched));
+        if (fetched.version === undefined) {
+            return undefined;
+        }
+        await this.store.writeFileVersion(fileKey, {
+            version: fetched.version,
+            lastModified: fetched.lastModified,
+            checkedAt: Date.now(),
+        });
+        return fetched.version;
+    }
+}
+//# sourceMappingURL=cached-request.js.map

package/dist/figma-api/cache/cached-request.js.map

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

package/dist/figma-api/cache/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const CACHE_DIR_NAME = "figma-inspect-cli-cache";
+export declare const ENTRY_TTL_MS: number;
+export declare const FILE_VERSION_MAX_AGE_MS: number;
+export declare const CACHE_DISABLED_ENV = "FIGMA_CACHE";
+//# sourceMappingURL=constants.d.ts.map

package/dist/figma-api/cache/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,eAAO,MAAM,YAAY,QAAiB,CAAC;AAE3C,eAAO,MAAM,uBAAuB,QAAgB,CAAC;AAErD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC"}

package/dist/figma-api/cache/constants.js

@@ -0,0 +1,5 @@
+export const CACHE_DIR_NAME = "figma-inspect-cli-cache";
+export const ENTRY_TTL_MS = 60 * 60 * 1000;
+export const FILE_VERSION_MAX_AGE_MS = 5 * 60 * 1000;
+export const CACHE_DISABLED_ENV = "FIGMA_CACHE";
+//# sourceMappingURL=constants.js.map

package/dist/figma-api/cache/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/figma-api/cache/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC"}

package/dist/figma-api/cache/extract-metadata.d.ts

@@ -0,0 +1,3 @@
+import type { FetchedResponse } from "./types.js";
+export declare function extractVersionMetadata(body: unknown): Pick<FetchedResponse, "version" | "lastModified">;
+//# sourceMappingURL=extract-metadata.d.ts.map

package/dist/figma-api/cache/extract-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-metadata.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/extract-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,GACZ,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,cAAc,CAAC,CAenD"}

package/dist/figma-api/cache/extract-metadata.js

@@ -0,0 +1,13 @@
+export function extractVersionMetadata(body) {
+    if (typeof body !== "object" || body === null) {
+        return {};
+    }
+    const record = body;
+    return {
+        version: record.version === undefined || record.version === null
+            ? undefined
+            : String(record.version),
+        lastModified: typeof record.lastModified === "string" ? record.lastModified : undefined,
+    };
+}
+//# sourceMappingURL=extract-metadata.js.map

package/dist/figma-api/cache/extract-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-metadata.js","sourceRoot":"","sources":["../../../src/figma-api/cache/extract-metadata.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CACpC,IAAa;IAEb,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAA+B,CAAC;IAE/C,OAAO;QACL,OAAO,EACL,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;YACrD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,YAAY,EACV,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC;AACJ,CAAC"}

package/dist/figma-api/cache/index.d.ts

@@ -0,0 +1,3 @@
+export { CachedFigmaRequest } from "./cached-request.js";
+export { CACHE_DISABLED_ENV } from "./constants.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/figma-api/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/figma-api/cache/index.js

@@ -0,0 +1,3 @@
+export { CachedFigmaRequest } from "./cached-request.js";
+export { CACHE_DISABLED_ENV } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/figma-api/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/figma-api/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/figma-api/cache/store.d.ts

@@ -0,0 +1,10 @@
+import type { CacheEntry, FileVersionEntry } from "./types.js";
+export declare class FigmaCacheStore {
+    private readonly cacheRoot;
+    constructor(token: string);
+    readEntry(url: string): Promise<CacheEntry | undefined>;
+    writeEntry(url: string, entry: CacheEntry): Promise<void>;
+    readFileVersion(fileKey: string): Promise<FileVersionEntry | undefined>;
+    writeFileVersion(fileKey: string, entry: FileVersionEntry): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/figma-api/cache/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuC/D,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,KAAK,EAAE,MAAM;IAIzB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIvD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAMvE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1E"}

package/dist/figma-api/cache/store.js

@@ -0,0 +1,53 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { CACHE_DIR_NAME } from "./constants.js";
+import { hashValue, normalizeRequestUrl } from "./url.js";
+function getCacheRoot(token) {
+    const tokenHash = createHash("sha256")
+        .update(token)
+        .digest("hex")
+        .slice(0, 16);
+    return join(tmpdir(), CACHE_DIR_NAME, tokenHash);
+}
+function entryPath(cacheRoot, url) {
+    return join(cacheRoot, "entries", `${hashValue(normalizeRequestUrl(url))}.json`);
+}
+function fileVersionPath(cacheRoot, fileKey) {
+    return join(cacheRoot, "files", `${hashValue(fileKey)}.json`);
+}
+async function writeJsonAtomic(path, value) {
+    await mkdir(join(path, ".."), { recursive: true });
+    const tempPath = `${path}.${process.pid}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(value)}\n`, "utf8");
+    await rename(tempPath, path);
+}
+async function readJsonFile(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+export class FigmaCacheStore {
+    cacheRoot;
+    constructor(token) {
+        this.cacheRoot = getCacheRoot(token);
+    }
+    readEntry(url) {
+        return readJsonFile(entryPath(this.cacheRoot, url));
+    }
+    writeEntry(url, entry) {
+        return writeJsonAtomic(entryPath(this.cacheRoot, url), entry);
+    }
+    readFileVersion(fileKey) {
+        return readJsonFile(fileVersionPath(this.cacheRoot, fileKey));
+    }
+    writeFileVersion(fileKey, entry) {
+        return writeJsonAtomic(fileVersionPath(this.cacheRoot, fileKey), entry);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/figma-api/cache/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/figma-api/cache/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE1D,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC;SACnC,MAAM,CAAC,KAAK,CAAC;SACb,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,GAAW;IAC/C,OAAO,IAAI,CACT,SAAS,EACT,SAAS,EACT,GAAG,SAAS,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,OAAO,CAC9C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,OAAe;IACzD,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IACzD,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC9C,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,YAAY,CAAI,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,eAAe;IACT,SAAS,CAAS;IAEnC,YAAY,KAAa;QACvB,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,YAAY,CAAa,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,KAAiB;QACvC,OAAO,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,eAAe,CAAC,OAAe;QAC7B,OAAO,YAAY,CACjB,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,OAAe,EAAE,KAAuB;QACvD,OAAO,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/figma-api/cache/types.d.ts

@@ -0,0 +1,20 @@
+export interface CacheEntry {
+    url: string;
+    cachedAt: number;
+    version?: string;
+    lastModified?: string;
+    etag?: string;
+    body: unknown;
+}
+export interface FileVersionEntry {
+    version: string;
+    lastModified?: string;
+    checkedAt: number;
+}
+export interface FetchedResponse {
+    body: unknown;
+    version?: string;
+    lastModified?: string;
+    etag?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/figma-api/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/figma-api/cache/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/figma-api/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/figma-api/cache/types.ts"],"names":[],"mappings":""}

package/dist/figma-api/cache/url.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeRequestUrl(url: string | URL): string;
+export declare function hashValue(value: string): string;
+export declare function extractFileKey(url: string): string | undefined;
+export declare function buildFileProbeUrl(fileKey: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/figma-api/cache/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/figma-api/cache/url.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,CAK7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/figma-api/cache/url.js

@@ -0,0 +1,20 @@
+import { createHash } from "node:crypto";
+export function normalizeRequestUrl(url) {
+    const parsed = new URL(url.toString());
+    parsed.hash = "";
+    parsed.searchParams.sort();
+    return parsed.toString();
+}
+export function hashValue(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function extractFileKey(url) {
+    const match = new URL(url).pathname.match(/^\/v1\/files\/([^/]+)(?:\/|$)/);
+    return match?.[1];
+}
+export function buildFileProbeUrl(fileKey) {
+    const url = new URL(`https://api.figma.com/v1/files/${encodeURIComponent(fileKey)}`);
+    url.searchParams.set("depth", "1");
+    return url.toString();
+}
+//# sourceMappingURL=url.js.map

package/dist/figma-api/cache/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/figma-api/cache/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC3E,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,kCAAkC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAChE,CAAC;IACF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const FIGMA_API_BASE_URL = "https://api.figma.com/v1";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/figma-api/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,6BAA6B,CAAC"}

package/dist/figma-api/constants.js

@@ -0,0 +1,2 @@
+export const FIGMA_API_BASE_URL = "https://api.figma.com/v1";
+//# sourceMappingURL=constants.js.map

package/dist/figma-api/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/figma-api/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC"}

package/dist/figma-api/fetch-with-retry.d.ts

@@ -0,0 +1,2 @@
+export declare function fetchFigmaResponse(url: string | URL, token: string, fetchImpl?: typeof fetch): Promise<Response>;
+//# sourceMappingURL=fetch-with-retry.d.ts.map

package/dist/figma-api/fetch-with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/figma-api/fetch-with-retry.ts"],"names":[],"mappings":"AAqCA,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAsBnB"}

package/dist/figma-api/fetch-with-retry.js

@@ -0,0 +1,48 @@
+const MAX_RATE_LIMIT_RETRIES = 10;
+const MIN_RETRY_DELAY_MS = 1000;
+const RATE_LIMIT_BUFFER_MS = 250;
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+async function discardResponseBody(response) {
+    await response.arrayBuffer().catch(() => undefined);
+}
+function rateLimitDelayMs(response, now = Date.now()) {
+    const resetHeader = response.headers.get("x-ratelimit-reset");
+    if (resetHeader) {
+        const resetAtMs = Number.parseInt(resetHeader, 10) * 1000;
+        if (Number.isFinite(resetAtMs)) {
+            return Math.max(MIN_RETRY_DELAY_MS, resetAtMs - now + RATE_LIMIT_BUFFER_MS);
+        }
+    }
+    const retryAfter = response.headers.get("retry-after");
+    if (retryAfter) {
+        const retryAfterSeconds = Number.parseInt(retryAfter, 10);
+        if (Number.isFinite(retryAfterSeconds)) {
+            return Math.max(MIN_RETRY_DELAY_MS, retryAfterSeconds * 1000);
+        }
+    }
+    return MIN_RETRY_DELAY_MS;
+}
+export async function fetchFigmaResponse(url, token, fetchImpl = fetch) {
+    for (let attempt = 0; attempt <= MAX_RATE_LIMIT_RETRIES; attempt += 1) {
+        const response = await fetchImpl(url, {
+            headers: {
+                "X-FIGMA-TOKEN": token,
+            },
+        });
+        if (response.status !== 429) {
+            return response;
+        }
+        if (attempt === MAX_RATE_LIMIT_RETRIES) {
+            return response;
+        }
+        const delayMs = rateLimitDelayMs(response);
+        await discardResponseBody(response);
+        await sleep(delayMs);
+    }
+    throw new Error("Unreachable fetch retry loop.");
+}
+//# sourceMappingURL=fetch-with-retry.js.map

package/dist/figma-api/fetch-with-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.js","sourceRoot":"","sources":["../../src/figma-api/fetch-with-retry.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,QAAkB;IACnD,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAkB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC5D,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC9D,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;QAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,GAAG,CACb,kBAAkB,EAClB,SAAS,GAAG,GAAG,GAAG,oBAAoB,CACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAiB,EACjB,KAAa,EACb,YAA0B,KAAK;IAE/B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,sBAAsB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACpC,OAAO,EAAE;gBACP,eAAe,EAAE,KAAK;aACvB;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,KAAK,sBAAsB,EAAE,CAAC;YACvC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,4 @@
+export declare class FigmaApiError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=figma-api-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figma-api-error.d.ts","sourceRoot":"","sources":["../../src/figma-api/figma-api-error.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B"}

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

@@ -0,0 +1,7 @@
+export class FigmaApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FigmaApiError";
+    }
+}
+//# sourceMappingURL=figma-api-error.js.map

package/dist/figma-api/figma-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-api-error.js","sourceRoot":"","sources":["../../src/figma-api/figma-api-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,2 @@
+export declare function figmaRequest(url: string | URL, token: string, fetchImpl?: typeof fetch): Promise<unknown>;
+//# sourceMappingURL=figma-request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figma-request.d.ts","sourceRoot":"","sources":["../../src/figma-api/figma-request.ts"],"names":[],"mappings":"AAuBA,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,OAAO,CAAC,CAMlB"}

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

@@ -0,0 +1,21 @@
+import { CACHE_DISABLED_ENV, CachedFigmaRequest } from "./cache/index.js";
+import { fetchFigmaResponse } from "./fetch-with-retry.js";
+import { FigmaApiError } from "./figma-api-error.js";
+import { formatFigmaError } from "./format-figma-error.js";
+function isCacheEnabled(env = process.env) {
+    return env[CACHE_DISABLED_ENV] !== "0";
+}
+async function fetchWithoutCache(url, token, fetchImpl) {
+    const response = await fetchFigmaResponse(url, token, fetchImpl);
+    if (!response.ok) {
+        throw new FigmaApiError(await formatFigmaError(response));
+    }
+    return response.json();
+}
+export async function figmaRequest(url, token, fetchImpl = fetch) {
+    if (!isCacheEnabled()) {
+        return fetchWithoutCache(url, token, fetchImpl);
+    }
+    return new CachedFigmaRequest(token).request(url, fetchImpl);
+}
+//# sourceMappingURL=figma-request.js.map

package/dist/figma-api/figma-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-request.js","sourceRoot":"","sources":["../../src/figma-api/figma-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,SAAS,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC1D,OAAO,GAAG,CAAC,kBAAkB,CAAC,KAAK,GAAG,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,GAAiB,EACjB,KAAa,EACb,SAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAEjE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,aAAa,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAiB,EACjB,KAAa,EACb,YAA0B,KAAK;IAE/B,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC"}

package/dist/figma-api/format-figma-error.d.ts

@@ -0,0 +1,2 @@
+export declare function formatFigmaError(response: Response): Promise<string>;
+//# sourceMappingURL=format-figma-error.d.ts.map

package/dist/figma-api/format-figma-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-figma-error.d.ts","sourceRoot":"","sources":["../../src/figma-api/format-figma-error.ts"],"names":[],"mappings":"AAuBA,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E"}