@lazarv/react-server/resources

Typed server resources — createResource / createResources — for binding validated data loaders to routes and reading them inside server components.

function createResource(): ResourceDescriptor<void>;
function createResource<TKey>(options: {
    key: ValidateSchema<TKey>;
}): ResourceDescriptor<TKey>;
function createResource<TParseMap extends Record<string, (value: string) => any>>(options: {
    key: TParseMap;
}): ResourceDescriptor<InferParseMap<TParseMap>>;

Create a singleton resource descriptor (no key).

export const currentUser = createResource();

function createResources<T extends Record<string, ResourceDescriptor<any, any>>>(resources: T): ResourceCollection<T>;

Collect resources into a typed registry.

export const resources = createResources({ userById, posts, currentUser });
resources.invalidateAll(); // bust all caches

const resources: Record<string, ResourceDescriptor<any, any>>;

Collection of file-router generated resource descriptors. Each entry is created from .resource.ts/js files via the file-router.

Empty when the file-router is not active.

import { resources } from "@lazarv/react-server/resources";

const data = resources.todos.use({ filter: "all" });
resources.todos.invalidate({ filter: "all" });

interface ResourceBinding<TKey = void, TData = unknown> {
    resource: ResourceDescriptor<TKey, TData>;
    mapFn: (routeParams: Record<string, any>, searchParams: Record<string, any>) => TKey extends void ? void : TKey;
}

A route-resource binding returned by .from(). Used in createRoute's resources option to load data when a route matches.

interface ResourceDescriptor<TKey = void, TData = unknown> {
    readonly _loader: ((key: TKey) => TData | Promise<TData>) | null;
    readonly key: ValidateSchema<TKey> | Record<string, (value: string) => any> | null;
    use: TKey extends void ? () => TData : (key: TKey) => TData;
    query: TKey extends void ? () => Promise<TData> : (key: TKey) => Promise<TData>;
    prefetch: TKey extends void ? () => void : (key: TKey) => void;
    invalidate: TKey extends void ? () => void | Promise<void> : (key?: TKey) => void | Promise<void>;
    from: TKey extends void ? never : (mapFn: (routeParams: Record<string, any>, searchParams: Record<string, any>) => TKey) => ResourceBinding<TKey, TData>;
    bind: <TBoundData>(loader: TKey extends void ? () => TBoundData | Promise<TBoundData> : (key: TKey) => TBoundData | Promise<TBoundData>) => ResourceDescriptor<TKey, TBoundData>;
}

A typed resource descriptor with suspense-integrated data fetching, imperative queries, cache prefetching, and invalidation.

Created by createResource(options?) (descriptor only, no loader). Call .bind(loaderFn) to attach a loader.

type ResourceCollection<T extends Record<string, ResourceDescriptor<any, any>>> = T & {
    invalidateAll(): Promise<void[]>;
};

A resource collection with individual resources and invalidateAll().