@bigballsports/sdk 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @bigballsports/sdk
+
+Official TypeScript SDK for the Big Ball Sports API.
+
+## Install
+
+```bash
+npm install @bigballsports/sdk
+```
+
+## Quick start
+
+```ts
+import { BigBallSportsClient } from '@bigballsports/sdk';
+
+const client = new BigBallSportsClient('bbs_your_api_key');
+
+const today = await client.matches.list({ sport: 'football', date: '2026-04-17' });
+console.log(today.data);
+
+const live = await client.matches.get('m-123', ['scores', 'odds', 'lineups']);
+console.log(live.data.scores, live.data.odds);
+```
+
+## WebSocket subscriptions
+
+```ts
+import { io } from 'socket.io-client';
+
+const unsubscribe = client.subscribe(
+  'match:m-123',
+  (event) => console.log(event.type, event.data),
+  { socketIo: io },
+);
+
+// later:
+unsubscribe();
+```
+
+Zero runtime dependencies. `socket.io-client` is required only if you use
+`subscribe()` — pass it in via `{ socketIo: io }`.

package/dist/canonical.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Big Ball Sports canonical data contract — SDK mirror.
+ *
+ * These types are a verbatim duplicate of `@bbs/shared/src/types/canonical.ts`.
+ * The SDK is published as a zero-dependency package, so it can't import
+ * from the workspace at runtime — but drift between this file and the
+ * server's canonical schema would silently break customer apps.
+ *
+ * The drift-prevention test
+ * (`packages/sdk/src/canonical.test.ts`) fails the build when this file
+ * diverges from `@bbs/shared`.
+ *
+ * Three contract invariants (same as the docs/DATA_CONTRACT.md):
+ *
+ *   1. Every `id` field is a BigBalls canonical id matching
+ *      `^bb_<entity>_[a-z0-9]+$`. Vendor IDs are translated upstream.
+ *   2. Every status / market / method / event-type field is one of the
+ *      enumerated string literals declared below. Vendor strings are
+ *      never returned.
+ *   3. There is no `unknown` / `Record<string, unknown>` in any return
+ *      type. If you see one, it's a bug.
+ */
+export type SportType = 'football' | 'basketball' | 'baseball' | 'ice_hockey' | 'cricket' | 'mma' | 'boxing' | 'formula1' | 'american_football';
+export type CanonicalMatchStatus = 'scheduled' | 'in_progress' | 'finished' | 'postponed' | 'cancelled' | 'suspended';
+export type CanonicalEventType = 'period_start' | 'period_end' | 'final' | 'goal' | 'own_goal' | 'penalty_scored' | 'penalty_missed' | 'card_yellow' | 'card_red' | 'substitution' | 'home_run' | 'strikeout' | 'walk' | 'rbi' | 'three_pointer' | 'free_throw_made' | 'rebound' | 'shot_on_goal' | 'power_play_goal' | 'touchdown' | 'field_goal' | 'turnover' | 'over_complete' | 'wicket' | 'boundary_four' | 'boundary_six' | 'knockdown' | 'submission_attempt' | 'other';
+export type CanonicalOddsMarket = 'moneyline' | 'spread' | 'total' | 'btts' | 'draw_no_bet' | 'double_chance';
+export type CanonicalSelectionName = 'home' | 'away' | 'draw' | 'over' | 'under' | 'yes' | 'no' | 'home_or_draw' | 'away_or_draw' | 'home_or_away';
+export type CanonicalMetricName = 'goals' | 'assists' | 'shots' | 'shots_on_target' | 'possession_percent' | 'passes' | 'pass_accuracy_percent' | 'corners' | 'fouls' | 'offsides' | 'cards_yellow' | 'cards_red' | 'saves' | 'xg' | 'progressive_passes' | 'pressures' | 'tackles' | 'interceptions' | 'points' | 'rebounds' | 'three_pointers_made' | 'three_pointers_attempted' | 'free_throws_made' | 'free_throws_attempted' | 'home_runs' | 'rbi' | 'strikeouts' | 'walks' | 'batting_average' | 'significant_strikes_landed' | 'significant_strikes_attempted' | 'takedowns_landed' | 'takedowns_attempted' | 'knockdowns' | 'control_time_seconds' | 'runs' | 'wickets' | 'overs' | 'fours' | 'sixes' | 'strike_rate' | 'economy' | 'market_value_eur';
+export type CanonicalMetricUnit = 'count' | 'percent' | 'seconds' | 'meters' | 'unit';
+export type CanonicalFightMethod = 'ko' | 'tko' | 'submission' | 'unanimous_decision' | 'split_decision' | 'majority_decision' | 'technical_decision' | 'disqualification' | 'no_contest' | 'draw';
+export type CanonicalCricketFormat = 't10' | 't20' | 'odi' | 'test' | 'first_class';
+export type CanonicalFightStance = 'orthodox' | 'southpaw' | 'switch';
+export type CanonicalSessionType = 'practice' | 'qualifying' | 'sprint' | 'race';
+export interface CanonicalEntity {
+    /** `bb_<entity>_<10–32 lowercase base32 chars>`. Stable across crashes. */
+    readonly id: string;
+}
+export interface CanonicalTeam extends CanonicalEntity {
+    readonly sport: SportType;
+    readonly name: string;
+    readonly short_name?: string;
+    readonly country?: string;
+    readonly founded_year?: number;
+}
+export interface CanonicalPlayer extends CanonicalEntity {
+    readonly sport: SportType;
+    readonly full_name: string;
+    readonly display_name: string;
+    readonly current_team_id?: string;
+    readonly position?: string;
+    readonly shirt_number?: number;
+    readonly date_of_birth?: string;
+    readonly nationality?: string;
+    readonly height_cm?: number;
+    readonly weight_kg?: number;
+}
+export interface CanonicalLeague extends CanonicalEntity {
+    readonly sport: SportType;
+    readonly name: string;
+    readonly country?: string;
+}
+export interface CanonicalPeriodScore {
+    readonly period: number;
+    readonly label: string;
+    readonly home: number;
+    readonly away: number;
+}
+export interface CanonicalClock {
+    readonly elapsed_seconds: number;
+    readonly period: number;
+    readonly added_seconds?: number;
+}
+export interface CanonicalScore {
+    readonly match_id: string;
+    readonly home: number | null;
+    readonly away: number | null;
+    readonly status: CanonicalMatchStatus;
+    readonly period_scores?: readonly CanonicalPeriodScore[];
+    readonly clock?: CanonicalClock;
+    readonly updated_at: string;
+}
+export interface CanonicalMatchSide {
+    readonly team_id: string;
+    readonly team_name: string;
+}
+export interface CanonicalMatch extends CanonicalEntity {
+    readonly sport: SportType;
+    readonly league_id: string;
+    readonly season?: string;
+    readonly start_time: string;
+    readonly status: CanonicalMatchStatus;
+    readonly home: CanonicalMatchSide;
+    readonly away: CanonicalMatchSide;
+    readonly venue?: string;
+    readonly score?: CanonicalScore;
+    readonly updated_at: string;
+}
+export interface CanonicalSelection {
+    readonly name: CanonicalSelectionName;
+    readonly decimal_odds: number;
+    readonly line?: number;
+}
+export interface CanonicalOdds {
+    readonly match_id: string;
+    readonly market: CanonicalOddsMarket;
+    readonly selections: readonly CanonicalSelection[];
+    readonly updated_at: string;
+}
+export interface CanonicalStat {
+    readonly match_id?: string;
+    readonly team_id?: string;
+    readonly player_id?: string;
+    readonly metric: CanonicalMetricName;
+    readonly value: number;
+    readonly unit: CanonicalMetricUnit;
+    readonly period?: number;
+    readonly updated_at: string;
+}
+export interface CanonicalEvent extends CanonicalEntity {
+    readonly match_id: string;
+    readonly sequence: number;
+    readonly clock: CanonicalClock;
+    readonly type: CanonicalEventType;
+    readonly team_id?: string;
+    readonly player_id?: string;
+    readonly related_player_id?: string;
+    readonly description?: string;
+}
+export interface CanonicalStandingRow {
+    readonly position: number;
+    readonly team_id: string;
+    readonly team_name: string;
+    readonly played: number;
+    readonly won: number;
+    readonly drawn: number;
+    readonly lost: number;
+    readonly goals_for: number;
+    readonly goals_against: number;
+    readonly goal_difference: number;
+    readonly points: number;
+}
+export interface CanonicalStandings {
+    readonly league_id: string;
+    readonly season: string;
+    readonly rows: readonly CanonicalStandingRow[];
+    readonly updated_at: string;
+}
+export interface CanonicalCricketInnings {
+    readonly number: 1 | 2 | 3 | 4;
+    readonly batting_team_id: string;
+    readonly runs: number;
+    readonly wickets: number;
+    readonly overs: number;
+    readonly declared: boolean;
+}
+export interface CanonicalCricketMatch extends CanonicalMatch {
+    readonly format: CanonicalCricketFormat;
+    readonly innings: readonly CanonicalCricketInnings[];
+    readonly result_text?: string;
+}
+export interface CanonicalFighterRecord {
+    readonly wins: number;
+    readonly losses: number;
+    readonly draws: number;
+    readonly no_contests: number;
+}
+export interface CanonicalFighter extends CanonicalPlayer {
+    readonly record: CanonicalFighterRecord;
+    readonly stance?: CanonicalFightStance;
+    readonly reach_cm?: number;
+}
+export interface CanonicalBoutResult {
+    readonly method: CanonicalFightMethod;
+    readonly round: number;
+    readonly time_seconds: number;
+    readonly winner_fighter_id?: string;
+}
+export interface CanonicalBout extends CanonicalEntity {
+    readonly card_id: string;
+    readonly order: number;
+    readonly weight_class: string;
+    readonly scheduled_rounds: number;
+    readonly fighter_a_id: string;
+    readonly fighter_b_id: string;
+    readonly result?: CanonicalBoutResult;
+}
+export interface CanonicalFightCard extends CanonicalEntity {
+    readonly sport: 'mma' | 'boxing';
+    readonly name: string;
+    readonly date: string;
+    readonly venue?: string;
+    readonly bouts: readonly CanonicalBout[];
+    readonly status: CanonicalMatchStatus;
+}
+export interface CanonicalSessionResult {
+    readonly position: number;
+    readonly driver_id: string;
+    readonly team_id?: string;
+    readonly best_lap_seconds?: number;
+    readonly gap_to_leader_seconds?: number;
+    readonly laps_completed?: number;
+    readonly dnf: boolean;
+}
+export interface CanonicalSession extends CanonicalEntity {
+    readonly sport: 'formula1';
+    readonly session_type: CanonicalSessionType;
+    readonly league_id: string;
+    readonly season?: string;
+    readonly circuit_id: string;
+    readonly start_time: string;
+    readonly status: CanonicalMatchStatus;
+    readonly results: readonly CanonicalSessionResult[];
+    readonly updated_at: string;
+}
+export type FieldKey = 'scores' | 'odds' | 'lineups' | 'players' | 'stats' | 'historical' | 'injuries' | 'transfers' | 'standings' | 'events' | 'player_market_value' | 'sessions';
+export type CanonicalForField = {
+    scores: readonly CanonicalScore[];
+    odds: readonly CanonicalOdds[];
+    lineups: readonly CanonicalPlayer[];
+    players: readonly CanonicalPlayer[];
+    stats: readonly CanonicalStat[];
+    historical: readonly CanonicalMatch[];
+    injuries: readonly CanonicalPlayer[];
+    transfers: readonly CanonicalPlayer[];
+    standings: CanonicalStandings;
+    events: readonly CanonicalEvent[];
+    player_market_value: readonly CanonicalStat[];
+    sessions: readonly CanonicalSession[];
+};
+export declare const ALL_SPORTS: readonly SportType[];
+export declare const ALL_MATCH_STATUSES: readonly CanonicalMatchStatus[];
+export declare const ALL_ODDS_MARKETS: readonly CanonicalOddsMarket[];
+export declare const ALL_SELECTION_NAMES: readonly CanonicalSelectionName[];
+export declare const ALL_FIGHT_METHODS: readonly CanonicalFightMethod[];
+export declare const ALL_CRICKET_FORMATS: readonly CanonicalCricketFormat[];
+export declare const ALL_FIELD_KEYS: readonly FieldKey[];
+export declare const ALL_SESSION_TYPES: readonly CanonicalSessionType[];
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"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"}

package/dist/canonical.js

@@ -0,0 +1,104 @@
+/**
+ * Big Ball Sports canonical data contract — SDK mirror.
+ *
+ * These types are a verbatim duplicate of `@bbs/shared/src/types/canonical.ts`.
+ * The SDK is published as a zero-dependency package, so it can't import
+ * from the workspace at runtime — but drift between this file and the
+ * server's canonical schema would silently break customer apps.
+ *
+ * The drift-prevention test
+ * (`packages/sdk/src/canonical.test.ts`) fails the build when this file
+ * diverges from `@bbs/shared`.
+ *
+ * Three contract invariants (same as the docs/DATA_CONTRACT.md):
+ *
+ *   1. Every `id` field is a BigBalls canonical id matching
+ *      `^bb_<entity>_[a-z0-9]+$`. Vendor IDs are translated upstream.
+ *   2. Every status / market / method / event-type field is one of the
+ *      enumerated string literals declared below. Vendor strings are
+ *      never returned.
+ *   3. There is no `unknown` / `Record<string, unknown>` in any return
+ *      type. If you see one, it's a bug.
+ */
+// ---------------------------------------------------------------------------
+// Frozen enum lists — needed by the drift test so it can iterate.
+// ---------------------------------------------------------------------------
+export const ALL_SPORTS = [
+    'football',
+    'basketball',
+    'baseball',
+    'ice_hockey',
+    'cricket',
+    'mma',
+    'boxing',
+    'formula1',
+    'american_football',
+];
+export const ALL_MATCH_STATUSES = [
+    'scheduled',
+    'in_progress',
+    'finished',
+    'postponed',
+    'cancelled',
+    'suspended',
+];
+export const ALL_ODDS_MARKETS = [
+    'moneyline',
+    'spread',
+    'total',
+    'btts',
+    'draw_no_bet',
+    'double_chance',
+];
+export const ALL_SELECTION_NAMES = [
+    'home',
+    'away',
+    'draw',
+    'over',
+    'under',
+    'yes',
+    'no',
+    'home_or_draw',
+    'away_or_draw',
+    'home_or_away',
+];
+export const ALL_FIGHT_METHODS = [
+    'ko',
+    'tko',
+    'submission',
+    'unanimous_decision',
+    'split_decision',
+    'majority_decision',
+    'technical_decision',
+    'disqualification',
+    'no_contest',
+    'draw',
+];
+export const ALL_CRICKET_FORMATS = [
+    't10',
+    't20',
+    'odi',
+    'test',
+    'first_class',
+];
+export const ALL_FIELD_KEYS = [
+    'scores',
+    'odds',
+    'lineups',
+    'players',
+    'stats',
+    'historical',
+    'injuries',
+    'transfers',
+    'standings',
+    'events',
+    'player_market_value',
+    'sessions',
+];
+export const ALL_SESSION_TYPES = [
+    'practice',
+    'qualifying',
+    'sprint',
+    'race',
+];
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA2YH,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,UAAU;IACV,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,SAAS;IACT,KAAK;IACL,QAAQ;IACR,UAAU;IACV,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAoC;IACjE,WAAW;IACX,aAAa;IACb,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,WAAW;IACX,QAAQ;IACR,OAAO;IACP,MAAM;IACN,aAAa;IACb,eAAe;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAsC;IACpE,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,IAAI;IACJ,cAAc;IACd,cAAc;IACd,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,IAAI;IACJ,KAAK;IACL,YAAY;IACZ,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAsC;IACpE,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,QAAQ;IACR,MAAM;IACN,SAAS;IACT,SAAS;IACT,OAAO;IACP,YAAY;IACZ,UAAU;IACV,WAAW;IACX,WAAW;IACX,QAAQ;IACR,qBAAqB;IACrB,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,MAAM;CACE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Big Ball Sports TypeScript SDK — thin HTTP + WebSocket client.
+ *
+ * The SDK is a zero-dependency wrapper around the canonical REST API and
+ * the socket.io WebSocket surface. Types are inlined so the package is
+ * publishable standalone; they track the server-side shapes defined in
+ * `@bbs/shared` but don't import them.
+ *
+ * Usage:
+ *
+ *   import { BigBallSportsClient } from '@bigballsports/sdk'
+ *
+ *   const client = new BigBallSportsClient('bbs_xxx')
+ *   const matches = await client.matches.list({ sport: 'football' })
+ *   const one = await client.matches.get('abc', ['scores', 'odds'])
+ */
+export * from './canonical.js';
+import type { CanonicalEvent, CanonicalForField, CanonicalOdds, CanonicalPlayer, CanonicalStandings, CanonicalStat, FieldKey, SportType } from './canonical.js';
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface ResponseMeta {
+    /**
+     * Opaque source-tier label (`official-league`, `aggregator-paid`,
+     * `aggregator-free`, `community-scraper`, `mixed`, `cache`, `none`).
+     * The vendor identity behind a source is never exposed.
+     */
+    source: string;
+    confidence: number;
+    cached: boolean;
+    cache_age_ms: number;
+    request_id: string;
+    fields_missing?: string[];
+}
+export interface ApiResponse<T> {
+    data: T;
+    meta: ResponseMeta;
+    error: ApiError | null;
+}
+/**
+ * Per-field cache envelope. `value` is typed by FieldKey via
+ * `CanonicalForField[F]`, so `FieldResult<'scores'>` carries a
+ * `CanonicalScore[]` and never raw vendor JSON.
+ */
+export interface FieldResult<F extends FieldKey = FieldKey> {
+    value: CanonicalForField[F];
+    source: string;
+    via: 'api' | 'cache' | 'mcp';
+    confidence: number;
+    fetchedAt: string;
+    ttlSeconds: number;
+}
+/**
+ * Multi-field match payload returned by `/v1/matches/:id`. Each entry
+ * is keyed by FieldKey; the value is the canonical-typed FieldResult or
+ * null when the field couldn't be satisfied.
+ */
+export type Match = {
+    [F in FieldKey]?: FieldResult<F> | null;
+};
+export type Player = CanonicalPlayer;
+export type OddsLine = CanonicalOdds;
+export type MatchEvent = CanonicalEvent;
+export type PlayerStats = CanonicalStat;
+export type Standing = CanonicalStandings;
+/** Injury reports surface as a canonical player; the absence of a return-date
+ *  field means active. */
+export type Injury = CanonicalPlayer;
+export interface LiveEvent {
+    type: string;
+    data: unknown;
+}
+export interface MatchListParams {
+    sport: SportType;
+    league?: string;
+    date?: string;
+    status?: 'scheduled' | 'live' | 'finished' | 'postponed' | 'cancelled';
+    page?: number;
+    limit?: number;
+}
+export interface StatsParams {
+    sport: SportType;
+    season?: string;
+    league?: string;
+    page?: number;
+    limit?: number;
+}
+export interface InjuryParams {
+    sport: SportType;
+    team?: string;
+    page?: number;
+    limit?: number;
+}
+export interface ClientOptions {
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+    /** Optional explicit timeout in ms. Defaults to 15s. */
+    readonly timeoutMs?: number;
+}
+declare class HttpError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare class BigBallSportsClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    readonly matches: MatchesApi;
+    readonly players: PlayersApi;
+    readonly standings: StandingsApi;
+    readonly injuries: InjuriesApi;
+    readonly cricket: CricketApi;
+    readonly combat: CombatApi;
+    constructor(apiKey: string, options?: ClientOptions);
+    /** @internal — used by the sub-APIs. */
+    get<T>(path: string, query?: Readonly<Record<string, string | number | boolean | readonly string[] | undefined>>): Promise<ApiResponse<T>>;
+    /** @internal — used by `webhooks` + future POST endpoints. */
+    post<T>(path: string, payload: unknown): Promise<ApiResponse<T>>;
+    /**
+     * GraphQL subscription helper using the graphql-ws subprotocol at
+     * `/graphql/ws`. The SDK doesn't ship `graphql-ws` as a hard dep —
+     * callers include it themselves and pass `createClient` via
+     * `options.graphqlWsClient`. (Same pattern as `subscribe(room, …)`
+     * for socket.io-client.)
+     *
+     * Spec § Tech Stack: "GraphQL Yoga · subscriptions via WS".
+     *
+     * @example
+     *   import { createClient } from 'graphql-ws';
+     *   const stop = client.subscribeGraphql(
+     *     `subscription M($id: ID!) { matchUpdated(matchId: $id) { id status scores { raw } } }`,
+     *     { id: 'abc' },
+     *     (data) => console.log(data),
+     *     { graphqlWsClient: createClient },
+     *   );
+     *   // ...later: stop();
+     */
+    subscribeGraphql<TData = unknown, TVars = Record<string, unknown>>(query: string, variables: TVars, onData: (data: TData) => void, options?: {
+        graphqlWsClient?: unknown;
+        url?: string;
+        onError?: (err: unknown) => void;
+        onComplete?: () => void;
+    }): () => void;
+    /**
+     * WebSocket subscription helper. Connects via socket.io-client if
+     * available in the runtime environment. Returns an unsubscribe fn.
+     *
+     * The SDK doesn't ship socket.io-client as a hard dep — callers include
+     * it themselves and pass it via `options.socketIo`.
+     */
+    subscribe(room: string, onEvent: (event: LiveEvent) => void, options?: {
+        socketIo?: unknown;
+        url?: string;
+    }): () => void;
+}
+declare class MatchesApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    list(params: MatchListParams): Promise<ApiResponse<Match[]>>;
+    get(id: string, fields?: FieldKey[], sport?: SportType): Promise<ApiResponse<Match>>;
+    odds(id: string, sport?: SportType): Promise<ApiResponse<OddsLine[]>>;
+    events(id: string, sport?: SportType): Promise<ApiResponse<MatchEvent[]>>;
+}
+declare class PlayersApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    get(id: string, sport: SportType): Promise<ApiResponse<Player>>;
+    stats(id: string, params: StatsParams): Promise<ApiResponse<PlayerStats[]>>;
+}
+declare class StandingsApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    get(league: string, season?: number, sport?: SportType): Promise<ApiResponse<Standing[]>>;
+}
+declare class InjuriesApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    list(params: InjuryParams): Promise<ApiResponse<Injury[]>>;
+}
+declare class CricketApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    matches(series?: string): Promise<ApiResponse<Match[]>>;
+    scorecard(matchId: string): Promise<ApiResponse<unknown>>;
+}
+declare class CombatApi {
+    private readonly client;
+    constructor(client: BigBallSportsClient);
+    cards(sport?: 'mma' | 'boxing', date?: string): Promise<ApiResponse<unknown>>;
+    bout(id: string, sport?: 'mma' | 'boxing'): Promise<ApiResponse<unknown>>;
+    athlete(id: string, sport?: 'mma' | 'boxing'): Promise<ApiResponse<unknown>>;
+}
+export { HttpError };
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,298 @@
+/**
+ * Big Ball Sports TypeScript SDK — thin HTTP + WebSocket client.
+ *
+ * The SDK is a zero-dependency wrapper around the canonical REST API and
+ * the socket.io WebSocket surface. Types are inlined so the package is
+ * publishable standalone; they track the server-side shapes defined in
+ * `@bbs/shared` but don't import them.
+ *
+ * Usage:
+ *
+ *   import { BigBallSportsClient } from '@bigballsports/sdk'
+ *
+ *   const client = new BigBallSportsClient('bbs_xxx')
+ *   const matches = await client.matches.list({ sport: 'football' })
+ *   const one = await client.matches.get('abc', ['scores', 'odds'])
+ */
+// ---------------------------------------------------------------------------
+// Re-export the canonical type surface. Customers using the SDK should
+// import these directly from `@bigballsports/sdk` — there is no need to
+// depend on `@bbs/shared` separately.
+// ---------------------------------------------------------------------------
+export * from './canonical.js';
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+const DEFAULT_BASE_URL = 'https://api.bigballsports.com';
+class HttpError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'HttpError';
+    }
+}
+export class BigBallSportsClient {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    timeoutMs;
+    matches;
+    players;
+    standings;
+    injuries;
+    cricket;
+    combat;
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.matches = new MatchesApi(this);
+        this.players = new PlayersApi(this);
+        this.standings = new StandingsApi(this);
+        this.injuries = new InjuriesApi(this);
+        this.cricket = new CricketApi(this);
+        this.combat = new CombatApi(this);
+    }
+    /** @internal — used by the sub-APIs. */
+    async get(path, query = {}) {
+        const url = new URL(path, this.baseUrl);
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined)
+                continue;
+            if (Array.isArray(v))
+                url.searchParams.set(k, v.join(','));
+            else
+                url.searchParams.set(k, String(v));
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(url.toString(), {
+                method: 'GET',
+                headers: {
+                    'x-api-key': this.apiKey,
+                    accept: 'application/json',
+                },
+                signal: controller.signal,
+            });
+            const body = (await response.json());
+            if (!response.ok && body?.error) {
+                throw new HttpError(body.error.message, response.status, body);
+            }
+            return body;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** @internal — used by `webhooks` + future POST endpoints. */
+    async post(path, payload) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(new URL(path, this.baseUrl).toString(), {
+                method: 'POST',
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'content-type': 'application/json',
+                    accept: 'application/json',
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const body = (await response.json());
+            if (!response.ok && body?.error) {
+                throw new HttpError(body.error.message, response.status, body);
+            }
+            return body;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * GraphQL subscription helper using the graphql-ws subprotocol at
+     * `/graphql/ws`. The SDK doesn't ship `graphql-ws` as a hard dep —
+     * callers include it themselves and pass `createClient` via
+     * `options.graphqlWsClient`. (Same pattern as `subscribe(room, …)`
+     * for socket.io-client.)
+     *
+     * Spec § Tech Stack: "GraphQL Yoga · subscriptions via WS".
+     *
+     * @example
+     *   import { createClient } from 'graphql-ws';
+     *   const stop = client.subscribeGraphql(
+     *     `subscription M($id: ID!) { matchUpdated(matchId: $id) { id status scores { raw } } }`,
+     *     { id: 'abc' },
+     *     (data) => console.log(data),
+     *     { graphqlWsClient: createClient },
+     *   );
+     *   // ...later: stop();
+     */
+    subscribeGraphql(query, variables, onData, options = {}) {
+        const factory = options.graphqlWsClient;
+        if (!factory) {
+            throw new Error('subscribeGraphql() requires `graphqlWsClient`: install `graphql-ws` and pass createClient as options.graphqlWsClient');
+        }
+        const httpUrl = new URL('/graphql/ws', options.url ?? this.baseUrl);
+        httpUrl.protocol = httpUrl.protocol === 'https:' ? 'wss:' : 'ws:';
+        const client = factory({
+            url: httpUrl.toString(),
+            connectionParams: { apiKey: this.apiKey },
+        });
+        const unsubscribeInner = client.subscribe({ query, variables }, {
+            next: (msg) => {
+                if (msg.data !== undefined)
+                    onData(msg.data);
+            },
+            error: (e) => options.onError?.(e),
+            complete: () => options.onComplete?.(),
+        });
+        return () => {
+            try {
+                unsubscribeInner();
+            }
+            finally {
+                void client.dispose();
+            }
+        };
+    }
+    /**
+     * WebSocket subscription helper. Connects via socket.io-client if
+     * available in the runtime environment. Returns an unsubscribe fn.
+     *
+     * The SDK doesn't ship socket.io-client as a hard dep — callers include
+     * it themselves and pass it via `options.socketIo`.
+     */
+    subscribe(room, onEvent, options = {}) {
+        const io = options.socketIo;
+        if (!io) {
+            throw new Error('subscribe() requires `socketIo`: install `socket.io-client` and pass io as options.socketIo');
+        }
+        const socketUrl = options.url ?? this.baseUrl;
+        // Server mounts socket.io at `/live` per architecture spec § WebSocket —
+        // Live Events ("wss://api.bigballsdata.com/live"). Override the
+        // socket.io-client default of `/socket.io` to match.
+        const socket = io(socketUrl, {
+            path: '/live',
+            extraHeaders: { 'x-api-key': this.apiKey },
+            auth: { apiKey: this.apiKey },
+        });
+        const listener = (type, data) => onEvent({ type, data });
+        socket.on('score_update', (d) => listener('score_update', d));
+        socket.on('odds_move', (d) => listener('odds_move', d));
+        socket.on('lineup_confirmed', (d) => listener('lineup_confirmed', d));
+        socket.on('match_start', (d) => listener('match_start', d));
+        socket.on('match_end', (d) => listener('match_end', d));
+        socket.on('goal', (d) => listener('goal', d));
+        socket.on('card', (d) => listener('card', d));
+        socket.on('substitution', (d) => listener('substitution', d));
+        socket.emit('join', room);
+        return () => {
+            socket.emit('leave', room);
+            socket.close();
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Sub-APIs
+// ---------------------------------------------------------------------------
+class MatchesApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(params) {
+        return this.client.get('/v1/matches', { ...params });
+    }
+    get(id, fields, sport) {
+        return this.client.get(`/v1/matches/${encodeURIComponent(id)}`, {
+            sport: sport ?? 'football',
+            ...(fields && fields.length > 0 ? { fields } : {}),
+        });
+    }
+    odds(id, sport) {
+        return this.client.get(`/v1/matches/${encodeURIComponent(id)}/odds`, {
+            sport: sport ?? 'football',
+        });
+    }
+    events(id, sport) {
+        return this.client.get(`/v1/matches/${encodeURIComponent(id)}/events`, {
+            sport: sport ?? 'football',
+        });
+    }
+}
+class PlayersApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    get(id, sport) {
+        return this.client.get(`/v1/players/${encodeURIComponent(id)}`, { sport });
+    }
+    stats(id, params) {
+        return this.client.get(`/v1/players/${encodeURIComponent(id)}/stats`, {
+            ...params,
+        });
+    }
+}
+class StandingsApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    get(league, season, sport = 'football') {
+        return this.client.get('/v1/standings', {
+            sport,
+            leagueId: league,
+            ...(season !== undefined ? { season: String(season) } : {}),
+        });
+    }
+}
+class InjuriesApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    list(params) {
+        return this.client.get('/v1/injuries', { ...params });
+    }
+}
+class CricketApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    matches(series) {
+        return this.client.get('/v1/cricket/matches', {
+            ...(series !== undefined ? { series } : {}),
+        });
+    }
+    scorecard(matchId) {
+        return this.client.get(`/v1/cricket/matches/${encodeURIComponent(matchId)}/scorecard`);
+    }
+}
+class CombatApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    cards(sport = 'mma', date) {
+        return this.client.get('/v1/fight-cards', {
+            sport,
+            ...(date !== undefined ? { date } : {}),
+        });
+    }
+    bout(id, sport = 'mma') {
+        return this.client.get(`/v1/bouts/${encodeURIComponent(id)}`, { sport });
+    }
+    athlete(id, sport = 'mma') {
+        return this.client.get(`/v1/athletes/${encodeURIComponent(id)}`, { sport });
+    }
+}
+export { HttpError };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@bigballsports/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the Big Ball Sports API.",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "build": "tsc --noEmit false",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm build"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "bigballsports",
+    "sports-api",
+    "sdk",
+    "football",
+    "nba",
+    "nfl",
+    "nhl",
+    "mlb",
+    "cricket",
+    "ufc"
+  ],
+  "license": "UNLICENSED",
+  "dependencies": {},
+  "devDependencies": {
+    "@bbs/shared": "workspace:*"
+  }
+}