Class CacheUtils

Retrieves multiple values from the cache in parallel.

Example

const results = await CacheUtils.batchGet(cache, ['key1', 'key2', 'key3']);
console.log(results.get('key1')); // cached value or null
Copy

Stores multiple key-value pairs in the cache in parallel.

Example

await CacheUtils.batchSet(cache, [
  { key: 'key1', value: 'value1', options: { ttl: 5000 } },
  { key: 'key2', value: 'value2' }
]);
Copy

Creates a memoizer function bound to a specific cache instance. Useful for creating multiple memoized functions with the same cache and default options.

Example

const cache = new MemoryCache();
const memoizer = CacheUtils.createMemoizer(cache, {
  ttl: 300000,
  namespace: 'api'
});

const memoizedFetch = memoizer(fetchUserData);
const memoizedCalc = memoizer(expensiveCalculation, { ttl: 600000 });
Copy

Generates a hash-based cache key from input data. Uses SHA256 for collision resistance and security.

Example

const key1 = await CacheUtils.generateKey('some text content');
const key2 = await CacheUtils.generateKey({ prompt: 'extract', content: 'medical text' });
Copy

Synchronous key generation for sync functions

Check if a function is async

Memoizes a function using the provided cache instance. Creates a cached version of the function that stores results and returns cached values for repeated calls.

Example

const cache = new MemoryCache();
const memoizedFn = CacheUtils.memoize(expensiveFunction, cache, {
  ttl: 300000, // 5 minutes
  namespace: 'calculations',
  keyGenerator: (args) => `custom:${args[0]}`
});

// First call - executes function and caches result
const result1 = await memoizedFn(123);
// Second call - returns cached result
const result2 = await memoizedFn(123);
Copy

Improved memoize function that properly handles both sync and async functions. For async functions, it caches the resolved value, not the promise itself. For sync functions, it caches the return value directly.