Rename use-figma to figma
This commit is contained in:
1 parent
c5bf4b57e4
commit
7cee562c02
8 files changed
+11
-11
No files matched your search
Executable
+390
@@ -0,0 +1,390 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-code-connect-map.ts
|
||||
import { readFile } from "node:fs/promises";
|
||||
import path from "node:path";
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/url-parse.ts
|
||||
var FILE_KEY_REGEX = /figma\.com\/(?:file|design)\/([A-Za-z0-9]+)\//i;
|
||||
function parseFigmaUrl(input) {
|
||||
if (!input) return { fileKey: null, nodeId: null };
|
||||
try {
|
||||
const url = new URL(input);
|
||||
const match = url.href.match(FILE_KEY_REGEX);
|
||||
const fileKey = match ? match[1] : null;
|
||||
const nodeParam = url.searchParams.get("node-id");
|
||||
const nodeId = nodeParam ? ensureNodeId(nodeParam) : null;
|
||||
return { fileKey, nodeId };
|
||||
} catch {
|
||||
return { fileKey: null, nodeId: null };
|
||||
}
|
||||
}
|
||||
function ensureNodeId(value) {
|
||||
if (!value) return null;
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (decoded.includes(":")) return decoded;
|
||||
if (/^[0-9]+-[0-9]+$/.test(decoded)) {
|
||||
const [left, right] = decoded.split("-", 2);
|
||||
return `${left}:${right}`;
|
||||
}
|
||||
return decoded;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path: path2,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path2, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-code-connect-map.ts
|
||||
var TOOL_NAME = "get-code-connect-map";
|
||||
function log(message, verbose) {
|
||||
if (verbose) process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
function toOptionalString(value) {
|
||||
return typeof value === "string" && value.length > 0 ? value : null;
|
||||
}
|
||||
function exitWithEnvelope(envelope, errors = []) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
async function readRepoConfig() {
|
||||
try {
|
||||
const configPath = path.resolve("config/code-connect-map.json");
|
||||
const content = await readFile(configPath, "utf8");
|
||||
const parsed = JSON.parse(content);
|
||||
if (parsed && Array.isArray(parsed.components)) return parsed;
|
||||
return { version: "0.1", components: [] };
|
||||
} catch {
|
||||
return { version: "0.1", components: [] };
|
||||
}
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
const schemaVersion = toOptionalString(args["schema-version"]) ?? void 0;
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
let repoConfig = { version: "0.1", components: [] };
|
||||
try {
|
||||
repoConfig = await readRepoConfig();
|
||||
} catch (error) {
|
||||
warnings.push(error instanceof Error ? error.message : String(error));
|
||||
}
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is required but was not provided."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input: { fileKey: null, nodeId: null }, warnings, errors, schemaVersion, data: {} });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const urlInput = toOptionalString(args.url) ?? toOptionalString(args.u);
|
||||
let fileKey = toOptionalString(args["file-key"]) ?? void 0;
|
||||
const nodeIdInput = ensureNodeId(toOptionalString(args["node-id"]));
|
||||
if (urlInput) {
|
||||
const parsed = parseFigmaUrl(urlInput);
|
||||
fileKey = fileKey || parsed.fileKey || void 0;
|
||||
}
|
||||
const input = { fileKey: fileKey ?? null, nodeId: nodeIdInput ?? null };
|
||||
if (!fileKey) errors.push(createError("INPUT_INVALID", "A valid Figma file key is required (--file-key or --url)."));
|
||||
if (errors.length) {
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const resolvedFileKey = fileKey;
|
||||
log("Fetching dev resources", verbose);
|
||||
const devResourcesResponse = await figmaRequest({ path: `/v1/files/${resolvedFileKey}/devresources`, token });
|
||||
log("Fetching components", verbose);
|
||||
const componentsResponse = await figmaRequest({ path: `/v1/files/${resolvedFileKey}/components`, token });
|
||||
if (!devResourcesResponse.ok) {
|
||||
errors.push(devResourcesResponse.error ?? createError("INTERNAL", "Failed to fetch dev resources."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: devResourcesResponse.rateLimit ?? void 0, schemaVersion, data: {} });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
if (!componentsResponse.ok) warnings.push(componentsResponse.error?.message ?? "Failed to fetch components.");
|
||||
const devResources = devResourcesResponse.data?.dev_resources ?? [];
|
||||
const componentsMap = componentsResponse.ok ? componentsResponse.data?.components ?? {} : {};
|
||||
const repoMappings = repoConfig.components ?? [];
|
||||
const normalisedResources = devResources.map((resource) => ({
|
||||
id: resource.id,
|
||||
name: resource.name,
|
||||
description: resource.description ?? null,
|
||||
url: resource.url ?? null,
|
||||
nodeId: resource.node_id ?? null,
|
||||
componentId: resource.component_id ?? null,
|
||||
fileKey: resource.file_key ?? resolvedFileKey,
|
||||
status: resource.status ?? null,
|
||||
createdAt: resource.created_at ?? null,
|
||||
updatedAt: resource.updated_at ?? null
|
||||
}));
|
||||
const normalisedComponents = Object.entries(componentsMap).map(([componentId, component]) => ({
|
||||
id: componentId,
|
||||
key: component.key,
|
||||
name: component.name,
|
||||
description: component.description ?? null,
|
||||
fileKey: component.file_key ?? resolvedFileKey,
|
||||
nodeId: component.node_id ?? null
|
||||
}));
|
||||
const findRepoMapping = (name) => {
|
||||
if (!name) return null;
|
||||
return repoMappings.find((m) => m.name === name || m.component === name) ?? null;
|
||||
};
|
||||
const mappings = normalisedResources.map((resource) => {
|
||||
const component = resource.componentId ? normalisedComponents.find((entry) => entry.id === resource.componentId) : null;
|
||||
const repoMapping = findRepoMapping(component?.name ?? resource.name);
|
||||
if (!repoMapping) {
|
||||
warnings.push(`Node ${resource.nodeId ?? component?.nodeId ?? "unknown"} (${resource.name ?? component?.name ?? "unnamed"}) has no mapping in config/code-connect-map.json.`);
|
||||
}
|
||||
return {
|
||||
nodeId: resource.nodeId ?? component?.nodeId ?? null,
|
||||
componentId: resource.componentId ?? component?.id ?? null,
|
||||
componentKey: component?.key ?? null,
|
||||
componentName: component?.name ?? resource.name ?? null,
|
||||
repoComponent: repoMapping?.component ?? null,
|
||||
repoPath: repoMapping?.path ?? null,
|
||||
props: repoMapping?.props ?? null,
|
||||
description: component?.description ?? resource.description ?? null,
|
||||
status: resource.status ?? null,
|
||||
sourceUrl: resource.url ?? null
|
||||
};
|
||||
});
|
||||
const data = { file: { key: resolvedFileKey }, mappings, components: normalisedComponents, devResources: normalisedResources };
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input, data, warnings, errors, rateLimit: devResourcesResponse.rateLimit ?? void 0, schemaVersion });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input: { fileKey: null, nodeId: null }, errors: [createError("INTERNAL", message, { stack: error instanceof Error ? error.stack : void 0 })], data: {} });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2dldC1jb2RlLWNvbm5lY3QtbWFwLnRzIiwgIi4uL3NyYy9fdXRpbHMvY2xpLWFyZ3MudHMiLCAiLi4vc3JjL191dGlscy91cmwtcGFyc2UudHMiLCAiLi4vc3JjL191dGlscy9jb25maWcudHMiLCAiLi4vc3JjL191dGlscy9lbnZlbG9wZS50cyIsICIuLi9zcmMvX3V0aWxzL2Vycm9ycy50cyIsICIuLi9zcmMvX3V0aWxzL2h0dHAtY2xpZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIjIS91c3IvYmluL2VudiBub2RlXG5cbmltcG9ydCB7IHJlYWRGaWxlIH0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcydcbmltcG9ydCBwYXRoIGZyb20gJ25vZGU6cGF0aCdcbmltcG9ydCB7IHBhcnNlQXJncywgdHlwZSBDbGlBcmdzIH0gZnJvbSAnLi9fdXRpbHMvY2xpLWFyZ3MudHMnXG5pbXBvcnQgeyBwYXJzZUZpZ21hVXJsLCBlbnN1cmVOb2RlSWQgfSBmcm9tICcuL191dGlscy91cmwtcGFyc2UudHMnXG5pbXBvcnQgeyBjcmVhdGVFbnZlbG9wZSwgdHlwZSBUb29sRW52ZWxvcGUgfSBmcm9tICcuL191dGlscy9lbnZlbG9wZS50cydcbmltcG9ydCB7IGNyZWF0ZUVycm9yLCBnZXRFeGl0Q29kZSwgdHlwZSBUb29sRXJyb3IgfSBmcm9tICcuL191dGlscy9lcnJvcnMudHMnXG5pbXBvcnQgeyBmaWdtYVJlcXVlc3QgfSBmcm9tICcuL191dGlscy9odHRwLWNsaWVudC50cydcblxuY29uc3QgVE9PTF9OQU1FID0gJ2dldC1jb2RlLWNvbm5lY3QtbWFwJ1xudHlwZSBFbXB0eURhdGEgPSBSZWNvcmQ8c3RyaW5nLCBuZXZlcj5cblxuaW50ZXJmYWNlIFRvb2xJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+IHsgZmlsZUtleTogc3RyaW5nIHwgbnVsbDsgbm9kZUlkOiBzdHJpbmcgfCBudWxsIH1cblxuaW50ZXJmYWNlIFJlcG9Db21wb25lbnRNYXBwaW5nIHsgbmFtZT86IHN0cmluZzsgY29tcG9uZW50Pzogc3RyaW5nOyBwYXRoPzogc3RyaW5nOyBwcm9wcz86IFJlY29yZDxzdHJpbmcsIHVua25vd24+IH1cbmludGVyZmFjZSBSZXBvQ29uZmlnIHsgdmVyc2lvbj86IHN0cmluZzsgY29tcG9uZW50cz86IFJlcG9Db21wb25lbnRNYXBwaW5nW10gfVxuXG5pbnRlcmZhY2UgRGV2UmVzb3VyY2VQYXlsb2FkIHsgZGV2X3Jlc291cmNlcz86IERldlJlc291cmNlW10gfVxuaW50ZXJmYWNlIERldlJlc291cmNlIHsgaWQ6IHN0cmluZzsgbmFtZT86IHN0cmluZzsgZGVzY3JpcHRpb24/OiBzdHJpbmc7IHVybD86IHN0cmluZzsgbm9kZV9pZD86IHN0cmluZzsgY29tcG9uZW50X2lkPzogc3RyaW5nOyBmaWxlX2tleT86IHN0cmluZzsgc3RhdHVzPzogc3RyaW5nOyBjcmVhdGVkX2F0Pzogc3RyaW5nOyB1cGRhdGVkX2F0Pzogc3RyaW5nIH1cbmludGVyZmFjZSBOb3JtYWxpc2VkRGV2UmVzb3VyY2UgeyBpZDogc3RyaW5nOyBuYW1lPzogc3RyaW5nOyBkZXNjcmlwdGlvbjogc3RyaW5nIHwgbnVsbDsgdXJsOiBzdHJpbmcgfCBudWxsOyBub2RlSWQ6IHN0cmluZyB8IG51bGw7IGNvbXBvbmVudElkOiBzdHJpbmcgfCBudWxsOyBmaWxlS2V5OiBzdHJpbmc7IHN0YXR1czogc3RyaW5nIHwgbnVsbDsgY3JlYXRlZEF0OiBzdHJpbmcgfCBudWxsOyB1cGRhdGVkQXQ6IHN0cmluZyB8IG51bGwgfVxuXG5pbnRlcmZhY2UgQ29tcG9uZW50TWV0YSB7IGtleT86IHN0cmluZzsgbmFtZT86IHN0cmluZzsgZGVzY3JpcHRpb24/OiBzdHJpbmc7IGZpbGVfa2V5Pzogc3RyaW5nOyBub2RlX2lkPzogc3RyaW5nIH1cbmludGVyZmFjZSBDb21wb25lbnRzUGF5bG9hZCB7IGNvbXBvbmVudHM/OiBSZWNvcmQ8c3RyaW5nLCBDb21wb25lbnRNZXRhPiB9XG5pbnRlcmZhY2UgTm9ybWFsaXNlZENvbXBvbmVudCB7IGlkOiBzdHJpbmc7IGtleT86IHN0cmluZzsgbmFtZT86IHN0cmluZzsgZGVzY3JpcHRpb246IHN0cmluZyB8IG51bGw7IGZpbGVLZXk6IHN0cmluZzsgbm9kZUlkOiBzdHJpbmcgfCBudWxsIH1cblxuaW50ZXJmYWNlIE1hcHBpbmcgeyBub2RlSWQ6IHN0cmluZyB8IG51bGw7IGNvbXBvbmVudElkOiBzdHJpbmcgfCBudWxsOyBjb21wb25lbnRLZXk6IHN0cmluZyB8IG51bGw7IGNvbXBvbmVudE5hbWU6IHN0cmluZyB8IG51bGw7IHJlcG9Db21wb25lbnQ6IHN0cmluZyB8IG51bGw7IHJlcG9QYXRoOiBzdHJpbmcgfCBudWxsOyBwcm9wczogUmVjb3JkPHN0cmluZywgdW5rbm93bj4gfCBudWxsOyBkZXNjcmlwdGlvbjogc3RyaW5nIHwgbnVsbDsgc3RhdHVzOiBzdHJpbmcgfCBudWxsOyBzb3VyY2VVcmw6IHN0cmluZyB8IG51bGwgfVxuXG5pbnRlcmZhY2UgQ29kZUNvbm5lY3REYXRhIHsgZmlsZTogeyBrZXk6IHN0cmluZyB9OyBtYXBwaW5nczogTWFwcGluZ1tdOyBjb21wb25lbnRzOiBOb3JtYWxpc2VkQ29tcG9uZW50W107IGRldlJlc291cmNlczogTm9ybWFsaXNlZERldlJlc291cmNlW10gfVxuXG5mdW5jdGlvbiBsb2cobWVzc2FnZTogc3RyaW5nLCB2ZXJib3NlOiBib29sZWFuKTogdm9pZCB7IGlmICh2ZXJib3NlKSBwcm9jZXNzLnN0ZGVyci53cml0ZShgWyR7VE9PTF9OQU1FfV0gJHttZXNzYWdlfVxcbmApIH1cbmZ1bmN0aW9uIHRvT3B0aW9uYWxTdHJpbmcodmFsdWU6IENsaUFyZ3Nbc3RyaW5nXSk6IHN0cmluZyB8IG51bGwgeyByZXR1cm4gdHlwZW9mIHZhbHVlID09PSAnc3RyaW5nJyAmJiB2YWx1ZS5sZW5ndGggPiAwID8gdmFsdWUgOiBudWxsIH1cbmZ1bmN0aW9uIGV4aXRXaXRoRW52ZWxvcGUoZW52ZWxvcGU6IFRvb2xFbnZlbG9wZTxUb29sSW5wdXQsIENvZGVDb25uZWN0RGF0YSB8IEVtcHR5RGF0YT4sIGVycm9yczogVG9vbEVycm9yW10gPSBbXSk6IG5ldmVyIHsgcHJvY2Vzcy5zdGRvdXQud3JpdGUoYCR7SlNPTi5zdHJpbmdpZnkoZW52ZWxvcGUsIG51bGwsIDIpfVxcbmApOyBwcm9jZXNzLmV4aXQoZ2V0RXhpdENvZGUoZXJyb3JzKSkgfVxuXG5hc3luYyBmdW5jdGlvbiByZWFkUmVwb0NvbmZpZygpOiBQcm9taXNlPFJlcG9Db25maWc+IHtcbiAgdHJ5IHtcbiAgICBjb25zdCBjb25maWdQYXRoID0gcGF0aC5yZXNvbHZlKCdjb25maWcvY29kZS1jb25uZWN0LW1hcC5qc29uJylcbiAgICBjb25zdCBjb250ZW50ID0gYXdhaXQgcmVhZEZpbGUoY29uZmlnUGF0aCwgJ3V0ZjgnKVxuICAgIGNvbnN0IHBhcnNlZCA9IEpTT04ucGFyc2UoY29udGVudClcbiAgICBpZiAocGFyc2VkICYmIEFycmF5LmlzQXJyYXkocGFyc2VkLmNvbXBvbmVudHMpKSByZXR1cm4gcGFyc2VkXG4gICAgcmV0dXJuIHsgdmVyc2lvbjogJzAuMScsIGNvbXBvbmVudHM6IFtdIH1cbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIHsgdmVyc2lvbjogJzAuMScsIGNvbXBvbmVudHM6IFtdIH1cbiAgfVxufVxuXG5hc3luYyBmdW5jdGlvbiBtYWluKCk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCBhcmdzID0gcGFyc2VBcmdzKClcbiAgY29uc3QgdmVyYm9zZSA9IEJvb2xlYW4oYXJncy52ZXJib3NlID8/IGFyZ3MudilcbiAgY29uc3Qgc2NoZW1hVmVyc2lvbiA9IHRvT3B0aW9uYWxTdHJpbmcoYXJnc1snc2NoZW1hLXZlcnNpb24nXSkgPz8gdW5kZWZpbmVkXG5cbiAgY29uc3Qgd2FybmluZ3M6IHN0cmluZ1tdID0gW11cbiAgY29uc3QgZXJyb3JzOiBUb29sRXJyb3JbXSA9IFtdXG5cbiAgbGV0IHJlcG9Db25maWc6IFJlcG9Db25maWcgPSB7IHZlcnNpb246ICcwLjEnLCBjb21wb25lbnRzOiBbXSB9XG4gIHRyeSB7IHJlcG9Db25maWcgPSBhd2FpdCByZWFkUmVwb0NvbmZpZygpIH0gY2F0Y2ggKGVyc
Line truncated
|
||||
Executable
+484
@@ -0,0 +1,484 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-design-context.ts
|
||||
import { createHash } from "node:crypto";
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/url-parse.ts
|
||||
var FILE_KEY_REGEX = /figma\.com\/(?:file|design)\/([A-Za-z0-9]+)\//i;
|
||||
function parseFigmaUrl(input) {
|
||||
if (!input) return { fileKey: null, nodeId: null };
|
||||
try {
|
||||
const url = new URL(input);
|
||||
const match = url.href.match(FILE_KEY_REGEX);
|
||||
const fileKey = match ? match[1] : null;
|
||||
const nodeParam = url.searchParams.get("node-id");
|
||||
const nodeId = nodeParam ? ensureNodeId(nodeParam) : null;
|
||||
return { fileKey, nodeId };
|
||||
} catch {
|
||||
return { fileKey: null, nodeId: null };
|
||||
}
|
||||
}
|
||||
function ensureNodeId(value) {
|
||||
if (!value) return null;
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (decoded.includes(":")) return decoded;
|
||||
if (/^[0-9]+-[0-9]+$/.test(decoded)) {
|
||||
const [left, right] = decoded.split("-", 2);
|
||||
return `${left}:${right}`;
|
||||
}
|
||||
return decoded;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-design-context.ts
|
||||
var TOOL_NAME = "get-design-context";
|
||||
var VALID_IMAGE_FORMATS = ["png", "jpg", "jpeg", "svg"];
|
||||
function log(message, verbose) {
|
||||
if (verbose) {
|
||||
process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
}
|
||||
function toOptionalString(value) {
|
||||
return typeof value === "string" && value.length > 0 ? value : null;
|
||||
}
|
||||
function exitWithEnvelope(envelope, errors = []) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
function mapLayoutNode(node) {
|
||||
const children = Array.isArray(node.children) ? node.children.map(mapLayoutNode) : [];
|
||||
const bbox = node.absoluteBoundingBox;
|
||||
const layout = bbox ? { x: bbox.x ?? 0, y: bbox.y ?? 0, width: bbox.width ?? 0, height: bbox.height ?? 0 } : null;
|
||||
return {
|
||||
id: node.id,
|
||||
name: node.name,
|
||||
type: node.type,
|
||||
visible: node.visible ?? true,
|
||||
layout,
|
||||
rotation: node.rotation ?? 0,
|
||||
clipsContent: node.clipsContent ?? false,
|
||||
characters: node.characters ?? null,
|
||||
fills: node.fills ?? [],
|
||||
strokes: node.strokes ?? [],
|
||||
effects: node.effects ?? [],
|
||||
tailwindSuggestion: null,
|
||||
children
|
||||
};
|
||||
}
|
||||
function buildStyleTokens(node) {
|
||||
const cornerRadius = Array.isArray(node.rectangleCornerRadii) && node.rectangleCornerRadii.length > 0 ? node.rectangleCornerRadii : node.cornerRadius ?? null;
|
||||
return {
|
||||
fills: node.fills ?? [],
|
||||
strokes: node.strokes ?? [],
|
||||
effects: node.effects ?? [],
|
||||
backgroundColor: node.backgroundColor ?? null,
|
||||
textStyle: node.style ?? null,
|
||||
styles: node.styles ?? {},
|
||||
cornerRadius
|
||||
};
|
||||
}
|
||||
function buildSelectionSummary(node, components, componentSets) {
|
||||
const componentId = node.componentId ?? null;
|
||||
const componentSetId = node.componentSetId ?? null;
|
||||
const componentMeta = componentId ? components[componentId] ?? null : null;
|
||||
const componentSetMeta = componentSetId ? componentSets[componentSetId] ?? null : null;
|
||||
return {
|
||||
id: node.id,
|
||||
name: node.name,
|
||||
type: node.type,
|
||||
componentId,
|
||||
componentKey: componentMeta?.key ?? null,
|
||||
componentName: componentMeta?.name ?? null,
|
||||
componentSetId,
|
||||
componentSetName: componentSetMeta?.name ?? null,
|
||||
variantProperties: node.variantProperties ?? null
|
||||
};
|
||||
}
|
||||
function computeLayoutHash(layoutTree) {
|
||||
const json = JSON.stringify(layoutTree);
|
||||
return createHash("sha1").update(json).digest("hex");
|
||||
}
|
||||
async function fetchPreviewImage(fileKey, nodeId, token, imageFormat, scale, warnings, verbose) {
|
||||
const format = VALID_IMAGE_FORMATS.includes(imageFormat) ? imageFormat : "png";
|
||||
const scaleClamped = Number.isFinite(scale) && scale > 0 ? scale : 1;
|
||||
log(`Requesting preview image format=${format}, scale=${scaleClamped}`, verbose);
|
||||
const imageResponse = await figmaRequest({
|
||||
path: `/v1/images/${fileKey}`,
|
||||
token,
|
||||
searchParams: { ids: nodeId, format, scale: scaleClamped }
|
||||
});
|
||||
if (!imageResponse.ok) {
|
||||
warnings.push(imageResponse.error?.message ?? "Failed to request preview image.");
|
||||
return null;
|
||||
}
|
||||
const url = imageResponse.data?.images?.[nodeId];
|
||||
if (!url) return null;
|
||||
return { url, format, size: `${scaleClamped}x` };
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
const schemaVersion = toOptionalString(args["schema-version"]) ?? void 0;
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is required but was not provided."));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input: { fileKey: null, nodeId: null, includeImages: false, imageFormat: "png", scale: 1 },
|
||||
warnings,
|
||||
errors,
|
||||
schemaVersion,
|
||||
data: {}
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const urlInput = toOptionalString(args.url) ?? toOptionalString(args.u);
|
||||
let fileKey = toOptionalString(args["file-key"]) ?? void 0;
|
||||
let nodeId = ensureNodeId(toOptionalString(args["node-id"]));
|
||||
if (urlInput) {
|
||||
const parsed = parseFigmaUrl(urlInput);
|
||||
fileKey = fileKey || parsed.fileKey || void 0;
|
||||
nodeId = nodeId || parsed.nodeId;
|
||||
}
|
||||
const includeImages = args["include-images"] !== "false";
|
||||
const imageFormatInput = String(args["image-format"] ?? "png").toLowerCase();
|
||||
const imageFormat = VALID_IMAGE_FORMATS.includes(imageFormatInput) ? imageFormatInput : "png";
|
||||
const scaleInput = Number(args.scale ?? 1);
|
||||
const imageScale = Number.isFinite(scaleInput) && scaleInput > 0 ? scaleInput : 1;
|
||||
const input = {
|
||||
fileKey: fileKey ?? null,
|
||||
nodeId: nodeId ?? null,
|
||||
includeImages,
|
||||
imageFormat,
|
||||
scale: imageScale
|
||||
};
|
||||
if (!fileKey) {
|
||||
errors.push(createError("INPUT_INVALID", "A valid Figma file key is required (--file-key or --url)."));
|
||||
}
|
||||
if (!nodeId) {
|
||||
errors.push(createError("INPUT_INVALID", "A valid Figma node id is required (--node-id or --url with node-id)."));
|
||||
}
|
||||
if (errors.length) {
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const resolvedFileKey = fileKey;
|
||||
const resolvedNodeId = nodeId;
|
||||
log(`Fetching node ${resolvedNodeId} from file ${resolvedFileKey}`, verbose);
|
||||
const nodeResponse = await figmaRequest({
|
||||
path: `/v1/files/${resolvedFileKey}/nodes`,
|
||||
token,
|
||||
searchParams: { ids: resolvedNodeId }
|
||||
});
|
||||
if (!nodeResponse.ok) {
|
||||
errors.push(nodeResponse.error ?? createError("INTERNAL", "Failed to fetch node data."));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
warnings,
|
||||
errors,
|
||||
rateLimit: nodeResponse.rateLimit ?? void 0,
|
||||
data: {},
|
||||
schemaVersion
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const nodePayload = nodeResponse.data ?? {};
|
||||
const nodesMap = nodePayload.nodes ?? {};
|
||||
const nodeWrapper = nodesMap[resolvedNodeId];
|
||||
if (!nodeWrapper || !nodeWrapper.document) {
|
||||
errors.push(createError("FIGMA_NOT_FOUND", `Node ${resolvedNodeId} was not found in file ${resolvedFileKey}.`));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: nodeResponse.rateLimit ?? void 0, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const node = nodeWrapper.document;
|
||||
const components = nodeWrapper.components ?? {};
|
||||
const componentSets = nodeWrapper.componentSets ?? {};
|
||||
const selectionSummary = buildSelectionSummary(node, components, componentSets);
|
||||
const layoutTree = mapLayoutNode(node);
|
||||
const styleTokens = buildStyleTokens(node);
|
||||
const layoutHash = computeLayoutHash(layoutTree);
|
||||
let preview = null;
|
||||
if (includeImages) {
|
||||
preview = await fetchPreviewImage(
|
||||
resolvedFileKey,
|
||||
resolvedNodeId,
|
||||
token,
|
||||
imageFormat,
|
||||
imageScale,
|
||||
warnings,
|
||||
verbose
|
||||
);
|
||||
}
|
||||
const data = {
|
||||
file: {
|
||||
key: resolvedFileKey,
|
||||
name: nodePayload?.name ?? null,
|
||||
lastModified: nodePayload?.lastModified ?? null
|
||||
},
|
||||
selectionSummary,
|
||||
layoutTree,
|
||||
styleTokens,
|
||||
layoutHash,
|
||||
images: preview ? { preview } : null
|
||||
};
|
||||
const envelope = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
data,
|
||||
warnings,
|
||||
errors,
|
||||
rateLimit: nodeResponse.rateLimit ?? void 0,
|
||||
schemaVersion
|
||||
});
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input: { fileKey: null, nodeId: null, includeImages: false, imageFormat: "png", scale: 1 },
|
||||
errors: [createError("INTERNAL", message, { stack: error instanceof Error ? error.stack : void 0 })],
|
||||
data: {}
|
||||
});
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2dldC1kZXNpZ24tY29udGV4dC50cyIsICIuLi9zcmMvX3V0aWxzL2NsaS1hcmdzLnRzIiwgIi4uL3NyYy9fdXRpbHMvY29uZmlnLnRzIiwgIi4uL3NyYy9fdXRpbHMvZW52ZWxvcGUudHMiLCAiLi4vc3JjL191dGlscy9lcnJvcnMudHMiLCAiLi4vc3JjL191dGlscy9odHRwLWNsaWVudC50cyIsICIuLi9zcmMvX3V0aWxzL3VybC1wYXJzZS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiIyEvdXNyL2Jpbi9lbnYgbm9kZVxuXG5pbXBvcnQgeyBjcmVhdGVIYXNoIH0gZnJvbSAnbm9kZTpjcnlwdG8nXG5pbXBvcnQgeyBwYXJzZUFyZ3MsIHR5cGUgQ2xpQXJncyB9IGZyb20gJy4vX3V0aWxzL2NsaS1hcmdzLnRzJ1xuaW1wb3J0IHsgY3JlYXRlRW52ZWxvcGUsIHR5cGUgVG9vbEVudmVsb3BlIH0gZnJvbSAnLi9fdXRpbHMvZW52ZWxvcGUudHMnXG5pbXBvcnQgeyBjcmVhdGVFcnJvciwgZ2V0RXhpdENvZGUsIHR5cGUgVG9vbEVycm9yIH0gZnJvbSAnLi9fdXRpbHMvZXJyb3JzLnRzJ1xuaW1wb3J0IHsgZmlnbWFSZXF1ZXN0IH0gZnJvbSAnLi9fdXRpbHMvaHR0cC1jbGllbnQudHMnXG5pbXBvcnQgeyBwYXJzZUZpZ21hVXJsLCBlbnN1cmVOb2RlSWQgfSBmcm9tICcuL191dGlscy91cmwtcGFyc2UudHMnXG5cbmNvbnN0IFRPT0xfTkFNRSA9ICdnZXQtZGVzaWduLWNvbnRleHQnXG5jb25zdCBWQUxJRF9JTUFHRV9GT1JNQVRTID0gWydwbmcnLCAnanBnJywgJ2pwZWcnLCAnc3ZnJ11cblxudHlwZSBFbXB0eURhdGEgPSBSZWNvcmQ8c3RyaW5nLCBuZXZlcj5cblxuaW50ZXJmYWNlIFRvb2xJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+IHtcbiAgZmlsZUtleTogc3RyaW5nIHwgbnVsbFxuICBub2RlSWQ6IHN0cmluZyB8IG51bGxcbiAgaW5jbHVkZUltYWdlczogYm9vbGVhblxuICBpbWFnZUZvcm1hdDogc3RyaW5nXG4gIHNjYWxlOiBudW1iZXJcbn1cblxuaW50ZXJmYWNlIERlc2lnbkNvbnRleHREYXRhIHtcbiAgZmlsZToge1xuICAgIGtleTogc3RyaW5nXG4gICAgbmFtZTogc3RyaW5nIHwgbnVsbFxuICAgIGxhc3RNb2RpZmllZDogc3RyaW5nIHwgbnVsbFxuICB9XG4gIHNlbGVjdGlvblN1bW1hcnk6IFNlbGVjdGlvblN1bW1hcnlcbiAgbGF5b3V0VHJlZTogTGF5b3V0Tm9kZVxuICBzdHlsZVRva2VuczogU3R5bGVUb2tlbnNcbiAgbGF5b3V0SGFzaDogc3RyaW5nIHwgbnVsbFxuICBpbWFnZXM6IHsgcHJldmlldzogUHJldmlld0ltYWdlIH0gfCBudWxsXG59XG5cbmludGVyZmFjZSBGaWdtYUNvbXBvbmVudE1ldGEge1xuICBrZXk/OiBzdHJpbmdcbiAgbmFtZT86IHN0cmluZ1xuICBkZXNjcmlwdGlvbj86IHN0cmluZ1xufVxuXG5pbnRlcmZhY2UgRmlnbWFDb21wb25lbnRTZXRNZXRhIHtcbiAgbmFtZT86IHN0cmluZ1xuICBjb21wb25lbnRTZXRQcm9wZXJ0aWVzPzogUmVjb3JkPHN0cmluZywgdW5rbm93bj5cbn1cblxuaW50ZXJmYWNlIEZpZ21hTm9kZSB7XG4gIGlkOiBzdHJpbmdcbiAgbmFtZT86IHN0cmluZ1xuICB0eXBlPzogc3RyaW5nXG4gIGNvbXBvbmVudElkPzogc3RyaW5nXG4gIGNvbXBvbmVudFNldElkPzogc3RyaW5nXG4gIHZhcmlhbnRQcm9wZXJ0aWVzPzogUmVjb3JkPHN0cmluZywgdW5rbm93bj5cbiAgYWJzb2x1dGVCb3VuZGluZ0JveD86IHsgeD86IG51bWJlcjsgeT86IG51bWJlcjsgd2lkdGg/OiBudW1iZXI7IGhlaWdodD86IG51bWJlciB9XG4gIGNoaWxkcmVuPzogRmlnbWFOb2RlW11cbiAgdmlzaWJsZT86IGJvb2xlYW5cbiAgcm90YXRpb24/OiBudW1iZXJcbiAgY2xpcHNDb250ZW50PzogYm9vbGVhblxuICBjaGFyYWN0ZXJzPzogc3RyaW5nXG4gIGZpbGxzPzogdW5rbm93bltdXG4gIHN0cm9rZXM/OiB1bmtub3duW11cbiAgZWZmZWN0cz86IHVua25vd25bXVxuICBzdHlsZT86IFJlY29yZDxzdHJpbmcsIHVua25vd24+XG4gIHN0eWxlcz86IFJlY29yZDxzdHJpbmcsIHVua25vd24+XG4gIGJhY2tncm91bmRDb2xvcj86IFJlY29yZDxzdHJpbmcsIHVua25vd24+XG4gIGNvcm5lclJhZGl1cz86IG51bWJlclxuICByZWN0YW5nbGVDb3JuZXJSYWRpaT86IG51bWJlcltdXG59XG5cbmludGVyZmFjZSBOb2RlV3JhcHBlciB7XG4gIGRvY3VtZW50PzogRmlnbWFOb2RlXG4gIGNvbXBvbmVudHM/OiBSZWNvcmQ8c3RyaW5nLCBGaWdtYUNvbXBvbmVudE1ldGE+XG4gIGNvbXBvbmVudFNldHM/OiBSZWNvcmQ8c3RyaW5nLCBGaWdtYUNvbXBvbmVudFNldE1ldGE+XG59XG5cbmludGVyZmFjZSBOb2Rlc1Jlc3BvbnNlIHtcbiAgbmFtZT86IHN0cmluZ1xuICBsYXN0TW9kaWZpZWQ/OiBzdHJpbmdcbiAgbm9kZXM/OiBSZWNvcmQ8c3RyaW5nLCBOb2RlV3JhcHBlcj5cbn1cblxuaW50ZXJmYWNlIEltYWdlUmVzcG9uc2Uge1xuICBpbWFnZXM/OiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+XG59XG5cbmludGVyZmFjZSBTZWxlY3Rpb25TdW1tYXJ5IHtcbiAgaWQ6IHN0cmluZ1xuICBuYW1lPzogc3RyaW5nXG4gIHR5cGU/OiBzdHJpbmdcbiAgY29tcG9uZW50SWQ/OiBzdHJpbmcgfCBudWxsXG4gIGNvbXBvbmVudEtleT86IHN0cmluZyB8IG51bGxcbiAgY29tcG9uZW50TmFtZT86IHN0cmluZyB8IG51bGxcbiAgY29tcG9uZW50U2V0SWQ/OiBzdHJpbmcgfCBudWxsXG4gIGNvbXBvbmVudFNldE5hbWU/OiBzdHJpbmcgfCBudWxsXG4gIHZhcmlhbnRQcm9wZXJ0aWVzPzogUmVjb3JkPHN0cmluZywgdW5rbm93bj4gfCBudWxsXG59XG5cbmludGVyZmFjZSBMYXlvdXROb2RlIHtcbiAgaWQ6IHN0cmluZ1xuICBuYW1lPzogc3RyaW5nXG4gIHR5cGU/OiBzdHJpbmdcbiAgdmlzaWJsZTogYm9vbGVhblxuICBsYXlvdXQ6IHsgeDogbnVtYmVyOyB5OiBudW1iZXI7IHdpZHRoOiBudW1iZXI7IGhlaWdodDogbnVtYmVyIH0gfCBudWxsXG4gIHJvdGF0aW9uOiBudW1iZXJcbiAgY2xpcHNDb250ZW50OiBib29sZWFuXG4gIGNoYXJhY3RlcnM6IHN0cmluZyB8IG51bGxcbiAgZmlsbHM6IHVua25vd25bXVxuICBzdHJva2VzOiB1bmtub3duW11cbiAgZWZmZWN0czogdW5rbm93bltdXG4gIHRhaWx3aW5kU3VnZ2VzdGlvbjogbnVsbFxuICBjaGlsZHJlbjogTGF5b3V0Tm9kZVtdXG59XG5cbmludGVyZmFjZSBTdHlsZVRva2VucyB7XG4gIGZpbGxzOiB1bmtub3duW11cbiAgc3Ryb2tlczogdW5rbm93bltdXG4gIGVmZmVjdHM6IHVua25vd25bXVxuICBiYWNrZ3JvdW5kQ29sb3I6IFJlY29yZDxzdHJpbmcsIHVua25vd24+IHwgbnVsbFxuICB0ZXh0U3R5bGU6IFJlY29yZDxzdHJpbmcsIHVua25vd24+IHwgbnVsbFxuICBzdHlsZXM6IFJlY29yZDxzdHJpbmcsIHVua25vd24+XG4gIGNvcm5lclJhZGl1czogbnVtYmVyIHwgbnVtYmVyW10gfCBudWxsXG59XG5cbmludGVyZmFjZSBQcmV2aWV3SW1hZ2Uge1xuICB1cmw6IHN0cmluZ1xuICBmb3JtYXQ6IHN0cmluZ1xuICBzaXplOiBzdHJpbmdcbn1cblxuZnVuY3Rpb24gbG9nKG1lc3NhZ2U6IHN0cmluZywgdmVyYm9zZTogYm9vbGVhbik6IHZvaWQge1xuICBpZiAodmVyYm9zZSkge1xuICAgIHByb2Nlc3Muc3RkZXJyLndyaXRlKGBbJHtUT09MX05BTUV9XSAke21lc3NhZ2V9XFxuYClcbiAgfVxufVxuXG5mdW5jdGlvbiB0b09wdGlvbmFsU3RyaW5nKHZhbHVlOiBDbGlBcmdzW3N0cmluZ10pOiBzdHJpbmcgfCBudWxsIHtcbiAgcmV0dXJuIHR5cGVvZiB2YWx1ZSA9PT0gJ3N0cmluZycgJiYgdmFsd
Line truncated
|
||||
Executable
+469
@@ -0,0 +1,469 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/url-parse.ts
|
||||
var FILE_KEY_REGEX = /figma\.com\/(?:file|design)\/([A-Za-z0-9]+)\//i;
|
||||
function parseFigmaUrl(input) {
|
||||
if (!input) return { fileKey: null, nodeId: null };
|
||||
try {
|
||||
const url = new URL(input);
|
||||
const match = url.href.match(FILE_KEY_REGEX);
|
||||
const fileKey = match ? match[1] : null;
|
||||
const nodeParam = url.searchParams.get("node-id");
|
||||
const nodeId = nodeParam ? ensureNodeId(nodeParam) : null;
|
||||
return { fileKey, nodeId };
|
||||
} catch {
|
||||
return { fileKey: null, nodeId: null };
|
||||
}
|
||||
}
|
||||
function ensureNodeId(value) {
|
||||
if (!value) return null;
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (decoded.includes(":")) return decoded;
|
||||
if (/^[0-9]+-[0-9]+$/.test(decoded)) {
|
||||
const [left, right] = decoded.split("-", 2);
|
||||
return `${left}:${right}`;
|
||||
}
|
||||
return decoded;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-metadata.ts
|
||||
var TOOL_NAME = "get-metadata";
|
||||
function log(message, verbose) {
|
||||
if (verbose) {
|
||||
process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
}
|
||||
function toOptionalString(value) {
|
||||
return typeof value === "string" && value.length > 0 ? value : null;
|
||||
}
|
||||
function exitWithEnvelope(envelope, errors = []) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
function mapNode(node, index = 0, parentId = null) {
|
||||
const children = Array.isArray(node.children) ? node.children.map((child, idx) => mapNode(child, idx, node.id)) : [];
|
||||
return {
|
||||
id: node.id,
|
||||
name: node.name,
|
||||
type: node.type,
|
||||
visible: node.visible ?? true,
|
||||
locked: node.locked ?? false,
|
||||
index,
|
||||
parentId,
|
||||
characters: node.characters ?? null,
|
||||
blendMode: node.blendMode ?? null,
|
||||
opacity: node.opacity ?? 1,
|
||||
isMask: node.isMask ?? false,
|
||||
relativeTransform: node.relativeTransform ?? null,
|
||||
absoluteBoundingBox: node.absoluteBoundingBox ?? null,
|
||||
size: node.size ?? null,
|
||||
fills: node.fills ?? [],
|
||||
strokes: node.strokes ?? [],
|
||||
strokeWeight: node.strokeWeight ?? null,
|
||||
strokeAlign: node.strokeAlign ?? null,
|
||||
effects: node.effects ?? [],
|
||||
constraints: node.constraints ?? null,
|
||||
layoutAlign: node.layoutAlign ?? null,
|
||||
layoutGrow: node.layoutGrow ?? null,
|
||||
layoutMode: node.layoutMode ?? null,
|
||||
primaryAxisSizingMode: node.primaryAxisSizingMode ?? null,
|
||||
counterAxisSizingMode: node.counterAxisSizingMode ?? null,
|
||||
primaryAxisAlignItems: node.primaryAxisAlignItems ?? null,
|
||||
counterAxisAlignItems: node.counterAxisAlignItems ?? null,
|
||||
itemSpacing: node.itemSpacing ?? null,
|
||||
paddingLeft: node.paddingLeft ?? null,
|
||||
paddingRight: node.paddingRight ?? null,
|
||||
paddingTop: node.paddingTop ?? null,
|
||||
paddingBottom: node.paddingBottom ?? null,
|
||||
clipsContent: node.clipsContent ?? false,
|
||||
layoutGrids: node.layoutGrids ?? [],
|
||||
exportSettings: node.exportSettings ?? [],
|
||||
transitionNodeID: node.transitionNodeID ?? null,
|
||||
overlayPositionType: node.overlayPositionType ?? null,
|
||||
overlayRelativePosition: node.overlayRelativePosition ?? null,
|
||||
children
|
||||
};
|
||||
}
|
||||
function escapeXml(value) {
|
||||
return value.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/\"/g, """).replace(/'/g, "'");
|
||||
}
|
||||
function nodeToXml(node) {
|
||||
const attrs = [
|
||||
`id="${escapeXml(node.id)}"`,
|
||||
node.type ? `type="${escapeXml(node.type)}"` : null,
|
||||
node.name ? `name="${escapeXml(node.name)}"` : null,
|
||||
node.visible === false ? 'visible="false"' : null,
|
||||
node.locked ? 'locked="true"' : null,
|
||||
node.parentId ? `parentId="${escapeXml(node.parentId)}"` : null,
|
||||
node.absoluteBoundingBox ? `x="${node.absoluteBoundingBox.x ?? 0}" y="${node.absoluteBoundingBox.y ?? 0}" width="${node.absoluteBoundingBox.width ?? 0}" height="${node.absoluteBoundingBox.height ?? 0}"` : null
|
||||
].filter(Boolean);
|
||||
const childXml = node.children.map(nodeToXml).join("");
|
||||
return `<node ${attrs.join(" ")}>${childXml}</node>`;
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
const schemaVersion = toOptionalString(args["schema-version"]) ?? void 0;
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is required but was not provided."));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input: { fileKey: null, nodeId: null, format: "json" },
|
||||
warnings,
|
||||
errors,
|
||||
schemaVersion,
|
||||
data: {}
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const urlInput = toOptionalString(args.url) ?? toOptionalString(args.u);
|
||||
let fileKey = toOptionalString(args["file-key"]) ?? void 0;
|
||||
let nodeId = ensureNodeId(toOptionalString(args["node-id"]));
|
||||
if (urlInput) {
|
||||
const parsed = parseFigmaUrl(urlInput);
|
||||
fileKey = fileKey || parsed.fileKey || void 0;
|
||||
nodeId = nodeId || parsed.nodeId;
|
||||
}
|
||||
let format = String(args.format ?? "json").toLowerCase();
|
||||
let outputMode;
|
||||
if (format === "json" || format === "xml" || format === "both") {
|
||||
outputMode = format;
|
||||
} else {
|
||||
warnings.push(`Unknown format "${format}". Defaulting to json.`);
|
||||
outputMode = "json";
|
||||
}
|
||||
const input = {
|
||||
fileKey: fileKey ?? null,
|
||||
nodeId: nodeId ?? null,
|
||||
format: outputMode
|
||||
};
|
||||
if (!fileKey) {
|
||||
errors.push(createError("INPUT_INVALID", "A valid Figma file key is required (--file-key or --url)."));
|
||||
}
|
||||
if (!nodeId) {
|
||||
errors.push(createError("INPUT_INVALID", "A valid Figma node id is required (--node-id or --url with node-id)."));
|
||||
}
|
||||
if (errors.length) {
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
warnings,
|
||||
errors,
|
||||
data: {},
|
||||
schemaVersion
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const resolvedFileKey = fileKey;
|
||||
const resolvedNodeId = nodeId;
|
||||
log(`Fetching metadata for node ${resolvedNodeId} in file ${resolvedFileKey}`, verbose);
|
||||
const nodeResponse = await figmaRequest({
|
||||
path: `/v1/files/${resolvedFileKey}/nodes`,
|
||||
token,
|
||||
searchParams: { ids: resolvedNodeId }
|
||||
});
|
||||
if (!nodeResponse.ok) {
|
||||
errors.push(nodeResponse.error ?? createError("INTERNAL", "Failed to fetch node metadata."));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
warnings,
|
||||
errors,
|
||||
rateLimit: nodeResponse.rateLimit ?? void 0,
|
||||
data: {},
|
||||
schemaVersion
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const nodesMap = nodeResponse.data?.nodes ?? {};
|
||||
const nodeWrapper = nodesMap[resolvedNodeId];
|
||||
if (!nodeWrapper || !nodeWrapper.document) {
|
||||
errors.push(createError("FIGMA_NOT_FOUND", `Node ${resolvedNodeId} was not found in file ${resolvedFileKey}.`));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
warnings,
|
||||
errors,
|
||||
rateLimit: nodeResponse.rateLimit ?? void 0,
|
||||
data: {},
|
||||
schemaVersion
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const rootNode = nodeWrapper.document;
|
||||
const metadataTree = mapNode(rootNode);
|
||||
let xmlDocument;
|
||||
if (outputMode === "xml" || outputMode === "both") {
|
||||
xmlDocument = `<figmaMetadata version="1.0">${nodeToXml(metadataTree)}</figmaMetadata>`;
|
||||
}
|
||||
const data = {
|
||||
file: {
|
||||
key: resolvedFileKey,
|
||||
name: nodeResponse.data?.name ?? null,
|
||||
lastModified: nodeResponse.data?.lastModified ?? null
|
||||
},
|
||||
metadata: metadataTree,
|
||||
xml: xmlDocument
|
||||
};
|
||||
const envelope = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input,
|
||||
data,
|
||||
warnings,
|
||||
errors,
|
||||
rateLimit: nodeResponse.rateLimit ?? void 0,
|
||||
schemaVersion
|
||||
});
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input: { fileKey: null, nodeId: null, format: "json" },
|
||||
errors: [createError("INTERNAL", message, { stack: error instanceof Error ? error.stack : void 0 })],
|
||||
data: {}
|
||||
});
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL191dGlscy9jbGktYXJncy50cyIsICIuLi9zcmMvX3V0aWxzL3VybC1wYXJzZS50cyIsICIuLi9zcmMvX3V0aWxzL2NvbmZpZy50cyIsICIuLi9zcmMvX3V0aWxzL2VudmVsb3BlLnRzIiwgIi4uL3NyYy9fdXRpbHMvZXJyb3JzLnRzIiwgIi4uL3NyYy9fdXRpbHMvaHR0cC1jbGllbnQudHMiLCAiLi4vc3JjL2dldC1tZXRhZGF0YS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiZXhwb3J0IHR5cGUgQ2xpQXJnVmFsdWUgPSBzdHJpbmcgfCBib29sZWFuO1xuXG5leHBvcnQgaW50ZXJmYWNlIENsaUFyZ3Mge1xuICBfOiBzdHJpbmdbXTtcbiAgW2tleTogc3RyaW5nXTogQ2xpQXJnVmFsdWUgfCBzdHJpbmdbXTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlQXJncyhhcmd2OiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndi5zbGljZSgyKSk6IENsaUFyZ3Mge1xuICBjb25zdCBhcmdzOiBDbGlBcmdzID0geyBfOiBbXSB9O1xuXG4gIGZvciAobGV0IGkgPSAwOyBpIDwgYXJndi5sZW5ndGg7IGkgKz0gMSkge1xuICAgIGNvbnN0IGFyZyA9IGFyZ3ZbaV07XG5cbiAgICBpZiAoIWFyZy5zdGFydHNXaXRoKCctJykgfHwgYXJnID09PSAnLScpIHtcbiAgICAgIGFyZ3MuXy5wdXNoKGFyZyk7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG5cbiAgICBpZiAoYXJnID09PSAnLS0nKSB7XG4gICAgICBjb25zdCByZW1haW5pbmcgPSBhcmd2LnNsaWNlKGkgKyAxKTtcbiAgICAgIGFyZ3MuXy5wdXNoKC4uLnJlbWFpbmluZyk7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBjb25zdCBbcmF3S2V5LCBpbmxpbmVWYWx1ZV0gPSBhcmcuc3BsaXQoJz0nLCAyKTtcbiAgICBjb25zdCBub3JtYWxpc2VkS2V5ID0gcmF3S2V5LnJlcGxhY2UoL14tKy8sICcnKTtcblxuICAgIGxldCB2YWx1ZTogQ2xpQXJnVmFsdWU7XG4gICAgaWYgKGlubGluZVZhbHVlICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIHZhbHVlID0gaW5saW5lVmFsdWU7XG4gICAgfSBlbHNlIHtcbiAgICAgIGNvbnN0IG5leHQgPSBhcmd2W2kgKyAxXTtcbiAgICAgIGlmIChuZXh0ICE9PSB1bmRlZmluZWQgJiYgIW5leHQuc3RhcnRzV2l0aCgnLScpKSB7XG4gICAgICAgIHZhbHVlID0gbmV4dDtcbiAgICAgICAgaSArPSAxO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgdmFsdWUgPSB0cnVlO1xuICAgICAgfVxuICAgIH1cblxuICAgIGFyZ3Nbbm9ybWFsaXNlZEtleV0gPSB2YWx1ZTtcbiAgfVxuXG4gIHJldHVybiBhcmdzO1xufVxuXG4iLCAiY29uc3QgRklMRV9LRVlfUkVHRVggPSAvZmlnbWFcXC5jb21cXC8oPzpmaWxlfGRlc2lnbilcXC8oW0EtWmEtejAtOV0rKVxcLy9pO1xuXG5leHBvcnQgaW50ZXJmYWNlIFBhcnNlZEZpZ21hVXJsIHtcbiAgZmlsZUtleTogc3RyaW5nIHwgbnVsbDtcbiAgbm9kZUlkOiBzdHJpbmcgfCBudWxsO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VGaWdtYVVybChpbnB1dDogc3RyaW5nIHwgbnVsbCB8IHVuZGVmaW5lZCk6IFBhcnNlZEZpZ21hVXJsIHtcbiAgaWYgKCFpbnB1dCkgcmV0dXJuIHsgZmlsZUtleTogbnVsbCwgbm9kZUlkOiBudWxsIH07XG4gIHRyeSB7XG4gICAgY29uc3QgdXJsID0gbmV3IFVSTChpbnB1dCk7XG4gICAgY29uc3QgbWF0Y2ggPSB1cmwuaHJlZi5tYXRjaChGSUxFX0tFWV9SRUdFWCk7XG4gICAgY29uc3QgZmlsZUtleSA9IG1hdGNoID8gbWF0Y2hbMV0gOiBudWxsO1xuICAgIGNvbnN0IG5vZGVQYXJhbSA9IHVybC5zZWFyY2hQYXJhbXMuZ2V0KCdub2RlLWlkJyk7XG4gICAgY29uc3Qgbm9kZUlkID0gbm9kZVBhcmFtID8gZW5zdXJlTm9kZUlkKG5vZGVQYXJhbSkgOiBudWxsO1xuICAgIHJldHVybiB7IGZpbGVLZXksIG5vZGVJZCB9O1xuICB9IGNhdGNoIHtcbiAgICByZXR1cm4geyBmaWxlS2V5OiBudWxsLCBub2RlSWQ6IG51bGwgfTtcbiAgfVxufVxuXG5leHBvcnQgZnVuY3Rpb24gZW5zdXJlTm9kZUlkKHZhbHVlOiBzdHJpbmcgfCBudWxsIHwgdW5kZWZpbmVkKTogc3RyaW5nIHwgbnVsbCB7XG4gIGlmICghdmFsdWUpIHJldHVybiBudWxsO1xuICBjb25zdCBkZWNvZGVkID0gZGVjb2RlVVJJQ29tcG9uZW50KHZhbHVlKTtcbiAgaWYgKGRlY29kZWQuaW5jbHVkZXMoJzonKSkgcmV0dXJuIGRlY29kZWQ7XG4gIGlmICgvXlswLTldKy1bMC05XSskLy50ZXN0KGRlY29kZWQpKSB7XG4gICAgY29uc3QgW2xlZnQsIHJpZ2h0XSA9IGRlY29kZWQuc3BsaXQoJy0nLCAyKTtcbiAgICByZXR1cm4gYCR7bGVmdH06JHtyaWdodH1gO1xuICB9XG4gIHJldHVybiBkZWNvZGVkO1xufVxuXG4iLCAiZXhwb3J0IGRlZmF1bHQge1xuICBzY2hlbWFWZXJzaW9uOiAnMS4wLjAnLFxuICBzb3VyY2U6ICdhZ2VudGljLWNvZGluZy10ZW1wbGF0ZXMvZmlnbWEtdG9vbHMnLFxuICBodHRwOiB7XG4gICAgbWF4QXR0ZW1wdHM6IDUsXG4gICAgaW5pdGlhbERlbGF5TXM6IDI1MCxcbiAgfSxcbn0gYXMgY29uc3Q7XG5cbiIsICJpbXBvcnQgY29uZmlnIGZyb20gJy4vY29uZmlnLnRzJztcbmltcG9ydCB0eXBlIHsgVG9vbEVycm9yIH0gZnJvbSAnLi9lcnJvcnMudHMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIFJhdGVMaW1pdE1ldGEge1xuICByZW1haW5pbmc6IG51bWJlciB8IG51bGw7XG4gIHJlc2V0QXQ6IHN0cmluZyB8IG51bGw7XG4gIGF0dGVtcHRzOiBudW1iZXI7XG4gIGxhc3RXYWl0TXM6IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUb29sRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4sXG4gIFREYXRhID0gdW5rbm93blxuPiB7XG4gIHNjaGVtYVZlcnNpb246IHN0cmluZztcbiAgdG9vbDogc3RyaW5nO1xuICBpbnB1dDogVElucHV0O1xuICBtZXRhOiB7XG4gICAgZ2VuZXJhdGVkQXQ6IHN0cmluZztcbiAgICBzb3VyY2U6IHN0cmluZztcbiAgICByYXRlTGltaXQ6IFJhdGVMaW1pdE1ldGE7XG4gIH07XG4gIGRhdGE6IFREYXRhO1xuICB3YXJuaW5nczogc3RyaW5nW107XG4gIGVycm9yczogVG9vbEVycm9yW107XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlRW52ZWxvcGVPcHRpb25zPFxuICBUSW5wdXQgZXh0ZW5kcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiA9IFJlY29yZDxzdHJpbmcsIHVua25vd24+LFxuICBURGF0YSA9IHVua25vd25cbj4ge1xuICB0b29sOiBzdHJpbmc7XG4gIGlucHV0PzogVElucHV0O1xuICBkYXRhPzogVERhdGE7XG4gIHdhcm5pbmdzPzogc3RyaW5nW107XG4gIGVycm9ycz86IFRvb2xFcnJvcltdO1xuICByYXRlTGltaXQ/OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+O1xuICBzY2hlbWFWZXJzaW9uPzogc3RyaW5nO1xufVxuXG5mdW5jdGlvbiBidWlsZFJhdGVMaW1pdE1ldGEocmF0ZUxpbWl0OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+ID0ge30pOiBSYXRlTGltaXRNZXRhIHtcbiAgcmV0dXJuIHtcbiAgICByZW1haW5pbmc6IHJhdGVMaW1pdC5yZW1haW5pbmcgPz8gbnVsbCxcbiAgICByZXNldEF0OiByYXRlTGltaXQucmVzZXRBdCA/PyBudWxsLFxuICAgIGF0dGVtcHRzOiByYXRlTGltaXQuYXR0ZW1wdHMgPz8gMSxcbiAgICBsYXN0V2FpdE1zOiByYXRlTGltaXQubGFzdFdhaXRNcyA/PyAwLFxuICB9O1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsI
Line truncated
|
||||
Executable
+387
@@ -0,0 +1,387 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-screenshot.ts
|
||||
import { mkdir, writeFile } from "node:fs/promises";
|
||||
import path from "node:path";
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/url-parse.ts
|
||||
var FILE_KEY_REGEX = /figma\.com\/(?:file|design)\/([A-Za-z0-9]+)\//i;
|
||||
function parseFigmaUrl(input) {
|
||||
if (!input) return { fileKey: null, nodeId: null };
|
||||
try {
|
||||
const url = new URL(input);
|
||||
const match = url.href.match(FILE_KEY_REGEX);
|
||||
const fileKey = match ? match[1] : null;
|
||||
const nodeParam = url.searchParams.get("node-id");
|
||||
const nodeId = nodeParam ? ensureNodeId(nodeParam) : null;
|
||||
return { fileKey, nodeId };
|
||||
} catch {
|
||||
return { fileKey: null, nodeId: null };
|
||||
}
|
||||
}
|
||||
function ensureNodeId(value) {
|
||||
if (!value) return null;
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (decoded.includes(":")) return decoded;
|
||||
if (/^[0-9]+-[0-9]+$/.test(decoded)) {
|
||||
const [left, right] = decoded.split("-", 2);
|
||||
return `${left}:${right}`;
|
||||
}
|
||||
return decoded;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path: path2,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path2, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-screenshot.ts
|
||||
var TOOL_NAME = "get-screenshot";
|
||||
var SUPPORTED_FORMATS = ["png", "jpg", "jpeg", "svg"];
|
||||
var SCREENSHOT_DIR = ".tmp/figma-tools/screenshots";
|
||||
function log(message, verbose) {
|
||||
if (verbose) process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
function toOptionalString(value) {
|
||||
return typeof value === "string" && value.length > 0 ? value : null;
|
||||
}
|
||||
function exitWithEnvelope(envelope, errors = []) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
async function ensureDirExists(dirPath) {
|
||||
await mkdir(dirPath, { recursive: true });
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
const schemaVersion = toOptionalString(args["schema-version"]) ?? void 0;
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is required but was not provided."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input: { fileKey: null, nodeId: null, format: "jpg", scale: 1, bounds: "selection", background: "canvas" }, warnings, errors, schemaVersion, data: {} });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const urlInput = toOptionalString(args.url) ?? toOptionalString(args.u);
|
||||
let fileKey = toOptionalString(args["file-key"]) ?? void 0;
|
||||
let nodeId = ensureNodeId(toOptionalString(args["node-id"]));
|
||||
if (urlInput) {
|
||||
const parsed = parseFigmaUrl(urlInput);
|
||||
fileKey = fileKey || parsed.fileKey || void 0;
|
||||
nodeId = nodeId || parsed.nodeId;
|
||||
}
|
||||
if (!fileKey) errors.push(createError("INPUT_INVALID", "A valid Figma file key is required (--file-key or --url)."));
|
||||
if (!nodeId) errors.push(createError("INPUT_INVALID", "A valid Figma node id is required (--node-id or --url with node-id)."));
|
||||
let format = String(args.format ?? "jpg").toLowerCase();
|
||||
if (!SUPPORTED_FORMATS.includes(format)) {
|
||||
warnings.push(`Unsupported format "${format}". Falling back to jpg.`);
|
||||
format = "jpg";
|
||||
}
|
||||
if (format === "jpeg") format = "jpg";
|
||||
const scaleInput = Number(args.scale ?? 1);
|
||||
const scale = Number.isFinite(scaleInput) ? Math.min(Math.max(scaleInput, 0.01), 1) : 1;
|
||||
const boundsInput = String(args.bounds ?? "selection").toLowerCase();
|
||||
const bounds = ["selection", "frame", "node"].includes(boundsInput) ? boundsInput : "selection";
|
||||
const useAbsoluteBounds = bounds === "frame";
|
||||
const backgroundInput = String(args.background ?? "canvas").toLowerCase();
|
||||
let backgroundParam;
|
||||
if (backgroundInput === "transparent") backgroundParam = "00000000";
|
||||
else if (/^[0-9a-f]{6,8}$/i.test(backgroundInput)) {
|
||||
const value = backgroundInput.toUpperCase();
|
||||
backgroundParam = value.length >= 6 ? value.slice(0, 8).padEnd(8, "F") : void 0;
|
||||
} else if (backgroundInput.startsWith("#")) backgroundParam = backgroundInput.replace("#", "").slice(0, 8).padEnd(8, "F");
|
||||
const input = { fileKey: fileKey ?? null, nodeId: nodeId ?? null, format, scale, bounds, background: backgroundInput };
|
||||
if (errors.length) {
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const resolvedFileKey = fileKey;
|
||||
const resolvedNodeId = nodeId;
|
||||
log(`Requesting image for ${resolvedNodeId} (${format}, scale ${scale})`, verbose);
|
||||
const imageResponse = await figmaRequest({
|
||||
path: `/v1/images/${resolvedFileKey}`,
|
||||
token,
|
||||
searchParams: { ids: resolvedNodeId, format, scale, use_absolute_bounds: useAbsoluteBounds ? "true" : void 0, background: backgroundParam }
|
||||
});
|
||||
if (!imageResponse.ok) {
|
||||
errors.push(imageResponse.error ?? createError("INTERNAL", "Failed to request image export."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: imageResponse.rateLimit ?? void 0, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const imageUrl = imageResponse.data?.images?.[resolvedNodeId];
|
||||
if (!imageUrl) {
|
||||
errors.push(createError("FIGMA_NOT_FOUND", "Figma did not return an image URL for the requested node."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: imageResponse.rateLimit ?? void 0, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
log("Downloading image", verbose);
|
||||
let buffer = null;
|
||||
let contentType = null;
|
||||
try {
|
||||
const res = await fetch(imageUrl);
|
||||
if (!res.ok) errors.push(createError("NETWORK", `Unable to download image (status ${res.status}).`));
|
||||
else {
|
||||
contentType = res.headers.get("content-type");
|
||||
buffer = format === "svg" ? Buffer.from(await res.text()) : Buffer.from(await res.arrayBuffer());
|
||||
}
|
||||
} catch (error) {
|
||||
const message = error instanceof Error ? error.message : "Unknown download error";
|
||||
errors.push(createError("NETWORK", `Unable to download image: ${message}`));
|
||||
}
|
||||
if (!buffer || errors.length) {
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: imageResponse.rateLimit ?? void 0, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const sanitizedNodeId = resolvedNodeId.replace(/[^a-zA-Z0-9-_]/g, "_");
|
||||
const baseDir = path.resolve(SCREENSHOT_DIR, resolvedFileKey);
|
||||
await ensureDirExists(baseDir);
|
||||
const extension = format === "jpg" ? "jpg" : format;
|
||||
const filePath = path.join(baseDir, `${sanitizedNodeId}.${extension}`);
|
||||
await writeFile(filePath, buffer);
|
||||
const data = {
|
||||
file: { key: resolvedFileKey, nodeId: resolvedNodeId },
|
||||
screenshot: { path: filePath, url: imageUrl, format: extension, scale, bounds, background: backgroundInput, contentType }
|
||||
};
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input, data, warnings, errors, rateLimit: imageResponse.rateLimit ?? void 0, schemaVersion });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input: { fileKey: null, nodeId: null, format: "jpg", scale: 1, bounds: "selection", background: "canvas" }, errors: [createError("INTERNAL", message, { stack: error instanceof Error ? error.stack : void 0 })], data: {} });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2dldC1zY3JlZW5zaG90LnRzIiwgIi4uL3NyYy9fdXRpbHMvY2xpLWFyZ3MudHMiLCAiLi4vc3JjL191dGlscy91cmwtcGFyc2UudHMiLCAiLi4vc3JjL191dGlscy9jb25maWcudHMiLCAiLi4vc3JjL191dGlscy9lbnZlbG9wZS50cyIsICIuLi9zcmMvX3V0aWxzL2Vycm9ycy50cyIsICIuLi9zcmMvX3V0aWxzL2h0dHAtY2xpZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIjIS91c3IvYmluL2VudiBub2RlXG5cbmltcG9ydCB7IG1rZGlyLCB3cml0ZUZpbGUgfSBmcm9tICdub2RlOmZzL3Byb21pc2VzJ1xuaW1wb3J0IHBhdGggZnJvbSAnbm9kZTpwYXRoJ1xuaW1wb3J0IHsgcGFyc2VBcmdzLCB0eXBlIENsaUFyZ3MgfSBmcm9tICcuL191dGlscy9jbGktYXJncy50cydcbmltcG9ydCB7IHBhcnNlRmlnbWFVcmwsIGVuc3VyZU5vZGVJZCB9IGZyb20gJy4vX3V0aWxzL3VybC1wYXJzZS50cydcbmltcG9ydCB7IGNyZWF0ZUVudmVsb3BlLCB0eXBlIFRvb2xFbnZlbG9wZSB9IGZyb20gJy4vX3V0aWxzL2VudmVsb3BlLnRzJ1xuaW1wb3J0IHsgY3JlYXRlRXJyb3IsIGdldEV4aXRDb2RlLCB0eXBlIFRvb2xFcnJvciB9IGZyb20gJy4vX3V0aWxzL2Vycm9ycy50cydcbmltcG9ydCB7IGZpZ21hUmVxdWVzdCB9IGZyb20gJy4vX3V0aWxzL2h0dHAtY2xpZW50LnRzJ1xuXG5jb25zdCBUT09MX05BTUUgPSAnZ2V0LXNjcmVlbnNob3QnXG5jb25zdCBTVVBQT1JURURfRk9STUFUUyA9IFsncG5nJywgJ2pwZycsICdqcGVnJywgJ3N2ZyddXG5jb25zdCBTQ1JFRU5TSE9UX0RJUiA9ICcudG1wL2ZpZ21hLXRvb2xzL3NjcmVlbnNob3RzJ1xudHlwZSBFbXB0eURhdGEgPSBSZWNvcmQ8c3RyaW5nLCBuZXZlcj5cblxuaW50ZXJmYWNlIFRvb2xJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+IHtcbiAgZmlsZUtleTogc3RyaW5nIHwgbnVsbFxuICBub2RlSWQ6IHN0cmluZyB8IG51bGxcbiAgZm9ybWF0OiBzdHJpbmdcbiAgc2NhbGU6IG51bWJlclxuICBib3VuZHM6IHN0cmluZ1xuICBiYWNrZ3JvdW5kOiBzdHJpbmdcbn1cblxuaW50ZXJmYWNlIEltYWdlRXhwb3J0UmVzcG9uc2UgeyBpbWFnZXM/OiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+IH1cblxuaW50ZXJmYWNlIFNjcmVlbnNob3REYXRhIHtcbiAgZmlsZTogeyBrZXk6IHN0cmluZzsgbm9kZUlkOiBzdHJpbmcgfVxuICBzY3JlZW5zaG90OiB7XG4gICAgcGF0aDogc3RyaW5nXG4gICAgdXJsOiBzdHJpbmdcbiAgICBmb3JtYXQ6IHN0cmluZ1xuICAgIHNjYWxlOiBudW1iZXJcbiAgICBib3VuZHM6IHN0cmluZ1xuICAgIGJhY2tncm91bmQ6IHN0cmluZ1xuICAgIGNvbnRlbnRUeXBlOiBzdHJpbmcgfCBudWxsXG4gIH1cbn1cblxuZnVuY3Rpb24gbG9nKG1lc3NhZ2U6IHN0cmluZywgdmVyYm9zZTogYm9vbGVhbik6IHZvaWQge1xuICBpZiAodmVyYm9zZSkgcHJvY2Vzcy5zdGRlcnIud3JpdGUoYFske1RPT0xfTkFNRX1dICR7bWVzc2FnZX1cXG5gKVxufVxuXG5mdW5jdGlvbiB0b09wdGlvbmFsU3RyaW5nKHZhbHVlOiBDbGlBcmdzW3N0cmluZ10pOiBzdHJpbmcgfCBudWxsIHtcbiAgcmV0dXJuIHR5cGVvZiB2YWx1ZSA9PT0gJ3N0cmluZycgJiYgdmFsdWUubGVuZ3RoID4gMCA/IHZhbHVlIDogbnVsbFxufVxuXG5mdW5jdGlvbiBleGl0V2l0aEVudmVsb3BlKFxuICBlbnZlbG9wZTogVG9vbEVudmVsb3BlPFRvb2xJbnB1dCwgU2NyZWVuc2hvdERhdGEgfCBFbXB0eURhdGE+LFxuICBlcnJvcnM6IFRvb2xFcnJvcltdID0gW11cbik6IG5ldmVyIHtcbiAgcHJvY2Vzcy5zdGRvdXQud3JpdGUoYCR7SlNPTi5zdHJpbmdpZnkoZW52ZWxvcGUsIG51bGwsIDIpfVxcbmApXG4gIHByb2Nlc3MuZXhpdChnZXRFeGl0Q29kZShlcnJvcnMpKVxufVxuXG5hc3luYyBmdW5jdGlvbiBlbnN1cmVEaXJFeGlzdHMoZGlyUGF0aDogc3RyaW5nKTogUHJvbWlzZTx2b2lkPiB7IGF3YWl0IG1rZGlyKGRpclBhdGgsIHsgcmVjdXJzaXZlOiB0cnVlIH0pIH1cblxuYXN5bmMgZnVuY3Rpb24gbWFpbigpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgYXJncyA9IHBhcnNlQXJncygpXG4gIGNvbnN0IHZlcmJvc2UgPSBCb29sZWFuKGFyZ3MudmVyYm9zZSA/PyBhcmdzLnYpXG4gIGNvbnN0IHNjaGVtYVZlcnNpb24gPSB0b09wdGlvbmFsU3RyaW5nKGFyZ3NbJ3NjaGVtYS12ZXJzaW9uJ10pID8/IHVuZGVmaW5lZFxuXG4gIGNvbnN0IHdhcm5pbmdzOiBzdHJpbmdbXSA9IFtdXG4gIGNvbnN0IGVycm9yczogVG9vbEVycm9yW10gPSBbXVxuXG4gIGNvbnN0IHRva2VuID0gcHJvY2Vzcy5lbnYuRklHTUFfQUNDRVNTX1RPS0VOXG4gIGlmICghdG9rZW4gfHwgIXRva2VuLnRyaW0oKSkge1xuICAgIGVycm9ycy5wdXNoKGNyZWF0ZUVycm9yKCdGSUdNQV9BVVRIJywgJ0ZJR01BX0FDQ0VTU19UT0tFTiBpcyByZXF1aXJlZCBidXQgd2FzIG5vdCBwcm92aWRlZC4nKSlcbiAgICBjb25zdCBlbnZlbG9wZSA9IGNyZWF0ZUVudmVsb3BlPFRvb2xJbnB1dCwgRW1wdHlEYXRhPih7IHRvb2w6IFRPT0xfTkFNRSwgaW5wdXQ6IHsgZmlsZUtleTogbnVsbCwgbm9kZUlkOiBudWxsLCBmb3JtYXQ6ICdqcGcnLCBzY2FsZTogMSwgYm91bmRzOiAnc2VsZWN0aW9uJywgYmFja2dyb3VuZDogJ2NhbnZhcycgfSwgd2FybmluZ3MsIGVycm9ycywgc2NoZW1hVmVyc2lvbiwgZGF0YToge30gYXMgRW1wdHlEYXRhIH0pXG4gICAgZXhpdFdpdGhFbnZlbG9wZShlbnZlbG9wZSwgZXJyb3JzKVxuICB9XG5cbiAgY29uc3QgdXJsSW5wdXQgPSB0b09wdGlvbmFsU3RyaW5nKGFyZ3MudXJsKSA/PyB0b09wdGlvbmFsU3RyaW5nKGFyZ3MudSlcbiAgbGV0IGZpbGVLZXkgPSB0b09wdGlvbmFsU3RyaW5nKGFyZ3NbJ2ZpbGUta2V5J10pID8/IHVuZGVmaW5lZFxuICBsZXQgbm9kZUlkID0gZW5zdXJlTm9kZUlkKHRvT3B0aW9uYWxTdHJpbmcoYXJnc1snbm9kZS1pZCddKSlcbiAgaWYgKHVybElucHV0KSB7XG4gICAgY29uc3QgcGFyc2VkID0gcGFyc2VGaWdtYVVybCh1cmxJbnB1dClcbiAgICBmaWxlS2V5ID0gZmlsZUtleSB8fCBwYXJzZWQuZmlsZUtleSB8fCB1bmRlZmluZWRcbiAgICBub2RlSWQgPSBub2RlSWQgfHwgcGFyc2VkLm5vZGVJZFxuICB9XG5cbiAgaWYgKCFmaWxlS2V5KSBlcnJvcnMucHVzaChjcmVhdGVFcnJvcignSU5QVVRfSU5WQUxJRCcsICdBIHZhbGlkIEZpZ21hIGZpbGUga2V5IGlzIHJlcXVpcmVkICgtLWZpbGUta2V5IG9yIC0tdXJsKS4nKSlcbiAgaWYgKCFub2RlSWQpIGVycm9ycy5wdXNoKGNyZWF0ZUVycm9yKCdJTlBVVF9JTlZBTElEJywgJ0EgdmFsaWQgRmlnbWEgbm9kZSBpZCBpcyByZXF1aXJlZCAoLS1ub2RlLWlkIG9yIC0tdXJsIHdpdGggbm9kZS1pZCkuJykpXG5cbiAgbGV0IGZvcm1hdCA9IFN0cmluZyhhcmdzLmZvcm1hdCA/PyAnanBnJykudG9Mb3dlckNhc2UoKVxuICBpZiAoIVNVUFBPUlRFRF9GT1JNQVRTLmluY2x1ZGVzKGZvcm1hdCkpIHsgd2FybmluZ3MucHVzaChgVW5zdXBwb3J0ZWQgZm9ybWF0IFwiJHtmb3JtYXR9XCIuIEZhbGxpbmcgYmFjayB0byBqcGcuYCk7IGZvcm1hdCA9ICdqcGcnIH1cbiAgaWYgKGZvcm1hdCA9PT0gJ2pwZWcnKSBmb3JtYXQgPSAnanBnJ1xuXG4gIGNvbnN0IHNjYWxlSW5wdXQgPSBOdW1iZXIoYXJncy5zY2FsZSA/PyAxKVxuICBjb25zdCBzY2FsZSA9IE51bWJlci5pc0Zpbml0ZShzY2FsZUluc
Line truncated
|
||||
Executable
+404
@@ -0,0 +1,404 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/url-parse.ts
|
||||
var FILE_KEY_REGEX = /figma\.com\/(?:file|design)\/([A-Za-z0-9]+)\//i;
|
||||
function parseFigmaUrl(input) {
|
||||
if (!input) return { fileKey: null, nodeId: null };
|
||||
try {
|
||||
const url = new URL(input);
|
||||
const match = url.href.match(FILE_KEY_REGEX);
|
||||
const fileKey = match ? match[1] : null;
|
||||
const nodeParam = url.searchParams.get("node-id");
|
||||
const nodeId = nodeParam ? ensureNodeId(nodeParam) : null;
|
||||
return { fileKey, nodeId };
|
||||
} catch {
|
||||
return { fileKey: null, nodeId: null };
|
||||
}
|
||||
}
|
||||
function ensureNodeId(value) {
|
||||
if (!value) return null;
|
||||
const decoded = decodeURIComponent(value);
|
||||
if (decoded.includes(":")) return decoded;
|
||||
if (/^[0-9]+-[0-9]+$/.test(decoded)) {
|
||||
const [left, right] = decoded.split("-", 2);
|
||||
return `${left}:${right}`;
|
||||
}
|
||||
return decoded;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/get-variable-definitions.ts
|
||||
var TOOL_NAME = "get-variable-definitions";
|
||||
function log(message, verbose) {
|
||||
if (verbose) process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
function toOptionalString(value) {
|
||||
return typeof value === "string" && value.length > 0 ? value : null;
|
||||
}
|
||||
function exitWithEnvelope(envelope, errors = []) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
function resolveCollectionName(id, collections) {
|
||||
if (!id) return null;
|
||||
const entry = collections.find((c) => c.id === id);
|
||||
return entry?.name ?? null;
|
||||
}
|
||||
function buildVariableEntry(variable, collections, sets) {
|
||||
return {
|
||||
id: variable.id,
|
||||
name: variable.name,
|
||||
key: variable.key,
|
||||
resolvedType: variable.resolvedType,
|
||||
collectionId: variable.collectionId ?? variable.variableCollectionId ?? null,
|
||||
collectionName: resolveCollectionName(variable.collectionId ?? variable.variableCollectionId, collections),
|
||||
variableSetId: variable.variableSetId ?? null,
|
||||
variableSetName: resolveCollectionName(variable.variableSetId, sets),
|
||||
scopes: variable.scopes ?? [],
|
||||
description: variable.description ?? null,
|
||||
defaultValue: variable.valuesByMode?.[variable.defaultModeId ?? ""] ?? null,
|
||||
valuesByMode: variable.valuesByMode ?? {}
|
||||
};
|
||||
}
|
||||
function partitionVariables(list) {
|
||||
const colors = [];
|
||||
const spacing = [];
|
||||
const typography = [];
|
||||
const others = [];
|
||||
for (const entry of list) {
|
||||
switch (entry.resolvedType) {
|
||||
case "COLOR":
|
||||
colors.push(entry);
|
||||
break;
|
||||
case "FLOAT":
|
||||
spacing.push(entry);
|
||||
break;
|
||||
case "STRING":
|
||||
case "BOOLEAN":
|
||||
typography.push(entry);
|
||||
break;
|
||||
default:
|
||||
others.push(entry);
|
||||
}
|
||||
}
|
||||
return { colors, spacing, typography, others };
|
||||
}
|
||||
function extractStyles(payload) {
|
||||
if (!payload) return [];
|
||||
if (Array.isArray(payload.styles)) return payload.styles;
|
||||
if (payload.meta?.styles) return Object.values(payload.meta.styles);
|
||||
return [];
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
const schemaVersion = toOptionalString(args["schema-version"]) ?? void 0;
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is required but was not provided."));
|
||||
const envelope2 = createEnvelope({
|
||||
tool: TOOL_NAME,
|
||||
input: { fileKey: null, includeStyles: false },
|
||||
warnings,
|
||||
errors,
|
||||
schemaVersion,
|
||||
data: {}
|
||||
});
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const urlInput = toOptionalString(args.url) ?? toOptionalString(args.u);
|
||||
let fileKey = toOptionalString(args["file-key"]) ?? void 0;
|
||||
if (urlInput) {
|
||||
const parsed = parseFigmaUrl(urlInput);
|
||||
fileKey = fileKey || parsed.fileKey || void 0;
|
||||
}
|
||||
const includeStyles = args["include-styles"] !== "false";
|
||||
const input = { fileKey: fileKey ?? null, includeStyles };
|
||||
if (!fileKey) {
|
||||
errors.push(createError("INPUT_INVALID", "A valid Figma file key is required (--file-key or --url)."));
|
||||
}
|
||||
if (errors.length) {
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, data: {}, schemaVersion });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
const resolvedFileKey = fileKey;
|
||||
log("Fetching variables", verbose);
|
||||
const variablesResponse = await figmaRequest({
|
||||
path: `/v1/files/${resolvedFileKey}/variables/local`,
|
||||
token
|
||||
});
|
||||
let stylesResponse;
|
||||
if (includeStyles) {
|
||||
log("Fetching styles", verbose);
|
||||
stylesResponse = await figmaRequest({ path: `/v1/files/${resolvedFileKey}/styles`, token });
|
||||
} else {
|
||||
stylesResponse = { ok: true, data: { styles: [] }, rateLimit: null };
|
||||
}
|
||||
if (!variablesResponse.ok) {
|
||||
errors.push(variablesResponse.error ?? createError("INTERNAL", "Failed to fetch variables."));
|
||||
const envelope2 = createEnvelope({ tool: TOOL_NAME, input, warnings, errors, rateLimit: variablesResponse.rateLimit ?? void 0, schemaVersion, data: {} });
|
||||
exitWithEnvelope(envelope2, errors);
|
||||
}
|
||||
if (!stylesResponse.ok) {
|
||||
warnings.push(stylesResponse.error?.message ?? "Failed to fetch styles.");
|
||||
}
|
||||
const variablesPayload = variablesResponse.data ?? {};
|
||||
const variableCollections = variablesPayload.collections ?? [];
|
||||
const variableSets = variablesPayload.variableCollections ?? [];
|
||||
const variables = variablesPayload.variables ?? [];
|
||||
const normalisedVariables = variables.map((v) => buildVariableEntry(v, variableCollections, variableSets));
|
||||
const partitions = partitionVariables(normalisedVariables);
|
||||
const styles = stylesResponse.ok ? extractStyles(stylesResponse.data) : [];
|
||||
const data = {
|
||||
file: { key: resolvedFileKey },
|
||||
variables: partitions,
|
||||
rawVariables: normalisedVariables,
|
||||
styles
|
||||
};
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input, data, warnings, errors, rateLimit: variablesResponse.rateLimit ?? void 0, schemaVersion });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input: { fileKey: null, includeStyles: false }, errors: [createError("INTERNAL", message, { stack: error instanceof Error ? error.stack : void 0 })], data: {} });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL191dGlscy9jbGktYXJncy50cyIsICIuLi9zcmMvX3V0aWxzL3VybC1wYXJzZS50cyIsICIuLi9zcmMvX3V0aWxzL2NvbmZpZy50cyIsICIuLi9zcmMvX3V0aWxzL2VudmVsb3BlLnRzIiwgIi4uL3NyYy9fdXRpbHMvZXJyb3JzLnRzIiwgIi4uL3NyYy9fdXRpbHMvaHR0cC1jbGllbnQudHMiLCAiLi4vc3JjL2dldC12YXJpYWJsZS1kZWZpbml0aW9ucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiZXhwb3J0IHR5cGUgQ2xpQXJnVmFsdWUgPSBzdHJpbmcgfCBib29sZWFuO1xuXG5leHBvcnQgaW50ZXJmYWNlIENsaUFyZ3Mge1xuICBfOiBzdHJpbmdbXTtcbiAgW2tleTogc3RyaW5nXTogQ2xpQXJnVmFsdWUgfCBzdHJpbmdbXTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlQXJncyhhcmd2OiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndi5zbGljZSgyKSk6IENsaUFyZ3Mge1xuICBjb25zdCBhcmdzOiBDbGlBcmdzID0geyBfOiBbXSB9O1xuXG4gIGZvciAobGV0IGkgPSAwOyBpIDwgYXJndi5sZW5ndGg7IGkgKz0gMSkge1xuICAgIGNvbnN0IGFyZyA9IGFyZ3ZbaV07XG5cbiAgICBpZiAoIWFyZy5zdGFydHNXaXRoKCctJykgfHwgYXJnID09PSAnLScpIHtcbiAgICAgIGFyZ3MuXy5wdXNoKGFyZyk7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG5cbiAgICBpZiAoYXJnID09PSAnLS0nKSB7XG4gICAgICBjb25zdCByZW1haW5pbmcgPSBhcmd2LnNsaWNlKGkgKyAxKTtcbiAgICAgIGFyZ3MuXy5wdXNoKC4uLnJlbWFpbmluZyk7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBjb25zdCBbcmF3S2V5LCBpbmxpbmVWYWx1ZV0gPSBhcmcuc3BsaXQoJz0nLCAyKTtcbiAgICBjb25zdCBub3JtYWxpc2VkS2V5ID0gcmF3S2V5LnJlcGxhY2UoL14tKy8sICcnKTtcblxuICAgIGxldCB2YWx1ZTogQ2xpQXJnVmFsdWU7XG4gICAgaWYgKGlubGluZVZhbHVlICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIHZhbHVlID0gaW5saW5lVmFsdWU7XG4gICAgfSBlbHNlIHtcbiAgICAgIGNvbnN0IG5leHQgPSBhcmd2W2kgKyAxXTtcbiAgICAgIGlmIChuZXh0ICE9PSB1bmRlZmluZWQgJiYgIW5leHQuc3RhcnRzV2l0aCgnLScpKSB7XG4gICAgICAgIHZhbHVlID0gbmV4dDtcbiAgICAgICAgaSArPSAxO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgdmFsdWUgPSB0cnVlO1xuICAgICAgfVxuICAgIH1cblxuICAgIGFyZ3Nbbm9ybWFsaXNlZEtleV0gPSB2YWx1ZTtcbiAgfVxuXG4gIHJldHVybiBhcmdzO1xufVxuXG4iLCAiY29uc3QgRklMRV9LRVlfUkVHRVggPSAvZmlnbWFcXC5jb21cXC8oPzpmaWxlfGRlc2lnbilcXC8oW0EtWmEtejAtOV0rKVxcLy9pO1xuXG5leHBvcnQgaW50ZXJmYWNlIFBhcnNlZEZpZ21hVXJsIHtcbiAgZmlsZUtleTogc3RyaW5nIHwgbnVsbDtcbiAgbm9kZUlkOiBzdHJpbmcgfCBudWxsO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VGaWdtYVVybChpbnB1dDogc3RyaW5nIHwgbnVsbCB8IHVuZGVmaW5lZCk6IFBhcnNlZEZpZ21hVXJsIHtcbiAgaWYgKCFpbnB1dCkgcmV0dXJuIHsgZmlsZUtleTogbnVsbCwgbm9kZUlkOiBudWxsIH07XG4gIHRyeSB7XG4gICAgY29uc3QgdXJsID0gbmV3IFVSTChpbnB1dCk7XG4gICAgY29uc3QgbWF0Y2ggPSB1cmwuaHJlZi5tYXRjaChGSUxFX0tFWV9SRUdFWCk7XG4gICAgY29uc3QgZmlsZUtleSA9IG1hdGNoID8gbWF0Y2hbMV0gOiBudWxsO1xuICAgIGNvbnN0IG5vZGVQYXJhbSA9IHVybC5zZWFyY2hQYXJhbXMuZ2V0KCdub2RlLWlkJyk7XG4gICAgY29uc3Qgbm9kZUlkID0gbm9kZVBhcmFtID8gZW5zdXJlTm9kZUlkKG5vZGVQYXJhbSkgOiBudWxsO1xuICAgIHJldHVybiB7IGZpbGVLZXksIG5vZGVJZCB9O1xuICB9IGNhdGNoIHtcbiAgICByZXR1cm4geyBmaWxlS2V5OiBudWxsLCBub2RlSWQ6IG51bGwgfTtcbiAgfVxufVxuXG5leHBvcnQgZnVuY3Rpb24gZW5zdXJlTm9kZUlkKHZhbHVlOiBzdHJpbmcgfCBudWxsIHwgdW5kZWZpbmVkKTogc3RyaW5nIHwgbnVsbCB7XG4gIGlmICghdmFsdWUpIHJldHVybiBudWxsO1xuICBjb25zdCBkZWNvZGVkID0gZGVjb2RlVVJJQ29tcG9uZW50KHZhbHVlKTtcbiAgaWYgKGRlY29kZWQuaW5jbHVkZXMoJzonKSkgcmV0dXJuIGRlY29kZWQ7XG4gIGlmICgvXlswLTldKy1bMC05XSskLy50ZXN0KGRlY29kZWQpKSB7XG4gICAgY29uc3QgW2xlZnQsIHJpZ2h0XSA9IGRlY29kZWQuc3BsaXQoJy0nLCAyKTtcbiAgICByZXR1cm4gYCR7bGVmdH06JHtyaWdodH1gO1xuICB9XG4gIHJldHVybiBkZWNvZGVkO1xufVxuXG4iLCAiZXhwb3J0IGRlZmF1bHQge1xuICBzY2hlbWFWZXJzaW9uOiAnMS4wLjAnLFxuICBzb3VyY2U6ICdhZ2VudGljLWNvZGluZy10ZW1wbGF0ZXMvZmlnbWEtdG9vbHMnLFxuICBodHRwOiB7XG4gICAgbWF4QXR0ZW1wdHM6IDUsXG4gICAgaW5pdGlhbERlbGF5TXM6IDI1MCxcbiAgfSxcbn0gYXMgY29uc3Q7XG5cbiIsICJpbXBvcnQgY29uZmlnIGZyb20gJy4vY29uZmlnLnRzJztcbmltcG9ydCB0eXBlIHsgVG9vbEVycm9yIH0gZnJvbSAnLi9lcnJvcnMudHMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIFJhdGVMaW1pdE1ldGEge1xuICByZW1haW5pbmc6IG51bWJlciB8IG51bGw7XG4gIHJlc2V0QXQ6IHN0cmluZyB8IG51bGw7XG4gIGF0dGVtcHRzOiBudW1iZXI7XG4gIGxhc3RXYWl0TXM6IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUb29sRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4sXG4gIFREYXRhID0gdW5rbm93blxuPiB7XG4gIHNjaGVtYVZlcnNpb246IHN0cmluZztcbiAgdG9vbDogc3RyaW5nO1xuICBpbnB1dDogVElucHV0O1xuICBtZXRhOiB7XG4gICAgZ2VuZXJhdGVkQXQ6IHN0cmluZztcbiAgICBzb3VyY2U6IHN0cmluZztcbiAgICByYXRlTGltaXQ6IFJhdGVMaW1pdE1ldGE7XG4gIH07XG4gIGRhdGE6IFREYXRhO1xuICB3YXJuaW5nczogc3RyaW5nW107XG4gIGVycm9yczogVG9vbEVycm9yW107XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlRW52ZWxvcGVPcHRpb25zPFxuICBUSW5wdXQgZXh0ZW5kcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiA9IFJlY29yZDxzdHJpbmcsIHVua25vd24+LFxuICBURGF0YSA9IHVua25vd25cbj4ge1xuICB0b29sOiBzdHJpbmc7XG4gIGlucHV0PzogVElucHV0O1xuICBkYXRhPzogVERhdGE7XG4gIHdhcm5pbmdzPzogc3RyaW5nW107XG4gIGVycm9ycz86IFRvb2xFcnJvcltdO1xuICByYXRlTGltaXQ/OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+O1xuICBzY2hlbWFWZXJzaW9uPzogc3RyaW5nO1xufVxuXG5mdW5jdGlvbiBidWlsZFJhdGVMaW1pdE1ldGEocmF0ZUxpbWl0OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+ID0ge30pOiBSYXRlTGltaXRNZXRhIHtcbiAgcmV0dXJuIHtcbiAgICByZW1haW5pbmc6IHJhdGVMaW1pdC5yZW1haW5pbmcgPz8gbnVsbCxcbiAgICByZXNldEF0OiByYXRlTGltaXQucmVzZXRBdCA/PyBudWxsLFxuICAgIGF0dGVtcHRzOiByYXRlTGltaXQuYXR0ZW1wdHMgPz8gMSxcbiAgICBsYXN0V2FpdE1zOiByYXRlTGltaXQubGFzdFdhaXRNcyA/PyAwLFxuICB9O1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY
Line truncated
|
||||
Executable
+276
@@ -0,0 +1,276 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/cli-args.ts
|
||||
function parseArgs(argv = process.argv.slice(2)) {
|
||||
const args = { _: [] };
|
||||
for (let i = 0; i < argv.length; i += 1) {
|
||||
const arg = argv[i];
|
||||
if (!arg.startsWith("-") || arg === "-") {
|
||||
args._.push(arg);
|
||||
continue;
|
||||
}
|
||||
if (arg === "--") {
|
||||
const remaining = argv.slice(i + 1);
|
||||
args._.push(...remaining);
|
||||
break;
|
||||
}
|
||||
const [rawKey, inlineValue] = arg.split("=", 2);
|
||||
const normalisedKey = rawKey.replace(/^-+/, "");
|
||||
let value;
|
||||
if (inlineValue !== void 0) {
|
||||
value = inlineValue;
|
||||
} else {
|
||||
const next = argv[i + 1];
|
||||
if (next !== void 0 && !next.startsWith("-")) {
|
||||
value = next;
|
||||
i += 1;
|
||||
} else {
|
||||
value = true;
|
||||
}
|
||||
}
|
||||
args[normalisedKey] = value;
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/config.ts
|
||||
var config_default = {
|
||||
schemaVersion: "1.0.0",
|
||||
source: "agentic-coding-templates/figma-tools",
|
||||
http: {
|
||||
maxAttempts: 5,
|
||||
initialDelayMs: 250
|
||||
}
|
||||
};
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/envelope.ts
|
||||
function buildRateLimitMeta(rateLimit = {}) {
|
||||
return {
|
||||
remaining: rateLimit.remaining ?? null,
|
||||
resetAt: rateLimit.resetAt ?? null,
|
||||
attempts: rateLimit.attempts ?? 1,
|
||||
lastWaitMs: rateLimit.lastWaitMs ?? 0
|
||||
};
|
||||
}
|
||||
function createEnvelope({
|
||||
tool,
|
||||
input = {},
|
||||
data = {},
|
||||
warnings = [],
|
||||
errors = [],
|
||||
rateLimit,
|
||||
schemaVersion
|
||||
}) {
|
||||
return {
|
||||
schemaVersion: schemaVersion ?? config_default.schemaVersion,
|
||||
tool,
|
||||
input,
|
||||
meta: {
|
||||
generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
||||
source: config_default.source,
|
||||
rateLimit: buildRateLimitMeta(rateLimit)
|
||||
},
|
||||
data,
|
||||
warnings,
|
||||
errors
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/errors.ts
|
||||
var ERROR_EXIT_CODES = {
|
||||
INPUT_INVALID: 1,
|
||||
CONFIG_INVALID: 1,
|
||||
FIGMA_AUTH: 1,
|
||||
FIGMA_NOT_FOUND: 2,
|
||||
FIGMA_RATE_LIMIT: 2,
|
||||
NETWORK: 2,
|
||||
INTERNAL: 3
|
||||
};
|
||||
function createError(code, message, detail) {
|
||||
return {
|
||||
code,
|
||||
message,
|
||||
detail: detail ?? null
|
||||
};
|
||||
}
|
||||
function getExitCode(errors = []) {
|
||||
if (!errors.length) {
|
||||
return 0;
|
||||
}
|
||||
return errors.reduce((max, error) => {
|
||||
const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
|
||||
return Math.max(max, exitCode);
|
||||
}, 0);
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/_utils/http-client.ts
|
||||
var BASE_URL = "https://api.figma.com";
|
||||
function sleep(ms) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
function parseJsonSafely(text) {
|
||||
try {
|
||||
return text ? JSON.parse(text) : {};
|
||||
} catch {
|
||||
return { raw: text };
|
||||
}
|
||||
}
|
||||
function parseRateLimit(headers, attempts, lastWaitMs) {
|
||||
const remainingHeader = headers.get("x-ratelimit-remaining");
|
||||
const resetHeader = headers.get("x-ratelimit-reset");
|
||||
let remaining = null;
|
||||
if (remainingHeader !== null && remainingHeader !== void 0) {
|
||||
const parsed = Number(remainingHeader);
|
||||
remaining = Number.isNaN(parsed) ? null : parsed;
|
||||
}
|
||||
let resetAt = null;
|
||||
if (resetHeader) {
|
||||
const numericReset = Number(resetHeader);
|
||||
if (!Number.isNaN(numericReset)) {
|
||||
resetAt = new Date(numericReset * 1e3).toISOString();
|
||||
} else {
|
||||
const date = new Date(resetHeader);
|
||||
if (!Number.isNaN(date.valueOf())) {
|
||||
resetAt = date.toISOString();
|
||||
}
|
||||
}
|
||||
}
|
||||
return {
|
||||
remaining,
|
||||
resetAt,
|
||||
attempts,
|
||||
lastWaitMs
|
||||
};
|
||||
}
|
||||
function computeBackoffMs(attempt, initialDelayMs) {
|
||||
return initialDelayMs * 2 ** (attempt - 1);
|
||||
}
|
||||
async function figmaRequest(options) {
|
||||
const {
|
||||
path,
|
||||
method = "GET",
|
||||
token,
|
||||
headers = {},
|
||||
body,
|
||||
searchParams,
|
||||
maxAttempts = config_default.http?.maxAttempts ?? 5,
|
||||
initialDelayMs = config_default.http?.initialDelayMs ?? 250
|
||||
} = options;
|
||||
if (!token) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN is missing from the environment."),
|
||||
status: null,
|
||||
rateLimit: null
|
||||
};
|
||||
}
|
||||
const url = new URL(path, BASE_URL);
|
||||
if (searchParams) {
|
||||
Object.entries(searchParams).forEach(([key, value]) => {
|
||||
if (value === void 0 || value === null) return;
|
||||
url.searchParams.append(key, String(value));
|
||||
});
|
||||
}
|
||||
let attempt = 0;
|
||||
let lastWaitMs = 0;
|
||||
while (attempt < maxAttempts) {
|
||||
attempt += 1;
|
||||
const response = await fetch(url, {
|
||||
method,
|
||||
headers: {
|
||||
"Content-Type": "application/json",
|
||||
"X-Figma-Token": token,
|
||||
...headers
|
||||
},
|
||||
body: body ? JSON.stringify(body) : void 0
|
||||
});
|
||||
const text = await response.text();
|
||||
const payload = parseJsonSafely(text);
|
||||
const rateLimit = parseRateLimit(response.headers, attempt, lastWaitMs);
|
||||
if (response.ok) {
|
||||
return { ok: true, data: payload, rateLimit };
|
||||
}
|
||||
const status = response.status;
|
||||
if (status === 401 || status === 403) {
|
||||
return { ok: false, error: createError("FIGMA_AUTH", payload?.message ?? "Figma token is unauthorized.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 404) {
|
||||
return { ok: false, error: createError("FIGMA_NOT_FOUND", payload?.message ?? "Resource not found.", { status }), status, rateLimit };
|
||||
}
|
||||
if (status === 429 || status >= 500) {
|
||||
if (attempt >= maxAttempts) {
|
||||
return {
|
||||
ok: false,
|
||||
error: createError(status === 429 ? "FIGMA_RATE_LIMIT" : "NETWORK", payload?.message ?? "Figma request failed after maximum retries.", { status }),
|
||||
status,
|
||||
rateLimit
|
||||
};
|
||||
}
|
||||
let waitMs = computeBackoffMs(attempt, initialDelayMs);
|
||||
const resetHeader = response.headers.get("x-ratelimit-reset");
|
||||
if (resetHeader) {
|
||||
const asNumber = Number(resetHeader);
|
||||
if (!Number.isNaN(asNumber)) {
|
||||
const resetMs = asNumber * 1e3;
|
||||
const delta = resetMs - Date.now();
|
||||
if (delta > 0) waitMs = Math.max(waitMs, delta);
|
||||
}
|
||||
}
|
||||
const jitter = Math.floor(Math.random() * 100);
|
||||
lastWaitMs = waitMs + jitter;
|
||||
await sleep(lastWaitMs);
|
||||
continue;
|
||||
}
|
||||
return { ok: false, error: createError("INTERNAL", payload?.message ?? "Unexpected error from Figma API.", { status }), status, rateLimit };
|
||||
}
|
||||
return {
|
||||
ok: false,
|
||||
error: createError("NETWORK", "Unable to reach Figma API."),
|
||||
status: null,
|
||||
rateLimit: { remaining: null, resetAt: null, attempts: maxAttempts, lastWaitMs }
|
||||
};
|
||||
}
|
||||
|
||||
// coding-tools/figma-tools/js/src/whoami.ts
|
||||
var TOOL_NAME = "whoami";
|
||||
function log(message, verbose) {
|
||||
if (verbose) process.stderr.write(`[${TOOL_NAME}] ${message}
|
||||
`);
|
||||
}
|
||||
async function main() {
|
||||
const args = parseArgs();
|
||||
const verbose = Boolean(args.verbose ?? args.v);
|
||||
log("Starting...", verbose);
|
||||
const warnings = [];
|
||||
const errors = [];
|
||||
const token = process.env.FIGMA_ACCESS_TOKEN;
|
||||
if (!token || !token.trim()) {
|
||||
errors.push(createError("FIGMA_AUTH", "FIGMA_ACCESS_TOKEN must be set in environment."));
|
||||
}
|
||||
let envelope = createEnvelope({ tool: TOOL_NAME, warnings, errors });
|
||||
if (errors.length > 0) {
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
const result = await figmaRequest({ path: "/v1/me", token });
|
||||
if (!result.ok) {
|
||||
errors.push(result.error);
|
||||
envelope = createEnvelope({ tool: TOOL_NAME, warnings, errors, rateLimit: result.rateLimit ?? void 0 });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(getExitCode(errors));
|
||||
}
|
||||
envelope = createEnvelope({ tool: TOOL_NAME, data: result.data, warnings, errors, rateLimit: result.rateLimit });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(0);
|
||||
}
|
||||
main().catch((error) => {
|
||||
const message = error instanceof Error ? error.message : "Unknown error";
|
||||
const envelope = createEnvelope({ tool: TOOL_NAME, input: {}, errors: [createError("INTERNAL", message)] });
|
||||
process.stdout.write(`${JSON.stringify(envelope, null, 2)}
|
||||
`);
|
||||
process.exit(3);
|
||||
});
|
||||
//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL191dGlscy9jbGktYXJncy50cyIsICIuLi9zcmMvX3V0aWxzL2NvbmZpZy50cyIsICIuLi9zcmMvX3V0aWxzL2VudmVsb3BlLnRzIiwgIi4uL3NyYy9fdXRpbHMvZXJyb3JzLnRzIiwgIi4uL3NyYy9fdXRpbHMvaHR0cC1jbGllbnQudHMiLCAiLi4vc3JjL3dob2FtaS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiZXhwb3J0IHR5cGUgQ2xpQXJnVmFsdWUgPSBzdHJpbmcgfCBib29sZWFuO1xuXG5leHBvcnQgaW50ZXJmYWNlIENsaUFyZ3Mge1xuICBfOiBzdHJpbmdbXTtcbiAgW2tleTogc3RyaW5nXTogQ2xpQXJnVmFsdWUgfCBzdHJpbmdbXTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlQXJncyhhcmd2OiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndi5zbGljZSgyKSk6IENsaUFyZ3Mge1xuICBjb25zdCBhcmdzOiBDbGlBcmdzID0geyBfOiBbXSB9O1xuXG4gIGZvciAobGV0IGkgPSAwOyBpIDwgYXJndi5sZW5ndGg7IGkgKz0gMSkge1xuICAgIGNvbnN0IGFyZyA9IGFyZ3ZbaV07XG5cbiAgICBpZiAoIWFyZy5zdGFydHNXaXRoKCctJykgfHwgYXJnID09PSAnLScpIHtcbiAgICAgIGFyZ3MuXy5wdXNoKGFyZyk7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG5cbiAgICBpZiAoYXJnID09PSAnLS0nKSB7XG4gICAgICBjb25zdCByZW1haW5pbmcgPSBhcmd2LnNsaWNlKGkgKyAxKTtcbiAgICAgIGFyZ3MuXy5wdXNoKC4uLnJlbWFpbmluZyk7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBjb25zdCBbcmF3S2V5LCBpbmxpbmVWYWx1ZV0gPSBhcmcuc3BsaXQoJz0nLCAyKTtcbiAgICBjb25zdCBub3JtYWxpc2VkS2V5ID0gcmF3S2V5LnJlcGxhY2UoL14tKy8sICcnKTtcblxuICAgIGxldCB2YWx1ZTogQ2xpQXJnVmFsdWU7XG4gICAgaWYgKGlubGluZVZhbHVlICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIHZhbHVlID0gaW5saW5lVmFsdWU7XG4gICAgfSBlbHNlIHtcbiAgICAgIGNvbnN0IG5leHQgPSBhcmd2W2kgKyAxXTtcbiAgICAgIGlmIChuZXh0ICE9PSB1bmRlZmluZWQgJiYgIW5leHQuc3RhcnRzV2l0aCgnLScpKSB7XG4gICAgICAgIHZhbHVlID0gbmV4dDtcbiAgICAgICAgaSArPSAxO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgdmFsdWUgPSB0cnVlO1xuICAgICAgfVxuICAgIH1cblxuICAgIGFyZ3Nbbm9ybWFsaXNlZEtleV0gPSB2YWx1ZTtcbiAgfVxuXG4gIHJldHVybiBhcmdzO1xufVxuXG4iLCAiZXhwb3J0IGRlZmF1bHQge1xuICBzY2hlbWFWZXJzaW9uOiAnMS4wLjAnLFxuICBzb3VyY2U6ICdhZ2VudGljLWNvZGluZy10ZW1wbGF0ZXMvZmlnbWEtdG9vbHMnLFxuICBodHRwOiB7XG4gICAgbWF4QXR0ZW1wdHM6IDUsXG4gICAgaW5pdGlhbERlbGF5TXM6IDI1MCxcbiAgfSxcbn0gYXMgY29uc3Q7XG5cbiIsICJpbXBvcnQgY29uZmlnIGZyb20gJy4vY29uZmlnLnRzJztcbmltcG9ydCB0eXBlIHsgVG9vbEVycm9yIH0gZnJvbSAnLi9lcnJvcnMudHMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIFJhdGVMaW1pdE1ldGEge1xuICByZW1haW5pbmc6IG51bWJlciB8IG51bGw7XG4gIHJlc2V0QXQ6IHN0cmluZyB8IG51bGw7XG4gIGF0dGVtcHRzOiBudW1iZXI7XG4gIGxhc3RXYWl0TXM6IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUb29sRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4sXG4gIFREYXRhID0gdW5rbm93blxuPiB7XG4gIHNjaGVtYVZlcnNpb246IHN0cmluZztcbiAgdG9vbDogc3RyaW5nO1xuICBpbnB1dDogVElucHV0O1xuICBtZXRhOiB7XG4gICAgZ2VuZXJhdGVkQXQ6IHN0cmluZztcbiAgICBzb3VyY2U6IHN0cmluZztcbiAgICByYXRlTGltaXQ6IFJhdGVMaW1pdE1ldGE7XG4gIH07XG4gIGRhdGE6IFREYXRhO1xuICB3YXJuaW5nczogc3RyaW5nW107XG4gIGVycm9yczogVG9vbEVycm9yW107XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlRW52ZWxvcGVPcHRpb25zPFxuICBUSW5wdXQgZXh0ZW5kcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiA9IFJlY29yZDxzdHJpbmcsIHVua25vd24+LFxuICBURGF0YSA9IHVua25vd25cbj4ge1xuICB0b29sOiBzdHJpbmc7XG4gIGlucHV0PzogVElucHV0O1xuICBkYXRhPzogVERhdGE7XG4gIHdhcm5pbmdzPzogc3RyaW5nW107XG4gIGVycm9ycz86IFRvb2xFcnJvcltdO1xuICByYXRlTGltaXQ/OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+O1xuICBzY2hlbWFWZXJzaW9uPzogc3RyaW5nO1xufVxuXG5mdW5jdGlvbiBidWlsZFJhdGVMaW1pdE1ldGEocmF0ZUxpbWl0OiBQYXJ0aWFsPFJhdGVMaW1pdE1ldGE+ID0ge30pOiBSYXRlTGltaXRNZXRhIHtcbiAgcmV0dXJuIHtcbiAgICByZW1haW5pbmc6IHJhdGVMaW1pdC5yZW1haW5pbmcgPz8gbnVsbCxcbiAgICByZXNldEF0OiByYXRlTGltaXQucmVzZXRBdCA/PyBudWxsLFxuICAgIGF0dGVtcHRzOiByYXRlTGltaXQuYXR0ZW1wdHMgPz8gMSxcbiAgICBsYXN0V2FpdE1zOiByYXRlTGltaXQubGFzdFdhaXRNcyA/PyAwLFxuICB9O1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlRW52ZWxvcGU8XG4gIFRJbnB1dCBleHRlbmRzIFJlY29yZDxzdHJpbmcsIHVua25vd24+ID0gUmVjb3JkPHN0cmluZywgdW5rbm93bj4sXG4gIFREYXRhID0gdW5rbm93blxuPih7XG4gIHRvb2wsXG4gIGlucHV0ID0ge30gYXMgVElucHV0LFxuICBkYXRhID0ge30gYXMgVERhdGEsXG4gIHdhcm5pbmdzID0gW10sXG4gIGVycm9ycyA9IFtdLFxuICByYXRlTGltaXQsXG4gIHNjaGVtYVZlcnNpb24sXG59OiBDcmVhdGVFbnZlbG9wZU9wdGlvbnM8VElucHV0LCBURGF0YT4pOiBUb29sRW52ZWxvcGU8VElucHV0LCBURGF0YT4ge1xuICByZXR1cm4ge1xuICAgIHNjaGVtYVZlcnNpb246IHNjaGVtYVZlcnNpb24gPz8gY29uZmlnLnNjaGVtYVZlcnNpb24sXG4gICAgdG9vbCxcbiAgICBpbnB1dCxcbiAgICBtZXRhOiB7XG4gICAgICBnZW5lcmF0ZWRBdDogbmV3IERhdGUoKS50b0lTT1N0cmluZygpLFxuICAgICAgc291cmNlOiBjb25maWcuc291cmNlLFxuICAgICAgcmF0ZUxpbWl0OiBidWlsZFJhdGVMaW1pdE1ldGEocmF0ZUxpbWl0KSxcbiAgICB9LFxuICAgIGRhdGEsXG4gICAgd2FybmluZ3MsXG4gICAgZXJyb3JzLFxuICB9O1xufVxuXG4iLCAiZXhwb3J0IGNvbnN0IEVSUk9SX0VYSVRfQ09ERVMgPSB7XG4gIElOUFVUX0lOVkFMSUQ6IDEsXG4gIENPTkZJR19JTlZBTElEOiAxLFxuICBGSUdNQV9BVVRIOiAxLFxuICBGSUdNQV9OT1RfRk9VTkQ6IDIsXG4gIEZJR01BX1JBVEVfTElNSVQ6IDIsXG4gIE5FVFdPUks6IDIsXG4gIElOVEVSTkFMOiAzLFxufSBhcyBjb25zdDtcblxuZXhwb3J0IHR5cGUgRXJyb3JDb2RlID0ga2V5b2YgdHlwZW9mIEVSUk9SX0VYSVRfQ09ERVM7XG5cbmV4cG9ydCBpbnRlcmZhY2UgVG9vbEVycm9yPFREZXRhaWwgPSB1bmtub3duPiB7XG4gIGNvZGU6IEVycm9yQ29kZSB8IHN0cmluZztcbiAgbWVzc2FnZTogc3RyaW5nO1xuICBkZXRhaWw/OiBURGV0YWlsIHwgbnVsbDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUVycm9yPFREZXRhaWwgPSB1bmtub3duPihcbiAgY29kZTogRXJyb3JDb2RlIHwgc3RyaW5nLFxuICBtZXNzYWdlOiBzdHJpbmcsXG4gIGRldGFpbD86IFREZXRhaWwgfCBudWxsXG4pOiBUb29sRXJyb
Line truncated
|
||||
Reference in new issue
Block a user