@animaapp/anima-sdk 0.6.10 → 0.6.12-beta.0

package/dist/index.d.ts

@@ -17,6 +17,39 @@ export declare class Anima {
     protected get headers(): Record<string, string>;
     generateCode(params: GetCodeParams, handler?: GetCodeHandler, signal?: AbortSignal): Promise<AnimaSDKResult>;
     generateCodeFromWebsite(params: GetCodeFromWebsiteParams, handler?: GetCodeFromWebsiteHandler, signal?: AbortSignal): Promise<AnimaSDKResult>;
+    /**
+     * Generates code from a text prompt using AI.
+     *
+     * This method sends a prompt to the Anima API and generates code based on the description provided.
+     * It supports real-time streaming of the generation process through Server-Sent Events (SSE).
+     *
+     * @param params - The parameters for code generation
+     * @param params.prompt - The text prompt describing what code to generate
+     * @param params.settings - Code generation settings (framework, language, styling, etc.)
+     * @param params.assetsStorage - Optional asset storage configuration
+     * @param params.tracking - Optional tracking information
+     * @param params.webhookUrl - Optional webhook URL for completion notification
+     * @param handler - Event handler for processing SSE messages during generation
+     * @param signal - Optional AbortSignal to cancel the request
+     * @returns Promise resolving to AnimaSDKResult with generated files and metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await anima.generateCodeFromPrompt({
+     *   prompt: "Create a login form with email and password fields",
+     *   settings: {
+     *     framework: "react",
+     *     language: "typescript",
+     *     styling: "tailwind"
+     *   }
+     * }, {
+     *   onStart: ({ sessionId }) => console.log("Started:", sessionId),
+     *   onGeneratingCode: ({ progress }) => console.log("Progress:", progress),
+     *   onCodegenCompleted: () => console.log("Generation completed!")
+     * });
+     * ```
+     */
+    generateCodeFromPrompt(params: GetCodeFromPromptParams, handler?: GetCodeFromPromptHandler, signal?: AbortSignal): Promise<AnimaSDKResult>;
     /**
      * @deprecated This method will be removed soon, please use `generateCodeFromWebsite` instead.
      */
@@ -53,8 +86,8 @@ export declare type Auth = {
 
 export declare type BaseResult = {
     sessionId: string;
-    figmaFileName: string;
-    figmaSelectedFrameName: string;
+    figmaFileName?: string;
+    figmaSelectedFrameName?: string;
     tokenUsage: number;
 };
 
@@ -63,7 +96,7 @@ export declare class CodegenError extends Error {
     detail?: unknown;
     constructor({ name, reason, status, detail, }: {
         name: string;
-        reason: CodegenErrorReason | CodegenRouteErrorReason | SDKErrorReason | GetCodeFromWebsiteErrorReason;
+        reason: CodegenErrorReason | CodegenRouteErrorReason | SDKErrorReason | GetCodeFromWebsiteErrorReason | GetCodeFromPromptErrorReason;
         status?: number;
         detail?: unknown;
     });
@@ -105,10 +138,35 @@ export declare type CodegenSettings = {
     allowAutoSelectFirstNode?: boolean;
     enableDisplayScreenModelId?: boolean;
     enableGeneratePackageLock?: boolean;
+    enableAnimationsPreset?: boolean;
     url?: string;
     codegenSettings?: Record<string, unknown>;
 };
 
+/**
+ * Creates a Server-Sent Events (SSE) `Response` that forwards all messages from the code generation from prompt stream.
+ *
+ * But, if the first message indicates an error (e.g., connection failed), the function returns a 500 response with the error message.
+ *
+ * @param {Anima} anima - The Anima instance to use for creating the data stream.
+ * @param {GetCodeFromPromptParams} params - The parameters for the code generation request.
+ * @returns {Promise<Response>} - A promise that resolves to an HTTP response.
+ */
+export declare const createCodeFromPromptResponseEventStream: (anima: Anima, params: GetCodeFromPromptParams) => Promise<Response>;
+
+/**
+ * Prompt to Code (p2c) stream flow.
+ *
+ * Start the prompt to code generation and creates a ReadableStream to output its result.
+ *
+ * The stream is closed when the code generation ends.
+ *
+ * @param {Anima} anima - An Anima service instance to generate the code from.
+ * @param {GetCodeFromPromptParams} params - Parameters required for the code generation process.
+ * @returns {ReadableStream<StreamCodeFromPromptMessage>} - A ReadableStream that emits messages related to the code generation process.
+ */
+export declare const createCodeFromPromptStream: (anima: Anima, params: GetCodeFromPromptParams) => ReadableStream<StreamCodeFromPromptMessage>;
+
 /**
  * Creates a Server-Sent Events (SSE) `Response` that forwards all messages from the code generation from website stream.
  *
@@ -224,6 +282,46 @@ export declare type GeneratingCodePayload = {
     files: AnimaFiles;
 };
 
+/**
+ * Errors from the Prompt To Code Flow
+ */
+export declare type GetCodeFromPromptErrorReason = "Invalid prompt" | "Generation failed" | "Unknown";
+
+export declare type GetCodeFromPromptHandler = ((message: SSEGetCodeFromPromptMessage) => void) | {
+    onQueueing?: () => void;
+    onStart?: ({ sessionId }: {
+        sessionId: string;
+    }) => void;
+    onAssetsUploaded?: () => void;
+    onAssetsList?: ({ assets, }: {
+        assets: Array<{
+            name: string;
+            url: string;
+        }>;
+    }) => void;
+    onGeneratingCode?: ({ status, progress, files, }: {
+        status: "success" | "running" | "failure";
+        progress: number;
+        files: AnimaFiles;
+    }) => void;
+    onCodegenCompleted?: () => void;
+};
+
+export declare type GetCodeFromPromptParams = {
+    prompt: string;
+    assetsStorage?: AssetsStorage;
+    settings: GetCodeFromPromptSettings;
+    tracking?: TrackingInfos;
+    webhookUrl?: string;
+};
+
+export declare type GetCodeFromPromptSettings = {
+    language?: "typescript";
+    framework: "react" | "html";
+    styling: "tailwind" | "inline_styles";
+    uiLibrary?: "shadcn";
+};
+
 /**
  * Errors from the Website To Code Flow
  */
@@ -549,6 +647,46 @@ export declare type SSECodgenMessageErrorPayload = {
     reason: CodegenErrorReason;
 };
 
+export declare type SSEGetCodeFromPromptMessage = {
+    type: 'queueing';
+} | {
+    type: 'start';
+    sessionId: string;
+} | {
+    type: 'generating_code';
+    payload: GeneratingCodePayload;
+} | {
+    type: 'generation_completed';
+} | {
+    type: 'assets_uploaded';
+} | {
+    type: 'assets_list';
+    payload: {
+        assets: Array<{
+            name: string;
+            url: string;
+        }>;
+    };
+} | {
+    type: 'aborted';
+} | {
+    type: 'error';
+    payload: SSEGetCodeFromPromptMessageErrorPayload;
+} | {
+    type: 'done';
+    payload: {
+        sessionId: string;
+        tokenUsage: number;
+    };
+};
+
+export declare type SSEGetCodeFromPromptMessageErrorPayload = {
+    errorName: string;
+    task?: string;
+    reason: GetCodeFromPromptErrorReason;
+    sentryTraceId?: string;
+};
+
 export declare type SSEGetCodeFromWebsiteMessage = {
     type: 'queueing';
 } | {
@@ -594,6 +732,8 @@ export declare type SSEGetCodeFromWebsiteMessageErrorPayload = {
  */
 export declare type SSEL2CMessage = SSEGetCodeFromWebsiteMessage;
 
+export declare type StreamCodeFromPromptMessage = StreamMessage<SSEGetCodeFromPromptMessage>;
+
 export declare type StreamCodeFromWebsiteMessage = StreamMessage<SSEGetCodeFromWebsiteMessage>;
 
 export declare type StreamCodgenMessage = StreamMessage<SSECodgenMessage>;