@animaapp/anima-sdk 0.3.1 → 0.3.5

package/dist/index.d.ts

@@ -58,14 +58,14 @@ export declare class CodegenError extends Error {
     detail?: unknown;
     constructor({ name, reason, status, detail, }: {
         name: string;
-        reason: CodegenErrorReason | SDKErrorReason;
+        reason: CodegenErrorReason | CodegenRouteErrorReason | SDKErrorReason;
         status?: number;
         detail?: unknown;
     });
 }
 
 /**
- * Errors from Public API
+ * Codegen errors from the worker
  */
 export declare type CodegenErrorReason = "Selected node type is not supported" | "Invisible group nodes are unsupported" | "Selected node is a page with multiple children" | "There is no node with the given id" | "Invalid Figma token" | "Anima API connection error" | "Figma token expired" | "Invalid user token" | "Figma file not found" | "Figma rate limit exceeded" | "Unknown";
 
@@ -76,6 +76,11 @@ export declare type CodegenResult = BaseResult & {
     }>;
 };
 
+/**
+ * Codegen errors from the "/codegen" route
+ */
+export declare type CodegenRouteErrorReason = "Missing Authorization header" | "Invalid Authorization header" | "Missing teamId" | "Internal server error" | "Forbidden, no team access" | "Requested Usage Exceeds Limit" | "Invalid Anima token";
+
 export declare type CodegenSettings = {
     language?: "typescript" | "javascript";
     model?: string;
@@ -113,16 +118,13 @@ export declare const createCodegenResponseEventStream: (anima: Anima, params: Ge
 export declare const createCodegenStream: (anima: Anima, params: GetCodeParams) => ReadableStream<StreamCodgenMessage>;
 
 export declare type FigmaApiError = {
-    cause?: {
-        body?: {
-            status?: number;
-            reason?: string;
+    cause: {
+        message?: string;
+        body: {
+            err: string;
+            status: number;
         };
     };
-    body?: {
-        status?: number;
-        reason?: string;
-    };
 };
 
 export declare type FigmaApiErrorType = "FigmaTokenIssue" | "RateLimitExceeded" | "NotFound" | "UnknownFigmaApiException";
@@ -137,12 +139,15 @@ export declare type FigmaPage = {
 export declare class FigmaTokenIssue extends Error {
     fileKey: string;
     reason: string;
-    constructor({ fileKey, reason }: {
+    constructor({ fileKey, reason, cause, }: {
         fileKey: string;
         reason: string;
+        cause?: unknown;
     });
 }
 
+export declare const findChildrenNode: (node: FigmaNode, targetNodeId: string) => FigmaNode | null;
+
 export declare const formatToFigmaLink: ({ fileKey, nodeId, duplicate, }: {
     fileKey: string;
     nodeId: string;
@@ -193,9 +198,7 @@ export declare type GetCodeParams = {
 
 export declare const getFigmaApiErrorType: (error: Error) => FigmaApiErrorType;
 
-export declare const getFigmaFile: ({ fileKey, authToken, figmaRestApi, params, }: GetFilePagesParams) => Promise<GetFigmaFileResult>;
-
-export declare type GetFigmaFileResult = GetFileResponse | undefined;
+export declare const getFigmaFile: ({ fileKey, authToken, figmaRestApi, params, }: GetFilePagesParams) => Promise<GetFileResponse>;
 
 export declare const getFileNodes: ({ fileKey, authToken, nodeIds, figmaRestApi, params, }: GetFileNodesParams) => Promise<{
     [key: string]: {
@@ -241,10 +244,15 @@ export declare const getRelatedScreenFiles: ({ files, screenPath, }: {
     screenPath?: string;
 }) => AnimaFiles;
 
-export declare const handleFigmaApiError: (error: FigmaApiError, fileKey: string) => never;
+declare type InvalidNodeForCodegenReason = "Selected node is a page with multiple children" | "There is no node with the given id" | "Selected node type is not supported";
 
 export declare const isFigmaTokenIssue: (error: Error) => boolean;
 
+/**
+ * Check if the pair "design" + "node id" are valid for code generation.
+ */
+export declare const isNodeCodegenCompatible: (design: GetFileResponse, nodeId: string) => ValidateNodeForCodegenResult;
+
 export declare const isNotFound: (error: Error) => boolean;
 
 export declare const isRateLimitExceeded: (error: Error) => boolean;
@@ -255,15 +263,17 @@ export declare const isValidFigmaUrl: (figmaLink: string) => [hasCorrectPrefix:
 
 export declare class NotFound extends Error {
     fileKey: string;
-    constructor({ fileKey }: {
+    constructor({ fileKey, cause }: {
         fileKey: string;
+        cause?: unknown;
     });
 }
 
 export declare class RateLimitExceeded extends Error {
     fileKey: string;
-    constructor({ fileKey }: {
+    constructor({ fileKey, cause }: {
         fileKey: string;
+        cause?: unknown;
     });
 }
 
@@ -347,6 +357,17 @@ export declare class UnknownFigmaApiException extends Error {
     });
 }
 
+declare type ValidateNodeForCodegenResult = {
+    isValid: true;
+    node: FigmaNode;
+    note?: "Selected node is a page with a single valid children - returning it instead";
+} | {
+    isValid: false;
+    reason: InvalidNodeForCodegenReason;
+};
+
 export declare const validateSettings: (obj: unknown) => CodegenSettings;
 
+export declare const wrapFigmaApiError: (error: FigmaApiError, fileKey: string) => Error;
+
 export { }