@hyve-sdk/js 1.0.1 → 1.1.2

package/README.md

@@ -1,34 +1,51 @@
-# @hyve/sdk
+# @hyve-sdk/js
 
 TypeScript SDK for web3 authentication and game integration, providing secure signature verification and utility functions.
 
 ## Installation
 
 ```bash
-bun add @hyve/sdk
+bun add @hyve-sdk/js
 # or
-npm install @hyve/sdk
+npm install @hyve-sdk/js
 # or
-pnpm add @hyve/sdk
+pnpm add @hyve-sdk/js
 ```
 
 ## Features
 
 - **Web3 Authentication**: EVM signature validation and verification
 - **Modern & Legacy Token Support**: Dual authentication token formats
-- **Security Utilities**: Domain validation and referrer checking  
+- **JWT Authentication**: Support for JWT tokens passed via URL parameters
+- **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
+- **Security Utilities**: Domain validation and referrer checking
 - **URL Parameter Parsing**: Easy extraction of authentication parameters
 - **UUID Generation**: Built-in UUID v4 generation
 
 ## Core Components
 
 ### HyveClient
-Main client class for SDK operations (currently minimal implementation).
+Main client class for SDK operations including authentication, telemetry, and API calls.
 
 ```typescript
-import { HyveClient } from "@hyve/sdk";
+import { HyveClient } from "@hyve-sdk/js";
 
-const client = new HyveClient();
+// Initialize with optional configuration
+const client = new HyveClient({
+  apiKey: 'your-api-key',      // For telemetry
+  isDev: true,                  // Development mode (default: true)
+  apiBaseUrl: 'https://...'     // Optional custom API URL
+});
+
+// Authenticate from URL parameters
+const authenticated = await client.authenticateFromUrl();
+if (authenticated) {
+  console.log('User ID:', client.getUserId());
+  console.log('Session ID:', client.getSessionId());
+  console.log('Has JWT:', client.hasJwtToken());
+}
 ```
 
 ### Authentication Utilities
@@ -37,7 +54,7 @@ const client = new HyveClient();
 Extract authentication and game parameters from URL:
 
 ```typescript
-import { parseUrlParams } from "@hyve/sdk";
+import { parseUrlParams } from "@hyve-sdk/js";
 
 const params = parseUrlParams(window.location.search);
 // Returns:
@@ -55,7 +72,7 @@ const params = parseUrlParams(window.location.search);
 Unified verification supporting both modern and legacy tokens:
 
 ```typescript
-import { verifyAuthentication } from "@hyve/sdk";
+import { verifyAuthentication } from "@hyve-sdk/js";
 
 const result = verifyAuthentication({
   hyveToken: params.hyveToken,    // Modern token format
@@ -73,7 +90,7 @@ if (result.isValid) {
 Verify modern authentication tokens with expiration:
 
 ```typescript
-import { verifyHyveToken } from "@hyve/sdk";
+import { verifyHyveToken } from "@hyve-sdk/js";
 
 // Token format: signature.address.randomBase64.timestamp
 const address = verifyHyveToken(hyveToken, 600); // 600 seconds max age
@@ -86,7 +103,7 @@ if (address) {
 Verify legacy signed messages with metadata:
 
 ```typescript
-import { handleVerifyMessage, validateSignature } from "@hyve/sdk";
+import { handleVerifyMessage, validateSignature } from "@hyve-sdk/js";
 
 // Method 1: Verify message with embedded metadata
 const address = handleVerifyMessage(signature, message);
@@ -101,7 +118,7 @@ const isValid = validateSignature(signature, message, userId);
 Check if current domain is allowed:
 
 ```typescript
-import { isDomainAllowed } from "@hyve/sdk";
+import { isDomainAllowed } from "@hyve-sdk/js";
 
 // Single domain
 const allowed = isDomainAllowed('example.com', window.location.hostname);
@@ -121,11 +138,157 @@ const allowed = isDomainAllowed(
 Generate random UUID v4:
 
 ```typescript
-import { generateUUID } from "@hyve/sdk";
+import { generateUUID } from "@hyve-sdk/js";
 
 const id = generateUUID();
 ```
 
+## Telemetry & Analytics
+
+### Send Telemetry Events
+Track user actions and game events:
+
+```typescript
+// Send a custom telemetry event
+await client.sendTelemetry(
+  'game',                          // Event location
+  'player',                        // Event category
+  'action',                        // Event action
+  'combat',                        // Event sub-category (optional)
+  'attack',                        // Event sub-action (optional)
+  null,                            // Event details string (optional)
+  {                                // Additional data (optional)
+    damage: 100,
+    targetId: 'enemy-123',
+    weaponType: 'sword'
+  }
+);
+```
+
+**Configuration:**
+- Requires `apiKey` in client configuration
+- Automatically includes `session_id` and `user_id`
+- Additional data is JSON-stringified into `event_details`
+- Supports anonymous telemetry (without authentication)
+
+## API Integration
+
+### JWT Authentication
+The SDK supports JWT tokens passed via URL parameter `hyve-access`:
+
+```typescript
+// URL: https://game.com?hyve-access=your-jwt-token
+
+// Authenticate extracts JWT automatically
+await client.authenticateFromUrl();
+
+// Check JWT availability
+if (client.hasJwtToken()) {
+  const token = client.getJwtToken();
+  console.log('JWT token available');
+}
+```
+
+### Generic API Calls
+Make authenticated API requests:
+
+```typescript
+// GET request
+const userData = await client.callApi('/api/v1/user');
+
+// POST request with body
+const result = await client.callApi('/api/v1/game/score', {
+  method: 'POST',
+  body: JSON.stringify({ score: 1000 })
+});
+
+// With TypeScript typing
+interface UserData {
+  id: string;
+  username: string;
+}
+const user = await client.callApi<UserData>('/api/v1/user');
+```
+
+### Inventory Management
+
+#### Get User Inventory
+Retrieve all inventory items:
+
+```typescript
+const inventory = await client.getInventory();
+
+console.log(`Total items: ${inventory.total_count}`);
+inventory.items.forEach(item => {
+  console.log(`${item.item_type}: ${item.quantity}x`);
+});
+```
+
+**Response Type:**
+```typescript
+interface Inventory {
+  items: InventoryItem[];
+  total_count: number;
+}
+
+interface InventoryItem {
+  id: string;
+  user_id: string;
+  item_type: string;
+  item_id: string;
+  quantity: number;
+  metadata?: Record<string, any>;
+  created_at: string;
+  updated_at: string;
+}
+```
+
+#### Get Specific Inventory Item
+Fetch details for a single item:
+
+```typescript
+const item = await client.getInventoryItem('item-id-123');
+
+console.log(`Item: ${item.item_type}`);
+console.log(`Quantity: ${item.quantity}`);
+if (item.metadata) {
+  console.log('Metadata:', item.metadata);
+}
+```
+
+**API Endpoints:**
+- `GET /api/v1/inventory` - Get all inventory items
+- `GET /api/v1/inventory/:id` - Get specific item
+
+**Requirements:**
+- JWT token must be available (via `hyve-access` URL parameter)
+- User must be authenticated
+
+## Client Methods Reference
+
+### Authentication
+- `authenticateFromUrl(urlParams?)` - Authenticate from URL parameters
+- `getUserId()` - Get authenticated user ID (address)
+- `getSessionId()` - Get unique session ID
+- `isUserAuthenticated()` - Check if user is authenticated
+- `hasJwtToken()` - Check if JWT token is available
+- `getJwtToken()` - Get JWT token string
+- `logout()` - Clear user authentication
+- `reset()` - Reset client state with new session
+
+### API Calls
+- `callApi<T>(endpoint, options?)` - Generic authenticated API call
+- `getInventory()` - Get user's inventory
+- `getInventoryItem(itemId)` - Get specific inventory item
+
+### Telemetry
+- `sendTelemetry(location, category, action, subCategory?, subAction?, details?, additionalData?)` - Send analytics event
+- `updateTelemetryConfig(config)` - Update telemetry settings
+
+### Configuration
+- `getApiBaseUrl()` - Get current API base URL
+- `updateTelemetryConfig(config)` - Update client configuration
+
 ## Authentication Flow
 
 ### Modern Token Flow (Recommended)

package/dist/index.d.mts

@@ -6,6 +6,8 @@ interface TelemetryConfig {
     apiKey?: string;
     /** Environment: true for dev, false for prod. Defaults to true (dev) */
     isDev?: boolean;
+    /** Base API URL for all API calls (telemetry and external). Can be set via env. If not provided, defaults based on isDev */
+    apiBaseUrl?: string;
 }
 /**
  * Telemetry event data structure
@@ -35,15 +37,36 @@ interface TelemetryAdditionalData {
     /** Optional additional data object (will be JSON stringified and put in event_details) */
     [key: string]: any;
 }
+/**
+ * User inventory item
+ */
+interface InventoryItem {
+    id: string;
+    user_id: string;
+    item_type: string;
+    item_id: string;
+    quantity: number;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * User inventory response
+ */
+interface Inventory {
+    items: InventoryItem[];
+    total_count: number;
+}
 
 /**
  * HyveClient provides telemetry and authentication functionality for Hyve games
  */
 declare class HyveClient {
     private telemetryConfig;
-    private telemetryApiUrl;
+    private apiBaseUrl;
     private sessionId;
     private userId;
+    private jwtToken;
     /**
      * Creates a new HyveClient instance
      * @param config Optional telemetry configuration
@@ -67,6 +90,24 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: string | null, additionalData?: TelemetryAdditionalData | 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
@@ -82,11 +123,26 @@ declare class HyveClient {
      * @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 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
      */
@@ -108,6 +164,7 @@ declare function parseUrlParams(searchParams: URLSearchParams | string): {
     gameStartTab: string;
     hyveToken: string;
     platform: string;
+    hyveAccess: string;
 };
 /**
  * Validates an EVM signature against a message and user ID
@@ -158,4 +215,4 @@ declare function generateUUID(): string;
  */
 declare function isDomainAllowed(allowedDomains?: string | string[], hostname?: string): boolean;
 
-export { HyveClient, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };
+export { HyveClient, type Inventory, type InventoryItem, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.d.ts

@@ -6,6 +6,8 @@ interface TelemetryConfig {
     apiKey?: string;
     /** Environment: true for dev, false for prod. Defaults to true (dev) */
     isDev?: boolean;
+    /** Base API URL for all API calls (telemetry and external). Can be set via env. If not provided, defaults based on isDev */
+    apiBaseUrl?: string;
 }
 /**
  * Telemetry event data structure
@@ -35,15 +37,36 @@ interface TelemetryAdditionalData {
     /** Optional additional data object (will be JSON stringified and put in event_details) */
     [key: string]: any;
 }
+/**
+ * User inventory item
+ */
+interface InventoryItem {
+    id: string;
+    user_id: string;
+    item_type: string;
+    item_id: string;
+    quantity: number;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * User inventory response
+ */
+interface Inventory {
+    items: InventoryItem[];
+    total_count: number;
+}
 
 /**
  * HyveClient provides telemetry and authentication functionality for Hyve games
  */
 declare class HyveClient {
     private telemetryConfig;
-    private telemetryApiUrl;
+    private apiBaseUrl;
     private sessionId;
     private userId;
+    private jwtToken;
     /**
      * Creates a new HyveClient instance
      * @param config Optional telemetry configuration
@@ -67,6 +90,24 @@ declare class HyveClient {
      * @returns Promise resolving to boolean indicating success
      */
     sendTelemetry(eventLocation: string, eventCategory: string, eventAction: string, eventSubCategory?: string | null, eventSubAction?: string | null, eventDetails?: string | null, additionalData?: TelemetryAdditionalData | 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
@@ -82,11 +123,26 @@ declare class HyveClient {
      * @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 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
      */
@@ -108,6 +164,7 @@ declare function parseUrlParams(searchParams: URLSearchParams | string): {
     gameStartTab: string;
     hyveToken: string;
     platform: string;
+    hyveAccess: string;
 };
 /**
  * Validates an EVM signature against a message and user ID
@@ -158,4 +215,4 @@ declare function generateUUID(): string;
  */
 declare function isDomainAllowed(allowedDomains?: string | string[], hostname?: string): boolean;
 
-export { HyveClient, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };
+export { HyveClient, type Inventory, type InventoryItem, type TelemetryAdditionalData, type TelemetryConfig, type TelemetryEvent, generateUUID, handleVerifyMessage, isDomainAllowed, parseUrlParams, validateSignature, verifyAuthentication, verifyHyveToken };

package/dist/index.js

@@ -41,7 +41,8 @@ function parseUrlParams(searchParams) {
     message: params.get("message") || "",
     gameStartTab: params.get("game_start_tab") || "",
     hyveToken: params.get("hyve-token") || "",
-    platform: params.get("platform") || ""
+    platform: params.get("platform") || "",
+    hyveAccess: params.get("hyve-access") || ""
   };
 }
 function validateSignature(signature, message) {
@@ -186,9 +187,10 @@ function isDomainAllowed(allowedDomains, hostname) {
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
-  telemetryApiUrl;
+  apiBaseUrl;
   sessionId;
   userId = null;
+  jwtToken = null;
   /**
    * Creates a new HyveClient instance
    * @param config Optional telemetry configuration
@@ -199,10 +201,15 @@ var HyveClient = class {
       // Default to dev environment
       ...config
     };
-    this.telemetryApiUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg/api/v1/partners/analytics/events" : "https://product-api.prod.hyve.gg/api/v1/partners/analytics/events";
+    if (this.telemetryConfig.apiBaseUrl) {
+      this.apiBaseUrl = this.telemetryConfig.apiBaseUrl;
+    } else {
+      this.apiBaseUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
+    }
     this.sessionId = generateUUID();
     console.log("[Hyve SDK] Client initialized with sessionId:", this.sessionId);
-    console.log("[Hyve SDK] Telemetry environment:", this.telemetryConfig.isDev ? "dev" : "prod");
+    console.log("[Hyve SDK] API Base URL:", this.apiBaseUrl);
+    console.log("[Hyve SDK] Environment:", this.telemetryConfig.isDev ? "dev" : "prod");
   }
   /**
    * Authenticates a user from URL parameters
@@ -212,6 +219,10 @@ var HyveClient = class {
   async authenticateFromUrl(urlParams) {
     try {
       const params = urlParams ? parseUrlParams(urlParams) : parseUrlParams(window.location.search);
+      if (params.hyveAccess) {
+        this.jwtToken = params.hyveAccess;
+        console.log("[Hyve SDK] JWT token extracted from hyve-access parameter");
+      }
       const authResult = verifyAuthentication({
         hyveToken: params.hyveToken,
         signature: params.signature,
@@ -270,7 +281,8 @@ var HyveClient = class {
         event_details: finalEventDetails
       };
       console.log("[Hyve Telemetry] Sending event:", telemetryEvent);
-      const response = await fetch(this.telemetryApiUrl, {
+      const telemetryUrl = `${this.apiBaseUrl}/api/v1/partners/analytics/events`;
+      const response = await fetch(telemetryUrl, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -291,6 +303,51 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * 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
+   */
+  async callApi(endpoint, options = {}) {
+    if (!this.jwtToken) {
+      throw new Error("[Hyve SDK] No JWT token available. Call authenticateFromUrl first.");
+    }
+    try {
+      const url = `${this.apiBaseUrl}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`;
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.jwtToken}`,
+          ...options.headers
+        }
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`API request failed: ${response.status} ${errorText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      console.error("[Hyve SDK] API call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Gets the user's inventory
+   * @returns Promise resolving to the user's inventory
+   */
+  async getInventory() {
+    return this.callApi("/api/v1/inventory");
+  }
+  /**
+   * Gets a specific inventory item by ID
+   * @param itemId The inventory item ID
+   * @returns Promise resolving to the inventory item details
+   */
+  async getInventoryItem(itemId) {
+    return this.callApi(`/api/v1/inventory/${itemId}`);
+  }
   /**
    * Updates the telemetry configuration
    * @param config New telemetry configuration
@@ -300,8 +357,13 @@ var HyveClient = class {
       ...this.telemetryConfig,
       ...config
     };
-    this.telemetryApiUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg/api/v1/partners/analytics/events" : "https://product-api.prod.hyve.gg/api/v1/partners/analytics/events";
-    console.log("[Hyve SDK] Telemetry config updated");
+    if (config.apiBaseUrl !== void 0) {
+      this.apiBaseUrl = config.apiBaseUrl;
+    } else if (config.isDev !== void 0) {
+      this.apiBaseUrl = config.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
+    }
+    console.log("[Hyve SDK] Config updated");
+    console.log("[Hyve SDK] API Base URL:", this.apiBaseUrl);
   }
   /**
    * Gets the current user ID
@@ -317,6 +379,20 @@ var HyveClient = class {
   getSessionId() {
     return this.sessionId;
   }
+  /**
+   * Gets the current JWT token
+   * @returns Current JWT token or null if not available
+   */
+  getJwtToken() {
+    return this.jwtToken;
+  }
+  /**
+   * Gets the API base URL
+   * @returns API base URL
+   */
+  getApiBaseUrl() {
+    return this.apiBaseUrl;
+  }
   /**
    * Checks if user is authenticated
    * @returns Boolean indicating authentication status
@@ -324,11 +400,19 @@ var HyveClient = class {
   isUserAuthenticated() {
     return this.userId !== null;
   }
+  /**
+   * Checks if JWT token is available
+   * @returns Boolean indicating if JWT token is present
+   */
+  hasJwtToken() {
+    return this.jwtToken !== null;
+  }
   /**
    * Logs out the current user
    */
   logout() {
     this.userId = null;
+    this.jwtToken = null;
     console.log("[Hyve SDK] User logged out");
   }
   /**

package/dist/index.mjs

@@ -8,7 +8,8 @@ function parseUrlParams(searchParams) {
     message: params.get("message") || "",
     gameStartTab: params.get("game_start_tab") || "",
     hyveToken: params.get("hyve-token") || "",
-    platform: params.get("platform") || ""
+    platform: params.get("platform") || "",
+    hyveAccess: params.get("hyve-access") || ""
   };
 }
 function validateSignature(signature, message) {
@@ -153,9 +154,10 @@ function isDomainAllowed(allowedDomains, hostname) {
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
-  telemetryApiUrl;
+  apiBaseUrl;
   sessionId;
   userId = null;
+  jwtToken = null;
   /**
    * Creates a new HyveClient instance
    * @param config Optional telemetry configuration
@@ -166,10 +168,15 @@ var HyveClient = class {
       // Default to dev environment
       ...config
     };
-    this.telemetryApiUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg/api/v1/partners/analytics/events" : "https://product-api.prod.hyve.gg/api/v1/partners/analytics/events";
+    if (this.telemetryConfig.apiBaseUrl) {
+      this.apiBaseUrl = this.telemetryConfig.apiBaseUrl;
+    } else {
+      this.apiBaseUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
+    }
     this.sessionId = generateUUID();
     console.log("[Hyve SDK] Client initialized with sessionId:", this.sessionId);
-    console.log("[Hyve SDK] Telemetry environment:", this.telemetryConfig.isDev ? "dev" : "prod");
+    console.log("[Hyve SDK] API Base URL:", this.apiBaseUrl);
+    console.log("[Hyve SDK] Environment:", this.telemetryConfig.isDev ? "dev" : "prod");
   }
   /**
    * Authenticates a user from URL parameters
@@ -179,6 +186,10 @@ var HyveClient = class {
   async authenticateFromUrl(urlParams) {
     try {
       const params = urlParams ? parseUrlParams(urlParams) : parseUrlParams(window.location.search);
+      if (params.hyveAccess) {
+        this.jwtToken = params.hyveAccess;
+        console.log("[Hyve SDK] JWT token extracted from hyve-access parameter");
+      }
       const authResult = verifyAuthentication({
         hyveToken: params.hyveToken,
         signature: params.signature,
@@ -237,7 +248,8 @@ var HyveClient = class {
         event_details: finalEventDetails
       };
       console.log("[Hyve Telemetry] Sending event:", telemetryEvent);
-      const response = await fetch(this.telemetryApiUrl, {
+      const telemetryUrl = `${this.apiBaseUrl}/api/v1/partners/analytics/events`;
+      const response = await fetch(telemetryUrl, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -258,6 +270,51 @@ var HyveClient = class {
       return false;
     }
   }
+  /**
+   * 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
+   */
+  async callApi(endpoint, options = {}) {
+    if (!this.jwtToken) {
+      throw new Error("[Hyve SDK] No JWT token available. Call authenticateFromUrl first.");
+    }
+    try {
+      const url = `${this.apiBaseUrl}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`;
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.jwtToken}`,
+          ...options.headers
+        }
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`API request failed: ${response.status} ${errorText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      console.error("[Hyve SDK] API call failed:", error);
+      throw error;
+    }
+  }
+  /**
+   * Gets the user's inventory
+   * @returns Promise resolving to the user's inventory
+   */
+  async getInventory() {
+    return this.callApi("/api/v1/inventory");
+  }
+  /**
+   * Gets a specific inventory item by ID
+   * @param itemId The inventory item ID
+   * @returns Promise resolving to the inventory item details
+   */
+  async getInventoryItem(itemId) {
+    return this.callApi(`/api/v1/inventory/${itemId}`);
+  }
   /**
    * Updates the telemetry configuration
    * @param config New telemetry configuration
@@ -267,8 +324,13 @@ var HyveClient = class {
       ...this.telemetryConfig,
       ...config
     };
-    this.telemetryApiUrl = this.telemetryConfig.isDev ? "https://product-api.dev.hyve.gg/api/v1/partners/analytics/events" : "https://product-api.prod.hyve.gg/api/v1/partners/analytics/events";
-    console.log("[Hyve SDK] Telemetry config updated");
+    if (config.apiBaseUrl !== void 0) {
+      this.apiBaseUrl = config.apiBaseUrl;
+    } else if (config.isDev !== void 0) {
+      this.apiBaseUrl = config.isDev ? "https://product-api.dev.hyve.gg" : "https://product-api.prod.hyve.gg";
+    }
+    console.log("[Hyve SDK] Config updated");
+    console.log("[Hyve SDK] API Base URL:", this.apiBaseUrl);
   }
   /**
    * Gets the current user ID
@@ -284,6 +346,20 @@ var HyveClient = class {
   getSessionId() {
     return this.sessionId;
   }
+  /**
+   * Gets the current JWT token
+   * @returns Current JWT token or null if not available
+   */
+  getJwtToken() {
+    return this.jwtToken;
+  }
+  /**
+   * Gets the API base URL
+   * @returns API base URL
+   */
+  getApiBaseUrl() {
+    return this.apiBaseUrl;
+  }
   /**
    * Checks if user is authenticated
    * @returns Boolean indicating authentication status
@@ -291,11 +367,19 @@ var HyveClient = class {
   isUserAuthenticated() {
     return this.userId !== null;
   }
+  /**
+   * Checks if JWT token is available
+   * @returns Boolean indicating if JWT token is present
+   */
+  hasJwtToken() {
+    return this.jwtToken !== null;
+  }
   /**
    * Logs out the current user
    */
   logout() {
     this.userId = null;
+    this.jwtToken = null;
     console.log("[Hyve SDK] User logged out");
   }
   /**

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@hyve-sdk/js",
-  "version": "1.0.1",
+  "version": "1.1.2",
   "description": "Hyve SDK - TypeScript wrapper for Hyve game server integration",
   "private": false,
   "publishConfig": {
-    "access": "restricted",
+    "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "main": "dist/index.js",
@@ -51,7 +51,7 @@
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "publish:npm": "pnpm publish --access restricted",
-    "publish:dry-run": "pnpm publish --dry-run --access restricted --no-git-checks"
+    "publish:npm": "pnpm publish --access public --no-git-checks",
+    "publish:dry-run": "pnpm publish --dry-run --access public --no-git-checks"
   }
 }