fansunited-frontend-core 0.0.74 → 0.0.76

package/README.md

@@ -33,6 +33,7 @@ in particular **no `@mui/*` package has to be installed**.
 - Shared utilities and helper functions
 - React providers and hooks
 - Component primitives
+- Typed analytics events for tag-manager and analytics integrations
 
 ## Core Exports
 
@@ -119,6 +120,8 @@ import {
   BetslipProps,
   BetslipState,
   PredictorBetslipConfig,
+  PredictorCallbacks,
+  ComponentEvent,
 } from "fansunited-frontend-core";
 ```
 
@@ -158,6 +161,14 @@ import {
   SelectionStatus,
   OddsFormat,
   PredictorBetslipTrigger,
+
+  // Component analytics events
+  ComponentEvent,
+  ComponentEventParams,
+  PredictorComponentEvent,
+  PredictorCallbacks,
+  PredictorAnalyticsContext,
+  PredictorAnalyticsEventName,
 } from "fansunited-frontend-core";
 ```
 
@@ -354,6 +365,44 @@ function MatchCard({ eventId, market, outcome }) {
 }
 ```
 
+### Component Events Bus
+
+`componentEvents` is a singleton bus carrying analytics events emitted by the components —
+`widget_view`, `prediction_submitted`, `private_league_joined` and the rest. Use it when you cannot
+reach the component's JSX: a tag manager, a separately-bundled script, anything loading after mount.
+
+> **Important:** import `componentEvents` from `fansunited-frontend-components`, not from
+> `fansunited-frontend-core` — same reason as `betslipApi`. The components package bundles its own
+> copy of the bus, so importing from there guarantees you get the singleton the components emit on.
+> The **types** below come from core.
+
+```tsx
+import { componentEvents } from "fansunited-frontend-components";
+import type { ComponentEvent } from "fansunited-frontend-core";
+
+const unsubscribe = componentEvents.subscribe((event: ComponentEvent) => {
+  if (event.component !== "predictor") return;
+  console.log(event.name, event.params, event.context);
+});
+```
+
+`subscribe` returns an unsubscribe function. It **replays recent events** to a new subscriber (the
+last 50, within the last 5 minutes), so a listener that attaches after the component mounted still
+sees `widget_view` and anything else it missed.
+
+The bus is **subscribe-only**: there is no public emit, so nothing else on the page can forge events
+into your analytics. `ComponentEvent` is discriminated on `component` — narrow it before reading
+`name` / `context`, and code keeps compiling when more components start emitting.
+
+Payloads are flat primitives and carry **no personal data** — no profile id, email, display name or
+token; only `context.userIsLoggedIn`. Identifiers in the payloads (`match_id`, `home_team_id`, …) are
+canonical and provider-agnostic, so they are the fields to join on; team *names* are localised by the
+`language` prop and are for display only.
+
+Emitting components: `Predictor` today. See the `Predictor` section of the
+[`fansunited-frontend-components` README](https://www.npmjs.com/package/fansunited-frontend-components)
+for the full event catalogue and the tag-manager setup.
+
 ## Call-to-Action (CTA) Interfaces
 
 The package provides several CTA interfaces for different use cases:

package/api/componentEvents.d.ts

@@ -0,0 +1,17 @@
+import { ComponentEvent } from '../interfaces/interfaces';
+
+type Listener = (event: ComponentEvent) => void;
+/** What consumers get. Deliberately read-only — see `componentEventsEmitter`. */
+export interface ComponentEventsApi {
+    /** Observe every component event. Returns an unsubscribe function. */
+    subscribe(listener: Listener): () => void;
+}
+/** @internal Emit side, for the component packages only. Never expose this on a global. */
+export interface ComponentEventsEmitter {
+    emit(event: ComponentEvent): void;
+}
+export declare const componentEvents: ComponentEventsApi;
+/** @internal Not re-exported from `fansunited-frontend-components`. */
+export declare const componentEventsEmitter: ComponentEventsEmitter;
+export {};
+//# sourceMappingURL=componentEvents.d.ts.map

package/api/componentEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentEvents.d.ts","sourceRoot":"","sources":["../../src/api/componentEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAahD,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAC3C;AAED,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACnC;AA8DD,eAAO,MAAM,eAAe,EAAE,kBAAwB,CAAC;AAEvD,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,sBAA4B,CAAC"}

package/index.d.ts

@@ -2,6 +2,8 @@ export declare const version: string;
 export * from './constants/constants';
 export { betslipApi } from './api/betslipApi';
 export type { BetslipState } from './api/betslipApi';
+export { componentEvents, componentEventsEmitter } from './api/componentEvents';
+export type { ComponentEventsApi, ComponentEventsEmitter, } from './api/componentEvents';
 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":"AACA,eAAO,MAAM,OAAO,EAAE,MAAyB,CAAC;AAEhD,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,uEAAuE,CAAC;AAC9H,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,oEAAoE,CAAC;AACxH,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAClH,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AACrH,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AACzG,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAC/G,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,qEAAqE,CAAC;AAC3H,OAAO,EAAE,OAAO,IAAI,gCAAgC,EAAE,MAAM,4EAA4E,CAAC;AACzI,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mEAAmE,CAAC;AACxH,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAC/G,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AACrH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,yDAAyD,CAAC;AACjH,YAAY,EAAE,gCAAgC,EAAE,MAAM,yDAAyD,CAAC;AAChH,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AAC3G,YAAY,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAC1G,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AAC/G,YAAY,EAAE,+BAA+B,EAAE,MAAM,wDAAwD,CAAC;AAC9G,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AACtG,YAAY,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AACrG,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACxE,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,uCAAuC,CAAC"}