fansunited-frontend-components 0.0.85 → 0.0.86

package/Predictor.js

@@ -1,4 +1,4 @@
-import { P as e } from "./chunks/Predictor-swx1IhLo.js";
+import { P as e } from "./chunks/Predictor-C3Kr_dEA.js";
 export {
   e as Predictor
 };

package/README.md

@@ -3722,6 +3722,7 @@ Football score predictor component with two templates: the default **multi-tab**
 - Consent management with required/optional consent gates before predicting
 - Customisable banners in 6 positions within the Play tab (`"standard"` only)
 - Authentication-aware UI with configurable sign-in CTA
+- Opt-in betting odds on the match cards (`showOdds`), pinned to one operator with `operatorId` — see [Predictor Odds](#predictor-odds)
 - Built-in Betslip integration — renders the Betslip widget automatically via the `betslip` prop with two trigger modes
 - Custom theming and multi-language support
 
@@ -3748,6 +3749,8 @@ Football score predictor component with two templates: the default **multi-tab**
 | `playTabBanners`              | `PlayTabBanner[]`        | Custom banners rendered in the Play tab. Ignored by `"embed"`                                     |
 | `consents`                    | `ConsentDef[]`           | Consent definitions required before predicting                                                    |
 | `matchCardBgImageUrl`         | `string`                 | Background image URL for match prediction cards. Ignored by `"embed"`                             |
+| `showOdds`                    | `boolean`                | Render betting odds on the match cards (default: false). While false the odds request is skipped, so an `"odds-only"` betslip needs this set |
+| `operatorId`                  | `string`                 | Operator config id to show odds from, e.g. `"betano-bg"`. Unset, each match shows the first operator listed. Falls back to `betslip.operatorId`, and the Betslip falls back to it |
 | `betslip`                     | `PredictorBetslipConfig` | Betslip integration config. Omit to disable. See [Betslip Integration](#betslip-integration)      |
 | `callbacks`                   | `PredictorCallbacks`     | `onEvent` — one observer for every journey event the component emits. See [Analytics](#analytics)  |
 
@@ -3992,6 +3995,27 @@ const consents: ConsentDef[] = [
 - Optional consents are shown in the same modal but do not block progression
 - Once accepted, consents are stored and the modal does not reappear
 
+#### Predictor Odds
+
+Odds are off by default. With `showOdds` set, each upcoming match card shows full-time 1X2 odds from one operator, refreshed while a match is live — in the Play tab, the `embed` card and a league member's predictions. Odds fail silently: when the odds API has no prices for a match, the card simply shows none.
+
+- **`showOdds`** — while it is false (the default) the odds request is skipped altogether. A betslip with `trigger: "odds-only"` is fed by clicking those odds, so that trigger needs `showOdds` set.
+- **`operatorId`** pins the odds to one operator. It is sent to the odds request as the SDK's `operators` filter, so the response is narrowed server-side. Without it, each match shows whichever operator the response lists first, which is not guaranteed to stay the same. A match the chosen operator doesn't price shows no odds; it does not fall back to another operator.
+
+```tsx
+<Predictor entityId="..." sdk={sdk} language="en" showOdds operatorId="betano-bg" />
+```
+
+`operatorId` and `betslip.operatorId` resolve against each other, so the card and the betslip show the same operator unless you set both to different values:
+
+| You set              | Card odds            | Betslip              |
+| -------------------- | -------------------- | -------------------- |
+| `operatorId`         | `operatorId`         | `operatorId`         |
+| `betslip.operatorId` | `betslip.operatorId` | `betslip.operatorId` |
+| Both                 | `operatorId`         | `betslip.operatorId` |
+
+See [Choosing a Bookmaker](#choosing-a-bookmaker) for the list of available operator ids.
+
 #### Betslip Integration
 
 When the `betslip` prop is provided, the Predictor automatically renders a `Betslip` widget as a sibling alongside its own UI — you do not need to add a separate `<Betslip />` component to the page. The widget is configured entirely through `PredictorBetslipConfig`.
@@ -4023,7 +4047,7 @@ const betslipConfig: PredictorBetslipConfig = {
 | `currency`            | `string`                  | `"€"`                | Currency symbol                                                                           |
 | `ctaUrlTemplate`      | `string`                  | —                    | Bookmaker deep-link URL with `{placeholder}` substitution                                 |
 | `brandingLogoUrl`     | `string`                  | —                    | Operator logo URL                                                                         |
-| `operatorId`          | `string`                  | —                    | Operator config id the Betslip requests odds for, e.g. `"betano-bg"`                      |
+| `operatorId`          | `string`                  | —                    | Operator config id the Betslip requests odds for, e.g. `"betano-bg"`. Falls back to the top-level `operatorId` |
 | `affiliateId`         | `string`                  | —                    | Affiliate id substituted into the operator's URLs                                         |
 | `labels`              | `BetslipLabels`           | —                    | UI text overrides                                                                         |
 | `themeOptions`        | `CustomThemeOptions`      | —                    | Theme for the Betslip widget. Falls back to the Predictor's `themeOptions` when omitted   |
@@ -4039,7 +4063,7 @@ type PredictorBetslipTrigger =
 | Mode                  | When selections are sent                                                                                                                                                                                                                       |
 | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `"predictions-only"`  | Every time the user edits a score (home/away increment or decrement). If the user submits without editing (e.g. a default 0:0), the selection is sent at submit time as a fallback. Derived outcome: `"1"` (home win), `"X"` (draw), `"2"` (away win). |
-| `"odds-only"`         | Only when the user clicks an odds button on the post-submit odds display. The odds button becomes a command-bus trigger instead of a direct bookmaker link.                                                                                     |
+| `"odds-only"`         | Only when the user clicks an odds button on the post-submit odds display. The odds button becomes a command-bus trigger instead of a direct bookmaker link. Requires `showOdds`.                                                                 |
 
 **Selection format sent by Predictor:**
 
@@ -4241,6 +4265,7 @@ Selections are sent only when the user explicitly clicks an odds button on the p
   sdk={sdkInstance}
   language="en"
   userIsLoggedIn={true}
+  showOdds={true}
   betslip={{
     trigger: "odds-only",
     position: "bottom-right",
@@ -4294,6 +4319,7 @@ Full-featured competitive picks predictor component with a multi-tab interface f
 - Consent management with required/optional consent gates before predicting
 - Customisable banners in the Play tab
 - Authentication-aware UI with configurable sign-in CTA
+- Opt-in betting odds on the match cards (`showOdds`), pinned to one operator with `operatorId` — see [TopX Odds](#topx-odds)
 - Built-in Betslip integration via the `betslip` prop
 - Custom theming and multi-language support
 
@@ -4317,6 +4343,8 @@ Full-featured competitive picks predictor component with a multi-tab interface f
 | `playTabBanners`             | `PlayTabBanner[]`      | —              | Custom banners rendered in the Play tab             |
 | `consents`                   | `ConsentDef[]`         | —              | Consent definitions required before predicting      |
 | `matchCardBgImageUrl`        | `string`               | —              | Background image URL for match prediction cards     |
+| `showOdds`                   | `boolean`              | `false`        | Render betting odds on the match cards. While false the odds request is skipped, so an `"odds-only"` betslip needs this set |
+| `operatorId`                 | `string`               | —              | Operator config id to show odds from, e.g. `"betano-bg"`. Unset, each match shows the first operator listed. Falls back to `betslip.operatorId`, and the Betslip falls back to it |
 | `betslip`                    | `TopXBetslipConfig`    | —              | Betslip integration config. Omit to disable.        |
 | `showCountdown`              | `boolean`              | `true`         | Show predictions-close countdown timer on open games |
 | `gameNavLabel`               | `TopXGameNavLabel`     | `"gameWeek"`   | Controls how each game is labelled in the navigation. See [Game Navigation Label](#game-navigation-label) |
@@ -4457,6 +4485,27 @@ const consents: ConsentDef[] = [
 <TopX {...otherProps} consents={consents} />;
 ```
 
+#### TopX Odds
+
+Odds are off by default. With `showOdds` set, each upcoming match card shows full-time 1X2 odds from one operator, refreshed while a match is live — in the Play tab and in a league member's predictions. Odds fail silently: when the odds API has no prices for a match, the card simply shows none.
+
+- **`showOdds`** — while it is false (the default) the odds request is skipped altogether. A betslip with `trigger: "odds-only"` is fed by clicking those odds, so that trigger needs `showOdds` set.
+- **`operatorId`** pins the odds to one operator. It is sent to the odds request as the SDK's `operators` filter, so the response is narrowed server-side. Without it, each match shows whichever operator the response lists first, which is not guaranteed to stay the same. A match the chosen operator doesn't price shows no odds; it does not fall back to another operator.
+
+```tsx
+<TopX entityId="..." sdk={sdk} language="en" showOdds operatorId="betano-bg" />
+```
+
+`operatorId` and `betslip.operatorId` resolve against each other, so the card and the betslip show the same operator unless you set both to different values:
+
+| You set              | Card odds            | Betslip              |
+| -------------------- | -------------------- | -------------------- |
+| `operatorId`         | `operatorId`         | `operatorId`         |
+| `betslip.operatorId` | `betslip.operatorId` | `betslip.operatorId` |
+| Both                 | `operatorId`         | `betslip.operatorId` |
+
+See [Choosing a Bookmaker](#choosing-a-bookmaker) for the list of available operator ids.
+
 #### Betslip Integration
 
 When the `betslip` prop is provided, the TopX component renders a `Betslip` widget alongside its own UI — no separate `<Betslip />` component is needed.
@@ -4488,7 +4537,7 @@ const betslipConfig: TopXBetslipConfig = {
 | `currency`            | `string`               | `"€"`            | Currency symbol                                                           |
 | `ctaUrlTemplate`      | `string`               | —                | Bookmaker deep-link URL with `{placeholder}` substitution                 |
 | `brandingLogoUrl`     | `string`               | —                | Operator logo URL                                                         |
-| `operatorId`          | `string`               | —                | Operator config id the Betslip requests odds for, e.g. `"betano-bg"`      |
+| `operatorId`          | `string`               | —                | Operator config id the Betslip requests odds for, e.g. `"betano-bg"`. Falls back to the top-level `operatorId` |
 | `affiliateId`         | `string`               | —                | Affiliate id substituted into the operator's URLs                         |
 | `labels`              | `BetslipLabels`        | —                | UI text overrides                                                         |
 | `themeOptions`        | `CustomThemeOptions`   | —                | Theme for the Betslip widget. Falls back to the TopX `themeOptions` when omitted |
@@ -4803,7 +4852,7 @@ import { Predictor } from "fansunited-frontend-components";
 | Mode                  | When selections are sent to Betslip                                               |
 | --------------------- | --------------------------------------------------------------------------------- |
 | `"predictions-only"`  | Each time the user changes a score prediction (before submitting)                 |
-| `"odds-only"`         | When the user clicks an odds button on the post-submit odds view                  |
+| `"odds-only"`         | When the user clicks an odds button on the post-submit odds view (requires `showOdds`) |
 
 #### The CTA Link
 
@@ -4855,6 +4904,8 @@ It is passed to the odds request as the SDK's `operators` filter, so the respons
 
 Everything the Betslip derives from the bookmaker follows — the odds themselves, the accent color, the header and CTA logo, and the deep links. Markets the chosen bookmaker does not price are dropped from the Betslip (see the odds behavior notes below), and if it prices nothing in the betslip, the panel stays hidden.
 
+Inside `Predictor` or `TopX` you don't need to set it twice: the component's top-level `operatorId` also pins the Betslip, unless `betslip.operatorId` says otherwise. See [Predictor Odds](#predictor-odds).
+
 **Available operator ids:**
 
 ```
@@ -5284,7 +5335,8 @@ A single-event card — a competition header over the two competitors and their
 | `showStandings`   | `boolean`                | `type="detailed"` only. Show the **Table** (standings) tab. Defaults to `true` |
 | `showHeadToHead`  | `boolean`                | `type="detailed"` only. Show the **H2H** tab. Defaults to `true`             |
 | `defaultSection`  | `"preview" \| "summary" \| "stats" \| "lineups" \| "table" \| "h2h"` | `type="detailed"` only. Which tab opens first. Defaults to the first tab of the event's status |
-| `showOdds`        | `boolean`                | Render betting odds. Defaults to `true` — not yet backed by the API, so currently renders nothing |
+| `showOdds`        | `boolean`                | Render betting odds. Defaults to `false` — not yet backed by the API, so currently renders nothing |
+| `operatorId`      | `string`                 | Operator config id to show odds from, e.g. `"betano-bg"`. Not yet backed by the API, like `showOdds` |
 | `liveRefresh`     | `boolean`                | Poll while the event is `LIVE`. Defaults to `true`                           |
 | `refreshInterval` | `number`                 | Live-refresh interval in ms. Defaults to `30000` (30s)                       |
 | `userIsLoggedIn`  | `boolean`                | Whether the visitor is signed in. Required for predictions. Defaults to `false` |