@hyve-sdk/js 1.5.0 → 1.5.1

package/dist/index.d.mts

@@ -200,6 +200,16 @@ declare class AdsService {
      * Show an ad break
      */
     private showAdBreak;
+    /**
+     * Returns the configured ad lifecycle callbacks.
+     * Used by platform-specific ad providers (e.g. Playgama) to fire the same
+     * onBeforeAd / onAfterAd / onRewardEarned hooks that the Google H5 path uses.
+     */
+    getCallbacks(): {
+        onBeforeAd: (type: AdType) => void;
+        onAfterAd: (type: AdType) => void;
+        onRewardEarned: () => void;
+    };
     /**
      * Check if ads are enabled
      */
@@ -444,6 +454,7 @@ declare class HyveClient {
     private gameId;
     private adsService;
     private playgamaService;
+    private playgamaInitPromise;
     private billingService;
     private billingConfig;
     private billingCallbacks;
@@ -688,6 +699,8 @@ declare class HyveClient {
  */
 
 interface PlaygamaBridgeAdvertisement {
+    isInterstitialSupported: boolean;
+    isRewardedSupported: boolean;
     interstitialState: string;
     rewardedState: string;
     showInterstitial(placement?: string): void;
@@ -698,6 +711,11 @@ interface PlaygamaBridgeAdvertisement {
 interface PlaygamaBridge {
     initialize(): Promise<void>;
     advertisement: PlaygamaBridgeAdvertisement;
+    EVENT_NAME: {
+        INTERSTITIAL_STATE_CHANGED: string;
+        REWARDED_STATE_CHANGED: string;
+        [key: string]: string;
+    };
 }
 declare global {
     interface Window {
@@ -718,8 +736,15 @@ declare class PlaygamaService {
      */
     initialize(): Promise<boolean>;
     isInitialized(): boolean;
-    showInterstitial(): Promise<AdResult>;
-    showRewarded(): Promise<AdResult>;
+    showInterstitial(callbacks?: {
+        onBeforeAd?: () => void;
+        onAfterAd?: () => void;
+    }): Promise<AdResult>;
+    showRewarded(callbacks?: {
+        onBeforeAd?: () => void;
+        onAfterAd?: () => void;
+        onRewardEarned?: () => void;
+    }): Promise<AdResult>;
     private loadScript;
 }
 

package/dist/index.d.ts

@@ -200,6 +200,16 @@ declare class AdsService {
      * Show an ad break
      */
     private showAdBreak;
+    /**
+     * Returns the configured ad lifecycle callbacks.
+     * Used by platform-specific ad providers (e.g. Playgama) to fire the same
+     * onBeforeAd / onAfterAd / onRewardEarned hooks that the Google H5 path uses.
+     */
+    getCallbacks(): {
+        onBeforeAd: (type: AdType) => void;
+        onAfterAd: (type: AdType) => void;
+        onRewardEarned: () => void;
+    };
     /**
      * Check if ads are enabled
      */
@@ -444,6 +454,7 @@ declare class HyveClient {
     private gameId;
     private adsService;
     private playgamaService;
+    private playgamaInitPromise;
     private billingService;
     private billingConfig;
     private billingCallbacks;
@@ -688,6 +699,8 @@ declare class HyveClient {
  */
 
 interface PlaygamaBridgeAdvertisement {
+    isInterstitialSupported: boolean;
+    isRewardedSupported: boolean;
     interstitialState: string;
     rewardedState: string;
     showInterstitial(placement?: string): void;
@@ -698,6 +711,11 @@ interface PlaygamaBridgeAdvertisement {
 interface PlaygamaBridge {
     initialize(): Promise<void>;
     advertisement: PlaygamaBridgeAdvertisement;
+    EVENT_NAME: {
+        INTERSTITIAL_STATE_CHANGED: string;
+        REWARDED_STATE_CHANGED: string;
+        [key: string]: string;
+    };
 }
 declare global {
     interface Window {
@@ -718,8 +736,15 @@ declare class PlaygamaService {
      */
     initialize(): Promise<boolean>;
     isInitialized(): boolean;
-    showInterstitial(): Promise<AdResult>;
-    showRewarded(): Promise<AdResult>;
+    showInterstitial(callbacks?: {
+        onBeforeAd?: () => void;
+        onAfterAd?: () => void;
+    }): Promise<AdResult>;
+    showRewarded(callbacks?: {
+        onBeforeAd?: () => void;
+        onAfterAd?: () => void;
+        onRewardEarned?: () => void;
+    }): Promise<AdResult>;
     private loadScript;
 }
 

package/dist/index.js

@@ -786,6 +786,18 @@ var AdsService = class {
       window.adBreak(adBreakConfig);
     });
   }
+  /**
+   * Returns the configured ad lifecycle callbacks.
+   * Used by platform-specific ad providers (e.g. Playgama) to fire the same
+   * onBeforeAd / onAfterAd / onRewardEarned hooks that the Google H5 path uses.
+   */
+  getCallbacks() {
+    return {
+      onBeforeAd: this.config.onBeforeAd,
+      onAfterAd: this.config.onAfterAd,
+      onRewardEarned: this.config.onRewardEarned
+    };
+  }
   /**
    * Check if ads are enabled
    */
@@ -850,9 +862,10 @@ var PlaygamaService = class {
   isInitialized() {
     return this.initialized;
   }
-  async showInterstitial() {
+  async showInterstitial(callbacks) {
     const requestedAt = Date.now();
-    if (!this.initialized || !window.bridge) {
+    const bridge = window.bridge;
+    if (!this.initialized || !bridge) {
       return {
         success: false,
         type: "interstitial",
@@ -861,13 +874,26 @@ var PlaygamaService = class {
         completedAt: Date.now()
       };
     }
+    if (!bridge.advertisement.isInterstitialSupported) {
+      return {
+        success: false,
+        type: "interstitial",
+        error: new Error("Interstitial ads not supported on this platform"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
     return new Promise((resolve) => {
       const handler = (state) => {
-        if (state === "closed") {
-          window.bridge.advertisement.off("interstitial_state_changed", handler);
+        if (state === "opened") {
+          callbacks?.onBeforeAd?.();
+        } else if (state === "closed") {
+          bridge.advertisement.off(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         } else if (state === "failed") {
-          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          bridge.advertisement.off(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({
             success: false,
             type: "interstitial",
@@ -877,13 +903,14 @@ var PlaygamaService = class {
           });
         }
       };
-      window.bridge.advertisement.on("interstitial_state_changed", handler);
-      window.bridge.advertisement.showInterstitial();
+      bridge.advertisement.on(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+      bridge.advertisement.showInterstitial();
     });
   }
-  async showRewarded() {
+  async showRewarded(callbacks) {
     const requestedAt = Date.now();
-    if (!this.initialized || !window.bridge) {
+    const bridge = window.bridge;
+    if (!this.initialized || !bridge) {
       return {
         success: false,
         type: "rewarded",
@@ -892,13 +919,26 @@ var PlaygamaService = class {
         completedAt: Date.now()
       };
     }
+    if (!bridge.advertisement.isRewardedSupported) {
+      return {
+        success: false,
+        type: "rewarded",
+        error: new Error("Rewarded ads not supported on this platform"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
     return new Promise((resolve) => {
       let rewarded = false;
       const handler = (state) => {
-        if (state === "rewarded") {
+        if (state === "opened") {
+          callbacks?.onBeforeAd?.();
+        } else if (state === "rewarded") {
           rewarded = true;
+          callbacks?.onRewardEarned?.();
         } else if (state === "closed" || state === "failed") {
-          window.bridge.advertisement.off("rewarded_state_changed", handler);
+          bridge.advertisement.off(bridge.EVENT_NAME.REWARDED_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({
             success: rewarded,
             type: "rewarded",
@@ -908,8 +948,8 @@ var PlaygamaService = class {
           });
         }
       };
-      window.bridge.advertisement.on("rewarded_state_changed", handler);
-      window.bridge.advertisement.showRewarded();
+      bridge.advertisement.on(bridge.EVENT_NAME.REWARDED_STATE_CHANGED, handler);
+      bridge.advertisement.showRewarded();
     });
   }
   loadScript() {
@@ -1639,6 +1679,7 @@ var HyveClient = class {
   gameId = null;
   adsService;
   playgamaService = null;
+  playgamaInitPromise = null;
   billingService;
   billingConfig;
   // Store callbacks to preserve them when recreating BillingService
@@ -1668,8 +1709,9 @@ var HyveClient = class {
     }
     if (typeof window !== "undefined" && PlaygamaService.isPlaygamaDomain()) {
       this.playgamaService = new PlaygamaService();
-      this.playgamaService.initialize().then((success) => {
+      this.playgamaInitPromise = this.playgamaService.initialize().then((success) => {
         logger.info("Playgama Bridge initialized:", success);
+        return success;
       });
     }
     this.billingConfig = config?.billing || {};
@@ -2121,9 +2163,24 @@ var HyveClient = class {
    * @returns Promise resolving to ad result
    */
   async showAd(type) {
-    if (this.playgamaService?.isInitialized()) {
-      if (type === "rewarded") return this.playgamaService.showRewarded();
-      return this.playgamaService.showInterstitial();
+    if (this.playgamaService) {
+      if (this.playgamaInitPromise) {
+        await this.playgamaInitPromise;
+      }
+      if (this.playgamaService.isInitialized()) {
+        const { onBeforeAd, onAfterAd, onRewardEarned } = this.adsService.getCallbacks();
+        if (type === "rewarded") {
+          return this.playgamaService.showRewarded({
+            onBeforeAd: () => onBeforeAd("rewarded"),
+            onAfterAd: () => onAfterAd("rewarded"),
+            onRewardEarned
+          });
+        }
+        return this.playgamaService.showInterstitial({
+          onBeforeAd: () => onBeforeAd(type),
+          onAfterAd: () => onAfterAd(type)
+        });
+      }
     }
     return this.adsService.show(type);
   }

package/dist/index.mjs

@@ -743,6 +743,18 @@ var AdsService = class {
       window.adBreak(adBreakConfig);
     });
   }
+  /**
+   * Returns the configured ad lifecycle callbacks.
+   * Used by platform-specific ad providers (e.g. Playgama) to fire the same
+   * onBeforeAd / onAfterAd / onRewardEarned hooks that the Google H5 path uses.
+   */
+  getCallbacks() {
+    return {
+      onBeforeAd: this.config.onBeforeAd,
+      onAfterAd: this.config.onAfterAd,
+      onRewardEarned: this.config.onRewardEarned
+    };
+  }
   /**
    * Check if ads are enabled
    */
@@ -807,9 +819,10 @@ var PlaygamaService = class {
   isInitialized() {
     return this.initialized;
   }
-  async showInterstitial() {
+  async showInterstitial(callbacks) {
     const requestedAt = Date.now();
-    if (!this.initialized || !window.bridge) {
+    const bridge = window.bridge;
+    if (!this.initialized || !bridge) {
       return {
         success: false,
         type: "interstitial",
@@ -818,13 +831,26 @@ var PlaygamaService = class {
         completedAt: Date.now()
       };
     }
+    if (!bridge.advertisement.isInterstitialSupported) {
+      return {
+        success: false,
+        type: "interstitial",
+        error: new Error("Interstitial ads not supported on this platform"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
     return new Promise((resolve) => {
       const handler = (state) => {
-        if (state === "closed") {
-          window.bridge.advertisement.off("interstitial_state_changed", handler);
+        if (state === "opened") {
+          callbacks?.onBeforeAd?.();
+        } else if (state === "closed") {
+          bridge.advertisement.off(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
         } else if (state === "failed") {
-          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          bridge.advertisement.off(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({
             success: false,
             type: "interstitial",
@@ -834,13 +860,14 @@ var PlaygamaService = class {
           });
         }
       };
-      window.bridge.advertisement.on("interstitial_state_changed", handler);
-      window.bridge.advertisement.showInterstitial();
+      bridge.advertisement.on(bridge.EVENT_NAME.INTERSTITIAL_STATE_CHANGED, handler);
+      bridge.advertisement.showInterstitial();
     });
   }
-  async showRewarded() {
+  async showRewarded(callbacks) {
     const requestedAt = Date.now();
-    if (!this.initialized || !window.bridge) {
+    const bridge = window.bridge;
+    if (!this.initialized || !bridge) {
       return {
         success: false,
         type: "rewarded",
@@ -849,13 +876,26 @@ var PlaygamaService = class {
         completedAt: Date.now()
       };
     }
+    if (!bridge.advertisement.isRewardedSupported) {
+      return {
+        success: false,
+        type: "rewarded",
+        error: new Error("Rewarded ads not supported on this platform"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
     return new Promise((resolve) => {
       let rewarded = false;
       const handler = (state) => {
-        if (state === "rewarded") {
+        if (state === "opened") {
+          callbacks?.onBeforeAd?.();
+        } else if (state === "rewarded") {
           rewarded = true;
+          callbacks?.onRewardEarned?.();
         } else if (state === "closed" || state === "failed") {
-          window.bridge.advertisement.off("rewarded_state_changed", handler);
+          bridge.advertisement.off(bridge.EVENT_NAME.REWARDED_STATE_CHANGED, handler);
+          callbacks?.onAfterAd?.();
           resolve({
             success: rewarded,
             type: "rewarded",
@@ -865,8 +905,8 @@ var PlaygamaService = class {
           });
         }
       };
-      window.bridge.advertisement.on("rewarded_state_changed", handler);
-      window.bridge.advertisement.showRewarded();
+      bridge.advertisement.on(bridge.EVENT_NAME.REWARDED_STATE_CHANGED, handler);
+      bridge.advertisement.showRewarded();
     });
   }
   loadScript() {
@@ -1596,6 +1636,7 @@ var HyveClient = class {
   gameId = null;
   adsService;
   playgamaService = null;
+  playgamaInitPromise = null;
   billingService;
   billingConfig;
   // Store callbacks to preserve them when recreating BillingService
@@ -1625,8 +1666,9 @@ var HyveClient = class {
     }
     if (typeof window !== "undefined" && PlaygamaService.isPlaygamaDomain()) {
       this.playgamaService = new PlaygamaService();
-      this.playgamaService.initialize().then((success) => {
+      this.playgamaInitPromise = this.playgamaService.initialize().then((success) => {
         logger.info("Playgama Bridge initialized:", success);
+        return success;
       });
     }
     this.billingConfig = config?.billing || {};
@@ -2078,9 +2120,24 @@ var HyveClient = class {
    * @returns Promise resolving to ad result
    */
   async showAd(type) {
-    if (this.playgamaService?.isInitialized()) {
-      if (type === "rewarded") return this.playgamaService.showRewarded();
-      return this.playgamaService.showInterstitial();
+    if (this.playgamaService) {
+      if (this.playgamaInitPromise) {
+        await this.playgamaInitPromise;
+      }
+      if (this.playgamaService.isInitialized()) {
+        const { onBeforeAd, onAfterAd, onRewardEarned } = this.adsService.getCallbacks();
+        if (type === "rewarded") {
+          return this.playgamaService.showRewarded({
+            onBeforeAd: () => onBeforeAd("rewarded"),
+            onAfterAd: () => onAfterAd("rewarded"),
+            onRewardEarned
+          });
+        }
+        return this.playgamaService.showInterstitial({
+          onBeforeAd: () => onBeforeAd(type),
+          onAfterAd: () => onAfterAd(type)
+        });
+      }
     }
     return this.adsService.show(type);
   }

package/package.json

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