fix: replace useCachedPromise with direct fetch to prevent OOM on first launch

useCachedPromise uses ~4x more memory than direct fetch when populating
an empty cache, causing JS heap out of memory crashes on first launch.

This replaces it with direct fetch + Cache API while maintaining the
same stale-while-revalidate behavior.

See: raycast/utils#65

Author: carlesandres

CHANGELOG.md

@@ -1,5 +1,16 @@
 # models.dev Changelog
 
+## [Bug Fix] - {PR_MERGE_DATE}
+
+### Fixed
+
+- Fixed JS heap out of memory crash on first launch caused by `useCachedPromise` memory overhead
+- Replaced `useCachedPromise` with direct fetch + Cache API to reduce peak memory usage
+
+### Changed
+
+- Removed `@raycast/utils` dependency (no longer needed)
+
 ## [Bug Fixes] - 2026-03-16
 
 ### Changed

package-lock.json

@@ -120,8 +120,7 @@
     }
   ],
   "dependencies": {
-    "@raycast/api": "^1.104.3",
-    "@raycast/utils": "^2.2.2"
+    "@raycast/api": "^1.104.3"
   },
   "devDependencies": {
     "@raycast/eslint-config": "^2.1.1",

package.json

@@ -1,21 +1,65 @@
-import { showToast, Toast } from "@raycast/api";
-import { useCachedPromise } from "@raycast/utils";
+import { Cache, showToast, Toast } from "@raycast/api";
+import { useState, useEffect, useRef } from "react";
 import { fetchModelsData } from "../lib/api";
+import type { ModelsData } from "../lib/types";
+
+const cache = new Cache();
+const CACHE_KEY = "models-data";
 
 /**
  * Hook to fetch models data from models.dev
- * useCachedPromise persists the last successful result to disk automatically,
- * serving stale-while-revalidate on subsequent opens with no extra heap allocation.
+ *
+ * Uses direct fetch + Cache API instead of useCachedPromise to avoid
+ * memory spikes during fresh cache population. See:
+ * https://github.com/raycast/utils/issues/XXX
  */
 export function useModelsData() {
-  return useCachedPromise(fetchModelsData, [], {
-    keepPreviousData: true,
-    onError: (error) => {
-      showToast({
-        style: Toast.Style.Failure,
-        title: "Failed to load models",
-        message: error instanceof Error ? error.message : "Unknown error",
-      });
-    },
+  const [data, setData] = useState<ModelsData | null>(() => {
+    const cached = cache.get(CACHE_KEY);
+    if (cached) {
+      try {
+        return JSON.parse(cached) as ModelsData;
+      } catch {
+        cache.remove(CACHE_KEY);
+      }
+    }
+    return null;
   });
+
+  const [isLoading, setIsLoading] = useState(!data);
+  const fetchedRef = useRef(false);
+
+  useEffect(() => {
+    // Already have cached data or already fetching
+    if (fetchedRef.current) return;
+    fetchedRef.current = true;
+
+    // If we have cached data, still revalidate in background
+    const shouldRevalidate = !!data;
+
+    if (!shouldRevalidate) {
+      setIsLoading(true);
+    }
+
+    fetchModelsData()
+      .then((result) => {
+        setData(result);
+        setIsLoading(false);
+        // Cache write happens after state update to reduce peak memory
+        cache.set(CACHE_KEY, JSON.stringify(result));
+      })
+      .catch((error) => {
+        setIsLoading(false);
+        // Only show error if we don't have cached data to fall back on
+        if (!data) {
+          showToast({
+            style: Toast.Style.Failure,
+            title: "Failed to load models",
+            message: error instanceof Error ? error.message : "Unknown error",
+          });
+        }
+      });
+  }, []);
+
+  return { data, isLoading };
 }