@design-sdk/figma-url 0.0.53 → 0.1.0

package/dist/index.mjs

@@ -0,0 +1,194 @@
+// lib/constants.ts
+var _FIGMA_EMBED_URL_PREFIX = "https://www.figma.com/embed";
+var _FIGMA_FILE_URL_PREFIX = "https://www.figma.com/file";
+var _FIGMA_DESIGN_URL_PREFIX = "https://www.figma.com/design";
+var _FIGMA_BOARD_URL_PREFIX = "https://www.figma.com/board";
+var _FIGMA_SLIDES_URL_PREFIX = "https://www.figma.com/slides";
+var _FIGMA_SITE_URL_PREFIX = "https://www.figma.com/site";
+var _PARAM_NODE_ID = "node-id";
+var __FIGMA_DEMO_DEFAULT_FILE_ID = "Y0Gh77AqBoHH7dG1GtK3xF";
+var __FIGMA_DEMO_DEFAULT_FILE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/";
+var __FIGMA_DEMO_DEFAULT_FILE_NODE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49";
+
+// lib/parse-url.ts
+function parseFileId(url) {
+  const supportedPatterns = [
+    "https://www.figma.com/file/",
+    "https://www.figma.com/design/",
+    "https://www.figma.com/board/",
+    "https://www.figma.com/slides/",
+    "https://www.figma.com/site/"
+  ];
+  const matchedPattern = supportedPatterns.find(
+    (pattern) => url.includes(pattern)
+  );
+  if (matchedPattern) {
+    return url.split("/")[4];
+  } else {
+    throw `figma url must contain one of the supported patterns (file/, design/, board/, slides/, site/). the given was ${url}, which we cannot extract file id from it.`;
+  }
+}
+function formatNodeId(node_id) {
+  if (node_id.includes(":") || node_id.includes("%3A") || node_id.includes("-")) {
+    if (node_id.includes("%3A")) {
+      node_id = decodeURIComponent(node_id);
+    }
+    if (node_id.includes("-")) {
+      node_id = node_id.split("-").join(":");
+    }
+    if (node_id.match(/[0-9]+:[0-9]+/) !== null) {
+      return node_id;
+    }
+  }
+}
+function parseFileAndNodeId(url) {
+  try {
+    const _url = new URL(url);
+    const params = new URLSearchParams(_url.search);
+    const nodeId = formatNodeId(params.get("node-id"));
+    const fileId = parseFileId(url);
+    return {
+      url,
+      file: fileId,
+      node: nodeId
+    };
+  } catch (_) {
+    return;
+  }
+}
+
+// lib/analyze-url.ts
+var FigmaUrlType = /* @__PURE__ */ ((FigmaUrlType2) => {
+  FigmaUrlType2["embed"] = "embed";
+  FigmaUrlType2["file"] = "file";
+  FigmaUrlType2["node"] = "node";
+  FigmaUrlType2["empty"] = "empty";
+  return FigmaUrlType2;
+})(FigmaUrlType || {});
+var FigmaFileOrNodeIdType = /* @__PURE__ */ ((FigmaFileOrNodeIdType2) => {
+  FigmaFileOrNodeIdType2["nodeid"] = "nodeid";
+  FigmaFileOrNodeIdType2["maybe_nodeid"] = "maybe_nodeid";
+  FigmaFileOrNodeIdType2["fileid"] = "fileid";
+  FigmaFileOrNodeIdType2["maybe_fileid"] = "maybe_fileid";
+  return FigmaFileOrNodeIdType2;
+})(FigmaFileOrNodeIdType || {});
+function analyze(url) {
+  if (!url) {
+    return "empty" /* empty */;
+  }
+  let _u;
+  try {
+    _u = new URL(url);
+  } catch (_) {
+    const maybeidlike = url;
+    if (maybeidlike.length > 0) {
+      if (formatNodeId(maybeidlike)) {
+        return "maybe_nodeid" /* maybe_nodeid */;
+      } else if (maybeidlike.length >= 22) {
+        const _taget = decodeURI(maybeidlike);
+        if (_taget.match(/[a-zA-Z0-9]/) !== null) {
+          if (_taget.length == 22) {
+            return "fileid" /* fileid */;
+          } else {
+            return "maybe_fileid" /* maybe_fileid */;
+          }
+        }
+      }
+    }
+    throw `this url cannot be analyzed. this is not a valid url string - "${url}"`;
+  }
+  if (url.startsWith(_FIGMA_EMBED_URL_PREFIX)) {
+    return "embed" /* embed */;
+  } else {
+    if (_u.hostname == "figma.com" || _u.hostname == "www.figma.com") {
+      const supportedPathPatterns = [
+        "file/",
+        "design/",
+        "board/",
+        "slides/",
+        "site/"
+      ];
+      const matchedPattern = supportedPathPatterns.find(
+        (pattern) => _u.pathname.includes(pattern)
+      );
+      if (matchedPattern) {
+        if (_u.searchParams.get(_PARAM_NODE_ID)?.length > 0) {
+          return "node" /* node */;
+        } else {
+          return "file" /* file */;
+        }
+      }
+    }
+    throw `not a valid figma url.`;
+  }
+}
+
+// lib/embed-url.ts
+function embed(src) {
+  const url = builEmbedableSourceUrl(src);
+  const urltype = analyze(url);
+  switch (urltype) {
+    case "embed" /* embed */:
+      return url;
+    case "file" /* file */:
+      console.warn(
+        "incomplete url input. the target node is not specified in the embedding target source url. this wont display contents as expected"
+      );
+      return _build(url);
+    case "node" /* node */:
+      return _build(url);
+    case "empty" /* empty */:
+      return;
+  }
+}
+function _build(url) {
+  const _embed_url = `${_FIGMA_EMBED_URL_PREFIX}?embed_host=astra&url=${url}`;
+  return _embed_url;
+}
+function builEmbedableSourceUrl(src) {
+  if (!src) {
+    return;
+  }
+  if (typeof src == "string") {
+    return src;
+  } else if ("url" in src) {
+    return src.url;
+  } else if ("fileid" in src) {
+    return `https://www.figma.com/design/${src.fileid}/${src.nodeid && `?node-id=${src.nodeid}`}`;
+  } else {
+    return void 0;
+  }
+}
+
+// lib/access-check.ts
+async function isPublic(url) {
+  analyze(url);
+  {
+    try {
+      const res = await fetch(url);
+      return res.status == 200;
+    } catch (e) {
+      return false;
+    }
+  }
+  return false;
+}
+
+// lib/compare-url.ts
+function isSameDesignUrl(url1, url2) {
+  const analysis = analyze(url1);
+  switch (analysis) {
+    case "embed" /* embed */:
+    case "empty" /* empty */:
+    case "file" /* file */:
+      return false;
+    case "node" /* node */:
+      const parsed = parseFileAndNodeId(url1);
+      const _this_parsed = parseFileAndNodeId(url2);
+      return _this_parsed.file === parsed.file && _this_parsed.node === parsed.node;
+  }
+}
+
+export { FigmaFileOrNodeIdType, FigmaUrlType, _FIGMA_BOARD_URL_PREFIX, _FIGMA_DESIGN_URL_PREFIX, _FIGMA_EMBED_URL_PREFIX, _FIGMA_FILE_URL_PREFIX, _FIGMA_SITE_URL_PREFIX, _FIGMA_SLIDES_URL_PREFIX, _PARAM_NODE_ID, __FIGMA_DEMO_DEFAULT_FILE_ID, __FIGMA_DEMO_DEFAULT_FILE_NODE_URL, __FIGMA_DEMO_DEFAULT_FILE_URL, analyze, builEmbedableSourceUrl, embed, formatNodeId, isPublic, isSameDesignUrl, parseFileAndNodeId, parseFileId };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../lib/constants.ts","../lib/parse-url.ts","../lib/analyze-url.ts","../lib/embed-url.ts","../lib/access-check.ts","../lib/compare-url.ts"],"names":["FigmaUrlType","FigmaFileOrNodeIdType"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * e.g. full url should look like -\n * https://www.figma.com/embed?embed_host=astra&url=https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n *\n * ref: https://www.figma.com/developers/embed\n */\nexport const _FIGMA_EMBED_URL_PREFIX = \"https://www.figma.com/embed\";\n\n/**\n * Legacy file URL prefix (for backward compatibility)\n * e.g. full url should look like -\n * https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n */\nexport const _FIGMA_FILE_URL_PREFIX = \"https://www.figma.com/file\";\n\n/**\n * Design file URL prefix (current standard, replaces /file/)\n * e.g. full url should look like -\n * https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n */\nexport const _FIGMA_DESIGN_URL_PREFIX = \"https://www.figma.com/design\";\n\n/**\n * FigJam board URL prefix\n * e.g. full url should look like -\n * https://www.figma.com/board/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n */\nexport const _FIGMA_BOARD_URL_PREFIX = \"https://www.figma.com/board\";\n\n/**\n * Figma Slides URL prefix\n * e.g. full url should look like -\n * https://www.figma.com/slides/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n */\nexport const _FIGMA_SLIDES_URL_PREFIX = \"https://www.figma.com/slides\";\n\n/**\n * Figma Site URL prefix\n * e.g. full url should look like -\n * https://www.figma.com/site/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n */\nexport const _FIGMA_SITE_URL_PREFIX = \"https://www.figma.com/site\";\n\n/**\n * param key for node id specification.\n *\n * e.g. - `https://www.figma.com/file/ABC/?node-id=1234` `(node-id = 1234)`\n */\nexport const _PARAM_NODE_ID = \"node-id\";\n\n// ======================================================================================================\n// escape with __ for \"super-internal\" usage\n/**\n * file id of Grida design - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/\n */\nexport const __FIGMA_DEMO_DEFAULT_FILE_ID = \"Y0Gh77AqBoHH7dG1GtK3xF\";\nexport const __FIGMA_DEMO_DEFAULT_FILE_URL =\n  \"https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/\";\nexport const __FIGMA_DEMO_DEFAULT_FILE_NODE_URL =\n  \"https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49\";\n// ======================================================================================================\n","import { FigmaTargetNodeConfig } from \"./target-node-config\";\n\n/**\n * extracts file id from share link\n *\n * Supports multiple Figma URL patterns:\n * - Old: \"https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - New: \"https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - New: \"https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - New: \"https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - New: \"https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n *\n * out - \"Y0Gh77AqBoHH7dG1GtK3xF\"\n * @param url\n * @returns\n */\nexport function parseFileId(url: string) {\n  // File ID is in the same position (4th segment) for all URL patterns\n  const supportedPatterns = [\n    \"https://www.figma.com/file/\",\n    \"https://www.figma.com/design/\",\n    \"https://www.figma.com/board/\",\n    \"https://www.figma.com/slides/\",\n    \"https://www.figma.com/site/\",\n  ];\n\n  const matchedPattern = supportedPatterns.find((pattern) =>\n    url.includes(pattern)\n  );\n\n  if (matchedPattern) {\n    return url.split(\"/\")[4];\n  } else {\n    throw `figma url must contain one of the supported patterns (file/, design/, board/, slides/, site/). the given was ${url}, which we cannot extract file id from it.`;\n  }\n}\n\n/**\n * Figma file url's node-id changed over time, this function is to make sure we can handle both formats.\n * to keep `00:00` format\n * @param node_id\n * @returns\n */\nexport function formatNodeId(node_id: string) {\n  if (\n    node_id.includes(\":\") ||\n    node_id.includes(\"%3A\") ||\n    node_id.includes(\"-\")\n  ) {\n    // \"%3A\" is \":\" as in url encoding\n    if (node_id.includes(\"%3A\")) {\n      // decode value, assuming it is url encoded\n      node_id = decodeURIComponent(node_id);\n    }\n    if (node_id.includes(\"-\")) {\n      // if id is formatted with `-` instead of `:`, replace it.\n      node_id = node_id.split(\"-\").join(\":\");\n    }\n    // 2. run regex\n    if (node_id.match(/[0-9]+:[0-9]+/) !== null) {\n      return node_id;\n    }\n  }\n}\n\n/**\n * pattern examples:\n * - \"https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - \"https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - \"https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - \"https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * - \"https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112\"\n * @param url\n */\nexport function parseFileAndNodeId(\n  url: string\n): FigmaTargetNodeConfig | undefined {\n  try {\n    const _url = new URL(url);\n    const params = new URLSearchParams(_url.search);\n    const nodeId = formatNodeId(params.get(\"node-id\"));\n    const fileId = parseFileId(url);\n    return {\n      url: url,\n      file: fileId,\n      node: nodeId,\n    };\n  } catch (_) {\n    // empty url, invalud url\n    return;\n  }\n}\n","import {\n  _FIGMA_EMBED_URL_PREFIX,\n  _FIGMA_FILE_URL_PREFIX,\n  _PARAM_NODE_ID,\n} from \"./constants\";\nimport { formatNodeId } from \"./parse-url\";\n\nexport enum FigmaUrlType {\n  /**\n   * embed ready url\n   */\n  embed = \"embed\",\n\n  /**\n   * file id only url. this cannot be used for embedding (cannot be used as a source)\n   */\n  file = \"file\",\n\n  /**\n   * url with file & node this can be used for embedding. (can be used as a source)\n   */\n  node = \"node\",\n\n  /**\n   * empty url. undefined or \"\"\n   */\n  empty = \"empty\",\n}\n\nexport enum FigmaFileOrNodeIdType {\n  nodeid = \"nodeid\",\n  maybe_nodeid = \"maybe_nodeid\",\n  fileid = \"fileid\",\n  maybe_fileid = \"maybe_fileid\",\n}\n\nexport type FigmaInputAnalysisResult = FigmaUrlType | FigmaFileOrNodeIdType;\n\nexport function analyze(url: string): FigmaInputAnalysisResult {\n  if (!url) {\n    // return if url is empty\n    return FigmaUrlType.empty;\n  }\n  let _u: URL;\n\n  // pre url validation\n  try {\n    _u = new URL(url);\n  } catch (_) {\n    const maybeidlike = url;\n    if (maybeidlike.length > 0) {\n      if (formatNodeId(maybeidlike)) {\n        return FigmaFileOrNodeIdType.maybe_nodeid;\n      }\n\n      // e.g. kLzb7R9xYuuphfX4TssVNe\n      // e.g. 4hqwYFw6FKw1njvzEl3VUh\n      // fileid is 22 chars at this point.\n      else if (maybeidlike.length >= 22) {\n        const _taget = decodeURI(maybeidlike);\n        // figma file id does not contain special characters. it's like mongodb id\n        if (_taget.match(/[a-zA-Z0-9]/) !== null) {\n          if (_taget.length == 22) {\n            return FigmaFileOrNodeIdType.fileid;\n          } else {\n            return FigmaFileOrNodeIdType.maybe_fileid;\n          }\n        }\n      }\n    }\n\n    throw `this url cannot be analyzed. this is not a valid url string - \"${url}\"`;\n  }\n\n  //\n  if (url.startsWith(_FIGMA_EMBED_URL_PREFIX)) {\n    return FigmaUrlType.embed;\n  } else {\n    // you might think the value of the embed target might be encoded,\n    // so it is wrong to compare value with raw string,\n    // but the only case the url is encoded is when it's for embeding\n    // - which will be returned above. it's fine.\n    if (_u.hostname == \"figma.com\" || _u.hostname == \"www.figma.com\") {\n      // Support all Figma URL patterns: file/, design/, board/, slides/, site/\n      const supportedPathPatterns = [\n        \"file/\",\n        \"design/\",\n        \"board/\",\n        \"slides/\",\n        \"site/\",\n      ];\n      const matchedPattern = supportedPathPatterns.find((pattern) =>\n        _u.pathname.includes(pattern)\n      );\n\n      if (matchedPattern) {\n        if (_u.searchParams.get(_PARAM_NODE_ID)?.length > 0) {\n          return FigmaUrlType.node;\n        } else {\n          return FigmaUrlType.file;\n        }\n      }\n    }\n    // otherwise,\n    throw `not a valid figma url.`;\n  }\n}\n","import { analyze, FigmaUrlType } from \"./analyze-url\";\nimport { _FIGMA_EMBED_URL_PREFIX } from \"./constants\";\n\nexport type FigmaEmbedInput =\n  | string\n  | { url: string }\n  | { fileid: string; nodeid?: string };\n\n/**\n * build embedding url. - https://www.figma.com/developers/embed\n * @param src : ;\n * @returns\n */\nexport function embed(src: FigmaEmbedInput) {\n  const url = builEmbedableSourceUrl(src);\n  const urltype = analyze(url);\n  switch (urltype) {\n    case FigmaUrlType.embed:\n      return url;\n    case FigmaUrlType.file:\n      console.warn(\n        \"incomplete url input. the target node is not specified in the embedding target source url. this wont display contents as expected\"\n      );\n      return _build(url);\n    case FigmaUrlType.node:\n      return _build(url);\n    case FigmaUrlType.empty:\n      return;\n  }\n}\n\nfunction _build(url: string) {\n  const _embed_url = `${_FIGMA_EMBED_URL_PREFIX}?embed_host=astra&url=${url}`;\n  return _embed_url;\n}\n\n/**\n * e.g. - https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0\n *\n * (*this does not contain logic for checking if input url is valid.*)\n * @param src : ;\n * @returns\n */\nexport function builEmbedableSourceUrl(\n  src?: FigmaEmbedInput\n): string | undefined {\n  if (!src) {\n    return;\n  }\n\n  if (typeof src == \"string\") {\n    return src;\n  } else if (\"url\" in src) {\n    return src.url;\n  } else if (\"fileid\" in src) {\n    /// WWW prefix is required. if non passed, figma embed won't accept it.\n    /// Use /design/ pattern for new URLs (replaces /file/)\n    return `https://www.figma.com/design/${src.fileid}/${\n      src.nodeid && `?node-id=${src.nodeid}`\n    }`;\n  } else {\n    return undefined;\n  }\n}\n","///\n/// simple functions to check if file is accessible by public.\n///\n\nimport { analyze, FigmaUrlType } from \"./analyze-url\";\n\n/**\n * e.g.\n *\n * - **ok**: (public file) - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/grida?node-id=1545%3A247\n * - **not found**: (private file) - https://www.figma.com/file/8R57Uv5Siu1ZhhGkVIyyQg/private-file-api-demo?node-id=2%3A2\n *\n */\nexport async function isPublic(url: string): Promise<boolean> {\n  const type = analyze(url);\n  if (type == FigmaUrlType.embed || FigmaUrlType.file || FigmaUrlType.node) {\n    try {\n      const res = await fetch(url);\n      return res.status == 200;\n    } catch (e) {\n      return false;\n    }\n  }\n  return false;\n}\n","import { analyze, FigmaUrlType } from \"./analyze-url\";\nimport { parseFileAndNodeId } from \"./parse-url\";\n\nexport function isSameDesignUrl(url1: string, url2: string): boolean {\n  const analysis = analyze(url1);\n  switch (analysis) {\n    case FigmaUrlType.embed:\n    case FigmaUrlType.empty:\n    case FigmaUrlType.file:\n      return false;\n    case FigmaUrlType.node:\n      const parsed = parseFileAndNodeId(url1);\n      const _this_parsed = parseFileAndNodeId(url2);\n      return (\n        _this_parsed.file === parsed.file && _this_parsed.node === parsed.node\n      );\n  }\n}\n"]}

package/package.json

@@ -1,29 +1,33 @@
 {
-    "name": "@design-sdk/figma-url",
-    "version": "0.0.53",
-    "description": "Figma url utils for sharing & embeding and url inspection",
-    "license": "MIT",
-    "private": false,
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "homepage": "https://github.com/gridaco/design-sdk",
-    "repository": "https://github.com/gridaco/design-sdk",
-    "authors": [
-        "grida.co",
-        "softmarshmallow <universe@grida.co>"
-    ],
-    "scripts": {
-        "clean": "rimraf dist",
-        "build": "tsc",
-        "test": "jest"
-    },
-    "files": [
-        "dist",
-        "README",
-        "LICENSE"
-    ],
-    "publishConfig": {
-        "access": "public"
-    },
-    "gitHead": "5784ab284f17fcb2b20bc821fc140fd004964d7e"
-}
+  "name": "@design-sdk/figma-url",
+  "version": "0.1.0",
+  "description": "Figma url utils for sharing & embeding and url inspection",
+  "license": "MIT",
+  "private": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "homepage": "https://github.com/gridaco/figma-sdk",
+  "repository": "https://github.com/gridaco/figma-sdk",
+  "authors": [
+    "grida.co",
+    "softmarshmallow <universe@grida.co>"
+  ],
+  "files": [
+    "dist",
+    "README",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.16"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "build": "tsup lib/index.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/dist/access-check.d.ts

@@ -1,8 +0,0 @@
-/**
- * e.g.
- *
- * - **ok**: (public file) - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/grida?node-id=1545%3A247
- * - **not found**: (private file) - https://www.figma.com/file/8R57Uv5Siu1ZhhGkVIyyQg/private-file-api-demo?node-id=2%3A2
- *
- */
-export declare function isPublic(url: string): Promise<boolean>;

package/dist/access-check.js

@@ -1,39 +0,0 @@
-"use strict";
-///
-/// simple functions to check if file is accessible by public.
-///
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPublic = void 0;
-const analyze_url_1 = require("./analyze-url");
-/**
- * e.g.
- *
- * - **ok**: (public file) - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/grida?node-id=1545%3A247
- * - **not found**: (private file) - https://www.figma.com/file/8R57Uv5Siu1ZhhGkVIyyQg/private-file-api-demo?node-id=2%3A2
- *
- */
-function isPublic(url) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const type = (0, analyze_url_1.analyze)(url);
-        if (type == analyze_url_1.FigmaUrlType.embed || analyze_url_1.FigmaUrlType.file || analyze_url_1.FigmaUrlType.node) {
-            try {
-                const res = yield fetch(url);
-                return res.status == 200;
-            }
-            catch (e) {
-                return false;
-            }
-        }
-        return false;
-    });
-}
-exports.isPublic = isPublic;

package/dist/analyze-url.d.ts

@@ -1,26 +0,0 @@
-export declare enum FigmaUrlType {
-    /**
-     * embed ready url
-     */
-    embed = "embed",
-    /**
-     * file id only url. this cannot be used for embedding (cannot be used as a source)
-     */
-    file = "file",
-    /**
-     * url with file & node this can be used for embedding. (can be used as a source)
-     */
-    node = "node",
-    /**
-     * empty url. undefined or ""
-     */
-    empty = "empty"
-}
-export declare enum FigmaFileOrNodeIdType {
-    nodeid = "nodeid",
-    maybe_nodeid = "maybe_nodeid",
-    fileid = "fileid",
-    maybe_fileid = "maybe_fileid"
-}
-export declare type FigmaInputAnalysisResult = FigmaUrlType | FigmaFileOrNodeIdType;
-export declare function analyze(url: string): FigmaInputAnalysisResult;

package/dist/analyze-url.js

@@ -1,91 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyze = exports.FigmaFileOrNodeIdType = exports.FigmaUrlType = void 0;
-const constants_1 = require("./constants");
-const parse_url_1 = require("./parse-url");
-var FigmaUrlType;
-(function (FigmaUrlType) {
-    /**
-     * embed ready url
-     */
-    FigmaUrlType["embed"] = "embed";
-    /**
-     * file id only url. this cannot be used for embedding (cannot be used as a source)
-     */
-    FigmaUrlType["file"] = "file";
-    /**
-     * url with file & node this can be used for embedding. (can be used as a source)
-     */
-    FigmaUrlType["node"] = "node";
-    /**
-     * empty url. undefined or ""
-     */
-    FigmaUrlType["empty"] = "empty";
-})(FigmaUrlType = exports.FigmaUrlType || (exports.FigmaUrlType = {}));
-var FigmaFileOrNodeIdType;
-(function (FigmaFileOrNodeIdType) {
-    FigmaFileOrNodeIdType["nodeid"] = "nodeid";
-    FigmaFileOrNodeIdType["maybe_nodeid"] = "maybe_nodeid";
-    FigmaFileOrNodeIdType["fileid"] = "fileid";
-    FigmaFileOrNodeIdType["maybe_fileid"] = "maybe_fileid";
-})(FigmaFileOrNodeIdType = exports.FigmaFileOrNodeIdType || (exports.FigmaFileOrNodeIdType = {}));
-function analyze(url) {
-    var _a;
-    if (!url) {
-        // return if url is empty
-        return FigmaUrlType.empty;
-    }
-    let _u;
-    // pre url validation
-    try {
-        _u = new URL(url);
-    }
-    catch (_) {
-        const maybeidlike = url;
-        if (maybeidlike.length > 0) {
-            if ((0, parse_url_1.formatNodeId)(maybeidlike)) {
-                return FigmaFileOrNodeIdType.maybe_nodeid;
-            }
-            // e.g. kLzb7R9xYuuphfX4TssVNe
-            // e.g. 4hqwYFw6FKw1njvzEl3VUh
-            // fileid is 22 chars at this point.
-            else if (maybeidlike.length >= 22) {
-                const _taget = decodeURI(maybeidlike);
-                // figma file id does not contain special characters. it's like mongodb id
-                if (_taget.match(/[a-zA-Z0-9]/) !== null) {
-                    if (_taget.length == 22) {
-                        return FigmaFileOrNodeIdType.fileid;
-                    }
-                    else {
-                        return FigmaFileOrNodeIdType.maybe_fileid;
-                    }
-                }
-            }
-        }
-        throw `this url cannot be analyzed. this is not a valid url string - "${url}"`;
-    }
-    //
-    if (url.startsWith(constants_1._FIGMA_EMBED_URL_PREFIX)) {
-        return FigmaUrlType.embed;
-    }
-    else {
-        // you might think the value of the embed target might be encoded,
-        // so it is wrong to compare value with raw string,
-        // but the only case the url is encoded is when it's for embeding
-        // - which will be returned above. it's fine.
-        if (_u.hostname == "figma.com" || _u.hostname == "www.figma.com") {
-            // file path is required for both file and node.
-            if (_u.pathname.includes("file/")) {
-                if (((_a = _u.searchParams.get(constants_1._PARAM_NODE_ID)) === null || _a === void 0 ? void 0 : _a.length) > 0) {
-                    return FigmaUrlType.node;
-                }
-                else {
-                    return FigmaUrlType.file;
-                }
-            }
-        }
-        // otherwise,
-        throw `not a valid figma url.`;
-    }
-}
-exports.analyze = analyze;

package/dist/compare-url.d.ts

@@ -1 +0,0 @@
-export declare function isSameDesignUrl(url1: string, url2: string): boolean;

package/dist/compare-url.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSameDesignUrl = void 0;
-const analyze_url_1 = require("./analyze-url");
-const parse_url_1 = require("./parse-url");
-function isSameDesignUrl(url1, url2) {
-    const analysis = (0, analyze_url_1.analyze)(url1);
-    switch (analysis) {
-        case analyze_url_1.FigmaUrlType.embed:
-        case analyze_url_1.FigmaUrlType.empty:
-        case analyze_url_1.FigmaUrlType.file:
-            return false;
-        case analyze_url_1.FigmaUrlType.node:
-            const parsed = (0, parse_url_1.parseFileAndNodeId)(url1);
-            const _this_parsed = (0, parse_url_1.parseFileAndNodeId)(url2);
-            return (_this_parsed.file === parsed.file && _this_parsed.node === parsed.node);
-    }
-}
-exports.isSameDesignUrl = isSameDesignUrl;

package/dist/constants.d.ts

@@ -1,24 +0,0 @@
-/**
- * e.g. full url should look like -
- * https://www.figma.com/embed?embed_host=astra&url=https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- *
- * ref: https://www.figma.com/developers/embed
- */
-export declare const _FIGMA_EMBED_URL_PREFIX = "https://www.figma.com/embed";
-/**
- * e.g. full url should look like -
- * https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- */
-export declare const _FIGMA_FILE_URL_PREFIX = "https://www.figma.com/file";
-/**
- * param key for node id specification.
- *
- * e.g. - `https://www.figma.com/file/ABC/?node-id=1234` `(node-id = 1234)`
- */
-export declare const _PARAM_NODE_ID = "node-id";
-/**
- * file id of Grida design - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/
- */
-export declare const __FIGMA_DEMO_DEFAULT_FILE_ID = "Y0Gh77AqBoHH7dG1GtK3xF";
-export declare const __FIGMA_DEMO_DEFAULT_FILE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/";
-export declare const __FIGMA_DEMO_DEFAULT_FILE_NODE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49";

package/dist/constants.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.__FIGMA_DEMO_DEFAULT_FILE_NODE_URL = exports.__FIGMA_DEMO_DEFAULT_FILE_URL = exports.__FIGMA_DEMO_DEFAULT_FILE_ID = exports._PARAM_NODE_ID = exports._FIGMA_FILE_URL_PREFIX = exports._FIGMA_EMBED_URL_PREFIX = void 0;
-/**
- * e.g. full url should look like -
- * https://www.figma.com/embed?embed_host=astra&url=https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- *
- * ref: https://www.figma.com/developers/embed
- */
-exports._FIGMA_EMBED_URL_PREFIX = "https://www.figma.com/embed";
-/**
- * e.g. full url should look like -
- * https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- */
-exports._FIGMA_FILE_URL_PREFIX = "https://www.figma.com/file";
-/**
- * param key for node id specification.
- *
- * e.g. - `https://www.figma.com/file/ABC/?node-id=1234` `(node-id = 1234)`
- */
-exports._PARAM_NODE_ID = "node-id";
-// ======================================================================================================
-// escape with __ for "super-internal" usage
-/**
- * file id of Grida design - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/
- */
-exports.__FIGMA_DEMO_DEFAULT_FILE_ID = "Y0Gh77AqBoHH7dG1GtK3xF";
-exports.__FIGMA_DEMO_DEFAULT_FILE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/";
-exports.__FIGMA_DEMO_DEFAULT_FILE_NODE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49";
-// ======================================================================================================

package/dist/embed-url.d.ts

@@ -1,20 +0,0 @@
-export declare type FigmaEmbedInput = string | {
-    url: string;
-} | {
-    fileid: string;
-    nodeid?: string;
-};
-/**
- * build embedding url. - https://www.figma.com/developers/embed
- * @param src : ;
- * @returns
- */
-export declare function embed(src: FigmaEmbedInput): string;
-/**
- * e.g. - https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- *
- * (*this does not contain logic for checking if input url is valid.*)
- * @param src : ;
- * @returns
- */
-export declare function builEmbedableSourceUrl(src?: FigmaEmbedInput): string | undefined;

package/dist/embed-url.js

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.builEmbedableSourceUrl = exports.embed = void 0;
-const analyze_url_1 = require("./analyze-url");
-const constants_1 = require("./constants");
-/**
- * build embedding url. - https://www.figma.com/developers/embed
- * @param src : ;
- * @returns
- */
-function embed(src) {
-    const url = builEmbedableSourceUrl(src);
-    const urltype = (0, analyze_url_1.analyze)(url);
-    switch (urltype) {
-        case analyze_url_1.FigmaUrlType.embed:
-            return url;
-        case analyze_url_1.FigmaUrlType.file:
-            console.warn("incomplete url input. the target node is not specified in the embedding target source url. this wont display contents as expected");
-            return _build(url);
-        case analyze_url_1.FigmaUrlType.node:
-            return _build(url);
-        case analyze_url_1.FigmaUrlType.empty:
-            return;
-    }
-}
-exports.embed = embed;
-function _build(url) {
-    const _embed_url = `${constants_1._FIGMA_EMBED_URL_PREFIX}?embed_host=astra&url=${url}`;
-    return _embed_url;
-}
-/**
- * e.g. - https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
- *
- * (*this does not contain logic for checking if input url is valid.*)
- * @param src : ;
- * @returns
- */
-function builEmbedableSourceUrl(src) {
-    if (!src) {
-        return;
-    }
-    if (typeof src == "string") {
-        return src;
-    }
-    else if ("url" in src) {
-        return src.url;
-    }
-    else if ("fileid" in src) {
-        /// WWW prefix is required. if non passed, figma embed won't accept it.
-        return `https://www.figma.com/file/${src.fileid}/${src.nodeid && `?node-id=${src.nodeid}`}`;
-    }
-    else {
-        return undefined;
-    }
-}
-exports.builEmbedableSourceUrl = builEmbedableSourceUrl;

package/dist/parse-url.d.ts

@@ -1,23 +0,0 @@
-import { FigmaTargetNodeConfig } from "./target-node-config";
-/**
- * extracts file id from share link
- *
- * e.g. in - "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
- *
- * out - "Y0Gh77AqBoHH7dG1GtK3xF"
- * @param url
- * @returns
- */
-export declare function parseFileId(url: string): string;
-/**
- * Figma file url's node-id changed over time, this function is to make sure we can handle both formats.
- * to keep `00:00` format
- * @param node_id
- * @returns
- */
-export declare function formatNodeId(node_id: string): string;
-/**
- * pattern is "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
- * @param url
- */
-export declare function parseFileAndNodeId(url: string): FigmaTargetNodeConfig | undefined;