@t87s/core

Cache that tells you when it's wrong.

npm install @t87s/core

Quickstart

QueryCache is the smooth path. Primitives are the sharp one. Both are first-class.

import { QueryCache, at, wild, MemoryAdapter } from '@t87s/core';

const schema = at('users', () => wild.at('settings'));

const cache = QueryCache({
  schema,
  adapter: new MemoryAdapter(),
  queries: (tags) => ({
    getUser: (id: string) => ({
      tags: [tags.users(id)],
      fn: () => db.users.findById(id),
    }),
  }),
});

await cache.getUser('123');
await cache.invalidate(cache.tags.users('123'));

// Access cache metadata via .entries
const result = await cache.getUser('123').entries;
console.log(result.before); // CacheEntry | null (null on miss)
console.log(result.after); // CacheEntry (always present)

If you want the raw tools:

import { createPrimitives, MemoryAdapter } from '@t87s/core';

const p = createPrimitives({ adapter: new MemoryAdapter() });

await p.query({
  key: 'users:123',
  tags: [['users', '123']],
  fn: () => db.users.findById('123'),
});

Go read the docs

There's more to know: prefix matching, TTLs, grace periods, the two APIs, and the cloud. The docs are at t87s.dev and they're worth reading.

License

MIT