@sensiblestats/widget-react 0.89.0 → 0.90.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @sensiblestats/widget-react
 
+## 0.90.0
+
+### Minor Changes
+
+- NBA bettor cards: renders the `nba_insight` event (prop reason, ladder, teammate out, co-hit, line move) in EN and
+  TR, and advertises the `nba_insight` client capability. An NBA price is an "Add to slip" button only when the new
+  `slipSports` config includes `'basketball'`. The slip is keyed by sport plus id, and `host.slipRemoved` /
+  `host.betPlaced` accept `sport`.
+
+### Patch Changes
+
+- Updated dependencies
+  - @sensiblestats/widget-sdk@0.60.0
+
 ## 0.89.0
 
 ### Minor Changes

package/README.md

@@ -53,11 +53,16 @@ export const widgetHost = createWidgetHost()
 ```
 
 ```tsx
+// Module scope too: a new function or array on every render makes the widget rebuild its slip handling.
+const addToMySlip = (selection: SlipSelection) => mySlip.add(selection)
+const SLIP_SPORTS = ['basketball'] as const
+
 <StatsWidget
   host={widgetHost}
   config={{
     ...config,
-    onAddToSlip: (selection) => addToMySlip(selection),
+    onAddToSlip: addToMySlip,
+    slipSports: SLIP_SPORTS,
   }}
 />
 ```
@@ -66,22 +71,33 @@ export const widgetHost = createWidgetHost()
 widgetHost.slipRemoved({ matchOddsId })                  // a leg left your slip
 widgetHost.betPlaced({ selections: [{ matchOddsId }] })  // the bet was placed
 widgetHost.matchOpened({ matchId })                      // your match page opened
+
+// an NBA leg also carries sport; the type is { matchOddsId: number; sport?: 'basketball' }
+widgetHost.slipRemoved({ matchOddsId, sport: 'basketball' })
+widgetHost.betPlaced({ selections: [{ matchOddsId, sport: 'basketball' }] })
 ```
 
 What each one does:
 
-- `onAddToSlip`. Called when the user taps "Add to slip", with `{ matchOddsId, matchId, oddsDecimal }`.
+- `onAddToSlip`. Called when the user taps "Add to slip", with `{ matchOddsId, matchId, oddsDecimal, sport? }`, where `sport` is the optional `'basketball'`.
   Add that selection to your slip. Return nothing, or a result such as `{ status: 'added' }`,
   `{ status: 'duplicate' }` or `{ status: 'rejected', reason }`. The widget shows "In slip" for an
   added or duplicate selection. Answer within 10 seconds. Without a `host`, an "In slip" button
   stays that way until the page reloads; with one, `slipRemoved` and `betPlaced` clear it.
+- `slipSports`. Sports your `onAddToSlip` understands beyond football. An NBA price is an "Add to
+  slip" button only when all three hold: the card arrives with the slip enabled for your operator
+  account (`addToSlipEnabled`), you set `onAddToSlip`, and `slipSports` includes `'basketball'`.
+  Otherwise the price is plain text. The selection then carries `sport: 'basketball'`, so branch on
+  it: a basketball id can equal a football id. Keep `onAddToSlip` and `slipSports` referentially
+  stable, a module-level constant or a memoised value. The widget rebuilds its slip handling
+  whenever either changes identity, and an inline function or array literal changes it every render.
 - `onOpenMatch` (deprecated). Ignored since 0.72.1: the widget no longer opens matches from any
   surface, so team names are plain text and this is never called. It stays in the config type so
   existing hosts still compile.
 - `slipRemoved`. Clears the widget's "In slip" mark for that selection. Call it whenever a leg
   leaves your slip for any reason, a "clear all" included. A leg the widget still believes is in
   the slip can be reported as bet later.
-- `betPlaced`. Pass every leg of the bet. The widget reports the legs it added itself, at most 25
+- `betPlaced`. Pass every leg of the bet, with the leg's `sport` when you got one. The widget reports the legs it added itself, at most 25
   per call, and ignores the rest, so you do not filter.
 - `matchOpened`. Call it from your match page. A view counts only for a visitor who has opened the
   widget in that tab, and at most once per match every 30 minutes.
@@ -90,6 +106,9 @@ Rules for the three host methods:
 
 - `matchOddsId` and `matchId` are the numbers `onAddToSlip` gave you. Anything that is not a
   positive integer is ignored, a numeric string included.
+- `sport` is optional and only ever `'basketball'`. A football selection omits it, so existing
+  integrations are unchanged. Echo it back on `slipRemoved` and `betPlaced` for an NBA leg: a basketball
+  id and a football id can be equal, and `sport` tells the widget which row to clear.
 - No method throws, and each is safe to call twice.
 - A call made while no widget is mounted is queued, the last 20, and replayed when one mounts. The
   queue lives in the page, so it does not survive a full page load.