First Release of Claw3D (#11)

Co-authored-by: iamlukethedev <iamlukethedev@users.noreply.github.com>
2026-03-19 23:14:04 -05:00
parent 5ea96b2650
commit 4fa4f13558
431 changed files with 105438 additions and 14 deletions
@@ -0,0 +1,87 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+
+type BrowserPreviewState = {
+  mediaUrl: string | null;
+  browserUrl: string | null;
+  loading: boolean;
+  error: string | null;
+};
+
+export function useBrowserPreview(url: string | null, enabled: boolean) {
+  const [state, setState] = useState<BrowserPreviewState>({
+    mediaUrl: null,
+    browserUrl: url,
+    loading: false,
+    error: null,
+  });
+  const requestIdRef = useRef(0);
+
+  useEffect(() => {
+    if (!enabled || !url) {
+      requestIdRef.current += 1;
+      setState({
+        mediaUrl: null,
+        browserUrl: url,
+        loading: false,
+        error: null,
+      });
+      return;
+    }
+
+    const requestId = requestIdRef.current + 1;
+    requestIdRef.current = requestId;
+    setState((current) => ({
+      ...current,
+      browserUrl: url,
+      loading: true,
+      error: null,
+    }));
+
+    void (async () => {
+      try {
+        const params = new URLSearchParams({
+          url,
+          ts: String(Date.now()),
+        });
+        const response = await fetch(
+          `/api/office/browser-preview?${params.toString()}`,
+          {
+            cache: "no-store",
+          },
+        );
+        const payload = (await response.json()) as {
+          error?: string;
+          mediaUrl?: string;
+          browserUrl?: string;
+        };
+        if (!response.ok) {
+          throw new Error(
+            payload.error?.trim() || "Unable to capture GitHub browser preview.",
+          );
+        }
+        if (requestIdRef.current !== requestId) return;
+        setState({
+          mediaUrl: payload.mediaUrl?.trim() || null,
+          browserUrl: payload.browserUrl?.trim() || url,
+          loading: false,
+          error: null,
+        });
+      } catch (error) {
+        if (requestIdRef.current !== requestId) return;
+        setState({
+          mediaUrl: null,
+          browserUrl: url,
+          loading: false,
+          error:
+            error instanceof Error
+              ? error.message
+              : "Unable to capture GitHub browser preview.",
+        });
+      }
+    })();
+  }, [enabled, url]);
+
+  return state;
+}