@buildcores/render-client 1.0.7 → 1.0.9

package/dist/index.js

@@ -326,6 +326,7 @@ const API_BASE_URL = "https://www.renderapi.buildcores.com";
 // API Endpoints
 const API_ENDPOINTS = {
     RENDER_BUILD_EXPERIMENTAL: "/render-build-experimental",
+    RENDER_BUILD: "/render-build",
     AVAILABLE_PARTS: "/available-parts",
 };
 // API URL helpers
@@ -348,6 +349,7 @@ const buildHeaders = (config) => {
     }
     return headers;
 };
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 // API Implementation
 const renderBuildExperimental = async (request, config) => {
     const requestWithFormat = {
@@ -371,6 +373,68 @@ const renderBuildExperimental = async (request, config) => {
         },
     };
 };
+// New async endpoints implementation
+const createRenderBuildJob = async (request, config) => {
+    const body = {
+        parts: request.parts,
+        // If provided, forward format; default handled server-side but we keep explicit default
+        ...(request.format ? { format: request.format } : {}),
+    };
+    const response = await fetch(buildApiUrl(API_ENDPOINTS.RENDER_BUILD, config), {
+        method: "POST",
+        headers: buildHeaders(config),
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new Error(`Create render job failed: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    if (!data?.job_id) {
+        throw new Error("Create render job failed: missing job_id in response");
+    }
+    return data;
+};
+const getRenderBuildStatus = async (jobId, config) => {
+    const url = buildApiUrl(`${API_ENDPOINTS.RENDER_BUILD}/${encodeURIComponent(jobId)}`, config);
+    const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders(config),
+    });
+    if (response.status === 404) {
+        throw new Error("Render job not found");
+    }
+    if (!response.ok) {
+        throw new Error(`Get render job status failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+};
+const renderBuild = async (request, config, options) => {
+    const pollIntervalMs = 1500;
+    const timeoutMs = 120000; // 2 minutes default
+    const { job_id } = await createRenderBuildJob(request, config);
+    const start = Date.now();
+    // Poll until completed or error or timeout
+    for (;;) {
+        const status = await getRenderBuildStatus(job_id, config);
+        if (status.status === "completed") {
+            const requestedFormat = request.format ?? "video";
+            const finalUrl = (requestedFormat === "sprite"
+                ? status.sprite_url || status.url || undefined
+                : status.video_url || status.url || undefined);
+            if (!finalUrl) {
+                throw new Error("Render job completed but no URL returned");
+            }
+            return { videoUrl: finalUrl };
+        }
+        if (status.status === "error") {
+            throw new Error(status.error || "Render job failed");
+        }
+        if (Date.now() - start > timeoutMs) {
+            throw new Error("Timed out waiting for render job to complete");
+        }
+        await sleep(pollIntervalMs);
+    }
+};
 const renderSpriteExperimental = async (request, config) => {
     const requestWithFormat = {
         ...request,
@@ -475,7 +539,7 @@ const arePartsEqual = (parts1, parts2) => {
     }
     return true;
 };
-const useBuildRender = (parts, apiConfig, onLoadStart) => {
+const useBuildRender = (parts, apiConfig, onLoadStart, options) => {
     const [videoSrc, setVideoSrc] = React.useState(null);
     const [isRenderingBuild, setIsRenderingBuild] = React.useState(false);
     const [renderError, setRenderError] = React.useState(null);
@@ -485,15 +549,27 @@ const useBuildRender = (parts, apiConfig, onLoadStart) => {
             setIsRenderingBuild(true);
             setRenderError(null);
             onLoadStart?.();
-            const response = await renderBuildExperimental(currentParts, apiConfig);
-            const objectUrl = URL.createObjectURL(response.video);
-            // Clean up previous video URL before setting new one
-            setVideoSrc((prevSrc) => {
-                if (prevSrc) {
-                    URL.revokeObjectURL(prevSrc);
-                }
-                return objectUrl;
-            });
+            const mode = options?.mode ?? "async";
+            if (mode === "experimental") {
+                const response = await renderBuildExperimental(currentParts, apiConfig);
+                const objectUrl = URL.createObjectURL(response.video);
+                setVideoSrc((prevSrc) => {
+                    if (prevSrc && prevSrc.startsWith("blob:")) {
+                        URL.revokeObjectURL(prevSrc);
+                    }
+                    return objectUrl;
+                });
+            }
+            else {
+                const { videoUrl } = await renderBuild(currentParts, apiConfig);
+                // Clean up previous object URL (if any) before setting new one
+                setVideoSrc((prevSrc) => {
+                    if (prevSrc && prevSrc.startsWith("blob:")) {
+                        URL.revokeObjectURL(prevSrc);
+                    }
+                    return videoUrl;
+                });
+            }
         }
         catch (error) {
             setRenderError(error instanceof Error ? error.message : "Failed to render build");
@@ -501,7 +577,7 @@ const useBuildRender = (parts, apiConfig, onLoadStart) => {
         finally {
             setIsRenderingBuild(false);
         }
-    }, [apiConfig, onLoadStart]);
+    }, [apiConfig, onLoadStart, options?.mode]);
     // Effect to call API when parts content changes (using custom equality check)
     React.useEffect(() => {
         const shouldFetch = previousPartsRef.current === null ||
@@ -514,7 +590,7 @@ const useBuildRender = (parts, apiConfig, onLoadStart) => {
     // Cleanup effect for component unmount
     React.useEffect(() => {
         return () => {
-            if (videoSrc) {
+            if (videoSrc && videoSrc.startsWith("blob:")) {
                 URL.revokeObjectURL(videoSrc);
             }
         };
@@ -526,7 +602,7 @@ const useBuildRender = (parts, apiConfig, onLoadStart) => {
     };
 };
 
-const useSpriteRender = (parts, apiConfig, onLoadStart) => {
+const useSpriteRender = (parts, apiConfig, onLoadStart, options) => {
     const [spriteSrc, setSpriteSrc] = React.useState(null);
     const [isRenderingSprite, setIsRenderingSprite] = React.useState(false);
     const [renderError, setRenderError] = React.useState(null);
@@ -537,21 +613,36 @@ const useSpriteRender = (parts, apiConfig, onLoadStart) => {
             setIsRenderingSprite(true);
             setRenderError(null);
             onLoadStart?.();
-            const response = await renderSpriteExperimental(currentParts, apiConfig);
-            const objectUrl = URL.createObjectURL(response.sprite);
-            // Clean up previous sprite URL before setting new one
-            setSpriteSrc((prevSrc) => {
-                if (prevSrc) {
-                    URL.revokeObjectURL(prevSrc);
-                }
-                return objectUrl;
-            });
-            // Set sprite metadata
-            setSpriteMetadata({
-                cols: response.metadata?.cols || 12,
-                rows: response.metadata?.rows || 6,
-                totalFrames: response.metadata?.totalFrames || 72,
-            });
+            const mode = options?.mode ?? "async";
+            if (mode === "experimental") {
+                const response = await renderSpriteExperimental(currentParts, apiConfig);
+                const objectUrl = URL.createObjectURL(response.sprite);
+                // Clean up previous sprite URL before setting new one
+                setSpriteSrc((prevSrc) => {
+                    if (prevSrc && prevSrc.startsWith("blob:")) {
+                        URL.revokeObjectURL(prevSrc);
+                    }
+                    return objectUrl;
+                });
+                // Set sprite metadata
+                setSpriteMetadata({
+                    cols: response.metadata?.cols || 12,
+                    rows: response.metadata?.rows || 6,
+                    totalFrames: response.metadata?.totalFrames || 72,
+                });
+            }
+            else {
+                // Async job-based flow: request sprite format and use returned URL
+                const { videoUrl: spriteUrl } = await renderBuild({ ...currentParts, format: "sprite" }, apiConfig);
+                setSpriteSrc((prevSrc) => {
+                    if (prevSrc && prevSrc.startsWith("blob:")) {
+                        URL.revokeObjectURL(prevSrc);
+                    }
+                    return spriteUrl;
+                });
+                // No metadata from async endpoint; keep defaults
+                setSpriteMetadata({ cols: 12, rows: 6, totalFrames: 72 });
+            }
         }
         catch (error) {
             setRenderError(error instanceof Error ? error.message : "Failed to render sprite");
@@ -559,7 +650,7 @@ const useSpriteRender = (parts, apiConfig, onLoadStart) => {
         finally {
             setIsRenderingSprite(false);
         }
-    }, [apiConfig, onLoadStart]);
+    }, [apiConfig, onLoadStart, options?.mode]);
     // Effect to call API when parts content changes (using custom equality check)
     React.useEffect(() => {
         const shouldFetch = previousPartsRef.current === null ||
@@ -572,7 +663,7 @@ const useSpriteRender = (parts, apiConfig, onLoadStart) => {
     // Cleanup effect for component unmount
     React.useEffect(() => {
         return () => {
-            if (spriteSrc) {
+            if (spriteSrc && spriteSrc.startsWith("blob:")) {
                 URL.revokeObjectURL(spriteSrc);
             }
         };