Service status

A graft built on TanStack Query that polls more often while a service is down.

eu
checking…
us
checking…

Mounted

The same graft twice, with a different region: two cache keys and two independent states.

tsx
// react-graft-services-demo.tsx
export const ReactGraftServicesDemo = () => (
  <QueryClientProvider client={client}>
    <ReactGraftServicesGraft.Provider region="eu">
      <ReactGraftServicesPanel />
    </ReactGraftServicesGraft.Provider>

    <ReactGraftServicesGraft.Provider region="us">
      <ReactGraftServicesPanel />
    </ReactGraftServicesGraft.Provider>
  </QueryClientProvider>
);

The graft is a query

useQuery is a hook, so it can be the graft. The provider's prop goes in the key, and the graft returns only what the feature needs.

tsx
// react-graft-services.graft.ts
export const ReactGraftServicesGraft = createGraft({
  name: "ReactGraftServicesGraft",
  graft: useGraft,
  inject: [useInjectEscalate],
});

function useGraft({ region }: { region: Region }) {
  const query = useQuery({
    queryKey: ["services", region],
    queryFn: () => serviceFetch(region),
    staleTime: 10_000,
  });

  const services = query.data ?? [];

  return {
    region,
    services,
    isDown: services.some((service) => service.status === "down"),
    isPending: query.isPending,
    isFetching: query.isFetching,
    refetch: query.refetch,
  };
}

Polling faster

While something is down, an injected effect polls more often. No component has to start it.

tsx
// while something is down, ask more often
function useInjectEscalate({ isDown, refetch }: { isDown: boolean; refetch: () => void }) {
  useEffect(() => {
    if (!isDown) return;

    const interval = setInterval(() => refetch(), ESCALATED_INTERVAL);

    return () => clearInterval(interval);
  }, [isDown, refetch]);
}

What components see

Components get a flat object, with no query key or client to pass around.

tsx
// react-graft-services-panel.tsx
export const ReactGraftServicesPanel = () => {
  const { isDown, isFetching, isPending, refetch, region, services } = ReactGraftServicesGraft.use();

  return (
    <Card>
      <span>{region}</span>
      {isFetching && <Spinner />}
      …
    </Card>
  );
};