@btrc/api-client 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bowler Racing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @btrc/api-client
+
+Browser/app client for the Bowler Racing BTRC API. The root export re-exports the isomorphic client from [`@btrc/api-server`](https://www.npmjs.com/package/@btrc/api-server); `@btrc/api-client/react` adds TanStack Query v5 bindings with real `isPending` / `isLoading` / `isError` / `statusCode` states.
+
+```bash
+npm install @btrc/api-client @tanstack/react-query react
+```
+
+## React
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { createBtrcClient } from '@btrc/api-client';
+import { BtrcClientProvider, useDriver } from '@btrc/api-client/react';
+
+const client = createBtrcClient({ baseUrl: 'https://api.specuro.com' });
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <BtrcClientProvider client={client}>
+        <DriverCard id="..." />
+      </BtrcClientProvider>
+    </QueryClientProvider>
+  );
+}
+
+function DriverCard({ id }: { id: string }) {
+  const { data, isPending, isLoading, isError, error, statusCode, refetch } = useDriver(id);
+  if (isPending) return <Spinner />;
+  if (isError) return <ErrorNote status={statusCode} problem={error?.problem} />;
+  return <h1>{data?.name}</h1>;
+}
+```
+
+Convenience hooks: `useDrivers`, `useDriver`, `useEvents`, `useSessions`, `useSessionLaps`, `useLeaderboard`, `useSearch`.
+
+### Query factories (full coverage)
+
+All 147 endpoints are reachable through typed `queryOptions()` factories — composable with `useQuery`, `useSuspenseQuery`, `useInfiniteQuery`, and SSR `prefetchQuery`:
+
+```ts
+import { useBtrcQueries } from '@btrc/api-client/react';
+import { useInfiniteQuery, useSuspenseQuery } from '@tanstack/react-query';
+
+const queries = useBtrcQueries();
+const laps = useInfiniteQuery(queries.sessions.lapsInfinite({ sessionId }));
+const coverage = useSuspenseQuery(queries.discovery.coverage());
+```
+
+Paginated routes get an `<op>Infinite` variant that follows the API's cursor automatically. Query keys are namespaced under `['btrc', ...]` (`queries.keyRoot`) for easy invalidation.
+
+Failures throw `BtrcRequestError` inside query functions, so TanStack Query's `error`/retry machinery works; `statusCode` and the RFC 9457 `problem` ride on the error.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from '@btrc/api-server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from '@btrc/api-server';

package/dist/react/context.d.ts

@@ -0,0 +1,10 @@
+import type { BtrcClient } from '@btrc/api-server';
+import type { ReactNode } from 'react';
+import type { BtrcQueries } from './query-options.js';
+export declare function BtrcClientProvider({ client, children }: {
+    client: BtrcClient;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useBtrcClient(): BtrcClient;
+export declare function useBtrcQueries(): BtrcQueries;
+//# sourceMappingURL=context.d.ts.map

package/dist/react/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAStD,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAGnG;AAED,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/react/context.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+import { createBtrcQueries } from './query-options.js';
+const BtrcContext = createContext(null);
+export function BtrcClientProvider({ client, children }) {
+    const value = useMemo(() => ({ client, queries: createBtrcQueries(client) }), [client]);
+    return _jsx(BtrcContext.Provider, { value: value, children: children });
+}
+export function useBtrcClient() {
+    return useBtrcContext().client;
+}
+export function useBtrcQueries() {
+    return useBtrcContext().queries;
+}
+function useBtrcContext() {
+    const value = useContext(BtrcContext);
+    if (value === null) {
+        throw new Error('BtrcClientProvider is missing above this component');
+    }
+    return value;
+}

package/dist/react/hooks.d.ts

@@ -0,0 +1,120 @@
+import type { RouteArgs, RouteResult, Routes } from '@btrc/api-server';
+import { BtrcRequestError } from '@btrc/api-server';
+type SuccessOf<R> = Extract<R, {
+    isError: false;
+}>;
+/** The state shape promised to consumers: TanStack Query states plus HTTP detail. */
+export interface BtrcQueryState<TData> {
+    data: TData | undefined;
+    isPending: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    error: BtrcRequestError | null;
+    statusCode: number | undefined;
+    meta: unknown;
+    rateLimit: SuccessOf<RouteResult<Routes['drivers']['get']>>['rateLimit'] | undefined;
+    refetch: () => void;
+}
+export declare function useDrivers(args?: RouteArgs<Routes['drivers']['list']>): BtrcQueryState<{
+    id: string & import("zod").BRAND<"DriverId">;
+    name: string;
+    givenName: string | null;
+    familyName: string | null;
+    nationalityCode: string | null;
+    aliases?: string[] | undefined;
+}[]>;
+export declare function useDriver(driverId: string): BtrcQueryState<{
+    id: string & import("zod").BRAND<"DriverId">;
+    name: string;
+    givenName: string | null;
+    familyName: string | null;
+    nationalityCode: string | null;
+    aliases?: string[] | undefined;
+}>;
+export declare function useEvents(args?: RouteArgs<Routes['events']['list']>): BtrcQueryState<{
+    id: string & import("zod").BRAND<"EventId">;
+    championshipId: string & import("zod").BRAND<"ChampionshipId">;
+    seasonYear: number;
+    circuitLayoutId: (string & import("zod").BRAND<"CircuitLayoutId">) | null;
+    timingProviderEventId: string | null;
+    name: string;
+    startDate: string;
+    endDate: string;
+    timezone: string;
+    status: "cancelled" | "completed" | "provisional" | "scheduled";
+    resultsIndexUrl: string | null;
+    updatedAt: string;
+}[]>;
+export declare function useSessions(args?: RouteArgs<Routes['sessions']['list']>): BtrcQueryState<{
+    id: string & import("zod").BRAND<"SessionId">;
+    eventId: string & import("zod").BRAND<"EventId">;
+    code: string | null;
+    name: string;
+    type: "other" | "practice" | "qualifying" | "race" | "test" | "warmup";
+    weekendRaceNumber: number | null;
+    championshipRoundNumber: number | null;
+    scheduledStart: string | null;
+    actualStart: string | null;
+    finishTime: string | null;
+    competitorsStarted: number | null;
+    totalLaps: number | null;
+    totalDistanceMiles: number | null;
+    weather: string | null;
+    trackCondition: string | null;
+    status: "abandoned" | "cancelled" | "official" | "provisional" | "scheduled";
+    publicationVersion: string;
+    updatedAt: string;
+}[]>;
+export declare function useSessionLaps(sessionId: string, args?: Omit<RouteArgs<Routes['sessions']['laps']>, 'sessionId'>): BtrcQueryState<{
+    id: string & import("zod").BRAND<"LapId">;
+    sessionId: string & import("zod").BRAND<"SessionId">;
+    entryId: string & import("zod").BRAND<"EntryId">;
+    lapNumber: number;
+    sessionPosition: number | null;
+    lapRank: number | null;
+    lapTime: string | null;
+    lapTimeMs: number | null;
+    elapsedTimeMs: number | null;
+    averageMph: number | null;
+    personalBestDiff: string | null;
+    personalBestDiffMs: number | null;
+    timeOfDay: string | null;
+    pitMarker: string | null;
+    isDisallowed: boolean;
+    isOutLap: boolean;
+    isInPit: boolean;
+    sectors?: {
+        id: string;
+        lapId: string & import("zod").BRAND<"LapId">;
+        sectorNumber: number;
+        time: string | null;
+        timeMs: number | null;
+        isPersonalBest: boolean | null;
+        isSessionBest: boolean | null;
+        provenance: {
+            sourcePageId: (string & import("zod").BRAND<"SourcePageId">) | null;
+            sourceDocumentId?: (string & import("zod").BRAND<"SourceDocumentId">) | null | undefined;
+            kind?: "derived" | "published" | undefined;
+        };
+    }[] | undefined;
+    quality: {
+        status: "exception" | "not_applicable" | "provisional" | "unchecked" | "verified";
+        checkedAt?: string | null | undefined;
+        pipelineVersion?: string | null | undefined;
+    };
+    provenance: {
+        sourcePageId: (string & import("zod").BRAND<"SourcePageId">) | null;
+        sourceDocumentId?: (string & import("zod").BRAND<"SourceDocumentId">) | null | undefined;
+        kind?: "derived" | "published" | undefined;
+    };
+}[]>;
+export type LeaderboardKind = 'lap-times' | 'sector-times' | 'consistency' | 'wins' | 'podiums' | 'poles' | 'fastest-laps' | 'laps-led';
+export declare function useLeaderboard(kind: LeaderboardKind, args?: RouteArgs<Routes['leaderboards']['wins']>): BtrcQueryState<unknown[]>;
+export declare function useSearch(q: string, limit?: number): BtrcQueryState<{
+    type: "bulletin" | "circuit" | "driver" | "event" | "judicial-decision" | "official" | "publication" | "session";
+    id: string;
+    label: string;
+    description: string | null;
+}[]>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMpD,KAAK,SAAS,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAEnD,qFAAqF;AACrF,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IACrF,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAyBD,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;;;;;;;KAGrE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM;;;;;;;GAGzC;AAED,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;KAGnE;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;;;;;;;KAGvE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKhH;AAED,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,cAAc,GACd,aAAa,GACb,MAAM,GACN,SAAS,GACT,OAAO,GACP,cAAc,GACd,UAAU,CAAC;AAaf,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,6BAMrG;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;KAOlD"}

package/dist/react/hooks.js

@@ -0,0 +1,62 @@
+import { BtrcRequestError } from '@btrc/api-server';
+import { useQuery } from '@tanstack/react-query';
+import { useBtrcQueries } from './context.js';
+function toState(query) {
+    const error = query.error instanceof BtrcRequestError ? query.error : null;
+    return {
+        data: query.data?.data,
+        isPending: query.isPending,
+        isLoading: query.isLoading,
+        isError: query.isError,
+        error,
+        statusCode: query.data?.statusCode ?? error?.statusCode ?? undefined,
+        meta: query.data?.meta,
+        rateLimit: (query.data?.rateLimit ?? error?.rateLimit ?? undefined),
+        refetch: () => {
+            void query.refetch();
+        },
+    };
+}
+export function useDrivers(args) {
+    const queries = useBtrcQueries();
+    return toState(useQuery(queries.drivers.list(args)));
+}
+export function useDriver(driverId) {
+    const queries = useBtrcQueries();
+    return toState(useQuery(queries.drivers.get({ driverId })));
+}
+export function useEvents(args) {
+    const queries = useBtrcQueries();
+    return toState(useQuery(queries.events.list(args)));
+}
+export function useSessions(args) {
+    const queries = useBtrcQueries();
+    return toState(useQuery(queries.sessions.list(args)));
+}
+export function useSessionLaps(sessionId, args) {
+    const queries = useBtrcQueries();
+    return toState(useQuery(queries.sessions.laps({ ...args, sessionId })));
+}
+const LEADERBOARD_OPS = {
+    'lap-times': 'lapTimes',
+    'sector-times': 'sectorTimes',
+    consistency: 'consistency',
+    wins: 'wins',
+    podiums: 'podiums',
+    poles: 'poles',
+    'fastest-laps': 'fastestLaps',
+    'laps-led': 'lapsLed',
+};
+export function useLeaderboard(kind, args) {
+    const queries = useBtrcQueries();
+    const factory = queries.leaderboards[LEADERBOARD_OPS[kind]];
+    return toState(useQuery(factory(args)));
+}
+export function useSearch(q, limit) {
+    const queries = useBtrcQueries();
+    const query = useQuery({
+        ...queries.discovery.search(limit === undefined ? { q } : { q, limit }),
+        enabled: q.trim().length >= 2,
+    });
+    return toState(query);
+}

package/dist/react/index.d.ts

@@ -0,0 +1,7 @@
+export { BtrcClientProvider, useBtrcClient, useBtrcQueries } from './context.js';
+export { createBtrcQueries, unwrap } from './query-options.js';
+export type { BtrcQueries } from './query-options.js';
+export { useDriver, useDrivers, useEvents, useLeaderboard, useSearch, useSessionLaps, useSessions, } from './hooks.js';
+export type { BtrcQueryState, LeaderboardKind } from './hooks.js';
+export { BtrcRequestError } from '@btrc/api-server';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,SAAS,EACT,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,4 @@
+export { BtrcClientProvider, useBtrcClient, useBtrcQueries } from './context.js';
+export { createBtrcQueries, unwrap } from './query-options.js';
+export { useDriver, useDrivers, useEvents, useLeaderboard, useSearch, useSessionLaps, useSessions, } from './hooks.js';
+export { BtrcRequestError } from '@btrc/api-server';

package/dist/react/query-options.d.ts

@@ -0,0 +1,29 @@
+import type { BtrcClient, RouteArgs, RouteResult } from '@btrc/api-server';
+import { BtrcRequestError } from '@btrc/api-server';
+import type { RouteDef, Routes } from '@btrc/api-server';
+import { infiniteQueryOptions, queryOptions } from '@tanstack/react-query';
+type SuccessResult<R extends RouteDef> = Extract<RouteResult<R>, {
+    isError: false;
+}>;
+/** Throws BtrcRequestError so TanStack Query's error/retry machinery engages. */
+export declare function unwrap<R extends RouteDef>(result: RouteResult<R>): SuccessResult<R>;
+type RouteQueryFactory<R extends RouteDef> = [RouteArgs<R>] extends [Record<never, never>] ? (args?: RouteArgs<R>) => ReturnType<typeof queryOptions<SuccessResult<R>, BtrcRequestError>> : (args: RouteArgs<R>) => ReturnType<typeof queryOptions<SuccessResult<R>, BtrcRequestError>>;
+type PaginatedKeys<G> = {
+    [K in keyof G]: G[K] extends {
+        paginated: true;
+    } ? K : never;
+}[keyof G];
+type NamespaceFactories<G> = {
+    [K in keyof G]: RouteQueryFactory<G[K] & RouteDef>;
+} & {
+    [K in PaginatedKeys<G> & string as `${K}Infinite`]: (args?: RouteArgs<G[K] & RouteDef>) => ReturnType<typeof infiniteQueryOptions<SuccessResult<G[K] & RouteDef>, BtrcRequestError>>;
+};
+export type BtrcQueries = {
+    readonly [G in keyof Routes]: NamespaceFactories<Routes[G]>;
+} & {
+    /** Root of every query key produced by these factories; useful for broad invalidation. */
+    readonly keyRoot: readonly ['btrc'];
+};
+export declare function createBtrcQueries(client: BtrcClient): BtrcQueries;
+export {};
+//# sourceMappingURL=query-options.d.ts.map

package/dist/react/query-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-options.d.ts","sourceRoot":"","sources":["../../src/react/query-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkB,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAU,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3E,KAAK,aAAa,CAAC,CAAC,SAAS,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErF,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAKnF;AAED,KAAK,iBAAiB,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GACtF,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAC5F,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEhG,KAAK,aAAa,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAElG,KAAK,kBAAkB,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;CACnD,GAAG;KACD,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,CAClD,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAC9B,UAAU,CACb,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAC9E;CACF,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,CAAC,IAAI,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC5D,GAAG;IACF,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CA4CjE"}

package/dist/react/query-options.js

@@ -0,0 +1,38 @@
+import { BtrcRequestError, routes } from '@btrc/api-server';
+import { infiniteQueryOptions, queryOptions } from '@tanstack/react-query';
+/** Throws BtrcRequestError so TanStack Query's error/retry machinery engages. */
+export function unwrap(result) {
+    if (result.isError) {
+        throw new BtrcRequestError(result.error, result.statusCode, result.rateLimit);
+    }
+    return result;
+}
+export function createBtrcQueries(client) {
+    const factories = { keyRoot: ['btrc'] };
+    for (const [namespaceName, defs] of Object.entries(routes)) {
+        const namespace = {};
+        const clientNamespace = client[namespaceName];
+        for (const [opName, route] of Object.entries(defs)) {
+            const call = clientNamespace[opName];
+            namespace[opName] = (args) => queryOptions({
+                queryKey: ['btrc', namespaceName, opName, args ?? {}],
+                queryFn: async ({ signal }) => unwrap(await call(args, { signal })),
+            });
+            if (route.paginated) {
+                namespace[`${opName}Infinite`] = (args) => infiniteQueryOptions({
+                    queryKey: ['btrc', namespaceName, opName, 'infinite', args ?? {}],
+                    queryFn: async ({ pageParam, signal }) => unwrap(await call(pageParam === undefined ? args : { ...args, cursor: pageParam }, { signal })),
+                    initialPageParam: undefined,
+                    getNextPageParam: (lastPage) => {
+                        const meta = (lastPage.meta ?? {});
+                        return meta.hasMore === true && typeof meta.nextCursor === 'string'
+                            ? meta.nextCursor
+                            : undefined;
+                    },
+                });
+            }
+        }
+        factories[namespaceName] = namespace;
+    }
+    return factories;
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@btrc/api-client",
+  "version": "0.0.2",
+  "description": "Typed browser/app client for the Bowler Racing BTRC API, with TanStack Query bindings at @btrc/api-client/react",
+  "private": false,
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.13"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ReeceCenturion/BTRC.git",
+    "directory": "packages/api-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.25.67",
+    "@btrc/contracts": "^0.0.2",
+    "@btrc/api-server": "^0.0.2"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.62.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.101.4",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22.10.0",
+    "@types/react": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "rimraf": "^6.0.1",
+    "typescript": "7.0.2",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo lint skipped: typescript-eslint does not yet support TypeScript 7 (TODO: restore eslint . when @typescript-eslint ships TS7 support)",
+    "test": "vitest run",
+    "clean": "rimraf .turbo dist coverage"
+  }
+}