@hyve-sdk/js 2.14.0 → 2.14.1-canary.0

package/README.md

@@ -244,6 +244,19 @@ await hyve.gameplayStop();
 await hyve.happytime();
 ```
 
+Gameplay start/stop tracking is handled automatically where the SDK has the
+context to do so:
+
+- `gameplayStart()` and `gameplayEnd()` lifecycle telemetry calls forward to
+  the CrazyGames SDK, so games emitting the required Hyve lifecycle events get
+  CrazyGames gameplay tracking for free.
+- Ads shown via `showAd()` automatically stop gameplay tracking for the
+  duration of the ad and resume it afterwards (only if gameplay was active
+  when the ad was requested).
+- Calls are idempotent — duplicate starts or stops are not forwarded.
+- Focus/tab changes are intentionally not tracked: CrazyGames handles those on
+  their side and instructs games not to signal them.
+
 ### Playgama
 
 When running on Playgama, the SDK auto-initializes the Playgama Bridge and routes ads through it. No additional setup required.

package/dist/index.d.mts

@@ -823,6 +823,8 @@ declare class HyveClient {
     configureAds(config: AdConfig): void;
     /**
      * Show an ad
+     * On CrazyGames, gameplay tracking is automatically stopped for the duration
+     * of the ad and resumed afterwards if it was active.
      * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
      * @param placement Optional placement key, forwarded to the native AdMob path
      *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.
@@ -1033,6 +1035,13 @@ declare global {
 declare class CrazyGamesService {
     private initialized;
     private environment;
+    /**
+     * Whether gameplay is currently marked active on the CrazyGames side.
+     * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+     * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+     * handles those on their side (per docs.crazygames.com/sdk/game).
+     */
+    private gameplayActive;
     /**
      * Detects if the game is running on the CrazyGames platform.
      * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1065,11 +1074,14 @@ declare class CrazyGamesService {
     /**
      * Notifies CrazyGames that gameplay has started.
      * Call when the player actively begins or resumes playing.
+     * Idempotent — repeated calls while gameplay is already active are no-ops.
      */
     gameplayStart(): void;
     /**
      * Notifies CrazyGames that gameplay has stopped.
-     * Call during menu access, level completion, or pausing.
+     * Call during menu access, level completion, or pausing. Do NOT call on
+     * focus/tab changes — CrazyGames handles those on their side.
+     * Idempotent — repeated calls while gameplay is already stopped are no-ops.
      */
     gameplayStop(): void;
     /**

package/dist/index.d.ts

@@ -823,6 +823,8 @@ declare class HyveClient {
     configureAds(config: AdConfig): void;
     /**
      * Show an ad
+     * On CrazyGames, gameplay tracking is automatically stopped for the duration
+     * of the ad and resumed afterwards if it was active.
      * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
      * @param placement Optional placement key, forwarded to the native AdMob path
      *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.
@@ -1033,6 +1035,13 @@ declare global {
 declare class CrazyGamesService {
     private initialized;
     private environment;
+    /**
+     * Whether gameplay is currently marked active on the CrazyGames side.
+     * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+     * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+     * handles those on their side (per docs.crazygames.com/sdk/game).
+     */
+    private gameplayActive;
     /**
      * Detects if the game is running on the CrazyGames platform.
      * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1065,11 +1074,14 @@ declare class CrazyGamesService {
     /**
      * Notifies CrazyGames that gameplay has started.
      * Call when the player actively begins or resumes playing.
+     * Idempotent — repeated calls while gameplay is already active are no-ops.
      */
     gameplayStart(): void;
     /**
      * Notifies CrazyGames that gameplay has stopped.
-     * Call during menu access, level completion, or pausing.
+     * Call during menu access, level completion, or pausing. Do NOT call on
+     * focus/tab changes — CrazyGames handles those on their side.
+     * Idempotent — repeated calls while gameplay is already stopped are no-ops.
      */
     gameplayStop(): void;
     /**

package/dist/index.js

@@ -1243,6 +1243,13 @@ var CRAZYGAMES_SDK_CDN = "https://sdk.crazygames.com/crazygames-sdk-v3.js";
 var CrazyGamesService = class {
   initialized = false;
   environment = null;
+  /**
+   * Whether gameplay is currently marked active on the CrazyGames side.
+   * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+   * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+   * handles those on their side (per docs.crazygames.com/sdk/game).
+   */
+  gameplayActive = false;
   /**
    * Detects if the game is running on the CrazyGames platform.
    * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1317,6 +1324,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("midgame", {
         adStarted: () => {
@@ -1324,10 +1333,12 @@ var CrazyGamesService = class {
         },
         adFinished: () => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "interstitial",
@@ -1355,6 +1366,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("rewarded", {
         adStarted: () => {
@@ -1363,10 +1376,12 @@ var CrazyGamesService = class {
         adFinished: () => {
           callbacks?.onRewardEarned?.();
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "rewarded", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "rewarded",
@@ -1381,17 +1396,22 @@ var CrazyGamesService = class {
   /**
    * Notifies CrazyGames that gameplay has started.
    * Call when the player actively begins or resumes playing.
+   * Idempotent — repeated calls while gameplay is already active are no-ops.
    */
   gameplayStart() {
-    if (!this.initialized) return;
+    if (!this.initialized || this.gameplayActive) return;
+    this.gameplayActive = true;
     window.CrazyGames?.SDK.game.gameplayStart();
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.
-   * Call during menu access, level completion, or pausing.
+   * Call during menu access, level completion, or pausing. Do NOT call on
+   * focus/tab changes — CrazyGames handles those on their side.
+   * Idempotent — repeated calls while gameplay is already stopped are no-ops.
    */
   gameplayStop() {
-    if (!this.initialized) return;
+    if (!this.initialized || !this.gameplayActive) return;
+    this.gameplayActive = false;
     window.CrazyGames?.SDK.game.gameplayStop();
   }
   /**
@@ -3080,6 +3100,8 @@ var HyveClient = class {
   }
   /**
    * Show an ad
+   * On CrazyGames, gameplay tracking is automatically stopped for the duration
+   * of the ad and resumed afterwards if it was active.
    * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
    * @param placement Optional placement key, forwarded to the native AdMob path
    *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/dist/index.mjs

@@ -1202,6 +1202,13 @@ var CRAZYGAMES_SDK_CDN = "https://sdk.crazygames.com/crazygames-sdk-v3.js";
 var CrazyGamesService = class {
   initialized = false;
   environment = null;
+  /**
+   * Whether gameplay is currently marked active on the CrazyGames side.
+   * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+   * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+   * handles those on their side (per docs.crazygames.com/sdk/game).
+   */
+  gameplayActive = false;
   /**
    * Detects if the game is running on the CrazyGames platform.
    * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1276,6 +1283,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("midgame", {
         adStarted: () => {
@@ -1283,10 +1292,12 @@ var CrazyGamesService = class {
         },
         adFinished: () => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "interstitial",
@@ -1314,6 +1325,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("rewarded", {
         adStarted: () => {
@@ -1322,10 +1335,12 @@ var CrazyGamesService = class {
         adFinished: () => {
           callbacks?.onRewardEarned?.();
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "rewarded", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "rewarded",
@@ -1340,17 +1355,22 @@ var CrazyGamesService = class {
   /**
    * Notifies CrazyGames that gameplay has started.
    * Call when the player actively begins or resumes playing.
+   * Idempotent — repeated calls while gameplay is already active are no-ops.
    */
   gameplayStart() {
-    if (!this.initialized) return;
+    if (!this.initialized || this.gameplayActive) return;
+    this.gameplayActive = true;
     window.CrazyGames?.SDK.game.gameplayStart();
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.
-   * Call during menu access, level completion, or pausing.
+   * Call during menu access, level completion, or pausing. Do NOT call on
+   * focus/tab changes — CrazyGames handles those on their side.
+   * Idempotent — repeated calls while gameplay is already stopped are no-ops.
    */
   gameplayStop() {
-    if (!this.initialized) return;
+    if (!this.initialized || !this.gameplayActive) return;
+    this.gameplayActive = false;
     window.CrazyGames?.SDK.game.gameplayStop();
   }
   /**
@@ -3039,6 +3059,8 @@ var HyveClient = class {
   }
   /**
    * Show an ad
+   * On CrazyGames, gameplay tracking is automatically stopped for the duration
+   * of the ad and resumed afterwards if it was active.
    * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
    * @param placement Optional placement key, forwarded to the native AdMob path
    *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/dist/react.d.mts

@@ -554,6 +554,8 @@ declare class HyveClient {
     configureAds(config: AdConfig): void;
     /**
      * Show an ad
+     * On CrazyGames, gameplay tracking is automatically stopped for the duration
+     * of the ad and resumed afterwards if it was active.
      * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
      * @param placement Optional placement key, forwarded to the native AdMob path
      *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/dist/react.d.ts

@@ -554,6 +554,8 @@ declare class HyveClient {
     configureAds(config: AdConfig): void;
     /**
      * Show an ad
+     * On CrazyGames, gameplay tracking is automatically stopped for the duration
+     * of the ad and resumed afterwards if it was active.
      * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
      * @param placement Optional placement key, forwarded to the native AdMob path
      *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/dist/react.js

@@ -1200,6 +1200,13 @@ var CRAZYGAMES_SDK_CDN = "https://sdk.crazygames.com/crazygames-sdk-v3.js";
 var CrazyGamesService = class {
   initialized = false;
   environment = null;
+  /**
+   * Whether gameplay is currently marked active on the CrazyGames side.
+   * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+   * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+   * handles those on their side (per docs.crazygames.com/sdk/game).
+   */
+  gameplayActive = false;
   /**
    * Detects if the game is running on the CrazyGames platform.
    * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1274,6 +1281,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("midgame", {
         adStarted: () => {
@@ -1281,10 +1290,12 @@ var CrazyGamesService = class {
         },
         adFinished: () => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "interstitial",
@@ -1312,6 +1323,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("rewarded", {
         adStarted: () => {
@@ -1320,10 +1333,12 @@ var CrazyGamesService = class {
         adFinished: () => {
           callbacks?.onRewardEarned?.();
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "rewarded", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "rewarded",
@@ -1338,17 +1353,22 @@ var CrazyGamesService = class {
   /**
    * Notifies CrazyGames that gameplay has started.
    * Call when the player actively begins or resumes playing.
+   * Idempotent — repeated calls while gameplay is already active are no-ops.
    */
   gameplayStart() {
-    if (!this.initialized) return;
+    if (!this.initialized || this.gameplayActive) return;
+    this.gameplayActive = true;
     window.CrazyGames?.SDK.game.gameplayStart();
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.
-   * Call during menu access, level completion, or pausing.
+   * Call during menu access, level completion, or pausing. Do NOT call on
+   * focus/tab changes — CrazyGames handles those on their side.
+   * Idempotent — repeated calls while gameplay is already stopped are no-ops.
    */
   gameplayStop() {
-    if (!this.initialized) return;
+    if (!this.initialized || !this.gameplayActive) return;
+    this.gameplayActive = false;
     window.CrazyGames?.SDK.game.gameplayStop();
   }
   /**
@@ -3031,6 +3051,8 @@ var HyveClient = class {
   }
   /**
    * Show an ad
+   * On CrazyGames, gameplay tracking is automatically stopped for the duration
+   * of the ad and resumed afterwards if it was active.
    * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
    * @param placement Optional placement key, forwarded to the native AdMob path
    *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/dist/react.mjs

@@ -1178,6 +1178,13 @@ var CRAZYGAMES_SDK_CDN = "https://sdk.crazygames.com/crazygames-sdk-v3.js";
 var CrazyGamesService = class {
   initialized = false;
   environment = null;
+  /**
+   * Whether gameplay is currently marked active on the CrazyGames side.
+   * Makes gameplayStart/gameplayStop idempotent and lets ad flows restore the
+   * pre-ad state. Focus/tab changes are intentionally NOT tracked — CrazyGames
+   * handles those on their side (per docs.crazygames.com/sdk/game).
+   */
+  gameplayActive = false;
   /**
    * Detects if the game is running on the CrazyGames platform.
    * Games on CrazyGames run inside an iframe, so we check document.referrer
@@ -1252,6 +1259,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("midgame", {
         adStarted: () => {
@@ -1259,10 +1268,12 @@ var CrazyGamesService = class {
         },
         adFinished: () => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "interstitial",
@@ -1290,6 +1301,8 @@ var CrazyGamesService = class {
         completedAt: Date.now()
       };
     }
+    const resumeAfterAd = this.gameplayActive;
+    this.gameplayStop();
     return new Promise((resolve) => {
       sdk.ad.requestAd("rewarded", {
         adStarted: () => {
@@ -1298,10 +1311,12 @@ var CrazyGamesService = class {
         adFinished: () => {
           callbacks?.onRewardEarned?.();
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({ success: true, type: "rewarded", requestedAt, completedAt: Date.now() });
         },
         adError: (error) => {
           callbacks?.onAfterAd?.();
+          if (resumeAfterAd) this.gameplayStart();
           resolve({
             success: false,
             type: "rewarded",
@@ -1316,17 +1331,22 @@ var CrazyGamesService = class {
   /**
    * Notifies CrazyGames that gameplay has started.
    * Call when the player actively begins or resumes playing.
+   * Idempotent — repeated calls while gameplay is already active are no-ops.
    */
   gameplayStart() {
-    if (!this.initialized) return;
+    if (!this.initialized || this.gameplayActive) return;
+    this.gameplayActive = true;
     window.CrazyGames?.SDK.game.gameplayStart();
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.
-   * Call during menu access, level completion, or pausing.
+   * Call during menu access, level completion, or pausing. Do NOT call on
+   * focus/tab changes — CrazyGames handles those on their side.
+   * Idempotent — repeated calls while gameplay is already stopped are no-ops.
    */
   gameplayStop() {
-    if (!this.initialized) return;
+    if (!this.initialized || !this.gameplayActive) return;
+    this.gameplayActive = false;
     window.CrazyGames?.SDK.game.gameplayStop();
   }
   /**
@@ -3009,6 +3029,8 @@ var HyveClient = class {
   }
   /**
    * Show an ad
+   * On CrazyGames, gameplay tracking is automatically stopped for the duration
+   * of the ad and resumed afterwards if it was active.
    * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
    * @param placement Optional placement key, forwarded to the native AdMob path
    *   to resolve a per-placement unit ID. Ignored on the web (H5/Playgama) path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyve-sdk/js",
-  "version": "2.14.0",
+  "version": "2.14.1-canary.0",
   "description": "Hyve SDK - TypeScript wrapper for Hyve game server integration",
   "private": false,
   "publishConfig": {