propline 0.54.0 → 0.56.0

package/dist/index.d.cts

@@ -765,6 +765,21 @@ interface ResultsResponse {
     upgrade_url?: string;
     [k: string]: unknown;
 }
+/** One match from {@link PropLine.searchPlayers}. */
+interface PlayerSearchResult {
+    /** Stable id, usable in place of a name on history/trends (e.g. `"mlb:677951"`). */
+    player_id: string;
+    name: string;
+    /** Every spelling the books use for this player. */
+    known_names: string[];
+    [k: string]: unknown;
+}
+interface PlayerSearchResponse {
+    sport_key: string;
+    search: string;
+    players: PlayerSearchResult[];
+    [k: string]: unknown;
+}
 interface PlayerHistoryEntry {
     event_id: number | string;
     commence_time: string;
@@ -779,11 +794,17 @@ interface PlayerHistoryEntry {
     over_result: "won" | "lost" | "push" | "void" | null;
     under_result: "won" | "lost" | "push" | "void" | null;
     resolved_at: string | null;
+    /** True when this line is the book's main line (not an alt-ladder rung). */
+    is_main_line?: boolean;
+    /** True when the book moved this line after the game started. */
+    line_moved_in_play?: boolean;
     redacted?: boolean;
     [k: string]: unknown;
 }
 interface PlayerHistoryResponse {
     player_name: string;
+    /** Stable player id (e.g. `"mlb:677951"`), or `null` when unknown. */
+    player_id?: string | null;
     sport_key: string;
     market: string;
     entries: PlayerHistoryEntry[];
@@ -834,6 +855,8 @@ interface PlayerMarketTrend {
 }
 interface PlayerTrends {
     player_name: string;
+    /** Stable player id (e.g. `"mlb:592450"`), or `null` when unknown. */
+    player_id?: string | null;
     sport_key: string;
     /**
      * Echo of the `dfs_odds_type` filter that scoped these trends (PrizePicks
@@ -1563,6 +1586,9 @@ interface GetStatsOptions {
 }
 interface GetResultsOptions {
     markets?: string[];
+    /** Bookmaker key(s) to restrict the response to. Omitted = all books.
+     *  An unfiltered MLB game can run several MB. */
+    bookmakers?: string | string[];
 }
 interface GetPlayerHistoryOptions {
     /** Market key (e.g. `"pitcher_strikeouts"`). Required. */
@@ -1571,6 +1597,12 @@ interface GetPlayerHistoryOptions {
     bookmaker?: string;
     /** Max entries (1-100). Default 20. */
     limit?: number;
+    /** Only each book's main line (drops alt-ladder rungs). */
+    mainLineOnly?: boolean;
+}
+interface SearchPlayersOptions {
+    /** Max players (1-100). Server default 25. */
+    limit?: number;
 }
 interface GetPlayerGamesOptions {
     /** Games to return, 1-100. Default 20. */
@@ -1990,10 +2022,24 @@ declare class PropLine {
      * Pro tier: full data. Free tier: redacted (resolution + actual nulled).
      */
     getResults(sport: string, eventId: number | string, options?: GetResultsOptions): Promise<ResultsResponse>;
+    /**
+     * Search players by name fragment and get their stable `player_id`.
+     * Free tier. Pass the id in place of a name to {@link getPlayerHistory}
+     * or {@link getPlayerTrends}.
+     *
+     * @example
+     * ```ts
+     * const res = await client.searchPlayers("baseball_mlb", "judge", { limit: 5 });
+     * for (const p of res.players) console.log(p.player_id, p.name, p.known_names);
+     * ```
+     */
+    searchPlayers(sport: string, search: string, options?: SearchPlayersOptions): Promise<PlayerSearchResponse>;
     /**
      * Recent resolved prop history for a player on a market.
      *
      * One entry per (event, bookmaker) pair. Pro: full. Free: redacted.
+     * `playerName` may be a name or a `player_id` like `"mlb:677951"`
+     * (see {@link searchPlayers}).
      */
     getPlayerHistory(sport: string, playerName: string, options: GetPlayerHistoryOptions): Promise<PlayerHistoryResponse>;
     /**
@@ -2026,7 +2072,8 @@ declare class PropLine {
      *
      * Returns over/under/push splits over the last 5/10/20/50 graded games,
      * the current streak, and the most recent game per market. Pro: full.
-     * Free: redacted.
+     * Free: redacted. `playerName` may be a name or a `player_id` like
+     * `"mlb:592450"` (see {@link searchPlayers}).
      */
     getPlayerTrends(sportKey: string, playerName: string, options?: GetPlayerTrendsOptions): Promise<PlayerTrends>;
     /**
@@ -2414,6 +2461,6 @@ declare const Bookmakers: {
     readonly PRIZEPICKS: "prizepicks";
 };
 type BookmakerKey = (typeof Bookmakers)[keyof typeof Bookmakers];
-declare const VERSION = "0.54.0";
+declare const VERSION = "0.56.0";
 
-export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
+export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };

package/dist/index.d.ts

@@ -765,6 +765,21 @@ interface ResultsResponse {
     upgrade_url?: string;
     [k: string]: unknown;
 }
+/** One match from {@link PropLine.searchPlayers}. */
+interface PlayerSearchResult {
+    /** Stable id, usable in place of a name on history/trends (e.g. `"mlb:677951"`). */
+    player_id: string;
+    name: string;
+    /** Every spelling the books use for this player. */
+    known_names: string[];
+    [k: string]: unknown;
+}
+interface PlayerSearchResponse {
+    sport_key: string;
+    search: string;
+    players: PlayerSearchResult[];
+    [k: string]: unknown;
+}
 interface PlayerHistoryEntry {
     event_id: number | string;
     commence_time: string;
@@ -779,11 +794,17 @@ interface PlayerHistoryEntry {
     over_result: "won" | "lost" | "push" | "void" | null;
     under_result: "won" | "lost" | "push" | "void" | null;
     resolved_at: string | null;
+    /** True when this line is the book's main line (not an alt-ladder rung). */
+    is_main_line?: boolean;
+    /** True when the book moved this line after the game started. */
+    line_moved_in_play?: boolean;
     redacted?: boolean;
     [k: string]: unknown;
 }
 interface PlayerHistoryResponse {
     player_name: string;
+    /** Stable player id (e.g. `"mlb:677951"`), or `null` when unknown. */
+    player_id?: string | null;
     sport_key: string;
     market: string;
     entries: PlayerHistoryEntry[];
@@ -834,6 +855,8 @@ interface PlayerMarketTrend {
 }
 interface PlayerTrends {
     player_name: string;
+    /** Stable player id (e.g. `"mlb:592450"`), or `null` when unknown. */
+    player_id?: string | null;
     sport_key: string;
     /**
      * Echo of the `dfs_odds_type` filter that scoped these trends (PrizePicks
@@ -1563,6 +1586,9 @@ interface GetStatsOptions {
 }
 interface GetResultsOptions {
     markets?: string[];
+    /** Bookmaker key(s) to restrict the response to. Omitted = all books.
+     *  An unfiltered MLB game can run several MB. */
+    bookmakers?: string | string[];
 }
 interface GetPlayerHistoryOptions {
     /** Market key (e.g. `"pitcher_strikeouts"`). Required. */
@@ -1571,6 +1597,12 @@ interface GetPlayerHistoryOptions {
     bookmaker?: string;
     /** Max entries (1-100). Default 20. */
     limit?: number;
+    /** Only each book's main line (drops alt-ladder rungs). */
+    mainLineOnly?: boolean;
+}
+interface SearchPlayersOptions {
+    /** Max players (1-100). Server default 25. */
+    limit?: number;
 }
 interface GetPlayerGamesOptions {
     /** Games to return, 1-100. Default 20. */
@@ -1990,10 +2022,24 @@ declare class PropLine {
      * Pro tier: full data. Free tier: redacted (resolution + actual nulled).
      */
     getResults(sport: string, eventId: number | string, options?: GetResultsOptions): Promise<ResultsResponse>;
+    /**
+     * Search players by name fragment and get their stable `player_id`.
+     * Free tier. Pass the id in place of a name to {@link getPlayerHistory}
+     * or {@link getPlayerTrends}.
+     *
+     * @example
+     * ```ts
+     * const res = await client.searchPlayers("baseball_mlb", "judge", { limit: 5 });
+     * for (const p of res.players) console.log(p.player_id, p.name, p.known_names);
+     * ```
+     */
+    searchPlayers(sport: string, search: string, options?: SearchPlayersOptions): Promise<PlayerSearchResponse>;
     /**
      * Recent resolved prop history for a player on a market.
      *
      * One entry per (event, bookmaker) pair. Pro: full. Free: redacted.
+     * `playerName` may be a name or a `player_id` like `"mlb:677951"`
+     * (see {@link searchPlayers}).
      */
     getPlayerHistory(sport: string, playerName: string, options: GetPlayerHistoryOptions): Promise<PlayerHistoryResponse>;
     /**
@@ -2026,7 +2072,8 @@ declare class PropLine {
      *
      * Returns over/under/push splits over the last 5/10/20/50 graded games,
      * the current streak, and the most recent game per market. Pro: full.
-     * Free: redacted.
+     * Free: redacted. `playerName` may be a name or a `player_id` like
+     * `"mlb:592450"` (see {@link searchPlayers}).
      */
     getPlayerTrends(sportKey: string, playerName: string, options?: GetPlayerTrendsOptions): Promise<PlayerTrends>;
     /**
@@ -2414,6 +2461,6 @@ declare const Bookmakers: {
     readonly PRIZEPICKS: "prizepicks";
 };
 type BookmakerKey = (typeof Bookmakers)[keyof typeof Bookmakers];
-declare const VERSION = "0.54.0";
+declare const VERSION = "0.56.0";
 
-export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
+export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };

package/dist/index.js

@@ -405,16 +405,42 @@ var PropLine = class {
     if (options.markets?.length) {
       params.markets = options.markets.join(",");
     }
+    const bookmakersParam = _bookmakersParam(options.bookmakers);
+    if (bookmakersParam !== void 0) params.bookmakers = bookmakersParam;
     return this._request(
       "GET",
       `/sports/${encodeURIComponent(sport)}/events/${encodeURIComponent(String(eventId))}/results`,
       { params }
     );
   }
+  /**
+   * Search players by name fragment and get their stable `player_id`.
+   * Free tier. Pass the id in place of a name to {@link getPlayerHistory}
+   * or {@link getPlayerTrends}.
+   *
+   * @example
+   * ```ts
+   * const res = await client.searchPlayers("baseball_mlb", "judge", { limit: 5 });
+   * for (const p of res.players) console.log(p.player_id, p.name, p.known_names);
+   * ```
+   */
+  searchPlayers(sport, search, options = {}) {
+    const params = { search };
+    if (options.limit !== void 0) {
+      params.limit = options.limit;
+    }
+    return this._request(
+      "GET",
+      `/sports/${encodeURIComponent(sport)}/players`,
+      { params }
+    );
+  }
   /**
    * Recent resolved prop history for a player on a market.
    *
    * One entry per (event, bookmaker) pair. Pro: full. Free: redacted.
+   * `playerName` may be a name or a `player_id` like `"mlb:677951"`
+   * (see {@link searchPlayers}).
    */
   getPlayerHistory(sport, playerName, options) {
     const params = {
@@ -424,6 +450,9 @@ var PropLine = class {
     if (options.bookmaker) {
       params.bookmaker = options.bookmaker;
     }
+    if (options.mainLineOnly !== void 0) {
+      params.main_line_only = options.mainLineOnly ? "true" : "false";
+    }
     return this._request(
       "GET",
       `/sports/${encodeURIComponent(sport)}/players/${encodeURIComponent(playerName)}/history`,
@@ -475,7 +504,8 @@ var PropLine = class {
    *
    * Returns over/under/push splits over the last 5/10/20/50 graded games,
    * the current streak, and the most recent game per market. Pro: full.
-   * Free: redacted.
+   * Free: redacted. `playerName` may be a name or a `player_id` like
+   * `"mlb:592450"` (see {@link searchPlayers}).
    */
   getPlayerTrends(sportKey, playerName, options = {}) {
     const params = {};
@@ -1078,7 +1108,7 @@ var Bookmakers = {
   POLYMARKET: "polymarket",
   PRIZEPICKS: "prizepicks"
 };
-var VERSION = "0.54.0";
+var VERSION = "0.56.0";
 export {
   AuthError,
   Bookmakers,