@supernova-studio/client 0.59.3 → 0.59.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/client",
-  "version": "0.59.3",
+  "version": "0.59.4",
   "description": "Supernova Data Models",
   "source": "src/index.ts",
   "main": "dist/index.js",

package/src/utils/figma.ts

@@ -2,28 +2,47 @@ const figmaFileIdRegex = /^[0-9a-zA-Z]{22,128}$/;
 const nodeIdRegex = /^\d+-\d+$/;
 const nodeTypeRegex = /^[0-9a-zA-Z]^/;
 
-type ParsedFigmaFileURL = {
-  fileId: string;
-  fileName: string | null;
-  nodeId: string | null;
-  nodeType: string | null;
-};
+export enum ParsedFigmaFileURLError {
+  InvalidUrl = "InvalidUrl",
+  InvalidFigmaFileId = "InvalidFigmaFileId",
+}
+
+type ParsedFigmaFileURL =
+  | {
+      status: "Success";
+      fileId: string;
+      fileName: string | null;
+      nodeId: string | null;
+      nodeType: string | null;
+    }
+  | {
+      status: "Error";
+      error: ParsedFigmaFileURLError;
+    };
 
 export const FigmaUtils = {
-  tryParseFigmaFileURL(urlString: string): ParsedFigmaFileURL | null {
-    if (!URL.canParse(urlString)) return null;
+  tryParseFigmaFileURL(urlString: string): ParsedFigmaFileURL {
+    if (!URL.canParse(urlString)) {
+      return { status: "Error", error: ParsedFigmaFileURLError.InvalidUrl };
+    }
 
     // Validate that this is a Figma URL
     const url = new URL(urlString);
-    if (!url.hostname.endsWith("figma.com")) return null;
+    if (!url.hostname.endsWith("figma.com")) {
+      return { status: "Error", error: ParsedFigmaFileURLError.InvalidUrl };
+    }
 
     // Validate that the URL type is the correct one (pointing to a design file)
     const pathSegments = url.pathname.split("/");
-    if (pathSegments[1] !== "design" && pathSegments[1] !== "file") return null;
+    if (pathSegments[1] !== "design" && pathSegments[1] !== "file") {
+      return { status: "Error", error: ParsedFigmaFileURLError.InvalidUrl };
+    }
 
     // Validate Figma file ID
     const fileId = pathSegments[2];
-    if (!fileId || !fileId.match(figmaFileIdRegex)) return null;
+    if (!fileId || !fileId.match(figmaFileIdRegex)) {
+      return { status: "Error", error: ParsedFigmaFileURLError.InvalidFigmaFileId };
+    }
 
     // Parse Figma file name
     let fileName: string | null = null;
@@ -46,7 +65,7 @@ export const FigmaUtils = {
       nodeType = nodeTypeRaw;
     }
 
-    return { fileId, fileName, nodeId, nodeType };
+    return { status: "Success", fileId, fileName, nodeId, nodeType };
   },
 };