[{"_1":2,"_176":-5,"_177":-5},"loaderData",{"_3":4,"_92":93},"root",{"_5":6,"_35":36,"_65":66},"ctx",{"_7":8,"_23":-5,"_24":25,"_26":27,"_28":20,"_29":20,"_30":20,"_31":32,"_33":20,"_34":20},"auth",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20,"_21":22},"sessionClaims","sessionId","sessionStatus","userId","actor","orgId","orgRole","orgSlug","orgPermissions","factorVerificationAge","isAuthenticated",false,"tokenType","session_token","user","preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","notificationCount",0,"flagDenols","isTeamOrgMember","ENV",{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58,"_59":60,"_61":62,"_63":64},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","VAL_RUNTIME_NAME","prod","RENDER_GIT_COMMIT","8a08d4a46a197c541e82d5fac862bafdcf40c111","RENDER_GIT_BRANCH","main","CLERK_PUBLISHABLE_KEY","pk_live_Y2xlcmsudmFsLnRvd24k","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","API_URL","https://api.val.town","clerkState",{"_67":68},"__internal_clerk_state",{"_69":70,"_71":46,"_72":73,"_74":73,"_75":20,"_76":73,"_77":73,"_78":73,"_79":73,"_80":81,"_90":20,"_91":20},"__clerk_ssr_state",{"_21":22,"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20},"__publishableKey","__proxyUrl","","__domain","__isSatellite","__signInUrl","__signUpUrl","__afterSignInUrl","__afterSignUpUrl","__clerk_debug",{"_82":20,"_19":20,"_83":73,"_84":85,"_86":73,"_87":46,"_88":20,"_89":73},"isSignedIn","proxyUrl","reason","session-token-and-uat-missing","message","publishableKey","isSatellite","domain","__telemetryDisabled","__telemetryDebug","routes/embed.x.$handle.$name.$",{"_94":95,"_96":97,"_98":99,"_100":101,"_150":151,"_173":174,"_175":-5},"handle","nbbaier","name","docs-gen","path","backend/services/docCache.ts","project",{"_102":103,"_96":97,"_104":105,"_106":-5,"_107":20,"_108":109,"_110":73,"_111":-5,"_12":112,"_113":114,"_115":116,"_117":116,"_118":-5,"_119":32,"_14":120,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_23":130,"_133":134,"_136":137,"_149":20},"id","b75c3768-c3dc-11f0-a370-42dde27851f2","createdAt",["D",1763401318495],"deletedAt","legacyEnvVars","privacy","public","description","imageUrl","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","pinnedFileId","ccc2b142-c3e4-11f0-b160-42dde27851f2","pinPreview",true,"pinMigrated","screenshotVersion","likeCount","5f80108f-7ca4-4327-b77b-089dbe4b5a82","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_94":95,"_131":132},"profileImageUrl","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","org",{"_94":95,"_135":132,"_12":112},"avatar","branch",{"_138":139,"_96":44,"_102":140,"_141":103,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":97,"_148":95},"version",155,"b75c761a-c3dc-11f0-a370-42dde27851f2","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","isOwned","file",{"_102":152,"_96":153,"_154":155,"_156":157,"_158":140,"_159":160,"_161":116,"_104":162,"_138":163,"_164":165,"_166":167,"_168":20,"_169":-5,"_98":170},"93ebf56c-c417-11f0-ba79-42dde27851f2","docCache.ts","fileId","ccdfd38a-c3e4-11f0-a716-42dde27851f2","parentId","cc70008c-c3e4-11f0-8120-42dde27851f2","branchId","branchVersion",147,"latest",["D",1763426599175],1,"fileType","script","content","/**\n * Documentation cache using Val Town blob storage with in-memory front cache\n */\n\nimport { blob } from \"https://esm.town/v/std/blob\";\n\n/**\n * Cache entry with metadata for expiration and versioning.\n *\n * @template T - Type of cached data\n */\nexport interface CacheEntry {\n /** Cached data */\n data: T;\n /** Version identifier for cache invalidation */\n version: string;\n /** Timestamp when entry was cached (milliseconds since epoch) */\n cachedAt: number;\n /** Timestamp when entry expires (milliseconds since epoch) */\n expiresAt: number;\n}\n\n/**\n * Configuration options for documentation cache.\n */\nexport interface CacheConfig {\n /** Cache time-to-live in milliseconds (default: 1 hour) */\n ttlMs?: number;\n /** Prefix for blob storage keys (default: \"doc-cache\") */\n blobPrefix?: string;\n}\n\n/**\n * Interface for documentation cache operations.\n *\n * Provides a two-tier caching system: in-memory LRU cache with blob storage fallback.\n */\nexport interface DocCache {\n /**\n * Retrieves cached data by key.\n *\n * @template T - Type of cached data\n * @param key - Cache key\n * @returns Cached data if found and not expired, null otherwise\n */\n get(key: string): Promise;\n /**\n * Stores data in cache with version metadata.\n *\n * @template T - Type of data to cache\n * @param key - Cache key\n * @param data - Data to cache\n * @param metadata - Cache metadata including version\n */\n set(key: string, data: T, metadata: { version: string }): Promise;\n /**\n * Checks if a key exists in cache and is not expired.\n *\n * @param key - Cache key\n * @returns True if key exists and is valid, false otherwise\n */\n has(key: string): Promise;\n /**\n * Checks if a cache entry is expired.\n *\n * @param key - Cache key\n * @returns True if expired or doesn't exist, false if valid\n */\n isExpired(key: string): Promise;\n /**\n * Deletes a cache entry by key.\n *\n * @param key - Cache key\n */\n delete(key: string): Promise;\n /**\n * Clears all cache entries.\n */\n clear(): Promise;\n}\n\n/**\n * In-memory cache with LRU (Least Recently Used) eviction policy.\n *\n * Maintains a fixed-size cache, automatically evicting the oldest entry when at capacity.\n */\nclass MemoryCache {\n private cache = new Map>();\n private readonly maxSize: number;\n\n constructor(maxSize = 100) {\n this.maxSize = maxSize;\n }\n\n get(key: string): CacheEntry | null {\n const entry = this.cache.get(key) as CacheEntry | undefined;\n if (!entry) return null;\n\n // Move to end (most recently used)\n this.cache.delete(key);\n this.cache.set(key, entry);\n\n return entry;\n }\n\n set(key: string, entry: CacheEntry): void {\n // Remove if exists (to update position)\n if (this.cache.has(key)) {\n this.cache.delete(key);\n }\n\n // Evict oldest if at capacity\n if (this.cache.size >= this.maxSize) {\n const firstKey = this.cache.keys().next().value;\n if (firstKey !== undefined) {\n this.cache.delete(firstKey);\n }\n }\n\n this.cache.set(key, entry);\n }\n\n has(key: string): boolean {\n return this.cache.has(key);\n }\n\n delete(key: string): void {\n this.cache.delete(key);\n }\n\n clear(): void {\n this.cache.clear();\n }\n}\n\n/**\n * Creates a documentation cache instance with two-tier storage.\n *\n * Uses in-memory LRU cache for fast access and blob storage for persistence.\n *\n * @param config - Cache configuration options\n * @returns Configured DocCache instance\n */\nexport function createDocCache(config: CacheConfig = {}): DocCache {\n const ttlMs = config.ttlMs ?? 60 * 60 * 1000; // 1 hour default\n const blobPrefix = config.blobPrefix ?? \"doc-cache\";\n const memoryCache = new MemoryCache(100);\n\n function deriveBlobKey(key: string): string {\n return `${blobPrefix}:${key}`;\n }\n\n return {\n async get(key: string): Promise {\n const now = Date.now();\n\n // Check memory cache first\n const memEntry = memoryCache.get(key);\n if (memEntry && memEntry.expiresAt > now) {\n return memEntry.data;\n }\n\n // Fall back to blob storage\n const blobKey = deriveBlobKey(key);\n const blobEntry = (await blob.getJSON(blobKey)) as CacheEntry | null;\n\n if (!blobEntry) {\n return null;\n }\n\n // Check if expired\n if (blobEntry.expiresAt <= now) {\n // Clean up expired entry\n await blob.delete(blobKey);\n memoryCache.delete(key);\n return null;\n }\n\n // Populate memory cache\n memoryCache.set(key, blobEntry);\n\n return blobEntry.data;\n },\n\n async set(\n key: string,\n data: T,\n metadata: { version: string },\n ): Promise {\n const now = Date.now();\n const entry: CacheEntry = {\n data,\n version: metadata.version,\n cachedAt: now,\n expiresAt: now + ttlMs,\n };\n\n // Store in both memory and blob\n memoryCache.set(key, entry);\n await blob.setJSON(deriveBlobKey(key), entry);\n },\n\n async has(key: string): Promise {\n // Check memory first\n if (memoryCache.has(key)) {\n const entry = memoryCache.get(key);\n if (entry && entry.expiresAt > Date.now()) {\n return true;\n }\n }\n\n // Check blob\n const blobKey = deriveBlobKey(key);\n const blobEntry = (await blob.getJSON(\n blobKey,\n )) as CacheEntry | null;\n\n if (!blobEntry) {\n return false;\n }\n\n return blobEntry.expiresAt > Date.now();\n },\n\n async isExpired(key: string): Promise {\n const hasKey = await this.has(key);\n return !hasKey;\n },\n\n async delete(key: string): Promise {\n memoryCache.delete(key);\n await blob.delete(deriveBlobKey(key));\n },\n\n async clear(): Promise {\n memoryCache.clear();\n // List and delete all blob entries with our prefix\n const keys = await blob.list(blobPrefix);\n await Promise.all(keys.map((key) => blob.delete(key)));\n },\n };\n}\n\n/**\n * Derives a normalized cache key from a val identifier and optional version.\n *\n * Normalizes the val identifier by lowercasing and replacing invalid characters.\n *\n * @param val - Val identifier in format \"username/valname\"\n * @param version - Optional version string to append\n * @returns Normalized cache key\n */\nexport function deriveCacheKey(val: string, version?: string): string {\n const normalized = val.toLowerCase().replace(/[^a-z0-9_/-]/g, \"_\");\n return version ? `${normalized}@${version}` : normalized;\n}\n\n/**\n * Default documentation cache instance with 1 hour TTL.\n *\n * Uses \"doc-manifest\" as the blob storage prefix.\n */\nexport const docCache = createDocCache({\n ttlMs: 60 * 60 * 1000,\n blobPrefix: \"doc-manifest\",\n});\n","deleted","label",[171,172,153],"backend","services","permalink","https://www.val.town/x/nbbaier/docs-gen/code/backend/services/docCache.ts","extension","actionData","errors"]