Added

Client (@coinlist-co/react, @coinlist-co/react/client)

• fetchOfferRequirements(offerId) on CoinListClient — returns requirements grouped by option ID (Record<OfferOptionId, Requirement[]>).
• fetchRequirementStatuses(offerId) on CoinListClient — returns the authenticated user’s status for each requirement.
• useCoinListRequirements(offerId) hook for loading requirements and statuses with a LOADING / CONTENT / ERROR state machine.
• sandbox option on ClientConfig — when true, passes sandbox=true to offers API calls so sandbox offers are included.
• New exported types: Requirement, RequirementId, RequirementType, RequirementStatusValue, RequirementStatusInfo, ParticipationsPaginationParams.
• New exported enums/constants: RequirementVariant, RequirementStatus, ChecklistStatus.
• New hook types: UseCoinListRequirementsResult, LoadRequirementsState, LoadRequirementsReason.
• fetchAllParticipations(offerId?) and fetchParticipationsPage(params) now accept an optional offerId to fetch participations for a specific offer. fetchParticipationsPage takes the new ParticipationsPaginationParams type (superset of PaginationParams) which carries the offerId field.

Fixed

Components

• Fixed missing dark mode CSS variables in Next.js projects — prebuilt styles now include the full set of design-system tokens so components render correctly under dark class or prefers-color-scheme: dark.

Added

Client (@coinlist-co/react, @coinlist-co/react/client)

• fetchAllParticipations() on CoinListClient for fetching all participations across pages.
• fetchParticipationsPage() on CoinListClient for paginated participation fetching.
• fetchParticipation() on CoinListClient for fetching a single participation by id.
• createParticipation() on CoinListClient for creating a new participation.
• New exported types: Participation, ParticipationId, ParticipationStatus, CreateParticipationParams, Blockchain, WalletAddress.

Added

Client (@coinlist-co/react, @coinlist-co/react/client)

• Added support for passing className and containerClassName to <OffersGrid />, <OfferCard />, and <CoinListSignInCard />.

Fixed

Client (@coinlist-co/react, @coinlist-co/react/client)

• Re-export offer, offer detail, and pagination types from the package root and client core entry so you can type against Offer, OfferDetail, pagination params, and related helpers without reaching into internal modules.
• Export BaseCoinListSignInCard and BaseCoinListSignInCardProps from @coinlist-co/react/client for custom sign-in layouts built on the same primitives as CoinListSignInCard.

Added

Client (@coinlist-co/react/client)

• fetchAllOffers(), fetchOffersPage(), and fetchOfferDetails() on CoinListClient for fetching offers data.
• <OffersGrid /> — batteries-included component that loads offers and displays them in a responsive grid, with <OfferCard /> for each tile.
• useCoinListOffers() hook for loading offers when you want full control over layout instead of the grid.
• useCoinListOfferDetails() hook for a single offer’s details.
• useCompleteCoinListOAuth() hook to run the OAuth redirect callback once on mount.
• Optional authorizationPageUrl on client config so you can point startOAuth() at a non-production authorization page.

Added

Client (@coinlist-co/react/client)

• CoinListProvider and useCoinList() hook for React context-based SDK initialization.
• createCoinListClient(config) factory for manual or non-React usage.
• OAuth 2.0 with PKCE via startOAuth() and completeOAuth().
• getAuthState() and logout().

Server (@coinlist-co/react/server)

• createCoinListServer(config) factory for BFF / Next.js API routes.
• completeOAuth(), accessToken() (auto-refreshing), and logout().

Components

• CoinListSignInCard and CoinListSignInButton for OAuth sign-in flows.
• RequirementsChecklist / RequirementItem — eligibility checklist with accordion UI.
• PoweredByCoinList attribution badge.
• Prebuilt CSS — no tailwindcss peer dependency required.

Infrastructure

• Subpath exports: @coinlist-co/react, @coinlist-co/react/client, @coinlist-co/react/server.
• Requires React 18+.