@scorio/client-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,564 @@
+interface ListResponse<T> {
+    readonly data: readonly T[];
+    readonly meta: {
+        readonly count: number;
+    };
+}
+interface SingleResponse<T> {
+    readonly data: T;
+}
+interface Sport {
+    readonly id: string;
+    readonly name: string;
+    readonly alias: string;
+    readonly category: 'sport' | 'esport' | 'virtual' | 'racing' | 'fighting';
+}
+interface SportCount extends Sport {
+    readonly live_count: number;
+    readonly prematch_count: number;
+}
+interface Region {
+    readonly id: string;
+    readonly name: string;
+    readonly alias: string;
+    readonly sport_id: string;
+}
+interface Competition {
+    readonly id: string;
+    readonly name: string;
+    readonly region_id: string;
+    readonly sport_id: string;
+}
+interface GameInfo {
+    readonly game_state: string;
+    readonly score: readonly [number, number];
+    readonly game_time?: number;
+    readonly set_count?: number;
+    readonly add_info?: string;
+    readonly stoppage_time?: {
+        readonly first_half?: string;
+        readonly second_half?: string;
+    };
+}
+interface GameStats {
+    readonly [key: string]: readonly number[] | readonly (readonly number[])[];
+}
+interface Outcome {
+    readonly id: string;
+    readonly name: string;
+    readonly price: number;
+    readonly is_suspended: boolean;
+}
+interface Market {
+    readonly id: string;
+    readonly name: string;
+    readonly type: string;
+    readonly line: number | null;
+    readonly outcomes: readonly Outcome[];
+}
+interface Game {
+    readonly id: string;
+    readonly home_team: string;
+    readonly away_team: string;
+    readonly status: 'prematch' | 'live' | 'ended';
+    readonly start_time: number;
+    readonly is_live: boolean;
+    readonly markets_count: number;
+    readonly competition_id: string;
+    readonly sport_id: string;
+    readonly score_text: string;
+    readonly info: GameInfo | null;
+    readonly stats: GameStats | null;
+    readonly updated_at: string;
+    readonly markets: readonly Market[];
+}
+interface LiveSnapshot {
+    readonly sports: readonly SportCount[];
+    readonly games: readonly Game[];
+}
+interface OddsSummary {
+    readonly event_id: string;
+    readonly event_name: string;
+    readonly current_price: number;
+    readonly min_price: number;
+    readonly max_price: number;
+    readonly avg_price: number;
+    readonly change_count: number;
+}
+interface OddsMover {
+    readonly event_id: string;
+    readonly game_id: string;
+    readonly current_price: number;
+    readonly opening_price: number;
+    readonly price_change: number;
+    readonly change_percent: number;
+    readonly game_name: string;
+    readonly market_name: string;
+    readonly event_name: string;
+}
+interface PricePoint {
+    readonly price: number;
+    readonly previous_price: number;
+    readonly recorded_at: string;
+}
+type Plan = 'free' | 'starter' | 'pro' | 'business';
+interface DebugConfig {
+    readonly host: string;
+    readonly secret: string;
+    readonly plan?: Plan;
+}
+interface ScorioSDKConfig {
+    readonly apiKey: string;
+    readonly host?: string;
+    readonly logger?: boolean;
+    readonly timeout?: number;
+    readonly debug?: DebugConfig;
+}
+interface PaginationOptions {
+    readonly limit?: number;
+    readonly offset?: number;
+}
+interface StartingSoonOptions {
+    readonly minutes?: number;
+}
+interface SearchOptions {
+    readonly limit?: number;
+}
+interface OddsMoversOptions {
+    readonly minutes?: number;
+    readonly limit?: number;
+}
+interface PriceHistoryOptions {
+    readonly from?: number;
+    readonly to?: number;
+    readonly limit?: number;
+}
+interface ScheduleOptions {
+    readonly date?: string;
+    readonly dateFrom?: string;
+    readonly dateTo?: string;
+    readonly sportId?: string;
+    readonly competitionId?: string;
+}
+interface HealthResponse {
+    readonly status: 'ok';
+}
+interface PingResponse {
+    readonly pong: true;
+}
+
+interface HttpRequest {
+    readonly method: 'GET';
+    readonly url: string;
+    readonly headers: Record<string, string>;
+    readonly timeout: number;
+}
+interface HttpResponse {
+    readonly status: number;
+    readonly headers: {
+        get(name: string): string | null;
+    };
+    readonly json: () => Promise<unknown>;
+}
+interface HttpClientPort {
+    request(req: HttpRequest): Promise<HttpResponse>;
+}
+
+declare class ScorioSDK {
+    private readonly apiKey;
+    private readonly host;
+    private readonly timeout;
+    private readonly logger;
+    private readonly config;
+    private readonly http;
+    constructor(config: ScorioSDKConfig, httpClient?: HttpClientPort);
+    private get;
+    /**
+     * List all available sports.
+     *
+     * Returns every available sport sorted by display order.
+     * Use this to build your top-level navigation or sport selector.
+     *
+     * @returns List of Sport objects with id, name, alias, and category.
+     *
+     * **Plans:** free, starter, pro, business | **Group:** catalog
+     *
+     * **Polling:** Cache locally for 60 seconds. The sport catalog changes infrequently.
+     *
+     * @example
+     * ```ts
+     * const { data, meta } = await client.getSports();
+     * // data: [{ id, name, alias, category }, ...]
+     * // meta: { count: number }
+     * ```
+     */
+    getSports(): Promise<ListResponse<Sport>>;
+    /**
+     * Sports with live and prematch game counts.
+     *
+     * Returns all sports along with the number of currently live and upcoming prematch games for each.
+     * Perfect for sidebar badges, sport selector counts, or deciding which sport feeds to subscribe to.
+     *
+     * @returns List of SportCount objects (Sport + live_count + prematch_count).
+     *
+     * **Plans:** free, starter, pro, business | **Group:** catalog
+     *
+     * **Polling:** Every 10-30 seconds. Counts change as games go live or finish.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getSportsCounts();
+     * // data: [{ id, name, alias, category, live_count, prematch_count }, ...]
+     * ```
+     */
+    getSportsCounts(): Promise<ListResponse<SportCount>>;
+    /**
+     * List regions for a sport.
+     *
+     * Returns all regions (countries or geographic areas) that currently have active games for the specified sport.
+     * Build the second level of your navigation tree (e.g., England, Germany, Spain for Football).
+     *
+     * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+     * @returns List of Region objects with id, name, alias, and sport_id.
+     *
+     * **Plans:** free, starter, pro, business | **Group:** catalog
+     *
+     * **Polling:** Cache locally for 60 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getRegions('01KNSZTCFAHSBS092VMZS7PMCW');
+     * // data: [{ id, name, alias, sport_id }, ...]
+     * ```
+     */
+    getRegions(sportId: string): Promise<ListResponse<Region>>;
+    /**
+     * List competitions for a region.
+     *
+     * Returns all competitions (leagues, tournaments, cups) within the specified region.
+     * Build the third level of your navigation tree (e.g., Premier League, Championship, FA Cup for England).
+     *
+     * @param regionId - Unique region identifier (ULID). Get IDs from {@link getRegions}.
+     * @returns List of Competition objects with id, name, region_id, and sport_id.
+     *
+     * **Plans:** free, starter, pro, business | **Group:** catalog
+     *
+     * **Polling:** Cache locally for 60 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getCompetitions('01JRQ00000ENGLAND0000001');
+     * // data: [{ id, name, region_id, sport_id }, ...]
+     * ```
+     */
+    getCompetitions(regionId: string): Promise<ListResponse<Competition>>;
+    /**
+     * List all competitions for a sport (flat list).
+     *
+     * Returns all competitions for the specified sport across ALL regions in one call.
+     * Useful for building flat competition selectors, search/filter dropdowns, or schedule filters.
+     *
+     * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+     * @returns Flat list of Competition objects.
+     *
+     * **Plans:** free, starter, pro, business | **Group:** catalog
+     *
+     * **Polling:** Cache locally for 60 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getCompetitionsBySport('01KNSZTCFAHSBS092VMZS7PMCW');
+     * // data: [{ id: "...", name: "Premier League", region_id, sport_id }, ...]
+     * ```
+     */
+    getCompetitionsBySport(sportId: string): Promise<ListResponse<Competition>>;
+    /**
+     * All live games across all sports.
+     *
+     * Returns every currently live (in-play) game in a single call.
+     * Ideal for multi-sport live tickers, aggregate live feeds, or monitoring total live game volume.
+     *
+     * @returns List of Game objects with is_live: true, including scores, stats, and market counts.
+     *
+     * **Plans:** starter, pro, business | **Group:** live
+     *
+     * **Polling:** Every 1-2 seconds for real-time updates.
+     * At peak hours this can return 200+ games. If you only need one sport, use {@link getLiveGamesBySport}.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getAllLiveGames();
+     * // data: [{ id, home_team, away_team, status: "live", score_text, info, stats, ... }, ...]
+     * ```
+     */
+    getAllLiveGames(): Promise<ListResponse<Game>>;
+    /**
+     * Live games for a specific sport.
+     *
+     * Returns all currently live (in-play) games for the specified sport.
+     * More efficient than {@link getAllLiveGames} when you only need one sport.
+     *
+     * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+     * @returns List of live Game objects filtered to the requested sport.
+     *
+     * **Plans:** starter, pro, business | **Group:** live
+     *
+     * **Polling:** Every 1-2 seconds for real-time updates.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getLiveGamesBySport('01KNSZTCFAHSBS092VMZS7PMCW');
+     * // data: [{ id, home_team, away_team, score_text: "2:1 (67')", ... }, ...]
+     * ```
+     */
+    getLiveGamesBySport(sportId: string): Promise<ListResponse<Game>>;
+    /**
+     * Full live dashboard snapshot.
+     *
+     * Returns a complete live dashboard in a single API call: sport counts and all live games combined.
+     * Combines `/api/sports/counts` and `/api/live/games` to reduce round trips.
+     *
+     * @returns LiveSnapshot containing sports (with counts) and all live games.
+     *
+     * **Plans:** starter, pro, business | **Group:** live
+     *
+     * **Polling:** Every 2-5 seconds. This is a heavier endpoint.
+     * For granular updates after initial load, prefer individual endpoints.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getLiveSnapshot();
+     * // data: { sports: [{ id, name, live_count, prematch_count, ... }], games: [...] }
+     * ```
+     */
+    getLiveSnapshot(): Promise<SingleResponse<LiveSnapshot>>;
+    /**
+     * Prematch games for a sport (paginated).
+     *
+     * Returns upcoming (prematch) games for the specified sport with pagination support.
+     * Sports like Football can have 1500+ prematch games.
+     *
+     * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+     * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).
+     * @returns Paginated list of prematch Game objects.
+     *
+     * **Plans:** starter, pro, business | **Group:** prematch
+     *
+     * **Polling:** Every 10-30 seconds. Prematch odds update less frequently than live.
+     *
+     * @example
+     * ```ts
+     * const { data, meta } = await client.getPrematchGames('01KNSZTCFAHSBS092VMZS7PMCW', { limit: 20 });
+     * // data: [{ id, home_team, away_team, status: "prematch", start_time, ... }, ...]
+     * ```
+     */
+    getPrematchGames(sportId: string, options?: PaginationOptions): Promise<ListResponse<Game>>;
+    /**
+     * Games for a competition (paginated).
+     *
+     * Returns games for a specific competition with pagination.
+     * Includes games that have recently started (up to 2 hours ago) and all upcoming games.
+     *
+     * @param competitionId - Unique competition identifier (ULID). Get IDs from {@link getCompetitions} or {@link getCompetitionsBySport}.
+     * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).
+     * @returns Paginated list of Game objects sorted by start time.
+     *
+     * **Plans:** starter, pro, business | **Group:** games
+     *
+     * **Polling:** Every 10-30 seconds for prematch, 1-2 seconds if showing live games.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getGamesByCompetition('01KNSZTCFGMM6JE2B9YQFGQCDZ', { limit: 10 });
+     * ```
+     */
+    getGamesByCompetition(competitionId: string, options?: PaginationOptions): Promise<ListResponse<Game>>;
+    /**
+     * Games starting within N minutes.
+     *
+     * Returns games that are about to start within the specified time window.
+     * Great for "Starting Soon" widgets or last-minute bet notifications.
+     *
+     * @param options - minutes: time window (1-180, default 30).
+     * @returns List of prematch Game objects sorted by start time (soonest first).
+     *
+     * **Plans:** starter, pro, business | **Group:** games
+     *
+     * **Polling:** Every 30-60 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getGamesStartingSoon({ minutes: 60 });
+     * ```
+     */
+    getGamesStartingSoon(options?: StartingSoonOptions): Promise<ListResponse<Game>>;
+    /**
+     * Search games by team name.
+     *
+     * Case-insensitive partial match against both home_team and away_team across all sports.
+     * Sorted by relevance, then by start time.
+     *
+     * @param query - Search query string (minimum 2 characters).
+     * @param options - limit: max results (1-50, default 20).
+     * @returns List of matching Game objects.
+     *
+     * **Plans:** starter, pro, business | **Group:** games
+     *
+     * **Polling:** On demand (triggered by user input).
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.searchGames('Arsenal', { limit: 10 });
+     * ```
+     */
+    searchGames(query: string, options?: SearchOptions): Promise<ListResponse<Game>>;
+    /**
+     * Full game detail with all markets and odds.
+     *
+     * Returns complete data for a single game: metadata, all markets, and all outcomes.
+     * Everything needed to render a full betting interface.
+     *
+     * @param gameId - Unique game identifier (ULID). Get IDs from any endpoint that returns Game objects.
+     * @returns Single Game object with nested markets and outcomes.
+     *
+     * **Plans:** starter, pro, business | **Group:** games
+     *
+     * Markets are populated only on **pro** and **business** plans.
+     * Lower plans receive `markets: []` and `markets_count: 0`.
+     *
+     * **Polling:** Every 1-2 seconds for live games, 10-30 seconds for prematch.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getGameDetail('01TESTGAME00000LIVESOC01');
+     * // data.markets: [{ id, name, type, line, outcomes: [{ id, name, price, is_suspended }] }]
+     * ```
+     */
+    getGameDetail(gameId: string): Promise<SingleResponse<Game>>;
+    /**
+     * Games by date or date range.
+     *
+     * Returns all games scheduled for a specific date or range, optionally filtered by sport or competition.
+     * Uses UTC dates. Defaults to today if no date params provided.
+     *
+     * @param options - date (YYYY-MM-DD), dateFrom/dateTo (max 90 days), sportId, competitionId.
+     * @returns List of Game objects sorted by start time.
+     *
+     * **Plans:** starter, pro, business | **Group:** schedule
+     *
+     * **Polling:** Every 60 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getSchedule({ date: '2026-04-10', sportId: '01KNSZTCFAHSBS092VMZS7PMCW' });
+     * ```
+     */
+    getSchedule(options?: ScheduleOptions): Promise<ListResponse<Game>>;
+    /**
+     * Min/max/avg price summary per outcome for a game.
+     *
+     * Returns statistical summary of odds for every outcome: min, max, average price, and number of changes.
+     * Useful for identifying value bets, overreactions, and market inefficiencies.
+     *
+     * @param gameId - Unique game identifier (ULID).
+     * @returns List of OddsSummary objects, one per outcome.
+     *
+     * **Plans:** pro, business | **Group:** odds
+     *
+     * **Polling:** Every 10-30 seconds.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getGameOddsSummary('01TESTGAME00000LIVESOC01');
+     * // data: [{ event_id, event_name, current_price, min_price, max_price, avg_price, change_count }]
+     * ```
+     */
+    getGameOddsSummary(gameId: string): Promise<ListResponse<OddsSummary>>;
+    /**
+     * Top odds movements (biggest price changes).
+     *
+     * Returns outcomes with the largest odds movements within a given time window.
+     * Key differentiator for professional bettors and odds aggregation platforms.
+     *
+     * @param options - minutes: look-back window (1-1440, default 60), limit: max results (1-100, default 20).
+     * @returns List of OddsMover objects sorted by absolute change percentage (largest first).
+     *
+     * **Plans:** pro, business | **Group:** odds
+     *
+     * **Polling:** Every 5-10 seconds for near-real-time steam move alerts.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getOddsMovers({ minutes: 30, limit: 10 });
+     * // data: [{ event_id, game_id, current_price, opening_price, price_change, change_percent, ... }]
+     * ```
+     */
+    getOddsMovers(options?: OddsMoversOptions): Promise<ListResponse<OddsMover>>;
+    /**
+     * Historical price changes for an outcome.
+     *
+     * Returns the full history of price changes for a specific outcome (selection).
+     * Build odds movement charts, sparklines, or trend analysis visualizations.
+     * 60-day retention, tick-level granularity.
+     *
+     * @param eventId - Unique outcome identifier (ULID). Get IDs from Game objects with markets.
+     * @param options - from/to (unix timestamps), limit (1-5000, default 500).
+     * @returns Chronological list of PricePoint objects (oldest first).
+     *
+     * **Plans:** pro, business | **Group:** odds
+     *
+     * **Polling:** On demand.
+     *
+     * @example
+     * ```ts
+     * const { data } = await client.getEventPriceHistory('01TESTEVT00000ARS0NAL01', { limit: 100 });
+     * // data: [{ price, previous_price, recorded_at }, ...]
+     * ```
+     */
+    getEventPriceHistory(eventId: string, options?: PriceHistoryOptions): Promise<ListResponse<PricePoint>>;
+    /**
+     * Health check.
+     *
+     * Returns the current health status of the API. No authentication required.
+     * Use in load balancer health checks, uptime monitoring, or status pages.
+     *
+     * @returns `{ status: "ok" }` when the API is healthy.
+     *
+     * **Plans:** all (no authentication required) | **Group:** system
+     *
+     * **Polling:** Every 30-60 seconds from your monitoring system.
+     */
+    health(): Promise<HealthResponse>;
+    /**
+     * Ping.
+     *
+     * Simple connectivity check. No authentication required.
+     * Quick liveness probe for monitoring or client-side connectivity checks.
+     *
+     * @returns `{ pong: true }`
+     *
+     * **Plans:** all (no authentication required) | **Group:** system
+     */
+    ping(): Promise<PingResponse>;
+}
+
+declare class ScorioError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code: string);
+}
+declare class PlanLimitError extends ScorioError {
+    readonly currentPlan: string;
+    constructor(message: string, currentPlan: string);
+}
+declare class RateLimitError extends ScorioError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number);
+}
+declare class NetworkError extends ScorioError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+export { type Competition, type DebugConfig, type Game, type GameInfo, type GameStats, type HealthResponse, type ListResponse, type LiveSnapshot, type Market, NetworkError, type OddsMover, type OddsMoversOptions, type OddsSummary, type Outcome, type PaginationOptions, type PingResponse, type Plan, PlanLimitError, type PriceHistoryOptions, type PricePoint, RateLimitError, type Region, type ScheduleOptions, ScorioError, type ScorioSDKConfig, type SearchOptions, type SingleResponse, type Sport, type SportCount, type StartingSoonOptions, ScorioSDK as default };

package/dist/index.js

@@ -0,0 +1,623 @@
+// src/domain/errors.ts
+var ScorioError = class extends Error {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "ScorioError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var PlanLimitError = class extends ScorioError {
+  currentPlan;
+  constructor(message, currentPlan) {
+    super(message, 403, "plan_limit");
+    this.name = "PlanLimitError";
+    this.currentPlan = currentPlan;
+  }
+};
+var RateLimitError = class extends ScorioError {
+  retryAfter;
+  constructor(message, retryAfter) {
+    super(message, 429, "rate_limit");
+    this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var NetworkError = class extends ScorioError {
+  constructor(message, options) {
+    super(message, 0, "network_error");
+    this.name = "NetworkError";
+    if (options?.cause) {
+      this.cause = options.cause;
+    }
+  }
+};
+
+// src/infrastructure/http/error-mapper.ts
+function isErrorBody(body) {
+  return typeof body === "object" && body !== null && "error" in body;
+}
+function extractMessage(body) {
+  if (isErrorBody(body)) {
+    return body.message ?? body.error ?? "Unknown error";
+  }
+  return "Unknown error";
+}
+function extractPlan(body) {
+  if (isErrorBody(body) && typeof body.message === "string") {
+    const match = body.message.match(/Current plan: (\w+)/);
+    if (match?.[1]) return match[1];
+  }
+  return "unknown";
+}
+async function mapResponseToError(status, headers, jsonFn) {
+  let body;
+  try {
+    body = await jsonFn();
+  } catch {
+    body = null;
+  }
+  const message = extractMessage(body);
+  if (status === 403 && isErrorBody(body) && body.error === "plan_limit") {
+    return new PlanLimitError(message, extractPlan(body));
+  }
+  if (status === 429) {
+    const retryAfter = Number(headers.get("retry-after") ?? "1");
+    return new RateLimitError(message, retryAfter);
+  }
+  return new ScorioError(message, status, "api_error");
+}
+
+// src/infrastructure/http/fetch-client.ts
+var FetchHttpClient = class {
+  async request(req) {
+    try {
+      const response = await fetch(req.url, {
+        method: req.method,
+        headers: req.headers,
+        signal: AbortSignal.timeout(req.timeout)
+      });
+      return {
+        status: response.status,
+        headers: response.headers,
+        json: () => response.json()
+      };
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "TimeoutError") {
+        throw new NetworkError(`Request timed out after ${req.timeout}ms`);
+      }
+      if (error instanceof TypeError) {
+        throw new NetworkError("Network request failed", { cause: error });
+      }
+      throw error;
+    }
+  }
+};
+
+// src/infrastructure/http/headers.ts
+var PLAN_TO_HEADER = {
+  free: "BASIC",
+  starter: "STARTER",
+  pro: "ULTRA",
+  business: "MEGA"
+};
+function buildHeaders(apiKey, host, debug, isSystem) {
+  const headers = {
+    Accept: "application/json"
+  };
+  if (isSystem) return headers;
+  if (debug) {
+    headers["x-rapidapi-proxy-secret"] = debug.secret;
+    if (debug.plan) {
+      headers["x-rapidapi-subscription"] = PLAN_TO_HEADER[debug.plan];
+    }
+  } else {
+    headers["X-RapidAPI-Key"] = apiKey;
+    headers["X-RapidAPI-Host"] = host;
+  }
+  return headers;
+}
+
+// src/infrastructure/http/url-builder.ts
+function serializeParams(params) {
+  if (!params) return "";
+  const entries = [];
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== void 0 && v !== null && v !== "") {
+      entries.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+    }
+  }
+  return entries.join("&");
+}
+function buildUrl(host, path, params) {
+  const base = `https://${host}${path}`;
+  const search = serializeParams(params);
+  return search ? `${base}?${search}` : base;
+}
+
+// src/application/sdk.ts
+var ScorioSDK = class {
+  apiKey;
+  host;
+  timeout;
+  logger;
+  config;
+  http;
+  constructor(config, httpClient) {
+    if (!config.apiKey) {
+      throw new Error("apiKey is required");
+    }
+    this.apiKey = config.apiKey;
+    this.host = config.debug?.host ?? config.host ?? "";
+    this.timeout = config.timeout ?? 3e4;
+    this.logger = config.logger ?? false;
+    this.config = config;
+    this.http = httpClient ?? new FetchHttpClient();
+    if (!this.host) {
+      throw new Error("host is required (or provide debug.host)");
+    }
+  }
+  async get(path, params, isSystem = false) {
+    const url = buildUrl(this.host, path, params);
+    const headers = buildHeaders(this.apiKey, this.host, this.config.debug, isSystem);
+    if (this.logger) {
+      console.log(`[scorio-sdk] GET ${path}`);
+    }
+    const response = await this.http.request({
+      method: "GET",
+      url,
+      headers,
+      timeout: this.timeout
+    });
+    if (response.status < 200 || response.status >= 300) {
+      throw await mapResponseToError(response.status, response.headers, response.json);
+    }
+    return response.json();
+  }
+  // ─── Catalog ───────────────────────────────────────────────────
+  /**
+   * List all available sports.
+   *
+   * Returns every available sport sorted by display order.
+   * Use this to build your top-level navigation or sport selector.
+   *
+   * @returns List of Sport objects with id, name, alias, and category.
+   *
+   * **Plans:** free, starter, pro, business | **Group:** catalog
+   *
+   * **Polling:** Cache locally for 60 seconds. The sport catalog changes infrequently.
+   *
+   * @example
+   * ```ts
+   * const { data, meta } = await client.getSports();
+   * // data: [{ id, name, alias, category }, ...]
+   * // meta: { count: number }
+   * ```
+   */
+  async getSports() {
+    return this.get("/api/sports");
+  }
+  /**
+   * Sports with live and prematch game counts.
+   *
+   * Returns all sports along with the number of currently live and upcoming prematch games for each.
+   * Perfect for sidebar badges, sport selector counts, or deciding which sport feeds to subscribe to.
+   *
+   * @returns List of SportCount objects (Sport + live_count + prematch_count).
+   *
+   * **Plans:** free, starter, pro, business | **Group:** catalog
+   *
+   * **Polling:** Every 10-30 seconds. Counts change as games go live or finish.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getSportsCounts();
+   * // data: [{ id, name, alias, category, live_count, prematch_count }, ...]
+   * ```
+   */
+  async getSportsCounts() {
+    return this.get("/api/sports/counts");
+  }
+  /**
+   * List regions for a sport.
+   *
+   * Returns all regions (countries or geographic areas) that currently have active games for the specified sport.
+   * Build the second level of your navigation tree (e.g., England, Germany, Spain for Football).
+   *
+   * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+   * @returns List of Region objects with id, name, alias, and sport_id.
+   *
+   * **Plans:** free, starter, pro, business | **Group:** catalog
+   *
+   * **Polling:** Cache locally for 60 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getRegions('01KNSZTCFAHSBS092VMZS7PMCW');
+   * // data: [{ id, name, alias, sport_id }, ...]
+   * ```
+   */
+  async getRegions(sportId) {
+    return this.get(`/api/sports/${sportId}/regions`);
+  }
+  /**
+   * List competitions for a region.
+   *
+   * Returns all competitions (leagues, tournaments, cups) within the specified region.
+   * Build the third level of your navigation tree (e.g., Premier League, Championship, FA Cup for England).
+   *
+   * @param regionId - Unique region identifier (ULID). Get IDs from {@link getRegions}.
+   * @returns List of Competition objects with id, name, region_id, and sport_id.
+   *
+   * **Plans:** free, starter, pro, business | **Group:** catalog
+   *
+   * **Polling:** Cache locally for 60 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getCompetitions('01JRQ00000ENGLAND0000001');
+   * // data: [{ id, name, region_id, sport_id }, ...]
+   * ```
+   */
+  async getCompetitions(regionId) {
+    return this.get(`/api/regions/${regionId}/competitions`);
+  }
+  /**
+   * List all competitions for a sport (flat list).
+   *
+   * Returns all competitions for the specified sport across ALL regions in one call.
+   * Useful for building flat competition selectors, search/filter dropdowns, or schedule filters.
+   *
+   * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+   * @returns Flat list of Competition objects.
+   *
+   * **Plans:** free, starter, pro, business | **Group:** catalog
+   *
+   * **Polling:** Cache locally for 60 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getCompetitionsBySport('01KNSZTCFAHSBS092VMZS7PMCW');
+   * // data: [{ id: "...", name: "Premier League", region_id, sport_id }, ...]
+   * ```
+   */
+  async getCompetitionsBySport(sportId) {
+    return this.get(`/api/sports/${sportId}/competitions`);
+  }
+  // ─── Live ──────────────────────────────────────────────────────
+  /**
+   * All live games across all sports.
+   *
+   * Returns every currently live (in-play) game in a single call.
+   * Ideal for multi-sport live tickers, aggregate live feeds, or monitoring total live game volume.
+   *
+   * @returns List of Game objects with is_live: true, including scores, stats, and market counts.
+   *
+   * **Plans:** starter, pro, business | **Group:** live
+   *
+   * **Polling:** Every 1-2 seconds for real-time updates.
+   * At peak hours this can return 200+ games. If you only need one sport, use {@link getLiveGamesBySport}.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getAllLiveGames();
+   * // data: [{ id, home_team, away_team, status: "live", score_text, info, stats, ... }, ...]
+   * ```
+   */
+  async getAllLiveGames() {
+    return this.get("/api/live/games");
+  }
+  /**
+   * Live games for a specific sport.
+   *
+   * Returns all currently live (in-play) games for the specified sport.
+   * More efficient than {@link getAllLiveGames} when you only need one sport.
+   *
+   * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+   * @returns List of live Game objects filtered to the requested sport.
+   *
+   * **Plans:** starter, pro, business | **Group:** live
+   *
+   * **Polling:** Every 1-2 seconds for real-time updates.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getLiveGamesBySport('01KNSZTCFAHSBS092VMZS7PMCW');
+   * // data: [{ id, home_team, away_team, score_text: "2:1 (67')", ... }, ...]
+   * ```
+   */
+  async getLiveGamesBySport(sportId) {
+    return this.get(`/api/live/games/${sportId}`);
+  }
+  /**
+   * Full live dashboard snapshot.
+   *
+   * Returns a complete live dashboard in a single API call: sport counts and all live games combined.
+   * Combines `/api/sports/counts` and `/api/live/games` to reduce round trips.
+   *
+   * @returns LiveSnapshot containing sports (with counts) and all live games.
+   *
+   * **Plans:** starter, pro, business | **Group:** live
+   *
+   * **Polling:** Every 2-5 seconds. This is a heavier endpoint.
+   * For granular updates after initial load, prefer individual endpoints.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getLiveSnapshot();
+   * // data: { sports: [{ id, name, live_count, prematch_count, ... }], games: [...] }
+   * ```
+   */
+  async getLiveSnapshot() {
+    return this.get("/api/live/snapshot");
+  }
+  // ─── Prematch ──────────────────────────────────────────────────
+  /**
+   * Prematch games for a sport (paginated).
+   *
+   * Returns upcoming (prematch) games for the specified sport with pagination support.
+   * Sports like Football can have 1500+ prematch games.
+   *
+   * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.
+   * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).
+   * @returns Paginated list of prematch Game objects.
+   *
+   * **Plans:** starter, pro, business | **Group:** prematch
+   *
+   * **Polling:** Every 10-30 seconds. Prematch odds update less frequently than live.
+   *
+   * @example
+   * ```ts
+   * const { data, meta } = await client.getPrematchGames('01KNSZTCFAHSBS092VMZS7PMCW', { limit: 20 });
+   * // data: [{ id, home_team, away_team, status: "prematch", start_time, ... }, ...]
+   * ```
+   */
+  async getPrematchGames(sportId, options) {
+    return this.get(`/api/prematch/games/${sportId}`, {
+      limit: options?.limit,
+      offset: options?.offset
+    });
+  }
+  // ─── Games ─────────────────────────────────────────────────────
+  /**
+   * Games for a competition (paginated).
+   *
+   * Returns games for a specific competition with pagination.
+   * Includes games that have recently started (up to 2 hours ago) and all upcoming games.
+   *
+   * @param competitionId - Unique competition identifier (ULID). Get IDs from {@link getCompetitions} or {@link getCompetitionsBySport}.
+   * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).
+   * @returns Paginated list of Game objects sorted by start time.
+   *
+   * **Plans:** starter, pro, business | **Group:** games
+   *
+   * **Polling:** Every 10-30 seconds for prematch, 1-2 seconds if showing live games.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getGamesByCompetition('01KNSZTCFGMM6JE2B9YQFGQCDZ', { limit: 10 });
+   * ```
+   */
+  async getGamesByCompetition(competitionId, options) {
+    return this.get(`/api/competitions/${competitionId}/games`, {
+      limit: options?.limit,
+      offset: options?.offset
+    });
+  }
+  /**
+   * Games starting within N minutes.
+   *
+   * Returns games that are about to start within the specified time window.
+   * Great for "Starting Soon" widgets or last-minute bet notifications.
+   *
+   * @param options - minutes: time window (1-180, default 30).
+   * @returns List of prematch Game objects sorted by start time (soonest first).
+   *
+   * **Plans:** starter, pro, business | **Group:** games
+   *
+   * **Polling:** Every 30-60 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getGamesStartingSoon({ minutes: 60 });
+   * ```
+   */
+  async getGamesStartingSoon(options) {
+    return this.get("/api/games/starting-soon", {
+      minutes: options?.minutes
+    });
+  }
+  /**
+   * Search games by team name.
+   *
+   * Case-insensitive partial match against both home_team and away_team across all sports.
+   * Sorted by relevance, then by start time.
+   *
+   * @param query - Search query string (minimum 2 characters).
+   * @param options - limit: max results (1-50, default 20).
+   * @returns List of matching Game objects.
+   *
+   * **Plans:** starter, pro, business | **Group:** games
+   *
+   * **Polling:** On demand (triggered by user input).
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.searchGames('Arsenal', { limit: 10 });
+   * ```
+   */
+  async searchGames(query, options) {
+    return this.get("/api/games/search", {
+      q: query,
+      limit: options?.limit
+    });
+  }
+  /**
+   * Full game detail with all markets and odds.
+   *
+   * Returns complete data for a single game: metadata, all markets, and all outcomes.
+   * Everything needed to render a full betting interface.
+   *
+   * @param gameId - Unique game identifier (ULID). Get IDs from any endpoint that returns Game objects.
+   * @returns Single Game object with nested markets and outcomes.
+   *
+   * **Plans:** starter, pro, business | **Group:** games
+   *
+   * Markets are populated only on **pro** and **business** plans.
+   * Lower plans receive `markets: []` and `markets_count: 0`.
+   *
+   * **Polling:** Every 1-2 seconds for live games, 10-30 seconds for prematch.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getGameDetail('01TESTGAME00000LIVESOC01');
+   * // data.markets: [{ id, name, type, line, outcomes: [{ id, name, price, is_suspended }] }]
+   * ```
+   */
+  async getGameDetail(gameId) {
+    return this.get(`/api/games/${gameId}`);
+  }
+  // ─── Schedule ──────────────────────────────────────────────────
+  /**
+   * Games by date or date range.
+   *
+   * Returns all games scheduled for a specific date or range, optionally filtered by sport or competition.
+   * Uses UTC dates. Defaults to today if no date params provided.
+   *
+   * @param options - date (YYYY-MM-DD), dateFrom/dateTo (max 90 days), sportId, competitionId.
+   * @returns List of Game objects sorted by start time.
+   *
+   * **Plans:** starter, pro, business | **Group:** schedule
+   *
+   * **Polling:** Every 60 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getSchedule({ date: '2026-04-10', sportId: '01KNSZTCFAHSBS092VMZS7PMCW' });
+   * ```
+   */
+  async getSchedule(options) {
+    return this.get("/api/schedule", {
+      date: options?.date,
+      date_from: options?.dateFrom,
+      date_to: options?.dateTo,
+      sport_id: options?.sportId,
+      competition_id: options?.competitionId
+    });
+  }
+  // ─── Odds Intelligence ─────────────────────────────────────────
+  /**
+   * Min/max/avg price summary per outcome for a game.
+   *
+   * Returns statistical summary of odds for every outcome: min, max, average price, and number of changes.
+   * Useful for identifying value bets, overreactions, and market inefficiencies.
+   *
+   * @param gameId - Unique game identifier (ULID).
+   * @returns List of OddsSummary objects, one per outcome.
+   *
+   * **Plans:** pro, business | **Group:** odds
+   *
+   * **Polling:** Every 10-30 seconds.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getGameOddsSummary('01TESTGAME00000LIVESOC01');
+   * // data: [{ event_id, event_name, current_price, min_price, max_price, avg_price, change_count }]
+   * ```
+   */
+  async getGameOddsSummary(gameId) {
+    return this.get(`/api/games/${gameId}/odds-summary`);
+  }
+  /**
+   * Top odds movements (biggest price changes).
+   *
+   * Returns outcomes with the largest odds movements within a given time window.
+   * Key differentiator for professional bettors and odds aggregation platforms.
+   *
+   * @param options - minutes: look-back window (1-1440, default 60), limit: max results (1-100, default 20).
+   * @returns List of OddsMover objects sorted by absolute change percentage (largest first).
+   *
+   * **Plans:** pro, business | **Group:** odds
+   *
+   * **Polling:** Every 5-10 seconds for near-real-time steam move alerts.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getOddsMovers({ minutes: 30, limit: 10 });
+   * // data: [{ event_id, game_id, current_price, opening_price, price_change, change_percent, ... }]
+   * ```
+   */
+  async getOddsMovers(options) {
+    return this.get("/api/odds/movers", {
+      minutes: options?.minutes,
+      limit: options?.limit
+    });
+  }
+  /**
+   * Historical price changes for an outcome.
+   *
+   * Returns the full history of price changes for a specific outcome (selection).
+   * Build odds movement charts, sparklines, or trend analysis visualizations.
+   * 60-day retention, tick-level granularity.
+   *
+   * @param eventId - Unique outcome identifier (ULID). Get IDs from Game objects with markets.
+   * @param options - from/to (unix timestamps), limit (1-5000, default 500).
+   * @returns Chronological list of PricePoint objects (oldest first).
+   *
+   * **Plans:** pro, business | **Group:** odds
+   *
+   * **Polling:** On demand.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.getEventPriceHistory('01TESTEVT00000ARS0NAL01', { limit: 100 });
+   * // data: [{ price, previous_price, recorded_at }, ...]
+   * ```
+   */
+  async getEventPriceHistory(eventId, options) {
+    return this.get(`/api/events/${eventId}/price-history`, {
+      from: options?.from,
+      to: options?.to,
+      limit: options?.limit
+    });
+  }
+  // ─── System ────────────────────────────────────────────────────
+  /**
+   * Health check.
+   *
+   * Returns the current health status of the API. No authentication required.
+   * Use in load balancer health checks, uptime monitoring, or status pages.
+   *
+   * @returns `{ status: "ok" }` when the API is healthy.
+   *
+   * **Plans:** all (no authentication required) | **Group:** system
+   *
+   * **Polling:** Every 30-60 seconds from your monitoring system.
+   */
+  async health() {
+    return this.get("/api/health", void 0, true);
+  }
+  /**
+   * Ping.
+   *
+   * Simple connectivity check. No authentication required.
+   * Quick liveness probe for monitoring or client-side connectivity checks.
+   *
+   * @returns `{ pong: true }`
+   *
+   * **Plans:** all (no authentication required) | **Group:** system
+   */
+  async ping() {
+    return this.get("/api/ping", void 0, true);
+  }
+};
+export {
+  NetworkError,
+  PlanLimitError,
+  RateLimitError,
+  ScorioError,
+  ScorioSDK as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/domain/errors.ts","../src/infrastructure/http/error-mapper.ts","../src/infrastructure/http/fetch-client.ts","../src/infrastructure/http/headers.ts","../src/infrastructure/http/url-builder.ts","../src/application/sdk.ts"],"sourcesContent":["export class ScorioError extends Error {\n\treadonly status: number;\n\treadonly code: string;\n\n\tconstructor(message: string, status: number, code: string) {\n\t\tsuper(message);\n\t\tthis.name = 'ScorioError';\n\t\tthis.status = status;\n\t\tthis.code = code;\n\t}\n}\n\nexport class PlanLimitError extends ScorioError {\n\treadonly currentPlan: string;\n\n\tconstructor(message: string, currentPlan: string) {\n\t\tsuper(message, 403, 'plan_limit');\n\t\tthis.name = 'PlanLimitError';\n\t\tthis.currentPlan = currentPlan;\n\t}\n}\n\nexport class RateLimitError extends ScorioError {\n\treadonly retryAfter: number;\n\n\tconstructor(message: string, retryAfter: number) {\n\t\tsuper(message, 429, 'rate_limit');\n\t\tthis.name = 'RateLimitError';\n\t\tthis.retryAfter = retryAfter;\n\t}\n}\n\nexport class NetworkError extends ScorioError {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, 0, 'network_error');\n\t\tthis.name = 'NetworkError';\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t}\n}\n","import { NetworkError, PlanLimitError, RateLimitError, ScorioError } from '../../domain/errors.js';\n\ninterface ErrorBody {\n\terror?: string;\n\tmessage?: string;\n}\n\nfunction isErrorBody(body: unknown): body is ErrorBody {\n\treturn typeof body === 'object' && body !== null && 'error' in body;\n}\n\nfunction extractMessage(body: unknown): string {\n\tif (isErrorBody(body)) {\n\t\treturn body.message ?? body.error ?? 'Unknown error';\n\t}\n\treturn 'Unknown error';\n}\n\nfunction extractPlan(body: unknown): string {\n\tif (isErrorBody(body) && typeof body.message === 'string') {\n\t\tconst match = body.message.match(/Current plan: (\\w+)/);\n\t\tif (match?.[1]) return match[1];\n\t}\n\treturn 'unknown';\n}\n\nexport async function mapResponseToError(\n\tstatus: number,\n\theaders: { get(name: string): string | null },\n\tjsonFn: () => Promise<unknown>,\n): Promise<ScorioError> {\n\tlet body: unknown;\n\ttry {\n\t\tbody = await jsonFn();\n\t} catch {\n\t\tbody = null;\n\t}\n\n\tconst message = extractMessage(body);\n\n\tif (status === 403 && isErrorBody(body) && body.error === 'plan_limit') {\n\t\treturn new PlanLimitError(message, extractPlan(body));\n\t}\n\n\tif (status === 429) {\n\t\tconst retryAfter = Number(headers.get('retry-after') ?? '1');\n\t\treturn new RateLimitError(message, retryAfter);\n\t}\n\n\treturn new ScorioError(message, status, 'api_error');\n}\n\nexport { NetworkError };\n","import type {\n\tHttpClientPort,\n\tHttpRequest,\n\tHttpResponse,\n} from '../../application/ports/http-client.port.js';\nimport { NetworkError } from '../../domain/errors.js';\n\nexport class FetchHttpClient implements HttpClientPort {\n\tasync request(req: HttpRequest): Promise<HttpResponse> {\n\t\ttry {\n\t\t\tconst response = await fetch(req.url, {\n\t\t\t\tmethod: req.method,\n\t\t\t\theaders: req.headers,\n\t\t\t\tsignal: AbortSignal.timeout(req.timeout),\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tstatus: response.status,\n\t\t\t\theaders: response.headers,\n\t\t\t\tjson: () => response.json() as Promise<unknown>,\n\t\t\t};\n\t\t} catch (error: unknown) {\n\t\t\tif (error instanceof DOMException && error.name === 'TimeoutError') {\n\t\t\t\tthrow new NetworkError(`Request timed out after ${req.timeout}ms`);\n\t\t\t}\n\t\t\tif (error instanceof TypeError) {\n\t\t\t\tthrow new NetworkError('Network request failed', { cause: error });\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n}\n","import type { DebugConfig, Plan } from '../../domain/types.js';\n\n/** Maps SDK plan names to the x-rapidapi-subscription header values\n *  that the server's plan-guard.ts resolves to the correct internal tier. */\nconst PLAN_TO_HEADER: Record<Plan, string> = {\n\tfree: 'BASIC',\n\tstarter: 'STARTER',\n\tpro: 'ULTRA',\n\tbusiness: 'MEGA',\n};\n\nexport function buildHeaders(\n\tapiKey: string,\n\thost: string,\n\tdebug: DebugConfig | undefined,\n\tisSystem: boolean,\n): Record<string, string> {\n\tconst headers: Record<string, string> = {\n\t\tAccept: 'application/json',\n\t};\n\n\tif (isSystem) return headers;\n\n\tif (debug) {\n\t\theaders['x-rapidapi-proxy-secret'] = debug.secret;\n\t\tif (debug.plan) {\n\t\t\theaders['x-rapidapi-subscription'] = PLAN_TO_HEADER[debug.plan];\n\t\t}\n\t} else {\n\t\theaders['X-RapidAPI-Key'] = apiKey;\n\t\theaders['X-RapidAPI-Host'] = host;\n\t}\n\n\treturn headers;\n}\n","export function serializeParams(params?: Record<string, string | number | undefined>): string {\n\tif (!params) return '';\n\tconst entries: string[] = [];\n\tfor (const [k, v] of Object.entries(params)) {\n\t\tif (v !== undefined && v !== null && v !== '') {\n\t\t\tentries.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);\n\t\t}\n\t}\n\treturn entries.join('&');\n}\n\nexport function buildUrl(\n\thost: string,\n\tpath: string,\n\tparams?: Record<string, string | number | undefined>,\n): string {\n\tconst base = `https://${host}${path}`;\n\tconst search = serializeParams(params);\n\treturn search ? `${base}?${search}` : base;\n}\n","import type {\n\tCompetition,\n\tGame,\n\tHealthResponse,\n\tListResponse,\n\tLiveSnapshot,\n\tOddsMover,\n\tOddsMoversOptions,\n\tOddsSummary,\n\tPaginationOptions,\n\tPingResponse,\n\tPriceHistoryOptions,\n\tPricePoint,\n\tRegion,\n\tScheduleOptions,\n\tScorioSDKConfig,\n\tSearchOptions,\n\tSingleResponse,\n\tSport,\n\tSportCount,\n\tStartingSoonOptions,\n} from '../domain/types.js';\nimport { mapResponseToError } from '../infrastructure/http/error-mapper.js';\nimport { FetchHttpClient } from '../infrastructure/http/fetch-client.js';\nimport { buildHeaders } from '../infrastructure/http/headers.js';\nimport { buildUrl } from '../infrastructure/http/url-builder.js';\nimport type { HttpClientPort } from './ports/http-client.port.js';\n\nexport default class ScorioSDK {\n\tprivate readonly apiKey: string;\n\tprivate readonly host: string;\n\tprivate readonly timeout: number;\n\tprivate readonly logger: boolean;\n\tprivate readonly config: ScorioSDKConfig;\n\tprivate readonly http: HttpClientPort;\n\n\tconstructor(config: ScorioSDKConfig, httpClient?: HttpClientPort) {\n\t\tif (!config.apiKey) {\n\t\t\tthrow new Error('apiKey is required');\n\t\t}\n\t\tthis.apiKey = config.apiKey;\n\t\tthis.host = config.debug?.host ?? config.host ?? '';\n\t\tthis.timeout = config.timeout ?? 30_000;\n\t\tthis.logger = config.logger ?? false;\n\t\tthis.config = config;\n\t\tthis.http = httpClient ?? new FetchHttpClient();\n\n\t\tif (!this.host) {\n\t\t\tthrow new Error('host is required (or provide debug.host)');\n\t\t}\n\t}\n\n\tprivate async get<T>(\n\t\tpath: string,\n\t\tparams?: Record<string, string | number | undefined>,\n\t\tisSystem = false,\n\t): Promise<T> {\n\t\tconst url = buildUrl(this.host, path, params);\n\t\tconst headers = buildHeaders(this.apiKey, this.host, this.config.debug, isSystem);\n\n\t\tif (this.logger) {\n\t\t\tconsole.log(`[scorio-sdk] GET ${path}`);\n\t\t}\n\n\t\tconst response = await this.http.request({\n\t\t\tmethod: 'GET',\n\t\t\turl,\n\t\t\theaders,\n\t\t\ttimeout: this.timeout,\n\t\t});\n\n\t\tif (response.status < 200 || response.status >= 300) {\n\t\t\tthrow await mapResponseToError(response.status, response.headers, response.json);\n\t\t}\n\n\t\treturn response.json() as Promise<T>;\n\t}\n\n\t// ─── Catalog ───────────────────────────────────────────────────\n\n\t/**\n\t * List all available sports.\n\t *\n\t * Returns every available sport sorted by display order.\n\t * Use this to build your top-level navigation or sport selector.\n\t *\n\t * @returns List of Sport objects with id, name, alias, and category.\n\t *\n\t * **Plans:** free, starter, pro, business | **Group:** catalog\n\t *\n\t * **Polling:** Cache locally for 60 seconds. The sport catalog changes infrequently.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data, meta } = await client.getSports();\n\t * // data: [{ id, name, alias, category }, ...]\n\t * // meta: { count: number }\n\t * ```\n\t */\n\tasync getSports(): Promise<ListResponse<Sport>> {\n\t\treturn this.get('/api/sports');\n\t}\n\n\t/**\n\t * Sports with live and prematch game counts.\n\t *\n\t * Returns all sports along with the number of currently live and upcoming prematch games for each.\n\t * Perfect for sidebar badges, sport selector counts, or deciding which sport feeds to subscribe to.\n\t *\n\t * @returns List of SportCount objects (Sport + live_count + prematch_count).\n\t *\n\t * **Plans:** free, starter, pro, business | **Group:** catalog\n\t *\n\t * **Polling:** Every 10-30 seconds. Counts change as games go live or finish.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getSportsCounts();\n\t * // data: [{ id, name, alias, category, live_count, prematch_count }, ...]\n\t * ```\n\t */\n\tasync getSportsCounts(): Promise<ListResponse<SportCount>> {\n\t\treturn this.get('/api/sports/counts');\n\t}\n\n\t/**\n\t * List regions for a sport.\n\t *\n\t * Returns all regions (countries or geographic areas) that currently have active games for the specified sport.\n\t * Build the second level of your navigation tree (e.g., England, Germany, Spain for Football).\n\t *\n\t * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.\n\t * @returns List of Region objects with id, name, alias, and sport_id.\n\t *\n\t * **Plans:** free, starter, pro, business | **Group:** catalog\n\t *\n\t * **Polling:** Cache locally for 60 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getRegions('01KNSZTCFAHSBS092VMZS7PMCW');\n\t * // data: [{ id, name, alias, sport_id }, ...]\n\t * ```\n\t */\n\tasync getRegions(sportId: string): Promise<ListResponse<Region>> {\n\t\treturn this.get(`/api/sports/${sportId}/regions`);\n\t}\n\n\t/**\n\t * List competitions for a region.\n\t *\n\t * Returns all competitions (leagues, tournaments, cups) within the specified region.\n\t * Build the third level of your navigation tree (e.g., Premier League, Championship, FA Cup for England).\n\t *\n\t * @param regionId - Unique region identifier (ULID). Get IDs from {@link getRegions}.\n\t * @returns List of Competition objects with id, name, region_id, and sport_id.\n\t *\n\t * **Plans:** free, starter, pro, business | **Group:** catalog\n\t *\n\t * **Polling:** Cache locally for 60 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getCompetitions('01JRQ00000ENGLAND0000001');\n\t * // data: [{ id, name, region_id, sport_id }, ...]\n\t * ```\n\t */\n\tasync getCompetitions(regionId: string): Promise<ListResponse<Competition>> {\n\t\treturn this.get(`/api/regions/${regionId}/competitions`);\n\t}\n\n\t/**\n\t * List all competitions for a sport (flat list).\n\t *\n\t * Returns all competitions for the specified sport across ALL regions in one call.\n\t * Useful for building flat competition selectors, search/filter dropdowns, or schedule filters.\n\t *\n\t * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.\n\t * @returns Flat list of Competition objects.\n\t *\n\t * **Plans:** free, starter, pro, business | **Group:** catalog\n\t *\n\t * **Polling:** Cache locally for 60 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getCompetitionsBySport('01KNSZTCFAHSBS092VMZS7PMCW');\n\t * // data: [{ id: \"...\", name: \"Premier League\", region_id, sport_id }, ...]\n\t * ```\n\t */\n\tasync getCompetitionsBySport(sportId: string): Promise<ListResponse<Competition>> {\n\t\treturn this.get(`/api/sports/${sportId}/competitions`);\n\t}\n\n\t// ─── Live ──────────────────────────────────────────────────────\n\n\t/**\n\t * All live games across all sports.\n\t *\n\t * Returns every currently live (in-play) game in a single call.\n\t * Ideal for multi-sport live tickers, aggregate live feeds, or monitoring total live game volume.\n\t *\n\t * @returns List of Game objects with is_live: true, including scores, stats, and market counts.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** live\n\t *\n\t * **Polling:** Every 1-2 seconds for real-time updates.\n\t * At peak hours this can return 200+ games. If you only need one sport, use {@link getLiveGamesBySport}.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getAllLiveGames();\n\t * // data: [{ id, home_team, away_team, status: \"live\", score_text, info, stats, ... }, ...]\n\t * ```\n\t */\n\tasync getAllLiveGames(): Promise<ListResponse<Game>> {\n\t\treturn this.get('/api/live/games');\n\t}\n\n\t/**\n\t * Live games for a specific sport.\n\t *\n\t * Returns all currently live (in-play) games for the specified sport.\n\t * More efficient than {@link getAllLiveGames} when you only need one sport.\n\t *\n\t * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.\n\t * @returns List of live Game objects filtered to the requested sport.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** live\n\t *\n\t * **Polling:** Every 1-2 seconds for real-time updates.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getLiveGamesBySport('01KNSZTCFAHSBS092VMZS7PMCW');\n\t * // data: [{ id, home_team, away_team, score_text: \"2:1 (67')\", ... }, ...]\n\t * ```\n\t */\n\tasync getLiveGamesBySport(sportId: string): Promise<ListResponse<Game>> {\n\t\treturn this.get(`/api/live/games/${sportId}`);\n\t}\n\n\t/**\n\t * Full live dashboard snapshot.\n\t *\n\t * Returns a complete live dashboard in a single API call: sport counts and all live games combined.\n\t * Combines `/api/sports/counts` and `/api/live/games` to reduce round trips.\n\t *\n\t * @returns LiveSnapshot containing sports (with counts) and all live games.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** live\n\t *\n\t * **Polling:** Every 2-5 seconds. This is a heavier endpoint.\n\t * For granular updates after initial load, prefer individual endpoints.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getLiveSnapshot();\n\t * // data: { sports: [{ id, name, live_count, prematch_count, ... }], games: [...] }\n\t * ```\n\t */\n\tasync getLiveSnapshot(): Promise<SingleResponse<LiveSnapshot>> {\n\t\treturn this.get('/api/live/snapshot');\n\t}\n\n\t// ─── Prematch ──────────────────────────────────────────────────\n\n\t/**\n\t * Prematch games for a sport (paginated).\n\t *\n\t * Returns upcoming (prematch) games for the specified sport with pagination support.\n\t * Sports like Football can have 1500+ prematch games.\n\t *\n\t * @param sportId - Unique sport identifier (ULID). Get IDs from {@link getSports}.\n\t * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).\n\t * @returns Paginated list of prematch Game objects.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** prematch\n\t *\n\t * **Polling:** Every 10-30 seconds. Prematch odds update less frequently than live.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data, meta } = await client.getPrematchGames('01KNSZTCFAHSBS092VMZS7PMCW', { limit: 20 });\n\t * // data: [{ id, home_team, away_team, status: \"prematch\", start_time, ... }, ...]\n\t * ```\n\t */\n\tasync getPrematchGames(\n\t\tsportId: string,\n\t\toptions?: PaginationOptions,\n\t): Promise<ListResponse<Game>> {\n\t\treturn this.get(`/api/prematch/games/${sportId}`, {\n\t\t\tlimit: options?.limit,\n\t\t\toffset: options?.offset,\n\t\t});\n\t}\n\n\t// ─── Games ─────────────────────────────────────────────────────\n\n\t/**\n\t * Games for a competition (paginated).\n\t *\n\t * Returns games for a specific competition with pagination.\n\t * Includes games that have recently started (up to 2 hours ago) and all upcoming games.\n\t *\n\t * @param competitionId - Unique competition identifier (ULID). Get IDs from {@link getCompetitions} or {@link getCompetitionsBySport}.\n\t * @param options - Pagination options: limit (1-100, default 50) and offset (default 0).\n\t * @returns Paginated list of Game objects sorted by start time.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** games\n\t *\n\t * **Polling:** Every 10-30 seconds for prematch, 1-2 seconds if showing live games.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getGamesByCompetition('01KNSZTCFGMM6JE2B9YQFGQCDZ', { limit: 10 });\n\t * ```\n\t */\n\tasync getGamesByCompetition(\n\t\tcompetitionId: string,\n\t\toptions?: PaginationOptions,\n\t): Promise<ListResponse<Game>> {\n\t\treturn this.get(`/api/competitions/${competitionId}/games`, {\n\t\t\tlimit: options?.limit,\n\t\t\toffset: options?.offset,\n\t\t});\n\t}\n\n\t/**\n\t * Games starting within N minutes.\n\t *\n\t * Returns games that are about to start within the specified time window.\n\t * Great for \"Starting Soon\" widgets or last-minute bet notifications.\n\t *\n\t * @param options - minutes: time window (1-180, default 30).\n\t * @returns List of prematch Game objects sorted by start time (soonest first).\n\t *\n\t * **Plans:** starter, pro, business | **Group:** games\n\t *\n\t * **Polling:** Every 30-60 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getGamesStartingSoon({ minutes: 60 });\n\t * ```\n\t */\n\tasync getGamesStartingSoon(options?: StartingSoonOptions): Promise<ListResponse<Game>> {\n\t\treturn this.get('/api/games/starting-soon', {\n\t\t\tminutes: options?.minutes,\n\t\t});\n\t}\n\n\t/**\n\t * Search games by team name.\n\t *\n\t * Case-insensitive partial match against both home_team and away_team across all sports.\n\t * Sorted by relevance, then by start time.\n\t *\n\t * @param query - Search query string (minimum 2 characters).\n\t * @param options - limit: max results (1-50, default 20).\n\t * @returns List of matching Game objects.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** games\n\t *\n\t * **Polling:** On demand (triggered by user input).\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.searchGames('Arsenal', { limit: 10 });\n\t * ```\n\t */\n\tasync searchGames(query: string, options?: SearchOptions): Promise<ListResponse<Game>> {\n\t\treturn this.get('/api/games/search', {\n\t\t\tq: query,\n\t\t\tlimit: options?.limit,\n\t\t});\n\t}\n\n\t/**\n\t * Full game detail with all markets and odds.\n\t *\n\t * Returns complete data for a single game: metadata, all markets, and all outcomes.\n\t * Everything needed to render a full betting interface.\n\t *\n\t * @param gameId - Unique game identifier (ULID). Get IDs from any endpoint that returns Game objects.\n\t * @returns Single Game object with nested markets and outcomes.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** games\n\t *\n\t * Markets are populated only on **pro** and **business** plans.\n\t * Lower plans receive `markets: []` and `markets_count: 0`.\n\t *\n\t * **Polling:** Every 1-2 seconds for live games, 10-30 seconds for prematch.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getGameDetail('01TESTGAME00000LIVESOC01');\n\t * // data.markets: [{ id, name, type, line, outcomes: [{ id, name, price, is_suspended }] }]\n\t * ```\n\t */\n\tasync getGameDetail(gameId: string): Promise<SingleResponse<Game>> {\n\t\treturn this.get(`/api/games/${gameId}`);\n\t}\n\n\t// ─── Schedule ──────────────────────────────────────────────────\n\n\t/**\n\t * Games by date or date range.\n\t *\n\t * Returns all games scheduled for a specific date or range, optionally filtered by sport or competition.\n\t * Uses UTC dates. Defaults to today if no date params provided.\n\t *\n\t * @param options - date (YYYY-MM-DD), dateFrom/dateTo (max 90 days), sportId, competitionId.\n\t * @returns List of Game objects sorted by start time.\n\t *\n\t * **Plans:** starter, pro, business | **Group:** schedule\n\t *\n\t * **Polling:** Every 60 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getSchedule({ date: '2026-04-10', sportId: '01KNSZTCFAHSBS092VMZS7PMCW' });\n\t * ```\n\t */\n\tasync getSchedule(options?: ScheduleOptions): Promise<ListResponse<Game>> {\n\t\treturn this.get('/api/schedule', {\n\t\t\tdate: options?.date,\n\t\t\tdate_from: options?.dateFrom,\n\t\t\tdate_to: options?.dateTo,\n\t\t\tsport_id: options?.sportId,\n\t\t\tcompetition_id: options?.competitionId,\n\t\t});\n\t}\n\n\t// ─── Odds Intelligence ─────────────────────────────────────────\n\n\t/**\n\t * Min/max/avg price summary per outcome for a game.\n\t *\n\t * Returns statistical summary of odds for every outcome: min, max, average price, and number of changes.\n\t * Useful for identifying value bets, overreactions, and market inefficiencies.\n\t *\n\t * @param gameId - Unique game identifier (ULID).\n\t * @returns List of OddsSummary objects, one per outcome.\n\t *\n\t * **Plans:** pro, business | **Group:** odds\n\t *\n\t * **Polling:** Every 10-30 seconds.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getGameOddsSummary('01TESTGAME00000LIVESOC01');\n\t * // data: [{ event_id, event_name, current_price, min_price, max_price, avg_price, change_count }]\n\t * ```\n\t */\n\tasync getGameOddsSummary(gameId: string): Promise<ListResponse<OddsSummary>> {\n\t\treturn this.get(`/api/games/${gameId}/odds-summary`);\n\t}\n\n\t/**\n\t * Top odds movements (biggest price changes).\n\t *\n\t * Returns outcomes with the largest odds movements within a given time window.\n\t * Key differentiator for professional bettors and odds aggregation platforms.\n\t *\n\t * @param options - minutes: look-back window (1-1440, default 60), limit: max results (1-100, default 20).\n\t * @returns List of OddsMover objects sorted by absolute change percentage (largest first).\n\t *\n\t * **Plans:** pro, business | **Group:** odds\n\t *\n\t * **Polling:** Every 5-10 seconds for near-real-time steam move alerts.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getOddsMovers({ minutes: 30, limit: 10 });\n\t * // data: [{ event_id, game_id, current_price, opening_price, price_change, change_percent, ... }]\n\t * ```\n\t */\n\tasync getOddsMovers(options?: OddsMoversOptions): Promise<ListResponse<OddsMover>> {\n\t\treturn this.get('/api/odds/movers', {\n\t\t\tminutes: options?.minutes,\n\t\t\tlimit: options?.limit,\n\t\t});\n\t}\n\n\t/**\n\t * Historical price changes for an outcome.\n\t *\n\t * Returns the full history of price changes for a specific outcome (selection).\n\t * Build odds movement charts, sparklines, or trend analysis visualizations.\n\t * 60-day retention, tick-level granularity.\n\t *\n\t * @param eventId - Unique outcome identifier (ULID). Get IDs from Game objects with markets.\n\t * @param options - from/to (unix timestamps), limit (1-5000, default 500).\n\t * @returns Chronological list of PricePoint objects (oldest first).\n\t *\n\t * **Plans:** pro, business | **Group:** odds\n\t *\n\t * **Polling:** On demand.\n\t *\n\t * @example\n\t * ```ts\n\t * const { data } = await client.getEventPriceHistory('01TESTEVT00000ARS0NAL01', { limit: 100 });\n\t * // data: [{ price, previous_price, recorded_at }, ...]\n\t * ```\n\t */\n\tasync getEventPriceHistory(\n\t\teventId: string,\n\t\toptions?: PriceHistoryOptions,\n\t): Promise<ListResponse<PricePoint>> {\n\t\treturn this.get(`/api/events/${eventId}/price-history`, {\n\t\t\tfrom: options?.from,\n\t\t\tto: options?.to,\n\t\t\tlimit: options?.limit,\n\t\t});\n\t}\n\n\t// ─── System ────────────────────────────────────────────────────\n\n\t/**\n\t * Health check.\n\t *\n\t * Returns the current health status of the API. No authentication required.\n\t * Use in load balancer health checks, uptime monitoring, or status pages.\n\t *\n\t * @returns `{ status: \"ok\" }` when the API is healthy.\n\t *\n\t * **Plans:** all (no authentication required) | **Group:** system\n\t *\n\t * **Polling:** Every 30-60 seconds from your monitoring system.\n\t */\n\tasync health(): Promise<HealthResponse> {\n\t\treturn this.get('/api/health', undefined, true);\n\t}\n\n\t/**\n\t * Ping.\n\t *\n\t * Simple connectivity check. No authentication required.\n\t * Quick liveness probe for monitoring or client-side connectivity checks.\n\t *\n\t * @returns `{ pong: true }`\n\t *\n\t * **Plans:** all (no authentication required) | **Group:** system\n\t */\n\tasync ping(): Promise<PingResponse> {\n\t\treturn this.get('/api/ping', undefined, true);\n\t}\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@scorio/client-sdk",
+	"version": "1.0.0",
+	"description": "TypeScript SDK for the Scorio Sports API — real-time odds, live scores, and historical price analytics across 80+ sports",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"keywords": [
+		"sports",
+		"betting",
+		"odds",
+		"live-scores",
+		"sports-data",
+		"sportsbook",
+		"sports-api",
+		"odds-api",
+		"betting-api",
+		"live-betting",
+		"prematch",
+		"price-history",
+		"football",
+		"basketball",
+		"tennis",
+		"esports",
+		"rapidapi",
+		"sdk",
+		"typescript"
+	],
+	"author": "Scorio <support@sportsdataapi.com>",
+	"license": "MIT",
+	"homepage": "https://github.com/ts-ign0re/scorio#readme",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/ts-ign0re/scorio.git",
+		"directory": "packages/scorio-sdk"
+	},
+	"scripts": {
+		"build": "tsup",
+		"check": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"test:integration": "vitest run src/__tests__/integration/",
+		"test:build": "tsup && vitest run -c vitest.build.config.ts src/__tests__/integration/",
+		"clean": "rm -rf dist *.tsbuildinfo"
+	},
+	"devDependencies": {
+		"tsup": "^8.4.0",
+		"vitest": "^4.1.4"
+	}
+}