fansunited-frontend-core 0.0.52 → 0.0.53

package/README.md

@@ -98,6 +98,7 @@ import {
   BetslipOutcomeLabels,
   BetslipLabels,
   BetslipProps,
+  BetslipState,
   PredictorBetslipConfig,
 } from "fansunited-frontend-core";
 ```
@@ -268,8 +269,10 @@ initializeI18n("en");
 
 `betslipApi` is a singleton command bus that lets any code — including code that runs **before the `<Betslip />` widget mounts** — add or remove selections programmatically. Pre-mount calls are queued and replayed automatically once the widget registers.
 
+> **Important:** Always import `betslipApi` from `fansunited-frontend-components`, not from `fansunited-frontend-core`. The Betslip widget bundles its own copy of the command bus; importing from the components package guarantees you use the same singleton instance the widget is listening on.
+
 ```tsx
-import { betslipApi } from "fansunited-frontend-core";
+import { betslipApi } from "fansunited-frontend-components";
 
 // Add a selection. If the same eventId + market already exists, the outcome is replaced.
 betslipApi.setSelection("fb:m:451678:FT_1X2:1");
@@ -280,6 +283,38 @@ betslipApi.removeSelection("fb:m:451678:FT_1X2:1");
 
 **Selection ID format:** `"{eventId}:{market}:{outcome}"`, for example `"fb:m:451678:FT_1X2:1"`.
 
+#### Reading betslip state
+
+`betslipApi` also exposes the current betslip state through a snapshot accessor and a reactive subscription:
+
+```tsx
+import { betslipApi } from "fansunited-frontend-components";
+import type { BetslipState } from "fansunited-frontend-components";
+
+// One-shot snapshot — returns the last known state immediately
+const { selections, stake, totalOdds } = betslipApi.getState();
+
+// Reactive subscription — fires whenever selections, stake, or odds change
+const unsubscribe = betslipApi.subscribe((state: BetslipState) => {
+  console.log("selections:", state.selections.length);
+  console.log("stake:", state.stake);
+  console.log("totalOdds:", state.totalOdds);
+});
+
+// Call unsubscribe() to stop receiving updates
+unsubscribe();
+```
+
+**`BetslipState` shape:**
+
+```ts
+interface BetslipState {
+  selections: BetslipSelectionInput[]; // current raw selections
+  stake: number;                        // parsed numeric stake (0 when empty)
+  totalOdds: number;                    // product of all selection decimal odds (0 when no selections)
+}
+```
+
 The typical integration pattern is:
 
 ```tsx
@@ -287,9 +322,9 @@ The typical integration pattern is:
 <Betslip sdk={sdk} language="en" />
 
 // 2. From anywhere in your app — e.g. a match card — call betslipApi
-import { betslipApi } from "fansunited-frontend-core";
+import { betslipApi } from "fansunited-frontend-components";
 
-function MatchCard({ eventId, market, outcome, participantOne, participantTwo }) {
+function MatchCard({ eventId, market, outcome }) {
   const selectionId = `${eventId}:${market}:${outcome}`;
 
   return (

package/api/betslipApi.d.ts

@@ -1,10 +1,21 @@
+import { BetslipSelectionInput } from '../interfaces/interfaces';
+
+export interface BetslipState {
+    selections: BetslipSelectionInput[];
+    stake: number;
+    totalOdds: number;
+}
 interface BetslipApi {
     /** Upsert a selection. If the same eventId + market already exists, the outcome is replaced. */
     setSelection(id: string): void;
     /** Remove a selection by its exact id ("eventId:market:outcome"). No-op if not present. */
     removeSelection(id: string): void;
+    /** Returns a snapshot of the current betslip state. */
+    getState(): BetslipState;
+    /** Subscribe to state changes. Returns an unsubscribe function. */
+    subscribe(listener: (state: BetslipState) => void): () => void;
 }
-type Handler = BetslipApi;
+type Handler = Pick<BetslipApi, "setSelection" | "removeSelection">;
 /**
  * Singleton command bus. BetslipShell registers its internal state handlers on mount
  * (_mount) and clears them on unmount (_unmount). Calls made before mount are queued
@@ -14,12 +25,18 @@ type Handler = BetslipApi;
 declare class BetslipBus implements BetslipApi {
     private handler;
     private queue;
+    private listeners;
+    private lastState;
     /** Called by BetslipShell on mount. Replays any queued pre-mount calls. */
     _mount(h: Handler): void;
     /** Called by BetslipShell on unmount. */
     _unmount(): void;
+    /** Called by BetslipStateBridge whenever context state changes. */
+    _notify(state: BetslipState): void;
     setSelection(id: string): void;
     removeSelection(id: string): void;
+    getState(): BetslipState;
+    subscribe(listener: (state: BetslipState) => void): () => void;
 }
 export declare const betslipApi: BetslipBus;
 export {};

package/api/betslipApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"betslipApi.d.ts","sourceRoot":"","sources":["../../src/api/betslipApi.ts"],"names":[],"mappings":"AAAA,UAAU,UAAU;IAClB,gGAAgG;IAChG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,KAAK,OAAO,GAAG,UAAU,CAAC;AAE1B;;;;;GAKG;AACH,cAAM,UAAW,YAAW,UAAU;IACpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAAyB;IAEtC,2EAA2E;IAC3E,MAAM,CAAC,CAAC,EAAE,OAAO;IAMjB,yCAAyC;IACzC,QAAQ;IAIR,YAAY,CAAC,EAAE,EAAE,MAAM;IAMvB,eAAe,CAAC,EAAE,EAAE,MAAM;CAG3B;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"betslipApi.d.ts","sourceRoot":"","sources":["../../src/api/betslipApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,gGAAgG;IAChG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uDAAuD;IACvD,QAAQ,IAAI,YAAY,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAChE;AAED,KAAK,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,cAAM,UAAW,YAAW,UAAU;IACpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAiD;IAClE,OAAO,CAAC,SAAS,CAA4D;IAE7E,2EAA2E;IAC3E,MAAM,CAAC,CAAC,EAAE,OAAO;IAMjB,yCAAyC;IACzC,QAAQ;IAIR,mEAAmE;IACnE,OAAO,CAAC,KAAK,EAAE,YAAY;IAK3B,YAAY,CAAC,EAAE,EAAE,MAAM;IAMvB,eAAe,CAAC,EAAE,EAAE,MAAM;IAI1B,QAAQ,IAAI,YAAY;IAIxB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;CAI/D;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/index.d.ts

@@ -1,6 +1,7 @@
 export declare const version: string;
 export * from './constants/constants';
 export { betslipApi } from './api/betslipApi';
+export type { BetslipState } from './api/betslipApi';
 export * from './functions/functions';
 export * from './interfaces/interfaces';
 export * from './types/types';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}