@johndimm/constellations 1.0.1 → 1.0.3

package/services/wikipediaService.ts

@@ -1,7 +1,23 @@
-import { fetchWithTimeout } from "./aiUtils";
+"use client";
+
+import { jsonFromResponse } from "./aiUtils";
 
 type WikiImageCacheEntry = { url: string | null; pageId?: number; pageTitle?: string; misses?: number };
 
+// Session-level rate-limit gate: after any 429, block all Wikipedia/Wikidata calls for 90s.
+let _wikiRateLimitedUntil = 0;
+function wikiIsRateLimited() { return Date.now() < _wikiRateLimitedUntil; }
+function wikiSetRateLimited() {
+  _wikiRateLimitedUntil = Date.now() + 90_000;
+  console.warn('[Wiki] 429 received — pausing all Wikipedia/Wikidata calls for 90s');
+}
+async function wikiFetch(url: string, init?: RequestInit): Promise<Response | null> {
+  if (wikiIsRateLimited()) return null;
+  const res = await fetch(url, init);
+  if (res.status === 429) { wikiSetRateLimited(); return null; }
+  return res;
+}
+
 // DuckDuckGo image search fallback (posters/cover art when Wikimedia lacks a usable image).
 export const fetchDuckDuckGoPoster = async (q: string): Promise<string | null> => {
   // Respect network sandbox: if running in a browser without CORS, skip.
@@ -59,7 +75,8 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       try {
         const url = `${api}?action=query&format=json&prop=imageinfo&titles=${encodeURIComponent(fileTitle)}&iiprop=url&iiurlwidth=500&origin=*`;
         const res = await fetch(url, { signal });
-        const data = await res.json();
+        const data = (await jsonFromResponse(res)) as { query?: { pages?: Record<string, unknown> } } | null;
+        if (!data) continue;
         const pages = data.query?.pages;
         if (pages) {
           const page = Object.values(pages)[0] as any;
@@ -78,7 +95,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
     try {
       const wdUrl = `https://www.wikidata.org/w/api.php?action=wbgetentities&format=json&props=claims&ids=${qid}&origin=*`;
       const wdRes = await fetch(wdUrl, { signal });
-      const wdData = await wdRes.json();
+      const wdData = (await jsonFromResponse(wdRes)) as { entities?: Record<string, { claims?: any }> } | null;
       const claims = wdData?.entities?.[qid]?.claims;
       const p18 = claims?.P18?.[0]?.mainsnak?.datavalue?.value as string | undefined;
       if (!p18) return null;
@@ -95,8 +112,8 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
     try {
       const ppUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=pageprops&titles=${encodeURIComponent(title)}&redirects=1&origin=*`;
       const ppRes = await fetch(ppUrl, { signal });
-      const ppData = await ppRes.json();
-      const pages = ppData?.query?.pages;
+      const ppData = await jsonFromResponse(ppRes);
+      const pages = (ppData as { query?: { pages?: unknown } } | null)?.query?.pages;
       const page = pages ? (Object.values(pages)[0] as any) : null;
       const qid = page?.pageprops?.wikibase_item;
       if (!qid || !/^Q\d+$/.test(qid)) return null;
@@ -112,7 +129,8 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       // 1. Get page info, thumbnail, and all images in one go
       const url = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=pageimages|pageprops|images&titles=${encodeURIComponent(title)}&pithumbsize=500&imlimit=50&redirects=1&origin=*`;
       const res = await fetch(url, { signal });
-      const data = await res.json();
+      const data = (await jsonFromResponse(res)) as { query?: { pages?: Record<string, unknown> } } | null;
+      if (!data) return { url: null };
 
       const pages = data.query?.pages;
       if (!pages) return { url: null };
@@ -146,7 +164,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       if (candidates.length === 0) return { url: null };
 
       const normalized = query.trim().toLowerCase();
-      const queryWords = normalized.split(/\s+/).filter(w => w.length > 1);
+      const queryWords = normalized.split(/\s+/).filter((w: string) => w.length > 1);
       const isPerson = context?.toLowerCase() === 'person';
 
       const scoredCandidates = candidates.map(c => {
@@ -198,7 +216,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
         if (t.includes('.png')) s -= isPerson ? 20 : 50;
 
         // Prefer solo filenames
-        const wordCount = t.split(/[^a-z]/).filter(w => w.length > 2).length;
+        const wordCount = t.split(/[^a-z]/).filter((w: string) => w.length > 2).length;
         s -= (wordCount * 15); // Stronger penalty for long, descriptive filenames
 
         return { ...c, score: s };
@@ -245,7 +263,8 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       const url = `https://www.googleapis.com/books/v1/volumes?q=${encodeURIComponent(q)}&maxResults=1`;
       const res = await fetch(url, { signal });
       if (res.ok) {
-        const data = await res.json();
+        const data = (await jsonFromResponse(res)) as { items?: { volumeInfo?: { imageLinks?: { thumbnail?: string } } }[] } | null;
+        if (!data) return null;
         const img = data.items?.[0]?.volumeInfo?.imageLinks?.thumbnail;
         return img ? img.replace('http://', 'https://') : null;
       }
@@ -279,10 +298,10 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
     // console.log(`🔍 [ImageSearch] Attempt 1 (Media-Aware): "${searchQuery}"`);
     const initialSearchUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&list=search&srsearch=${encodeURIComponent(searchQuery)}&srlimit=5&origin=*`;
     const initialSearchRes = await fetch(initialSearchUrl, { signal: controller.signal });
-    const initialSearchData = await initialSearchRes.json();
+    const initialSearchData = (await jsonFromResponse(initialSearchRes)) as { query?: { search?: { title: string; snippet?: string }[] } } | null;
 
     let bestTitle = query;
-    if (initialSearchData.query?.search?.length) {
+    if (initialSearchData?.query?.search?.length) {
       const results = initialSearchData.query.search;
       const normalized = baseTitle.toLowerCase();
       const avoidMedia = false; // For images, we generally allow media if it's the right title
@@ -305,7 +324,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
 
         // 2. Context matching
         if (context) {
-          const words = context.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+          const words = context.toLowerCase().split(/\s+/).filter((w: string) => w.length > 2);
           words.forEach(word => {
             if (title.includes(word)) s += 100;
             if (snippet.includes(word)) s += 50;
@@ -322,7 +341,9 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
         return s;
       };
 
-      const scored = results.map((r: any) => ({ r, score: scoreResult(r) })).sort((a, b) => b.score - a.score);
+      const scored = results
+        .map((r: any) => ({ r, score: scoreResult(r) }))
+        .sort((a: { score: number }, b: { score: number }) => b.score - a.score);
       bestTitle = scored[0]?.r?.title || query;
       // console.log(`✅ [ImageSearch] Chosen result "${bestTitle}" with score ${scored[0]?.score ?? 'n/a'}`);
     }
@@ -336,9 +357,9 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       // console.log(`🔍 [ImageSearch] Attempt 2 (Commons for Person): "${baseTitle}"`);
       const commonsUrl = `https://commons.wikimedia.org/w/api.php?action=query&format=json&list=search&srsearch=${encodeURIComponent(baseTitle)}&srnamespace=6&srlimit=10&origin=*`;
       const commonsRes = await fetch(commonsUrl, { signal: controller.signal });
-      const commonsData = await commonsRes.json();
-      if (commonsData.query?.search?.length) {
-        const baseWords = baseTitle.toLowerCase().split(/\s+/).filter(w => w.length > 1);
+      const commonsData = (await jsonFromResponse(commonsRes)) as { query?: { search?: any[] } } | null;
+      if (commonsData?.query?.search?.length) {
+        const baseWords = baseTitle.toLowerCase().split(/\s+/).filter((w: string) => w.length > 1);
         const scoredResults = commonsData.query.search.map((res: any) => {
           const t = res.title.toLowerCase();
           if (excludePatterns.some(p => t.includes(p))) return { res, score: -1000 };
@@ -356,7 +377,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
           if (t.includes('.png')) s -= 20; // Reduced penalty for Person
           if (t.includes('.svg') || t.includes('.webm') || t.includes('.gif')) s -= 300;
 
-          const wordCount = t.split(/[^a-z]/).filter(w => w.length > 2).length;
+          const wordCount = t.split(/[^a-z]/).filter((w: string) => w.length > 2).length;
           s -= (wordCount * 15);
 
           return { res, score: s };
@@ -386,9 +407,9 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
       // console.log(`🔍 [ImageSearch] Attempt 4 (Commons): "${baseTitle}"`);
       const commonsUrl = `https://commons.wikimedia.org/w/api.php?action=query&format=json&list=search&srsearch=${encodeURIComponent(baseTitle)}&srnamespace=6&srlimit=10&origin=*`;
       const commonsRes = await fetch(commonsUrl, { signal: controller.signal });
-      const commonsData = await commonsRes.json();
-      if (commonsData.query?.search?.length) {
-        const baseWords = baseTitle.toLowerCase().split(/\s+/).filter(w => w.length > 1);
+      const commonsData = (await jsonFromResponse(commonsRes)) as { query?: { search?: any[] } } | null;
+      if (commonsData?.query?.search?.length) {
+        const baseWords = baseTitle.toLowerCase().split(/\s+/).filter((w: string) => w.length > 1);
         const scoredResults = commonsData.query.search.map((res: any) => {
           const t = res.title.toLowerCase();
           if (excludePatterns.some(p => t.includes(p))) return { res, score: -1000 };
@@ -408,7 +429,7 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
           if (t.includes('.png')) s -= 50;
           if (t.includes('.svg') || t.includes('.webm') || t.includes('.gif')) s -= 300;
 
-          const wordCount = t.split(/[^a-z]/).filter(w => w.length > 2).length;
+          const wordCount = t.split(/[^a-z]/).filter((w: string) => w.length > 2).length;
           s -= (wordCount * 15);
 
           return { res, score: s };
@@ -426,8 +447,8 @@ export const fetchWikipediaImage = async (query: string, context?: string): Prom
     // console.log(`🔍 [ImageSearch] Attempt 5 (Search): "${baseTitle}"`);
     const searchUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&list=search&srsearch=${encodeURIComponent(baseTitle)}&srlimit=5&origin=*`;
     const searchRes = await fetch(searchUrl, { signal: controller.signal });
-    const searchData = await searchRes.json();
-    if (searchData.query?.search?.length) {
+    const searchData = (await jsonFromResponse(searchRes)) as { query?: { search?: { title: string }[] } } | null;
+    if (searchData?.query?.search?.length) {
       for (const result of searchData.query.search) {
         const img = await fetchPageImage(result.title, controller.signal);
         if (img.url) return img;
@@ -486,6 +507,7 @@ export const fetchWikipediaSummary = async (
   depth: number = 0,
   triedNoContext = false
 ): Promise<{ extract: string | null; pageid: number | null; title: string | null; year?: number | null; mentioningPageTitles?: string[] | null; searchContext?: string | null }> => {
+  if (wikiIsRateLimited()) return { extract: null, pageid: null, title: null };
   const normKey = `${query.trim().toLowerCase()}|${context || ''}`;
   if (visited.has(normKey) || depth > 2) {
     return { extract: null, pageid: null, title: null };
@@ -497,8 +519,10 @@ export const fetchWikipediaSummary = async (
     const tryDirectLookup = async (titleToFetch: string) => {
       try {
         const directUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=extracts|pageprops&exintro&explaintext&titles=${encodeURIComponent(titleToFetch)}&redirects=1&origin=*`;
-        const directRes = await fetch(directUrl);
-        const directData = await directRes.json();
+        const directRes = await wikiFetch(directUrl);
+        if (!directRes) return null;
+        const directData = (await jsonFromResponse(directRes)) as { query?: { pages?: unknown; redirects?: unknown } } | null;
+        if (!directData) return null;
         const directPages = directData.query?.pages;
 
         if (directPages) {
@@ -541,7 +565,7 @@ export const fetchWikipediaSummary = async (
     // for disambiguation (e.g., "Republic (book)" vs "Republic").
     const cleanQuery = query.trim();
     const normalized = cleanQuery.toLowerCase();
-    const queryNameParts = normalized.split(/[\s-]+/).filter(w => w.length > 2);
+    const queryNameParts = normalized.split(/[\s-]+/).filter((w: string) => w.length > 2);
     const looksLikePersonName = queryNameParts.length >= 2 && !/\d/.test(cleanQuery);
     const queryLastName = looksLikePersonName ? queryNameParts[queryNameParts.length - 1].toLowerCase() : null;
 
@@ -564,7 +588,7 @@ export const fetchWikipediaSummary = async (
     const directExact = await tryDirectLookup(cleanQuery);
     if (directExact?.extract) {
       if (queryLastName) {
-        const titleParts = String(directExact.title || "").toLowerCase().split(/[\s-]+/).filter(w => w.length > 2);
+        const titleParts = String(directExact.title || "").toLowerCase().split(/[\s-]+/).filter((w: string) => w.length > 2);
         // If it's a redirect, we are MUCH more lenient. Napoleon Bonaparte -> Napoleon is a classic case.
         if (!titleParts.includes(queryLastName) && !directExact.redirected) {
           // console.log(`⚠️ [Wiki] Ignoring direct match "${directExact.title}" for "${cleanQuery}" (missing last-name match and no redirect).`);
@@ -638,11 +662,12 @@ export const fetchWikipediaSummary = async (
 
     const avoidMedia = /\b(project|program|programme|operation|war|battle|campaign|treaty|scandal|scientist)\b/i.test(baseQuery);
     const searchUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&list=search&srsearch=${encodeURIComponent(searchQuery)}&srlimit=5&origin=*`;
-    const searchRes = await fetch(searchUrl);
-    const searchData = await searchRes.json();
+    const searchRes = await wikiFetch(searchUrl);
+    if (!searchRes) return { extract: null, pageid: null, title: null };
+    const searchData = (await jsonFromResponse(searchRes)) as { query?: { search?: any[] } } | null;
 
     let bestTitle = query;
-    if (searchData.query?.search?.length) {
+    if (searchData?.query?.search?.length) {
       const results = searchData.query.search;
       const scoreResult = (r: any, index: number) => {
         const title = r.title.toLowerCase();
@@ -697,7 +722,7 @@ export const fetchWikipediaSummary = async (
 
         // 2. Context matching
         if (context) {
-          const words = context.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+          const words = context.toLowerCase().split(/\s+/).filter((w: string) => w.length > 2);
           words.forEach(word => {
             if (title.includes(word)) s += 100;
             if (snippet.includes(word)) s += 50;
@@ -754,7 +779,7 @@ export const fetchWikipediaSummary = async (
       bestTitle = scored[0]?.r?.title || query;
 
 
-      const titleNameParts = bestTitle.toLowerCase().split(/[\s-]+/).filter(w => w.length > 2);
+      const titleNameParts = bestTitle.toLowerCase().split(/[\s-]+/).filter((w: string) => w.length > 2);
       // Require at least one full word match, not just a substring overlap
       const hasFullWordMatch = queryNameParts.some(q => titleNameParts.includes(q));
       const hasOverlap = queryNameParts.some(q => titleNameParts.some(t => t.includes(q) || q.includes(t)));
@@ -764,7 +789,7 @@ export const fetchWikipediaSummary = async (
 
       for (const titleToTry of candidates) {
         if (queryNameParts.length > 0) {
-          const candidateParts = titleToTry.toLowerCase().split(/[\s-]+/).filter(w => w.length > 2);
+          const candidateParts = titleToTry.toLowerCase().split(/[\s-]+/).filter((w: string) => w.length > 2);
 
           // STRICT PERSON MATCHING:
           // If we are looking for a person (query has 2+ name parts),
@@ -788,8 +813,10 @@ export const fetchWikipediaSummary = async (
           }
         }
         const summaryUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=extracts|pageprops&exintro&explaintext&titles=${encodeURIComponent(titleToTry)}&redirects=1&origin=*`;
-        const summaryRes = await fetch(summaryUrl);
-        const summaryData = await summaryRes.json();
+        const summaryRes = await wikiFetch(summaryUrl);
+        if (!summaryRes) break;
+        const summaryData = (await jsonFromResponse(summaryRes)) as { query?: { pages?: unknown } } | null;
+        if (!summaryData) continue;
         const pages = summaryData.query?.pages;
 
         if (pages) {
@@ -831,14 +858,14 @@ export const fetchWikipediaSummary = async (
             }
 
             if (queryNameParts.length >= 2) {
-              const pageParts = String(page.title || "").toLowerCase().split(/[\s-]+/).filter(w => w.length > 2);
+              const pageParts = String(page.title || "").toLowerCase().split(/[\s-]+/).filter((w: string) => w.length > 2);
               const allMatch = queryNameParts.every(q => pageParts.includes(q));
               if (!allMatch) {
                 // console.log(`⚠️ [Wiki] Skipping resolved title "${page.title}" for "${cleanQuery}" (not all name parts match).`);
                 continue;
               }
             } else if (queryLastName) {
-              const pageParts = String(page.title || "").toLowerCase().split(/[\s-]+/).filter(w => w.length > 2);
+              const pageParts = String(page.title || "").toLowerCase().split(/[\s-]+/).filter((w: string) => w.length > 2);
               if (!pageParts.includes(queryLastName)) {
                 // console.log(`⚠️ [Wiki] Skipping resolved title "${page.title}" for "${cleanQuery}" (missing last-name match).`);
                 continue;
@@ -936,9 +963,9 @@ export const fetchWikipediaExtract = async (
     // when exchars is set (returns fewer chars than the article actually contains). We fetch
     // the full extract and truncate client-side instead.
     const url = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=extracts|pageprops&explaintext&titles=${encodeURIComponent(title)}&redirects=1&origin=*`;
-    // Hard cap: a hung Wikipedia response must not strand graph expansion spinners indefinitely.
-    const res = await fetchWithTimeout(url, {}, 25_000);
-    const data = await res.json();
+    const res = await fetch(url);
+    const data = (await jsonFromResponse(res)) as { query?: { pages?: unknown } } | null;
+    if (!data) return { extract: null, pageid: null, title: null };
     const pages = data.query?.pages;
     if (!pages) return { extract: null, pageid: null, title: null };
     const page = Object.values(pages)[0] as any;
@@ -988,8 +1015,8 @@ export const fetchWikidataCastForTitle = async (title: string, limit: number = 1
     try {
       const pagepropsUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=pageprops&titles=${encodeURIComponent(title)}&redirects=1&origin=*`;
       const ppRes = await fetch(pagepropsUrl, { signal });
-      const ppData = await ppRes.json();
-      const pages = ppData?.query?.pages;
+      const ppData = await jsonFromResponse(ppRes);
+      const pages = (ppData as { query?: { pages?: unknown } } | null)?.query?.pages;
       if (pages) {
         const page = Object.values(pages)[0] as any;
         const candidate = page?.pageprops?.wikibase_item;
@@ -1008,8 +1035,8 @@ export const fetchWikidataCastForTitle = async (title: string, limit: number = 1
 
     const entityUrl = `https://www.wikidata.org/w/api.php?action=wbgetentities&format=json&props=claims&ids=${encodeURIComponent(wikidataId)}&origin=*`;
     const entRes = await fetch(entityUrl, { signal });
-    const entData = await entRes.json();
-    const claims = entData?.entities?.[wikidataId]?.claims;
+    const entData = await jsonFromResponse(entRes);
+    const claims = (entData as { entities?: Record<string, { claims?: unknown }> } | null)?.entities?.[wikidataId]?.claims;
     if (!claims) return [];
 
     const castIds = extractWikidataItemIds(claims, "P161");
@@ -1036,7 +1063,8 @@ const fetchWikidataLabels = async (ids: string[], signal: AbortSignal): Promise<
     try {
       const url = `https://www.wikidata.org/w/api.php?action=wbgetentities&format=json&props=labels&languages=en&ids=${encodeURIComponent(chunk.join("|"))}&origin=*`;
       const res = await fetch(url, { signal });
-      const data = await res.json();
+      const data = (await jsonFromResponse(res)) as { entities?: Record<string, { labels?: { en?: { value?: string } } }> } | null;
+      if (!data) continue;
       const entities = data?.entities || {};
       for (const [id, ent] of Object.entries<any>(entities)) {
         const label = ent?.labels?.en?.value;
@@ -1051,9 +1079,11 @@ const fetchWikidataLabels = async (ids: string[], signal: AbortSignal): Promise<
 
 const resolveWikidataIdBySearch = async (label: string, signal: AbortSignal): Promise<string | null> => {
   try {
+    if (wikiIsRateLimited()) return null;
     const url = `https://www.wikidata.org/w/api.php?action=wbsearchentities&format=json&language=en&limit=8&search=${encodeURIComponent(label)}&origin=*`;
     const res = await fetch(url, { signal });
-    const data = await res.json();
+    if (res.status === 429) { wikiSetRateLimited(); return null; }
+    const data = (await jsonFromResponse(res)) as { search?: any[] } | null;
     const results: any[] = data?.search || [];
     if (!results.length) return null;
 
@@ -1095,8 +1125,8 @@ export const fetchWikidataKeyPeopleForTitle = async (title: string): Promise<Wik
     try {
       const pagepropsUrl = `https://en.wikipedia.org/w/api.php?action=query&format=json&prop=pageprops&titles=${encodeURIComponent(title)}&redirects=1&origin=*`;
       const ppRes = await fetch(pagepropsUrl, { signal });
-      const ppData = await ppRes.json();
-      const pages = ppData?.query?.pages;
+      const ppData = await jsonFromResponse(ppRes);
+      const pages = (ppData as { query?: { pages?: unknown } } | null)?.query?.pages;
       if (pages) {
         const page = Object.values(pages)[0] as any;
         const resolvedTitle = String(page?.title || "");
@@ -1127,7 +1157,7 @@ export const fetchWikidataKeyPeopleForTitle = async (title: string): Promise<Wik
     // 2) Pull key-people claims.
     const entityUrl = `https://www.wikidata.org/w/api.php?action=wbgetentities&format=json&props=claims&ids=${encodeURIComponent(wikidataId)}&origin=*`;
     const entRes = await fetch(entityUrl, { signal });
-    const entData = await entRes.json();
+    const entData = (await jsonFromResponse(entRes)) as { entities?: Record<string, { claims?: unknown }> } | null;
     const entity = entData?.entities?.[wikidataId];
     const claims = entity?.claims;
     if (!claims) {

package/sessionHandoff.ts

@@ -130,3 +130,29 @@ export function takeEmbedHandoffForInitialState(): ConstellationsSessionHandoffV
     embedHandoffMem = null;
     return null;
 }
+
+declare global {
+    interface Window {
+        __soundingsConstellationsGetHandoff?: () => unknown;
+    }
+}
+
+/** Serialize current embedded graph (`__soundingsConstellationsGetHandoff`) before navigating away. */
+export function persistWindowConstellationsHandoffToSession(): void {
+    if (typeof window === 'undefined') return;
+    try {
+        const fn = window.__soundingsConstellationsGetHandoff;
+        if (typeof fn !== 'function') return;
+        const payload = fn();
+        if (!payload || typeof payload !== 'object') return;
+        const p = payload as { v?: number; graph?: { nodes?: unknown[] } };
+        if (p.v !== 1 || !p.graph?.nodes?.length) return;
+        try {
+            sessionStorage.setItem(SOUNDINGS_CONSTELLATIONS_HANDOFF_KEY, JSON.stringify(payload));
+        } catch (e) {
+            console.warn('[constellations] handoff too large for sessionStorage', e);
+        }
+    } catch (e) {
+        console.warn('[constellations] handoff persist', e);
+    }
+}

package/types.ts

@@ -1,3 +1,4 @@
+"use client";
 import { SimulationNodeDatum, SimulationLinkDatum } from 'd3';
 
 export interface GraphNode extends SimulationNodeDatum {
@@ -20,6 +21,8 @@ export interface GraphNode extends SimulationNodeDatum {
   atomic_type?: string; // e.g. "Symptom"
   composite_type?: string; // e.g. "Disease"
   mentioningPageTitles?: string[]; // Titles of articles mentioning this entity (for non-article fallback)
+  /** Measured card height in timeline view (set by Graph layout). */
+  h?: number;
   // D3 Simulation properties explicitly defined to ensure access
   x?: number;
   y?: number;

package/utils/evidenceUtils.ts

@@ -1,3 +1,4 @@
+"use client";
 export const normalizeForEvidence = (s: unknown) =>
     String(s || '')
         .toLowerCase()

package/utils/graphLogicUtils.ts

@@ -1,3 +1,4 @@
+"use client";
 export const getLinkKey = (a: number | string, b: number | string) => {
     const s = String(a);
     const t = String(b);

package/utils/wikiUtils.ts

@@ -1,3 +1,4 @@
+"use client";
 import { fetchWikipediaExtract } from '../services/wikipediaService';
 
 export const buildWikiUrl = (title: string, wikipediaId?: string | number) => {
@@ -21,10 +22,21 @@ export const looksLikeWikipediaTitle = (t: unknown) => {
     return true;
 };
 
-const extractCache: Map<string, string | null> =
-    ((window as any).__wikiExtractCache ||= new Map<string, string | null>());
+const serverExtractCache = new Map<string, string | null>();
+
+function getExtractCacheMap(): Map<string, string | null> {
+    if (typeof window === 'undefined') {
+        return serverExtractCache;
+    }
+    const w = window as unknown as { __wikiExtractCache?: Map<string, string | null> };
+    if (!w.__wikiExtractCache) {
+        w.__wikiExtractCache = new Map();
+    }
+    return w.__wikiExtractCache;
+}
 
 export const getExtractCached = async (title: string) => {
+    const extractCache = getExtractCacheMap();
     const key = String(title || '').trim();
     if (!key) return null;
     if (extractCache.has(key)) return extractCache.get(key) || null;