PVCache class

A configurable cache instance with hook-based extensibility.

Each cache has its own environment namespace and supports custom hooks for TTL, encryption, LRU, and other behaviors.

Example - Basic cache:

final cache = PVCache(
  env: 'dev',
  hooks: [],
  defaultMetadata: {},
);
await cache.put('user:123', {'name': 'Alice'});

Example - Cache with TTL:

final cache = PVCache(
  env: 'prod',
  hooks: [createTTLHook()],
  defaultMetadata: {},
);
await cache.put('session', token, metadata: {'ttl_seconds': 3600});

Example - Cache with macro get (pattern-based auto-fetch):

final cache = PVCache(
  env: 'prod',
  hooks: [createTTLHook()],
  defaultMetadata: {},
  macroGetHandlers: {
    RegExp(r'^user:\d+$'): (key) async {
      final userId = key.split(':')[1];
      return await api.fetchUser(userId);
    },
  },
);
// Automatically fetches from API if not cached
final user = await cache.get('user:123');