@nogoo9/mcp-server-cloud-fs / CacheStore

Interface: CacheStore

Defined in: cache/interface.ts:19

Cache backend interface for the VFS write-back overlay.

Implementations must handle dirty tracking, debounced flushing, and TTL-based expiry. Built-in implementations: MemoryStore, FilesystemStore, PassThroughCache, and the Redis-backed store created via createRedisStore.

Methods

clear()

clear(): Promise<void>

Defined in: cache/interface.ts:29

Returns

Promise<void>

---

delete()

delete(cacheKey): Promise<void>

Defined in: cache/interface.ts:28

Parameters

cacheKey

string

Returns

Promise<void>

---

dirtyEntries()

dirtyEntries(): string[]

Defined in: cache/interface.ts:27

Returns

string[]

---

flush()

flush(): Promise<void>

Defined in: cache/interface.ts:31

Cancels debounce timer; flushes all dirty entries to provider synchronously.

Returns

Promise<void>

---

get()

get(cacheKey): Promise<Buffer<ArrayBufferLike> | null>

Defined in: cache/interface.ts:21

Returns null on cache miss or TTL expiry. Does NOT call the provider.

Parameters

cacheKey

string

Returns

Promise<Buffer<ArrayBufferLike> | null>

---

isDirty()

isDirty(cacheKey): boolean

Defined in: cache/interface.ts:26

Parameters

cacheKey

string

Returns

boolean

---

markDirty()

markDirty(cacheKey, root, key): void

Defined in: cache/interface.ts:25

Marks cacheKey dirty and records routing info for flush. Starts debounce timer.

Parameters

cacheKey

string

root

ParsedRoot

key

string

Returns

void

---

set()

set(cacheKey, value): Promise<void>

Defined in: cache/interface.ts:23

Stores value with TTL; does NOT mark dirty.

Parameters

cacheKey

string

value

Buffer

Returns

Promise<void>