@hyve-sdk/js 1.3.2 → 1.3.3

package/dist/index.d.ts

@@ -171,138 +171,6 @@ declare class AdsService {
     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
- */
-declare class HyveClient {
-    private telemetryConfig;
-    private apiBaseUrl;
-    private sessionId;
-    private userId;
-    private jwtToken;
-    private gameId;
-    private adsService;
-    /**
-     * Creates a new HyveClient instance
-     * @param config Optional configuration including telemetry and ads
-     */
-    constructor(config?: HyveClientConfig);
-    /**
-     * Authenticates a user from URL parameters
-     * @param urlParams URL parameters or search string
-     * @returns Promise resolving to boolean indicating success
-     */
-    authenticateFromUrl(urlParams?: URLSearchParams | string): Promise<boolean>;
-    /**
-     * Sends a user-level telemetry event using JWT authentication
-     * Requires JWT token, authenticated user, and game ID from URL parameters
-     * @param eventLocation Location where the event occurred
-     * @param eventCategory Main category of the event
-     * @param eventAction Primary action taken
-     * @param eventSubCategory Optional sub-category
-     * @param eventSubAction Optional sub-action
-     * @param eventDetails Optional event details (object or JSON string)
-     * @param customData Optional custom data (object or JSON string)
-     * @param platformId Optional platform identifier
-     * @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, customData?: Record<string, any> | null, platformId?: string | null): Promise<boolean>;
-    /**
-     * Makes an authenticated API call using the JWT token
-     * @param endpoint API endpoint path (will be appended to base URL)
-     * @param options Fetch options (method, body, etc.)
-     * @returns Promise resolving to the API response
-     */
-    callApi<T = any>(endpoint: string, options?: RequestInit): Promise<T>;
-    /**
-     * Gets the user's inventory
-     * @returns Promise resolving to the user's inventory
-     */
-    getInventory(): Promise<Inventory>;
-    /**
-     * Gets a specific inventory item by ID
-     * @param itemId The inventory item ID
-     * @returns Promise resolving to the inventory item details
-     */
-    getInventoryItem(itemId: string): Promise<InventoryItem>;
-    /**
-     * Updates the telemetry configuration
-     * @param config New telemetry configuration
-     */
-    updateTelemetryConfig(config: TelemetryConfig): void;
-    /**
-     * Gets the current user ID
-     * @returns Current user ID or null if not authenticated
-     */
-    getUserId(): string | null;
-    /**
-     * Gets the current session ID
-     * @returns Current session ID
-     */
-    getSessionId(): string;
-    /**
-     * Gets the current JWT token
-     * @returns Current JWT token or null if not available
-     */
-    getJwtToken(): string | null;
-    /**
-     * Gets the current game ID
-     * @returns Current game ID or null if not available
-     */
-    getGameId(): string | null;
-    /**
-     * Gets the API base URL
-     * @returns API base URL
-     */
-    getApiBaseUrl(): string;
-    /**
-     * Checks if user is authenticated
-     * @returns Boolean indicating authentication status
-     */
-    isUserAuthenticated(): boolean;
-    /**
-     * Checks if JWT token is available
-     * @returns Boolean indicating if JWT token is present
-     */
-    hasJwtToken(): boolean;
-    /**
-     * Logs out the current user
-     */
-    logout(): void;
-    /**
-     * 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;
-}
-
 /**
  * Product information from the native app or server
  */
@@ -514,6 +382,197 @@ declare class BillingService {
     dispose(): void;
 }
 
+/**
+ * HyveClient configuration options
+ */
+interface HyveClientConfig extends TelemetryConfig {
+    /** Ads configuration (disabled by default) */
+    ads?: AdConfig$1;
+    /** Billing configuration (disabled by default) */
+    billing?: BillingConfig;
+}
+/**
+ * HyveClient provides telemetry and authentication functionality for Hyve games
+ */
+declare class HyveClient {
+    private telemetryConfig;
+    private apiBaseUrl;
+    private sessionId;
+    private userId;
+    private jwtToken;
+    private gameId;
+    private adsService;
+    private billingService;
+    private billingConfig;
+    private billingCallbacks;
+    /**
+     * Creates a new HyveClient instance
+     * @param config Optional configuration including telemetry and ads
+     */
+    constructor(config?: HyveClientConfig);
+    /**
+     * Authenticates a user from URL parameters
+     * @param urlParams URL parameters or search string
+     * @returns Promise resolving to boolean indicating success
+     */
+    authenticateFromUrl(urlParams?: URLSearchParams | string): Promise<boolean>;
+    /**
+     * Sends a user-level telemetry event using JWT authentication
+     * Requires JWT token, authenticated user, and game ID from URL parameters
+     * @param eventLocation Location where the event occurred
+     * @param eventCategory Main category of the event
+     * @param eventAction Primary action taken
+     * @param eventSubCategory Optional sub-category
+     * @param eventSubAction Optional sub-action
+     * @param eventDetails Optional event details (object or JSON string)
+     * @param customData Optional custom data (object or JSON string)
+     * @param platformId Optional platform identifier
+     * @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, customData?: Record<string, any> | null, platformId?: string | null): Promise<boolean>;
+    /**
+     * Makes an authenticated API call using the JWT token
+     * @param endpoint API endpoint path (will be appended to base URL)
+     * @param options Fetch options (method, body, etc.)
+     * @returns Promise resolving to the API response
+     */
+    callApi<T = any>(endpoint: string, options?: RequestInit): Promise<T>;
+    /**
+     * Gets the user's inventory
+     * @returns Promise resolving to the user's inventory
+     */
+    getInventory(): Promise<Inventory>;
+    /**
+     * Gets a specific inventory item by ID
+     * @param itemId The inventory item ID
+     * @returns Promise resolving to the inventory item details
+     */
+    getInventoryItem(itemId: string): Promise<InventoryItem>;
+    /**
+     * Updates the telemetry configuration
+     * @param config New telemetry configuration
+     */
+    updateTelemetryConfig(config: TelemetryConfig): void;
+    /**
+     * Gets the current user ID
+     * @returns Current user ID or null if not authenticated
+     */
+    getUserId(): string | null;
+    /**
+     * Gets the current session ID
+     * @returns Current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Gets the current JWT token
+     * @returns Current JWT token or null if not available
+     */
+    getJwtToken(): string | null;
+    /**
+     * Gets the current game ID
+     * @returns Current game ID or null if not available
+     */
+    getGameId(): string | null;
+    /**
+     * Gets the API base URL
+     * @returns API base URL
+     */
+    getApiBaseUrl(): string;
+    /**
+     * Checks if user is authenticated
+     * @returns Boolean indicating authentication status
+     */
+    isUserAuthenticated(): boolean;
+    /**
+     * Checks if JWT token is available
+     * @returns Boolean indicating if JWT token is present
+     */
+    hasJwtToken(): boolean;
+    /**
+     * Logs out the current user
+     */
+    logout(): void;
+    /**
+     * 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;
+    /**
+     * Configure billing service
+     * @param config Billing configuration
+     */
+    configureBilling(config: BillingConfig): void;
+    /**
+     * Initialize billing service
+     * Must be called before using billing features
+     * @returns Promise resolving to boolean indicating success
+     */
+    initializeBilling(): Promise<boolean>;
+    /**
+     * Get the billing platform
+     * @returns Current billing platform
+     */
+    getBillingPlatform(): BillingPlatform;
+    /**
+     * Check if billing is available
+     * @returns Boolean indicating if billing is available
+     */
+    isBillingAvailable(): boolean;
+    /**
+     * Get available billing products
+     * @returns Promise resolving to array of products
+     */
+    getBillingProducts(): Promise<BillingProduct[]>;
+    /**
+     * Purchase a product
+     * @param productId Product ID to purchase
+     * @param options Optional purchase options (e.g., elementId for web)
+     * @returns Promise resolving to purchase result
+     */
+    purchaseProduct(productId: string, options?: {
+        elementId?: string;
+    }): Promise<PurchaseResult>;
+    /**
+     * Set callback for successful purchases
+     * @param callback Function to call on purchase completion
+     */
+    onPurchaseComplete(callback: (result: PurchaseResult) => void): void;
+    /**
+     * Set callback for failed purchases
+     * @param callback Function to call on purchase error
+     */
+    onPurchaseError(callback: (result: PurchaseResult) => void): void;
+    /**
+     * Unmount Stripe checkout element
+     */
+    unmountBillingCheckout(): void;
+    /**
+     * Register a callback to receive billing logs
+     * @param callback Function to call with log messages
+     */
+    onBillingLog(callback: (level: "info" | "warn" | "error", message: string, data?: any) => void): void;
+}
+
 /**
  * Logger utility for the Hyve SDK
  * Automatically enabled in development (NODE_ENV !== 'production')