@hyve-sdk/js 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -443,6 +443,7 @@ declare class HyveClient {
     private jwtToken;
     private gameId;
     private adsService;
+    private playgamaService;
     private billingService;
     private billingConfig;
     private billingCallbacks;
@@ -674,6 +675,54 @@ declare class HyveClient {
     onBillingLog(callback: (level: "info" | "warn" | "error", message: string, data?: any) => void): void;
 }
 
+/**
+ * Playgama Bridge integration service
+ *
+ * Loads and initializes the Playgama Bridge SDK when running on a Playgama domain.
+ * The bridge SDK is loaded from CDN and exposes a global `window.bridge` object.
+ *
+ * Detection: Playgama games receive a `platform_id=playgama` URL parameter when
+ * embedded on the platform.
+ *
+ * @packageDocumentation
+ */
+
+interface PlaygamaBridgeAdvertisement {
+    interstitialState: string;
+    rewardedState: string;
+    showInterstitial(placement?: string): void;
+    showRewarded(placement?: string): void;
+    on(event: string, callback: (state: string) => void): void;
+    off(event: string, callback: (state: string) => void): void;
+}
+interface PlaygamaBridge {
+    initialize(): Promise<void>;
+    advertisement: PlaygamaBridgeAdvertisement;
+}
+declare global {
+    interface Window {
+        bridge?: PlaygamaBridge;
+    }
+}
+declare class PlaygamaService {
+    private initialized;
+    /**
+     * Detects if the game is running on the Playgama platform.
+     * Playgama injects a `platform_id=playgama` URL parameter into the game URL.
+     * Falls back to checking document.referrer for playgama.com.
+     */
+    static isPlaygamaDomain(): boolean;
+    /**
+     * Loads the Playgama Bridge script from CDN and initializes it.
+     * Safe to call multiple times - resolves immediately if already initialized.
+     */
+    initialize(): Promise<boolean>;
+    isInitialized(): boolean;
+    showInterstitial(): Promise<AdResult>;
+    showRewarded(): Promise<AdResult>;
+    private loadScript;
+}
+
 /**
  * Storage adapter interface - supports cloud and local implementations
  */
@@ -988,4 +1037,4 @@ declare class NativeBridge {
  */
 declare function generateUUID(): string;
 
-export { type AdConfig$1 as AdConfig, type AdResult, type AdType, AdsService, type BillingConfig, BillingPlatform, type BillingProduct, BillingService, CloudStorageAdapter, type DeleteGameDataResponse, type GameDataBatchItem, type GameDataItem, type GameDataValue, type GetGameDataBatchResponse, type GetGameDataResponse, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, LocalStorageAdapter, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, type PurchaseResult, type SaveGameDataResponse, type StorageAdapter, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };
+export { type AdConfig$1 as AdConfig, type AdResult, type AdType, AdsService, type BillingConfig, BillingPlatform, type BillingProduct, BillingService, CloudStorageAdapter, type DeleteGameDataResponse, type GameDataBatchItem, type GameDataItem, type GameDataValue, type GetGameDataBatchResponse, type GetGameDataResponse, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, LocalStorageAdapter, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, PlaygamaService, type PurchaseResult, type SaveGameDataResponse, type StorageAdapter, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.d.ts

@@ -443,6 +443,7 @@ declare class HyveClient {
     private jwtToken;
     private gameId;
     private adsService;
+    private playgamaService;
     private billingService;
     private billingConfig;
     private billingCallbacks;
@@ -674,6 +675,54 @@ declare class HyveClient {
     onBillingLog(callback: (level: "info" | "warn" | "error", message: string, data?: any) => void): void;
 }
 
+/**
+ * Playgama Bridge integration service
+ *
+ * Loads and initializes the Playgama Bridge SDK when running on a Playgama domain.
+ * The bridge SDK is loaded from CDN and exposes a global `window.bridge` object.
+ *
+ * Detection: Playgama games receive a `platform_id=playgama` URL parameter when
+ * embedded on the platform.
+ *
+ * @packageDocumentation
+ */
+
+interface PlaygamaBridgeAdvertisement {
+    interstitialState: string;
+    rewardedState: string;
+    showInterstitial(placement?: string): void;
+    showRewarded(placement?: string): void;
+    on(event: string, callback: (state: string) => void): void;
+    off(event: string, callback: (state: string) => void): void;
+}
+interface PlaygamaBridge {
+    initialize(): Promise<void>;
+    advertisement: PlaygamaBridgeAdvertisement;
+}
+declare global {
+    interface Window {
+        bridge?: PlaygamaBridge;
+    }
+}
+declare class PlaygamaService {
+    private initialized;
+    /**
+     * Detects if the game is running on the Playgama platform.
+     * Playgama injects a `platform_id=playgama` URL parameter into the game URL.
+     * Falls back to checking document.referrer for playgama.com.
+     */
+    static isPlaygamaDomain(): boolean;
+    /**
+     * Loads the Playgama Bridge script from CDN and initializes it.
+     * Safe to call multiple times - resolves immediately if already initialized.
+     */
+    initialize(): Promise<boolean>;
+    isInitialized(): boolean;
+    showInterstitial(): Promise<AdResult>;
+    showRewarded(): Promise<AdResult>;
+    private loadScript;
+}
+
 /**
  * Storage adapter interface - supports cloud and local implementations
  */
@@ -988,4 +1037,4 @@ declare class NativeBridge {
  */
 declare function generateUUID(): string;
 
-export { type AdConfig$1 as AdConfig, type AdResult, type AdType, AdsService, type BillingConfig, BillingPlatform, type BillingProduct, BillingService, CloudStorageAdapter, type DeleteGameDataResponse, type GameDataBatchItem, type GameDataItem, type GameDataValue, type GetGameDataBatchResponse, type GetGameDataResponse, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, LocalStorageAdapter, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, type PurchaseResult, type SaveGameDataResponse, type StorageAdapter, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };
+export { type AdConfig$1 as AdConfig, type AdResult, type AdType, AdsService, type BillingConfig, BillingPlatform, type BillingProduct, BillingService, CloudStorageAdapter, type DeleteGameDataResponse, type GameDataBatchItem, type GameDataItem, type GameDataValue, type GetGameDataBatchResponse, type GetGameDataResponse, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, LocalStorageAdapter, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, PlaygamaService, type PurchaseResult, type SaveGameDataResponse, type StorageAdapter, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   Logger: () => Logger,
   NativeBridge: () => NativeBridge,
   NativeMessageType: () => NativeMessageType,
+  PlaygamaService: () => PlaygamaService,
   generateUUID: () => generateUUID,
   handleVerifyMessage: () => handleVerifyMessage,
   isDomainAllowed: () => isDomainAllowed,
@@ -799,6 +800,133 @@ var AdsService = class {
   }
 };
 
+// src/services/playgama.ts
+var PLAYGAMA_BRIDGE_CDN = "https://bridge.playgama.com/v1/stable/playgama-bridge.js";
+var PlaygamaService = class {
+  initialized = false;
+  /**
+   * Detects if the game is running on the Playgama platform.
+   * Playgama injects a `platform_id=playgama` URL parameter into the game URL.
+   * Falls back to checking document.referrer for playgama.com.
+   */
+  static isPlaygamaDomain() {
+    try {
+      const url = new URL(window.location.href);
+      if (url.searchParams.get("platform_id") === "playgama") {
+        return true;
+      }
+      if (document.referrer.includes("playgama.com")) {
+        return true;
+      }
+      if (window !== window.top) {
+        try {
+          if (window.parent.location.hostname.includes("playgama.com")) {
+            return true;
+          }
+        } catch {
+        }
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Loads the Playgama Bridge script from CDN and initializes it.
+   * Safe to call multiple times - resolves immediately if already initialized.
+   */
+  async initialize() {
+    if (this.initialized) return true;
+    try {
+      await this.loadScript();
+      await window.bridge.initialize();
+      this.initialized = true;
+      return true;
+    } catch (error) {
+      console.warn("[PlaygamaService] Failed to initialize:", error);
+      return false;
+    }
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  async showInterstitial() {
+    const requestedAt = Date.now();
+    if (!this.initialized || !window.bridge) {
+      return {
+        success: false,
+        type: "interstitial",
+        error: new Error("Playgama not initialized"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return new Promise((resolve) => {
+      const handler = (state) => {
+        if (state === "closed") {
+          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
+        } else if (state === "failed") {
+          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          resolve({
+            success: false,
+            type: "interstitial",
+            error: new Error("Interstitial ad failed"),
+            requestedAt,
+            completedAt: Date.now()
+          });
+        }
+      };
+      window.bridge.advertisement.on("interstitial_state_changed", handler);
+      window.bridge.advertisement.showInterstitial();
+    });
+  }
+  async showRewarded() {
+    const requestedAt = Date.now();
+    if (!this.initialized || !window.bridge) {
+      return {
+        success: false,
+        type: "rewarded",
+        error: new Error("Playgama not initialized"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return new Promise((resolve) => {
+      let rewarded = false;
+      const handler = (state) => {
+        if (state === "rewarded") {
+          rewarded = true;
+        } else if (state === "closed" || state === "failed") {
+          window.bridge.advertisement.off("rewarded_state_changed", handler);
+          resolve({
+            success: rewarded,
+            type: "rewarded",
+            error: !rewarded ? new Error("Rewarded ad not completed") : void 0,
+            requestedAt,
+            completedAt: Date.now()
+          });
+        }
+      };
+      window.bridge.advertisement.on("rewarded_state_changed", handler);
+      window.bridge.advertisement.showRewarded();
+    });
+  }
+  loadScript() {
+    return new Promise((resolve, reject) => {
+      if (window.bridge) {
+        resolve();
+        return;
+      }
+      const script = document.createElement("script");
+      script.src = PLAYGAMA_BRIDGE_CDN;
+      script.onload = () => resolve();
+      script.onerror = () => reject(new Error("Failed to load Playgama Bridge script"));
+      document.head.appendChild(script);
+    });
+  }
+};
+
 // src/services/billing.ts
 var BillingPlatform = /* @__PURE__ */ ((BillingPlatform3) => {
   BillingPlatform3["WEB"] = "web";
@@ -1251,14 +1379,21 @@ var BillingService = class {
       throw new Error("Stripe not initialized");
     }
     try {
+      if (this.checkoutElement) {
+        this.log("info", "[BillingService] Unmounting existing checkout element");
+        this.unmountCheckoutElement();
+        await new Promise((resolve) => setTimeout(resolve, 100));
+      }
       const container = document.getElementById(elementId);
       if (!container) {
         throw new Error(`Element with id "${elementId}" not found in the DOM`);
       }
       container.innerHTML = "";
+      this.log("info", "[BillingService] Creating new checkout instance");
       this.checkoutElement = await this.stripe.initEmbeddedCheckout({
         clientSecret
       });
+      this.log("info", "[BillingService] Mounting checkout element to DOM");
       this.checkoutElement.mount(`#${elementId}`);
       this.setupCheckoutEventListeners();
     } catch (error) {
@@ -1296,7 +1431,14 @@ var BillingService = class {
    */
   unmountCheckoutElement() {
     if (this.checkoutElement) {
-      this.checkoutElement.unmount();
+      try {
+        this.checkoutElement.unmount();
+        if (typeof this.checkoutElement.destroy === "function") {
+          this.checkoutElement.destroy();
+        }
+      } catch (error) {
+        this.log("warn", "[BillingService] Error unmounting checkout element:", error?.message);
+      }
       this.checkoutElement = null;
     }
   }
@@ -1496,6 +1638,7 @@ var HyveClient = class {
   jwtToken = null;
   gameId = null;
   adsService;
+  playgamaService = null;
   billingService;
   billingConfig;
   // Store callbacks to preserve them when recreating BillingService
@@ -1523,6 +1666,12 @@ var HyveClient = class {
     if (config?.ads) {
       this.adsService.configure(config.ads);
     }
+    if (typeof window !== "undefined" && PlaygamaService.isPlaygamaDomain()) {
+      this.playgamaService = new PlaygamaService();
+      this.playgamaService.initialize().then((success) => {
+        logger.info("Playgama Bridge initialized:", success);
+      });
+    }
     this.billingConfig = config?.billing || {};
     this.billingService = new BillingService(this.billingConfig);
     this.storageMode = config?.storageMode || "cloud";
@@ -1542,6 +1691,7 @@ var HyveClient = class {
     );
     logger.info("API Base URL:", this.apiBaseUrl);
     logger.info("Ads enabled:", this.adsService.isEnabled());
+    logger.info("Playgama platform:", this.playgamaService !== null);
     logger.info(
       "Billing configured:",
       Object.keys(this.billingConfig).length > 0
@@ -1971,6 +2121,10 @@ 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();
+    }
     return this.adsService.show(type);
   }
   /**
@@ -2100,6 +2254,7 @@ var HyveClient = class {
   Logger,
   NativeBridge,
   NativeMessageType,
+  PlaygamaService,
   generateUUID,
   handleVerifyMessage,
   isDomainAllowed,

package/dist/index.mjs

@@ -757,6 +757,133 @@ var AdsService = class {
   }
 };
 
+// src/services/playgama.ts
+var PLAYGAMA_BRIDGE_CDN = "https://bridge.playgama.com/v1/stable/playgama-bridge.js";
+var PlaygamaService = class {
+  initialized = false;
+  /**
+   * Detects if the game is running on the Playgama platform.
+   * Playgama injects a `platform_id=playgama` URL parameter into the game URL.
+   * Falls back to checking document.referrer for playgama.com.
+   */
+  static isPlaygamaDomain() {
+    try {
+      const url = new URL(window.location.href);
+      if (url.searchParams.get("platform_id") === "playgama") {
+        return true;
+      }
+      if (document.referrer.includes("playgama.com")) {
+        return true;
+      }
+      if (window !== window.top) {
+        try {
+          if (window.parent.location.hostname.includes("playgama.com")) {
+            return true;
+          }
+        } catch {
+        }
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Loads the Playgama Bridge script from CDN and initializes it.
+   * Safe to call multiple times - resolves immediately if already initialized.
+   */
+  async initialize() {
+    if (this.initialized) return true;
+    try {
+      await this.loadScript();
+      await window.bridge.initialize();
+      this.initialized = true;
+      return true;
+    } catch (error) {
+      console.warn("[PlaygamaService] Failed to initialize:", error);
+      return false;
+    }
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  async showInterstitial() {
+    const requestedAt = Date.now();
+    if (!this.initialized || !window.bridge) {
+      return {
+        success: false,
+        type: "interstitial",
+        error: new Error("Playgama not initialized"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return new Promise((resolve) => {
+      const handler = (state) => {
+        if (state === "closed") {
+          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          resolve({ success: true, type: "interstitial", requestedAt, completedAt: Date.now() });
+        } else if (state === "failed") {
+          window.bridge.advertisement.off("interstitial_state_changed", handler);
+          resolve({
+            success: false,
+            type: "interstitial",
+            error: new Error("Interstitial ad failed"),
+            requestedAt,
+            completedAt: Date.now()
+          });
+        }
+      };
+      window.bridge.advertisement.on("interstitial_state_changed", handler);
+      window.bridge.advertisement.showInterstitial();
+    });
+  }
+  async showRewarded() {
+    const requestedAt = Date.now();
+    if (!this.initialized || !window.bridge) {
+      return {
+        success: false,
+        type: "rewarded",
+        error: new Error("Playgama not initialized"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return new Promise((resolve) => {
+      let rewarded = false;
+      const handler = (state) => {
+        if (state === "rewarded") {
+          rewarded = true;
+        } else if (state === "closed" || state === "failed") {
+          window.bridge.advertisement.off("rewarded_state_changed", handler);
+          resolve({
+            success: rewarded,
+            type: "rewarded",
+            error: !rewarded ? new Error("Rewarded ad not completed") : void 0,
+            requestedAt,
+            completedAt: Date.now()
+          });
+        }
+      };
+      window.bridge.advertisement.on("rewarded_state_changed", handler);
+      window.bridge.advertisement.showRewarded();
+    });
+  }
+  loadScript() {
+    return new Promise((resolve, reject) => {
+      if (window.bridge) {
+        resolve();
+        return;
+      }
+      const script = document.createElement("script");
+      script.src = PLAYGAMA_BRIDGE_CDN;
+      script.onload = () => resolve();
+      script.onerror = () => reject(new Error("Failed to load Playgama Bridge script"));
+      document.head.appendChild(script);
+    });
+  }
+};
+
 // src/services/billing.ts
 var BillingPlatform = /* @__PURE__ */ ((BillingPlatform3) => {
   BillingPlatform3["WEB"] = "web";
@@ -1209,14 +1336,21 @@ var BillingService = class {
       throw new Error("Stripe not initialized");
     }
     try {
+      if (this.checkoutElement) {
+        this.log("info", "[BillingService] Unmounting existing checkout element");
+        this.unmountCheckoutElement();
+        await new Promise((resolve) => setTimeout(resolve, 100));
+      }
       const container = document.getElementById(elementId);
       if (!container) {
         throw new Error(`Element with id "${elementId}" not found in the DOM`);
       }
       container.innerHTML = "";
+      this.log("info", "[BillingService] Creating new checkout instance");
       this.checkoutElement = await this.stripe.initEmbeddedCheckout({
         clientSecret
       });
+      this.log("info", "[BillingService] Mounting checkout element to DOM");
       this.checkoutElement.mount(`#${elementId}`);
       this.setupCheckoutEventListeners();
     } catch (error) {
@@ -1254,7 +1388,14 @@ var BillingService = class {
    */
   unmountCheckoutElement() {
     if (this.checkoutElement) {
-      this.checkoutElement.unmount();
+      try {
+        this.checkoutElement.unmount();
+        if (typeof this.checkoutElement.destroy === "function") {
+          this.checkoutElement.destroy();
+        }
+      } catch (error) {
+        this.log("warn", "[BillingService] Error unmounting checkout element:", error?.message);
+      }
       this.checkoutElement = null;
     }
   }
@@ -1454,6 +1595,7 @@ var HyveClient = class {
   jwtToken = null;
   gameId = null;
   adsService;
+  playgamaService = null;
   billingService;
   billingConfig;
   // Store callbacks to preserve them when recreating BillingService
@@ -1481,6 +1623,12 @@ var HyveClient = class {
     if (config?.ads) {
       this.adsService.configure(config.ads);
     }
+    if (typeof window !== "undefined" && PlaygamaService.isPlaygamaDomain()) {
+      this.playgamaService = new PlaygamaService();
+      this.playgamaService.initialize().then((success) => {
+        logger.info("Playgama Bridge initialized:", success);
+      });
+    }
     this.billingConfig = config?.billing || {};
     this.billingService = new BillingService(this.billingConfig);
     this.storageMode = config?.storageMode || "cloud";
@@ -1500,6 +1648,7 @@ var HyveClient = class {
     );
     logger.info("API Base URL:", this.apiBaseUrl);
     logger.info("Ads enabled:", this.adsService.isEnabled());
+    logger.info("Playgama platform:", this.playgamaService !== null);
     logger.info(
       "Billing configured:",
       Object.keys(this.billingConfig).length > 0
@@ -1929,6 +2078,10 @@ 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();
+    }
     return this.adsService.show(type);
   }
   /**
@@ -2057,6 +2210,7 @@ export {
   Logger,
   NativeBridge,
   NativeMessageType,
+  PlaygamaService,
   generateUUID,
   handleVerifyMessage,
   isDomainAllowed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyve-sdk/js",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Hyve SDK - TypeScript wrapper for Hyve game server integration",
   "private": false,
   "publishConfig": {
@@ -15,6 +15,14 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "prepublishOnly": "pnpm run build && pnpm run check-types",
+    "publish:npm": "pnpm publish --access public",
+    "publish:dry-run": "pnpm publish --dry-run --access public --no-git-checks"
+  },
   "keywords": [
     "hyve",
     "game",
@@ -48,18 +56,11 @@
     }
   },
   "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
     "@types/minimatch": "^5.1.2",
     "@types/uuid": "^10.0.0",
     "tsup": "^8.4.0",
-    "typescript": "^5.3.3",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
-  },
-  "scripts": {
-    "lint": "eslint . --max-warnings 0",
-    "check-types": "tsc --noEmit",
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "publish:npm": "pnpm publish --access public",
-    "publish:dry-run": "pnpm publish --dry-run --access public --no-git-checks"
+    "typescript": "^5.3.3"
   }
-}
+}