Ultra lightweight query manager

• super small bundle size 📦
• manages deterministic query keys and invocations 🛠️
• enhances type safety of existing fetching packages 🧪
• organizes fetching structure into schemas 🫐
• fully tree shake-able 🌴

Usage

1import { query, schema } from 'qman'
2import { use } from 'qman/swr' // or qman/query
3
4// Specifies your getters, can be api route, db handlers, anything that returns a promise
5const getAllUsers = () => fetch('your.api/users/')
6const getUserById = (id: string) => fetch(`your.api/users/${id}`)
7
8// Specifies a schema that organizes your api, declare multiple schemas based on category
9export const users = schema(
10  'users',
11  query('allUsers', getAllUsers, use), 
12  query('byId', getUserById, use),
13  query('somePromise', directDBPromiseFn) // note we don't have to use swr/query adapters here
14)
15
16// Later in code (usually in different file) use your schema.
17users.get('allUsers', [])
18users.get('byId', ['exampleId123']) // You get full type-safety here with exact argument names i.e. `[id: string]`

This also ensures your query keys are always unique even if different schemas have same queries. i.e. you can have a schema called users and posts which both ship byId query. You can be sure and safe that even if you mutate / revalidate, it will stay within the schema boundaries and will get type safety according to schema definitions.

Advanced usage

Adds support for advanced query usage, such as

• firebase
• subscriptions
• infinite and paginated queries
• mutations
• and more

documentation will come with beta release, will expand on these topics.