web-sdk-wrapper 2.0.0

package/dist/web-sdk-wrapper.umd.cjs

@@ -0,0 +1,7 @@
+(function(o,r){typeof exports=="object"&&typeof module<"u"?r(exports):typeof define=="function"&&define.amd?define(["exports"],r):(o=typeof globalThis<"u"?globalThis:o||self,r(o.WebSdkWrapper={}))})(this,(function(o){"use strict";var x=Object.defineProperty;var I=(o,r,c)=>r in o?x(o,r,{enumerable:!0,configurable:!0,writable:!0,value:c}):o[r]=c;var t=(o,r,c)=>I(o,typeof r!="symbol"?r+"":r,c);class r{constructor(){t(this,"name","Unknown");t(this,"capabilities",{ads:!1,interstitialAds:!1,rewardedAds:!1,bannerAds:!1,accounts:!1,tokens:!1});t(this,"scriptSources",[]);t(this,"requiresProduction",!1);t(this,"_sdk",null);t(this,"_gameplayStarted",!1)}async preInit(e){}async init(e){}onLoadingStart(){}onLoadingEnd(){}maybeGameplayStart(){this._gameplayStarted||(this._gameplayStarted=!0,this.onGameplayStart())}maybeGameplayStop(){this._gameplayStarted&&(this._gameplayStarted=!1,this.onGameplayStop())}onGameplayStart(){}onGameplayStop(){}onLevelStart(e){}onReplayLevel(e){}async showInterstitial(){return!1}async showRewarded(e){return!0}login(){return Promise.reject(new Error("Accounts not supported"))}getUser(){return Promise.resolve(null)}getToken(){return Promise.resolve(null)}trackEvent(e,a,n){}openExternalLink(e){window.open(e,"_blank")}}class c extends r{constructor(){super(...arguments);t(this,"name","Poki");t(this,"capabilities",{ads:!0,interstitialAds:!0,rewardedAds:!0,bannerAds:!1,accounts:!0,tokens:!0});t(this,"scriptSources",["https://game-cdn.poki.com/scripts/v2/poki-sdk.js"]);t(this,"requiresProduction",!1);t(this,"_lastBeaconTime",0);t(this,"_maxBeacons",6);t(this,"_beaconInterval",60);t(this,"_gameId",null);t(this,"_doBeacon",!1)}_beacon(a){if(!this._gameId||!this._doBeacon)return;const n=Date.now();n-this._lastBeaconTime<this._beaconInterval*1e3||this._maxBeacons<=0||(this._lastBeaconTime=n,this._maxBeacons--,navigator.sendBeacon(`https://leveldata.poki.io/${a}`,this._gameId))}async init(a){this._sdk=globalThis.PokiSDK,this._sdk.setDebug(a.debug),await this._sdk.init().catch(()=>{});const n=a.data||{};this._gameId=n.poki_gameId,this._doBeacon=n.poki_doBeacon,this._maxBeacons=n.poki_maxBeacons||6,this._beaconInterval=n.poki_beaconInterval||60}onLoadingStart(){this._sdk.gameLoadingStart()}onLoadingEnd(){this._sdk.gameLoadingFinished(),this._beacon("loadingEnd")}onGameplayStart(){this._beacon("gameplayStart"),this._sdk.gameplayStart()}onGameplayStop(){this._beacon("gameplayStop"),this._sdk.gameplayStop()}async showInterstitial(){return this._beacon("interstitial"),await this._sdk.commercialBreak(),!0}async showRewarded(a="small"){return this._beacon("rewarded"),await this._sdk.rewardedBreak({size:a})}login(){return this._sdk.login()}getUser(){return this._sdk.getUser()}getToken(){return this._sdk.getToken()}trackEvent(a,n,i){this._beacon(`${a}_${n}`),this._sdk.measure(a,n,i)}openExternalLink(a){this._sdk&&this._sdk.openExternalLink?this._sdk.openExternalLink(a):super.openExternalLink(a)}}class _ extends r{constructor(){super(...arguments);t(this,"name","CrazyGames");t(this,"capabilities",{ads:!0,interstitialAds:!0,rewardedAds:!0,bannerAds:!0,accounts:!1,tokens:!1});t(this,"scriptSources",["https://sdk.crazygames.com/crazygames-sdk-v1.js"]);t(this,"requiresProduction",!1);t(this,"_lastRequestedAd",null);t(this,"_adResolve",null)}async init(a){var n,i;this._sdk=(i=(n=globalThis==null?void 0:globalThis.CrazyGames)==null?void 0:n.CrazySDK)==null?void 0:i.getInstance(),await new Promise(d=>{this._sdk.addEventListener("adblockDetectionExecuted",()=>{d()}),this._sdk.init()}),this._sdk.addEventListener("adFinished",()=>{this._adResolve&&(this._adResolve(!0),this._adResolve=null)}),this._sdk.addEventListener("adError",()=>{this._adResolve&&(this._adResolve(!1),this._adResolve=null)})}onGameplayStart(){this._sdk.gameplayStart()}onGameplayStop(){this._sdk.gameplayStop()}async showInterstitial(){return new Promise(a=>{this._adResolve=a,this._lastRequestedAd="interstitial",this._sdk.requestAd("midgame")})}async showRewarded(){return new Promise(a=>{this._adResolve=a,this._lastRequestedAd="rewarded",this._sdk.requestAd("rewarded")})}}class g extends r{constructor(){super(...arguments);t(this,"name","CoolMathGames");t(this,"capabilities",{ads:!0,interstitialAds:!0,rewardedAds:!1,bannerAds:!1,accounts:!1,tokens:!1});t(this,"scriptSources",["https://www.coolmathgames.com/sites/default/files/cmg-ads.js"]);t(this,"requiresProduction",!0);t(this,"_adResolve",null)}async init(a){document.addEventListener("adBreakComplete",()=>{this._adResolve&&(this._adResolve(!0),this._adResolve=null)})}onGameplayStart(){parent.cmgGameEvent("start")}onLevelStart(a){parent.cmgGameEvent("start",a.toString())}onReplayLevel(a){parent.cmgGameEvent("replay",a.toString())}async showInterstitial(){return new Promise(a=>{this._adResolve=a,window.cmgAdBreak()})}}class y extends r{constructor(){super(...arguments);t(this,"name","HoodaMath")}}class k extends r{constructor(){super(...arguments);t(this,"name","FreezeNova");t(this,"capabilities",{ads:!0,interstitialAds:!0,rewardedAds:!0,bannerAds:!1,accounts:!1,tokens:!1});t(this,"scriptSources",['https://universal.wgplayer.com/tag/?lh="+window.location.hostname+"&wp="+window.location.pathname+"&ws="+window.location.search']);t(this,"requiresProduction",!0);t(this,"_adResolve",null)}async init(a){const n=a.data||{};window.SubmitLeaderboardScore=function(d){},window.InitExternEval=function(){window.firstInit==null?window.firstInit=1:window.ExternEval()},window.TakeReward=function(){window.adReward=0},window.RewardErrorHandled=function(){window.rewardError=0},window.InitApi=function(d){const l=Math.round(Date.now()/1e3);window.callTime=l-181},window.ExternEval=function(){const d=Math.round(Date.now()/1e3);if(window.callTime!=null&&d-window.callTime>180&&(window.callTime=d,typeof preroll<"u"&&window[preroll.config.loaderObjectName]!=null)){window.adRunning=1;try{window[preroll.config.loaderObjectName].refetchAd(window.ExternEvalResumeGame)}catch(l){console.log(l.message),window.ExternEvalResumeGame()}}},window.ExternEvalResumeGame=function(){window.adRunning=0},window.PreloadRewarded=function(){if(window.rewardedCallbacks==null){window.rewardedCallbacks=!0;try{window[window.preroll.config.loaderObjectName].registerRewardCallbacks({onReady:window.RewardedReady,onSuccess:window.RewardedSuccess,onFail:window.RewardedFail})}catch(d){console.log(d.message)}}},window.ShowRewarded=function(){if(typeof preroll<"u"&&window[preroll.config.loaderObjectName]!=null){window.canReward=0,window.adRunning=1;try{window[preroll.config.loaderObjectName].showRewardAd()}catch(d){console.log(d.message),window.adRunning=0}}},window.RewardedReady=function(){window.rewardedCount==null?(window.rewardedCount=1,window.canReward=1):(window.rewardedCount=window.rewardedCount+1,setTimeout(function(){window.canReward=1},3e4))};const i=this;window.RewardedSuccess=function(){window.adRunning=0,window.adReward=1,i._adResolve&&(i._adResolve(!0),i._adResolve=null)},window.RewardedFail=function(){window.adRunning=0,i._adResolve&&(i._adResolve(!1),i._adResolve=null)},window.OpenLink=function(){},window.adRunning=0,window.adRunningRewarded=0,window.adReward=0,window.rewardError=0,window.canReward=0,window.callTime=0,window.adPlatform=4,window.myLeaderboardScore=0,window.gameLang="en",window.InitApi(n.freezeNova_id||0)}async showInterstitial(){return new Promise(a=>{this._adResolve=a,window.PreloadRewarded(),window.ShowRewarded()})}async showRewarded(){return new Promise(a=>{this._adResolve=a,window.PreloadRewarded(),window.ShowRewarded()})}}class b extends r{constructor(){super(...arguments);t(this,"name","Xiaomi");t(this,"capabilities",{ads:!0,interstitialAds:!0,rewardedAds:!0,bannerAds:!1,accounts:!1,tokens:!1});t(this,"scriptSources",[]);t(this,"requiresProduction",!0);t(this,"_adBreak",null)}async preInit(a){const n=a.data||{},i=document.createElement("script");i.async=!0,i.setAttribute("data-ad-frequency-hint","30s"),i.src=`https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-${n.xiaomi_publisherId}`,i.setAttribute("crossorigin","anonymous"),a.debug&&i.setAttribute("data-adbreak-test","on"),window.adsbygoogle=window.adsbygoogle||[],window.adConfig=function(d){adsbygoogle.push(d)},window.adBreak=window.adConfig,this._adBreak=window.adBreak,document.body.appendChild(i),await new Promise(d=>{i.onload=()=>{if(n.xiaomi_bannerEnabled){const l=document.createElement("ins");l.className="adsbygoogle",l.style.display="block",l.setAttribute("data-ad-client",`ca-${n.xiaomi_publisherId}`),l.setAttribute("data-ad-slot",n.xiaomi_dataAdSlot),l.setAttribute("data-ad-format","auto"),l.setAttribute("data-full-width-responsive","true");const u=n.xiaomi_bannerConainerId||"adSpace";let p=document.getElementById(u);p||(p=document.createElement("div"),p.id=u,document.body.appendChild(p)),p.appendChild(l),(adsbygoogle=window.adsbygoogle||[]).push({})}d()}})}onLoadingStart(){try{funmax&&funmax.loadStart()}catch{console.error("funmax not found")}}onLoadingEnd(){try{funmax&&funmax.loadReady()}catch{console.error("funmax not found")}}async showInterstitial(){return new Promise(a=>{this._adBreak({type:"next",name:"interstitial",beforeAd:()=>{},adBreakDone:()=>{a(!0)}})})}async showRewarded(){return new Promise(a=>{let n=!1;this._adBreak({type:"reward",name:"rewarded",beforeAd:()=>{},adBreakDone:()=>{a(n)},beforeReward:i=>{i()},adDismissed:()=>{n=!1},adViewed:()=>{n=!0}})})}}const m={Poki:c,CrazyGames:_,CoolMathGames:g,HoodaMath:y,FreezeNova:k,Xiaomi:b},S=Object.keys(m),f=new Map;function v(s){if(f.has(s))return f.get(s);const e=new Promise((a,n)=>{const i=document.createElement("script");i.src=s,i.onload=()=>a(),i.onerror=()=>n(new Error(`Failed to load script: ${s}`)),document.head.appendChild(i)});return f.set(s,e),e}const w={};function R(s,e,{once:a=!1}={}){w[s]=w[s]||[],w[s].push({fn:e,once:a})}function h(s,...e){(w[s]||[]).forEach(a=>{a.fn(...e)}),w[s]=(w[s]||[]).filter(a=>!a.once)}function A(){const s=document.createElement("style");s.innerHTML=`
+  canvas {
+    user-select: none !important;
+    -webkit-user-select: none !important;
+    -moz-user-select: none !important;
+    -ms-user-select: none !important;
+  }`,document.head.appendChild(s),window.addEventListener("keydown",e=>{["ArrowDown","ArrowUp"," "].includes(e.key)&&e.preventDefault()}),window.addEventListener("wheel",e=>e.preventDefault(),{passive:!1})}class E{constructor(){t(this,"_adapter",null);t(this,"_enabled",!1)}get enabled(){return this._enabled}get currentSdk(){return this._adapter}async init(e,a=!1,n={}){const i=Object.keys(m).find(u=>u.toLowerCase()===e.toLowerCase()),d=i?m[i]:null;if(!d||(this._adapter=new d,this._adapter.requiresProduction&&a))return;this._enabled=!0;const l={debug:a,data:n};await this._adapter.preInit(l);for(const u of this._adapter.scriptSources)await v(u);await this._adapter.init(l),this.loadingStart()}loadingStart(){this._adapter&&this._adapter.onLoadingStart()}loadingEnd(){this._adapter&&this._adapter.onLoadingEnd()}gameplayStart(){this._adapter&&this._adapter.maybeGameplayStart()}gameplayStop(){this._adapter&&this._adapter.maybeGameplayStop()}levelStart(e){this._adapter&&this._adapter.onLevelStart(e)}replayLevel(e){this._adapter&&this._adapter.onReplayLevel(e)}onUnlockAllLevels(e){window.unlockAllLevels=e}async interstitial(){var n;if(!((n=this._adapter)!=null&&n.capabilities.interstitialAds))return h("adStarted","interstitial"),!1;const e=this._adapter._gameplayStarted;e&&this.gameplayStop(),h("adStarted","interstitial");const a=await this._adapter.showInterstitial();return e&&this.gameplayStart(),a}async rewarded(e){var i;if(!((i=this._adapter)!=null&&i.capabilities.rewardedAds))return h("adStarted","rewarded"),!0;const a=this._adapter._gameplayStarted;a&&this.gameplayStop(),h("adStarted","rewarded");const n=await this._adapter.showRewarded(e);return a&&this.gameplayStart(),n}onAdStarted(e){R("adStarted",e)}hasAds(){var e;return(e=this._adapter)!=null&&e.capabilities.ads?1:0}hasInterstitialAds(){var e;return(e=this._adapter)!=null&&e.capabilities.interstitialAds?1:0}hasRewardedAds(){var e;return(e=this._adapter)!=null&&e.capabilities.rewardedAds?1:0}analyticsEvent({category:e,action:a,label:n}){this._adapter&&this._adapter.trackEvent(e,a,n)}login(){var e;return(e=this._adapter)!=null&&e.capabilities.accounts?this._adapter.login():Promise.reject(new Error("Accounts not supported"))}getUser(){var e;return(e=this._adapter)!=null&&e.capabilities.accounts?this._adapter.getUser():Promise.resolve(null)}getToken(){var e;return(e=this._adapter)!=null&&e.capabilities.tokens?this._adapter.getToken():Promise.resolve(null)}hasAccounts(){var e;return(e=this._adapter)!=null&&e.capabilities.accounts?1:0}hasToken(){var e;return(e=this._adapter)!=null&&e.capabilities.tokens?1:0}openExternalLink(e){if(!this._adapter||!this._enabled){window.open(e,"_blank");return}this._adapter.openExternalLink(e)}}const L=new E;o.NetworkAdapter=r,o.default=L,o.networks=S,o.preventWeirdInputs=A,Object.defineProperties(o,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}));

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "web-sdk-wrapper",
+  "version": "2.0.0",
+  "description": "Unified wrapper for web game distribution platform SDKs (Poki, CrazyGames, CoolMathGames, and more)",
+  "type": "module",
+  "main": "./dist/web-sdk-wrapper.umd.cjs",
+  "module": "./dist/web-sdk-wrapper.js",
+  "exports": {
+    ".": {
+      "import": "./dist/web-sdk-wrapper.js",
+      "require": "./dist/web-sdk-wrapper.umd.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "sdk",
+    "wrapper",
+    "poki",
+    "crazygames",
+    "coolmathgames",
+    "web-games",
+    "ads",
+    "game-sdk"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "vite": "^6.3.2"
+  }
+}

package/src/event-emitter.js

@@ -0,0 +1,33 @@
+const events = {};
+
+/**
+ * Subscribe to an event.
+ * @param {string} event
+ * @param {Function} fn
+ * @param {{ once?: boolean }} [options]
+ */
+export function listen(event, fn, { once = false } = {}) {
+  events[event] = events[event] || [];
+  events[event].push({ fn, once });
+}
+
+/**
+ * Subscribe to an event for a single dispatch.
+ * @param {string} event
+ * @param {Function} fn
+ */
+export function listenOnce(event, fn) {
+  listen(event, fn, { once: true });
+}
+
+/**
+ * Dispatch an event to all listeners.
+ * @param {string} event
+ * @param {...any} data
+ */
+export function dispatch(event, ...data) {
+  (events[event] || []).forEach((fnObj) => {
+    fnObj.fn(...data);
+  });
+  events[event] = (events[event] || []).filter((fnObj) => !fnObj.once);
+}

package/src/index.js

@@ -0,0 +1,215 @@
+import registry from "./networks/index.js";
+import { loadScript } from "./script-loader.js";
+import { listen, listenOnce, dispatch } from "./event-emitter.js";
+
+export { preventWeirdInputs } from "./utils.js";
+export { NetworkAdapter } from "./networks/base.js";
+export { networks } from "./networks/index.js";
+
+/**
+ * @class Wrapper
+ *
+ * Unified facade over multiple web game distribution platform SDKs.
+ * Delegates all behavior to the currently active network adapter.
+ *
+ * Usage:
+ *   import Wrapper from "web-sdk-wrapper";
+ *   await Wrapper.init("Poki", false, { poki_gameId: "abc" });
+ *   Wrapper.loadingEnd();
+ *   const rewarded = await Wrapper.rewarded();
+ */
+class Wrapper {
+  /** @type {import('./networks/base.js').NetworkAdapter|null} */
+  _adapter = null;
+
+  /** @type {boolean} */
+  _enabled = false;
+
+  get enabled() {
+    return this._enabled;
+  }
+
+  get currentSdk() {
+    return this._adapter;
+  }
+
+  /**
+   * Initialize the wrapper with a specific network.
+   * @param {string} name - Network name (case-insensitive)
+   * @param {boolean} [debug=false]
+   * @param {Object} [data={}] - Network-specific configuration
+   * @returns {Promise<void>}
+   */
+  async init(name, debug = false, data = {}) {
+    const key = Object.keys(registry).find(
+      (k) => k.toLowerCase() === name.toLowerCase(),
+    );
+    const AdapterClass = key ? registry[key] : null;
+    if (!AdapterClass) return;
+
+    this._adapter = new AdapterClass();
+
+    if (this._adapter.requiresProduction && debug) {
+      return;
+    }
+
+    this._enabled = true;
+    const options = { debug, data };
+
+    // preInit (before scripts load)
+    await this._adapter.preInit(options);
+
+    // Load SDK scripts
+    for (const src of this._adapter.scriptSources) {
+      await loadScript(src);
+    }
+
+    // Init adapter (after scripts are loaded)
+    await this._adapter.init(options);
+
+    // Signal loading started
+    this.loadingStart();
+  }
+
+  loadingStart() {
+    if (this._adapter) this._adapter.onLoadingStart();
+  }
+
+  loadingEnd() {
+    if (this._adapter) this._adapter.onLoadingEnd();
+  }
+
+  gameplayStart() {
+    if (this._adapter) this._adapter.maybeGameplayStart();
+  }
+
+  gameplayStop() {
+    if (this._adapter) this._adapter.maybeGameplayStop();
+  }
+
+  levelStart(level) {
+    if (this._adapter) this._adapter.onLevelStart(level);
+  }
+
+  replayLevel(level) {
+    if (this._adapter) this._adapter.onReplayLevel(level);
+  }
+
+  onUnlockAllLevels(fn) {
+    window.unlockAllLevels = fn;
+  }
+
+  /**
+   * Show an interstitial ad. Auto-pauses/resumes gameplay.
+   * @returns {Promise<boolean>}
+   */
+  async interstitial() {
+    if (!this._adapter?.capabilities.interstitialAds) {
+      dispatch("adStarted", "interstitial");
+      return false;
+    }
+
+    const wasPlaying = this._adapter._gameplayStarted;
+    if (wasPlaying) this.gameplayStop();
+
+    dispatch("adStarted", "interstitial");
+    const success = await this._adapter.showInterstitial();
+
+    if (wasPlaying) this.gameplayStart();
+    return success;
+  }
+
+  /**
+   * Show a rewarded ad. Auto-pauses/resumes gameplay.
+   * @param {string} [size]
+   * @returns {Promise<boolean>}
+   */
+  async rewarded(size) {
+    if (!this._adapter?.capabilities.rewardedAds) {
+      dispatch("adStarted", "rewarded");
+      return true;
+    }
+
+    const wasPlaying = this._adapter._gameplayStarted;
+    if (wasPlaying) this.gameplayStop();
+
+    dispatch("adStarted", "rewarded");
+    const success = await this._adapter.showRewarded(size);
+
+    if (wasPlaying) this.gameplayStart();
+    return success;
+  }
+
+  /**
+   * Register a callback for when an ad starts.
+   * @param {function} fn
+   */
+  onAdStarted(fn) {
+    listen("adStarted", fn);
+  }
+
+  /** @returns {number} 1 if ads supported, 0 otherwise */
+  hasAds() {
+    return this._adapter?.capabilities.ads ? 1 : 0;
+  }
+
+  /** @returns {number} 1 if interstitial ads supported, 0 otherwise */
+  hasInterstitialAds() {
+    return this._adapter?.capabilities.interstitialAds ? 1 : 0;
+  }
+
+  /** @returns {number} 1 if rewarded ads supported, 0 otherwise */
+  hasRewardedAds() {
+    return this._adapter?.capabilities.rewardedAds ? 1 : 0;
+  }
+
+  /**
+   * Track an analytics event.
+   * @param {{ category: string, action: string, label?: string }} event
+   */
+  analyticsEvent({ category, action, label }) {
+    if (this._adapter) this._adapter.trackEvent(category, action, label);
+  }
+
+  login() {
+    if (!this._adapter?.capabilities.accounts) {
+      return Promise.reject(new Error("Accounts not supported"));
+    }
+    return this._adapter.login();
+  }
+
+  getUser() {
+    if (!this._adapter?.capabilities.accounts) {
+      return Promise.resolve(null);
+    }
+    return this._adapter.getUser();
+  }
+
+  getToken() {
+    if (!this._adapter?.capabilities.tokens) {
+      return Promise.resolve(null);
+    }
+    return this._adapter.getToken();
+  }
+
+  /** @returns {number} 1 if accounts supported, 0 otherwise */
+  hasAccounts() {
+    return this._adapter?.capabilities.accounts ? 1 : 0;
+  }
+
+  /** @returns {number} 1 if tokens supported, 0 otherwise */
+  hasToken() {
+    return this._adapter?.capabilities.tokens ? 1 : 0;
+  }
+
+  openExternalLink(url) {
+    if (!this._adapter || !this._enabled) {
+      window.open(url, "_blank");
+      return;
+    }
+    this._adapter.openExternalLink(url);
+  }
+}
+
+// Export a singleton instance to match V1 API (import Wrapper from "...")
+export default new Wrapper();

package/src/networks/base.js

@@ -0,0 +1,224 @@
+/**
+ * @class NetworkAdapter
+ *
+ * Base class for all network adapters. Subclass this and override
+ * only the methods your network needs. Everything has a sensible default.
+ *
+ * ===== Properties to override =====
+ *
+ * @property {string} name - Network display name (e.g. "Poki")
+ *
+ * @property {{
+ *   ads: boolean,
+ *   interstitialAds: boolean,
+ *   rewardedAds: boolean,
+ *   bannerAds: boolean,
+ *   accounts: boolean,
+ *   tokens: boolean
+ * }} capabilities - What this network supports
+ *
+ * @property {string[]} scriptSources - SDK script URLs to load before init
+ *
+ * @property {boolean} requiresProduction - If true, adapter is disabled in debug mode
+ *
+ * ===== Lifecycle methods to override =====
+ *
+ * @method preInit - Called before scripts are loaded. Use for early setup.
+ * @method init - Called after scripts are loaded. Set up your SDK here.
+ * @method onLoadingStart - Game loading started
+ * @method onLoadingEnd - Game loading finished
+ * @method onGameplayStart - Gameplay session started (has built-in duplicate guard)
+ * @method onGameplayStop - Gameplay session stopped (has built-in duplicate guard)
+ * @method onLevelStart - Level started (receives level identifier)
+ * @method onReplayLevel - Level replayed (receives level identifier)
+ *
+ * ===== Ad methods to override =====
+ *
+ * @method showInterstitial - Show an interstitial ad. Return true if shown.
+ * @method showRewarded - Show a rewarded ad. Return true if reward was earned.
+ *
+ * ===== Account methods to override =====
+ *
+ * @method login - Log in via the platform
+ * @method getUser - Get the current user
+ * @method getToken - Get an auth token
+ *
+ * ===== Misc methods to override =====
+ *
+ * @method trackEvent - Track an analytics event
+ * @method openExternalLink - Open a URL (default: window.open)
+ */
+export class NetworkAdapter {
+  /** @type {string} */
+  name = "Unknown";
+
+  /**
+   * @type {{
+   *   ads: boolean,
+   *   interstitialAds: boolean,
+   *   rewardedAds: boolean,
+   *   bannerAds: boolean,
+   *   accounts: boolean,
+   *   tokens: boolean
+   * }}
+   */
+  capabilities = {
+    ads: false,
+    interstitialAds: false,
+    rewardedAds: false,
+    bannerAds: false,
+    accounts: false,
+    tokens: false,
+  };
+
+  /** @type {string[]} SDK script URLs to load before init */
+  scriptSources = [];
+
+  /** @type {boolean} If true, adapter is disabled when debug=true */
+  requiresProduction = false;
+
+  /** @type {any} Reference to the loaded SDK object. Set in init(). */
+  _sdk = null;
+
+  /** @type {boolean} Whether a gameplay session is active */
+  _gameplayStarted = false;
+
+  // ========================
+  // Lifecycle
+  // ========================
+
+  /**
+   * Called before scripts are loaded. Use for early DOM setup or config.
+   * @param {{ debug: boolean, data: Object }} options
+   * @returns {Promise<void>}
+   */
+  async preInit(options) {}
+
+  /**
+   * Called after scripts are loaded. Initialize the SDK here.
+   * @param {{ debug: boolean, data: Object }} options
+   * @returns {Promise<void>}
+   */
+  async init(options) {}
+
+  /** Called when the game starts loading. */
+  onLoadingStart() {}
+
+  /** Called when the game finishes loading. */
+  onLoadingEnd() {}
+
+  /**
+   * Handles duplicate-call gating for gameplay start.
+   * Do NOT override this — override onGameplayStart() instead.
+   */
+  maybeGameplayStart() {
+    if (this._gameplayStarted) return;
+    this._gameplayStarted = true;
+    this.onGameplayStart();
+  }
+
+  /**
+   * Handles duplicate-call gating for gameplay stop.
+   * Do NOT override this — override onGameplayStop() instead.
+   */
+  maybeGameplayStop() {
+    if (!this._gameplayStarted) return;
+    this._gameplayStarted = false;
+    this.onGameplayStop();
+  }
+
+  /**
+   * Called when a gameplay session starts.
+   * Only called if not already in a gameplay session (gated by maybeGameplayStart).
+   * Override this freely — no need to call super.
+   */
+  onGameplayStart() {}
+
+  /**
+   * Called when a gameplay session stops.
+   * Only called if currently in a gameplay session (gated by maybeGameplayStop).
+   * Override this freely — no need to call super.
+   */
+  onGameplayStop() {}
+
+  /**
+   * Called when a level starts.
+   * @param {string|number} level
+   */
+  onLevelStart(level) {}
+
+  /**
+   * Called when a level is replayed.
+   * @param {string|number} level
+   */
+  onReplayLevel(level) {}
+
+  // ========================
+  // Ads
+  // ========================
+
+  /**
+   * Show an interstitial ad.
+   * @returns {Promise<boolean>} Whether the ad was shown successfully
+   */
+  async showInterstitial() {
+    return false;
+  }
+
+  /**
+   * Show a rewarded ad.
+   * @param {string} [size] - Ad size hint (e.g. "small", "medium")
+   * @returns {Promise<boolean>} Whether the reward was earned
+   */
+  async showRewarded(size) {
+    return true;
+  }
+
+  // ========================
+  // Accounts
+  // ========================
+
+  /**
+   * Log in via the platform's auth system.
+   * @returns {Promise<any>}
+   */
+  login() {
+    return Promise.reject(new Error("Accounts not supported"));
+  }
+
+  /**
+   * Get the currently logged-in user.
+   * @returns {Promise<any>}
+   */
+  getUser() {
+    return Promise.resolve(null);
+  }
+
+  /**
+   * Get an auth token for the current user.
+   * @returns {Promise<string|null>}
+   */
+  getToken() {
+    return Promise.resolve(null);
+  }
+
+  // ========================
+  // Misc
+  // ========================
+
+  /**
+   * Track an analytics event.
+   * @param {string} category
+   * @param {string} action
+   * @param {string} [label]
+   */
+  trackEvent(category, action, label) {}
+
+  /**
+   * Open an external link. Default: window.open.
+   * @param {string} url
+   */
+  openExternalLink(url) {
+    window.open(url, "_blank");
+  }
+}

package/src/networks/cool-math-games.js

@@ -0,0 +1,52 @@
+import { NetworkAdapter } from "./base.js";
+
+export class CoolMathGamesAdapter extends NetworkAdapter {
+  name = "CoolMathGames";
+
+  capabilities = {
+    ads: true,
+    interstitialAds: true,
+    rewardedAds: false,
+    bannerAds: false,
+    accounts: false,
+    tokens: false,
+  };
+
+  scriptSources = [
+    "https://www.coolmathgames.com/sites/default/files/cmg-ads.js",
+  ];
+
+  requiresProduction = true;
+
+  /** @type {function|null} */
+  _adResolve = null;
+
+  async init(options) {
+    // CMG SDK is loaded via script tag and uses document events + parent.cmgGameEvent
+    document.addEventListener("adBreakComplete", () => {
+      if (this._adResolve) {
+        this._adResolve(true);
+        this._adResolve = null;
+      }
+    });
+  }
+
+  onGameplayStart() {
+    parent.cmgGameEvent("start");
+  }
+
+  onLevelStart(level) {
+    parent.cmgGameEvent("start", level.toString());
+  }
+
+  onReplayLevel(level) {
+    parent.cmgGameEvent("replay", level.toString());
+  }
+
+  async showInterstitial() {
+    return new Promise((resolve) => {
+      this._adResolve = resolve;
+      window.cmgAdBreak();
+    });
+  }
+}

package/src/networks/crazy-games.js

@@ -0,0 +1,74 @@
+import { NetworkAdapter } from "./base.js";
+
+export class CrazyGamesAdapter extends NetworkAdapter {
+  name = "CrazyGames";
+
+  capabilities = {
+    ads: true,
+    interstitialAds: true,
+    rewardedAds: true,
+    bannerAds: true,
+    accounts: false,
+    tokens: false,
+  };
+
+  scriptSources = ["https://sdk.crazygames.com/crazygames-sdk-v1.js"];
+
+  requiresProduction = false;
+
+  /** @type {string|null} Tracks which ad type was last requested */
+  _lastRequestedAd = null;
+
+  /** @type {function|null} Resolve function for the current ad promise */
+  _adResolve = null;
+
+  async init(options) {
+    this._sdk = globalThis?.CrazyGames?.CrazySDK?.getInstance();
+
+    await new Promise((resolve) => {
+      this._sdk.addEventListener("adblockDetectionExecuted", () => {
+        resolve();
+      });
+      this._sdk.init();
+    });
+
+    // Set up SDK event listeners once
+    this._sdk.addEventListener("adFinished", () => {
+      if (this._adResolve) {
+        this._adResolve(true);
+        this._adResolve = null;
+      }
+    });
+
+    this._sdk.addEventListener("adError", () => {
+      if (this._adResolve) {
+        this._adResolve(false);
+        this._adResolve = null;
+      }
+    });
+  }
+
+  onGameplayStart() {
+    this._sdk.gameplayStart();
+  }
+
+  onGameplayStop() {
+    this._sdk.gameplayStop();
+  }
+
+  async showInterstitial() {
+    return new Promise((resolve) => {
+      this._adResolve = resolve;
+      this._lastRequestedAd = "interstitial";
+      this._sdk.requestAd("midgame");
+    });
+  }
+
+  async showRewarded() {
+    return new Promise((resolve) => {
+      this._adResolve = resolve;
+      this._lastRequestedAd = "rewarded";
+      this._sdk.requestAd("rewarded");
+    });
+  }
+}