@hyve-sdk/js 1.3.1-canary.0 → 1.3.1

package/README.md

@@ -20,6 +20,7 @@ pnpm add @hyve-sdk/js
 - **API Integration**: Authenticated API calls with JWT token support
 - **Inventory Management**: Built-in methods for user inventory operations
 - **Telemetry Tracking**: Session-based analytics and event tracking
+- **Ads Integration**: Google H5 Games Ads support (disabled by default)
 - **Native Bridge**: Type-safe communication with React Native WebView apps
 - **Security Utilities**: Domain validation and referrer checking
 - **URL Parameter Parsing**: Easy extraction of authentication parameters
@@ -279,6 +280,100 @@ if (item.metadata) {
 - `GET /api/v1/inventory` - Get all inventory items
 - `GET /api/v1/inventory/:id` - Get specific item
 
+## Ads Integration
+
+The SDK includes support for Google H5 Games Ads. **Ads are disabled by default** and must be explicitly enabled in the configuration.
+
+### Quick Start
+
+```typescript
+import { HyveClient } from "@hyve-sdk/js";
+
+// Enable ads in initial config
+const client = new HyveClient({
+  isDev: true,
+  ads: {
+    enabled: true,  // Must be set to true
+    sound: 'on',
+    debug: true,
+    onBeforeAd: (type) => {
+      console.log('Pausing game for ad:', type);
+      game.pause();
+    },
+    onAfterAd: (type) => {
+      console.log('Resuming game after ad');
+      game.resume();
+    },
+    onRewardEarned: () => {
+      console.log('User earned reward!');
+      player.coins += 100;
+    }
+  }
+});
+
+// Show different ad types
+const result = await client.showAd('rewarded');
+if (result.success) {
+  console.log('User watched the ad!');
+}
+
+await client.showAd('interstitial');  // Between levels
+await client.showAd('preroll');       // Game start
+```
+
+### Prerequisites
+
+Add the Google H5 Games Ads SDK to your HTML:
+
+```html
+<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
+<script>
+  window.adBreak = window.adBreak || function(o) {
+    (window.adsbygoogle = window.adsbygoogle || []).push(o);
+  };
+  window.adConfig = window.adConfig || function(o) {
+    (window.adsbygoogle = window.adsbygoogle || []).push(o);
+  };
+</script>
+```
+
+### Ad Types
+
+| Type | Use Case |
+|------|----------|
+| `rewarded` | User watches full ad for reward (coins, lives, etc.) |
+| `interstitial` | Between levels or game screens |
+| `preroll` | Before game starts |
+
+### Configuration
+
+```typescript
+interface AdConfig {
+  enabled?: boolean;           // Enable/disable ads (default: false)
+  sound?: 'on' | 'off';       // Sound setting (default: 'on')
+  debug?: boolean;             // Enable debug logging (default: false)
+  onBeforeAd?: (type) => void; // Called before ad shows
+  onAfterAd?: (type) => void;  // Called after ad finishes
+  onRewardEarned?: () => void; // Called when user earns reward
+}
+```
+
+### Methods
+
+```typescript
+// Configure ads after initialization
+client.configureAds({ enabled: true, sound: 'off' });
+
+// Show an ad
+const result = await client.showAd('rewarded');
+
+// Check status
+client.areAdsEnabled();  // Boolean
+client.areAdsReady();    // Boolean
+```
+
+See [docs/ads.md](./docs/ads.md) for detailed documentation and examples.
+
 **Requirements:**
 - JWT token must be available (via `hyve-access` URL parameter)
 - User must be authenticated

package/dist/index.d.mts

@@ -63,7 +63,121 @@ interface Inventory {
     items: InventoryItem[];
     total_count: number;
 }
+/**
+ * Ads configuration options
+ * Ads are disabled by default and must be explicitly enabled
+ */
+interface AdConfig$1 {
+    /** Enable/disable ads (default: false) */
+    enabled?: boolean;
+    /** Sound setting for ads (default: 'on') */
+    sound?: 'on' | 'off';
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Callback before ad is shown */
+    onBeforeAd?: (type: 'rewarded' | 'interstitial' | 'preroll') => void;
+    /** Callback after ad is shown */
+    onAfterAd?: (type: 'rewarded' | 'interstitial' | 'preroll') => void;
+    /** Callback when user earns a reward (rewarded ads only) */
+    onRewardEarned?: () => void;
+}
+
+/**
+ * Ads Service for Hyve SDK
+ *
+ * Simple wrapper around Google H5 Games Ads with configurable enable/disable.
+ * Ads are OFF by default and must be explicitly enabled in SDK config.
+ *
+ * Prerequisites:
+ * - Google H5 Games Ads SDK script must be loaded in HTML:
+ *   <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
+ *   <script>
+ *     window.adBreak = window.adBreak || function(o) { (window.adsbygoogle = window.adsbygoogle || []).push(o); };
+ *     window.adConfig = window.adConfig || function(o) { (window.adsbygoogle = window.adsbygoogle || []).push(o); };
+ *   </script>
+ *
+ * @packageDocumentation
+ */
+type AdType = 'rewarded' | 'interstitial' | 'preroll';
+interface AdResult {
+    success: boolean;
+    type: AdType;
+    error?: Error;
+    requestedAt: number;
+    completedAt: number;
+}
+interface AdConfig {
+    enabled?: boolean;
+    sound?: 'on' | 'off';
+    debug?: boolean;
+    onBeforeAd?: (type: AdType) => void;
+    onAfterAd?: (type: AdType) => void;
+    onRewardEarned?: () => void;
+}
+interface GoogleAdBreakConfig {
+    type: 'reward' | 'next' | 'start';
+    name: string;
+    beforeAd?: () => void;
+    afterAd?: () => void;
+    beforeReward?: (showAdFn: () => void) => void;
+    adViewed?: () => void;
+    adDismissed?: () => void;
+    adBreakDone?: (info?: any) => void;
+}
+interface GoogleAdConfigOptions {
+    sound?: 'on' | 'off';
+    preloadAdBreaks?: 'on' | 'off';
+    onReady?: () => void;
+}
+declare global {
+    interface Window {
+        adBreak?: (config: GoogleAdBreakConfig) => void;
+        adConfig?: (config: GoogleAdConfigOptions) => void;
+    }
+}
+/**
+ * Simple Ads Manager
+ * Ads are disabled by default
+ */
+declare class AdsService {
+    private config;
+    private initialized;
+    private ready;
+    /**
+     * Configure the ads service
+     * Must set enabled: true to activate ads
+     */
+    configure(config: AdConfig): void;
+    /**
+     * Initialize the ads system
+     */
+    private initialize;
+    /**
+     * Show an ad
+     * Returns immediately if ads are disabled
+     */
+    show(type: AdType): Promise<AdResult>;
+    /**
+     * Show an ad break
+     */
+    private showAdBreak;
+    /**
+     * Check if ads are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Check if ads are ready to show
+     */
+    isReady(): boolean;
+}
 
+/**
+ * HyveClient configuration options
+ */
+interface HyveClientConfig extends TelemetryConfig {
+    /** Ads configuration (disabled by default) */
+    ads?: AdConfig$1;
+}
 /**
  * HyveClient provides telemetry and authentication functionality for Hyve games
  */
@@ -74,11 +188,12 @@ declare class HyveClient {
     private userId;
     private jwtToken;
     private gameId;
+    private adsService;
     /**
      * Creates a new HyveClient instance
-     * @param config Optional telemetry configuration
+     * @param config Optional configuration including telemetry and ads
      */
-    constructor(config?: TelemetryConfig);
+    constructor(config?: HyveClientConfig);
     /**
      * Authenticates a user from URL parameters
      * @param urlParams URL parameters or search string
@@ -165,6 +280,27 @@ declare class HyveClient {
      * Resets the client state
      */
     reset(): void;
+    /**
+     * Configure ads service
+     * @param config Ads configuration
+     */
+    configureAds(config: AdConfig$1): void;
+    /**
+     * Show an ad
+     * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
+     * @returns Promise resolving to ad result
+     */
+    showAd(type: AdType): Promise<AdResult>;
+    /**
+     * Check if ads are enabled
+     * @returns Boolean indicating if ads are enabled
+     */
+    areAdsEnabled(): boolean;
+    /**
+     * Check if ads are ready to show
+     * @returns Boolean indicating if ads are ready
+     */
+    areAdsReady(): boolean;
 }
 
 /**
@@ -440,4 +576,4 @@ declare class NativeBridge {
  */
 declare function generateUUID(): string;
 
-export { HyveClient, type Inventory, type InventoryItem, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, 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, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.d.ts

@@ -63,7 +63,121 @@ interface Inventory {
     items: InventoryItem[];
     total_count: number;
 }
+/**
+ * Ads configuration options
+ * Ads are disabled by default and must be explicitly enabled
+ */
+interface AdConfig$1 {
+    /** Enable/disable ads (default: false) */
+    enabled?: boolean;
+    /** Sound setting for ads (default: 'on') */
+    sound?: 'on' | 'off';
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Callback before ad is shown */
+    onBeforeAd?: (type: 'rewarded' | 'interstitial' | 'preroll') => void;
+    /** Callback after ad is shown */
+    onAfterAd?: (type: 'rewarded' | 'interstitial' | 'preroll') => void;
+    /** Callback when user earns a reward (rewarded ads only) */
+    onRewardEarned?: () => void;
+}
+
+/**
+ * Ads Service for Hyve SDK
+ *
+ * Simple wrapper around Google H5 Games Ads with configurable enable/disable.
+ * Ads are OFF by default and must be explicitly enabled in SDK config.
+ *
+ * Prerequisites:
+ * - Google H5 Games Ads SDK script must be loaded in HTML:
+ *   <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
+ *   <script>
+ *     window.adBreak = window.adBreak || function(o) { (window.adsbygoogle = window.adsbygoogle || []).push(o); };
+ *     window.adConfig = window.adConfig || function(o) { (window.adsbygoogle = window.adsbygoogle || []).push(o); };
+ *   </script>
+ *
+ * @packageDocumentation
+ */
+type AdType = 'rewarded' | 'interstitial' | 'preroll';
+interface AdResult {
+    success: boolean;
+    type: AdType;
+    error?: Error;
+    requestedAt: number;
+    completedAt: number;
+}
+interface AdConfig {
+    enabled?: boolean;
+    sound?: 'on' | 'off';
+    debug?: boolean;
+    onBeforeAd?: (type: AdType) => void;
+    onAfterAd?: (type: AdType) => void;
+    onRewardEarned?: () => void;
+}
+interface GoogleAdBreakConfig {
+    type: 'reward' | 'next' | 'start';
+    name: string;
+    beforeAd?: () => void;
+    afterAd?: () => void;
+    beforeReward?: (showAdFn: () => void) => void;
+    adViewed?: () => void;
+    adDismissed?: () => void;
+    adBreakDone?: (info?: any) => void;
+}
+interface GoogleAdConfigOptions {
+    sound?: 'on' | 'off';
+    preloadAdBreaks?: 'on' | 'off';
+    onReady?: () => void;
+}
+declare global {
+    interface Window {
+        adBreak?: (config: GoogleAdBreakConfig) => void;
+        adConfig?: (config: GoogleAdConfigOptions) => void;
+    }
+}
+/**
+ * Simple Ads Manager
+ * Ads are disabled by default
+ */
+declare class AdsService {
+    private config;
+    private initialized;
+    private ready;
+    /**
+     * Configure the ads service
+     * Must set enabled: true to activate ads
+     */
+    configure(config: AdConfig): void;
+    /**
+     * Initialize the ads system
+     */
+    private initialize;
+    /**
+     * Show an ad
+     * Returns immediately if ads are disabled
+     */
+    show(type: AdType): Promise<AdResult>;
+    /**
+     * Show an ad break
+     */
+    private showAdBreak;
+    /**
+     * Check if ads are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Check if ads are ready to show
+     */
+    isReady(): boolean;
+}
 
+/**
+ * HyveClient configuration options
+ */
+interface HyveClientConfig extends TelemetryConfig {
+    /** Ads configuration (disabled by default) */
+    ads?: AdConfig$1;
+}
 /**
  * HyveClient provides telemetry and authentication functionality for Hyve games
  */
@@ -74,11 +188,12 @@ declare class HyveClient {
     private userId;
     private jwtToken;
     private gameId;
+    private adsService;
     /**
      * Creates a new HyveClient instance
-     * @param config Optional telemetry configuration
+     * @param config Optional configuration including telemetry and ads
      */
-    constructor(config?: TelemetryConfig);
+    constructor(config?: HyveClientConfig);
     /**
      * Authenticates a user from URL parameters
      * @param urlParams URL parameters or search string
@@ -165,6 +280,27 @@ declare class HyveClient {
      * Resets the client state
      */
     reset(): void;
+    /**
+     * Configure ads service
+     * @param config Ads configuration
+     */
+    configureAds(config: AdConfig$1): void;
+    /**
+     * Show an ad
+     * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
+     * @returns Promise resolving to ad result
+     */
+    showAd(type: AdType): Promise<AdResult>;
+    /**
+     * Check if ads are enabled
+     * @returns Boolean indicating if ads are enabled
+     */
+    areAdsEnabled(): boolean;
+    /**
+     * Check if ads are ready to show
+     * @returns Boolean indicating if ads are ready
+     */
+    areAdsReady(): boolean;
 }
 
 /**
@@ -440,4 +576,4 @@ declare class NativeBridge {
  */
 declare function generateUUID(): string;
 
-export { HyveClient, type Inventory, type InventoryItem, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, 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, HyveClient, type HyveClientConfig, type Inventory, type InventoryItem, Logger, NativeBridge, type NativeMessage, type NativeMessageHandler, NativeMessageType, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, logger, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AdsService: () => AdsService,
   HyveClient: () => HyveClient,
   Logger: () => Logger,
   NativeBridge: () => NativeBridge,
@@ -520,6 +521,193 @@ function generateUUID() {
   return (0, import_uuid.v4)();
 }
 
+// src/services/ads.ts
+var AdsService = class {
+  config = {
+    enabled: false,
+    sound: "on",
+    debug: false,
+    onBeforeAd: () => {
+    },
+    onAfterAd: () => {
+    },
+    onRewardEarned: () => {
+    }
+  };
+  initialized = false;
+  ready = false;
+  /**
+   * Configure the ads service
+   * Must set enabled: true to activate ads
+   */
+  configure(config) {
+    this.config = {
+      ...this.config,
+      ...config,
+      onBeforeAd: config.onBeforeAd || this.config.onBeforeAd,
+      onAfterAd: config.onAfterAd || this.config.onAfterAd,
+      onRewardEarned: config.onRewardEarned || this.config.onRewardEarned
+    };
+    if (this.config.debug) {
+      console.log("[AdsService] Configuration updated:", {
+        enabled: this.config.enabled,
+        sound: this.config.sound
+      });
+    }
+    if (this.config.enabled && !this.initialized) {
+      this.initialize();
+    }
+  }
+  /**
+   * Initialize the ads system
+   */
+  initialize() {
+    if (this.initialized) return;
+    if (!this.config.enabled) {
+      if (this.config.debug) {
+        console.log("[AdsService] Ads disabled, skipping initialization");
+      }
+      return;
+    }
+    if (!window.adConfig || !window.adBreak) {
+      console.warn("[AdsService] Google Ads SDK not found. Ads will not be available.");
+      return;
+    }
+    if (this.config.debug) {
+      console.log("[AdsService] Initializing ads system...");
+    }
+    const googleConfig = {
+      sound: this.config.sound,
+      preloadAdBreaks: "on",
+      onReady: () => {
+        this.ready = true;
+        if (this.config.debug) {
+          console.log("[AdsService] Ads ready");
+        }
+      }
+    };
+    window.adConfig(googleConfig);
+    this.initialized = true;
+  }
+  /**
+   * Show an ad
+   * Returns immediately if ads are disabled
+   */
+  async show(type) {
+    const requestedAt = Date.now();
+    if (!this.config.enabled) {
+      if (this.config.debug) {
+        console.log("[AdsService] Ads disabled, skipping ad request");
+      }
+      return {
+        success: false,
+        type,
+        error: new Error("Ads are disabled"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    if (!this.initialized) {
+      this.initialize();
+    }
+    if (!this.ready || !window.adBreak) {
+      return {
+        success: false,
+        type,
+        error: new Error("Ads not ready"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return this.showAdBreak(type);
+  }
+  /**
+   * Show an ad break
+   */
+  async showAdBreak(type) {
+    const requestedAt = Date.now();
+    return new Promise((resolve) => {
+      const googleType = type === "rewarded" ? "reward" : type === "preroll" ? "start" : "next";
+      const adName = `${type}-ad-${Date.now()}`;
+      if (this.config.debug) {
+        console.log(`[AdsService] Showing ${type} ad`);
+      }
+      this.config.onBeforeAd(type);
+      const adBreakConfig = {
+        type: googleType,
+        name: adName,
+        beforeAd: () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Ad started");
+          }
+        },
+        afterAd: () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Ad finished");
+          }
+          this.config.onAfterAd(type);
+        },
+        adBreakDone: (info) => {
+          const completedAt = Date.now();
+          let success = false;
+          if (type === "rewarded") {
+            success = info?.breakStatus === "viewed";
+          } else {
+            success = info?.breakStatus !== "error";
+          }
+          const error = info?.breakStatus === "error" && info?.error ? new Error(info.error) : void 0;
+          if (this.config.debug) {
+            console.log("[AdsService] Ad break done:", {
+              success,
+              status: info?.breakStatus
+            });
+          }
+          const result = {
+            success,
+            type,
+            error,
+            requestedAt,
+            completedAt
+          };
+          resolve(result);
+        }
+      };
+      if (type === "rewarded") {
+        adBreakConfig.beforeReward = (showAdFn) => {
+          if (this.config.debug) {
+            console.log("[AdsService] beforeReward callback");
+          }
+          showAdFn();
+        };
+        adBreakConfig.adViewed = () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Rewarded ad watched successfully");
+          }
+          this.config.onRewardEarned();
+        };
+        adBreakConfig.adDismissed = () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Rewarded ad dismissed");
+          }
+        };
+      }
+      window.adBreak(adBreakConfig);
+    });
+  }
+  /**
+   * Check if ads are enabled
+   */
+  isEnabled() {
+    return this.config.enabled;
+  }
+  /**
+   * Check if ads are ready to show
+   */
+  isReady() {
+    return this.config.enabled && this.ready;
+  }
+};
+
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
@@ -528,9 +716,10 @@ var HyveClient = class {
   userId = null;
   jwtToken = null;
   gameId = null;
+  adsService;
   /**
    * Creates a new HyveClient instance
-   * @param config Optional telemetry configuration
+   * @param config Optional configuration including telemetry and ads
    */
   constructor(config) {
     this.telemetryConfig = {
@@ -544,9 +733,14 @@ var HyveClient = class {
       this.apiBaseUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
     }
     this.sessionId = generateUUID();
+    this.adsService = new AdsService();
+    if (config?.ads) {
+      this.adsService.configure(config.ads);
+    }
     logger.info("Client initialized with sessionId:", this.sessionId);
     logger.info("API Base URL:", this.apiBaseUrl);
     logger.info("Environment:", this.telemetryConfig.isDev ? "dev" : "prod");
+    logger.info("Ads enabled:", this.adsService.isEnabled());
   }
   /**
    * Authenticates a user from URL parameters
@@ -794,9 +988,40 @@ var HyveClient = class {
     this.sessionId = generateUUID();
     logger.info("Client reset with new sessionId:", this.sessionId);
   }
+  /**
+   * Configure ads service
+   * @param config Ads configuration
+   */
+  configureAds(config) {
+    this.adsService.configure(config);
+    logger.info("Ads configuration updated");
+  }
+  /**
+   * Show an ad
+   * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
+   * @returns Promise resolving to ad result
+   */
+  async showAd(type) {
+    return this.adsService.show(type);
+  }
+  /**
+   * Check if ads are enabled
+   * @returns Boolean indicating if ads are enabled
+   */
+  areAdsEnabled() {
+    return this.adsService.isEnabled();
+  }
+  /**
+   * Check if ads are ready to show
+   * @returns Boolean indicating if ads are ready
+   */
+  areAdsReady() {
+    return this.adsService.isReady();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AdsService,
   HyveClient,
   Logger,
   NativeBridge,

package/dist/index.mjs

@@ -483,6 +483,193 @@ function generateUUID() {
   return uuidv4();
 }
 
+// src/services/ads.ts
+var AdsService = class {
+  config = {
+    enabled: false,
+    sound: "on",
+    debug: false,
+    onBeforeAd: () => {
+    },
+    onAfterAd: () => {
+    },
+    onRewardEarned: () => {
+    }
+  };
+  initialized = false;
+  ready = false;
+  /**
+   * Configure the ads service
+   * Must set enabled: true to activate ads
+   */
+  configure(config) {
+    this.config = {
+      ...this.config,
+      ...config,
+      onBeforeAd: config.onBeforeAd || this.config.onBeforeAd,
+      onAfterAd: config.onAfterAd || this.config.onAfterAd,
+      onRewardEarned: config.onRewardEarned || this.config.onRewardEarned
+    };
+    if (this.config.debug) {
+      console.log("[AdsService] Configuration updated:", {
+        enabled: this.config.enabled,
+        sound: this.config.sound
+      });
+    }
+    if (this.config.enabled && !this.initialized) {
+      this.initialize();
+    }
+  }
+  /**
+   * Initialize the ads system
+   */
+  initialize() {
+    if (this.initialized) return;
+    if (!this.config.enabled) {
+      if (this.config.debug) {
+        console.log("[AdsService] Ads disabled, skipping initialization");
+      }
+      return;
+    }
+    if (!window.adConfig || !window.adBreak) {
+      console.warn("[AdsService] Google Ads SDK not found. Ads will not be available.");
+      return;
+    }
+    if (this.config.debug) {
+      console.log("[AdsService] Initializing ads system...");
+    }
+    const googleConfig = {
+      sound: this.config.sound,
+      preloadAdBreaks: "on",
+      onReady: () => {
+        this.ready = true;
+        if (this.config.debug) {
+          console.log("[AdsService] Ads ready");
+        }
+      }
+    };
+    window.adConfig(googleConfig);
+    this.initialized = true;
+  }
+  /**
+   * Show an ad
+   * Returns immediately if ads are disabled
+   */
+  async show(type) {
+    const requestedAt = Date.now();
+    if (!this.config.enabled) {
+      if (this.config.debug) {
+        console.log("[AdsService] Ads disabled, skipping ad request");
+      }
+      return {
+        success: false,
+        type,
+        error: new Error("Ads are disabled"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    if (!this.initialized) {
+      this.initialize();
+    }
+    if (!this.ready || !window.adBreak) {
+      return {
+        success: false,
+        type,
+        error: new Error("Ads not ready"),
+        requestedAt,
+        completedAt: Date.now()
+      };
+    }
+    return this.showAdBreak(type);
+  }
+  /**
+   * Show an ad break
+   */
+  async showAdBreak(type) {
+    const requestedAt = Date.now();
+    return new Promise((resolve) => {
+      const googleType = type === "rewarded" ? "reward" : type === "preroll" ? "start" : "next";
+      const adName = `${type}-ad-${Date.now()}`;
+      if (this.config.debug) {
+        console.log(`[AdsService] Showing ${type} ad`);
+      }
+      this.config.onBeforeAd(type);
+      const adBreakConfig = {
+        type: googleType,
+        name: adName,
+        beforeAd: () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Ad started");
+          }
+        },
+        afterAd: () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Ad finished");
+          }
+          this.config.onAfterAd(type);
+        },
+        adBreakDone: (info) => {
+          const completedAt = Date.now();
+          let success = false;
+          if (type === "rewarded") {
+            success = info?.breakStatus === "viewed";
+          } else {
+            success = info?.breakStatus !== "error";
+          }
+          const error = info?.breakStatus === "error" && info?.error ? new Error(info.error) : void 0;
+          if (this.config.debug) {
+            console.log("[AdsService] Ad break done:", {
+              success,
+              status: info?.breakStatus
+            });
+          }
+          const result = {
+            success,
+            type,
+            error,
+            requestedAt,
+            completedAt
+          };
+          resolve(result);
+        }
+      };
+      if (type === "rewarded") {
+        adBreakConfig.beforeReward = (showAdFn) => {
+          if (this.config.debug) {
+            console.log("[AdsService] beforeReward callback");
+          }
+          showAdFn();
+        };
+        adBreakConfig.adViewed = () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Rewarded ad watched successfully");
+          }
+          this.config.onRewardEarned();
+        };
+        adBreakConfig.adDismissed = () => {
+          if (this.config.debug) {
+            console.log("[AdsService] Rewarded ad dismissed");
+          }
+        };
+      }
+      window.adBreak(adBreakConfig);
+    });
+  }
+  /**
+   * Check if ads are enabled
+   */
+  isEnabled() {
+    return this.config.enabled;
+  }
+  /**
+   * Check if ads are ready to show
+   */
+  isReady() {
+    return this.config.enabled && this.ready;
+  }
+};
+
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
@@ -491,9 +678,10 @@ var HyveClient = class {
   userId = null;
   jwtToken = null;
   gameId = null;
+  adsService;
   /**
    * Creates a new HyveClient instance
-   * @param config Optional telemetry configuration
+   * @param config Optional configuration including telemetry and ads
    */
   constructor(config) {
     this.telemetryConfig = {
@@ -507,9 +695,14 @@ var HyveClient = class {
       this.apiBaseUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
     }
     this.sessionId = generateUUID();
+    this.adsService = new AdsService();
+    if (config?.ads) {
+      this.adsService.configure(config.ads);
+    }
     logger.info("Client initialized with sessionId:", this.sessionId);
     logger.info("API Base URL:", this.apiBaseUrl);
     logger.info("Environment:", this.telemetryConfig.isDev ? "dev" : "prod");
+    logger.info("Ads enabled:", this.adsService.isEnabled());
   }
   /**
    * Authenticates a user from URL parameters
@@ -757,8 +950,39 @@ var HyveClient = class {
     this.sessionId = generateUUID();
     logger.info("Client reset with new sessionId:", this.sessionId);
   }
+  /**
+   * Configure ads service
+   * @param config Ads configuration
+   */
+  configureAds(config) {
+    this.adsService.configure(config);
+    logger.info("Ads configuration updated");
+  }
+  /**
+   * Show an ad
+   * @param type Type of ad to show ('rewarded', 'interstitial', or 'preroll')
+   * @returns Promise resolving to ad result
+   */
+  async showAd(type) {
+    return this.adsService.show(type);
+  }
+  /**
+   * Check if ads are enabled
+   * @returns Boolean indicating if ads are enabled
+   */
+  areAdsEnabled() {
+    return this.adsService.isEnabled();
+  }
+  /**
+   * Check if ads are ready to show
+   * @returns Boolean indicating if ads are ready
+   */
+  areAdsReady() {
+    return this.adsService.isReady();
+  }
 };
 export {
+  AdsService,
   HyveClient,
   Logger,
   NativeBridge,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyve-sdk/js",
-  "version": "1.3.1-canary.0",
+  "version": "1.3.1",
   "description": "Hyve SDK - TypeScript wrapper for Hyve game server integration",
   "private": false,
   "publishConfig": {
@@ -15,14 +15,6 @@
     "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,11 +40,18 @@
     "uuid": "^10.0.0"
   },
   "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"
+    "typescript": "^5.3.3",
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-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"
   }
-}
+}