@calibrate-ds/figma-client 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+import type { FigmaClientOptions } from "./types.js";
+type FetchOptions = {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+};
+export declare function createFigmaClient(options: FigmaClientOptions): {
+    request: <T>(endpoint: string, fetchOptions?: FetchOptions) => Promise<T>;
+};
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AAEzE,KAAK,YAAY,GAAG;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB;cAGlC,CAAC,YAAY,MAAM,iBAAgB,YAAY,KAAQ,OAAO,CAAC,CAAC,CAAC;EAmC3F"}

package/dist/client.js

@@ -0,0 +1,33 @@
+export function createFigmaClient(options) {
+    const baseUrl = options.baseUrl || "https://api.figma.com/v1";
+    async function request(endpoint, fetchOptions = {}) {
+        const url = `${baseUrl}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`;
+        const headers = {
+            "X-Figma-Token": options.token,
+            "Content-Type": "application/json",
+            ...(fetchOptions.headers || {}),
+        };
+        const response = await fetch(url, {
+            ...fetchOptions,
+            headers,
+        });
+        if (!response.ok) {
+            let errorData;
+            try {
+                // Attempt to parse standard Figma error format
+                errorData = await response.json();
+            }
+            catch {
+                // Fallback if not JSON
+            }
+            const rawErrorMessage = errorData?.err || response.statusText;
+            const errorMessage = typeof rawErrorMessage === 'string'
+                ? rawErrorMessage.replace(/(?:figd|figa)_[a-zA-Z0-9\-_]+/g, "[REDACTED]")
+                : String(rawErrorMessage);
+            throw new Error(`Figma API Error (${response.status}): ${errorMessage} - while requesting ${url}`);
+        }
+        return response.json();
+    }
+    return { request };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,0BAA0B,CAAC;IAE9D,KAAK,UAAU,OAAO,CAAI,QAAgB,EAAE,eAA6B,EAAE;QACvE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC;QAEhF,MAAM,OAAO,GAAG;YACZ,eAAe,EAAE,OAAO,CAAC,KAAK;YAC9B,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;SAClC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,GAAG,YAAY;YACf,OAAO;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,SAAyC,CAAC;YAC9C,IAAI,CAAC;gBACD,+CAA+C;gBAC/C,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACL,uBAAuB;YAC3B,CAAC;YAED,MAAM,eAAe,GAAG,SAAS,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC;YAC9D,MAAM,YAAY,GAAG,OAAO,eAAe,KAAK,QAAQ;gBACpD,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,gCAAgC,EAAE,YAAY,CAAC;gBACzE,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAE9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,MAAM,YAAY,uBAAuB,GAAG,EAAE,CAAC,CAAC;QACvG,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACzC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACvB,CAAC"}

package/dist/get-file.d.ts

@@ -0,0 +1,12 @@
+import type { FigmaFileResponse } from "./types.js";
+type GetFigmaFileParams = {
+    fileKey: string;
+    token: string;
+    baseUrl?: string;
+};
+/**
+ * Fetch the complete Figma file contents (document tree, components, component sets, and styles).
+ */
+export declare function getFigmaFile(params: GetFigmaFileParams): Promise<FigmaFileResponse>;
+export {};
+//# sourceMappingURL=get-file.d.ts.map

package/dist/get-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file.d.ts","sourceRoot":"","sources":["../src/get-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,KAAK,kBAAkB,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAOzF"}

package/dist/get-file.js

@@ -0,0 +1,12 @@
+import { createFigmaClient } from "./client.js";
+/**
+ * Fetch the complete Figma file contents (document tree, components, component sets, and styles).
+ */
+export async function getFigmaFile(params) {
+    const client = createFigmaClient({
+        token: params.token,
+        baseUrl: params.baseUrl,
+    });
+    return client.request(`/files/${params.fileKey}`);
+}
+//# sourceMappingURL=get-file.js.map

package/dist/get-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file.js","sourceRoot":"","sources":["../src/get-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,OAAO,CAAoB,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/get-image-exports.d.ts

@@ -0,0 +1,8 @@
+import type { FigmaClientOptions } from "./types.js";
+export type GetImageExportsParams = {
+    fileKey: string;
+    nodeIds: string[];
+    format?: "svg" | "png" | "jpg";
+} & Pick<FigmaClientOptions, "token" | "baseUrl">;
+export declare function getImageExports(params: GetImageExportsParams): Promise<Record<string, string | null>>;
+//# sourceMappingURL=get-image-exports.d.ts.map

package/dist/get-image-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-image-exports.d.ts","sourceRoot":"","sources":["../src/get-image-exports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;CAClC,GAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;AAOlD,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAS3G"}

package/dist/get-image-exports.js

@@ -0,0 +1,11 @@
+import { createFigmaClient } from "./client.js";
+export async function getImageExports(params) {
+    const client = createFigmaClient({ token: params.token, baseUrl: params.baseUrl });
+    const ids = params.nodeIds.join(",");
+    const format = params.format ?? "svg";
+    const response = await client.request(`/images/${params.fileKey}?ids=${ids}&format=${format}&svg_include_id=false`);
+    if (response.err)
+        throw new Error(`Figma image export error: ${response.err}`);
+    return response.images;
+}
+//# sourceMappingURL=get-image-exports.js.map

package/dist/get-image-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-image-exports.js","sourceRoot":"","sources":["../src/get-image-exports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAchD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAA6B;IAC/D,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CACjC,WAAW,MAAM,CAAC,OAAO,QAAQ,GAAG,WAAW,MAAM,uBAAuB,CAC/E,CAAC;IACF,IAAI,QAAQ,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,OAAO,QAAQ,CAAC,MAAM,CAAC;AAC3B,CAAC"}

package/dist/get-local-variables.d.ts

@@ -0,0 +1,12 @@
+import type { FigmaVariablesResponse } from "./types.js";
+type GetFigmaLocalVariablesParams = {
+    fileKey: string;
+    token: string;
+    baseUrl?: string;
+};
+/**
+ * Fetch the local variables and collections associated with the given Figma file.
+ */
+export declare function getFigmaLocalVariables(params: GetFigmaLocalVariablesParams): Promise<FigmaVariablesResponse>;
+export {};
+//# sourceMappingURL=get-local-variables.d.ts.map

package/dist/get-local-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-local-variables.d.ts","sourceRoot":"","sources":["../src/get-local-variables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,KAAK,4BAA4B,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAOlH"}

package/dist/get-local-variables.js

@@ -0,0 +1,12 @@
+import { createFigmaClient } from "./client.js";
+/**
+ * Fetch the local variables and collections associated with the given Figma file.
+ */
+export async function getFigmaLocalVariables(params) {
+    const client = createFigmaClient({
+        token: params.token,
+        baseUrl: params.baseUrl,
+    });
+    return client.request(`/files/${params.fileKey}/variables/local`);
+}
+//# sourceMappingURL=get-local-variables.js.map

package/dist/get-local-variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-local-variables.js","sourceRoot":"","sources":["../src/get-local-variables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAShD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAoC;IAC7E,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,OAAO,CAAyB,UAAU,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9F,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./client.js";
+export * from "./get-file.js";
+export * from "./get-local-variables.js";
+export * from "./get-image-exports.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./client.js";
+export * from "./get-file.js";
+export * from "./get-local-variables.js";
+export * from "./get-image-exports.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+export type FigmaClientOptions = {
+    token: string;
+    baseUrl?: string;
+};
+export type FigmaApiErrorShape = {
+    status: number;
+    err: string;
+};
+export type FigmaFileResponse = {
+    document: any;
+    components: Record<string, any>;
+    componentSets: Record<string, any>;
+    schemaVersion: number;
+    styles: Record<string, any>;
+    name: string;
+    lastModified: string;
+    thumbnailUrl: string;
+    version: string;
+    role: string;
+};
+export type FigmaVariablesResponse = {
+    status: number;
+    error?: boolean;
+    meta: {
+        variableCollections: Record<string, any>;
+        variables: Record<string, any>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE;QACF,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,CAAC;CACL,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@calibrate-ds/figma-client",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "echo \"No lint yet\"",
+    "test": "echo \"No tests yet\""
+  }
+}