From 5ef9e14be71b97252ee3bb792f290708567b8b20 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Tue, 17 Mar 2026 21:08:50 +0000
Subject: [PATCH] feat: cache domain searches

Added a module-level `Map` cache in `DomainSearch.svelte` to prevent redundant network requests when searching for the same domain multiple times within a 5-minute window.

Co-authored-by: yeboster <23556525+yeboster@users.noreply.github.com>
---
 .jules/bolt.md                 |  5 +++++
 src/routes/DomainSearch.svelte | 22 +++++++++++++++++++++-
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/.jules/bolt.md b/.jules/bolt.md
index 91541609..214bf4fc 100644
--- a/.jules/bolt.md
+++ b/.jules/bolt.md
@@ -9,3 +9,8 @@
 
 **Learning:** Using `on:keyup` for search input debouncing triggers unnecessary API calls on navigation keys (arrows, home, end) and misses changes from paste/cut. Svelte's reactive statements `$: debounce(value)` provide a robust, declarative way to trigger debouncing only when the value actually changes.
 **Action:** Replace `on:keyup` handlers with reactive statements for input debouncing to improve performance and correctness.
+
+## 2024-05-23 - Client-side Caching bounded by session duration
+
+**Learning:** Caching bounded by session duration in Svelte applications is best accomplished by using a module-scoped `Map` in `<script context="module">`. This effectively caches repetitive data fetches (like identical user queries) while preventing the cache from growing indefinitely (since it resets on app reload/session end).
+**Action:** Always prefer module-scoped `Map`s for caching over stores if the data doesn't require reactivity to update the UI on change, but rather needs to provide data quickly.
diff --git a/src/routes/DomainSearch.svelte b/src/routes/DomainSearch.svelte
index 53d006f1..f295396b 100644
--- a/src/routes/DomainSearch.svelte
+++ b/src/routes/DomainSearch.svelte
@@ -1,9 +1,20 @@
+<script context="module" lang="ts">
+	import type { Domain as DomainModel } from '@metanames/sdk';
+
+	type CacheEntry = {
+		domain: DomainModel | null | undefined;
+		timestamp: number;
+	};
+
+	const searchCache = new Map<string, CacheEntry>();
+	const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+</script>
+
 <script lang="ts">
 	import Card, { Content as CardContent } from '@smui/card';
 	import CircularProgress from '@smui/circular-progress';
 	import Textfield from '@smui/textfield';
 	import HelperText from '@smui/textfield/helper-text';
-	import type { Domain as DomainModel } from '@metanames/sdk';
 	import IconButton from '@smui/icon-button';
 	import { metaNamesSdk } from '$lib/stores/sdk';
 	import { goto } from '$app/navigation';
@@ -42,6 +53,14 @@
 
 		const currentRequestId = ++requestId;
 		nameSearched = domainName.toLocaleLowerCase();
+
+		const cachedItem = searchCache.get(nameSearched);
+		if (cachedItem && Date.now() < cachedItem.timestamp + CACHE_TTL) {
+			domain = cachedItem.domain;
+			isLoading = false;
+			return;
+		}
+
 		isLoading = true;
 
 		const result = await $metaNamesSdk.domainRepository.find(domainName);
@@ -49,6 +68,7 @@
 		if (currentRequestId === requestId) {
 			domain = result;
 			isLoading = false;
+			searchCache.set(nameSearched, { domain, timestamp: Date.now() });
 		}
 	}