hassanzohdy/mongez-http/caching

interface CacheDriver {
  get<T = unknown>(key: string): Promise<T | null | undefined>
  set(key: string, value: unknown, ttl?: number): Promise<void> | void
  remove?(key: string): Promise<void> | void
  clear?(): Promise<void> | void   // required for `http.invalidateAll()`
}

// Global — all GET requests are cached
const http = new Http({
  baseURL: '...',
  cache: {
    driver: myDriver,
    ttl: 300,                           // seconds, default 300
    generateKey: (url, params) => url,  // optional custom key
  },
});
// Globally disabled
const http = new Http({ cache: false });

// Force-disable cache for this call
const { data } = await http.get('/users', { cache: false });
// Force-enable for this call (inherits global driver)
const { data } = await http.get('/static/config', { cache: true });
// Per-request driver override
const { data } = await http.get('/users', {
  cache: { driver: sessionDriver, ttl: 60 },
});
// Explicit cache key
const { data } = await http.get('/users', { cacheKey: 'all-users' });
// Server-side: the key must identify the caller, or the request throws
const { data } = await http.get('/me', { cacheKey: `me:${session.userId}` });

const store = new Map<string, unknown>();
const memoryDriver = {
  get: async (k) => store.get(k) ?? null,
  set: async (k, v) => { store.set(k, v); },
  remove: async (k) => { store.delete(k); },
};

const localStorageDriver = {
  get: async (k) => {
    const raw = localStorage.getItem(k);
    return raw ? JSON.parse(raw) : null;
  },
  set: async (k, v, ttl) => {
    localStorage.setItem(k, JSON.stringify(v));
    if (ttl) {
      setTimeout(() => localStorage.removeItem(k), ttl * 1000);
    }
  },
  remove: async (k) => { localStorage.removeItem(k); },
};