@falcongames/falcon-playable-ads-sdk 1.1.8

package/README.md

@@ -0,0 +1,272 @@
+# Falcon Playable Ads SDK
+
+A TypeScript SDK for tracking events in playable advertisements.
+
+## Installation
+
+```bash
+npm install @falcongames/falcon-playable-ads-sdk
+```
+
+## Quick Start
+
+```typescript
+import FalconPlayableSDK from "@falcongames/falcon-playable-ads-sdk";
+
+FalconPlayableSDK.initialize({
+  baseURL: "https://your-api-endpoint.com/api/message",
+  appId: "your-app-id",
+  campaignId: "your-campaign-id",
+  creativeId: "your-creative-id",
+  adNetwork: "applovin",
+  linkAndroid: "https://play.google.com/store/apps/details?id=com.example",
+  linkiOS: "https://apps.apple.com/app/id000000000",
+  debug: true,
+});
+
+// Lifecycle events
+FalconPlayableSDK.onLoaded(); // Ad finished loading
+FalconPlayableSDK.onFrame(); // First frame rendered
+FalconPlayableSDK.onInternalClick(); // User clicked inside ad
+FalconPlayableSDK.onEndGame(); // Game/ad ended
+FalconPlayableSDK.onCTA(); // User clicked CTA button
+```
+
+## Configuration
+
+| Option                  | Type    | Default | Description                                         |
+| ----------------------- | ------- | ------- | --------------------------------------------------- |
+| `baseURL`               | string  | `""`    | API endpoint for event tracking                     |
+| `appId`                 | string  | `null`  | Application identifier                              |
+| `campaignId`            | string  | `null`  | Campaign identifier                                 |
+| `creativeId`            | string  | `null`  | Creative identifier                                 |
+| `conceptId`             | string  | `null`  | Concept identifier                                  |
+| `adNetwork`             | string  | `null`  | Ad network name (e.g. `"applovin"`, `"ironsource"`) |
+| `linkAndroid`           | string  | `null`  | Google Play store URL for CTA routing               |
+| `linkiOS`               | string  | `null`  | App Store URL for CTA routing                       |
+| `debug`                 | boolean | `false` | Enable debug logging                                |
+| `autoTrackInteractions` | boolean | `true`  | Auto-track user interactions via global listener    |
+
+## Default Event Flow
+
+The SDK has a built-in event hierarchy:
+
+```
+LOADED → FRAME → INTERACTION → [custom events...]
+                                       ↓
+                                   END_GAME → CTA
+```
+
+`END_GAME` and `CTA` are **terminal nodes** — they always fire after all custom events, regardless of how deep the hierarchy is.
+
+## Custom Events
+
+### 1. Register a custom event node
+
+Use `registerPlayableEventNode` to define and register a custom event. It is automatically added to the collection — no extra step needed.
+
+```typescript
+import {
+  FalconPlayableSDK,
+  registerPlayableEventNode,
+  DefaultPlayableEventNodes,
+} from "@falcongames/falcon-playable-ads-sdk";
+
+// Default parent is INTERACTION
+const LEVEL_START = registerPlayableEventNode("level_start");
+
+// Or specify a custom parent
+const LEVEL_COMPLETE = registerPlayableEventNode("level_complete", LEVEL_START);
+```
+
+### 2. Fire a custom event
+
+```typescript
+FalconPlayableSDK.logEvent(LEVEL_START);
+FalconPlayableSDK.logEvent(LEVEL_COMPLETE);
+```
+
+### 3. Define events via SDK (registers + tracks definition)
+
+```typescript
+const levelStart = FalconPlayableSDK.defineEventNode({
+  key: "level_start",
+  parent: DefaultPlayableEventNodes.INTERACTION,
+});
+
+// Define multiple at once
+FalconPlayableSDK.defineEventNodes([
+  { key: "level_start" },
+  { key: "level_complete", parent: levelStart },
+]);
+```
+
+### 4. Inspect the event hierarchy
+
+```typescript
+const hierarchy = FalconPlayableSDK.getEventHierarchy();
+
+// hierarchy.roots — the main event tree (LOADED → ... → custom events)
+// hierarchy.terminalNode — END_GAME → CTA (detached)
+
+console.log(JSON.stringify(hierarchy, null, 2));
+```
+
+Example output:
+
+```json
+{
+  "roots": [
+    {
+      "eventId": "loaded",
+      "parentEventId": null,
+      "isDefault": true,
+      "children": [
+        {
+          "eventId": "frame",
+          "parentEventId": "loaded",
+          "isDefault": true,
+          "children": [
+            {
+              "eventId": "interaction",
+              "parentEventId": "frame",
+              "isDefault": true,
+              "children": [
+                {
+                  "eventId": "level_start",
+                  "parentEventId": "interaction",
+                  "isDefault": false,
+                  "children": []
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "terminalNode": {
+    "eventId": "end_game",
+    "parentEventId": null,
+    "isDefault": true,
+    "children": [
+      {
+        "eventId": "cta",
+        "parentEventId": "end_game",
+        "isDefault": true,
+        "children": []
+      }
+    ]
+  }
+}
+```
+
+### Circular parent detection
+
+The SDK throws an error if a circular dependency is detected when registering a node:
+
+```typescript
+const A = registerPlayableEventNode("a");
+const B = registerPlayableEventNode("b", A);
+// Error: Circular event definition detected: "a" is an ancestor of itself.
+registerPlayableEventNode("a", B);
+```
+
+## API Reference
+
+### Lifecycle Methods
+
+| Method               | Description                                                     |
+| -------------------- | --------------------------------------------------------------- |
+| `initialize(config)` | Initialize SDK — must be called first                           |
+| `onLoaded()`         | Ad finished loading                                             |
+| `onFrame()`          | First frame rendered                                            |
+| `onInternalClick()`  | User clicked inside ad (fires `pa:internal_click` window event) |
+| `onEndGame()`        | Game/ad ended                                                   |
+| `onCTA()`            | User clicked CTA — routes to store automatically                |
+| `isReady()`          | Returns `true` if SDK is initialized                            |
+| `configure(config)`  | Update configuration after initialization                       |
+| `reset()`            | Reset SDK state (for testing)                                   |
+
+### Custom Event Methods
+
+| Method                     | Description                                     |
+| -------------------------- | ----------------------------------------------- |
+| `logEvent(event)`          | Fire a custom event                             |
+| `defineEventNode(input)`   | Register a custom node definition               |
+| `defineEventNodes(inputs)` | Register multiple node definitions              |
+| `getEventDefinitions()`    | Get all registered event definitions            |
+| `getEventHierarchy()`      | Get full event tree as `PlayableEventHierarchy` |
+
+### Utility Methods
+
+| Method                              | Description                           |
+| ----------------------------------- | ------------------------------------- |
+| `dispatchGainScoreEvent(score)`     | Dispatch `pa:gain_score` window event |
+| `dispatchLoseScoreEvent(score)`     | Dispatch `pa:lose_score` window event |
+| `dispatchWinEvent()`                | Dispatch `pa:win_game` window event   |
+| `dispatchLoseEvent()`               | Dispatch `pa:lose_game` window event  |
+| `dispatchCustomEvent(type, detail)` | Dispatch any custom window event      |
+| `getVersion()`                      | Get SDK version string                |
+| `getAdNetworkInfo()`                | Get `PlayableAdsType` enum value      |
+
+### `registerPlayableEventNode(key, parent?)`
+
+```typescript
+import {
+  registerPlayableEventNode,
+  DefaultPlayableEventNodes,
+} from "@falcongames/falcon-playable-ads-sdk";
+
+// parent defaults to DefaultPlayableEventNodes.INTERACTION
+const MY_EVENT = registerPlayableEventNode("my_event");
+
+// Custom parent
+const MY_CHILD = registerPlayableEventNode("my_child", MY_EVENT);
+```
+
+### `DefaultPlayableEventNodes`
+
+```typescript
+import { DefaultPlayableEventNodes } from "@falcongames/falcon-playable-ads-sdk";
+
+DefaultPlayableEventNodes.LOADED;
+DefaultPlayableEventNodes.FRAME;
+DefaultPlayableEventNodes.INTERACTION;
+DefaultPlayableEventNodes.END_GAME;
+DefaultPlayableEventNodes.CTA;
+```
+
+## Extending with Custom HTTP Messages
+
+```typescript
+import { CSHttpMessage } from "@falcongames/falcon-playable-ads-sdk";
+
+class MyCustomMessage extends CSHttpMessage {
+  static event = "my_custom_event";
+  playerId: string = "";
+  score: number = 0;
+
+  constructor(playerId: string, score: number) {
+    super();
+    this.playerId = playerId;
+    this.score = score;
+  }
+}
+
+new MyCustomMessage("player-123", 1000).send();
+```
+
+See `src/examples/` for more examples.
+
+## Development
+
+```bash
+npm install       # Install dependencies
+npm run build     # Compile TypeScript
+npm run watch     # Watch mode
+```
+
+## License
+
+ISC

package/dist/FalconPlayableSDK.d.ts

@@ -0,0 +1,42 @@
+import { SDKConfig, SDKConfiguration, PlayableAdsType } from "./config/SDKConfig";
+import { PlayableEventDefinitionCollection, PlayableEventNodeInput, PlayableEventDefinition, PlayableEventDefinitionInput, PlayableEventHierarchyNode, PlayableEventHierarchy } from "./http_transport/playable_events/FPlayableEventManager";
+export declare class FalconPlayableSDK {
+    private static instance;
+    private isInitialized;
+    private config;
+    private referralCode;
+    setReferralCode(code: string): void;
+    getReferralCode(): string | null;
+    private constructor();
+    static getInstance(): FalconPlayableSDK;
+    initialize(config?: SDKConfig): void;
+    isReady(): boolean;
+    configure(config: SDKConfig): void;
+    onLoaded(): void;
+    onFrame(): void;
+    onInternalClick(): void;
+    onCTA(): void;
+    onEndGame(): void;
+    logEvent(event: PlayableEventNodeInput): PlayableEventHierarchyNode | null;
+    defineEventNode<T extends string>(event: PlayableEventDefinitionInput<T>): PlayableEventDefinition;
+    defineEventNodes(definitions?: Iterable<PlayableEventDefinitionInput> | PlayableEventDefinitionCollection): PlayableEventDefinition[];
+    getEventDefinitions(): PlayableEventDefinition[];
+    getEventHierarchy(): PlayableEventHierarchy;
+    dispatchGainScoreEvent(score?: number): void;
+    dispatchLoseScoreEvent(score?: number): void;
+    dispatchWinEvent(): void;
+    dispatchLoseEvent(): void;
+    dispatchCustomEvent<T>(type: string, detail?: T, options?: CustomEventInit<T>): boolean;
+    getVersion(): string;
+    getConfig(): SDKConfiguration;
+    getAdNetworkInfo(): PlayableAdsType;
+    getPlayableAdsType(): PlayableAdsType;
+    reset(): void;
+    private trackPlayable;
+    private ensureInitialized;
+    private routeToStore;
+    private notifyGameReadyToNetwork;
+    private notifyEndGameToNetwork;
+}
+export default FalconPlayableSDK;
+//# sourceMappingURL=FalconPlayableSDK.d.ts.map

package/dist/FalconPlayableSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FalconPlayableSDK.d.ts","sourceRoot":"","sources":["../src/FalconPlayableSDK.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,gBAAgB,EAEhB,eAAe,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAA8B,EAC5B,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,wDAAwD,CAAC;AAkBhE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IACzD,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,MAAM,CAAmB;IAEjC,OAAO,CAAC,YAAY,CAAuB;IAEpC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,eAAe,IAAI,MAAM,GAAG,IAAI;IAQvC,OAAO;WAOO,WAAW,IAAI,iBAAiB;IAWvC,UAAU,CACf,MAAM,GAAE,SAUP,GACA,IAAI;IA2CA,OAAO,IAAI,OAAO;IAQlB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAgBlC,QAAQ,IAAI,IAAI;IA0BhB,OAAO,IAAI,IAAI;IAQf,eAAe,IAAI,IAAI;IAQvB,KAAK,IAAI,IAAI;IAUb,SAAS,IAAI,IAAI;IAOjB,QAAQ,CACb,KAAK,EAAE,sBAAsB,GAC5B,0BAA0B,GAAG,IAAI;IAK7B,eAAe,CAAC,CAAC,SAAS,MAAM,EACrC,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACrC,uBAAuB;IAKnB,gBAAgB,CACrB,WAAW,CAAC,EACR,QAAQ,CAAC,4BAA4B,CAAC,GACtC,iCAAiC,GACpC,uBAAuB,EAAE;IAKrB,mBAAmB,IAAI,uBAAuB,EAAE;IAKhD,iBAAiB,IAAI,sBAAsB;IAK3C,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C,gBAAgB,IAAI,IAAI;IAIxB,iBAAiB,IAAI,IAAI;IAIzB,mBAAmB,CAAC,CAAC,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,OAAO;IAOH,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,gBAAgB;IAI7B,gBAAgB,IAAI,eAAe;IAMnC,kBAAkB,IAAI,eAAe;IAOrC,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,sBAAsB;CAG/B;AAED,eAAe,iBAAiB,CAAC"}

package/dist/FalconPlayableSDK.js

@@ -0,0 +1,208 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FalconPlayableSDK = void 0;
+const _1 = require(".");
+const SDKConfig_1 = require("./config/SDKConfig");
+const FPlayableEventManager_1 = __importDefault(require("./http_transport/playable_events/FPlayableEventManager"));
+const GlobalInteractionTracker_1 = __importDefault(require("./http_transport/playable_events/GlobalInteractionTracker"));
+const dispatchWindowCustomEvent_1 = __importDefault(require("./utils/dispatchWindowCustomEvent"));
+const Logger_1 = __importDefault(require("./utils/Logger"));
+const adNetworkUtils_1 = require("./adNetworkUtils");
+const storeRouter_1 = require("./storeRouter");
+class FalconPlayableSDK {
+    setReferralCode(code) {
+        this.referralCode = code;
+    }
+    getReferralCode() {
+        if (!this.referralCode) {
+            Logger_1.default.warn("ReferralCode", "Referral code is not set.");
+            return null;
+        }
+        return this.referralCode;
+    }
+    constructor() {
+        Object.defineProperty(this, "isInitialized", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "referralCode", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        this.config = SDKConfig_1.SDKConfiguration.getInstance();
+    }
+    static getInstance() {
+        if (!FalconPlayableSDK.instance) {
+            FalconPlayableSDK.instance = new FalconPlayableSDK();
+        }
+        return FalconPlayableSDK.instance;
+    }
+    initialize(config = {
+        appId: SDKConfig_1.Placeholder.APP_ID,
+        debug: true,
+        baseURL: SDKConfig_1.Placeholder.BASE_URL,
+        campaignId: SDKConfig_1.Placeholder.CAMPAIGN_ID,
+        creativeId: SDKConfig_1.Placeholder.CREATIVE_ID,
+        adNetwork: SDKConfig_1.Placeholder.AD_NETWORK,
+        linkAndroid: SDKConfig_1.Placeholder.LINK_ANDROID,
+        linkiOS: SDKConfig_1.Placeholder.LINK_IOS,
+        conceptId: SDKConfig_1.Placeholder.CONCEPT_ID,
+    }) {
+        if (this.isInitialized) {
+            Logger_1.default.warn("Init", "FalconPlayableSDK is already initialized");
+            return;
+        }
+        this.config.configure(config);
+        if (typeof window !== "undefined") {
+            window.enableLogging = this.config.adNetwork?.startsWith("{{");
+        }
+        GlobalInteractionTracker_1.default.init();
+        this.setReferralCode(FPlayableEventManager_1.default.getReferralCode() ?? "");
+        this.isInitialized = true;
+        Logger_1.default.success("Init", `SDK initialized v${_1.SDK_VERSION}`);
+        Logger_1.default.info("Config", "Current SDK configuration", {
+            baseURL: this.config.baseURL,
+            appId: this.config.appId,
+            campaignId: this.config.campaignId,
+            creativeId: this.config.creativeId,
+            conceptId: this.config.conceptId,
+            autoTrackInteractions: this.config.autoTrackInteractions,
+            adNetwork: this.config.adNetwork,
+            linkAndroid: this.config.linkAndroid,
+            linkiOS: this.config.linkiOS,
+        });
+        if (typeof window !== "undefined") {
+            window.addEventListener("tool:cta", this.onCTA.bind(this));
+            window.addEventListener("tool:end_game", this.onEndGame.bind(this));
+        }
+    }
+    isReady() {
+        return this.isInitialized;
+    }
+    configure(config) {
+        this.config.configure(config);
+        Logger_1.default.info("Config", "SDK configuration updated", config);
+    }
+    onLoaded() {
+        this.ensureInitialized();
+        FPlayableEventManager_1.default.loaded();
+        this.notifyGameReadyToNetwork();
+        this.trackPlayable("LOADED");
+    }
+    onFrame() {
+        this.ensureInitialized();
+        FPlayableEventManager_1.default.frame();
+    }
+    onInternalClick() {
+        this.ensureInitialized();
+        FPlayableEventManager_1.default.internalClick();
+    }
+    onCTA() {
+        this.ensureInitialized();
+        FPlayableEventManager_1.default.cta();
+        this.trackPlayable("CTA_CLICKED");
+        this.routeToStore();
+    }
+    onEndGame() {
+        this.ensureInitialized();
+        FPlayableEventManager_1.default.endGame();
+        this.notifyEndGameToNetwork();
+        this.trackPlayable("COMPLETED");
+    }
+    logEvent(event) {
+        this.ensureInitialized();
+        return FPlayableEventManager_1.default.logEvent(event);
+    }
+    defineEventNode(event) {
+        this.ensureInitialized();
+        return FPlayableEventManager_1.default.defineEventNode(event);
+    }
+    defineEventNodes(definitions) {
+        this.ensureInitialized();
+        return FPlayableEventManager_1.default.defineEventNodes(definitions);
+    }
+    getEventDefinitions() {
+        this.ensureInitialized();
+        return FPlayableEventManager_1.default.getEventDefinitions();
+    }
+    getEventHierarchy() {
+        this.ensureInitialized();
+        return FPlayableEventManager_1.default.getEventHierarchy();
+    }
+    dispatchGainScoreEvent(score) {
+        (0, dispatchWindowCustomEvent_1.default)("pa:gain_score", { score });
+    }
+    dispatchLoseScoreEvent(score) {
+        (0, dispatchWindowCustomEvent_1.default)("pa:lose_score", { score });
+    }
+    dispatchWinEvent() {
+        (0, dispatchWindowCustomEvent_1.default)("pa:win_game");
+    }
+    dispatchLoseEvent() {
+        (0, dispatchWindowCustomEvent_1.default)("pa:lose_game");
+    }
+    dispatchCustomEvent(type, detail, options) {
+        return (0, dispatchWindowCustomEvent_1.default)(type, detail, options);
+    }
+    getVersion() {
+        return _1.SDK_VERSION;
+    }
+    getConfig() {
+        return this.config;
+    }
+    getAdNetworkInfo() {
+        const name = (0, adNetworkUtils_1.getNormalizedAdNetwork)(this.config.adNetwork);
+        return (SDKConfig_1.AD_NETWORK_CONFIG[name]?.numericId ??
+            SDKConfig_1.PlayableAdsType.UNKNOWN);
+    }
+    getPlayableAdsType() {
+        return this.getAdNetworkInfo();
+    }
+    reset() {
+        this.isInitialized = false;
+        this.config.reset();
+        FPlayableEventManager_1.default.reset();
+        FalconPlayableSDK.instance = null;
+    }
+    trackPlayable(event) {
+        (0, storeRouter_1.trackPlayable)(event, (0, adNetworkUtils_1.getNormalizedAdNetwork)(this.config.adNetwork));
+    }
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new Error("FalconPlayableSDK is not initialized. Call initialize() first.");
+        }
+    }
+    routeToStore() {
+        const network = (0, adNetworkUtils_1.getNormalizedAdNetwork)(this.config.adNetwork);
+        const link = (0, storeRouter_1.getStoreLink)(this.config);
+        (0, storeRouter_1.routeToStore)(network, link);
+    }
+    notifyGameReadyToNetwork() {
+        (0, storeRouter_1.notifyGameReadyToNetwork)((0, adNetworkUtils_1.getNormalizedAdNetwork)(this.config.adNetwork));
+    }
+    notifyEndGameToNetwork() {
+        (0, storeRouter_1.notifyEndGameToNetwork)((0, adNetworkUtils_1.getNormalizedAdNetwork)(this.config.adNetwork));
+    }
+}
+exports.FalconPlayableSDK = FalconPlayableSDK;
+Object.defineProperty(FalconPlayableSDK, "instance", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: null
+});
+exports.default = FalconPlayableSDK;
+//# sourceMappingURL=FalconPlayableSDK.js.map

package/dist/FalconPlayableSDK.js.map

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

package/dist/adNetworkNotifier.d.ts

@@ -0,0 +1,4 @@
+export declare function trackPlayable(event: string, network: string): void;
+export declare function notifyGameReadyToNetwork(network: string): void;
+export declare function notifyEndGameToNetwork(network: string): void;
+//# sourceMappingURL=adNetworkNotifier.d.ts.map

package/dist/adNetworkNotifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adNetworkNotifier.d.ts","sourceRoot":"","sources":["../src/adNetworkNotifier.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO5D"}

package/dist/adNetworkNotifier.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackPlayable = trackPlayable;
+exports.notifyGameReadyToNetwork = notifyGameReadyToNetwork;
+exports.notifyEndGameToNetwork = notifyEndGameToNetwork;
+const SDKConfig_1 = require("./config/SDKConfig");
+function trackPlayable(event, network) {
+    if (typeof window === "undefined")
+        return;
+    if (network !== SDKConfig_1.AdNetwork.APPLOVIN)
+        return;
+    const w = window;
+    if (typeof w.ALPlayableAnalytics !== "undefined") {
+        w.ALPlayableAnalytics.trackEvent(event);
+    }
+}
+function notifyGameReadyToNetwork(network) {
+    if (typeof window === "undefined")
+        return;
+    if (network !== SDKConfig_1.AdNetwork.MINTEGRAL)
+        return;
+    const w = window;
+    if (w.gameReady) {
+        w.gameReady();
+    }
+}
+function notifyEndGameToNetwork(network) {
+    if (typeof window === "undefined")
+        return;
+    if (network !== SDKConfig_1.AdNetwork.MINTEGRAL)
+        return;
+    const w = window;
+    if (w.gameEnd) {
+        w.gameEnd();
+    }
+}
+//# sourceMappingURL=adNetworkNotifier.js.map

package/dist/adNetworkNotifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adNetworkNotifier.js","sourceRoot":"","sources":["../src/adNetworkNotifier.ts"],"names":[],"mappings":";;AAEA,sCAOC;AAED,4DAOC;AAED,wDAOC;AA3BD,kDAA+C;AAE/C,SAAgB,aAAa,CAAC,KAAa,EAAE,OAAe;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,OAAO,KAAK,qBAAS,CAAC,QAAQ;QAAE,OAAO;IAC3C,MAAM,CAAC,GAAG,MAAa,CAAC;IACxB,IAAI,OAAO,CAAC,CAAC,mBAAmB,KAAK,WAAW,EAAE,CAAC;QACjD,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,OAAe;IACtD,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,OAAO,KAAK,qBAAS,CAAC,SAAS;QAAE,OAAO;IAC5C,MAAM,CAAC,GAAG,MAAa,CAAC;IACxB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,CAAC,CAAC,SAAS,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAC,OAAe;IACpD,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,OAAO,KAAK,qBAAS,CAAC,SAAS;QAAE,OAAO;IAC5C,MAAM,CAAC,GAAG,MAAa,CAAC;IACxB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/adNetworkUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function getNormalizedAdNetwork(raw: string | null | undefined): string;
+//# sourceMappingURL=adNetworkUtils.d.ts.map

package/dist/adNetworkUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adNetworkUtils.d.ts","sourceRoot":"","sources":["../src/adNetworkUtils.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAiB7E"}

package/dist/adNetworkUtils.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNormalizedAdNetwork = getNormalizedAdNetwork;
+const SDKConfig_1 = require("./config/SDKConfig");
+function getNormalizedAdNetwork(raw) {
+    if (!raw)
+        return "";
+    const key = String(raw).trim().toLowerCase();
+    if (!key)
+        return "";
+    const numericMap = {};
+    const aliasMap = {};
+    for (const [name, cfg] of Object.entries(SDKConfig_1.AD_NETWORK_CONFIG)) {
+        numericMap[String(cfg.numericId)] = name;
+        if (cfg.aliases) {
+            for (const alias of cfg.aliases) {
+                aliasMap[alias] = name;
+            }
+        }
+    }
+    return numericMap[key] ?? aliasMap[key] ?? key;
+}
+//# sourceMappingURL=adNetworkUtils.js.map

package/dist/adNetworkUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adNetworkUtils.js","sourceRoot":"","sources":["../src/adNetworkUtils.ts"],"names":[],"mappings":";;AAEA,wDAiBC;AAnBD,kDAAuD;AAEvD,SAAgB,sBAAsB,CAAC,GAA8B;IACnE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,6BAAiB,CAAC,EAAE,CAAC;QAC5D,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;QACzC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChC,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AACjD,CAAC"}