@design-sdk/figma-url 0.0.53 → 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,161 @@
+type FigmaEmbedInput = string | {
+    url: string;
+} | {
+    fileid: string;
+    nodeid?: string;
+};
+/**
+ * build embedding url. - https://www.figma.com/developers/embed
+ * @param src : ;
+ * @returns
+ */
+declare function embed(src: FigmaEmbedInput): string;
+/**
+ * e.g. - https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ *
+ * (*this does not contain logic for checking if input url is valid.*)
+ * @param src : ;
+ * @returns
+ */
+declare function builEmbedableSourceUrl(src?: FigmaEmbedInput): string | undefined;
+
+/**
+ * target node configuration for figma node that contains all fileid, nodeid and the figma url of the target.
+ */
+interface FigmaTargetNodeConfig {
+    /**
+     * url of target node originated from figma
+     */
+    url: string;
+    /**
+     * id of the file originated from figma
+     */
+    file: string;
+    /**
+     * id of the node originated from figma
+     */
+    node: string;
+}
+
+/**
+ * extracts file id from share link
+ *
+ * Supports multiple Figma URL patterns:
+ * - Old: "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ *
+ * out - "Y0Gh77AqBoHH7dG1GtK3xF"
+ * @param url
+ * @returns
+ */
+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
+ */
+declare function formatNodeId(node_id: string): string;
+/**
+ * pattern examples:
+ * - "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * @param url
+ */
+declare function parseFileAndNodeId(url: string): FigmaTargetNodeConfig | undefined;
+
+/**
+ * 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
+ *
+ */
+declare function isPublic(url: string): Promise<boolean>;
+
+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"
+}
+declare enum FigmaFileOrNodeIdType {
+    nodeid = "nodeid",
+    maybe_nodeid = "maybe_nodeid",
+    fileid = "fileid",
+    maybe_fileid = "maybe_fileid"
+}
+type FigmaInputAnalysisResult = FigmaUrlType | FigmaFileOrNodeIdType;
+declare function analyze(url: string): FigmaInputAnalysisResult;
+
+/**
+ * e.g. full url should look like -
+ * https://www.figma.com/embed?embed_host=astra&url=https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ *
+ * ref: https://www.figma.com/developers/embed
+ */
+declare const _FIGMA_EMBED_URL_PREFIX = "https://www.figma.com/embed";
+/**
+ * Legacy file URL prefix (for backward compatibility)
+ * e.g. full url should look like -
+ * https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_FILE_URL_PREFIX = "https://www.figma.com/file";
+/**
+ * Design file URL prefix (current standard, replaces /file/)
+ * e.g. full url should look like -
+ * https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_DESIGN_URL_PREFIX = "https://www.figma.com/design";
+/**
+ * FigJam board URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/board/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_BOARD_URL_PREFIX = "https://www.figma.com/board";
+/**
+ * Figma Slides URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/slides/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_SLIDES_URL_PREFIX = "https://www.figma.com/slides";
+/**
+ * Figma Site URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/site/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_SITE_URL_PREFIX = "https://www.figma.com/site";
+/**
+ * param key for node id specification.
+ *
+ * e.g. - `https://www.figma.com/file/ABC/?node-id=1234` `(node-id = 1234)`
+ */
+declare const _PARAM_NODE_ID = "node-id";
+/**
+ * file id of Grida design - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/
+ */
+declare const __FIGMA_DEMO_DEFAULT_FILE_ID = "Y0Gh77AqBoHH7dG1GtK3xF";
+declare const __FIGMA_DEMO_DEFAULT_FILE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/";
+declare const __FIGMA_DEMO_DEFAULT_FILE_NODE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49";
+
+declare function isSameDesignUrl(url1: string, url2: string): boolean;
+
+export { type FigmaEmbedInput, FigmaFileOrNodeIdType, type FigmaInputAnalysisResult, type FigmaTargetNodeConfig, 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 };

package/dist/index.d.ts

@@ -1,7 +1,161 @@
-export * from "./embed-url";
-export * from "./parse-url";
-export * from "./access-check";
-export * from "./analyze-url";
-export * from "./target-node-config";
-export * from "./constants";
-export * from "./compare-url";
+type FigmaEmbedInput = string | {
+    url: string;
+} | {
+    fileid: string;
+    nodeid?: string;
+};
+/**
+ * build embedding url. - https://www.figma.com/developers/embed
+ * @param src : ;
+ * @returns
+ */
+declare function embed(src: FigmaEmbedInput): string;
+/**
+ * e.g. - https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ *
+ * (*this does not contain logic for checking if input url is valid.*)
+ * @param src : ;
+ * @returns
+ */
+declare function builEmbedableSourceUrl(src?: FigmaEmbedInput): string | undefined;
+
+/**
+ * target node configuration for figma node that contains all fileid, nodeid and the figma url of the target.
+ */
+interface FigmaTargetNodeConfig {
+    /**
+     * url of target node originated from figma
+     */
+    url: string;
+    /**
+     * id of the file originated from figma
+     */
+    file: string;
+    /**
+     * id of the node originated from figma
+     */
+    node: string;
+}
+
+/**
+ * extracts file id from share link
+ *
+ * Supports multiple Figma URL patterns:
+ * - Old: "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - New: "https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ *
+ * out - "Y0Gh77AqBoHH7dG1GtK3xF"
+ * @param url
+ * @returns
+ */
+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
+ */
+declare function formatNodeId(node_id: string): string;
+/**
+ * pattern examples:
+ * - "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/design/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/board/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/slides/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * - "https://www.figma.com/site/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=775%3A112"
+ * @param url
+ */
+declare function parseFileAndNodeId(url: string): FigmaTargetNodeConfig | undefined;
+
+/**
+ * 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
+ *
+ */
+declare function isPublic(url: string): Promise<boolean>;
+
+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"
+}
+declare enum FigmaFileOrNodeIdType {
+    nodeid = "nodeid",
+    maybe_nodeid = "maybe_nodeid",
+    fileid = "fileid",
+    maybe_fileid = "maybe_fileid"
+}
+type FigmaInputAnalysisResult = FigmaUrlType | FigmaFileOrNodeIdType;
+declare function analyze(url: string): FigmaInputAnalysisResult;
+
+/**
+ * e.g. full url should look like -
+ * https://www.figma.com/embed?embed_host=astra&url=https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ *
+ * ref: https://www.figma.com/developers/embed
+ */
+declare const _FIGMA_EMBED_URL_PREFIX = "https://www.figma.com/embed";
+/**
+ * Legacy file URL prefix (for backward compatibility)
+ * e.g. full url should look like -
+ * https://www.figma.com/file/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_FILE_URL_PREFIX = "https://www.figma.com/file";
+/**
+ * Design file URL prefix (current standard, replaces /file/)
+ * e.g. full url should look like -
+ * https://www.figma.com/design/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_DESIGN_URL_PREFIX = "https://www.figma.com/design";
+/**
+ * FigJam board URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/board/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_BOARD_URL_PREFIX = "https://www.figma.com/board";
+/**
+ * Figma Slides URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/slides/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_SLIDES_URL_PREFIX = "https://www.figma.com/slides";
+/**
+ * Figma Site URL prefix
+ * e.g. full url should look like -
+ * https://www.figma.com/site/HSozKEVWhh8saZa2vr1Nxd?node-id=111%3A0
+ */
+declare const _FIGMA_SITE_URL_PREFIX = "https://www.figma.com/site";
+/**
+ * param key for node id specification.
+ *
+ * e.g. - `https://www.figma.com/file/ABC/?node-id=1234` `(node-id = 1234)`
+ */
+declare const _PARAM_NODE_ID = "node-id";
+/**
+ * file id of Grida design - https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/
+ */
+declare const __FIGMA_DEMO_DEFAULT_FILE_ID = "Y0Gh77AqBoHH7dG1GtK3xF";
+declare const __FIGMA_DEMO_DEFAULT_FILE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/";
+declare const __FIGMA_DEMO_DEFAULT_FILE_NODE_URL = "https://www.figma.com/file/Y0Gh77AqBoHH7dG1GtK3xF/?node-id=264%3A49";
+
+declare function isSameDesignUrl(url1: string, url2: string): boolean;
+
+export { type FigmaEmbedInput, FigmaFileOrNodeIdType, type FigmaInputAnalysisResult, type FigmaTargetNodeConfig, 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 };

package/dist/index.js

@@ -1,19 +1,215 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./embed-url"), exports);
-__exportStar(require("./parse-url"), exports);
-__exportStar(require("./access-check"), exports);
-__exportStar(require("./analyze-url"), exports);
-__exportStar(require("./target-node-config"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./compare-url"), exports);
+'use strict';
+
+// 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;
+  }
+}
+
+exports.FigmaFileOrNodeIdType = FigmaFileOrNodeIdType;
+exports.FigmaUrlType = FigmaUrlType;
+exports._FIGMA_BOARD_URL_PREFIX = _FIGMA_BOARD_URL_PREFIX;
+exports._FIGMA_DESIGN_URL_PREFIX = _FIGMA_DESIGN_URL_PREFIX;
+exports._FIGMA_EMBED_URL_PREFIX = _FIGMA_EMBED_URL_PREFIX;
+exports._FIGMA_FILE_URL_PREFIX = _FIGMA_FILE_URL_PREFIX;
+exports._FIGMA_SITE_URL_PREFIX = _FIGMA_SITE_URL_PREFIX;
+exports._FIGMA_SLIDES_URL_PREFIX = _FIGMA_SLIDES_URL_PREFIX;
+exports._PARAM_NODE_ID = _PARAM_NODE_ID;
+exports.__FIGMA_DEMO_DEFAULT_FILE_ID = __FIGMA_DEMO_DEFAULT_FILE_ID;
+exports.__FIGMA_DEMO_DEFAULT_FILE_NODE_URL = __FIGMA_DEMO_DEFAULT_FILE_NODE_URL;
+exports.__FIGMA_DEMO_DEFAULT_FILE_URL = __FIGMA_DEMO_DEFAULT_FILE_URL;
+exports.analyze = analyze;
+exports.builEmbedableSourceUrl = builEmbedableSourceUrl;
+exports.embed = embed;
+exports.formatNodeId = formatNodeId;
+exports.isPublic = isPublic;
+exports.isSameDesignUrl = isSameDesignUrl;
+exports.parseFileAndNodeId = parseFileAndNodeId;
+exports.parseFileId = parseFileId;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.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.js","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"]}