Add fetch timeout and caching to supermemory-docs-mintlify proxy worker

apps/docs-proxy/package.json

@@ -0,0 +1,15 @@
+{
+	"name": "@repo/docs-proxy",
+	"version": "1.0.0",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"dev": "wrangler dev",
+		"deploy": "wrangler deploy --minify"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20250620.0",
+		"typescript": "^5.8.3",
+		"wrangler": "^4.4.0"
+	}
+}

apps/docs-proxy/src/index.ts

@@ -0,0 +1,49 @@
+const UPSTREAM_BASE = "https://supermemory.mintlify.dev"
+const CACHE_TTL = 300 // 5 minutes
+const FETCH_TIMEOUT_MS = 10000 // 10 seconds
+
+export default {
+	async fetch(request: Request): Promise<Response> {
+		const url = new URL(request.url)
+		const proxyUrl = UPSTREAM_BASE + url.pathname + url.search
+
+		const cache = caches.default
+
+		if (request.method === "GET") {
+			const cached = await cache.match(request)
+			if (cached) return cached
+		}
+
+		const controller = new AbortController()
+		const timeoutId = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
+
+		try {
+			const proxyRequest = new Request(proxyUrl, request)
+			const response = await fetch(proxyRequest, { signal: controller.signal })
+
+			if (request.method === "GET" && response.ok) {
+				const cachedResponse = new Response(response.clone().body, response)
+				cachedResponse.headers.set(
+					"Cache-Control",
+					`public, max-age=${CACHE_TTL}`,
+				)
+				await cache.put(request, cachedResponse)
+			}
+
+			return response
+		} catch (e) {
+			if (e instanceof Error && e.name === "AbortError") {
+				return new Response(
+					"Documentation temporarily unavailable. Please try again in a moment.",
+					{
+						status: 504,
+						headers: { "Content-Type": "text/plain; charset=utf-8" },
+					},
+				)
+			}
+			throw e
+		} finally {
+			clearTimeout(timeoutId)
+		}
+	},
+}

apps/docs-proxy/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "Bundler",
+		"strict": true,
+		"skipLibCheck": true,
+		"lib": ["ESNext"],
+		"types": ["@cloudflare/workers-types"],
+		"outDir": "dist",
+		"rootDir": "src"
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules"]
+}

apps/docs-proxy/wrangler.jsonc

@@ -0,0 +1,11 @@
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "supermemory-docs-mintlify",
+	"main": "src/index.ts",
+	"compatibility_date": "2025-06-20",
+	"compatibility_flags": [],
+
+	"observability": {
+		"enabled": true
+	}
+}