Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
import { useQuery } from "@tanstack/react-query";
import { LoaderRequestError, loaderQuery } from "./cache";
/**
* What a read returns. `T` is the data itself, or the route's `typeof loader`
* (as `useFetcher<typeof loader>` takes): then it is what that loader returns,
* without the `data()` wrapper.
*/
// biome-ignore lint/suspicious/noExplicitAny: any loader signature
export type LoaderData<T> = T extends (...args: any[]) => infer R
? Unwrapped<Awaited<R>>
: T;
// Distributes over a loader that returns `data(...)` on one path and a plain
// object on another. The shape is React Router's `DataWithResponseInit`.
type Unwrapped<R> = R extends {
type: string;
data: infer D;
init: ResponseInit | null;
}
? D
: R;
/**
* Reads an `api+` URL through the cache, as an observed query: every component
* reading the same URL shares one request, renders the cached value at once,
* and refetches when a mutation or a realtime change invalidates the entry.
* Pass `null` to wait (a picker that is still closed, an id not chosen yet).
*/
export function useLoaderQuery<T>(
url: string | null,
options?: { staleTime?: number }
) {
return useQuery<LoaderData<T>>({
...loaderQuery<LoaderData<T>>(url ?? "", options),
enabled: url !== null,
// A 403 or an expired session fails the same way every time.
retry: (failures, error) =>
!(error instanceof LoaderRequestError) && failures < 3
});
}