@playlive/react-data

@playlive/react-data — minimal React hooks over @playlive/fundraiser-data.

No TanStack Query, no Zustand. Built on useState + useEffect with AbortController-driven cancellation, optional polling, and exponential-backoff retry. Drop-in compatible with @playlive/react-query — same hook names, same parameter shape, same { data, error, isLoading, isFetching, refetch } return.

Subpath exports (PRD §5.14 — jose-style "take only what you need"):

@playlive/react-data — full barrel (this file).
@playlive/react-data/core — the useFetch primitive only.
@playlive/react-data/types — shared result + option types.

Peer deps: react (^19), @playlive/fundraiser-data. No react-dom — these hooks render nothing.

Example

import { configure } from "@playlive/fundraiser-data/config";
import { useCampaign, useFlattenedDonations } from "@playlive/react-data";

configure({ tiltifyProxyUrl: "https://proxy.example" });

function Overlay({ id }: { id: string }) {
  const campaign = useCampaign({ charityType: "tiltify", id });
  const donations = useFlattenedDonations({ campaignId: id });
  if (campaign.isLoading) return "Loading…";
  if (campaign.error) return `Error: ${campaign.error.message}`;
  return <pre>{JSON.stringify({ campaign: campaign.data, donations: donations.data })}</pre>;
}

@playlive/react-data

Example

Interfaces

Type Aliases

Variables

Functions

Settings

On This Page