API: utils/memoryCache

better-web-search-mcp / utils/memoryCache

utils/memoryCache#

Classes#

MemoryCache#

A cache backend backed by a plain Map.

Search entries expire after SEARCH_TTL_MS, page entries after PAGE_TTL_MS; domain profiles and API patterns never expire.

Constructors#

Constructor#

new MemoryCache(): MemoryCache

Returns#

MemoryCache

Methods#

addApiPattern()#

addApiPattern(domain, endpointPattern, method, contentType): void

Defined in: src/utils/memoryCache.ts:76

Record a discovered API endpoint pattern for a domain.

Parameters#

Parameter	Type
`domain`	`string`
`endpointPattern`	`string`
`method`	`string`
`contentType`	`string`

Returns#

void

clear()#

clear(): void

Defined in: src/utils/memoryCache.ts:28

Drop every entry (used on close).

Returns#

void

getApiPatterns()#

getApiPatterns(domain): ApiPattern[]

Defined in: src/utils/memoryCache.ts:99

List all API patterns for a domain, newest first.

Parameters#

Parameter	Type
`domain`	`string`

Returns#

ApiPattern[]

getDomain()#

getDomain(domain): unknown

Defined in: src/utils/memoryCache.ts:66

Read a cached domain profile, or null on miss.

Parameters#

Parameter	Type
`domain`	`string`

Returns#

unknown

getPage()#

getPage(url): PageCacheEntry | null

Defined in: src/utils/memoryCache.ts:43

Read a cached page entry, or null on miss / expiry.

Parameters#

Parameter	Type
`url`	`string`

Returns#

PageCacheEntry | null

getSearch()#

getSearch(key): unknown

Defined in: src/utils/memoryCache.ts:33

Read a search result, or null on miss / expiry.

Parameters#

Parameter	Type
`key`	`string`

Returns#

unknown

pruneExpired()#

pruneExpired(): void

Defined in: src/utils/memoryCache.ts:108

Delete every search/page entry whose TTL has expired.

Returns#

void

setDomain()#

setDomain(domain, profile): void

Defined in: src/utils/memoryCache.ts:71

Upsert a domain profile.

Parameters#

Parameter	Type
`domain`	`string`
`profile`	`unknown`

Returns#

void

setPage()#

setPage(url, content, extractionMethod, confidence): void

Defined in: src/utils/memoryCache.ts:49

Store a page extraction, refreshing the TTL on overwrite.

Parameters#

Parameter	Type
`url`	`string`
`content`	`string`
`extractionMethod`	`string`
`confidence`	`number`

Returns#

void

setSearch()#

setSearch(key, _query, results): void

Defined in: src/utils/memoryCache.ts:38

Store a search result, refreshing the TTL on overwrite.

Parameters#

Parameter	Type
`key`	`string`
`_query`	`string`
`results`	`unknown`

Returns#

void