feat: add optional teamSide + marketSegment to odds/EV/closing types (#76, #689)

Surfaces the structured side + segment axes the API now emits (sharp-api-go
#76 Phase C / #689). NormalizedOdds + EVOpportunity gain optional teamSide +
marketSegment; ClosingOdd gains snake_case team_side + market_segment (matching
that endpoint's wire). selectionType/selection_type unions widen with
(string & {}) so any server value is accepted without a major bump; compound
team-total literals intentionally retained. Additive, non-breaking.

Bump 0.3.2 → 0.3.3.

Type: feat

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: paperclip-resolver[bot]

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@sharp-api/client` are documented here.
 
+## 0.3.3 — 2026-06-02
+
+### Added — structured `teamSide` + `marketSegment` (issue #76 / #689)
+
+- `NormalizedOdds` and `EVOpportunity` gain optional `teamSide`
+  (`'home' | 'away' | 'draw' | 'over' | 'under'`) and `marketSegment` (`string`);
+  `ClosingOdd` gains the snake_case `team_side` + `market_segment` (matching that
+  endpoint's wire casing).
+- `teamSide` is the raw structured side decomposed out of the compound
+  `selectionType` vocabulary — prefer it over parsing compound prefixes like
+  `'home_over'`. `marketSegment` is the canonical contest slice.
+- Additive, optional, non-breaking. The `selectionType` / `selection_type`
+  unions now also admit `(string & {})` so they accept any server value without
+  a major bump; the compound team-total literals were intentionally **not**
+  removed.
+
 ## 0.3.2 — 2026-05-07
 
 ### Changed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharp-api/client",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Official TypeScript/JavaScript client for the SharpAPI real-time sports betting odds API",
   "type": "module",
   "main": "./dist/index.cjs",

src/index.ts

@@ -301,6 +301,16 @@ export interface NormalizedOdds extends NestedRefs {
     | 'home_draw'
     | 'away_draw'
     | 'home_away'
+    | (string & {})
+  /**
+   * Raw structured side axis ("home" | "away" | "draw") decomposed out of the
+   * compound selectionType vocabulary (issue #76). Optional + additive — absent
+   * when the adapter didn't stamp it. Prefer this over parsing compound
+   * selectionType prefixes (e.g. "home_over").
+   */
+  teamSide?: 'home' | 'away' | 'draw' | 'over' | 'under'
+  /** Canonical contest slice ("full_game" | "1st_half" | ...) — issue #689. */
+  marketSegment?: string
   odds: OddsValue
   line?: number
   eventStartTime: string
@@ -324,6 +334,10 @@ export interface EVOpportunity extends NestedRefs {
   fairProbability: number
   evPercentage: number
   kellyPercent: number
+  /** Raw structured side axis ("home" | "away" | "draw") — issue #76. Optional + additive. */
+  teamSide?: 'home' | 'away' | 'draw' | 'over' | 'under'
+  /** Canonical contest slice ("full_game" | "1st_half" | ...) — issue #689. */
+  marketSegment?: string
   detectedAt: string
 }
 
@@ -538,6 +552,10 @@ export interface ClosingOdd {
     | 'away_draw'
     | 'home_away'
     | (string & {})
+  /** Raw structured side axis ("home" | "away" | "draw") — issue #76. Optional + additive. */
+  team_side?: 'home' | 'away' | 'draw' | 'over' | 'under'
+  /** Canonical contest slice ("full_game" | "1st_half" | ...) — issue #689. */
+  market_segment?: string
   odds_american: number
   odds_decimal: number
   /** Spread / total line — present only on point-spread and totals markets. */