figma-metadata-extractor 1.0.13 → 1.0.14

package/dist/__vite-browser-external-Dyvby5gX.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/__vite-browser-external-l0sNRNKZ.js

@@ -0,0 +1 @@
+

package/dist/index.cjs

@@ -265,6 +265,122 @@ function formatHeadersForCurl(headers) {
   }
   return headerArgs;
 }
+async function downloadFigmaImage(fileName, localPath, imageUrl, returnBuffer = false) {
+  const { pipeline } = await Promise.resolve().then(() => require("./__vite-browser-external-Dyvby5gX.cjs"));
+  const { Readable } = await Promise.resolve().then(() => require("./__vite-browser-external-Dyvby5gX.cjs"));
+  try {
+    const response = await fetch(imageUrl, {
+      method: "GET"
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Failed to download image: ${response.status} ${response.statusText}`
+      );
+    }
+    if (!response.body) {
+      throw new Error("Response body is empty");
+    }
+    if (returnBuffer) {
+      const arrayBuffer = await response.arrayBuffer();
+      if (arrayBuffer.byteLength === 0) {
+        throw new Error("Downloaded image buffer is empty");
+      }
+      return arrayBuffer;
+    }
+    if (!fs.existsSync(localPath)) {
+      fs.mkdirSync(localPath, { recursive: true });
+    }
+    const fullPath = path.join(localPath, fileName);
+    const fileStream = fs.createWriteStream(fullPath);
+    await pipeline(Readable.fromWeb(response.body), fileStream);
+    const stats = fs.statSync(fullPath);
+    if (stats.size === 0) {
+      fs.unlinkSync(fullPath);
+      throw new Error("Downloaded file is empty (0 bytes)");
+    }
+    return fullPath;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Error downloading image: ${errorMessage}`);
+  }
+}
+function generateVarId(prefix = "var") {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+  let result = "";
+  for (let i = 0; i < 6; i++) {
+    const randomIndex = Math.floor(Math.random() * chars.length);
+    result += chars[randomIndex];
+  }
+  return `${prefix}_${result}`;
+}
+function generateCSSShorthand(values, {
+  ignoreZero = true,
+  suffix = "px"
+} = {}) {
+  const { top, right, bottom, left } = values;
+  if (ignoreZero && top === 0 && right === 0 && bottom === 0 && left === 0) {
+    return void 0;
+  }
+  if (top === right && right === bottom && bottom === left) {
+    return `${top}${suffix}`;
+  }
+  if (right === left) {
+    if (top === bottom) {
+      return `${top}${suffix} ${right}${suffix}`;
+    }
+    return `${top}${suffix} ${right}${suffix} ${bottom}${suffix}`;
+  }
+  return `${top}${suffix} ${right}${suffix} ${bottom}${suffix} ${left}${suffix}`;
+}
+function isVisible(element) {
+  return element.visible ?? true;
+}
+function pixelRound(num) {
+  if (isNaN(num)) {
+    throw new TypeError(`Input must be a valid number`);
+  }
+  return Number(Number(num).toFixed(2));
+}
+async function runWithConcurrency(tasks, limit) {
+  const results = new Array(tasks.length);
+  return new Promise((resolve, reject) => {
+    if (tasks.length === 0) {
+      resolve([]);
+      return;
+    }
+    let completed = 0;
+    let launched = 0;
+    let failed = false;
+    const next = () => {
+      if (failed) return;
+      if (completed === tasks.length) {
+        resolve(results);
+        return;
+      }
+      while (launched < tasks.length && launched - completed < limit) {
+        const index = launched++;
+        tasks[index]().then((result) => {
+          results[index] = result;
+          completed++;
+          next();
+        }).catch((err) => {
+          failed = true;
+          reject(err);
+        });
+      }
+    };
+    next();
+  });
+}
+const common = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  downloadFigmaImage,
+  generateCSSShorthand,
+  generateVarId,
+  isVisible,
+  pixelRound,
+  runWithConcurrency
+}, Symbol.toStringTag, { value: "Module" }));
 class FigmaService {
   apiKey;
   oauthToken;
@@ -372,6 +488,7 @@ class FigmaService {
   async downloadImages(fileKey, localPath, items, options = {}) {
     if (items.length === 0) return [];
     const { pngScale = 2, svgOptions, returnBuffer = false } = options;
+    const CONCURRENCY_LIMIT = 10;
     let resolvedPath = "";
     if (!returnBuffer) {
       const sanitizedPath = path.normalize(localPath).replace(/^(\.\.(\/|\\|$))+/, "");
@@ -391,7 +508,7 @@ class FigmaService {
     );
     if (imageFills.length > 0) {
       const fillUrls = await this.getImageFillUrls(fileKey);
-      const fillDownloads = imageFills.map(
+      const fillTasks = imageFills.map(
         ({
           imageRef,
           fileName,
@@ -406,7 +523,7 @@ class FigmaService {
             );
             return null;
           }
-          return downloadAndProcessImage(
+          return () => downloadAndProcessImage(
             fileName,
             resolvedPath,
             imageUrl,
@@ -417,10 +534,10 @@ class FigmaService {
           );
         }
       ).filter(
-        (promise) => promise !== null
+        (task) => task !== null
       );
-      if (fillDownloads.length > 0) {
-        downloadPromises.push(Promise.all(fillDownloads));
+      if (fillTasks.length > 0) {
+        downloadPromises.push(runWithConcurrency(fillTasks, CONCURRENCY_LIMIT));
       }
     }
     if (renderNodes.length > 0) {
@@ -437,7 +554,7 @@ class FigmaService {
           "png",
           { pngScale }
         );
-        const pngDownloads = pngNodes.map(
+        const pngTasks = pngNodes.map(
           ({
             nodeId,
             fileName,
@@ -452,7 +569,7 @@ class FigmaService {
               );
               return null;
             }
-            return downloadAndProcessImage(
+            return () => downloadAndProcessImage(
               fileName,
               resolvedPath,
               imageUrl,
@@ -465,10 +582,12 @@ class FigmaService {
             );
           }
         ).filter(
-          (promise) => promise !== null
+          (task) => task !== null
         );
-        if (pngDownloads.length > 0) {
-          downloadPromises.push(Promise.all(pngDownloads));
+        if (pngTasks.length > 0) {
+          downloadPromises.push(
+            runWithConcurrency(pngTasks, CONCURRENCY_LIMIT)
+          );
         }
       }
       if (svgNodes.length > 0) {
@@ -478,7 +597,7 @@ class FigmaService {
           "svg",
           { svgOptions }
         );
-        const svgDownloads = svgNodes.map(
+        const svgTasks = svgNodes.map(
           ({
             nodeId,
             fileName,
@@ -493,7 +612,7 @@ class FigmaService {
               );
               return null;
             }
-            return downloadAndProcessImage(
+            return () => downloadAndProcessImage(
               fileName,
               resolvedPath,
               imageUrl,
@@ -506,10 +625,12 @@ class FigmaService {
             );
           }
         ).filter(
-          (promise) => promise !== null
+          (task) => task !== null
         );
-        if (svgDownloads.length > 0) {
-          downloadPromises.push(Promise.all(svgDownloads));
+        if (svgTasks.length > 0) {
+          downloadPromises.push(
+            runWithConcurrency(svgTasks, CONCURRENCY_LIMIT)
+          );
         }
       }
     }
@@ -541,106 +662,6 @@ class FigmaService {
     return response;
   }
 }
-async function downloadFigmaImage(fileName, localPath, imageUrl, returnBuffer = false) {
-  try {
-    const response = await fetch(imageUrl, {
-      method: "GET"
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to download image: ${response.statusText}`);
-    }
-    if (returnBuffer) {
-      const arrayBuffer = await response.arrayBuffer();
-      return arrayBuffer;
-    }
-    if (!fs.existsSync(localPath)) {
-      fs.mkdirSync(localPath, { recursive: true });
-    }
-    const fullPath = path.join(localPath, fileName);
-    const reader = response.body?.getReader();
-    if (!reader) {
-      throw new Error("Failed to get response body");
-    }
-    const writer = fs.createWriteStream(fullPath);
-    return new Promise((resolve, reject) => {
-      const processStream = async () => {
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-              writer.end();
-              break;
-            }
-            writer.write(value);
-          }
-        } catch (err) {
-          writer.end();
-          fs.unlink(fullPath, () => {
-          });
-          reject(err);
-        }
-      };
-      writer.on("finish", () => {
-        resolve(fullPath);
-      });
-      writer.on("error", (err) => {
-        reader.cancel();
-        fs.unlink(fullPath, () => {
-        });
-        reject(new Error(`Failed to write image: ${err.message}`));
-      });
-      processStream();
-    });
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    throw new Error(`Error downloading image: ${errorMessage}`);
-  }
-}
-function generateVarId(prefix = "var") {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-  let result = "";
-  for (let i = 0; i < 6; i++) {
-    const randomIndex = Math.floor(Math.random() * chars.length);
-    result += chars[randomIndex];
-  }
-  return `${prefix}_${result}`;
-}
-function generateCSSShorthand(values, {
-  ignoreZero = true,
-  suffix = "px"
-} = {}) {
-  const { top, right, bottom, left } = values;
-  if (ignoreZero && top === 0 && right === 0 && bottom === 0 && left === 0) {
-    return void 0;
-  }
-  if (top === right && right === bottom && bottom === left) {
-    return `${top}${suffix}`;
-  }
-  if (right === left) {
-    if (top === bottom) {
-      return `${top}${suffix} ${right}${suffix}`;
-    }
-    return `${top}${suffix} ${right}${suffix} ${bottom}${suffix}`;
-  }
-  return `${top}${suffix} ${right}${suffix} ${bottom}${suffix} ${left}${suffix}`;
-}
-function isVisible(element) {
-  return element.visible ?? true;
-}
-function pixelRound(num) {
-  if (isNaN(num)) {
-    throw new TypeError(`Input must be a valid number`);
-  }
-  return Number(Number(num).toFixed(2));
-}
-const common = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  downloadFigmaImage,
-  generateCSSShorthand,
-  generateVarId,
-  isVisible,
-  pixelRound
-}, Symbol.toStringTag, { value: "Module" }));
 function hasValue(key, obj, typeGuard) {
   const isObject = typeof obj === "object" && obj !== null;
   if (!isObject || !(key in obj)) return false;

package/dist/index.js

@@ -263,6 +263,122 @@ function formatHeadersForCurl(headers) {
   }
   return headerArgs;
 }
+async function downloadFigmaImage(fileName, localPath, imageUrl, returnBuffer = false) {
+  const { pipeline } = await import("./__vite-browser-external-l0sNRNKZ.js");
+  const { Readable } = await import("./__vite-browser-external-l0sNRNKZ.js");
+  try {
+    const response = await fetch(imageUrl, {
+      method: "GET"
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Failed to download image: ${response.status} ${response.statusText}`
+      );
+    }
+    if (!response.body) {
+      throw new Error("Response body is empty");
+    }
+    if (returnBuffer) {
+      const arrayBuffer = await response.arrayBuffer();
+      if (arrayBuffer.byteLength === 0) {
+        throw new Error("Downloaded image buffer is empty");
+      }
+      return arrayBuffer;
+    }
+    if (!fs.existsSync(localPath)) {
+      fs.mkdirSync(localPath, { recursive: true });
+    }
+    const fullPath = path.join(localPath, fileName);
+    const fileStream = fs.createWriteStream(fullPath);
+    await pipeline(Readable.fromWeb(response.body), fileStream);
+    const stats = fs.statSync(fullPath);
+    if (stats.size === 0) {
+      fs.unlinkSync(fullPath);
+      throw new Error("Downloaded file is empty (0 bytes)");
+    }
+    return fullPath;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Error downloading image: ${errorMessage}`);
+  }
+}
+function generateVarId(prefix = "var") {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+  let result = "";
+  for (let i = 0; i < 6; i++) {
+    const randomIndex = Math.floor(Math.random() * chars.length);
+    result += chars[randomIndex];
+  }
+  return `${prefix}_${result}`;
+}
+function generateCSSShorthand(values, {
+  ignoreZero = true,
+  suffix = "px"
+} = {}) {
+  const { top, right, bottom, left } = values;
+  if (ignoreZero && top === 0 && right === 0 && bottom === 0 && left === 0) {
+    return void 0;
+  }
+  if (top === right && right === bottom && bottom === left) {
+    return `${top}${suffix}`;
+  }
+  if (right === left) {
+    if (top === bottom) {
+      return `${top}${suffix} ${right}${suffix}`;
+    }
+    return `${top}${suffix} ${right}${suffix} ${bottom}${suffix}`;
+  }
+  return `${top}${suffix} ${right}${suffix} ${bottom}${suffix} ${left}${suffix}`;
+}
+function isVisible(element) {
+  return element.visible ?? true;
+}
+function pixelRound(num) {
+  if (isNaN(num)) {
+    throw new TypeError(`Input must be a valid number`);
+  }
+  return Number(Number(num).toFixed(2));
+}
+async function runWithConcurrency(tasks, limit) {
+  const results = new Array(tasks.length);
+  return new Promise((resolve, reject) => {
+    if (tasks.length === 0) {
+      resolve([]);
+      return;
+    }
+    let completed = 0;
+    let launched = 0;
+    let failed = false;
+    const next = () => {
+      if (failed) return;
+      if (completed === tasks.length) {
+        resolve(results);
+        return;
+      }
+      while (launched < tasks.length && launched - completed < limit) {
+        const index = launched++;
+        tasks[index]().then((result) => {
+          results[index] = result;
+          completed++;
+          next();
+        }).catch((err) => {
+          failed = true;
+          reject(err);
+        });
+      }
+    };
+    next();
+  });
+}
+const common = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  downloadFigmaImage,
+  generateCSSShorthand,
+  generateVarId,
+  isVisible,
+  pixelRound,
+  runWithConcurrency
+}, Symbol.toStringTag, { value: "Module" }));
 class FigmaService {
   apiKey;
   oauthToken;
@@ -370,6 +486,7 @@ class FigmaService {
   async downloadImages(fileKey, localPath, items, options = {}) {
     if (items.length === 0) return [];
     const { pngScale = 2, svgOptions, returnBuffer = false } = options;
+    const CONCURRENCY_LIMIT = 10;
     let resolvedPath = "";
     if (!returnBuffer) {
       const sanitizedPath = path.normalize(localPath).replace(/^(\.\.(\/|\\|$))+/, "");
@@ -389,7 +506,7 @@ class FigmaService {
     );
     if (imageFills.length > 0) {
       const fillUrls = await this.getImageFillUrls(fileKey);
-      const fillDownloads = imageFills.map(
+      const fillTasks = imageFills.map(
         ({
           imageRef,
           fileName,
@@ -404,7 +521,7 @@ class FigmaService {
             );
             return null;
           }
-          return downloadAndProcessImage(
+          return () => downloadAndProcessImage(
             fileName,
             resolvedPath,
             imageUrl,
@@ -415,10 +532,10 @@ class FigmaService {
           );
         }
       ).filter(
-        (promise) => promise !== null
+        (task) => task !== null
       );
-      if (fillDownloads.length > 0) {
-        downloadPromises.push(Promise.all(fillDownloads));
+      if (fillTasks.length > 0) {
+        downloadPromises.push(runWithConcurrency(fillTasks, CONCURRENCY_LIMIT));
       }
     }
     if (renderNodes.length > 0) {
@@ -435,7 +552,7 @@ class FigmaService {
           "png",
           { pngScale }
         );
-        const pngDownloads = pngNodes.map(
+        const pngTasks = pngNodes.map(
           ({
             nodeId,
             fileName,
@@ -450,7 +567,7 @@ class FigmaService {
               );
               return null;
             }
-            return downloadAndProcessImage(
+            return () => downloadAndProcessImage(
               fileName,
               resolvedPath,
               imageUrl,
@@ -463,10 +580,12 @@ class FigmaService {
             );
           }
         ).filter(
-          (promise) => promise !== null
+          (task) => task !== null
         );
-        if (pngDownloads.length > 0) {
-          downloadPromises.push(Promise.all(pngDownloads));
+        if (pngTasks.length > 0) {
+          downloadPromises.push(
+            runWithConcurrency(pngTasks, CONCURRENCY_LIMIT)
+          );
         }
       }
       if (svgNodes.length > 0) {
@@ -476,7 +595,7 @@ class FigmaService {
           "svg",
           { svgOptions }
         );
-        const svgDownloads = svgNodes.map(
+        const svgTasks = svgNodes.map(
           ({
             nodeId,
             fileName,
@@ -491,7 +610,7 @@ class FigmaService {
               );
               return null;
             }
-            return downloadAndProcessImage(
+            return () => downloadAndProcessImage(
               fileName,
               resolvedPath,
               imageUrl,
@@ -504,10 +623,12 @@ class FigmaService {
             );
           }
         ).filter(
-          (promise) => promise !== null
+          (task) => task !== null
         );
-        if (svgDownloads.length > 0) {
-          downloadPromises.push(Promise.all(svgDownloads));
+        if (svgTasks.length > 0) {
+          downloadPromises.push(
+            runWithConcurrency(svgTasks, CONCURRENCY_LIMIT)
+          );
         }
       }
     }
@@ -539,106 +660,6 @@ class FigmaService {
     return response;
   }
 }
-async function downloadFigmaImage(fileName, localPath, imageUrl, returnBuffer = false) {
-  try {
-    const response = await fetch(imageUrl, {
-      method: "GET"
-    });
-    if (!response.ok) {
-      throw new Error(`Failed to download image: ${response.statusText}`);
-    }
-    if (returnBuffer) {
-      const arrayBuffer = await response.arrayBuffer();
-      return arrayBuffer;
-    }
-    if (!fs.existsSync(localPath)) {
-      fs.mkdirSync(localPath, { recursive: true });
-    }
-    const fullPath = path.join(localPath, fileName);
-    const reader = response.body?.getReader();
-    if (!reader) {
-      throw new Error("Failed to get response body");
-    }
-    const writer = fs.createWriteStream(fullPath);
-    return new Promise((resolve, reject) => {
-      const processStream = async () => {
-        try {
-          while (true) {
-            const { done, value } = await reader.read();
-            if (done) {
-              writer.end();
-              break;
-            }
-            writer.write(value);
-          }
-        } catch (err) {
-          writer.end();
-          fs.unlink(fullPath, () => {
-          });
-          reject(err);
-        }
-      };
-      writer.on("finish", () => {
-        resolve(fullPath);
-      });
-      writer.on("error", (err) => {
-        reader.cancel();
-        fs.unlink(fullPath, () => {
-        });
-        reject(new Error(`Failed to write image: ${err.message}`));
-      });
-      processStream();
-    });
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    throw new Error(`Error downloading image: ${errorMessage}`);
-  }
-}
-function generateVarId(prefix = "var") {
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-  let result = "";
-  for (let i = 0; i < 6; i++) {
-    const randomIndex = Math.floor(Math.random() * chars.length);
-    result += chars[randomIndex];
-  }
-  return `${prefix}_${result}`;
-}
-function generateCSSShorthand(values, {
-  ignoreZero = true,
-  suffix = "px"
-} = {}) {
-  const { top, right, bottom, left } = values;
-  if (ignoreZero && top === 0 && right === 0 && bottom === 0 && left === 0) {
-    return void 0;
-  }
-  if (top === right && right === bottom && bottom === left) {
-    return `${top}${suffix}`;
-  }
-  if (right === left) {
-    if (top === bottom) {
-      return `${top}${suffix} ${right}${suffix}`;
-    }
-    return `${top}${suffix} ${right}${suffix} ${bottom}${suffix}`;
-  }
-  return `${top}${suffix} ${right}${suffix} ${bottom}${suffix} ${left}${suffix}`;
-}
-function isVisible(element) {
-  return element.visible ?? true;
-}
-function pixelRound(num) {
-  if (isNaN(num)) {
-    throw new TypeError(`Input must be a valid number`);
-  }
-  return Number(Number(num).toFixed(2));
-}
-const common = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  downloadFigmaImage,
-  generateCSSShorthand,
-  generateVarId,
-  isVisible,
-  pixelRound
-}, Symbol.toStringTag, { value: "Module" }));
 function hasValue(key, obj, typeGuard) {
   const isObject = typeof obj === "object" && obj !== null;
   if (!isObject || !(key in obj)) return false;

package/dist/utils/common.d.ts

@@ -68,3 +68,10 @@ export declare function isVisible(element: {
  * @throws TypeError If the input is not a valid number
  */
 export declare function pixelRound(num: number): number;
+/**
+ * Run a list of async tasks with a concurrency limit
+ * @param tasks - Array of functions that return a Promise
+ * @param limit - Maximum number of concurrent tasks
+ * @returns Promise resolving to array of results
+ */
+export declare function runWithConcurrency<T>(tasks: Array<() => Promise<T>>, limit: number): Promise<T[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figma-metadata-extractor",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Extract metadata and download images from Figma files. A standalone library for accessing Figma design data and downloading frame images programmatically.",
   "type": "module",
   "main": "dist/index.cjs",