@hyve-sdk/js 2.11.2 → 2.12.0

package/dist/index.d.mts

@@ -507,6 +507,59 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: Record<string, any> | string | null, platformId?: string | null): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session start.
+     * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+     */
+    sessionStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session end.
+     */
+    sessionEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading start.
+     */
+    lobbyLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading end.
+     */
+    lobbyLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading start.
+     */
+    gameLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading end.
+     */
+    gameLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby initialization.
+     */
+    lobbyInit(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Gameplay end.
+     * Also notifies CrazyGames that gameplay has stopped.
+     */
+    gameplayEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Store opened.
+     */
+    storeOpen(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase complete.
+     * @param itemName Name of the purchased item (required by the platform)
+     */
+    purchaseComplete(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase failed.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseFail(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase cancelled.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseCancel(itemName: string): Promise<boolean>;
     /**
      * Makes an authenticated API call using the JWT token
      * @param endpoint API endpoint path (will be appended to base URL)
@@ -656,10 +709,10 @@ declare class HyveClient {
      */
     showAd(type: AdType): Promise<AdResult>;
     /**
-     * Notifies CrazyGames that gameplay has started.
-     * No-op on other platforms.
+     * Required lifecycle telemetry — Gameplay start.
+     * Also notifies CrazyGames that gameplay has started.
      */
-    gameplayStart(): Promise<void>;
+    gameplayStart(): Promise<boolean>;
     /**
      * Notifies CrazyGames that gameplay has stopped.
      * No-op on other platforms.

package/dist/index.d.ts

@@ -507,6 +507,59 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: Record<string, any> | string | null, platformId?: string | null): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session start.
+     * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+     */
+    sessionStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session end.
+     */
+    sessionEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading start.
+     */
+    lobbyLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading end.
+     */
+    lobbyLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading start.
+     */
+    gameLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading end.
+     */
+    gameLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby initialization.
+     */
+    lobbyInit(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Gameplay end.
+     * Also notifies CrazyGames that gameplay has stopped.
+     */
+    gameplayEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Store opened.
+     */
+    storeOpen(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase complete.
+     * @param itemName Name of the purchased item (required by the platform)
+     */
+    purchaseComplete(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase failed.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseFail(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase cancelled.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseCancel(itemName: string): Promise<boolean>;
     /**
      * Makes an authenticated API call using the JWT token
      * @param endpoint API endpoint path (will be appended to base URL)
@@ -656,10 +709,10 @@ declare class HyveClient {
      */
     showAd(type: AdType): Promise<AdResult>;
     /**
-     * Notifies CrazyGames that gameplay has started.
-     * No-op on other platforms.
+     * Required lifecycle telemetry — Gameplay start.
+     * Also notifies CrazyGames that gameplay has started.
      */
-    gameplayStart(): Promise<void>;
+    gameplayStart(): Promise<boolean>;
     /**
      * Notifies CrazyGames that gameplay has stopped.
      * No-op on other platforms.

package/dist/index.js

@@ -2122,6 +2122,93 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * Required lifecycle telemetry — Session start.
+   * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+   */
+  async sessionStart() {
+    return this.sendTelemetry("game", "session", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Session end.
+   */
+  async sessionEnd() {
+    return this.sendTelemetry("game", "session", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading start.
+   */
+  async lobbyLoadingStart() {
+    return this.sendTelemetry("game", "loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading end.
+   */
+  async lobbyLoadingEnd() {
+    return this.sendTelemetry("game", "loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading start.
+   */
+  async gameLoadingStart() {
+    return this.sendTelemetry("game", "game_loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading end.
+   */
+  async gameLoadingEnd() {
+    return this.sendTelemetry("game", "game_loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby initialization.
+   */
+  async lobbyInit() {
+    return this.sendTelemetry("game", "lobby", "init");
+  }
+  /**
+   * Required lifecycle telemetry — Gameplay end.
+   * Also notifies CrazyGames that gameplay has stopped.
+   */
+  async gameplayEnd() {
+    if (this.crazyGamesService) {
+      if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
+      this.crazyGamesService.gameplayStop();
+    }
+    return this.sendTelemetry("game", "gameplay", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Store opened.
+   */
+  async storeOpen() {
+    return this.sendTelemetry("game", "store", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Purchase complete.
+   * @param itemName Name of the purchased item (required by the platform)
+   */
+  async purchaseComplete(itemName) {
+    return this.sendTelemetry("game", "purchase", "complete", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase failed.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseFail(itemName) {
+    return this.sendTelemetry("game", "purchase", "fail", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase cancelled.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseCancel(itemName) {
+    return this.sendTelemetry("game", "purchase", "cancel", null, null, {
+      item_name: itemName
+    });
+  }
   /**
    * Makes an authenticated API call using the JWT token
    * @param endpoint API endpoint path (will be appended to base URL)
@@ -2461,14 +2548,15 @@ var HyveClient = class {
     return this.adsService.show(type);
   }
   /**
-   * Notifies CrazyGames that gameplay has started.
-   * No-op on other platforms.
+   * Required lifecycle telemetry — Gameplay start.
+   * Also notifies CrazyGames that gameplay has started.
    */
   async gameplayStart() {
     if (this.crazyGamesService) {
       if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
       this.crazyGamesService.gameplayStart();
     }
+    return this.sendTelemetry("game", "gameplay", "start");
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.

package/dist/index.mjs

@@ -2082,6 +2082,93 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * Required lifecycle telemetry — Session start.
+   * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+   */
+  async sessionStart() {
+    return this.sendTelemetry("game", "session", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Session end.
+   */
+  async sessionEnd() {
+    return this.sendTelemetry("game", "session", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading start.
+   */
+  async lobbyLoadingStart() {
+    return this.sendTelemetry("game", "loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading end.
+   */
+  async lobbyLoadingEnd() {
+    return this.sendTelemetry("game", "loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading start.
+   */
+  async gameLoadingStart() {
+    return this.sendTelemetry("game", "game_loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading end.
+   */
+  async gameLoadingEnd() {
+    return this.sendTelemetry("game", "game_loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby initialization.
+   */
+  async lobbyInit() {
+    return this.sendTelemetry("game", "lobby", "init");
+  }
+  /**
+   * Required lifecycle telemetry — Gameplay end.
+   * Also notifies CrazyGames that gameplay has stopped.
+   */
+  async gameplayEnd() {
+    if (this.crazyGamesService) {
+      if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
+      this.crazyGamesService.gameplayStop();
+    }
+    return this.sendTelemetry("game", "gameplay", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Store opened.
+   */
+  async storeOpen() {
+    return this.sendTelemetry("game", "store", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Purchase complete.
+   * @param itemName Name of the purchased item (required by the platform)
+   */
+  async purchaseComplete(itemName) {
+    return this.sendTelemetry("game", "purchase", "complete", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase failed.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseFail(itemName) {
+    return this.sendTelemetry("game", "purchase", "fail", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase cancelled.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseCancel(itemName) {
+    return this.sendTelemetry("game", "purchase", "cancel", null, null, {
+      item_name: itemName
+    });
+  }
   /**
    * Makes an authenticated API call using the JWT token
    * @param endpoint API endpoint path (will be appended to base URL)
@@ -2421,14 +2508,15 @@ var HyveClient = class {
     return this.adsService.show(type);
   }
   /**
-   * Notifies CrazyGames that gameplay has started.
-   * No-op on other platforms.
+   * Required lifecycle telemetry — Gameplay start.
+   * Also notifies CrazyGames that gameplay has started.
    */
   async gameplayStart() {
     if (this.crazyGamesService) {
       if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
       this.crazyGamesService.gameplayStart();
     }
+    return this.sendTelemetry("game", "gameplay", "start");
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.

package/dist/react.d.mts

@@ -282,6 +282,59 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: Record<string, any> | string | null, platformId?: string | null): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session start.
+     * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+     */
+    sessionStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session end.
+     */
+    sessionEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading start.
+     */
+    lobbyLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading end.
+     */
+    lobbyLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading start.
+     */
+    gameLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading end.
+     */
+    gameLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby initialization.
+     */
+    lobbyInit(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Gameplay end.
+     * Also notifies CrazyGames that gameplay has stopped.
+     */
+    gameplayEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Store opened.
+     */
+    storeOpen(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase complete.
+     * @param itemName Name of the purchased item (required by the platform)
+     */
+    purchaseComplete(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase failed.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseFail(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase cancelled.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseCancel(itemName: string): Promise<boolean>;
     /**
      * Makes an authenticated API call using the JWT token
      * @param endpoint API endpoint path (will be appended to base URL)
@@ -431,10 +484,10 @@ declare class HyveClient {
      */
     showAd(type: AdType): Promise<AdResult>;
     /**
-     * Notifies CrazyGames that gameplay has started.
-     * No-op on other platforms.
+     * Required lifecycle telemetry — Gameplay start.
+     * Also notifies CrazyGames that gameplay has started.
      */
-    gameplayStart(): Promise<void>;
+    gameplayStart(): Promise<boolean>;
     /**
      * Notifies CrazyGames that gameplay has stopped.
      * No-op on other platforms.

package/dist/react.d.ts

@@ -282,6 +282,59 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: Record<string, any> | string | null, platformId?: string | null): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session start.
+     * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+     */
+    sessionStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Session end.
+     */
+    sessionEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading start.
+     */
+    lobbyLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby loading end.
+     */
+    lobbyLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading start.
+     */
+    gameLoadingStart(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Game loading end.
+     */
+    gameLoadingEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Lobby initialization.
+     */
+    lobbyInit(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Gameplay end.
+     * Also notifies CrazyGames that gameplay has stopped.
+     */
+    gameplayEnd(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Store opened.
+     */
+    storeOpen(): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase complete.
+     * @param itemName Name of the purchased item (required by the platform)
+     */
+    purchaseComplete(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase failed.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseFail(itemName: string): Promise<boolean>;
+    /**
+     * Required lifecycle telemetry — Purchase cancelled.
+     * @param itemName Name of the item the purchase was for
+     */
+    purchaseCancel(itemName: string): Promise<boolean>;
     /**
      * Makes an authenticated API call using the JWT token
      * @param endpoint API endpoint path (will be appended to base URL)
@@ -431,10 +484,10 @@ declare class HyveClient {
      */
     showAd(type: AdType): Promise<AdResult>;
     /**
-     * Notifies CrazyGames that gameplay has started.
-     * No-op on other platforms.
+     * Required lifecycle telemetry — Gameplay start.
+     * Also notifies CrazyGames that gameplay has started.
      */
-    gameplayStart(): Promise<void>;
+    gameplayStart(): Promise<boolean>;
     /**
      * Notifies CrazyGames that gameplay has stopped.
      * No-op on other platforms.

package/dist/react.js

@@ -2077,6 +2077,93 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * Required lifecycle telemetry — Session start.
+   * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+   */
+  async sessionStart() {
+    return this.sendTelemetry("game", "session", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Session end.
+   */
+  async sessionEnd() {
+    return this.sendTelemetry("game", "session", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading start.
+   */
+  async lobbyLoadingStart() {
+    return this.sendTelemetry("game", "loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading end.
+   */
+  async lobbyLoadingEnd() {
+    return this.sendTelemetry("game", "loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading start.
+   */
+  async gameLoadingStart() {
+    return this.sendTelemetry("game", "game_loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading end.
+   */
+  async gameLoadingEnd() {
+    return this.sendTelemetry("game", "game_loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby initialization.
+   */
+  async lobbyInit() {
+    return this.sendTelemetry("game", "lobby", "init");
+  }
+  /**
+   * Required lifecycle telemetry — Gameplay end.
+   * Also notifies CrazyGames that gameplay has stopped.
+   */
+  async gameplayEnd() {
+    if (this.crazyGamesService) {
+      if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
+      this.crazyGamesService.gameplayStop();
+    }
+    return this.sendTelemetry("game", "gameplay", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Store opened.
+   */
+  async storeOpen() {
+    return this.sendTelemetry("game", "store", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Purchase complete.
+   * @param itemName Name of the purchased item (required by the platform)
+   */
+  async purchaseComplete(itemName) {
+    return this.sendTelemetry("game", "purchase", "complete", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase failed.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseFail(itemName) {
+    return this.sendTelemetry("game", "purchase", "fail", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase cancelled.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseCancel(itemName) {
+    return this.sendTelemetry("game", "purchase", "cancel", null, null, {
+      item_name: itemName
+    });
+  }
   /**
    * Makes an authenticated API call using the JWT token
    * @param endpoint API endpoint path (will be appended to base URL)
@@ -2416,14 +2503,15 @@ var HyveClient = class {
     return this.adsService.show(type);
   }
   /**
-   * Notifies CrazyGames that gameplay has started.
-   * No-op on other platforms.
+   * Required lifecycle telemetry — Gameplay start.
+   * Also notifies CrazyGames that gameplay has started.
    */
   async gameplayStart() {
     if (this.crazyGamesService) {
       if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
       this.crazyGamesService.gameplayStart();
     }
+    return this.sendTelemetry("game", "gameplay", "start");
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.

package/dist/react.mjs

@@ -2055,6 +2055,93 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * Required lifecycle telemetry — Session start.
+   * See https://docs.hyve.gg/docs/telemetry#required-lifecycle-events
+   */
+  async sessionStart() {
+    return this.sendTelemetry("game", "session", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Session end.
+   */
+  async sessionEnd() {
+    return this.sendTelemetry("game", "session", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading start.
+   */
+  async lobbyLoadingStart() {
+    return this.sendTelemetry("game", "loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby loading end.
+   */
+  async lobbyLoadingEnd() {
+    return this.sendTelemetry("game", "loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading start.
+   */
+  async gameLoadingStart() {
+    return this.sendTelemetry("game", "game_loading", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Game loading end.
+   */
+  async gameLoadingEnd() {
+    return this.sendTelemetry("game", "game_loading", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Lobby initialization.
+   */
+  async lobbyInit() {
+    return this.sendTelemetry("game", "lobby", "init");
+  }
+  /**
+   * Required lifecycle telemetry — Gameplay end.
+   * Also notifies CrazyGames that gameplay has stopped.
+   */
+  async gameplayEnd() {
+    if (this.crazyGamesService) {
+      if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
+      this.crazyGamesService.gameplayStop();
+    }
+    return this.sendTelemetry("game", "gameplay", "end");
+  }
+  /**
+   * Required lifecycle telemetry — Store opened.
+   */
+  async storeOpen() {
+    return this.sendTelemetry("game", "store", "start");
+  }
+  /**
+   * Required lifecycle telemetry — Purchase complete.
+   * @param itemName Name of the purchased item (required by the platform)
+   */
+  async purchaseComplete(itemName) {
+    return this.sendTelemetry("game", "purchase", "complete", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase failed.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseFail(itemName) {
+    return this.sendTelemetry("game", "purchase", "fail", null, null, {
+      item_name: itemName
+    });
+  }
+  /**
+   * Required lifecycle telemetry — Purchase cancelled.
+   * @param itemName Name of the item the purchase was for
+   */
+  async purchaseCancel(itemName) {
+    return this.sendTelemetry("game", "purchase", "cancel", null, null, {
+      item_name: itemName
+    });
+  }
   /**
    * Makes an authenticated API call using the JWT token
    * @param endpoint API endpoint path (will be appended to base URL)
@@ -2394,14 +2481,15 @@ var HyveClient = class {
     return this.adsService.show(type);
   }
   /**
-   * Notifies CrazyGames that gameplay has started.
-   * No-op on other platforms.
+   * Required lifecycle telemetry — Gameplay start.
+   * Also notifies CrazyGames that gameplay has started.
    */
   async gameplayStart() {
     if (this.crazyGamesService) {
       if (this.crazyGamesInitPromise) await this.crazyGamesInitPromise;
       this.crazyGamesService.gameplayStart();
     }
+    return this.sendTelemetry("game", "gameplay", "start");
   }
   /**
    * Notifies CrazyGames that gameplay has stopped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyve-sdk/js",
-  "version": "2.11.2",
+  "version": "2.12.0",
   "description": "Hyve SDK - TypeScript wrapper for Hyve game server integration",
   "private": false,
   "publishConfig": {