@hyve-sdk/js 1.0.1 → 1.2.2

package/README.md

@@ -1,34 +1,52 @@
-# @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({
+  isDev: true,                  // Development mode (default: true)
+  apiBaseUrl: 'https://...'     // Optional custom API URL
+});
+
+// Authenticate from URL parameters
+// Extracts: hyve-token/signature, hyve-access (JWT), game-id
+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());
+  console.log('Game ID:', client.getGameId());
+}
 ```
 
 ### Authentication Utilities
@@ -37,17 +55,18 @@ 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:
 // {
 //   signature: string,
 //   message: string,
-//   userId: string,
 //   gameStartTab: string,
 //   hyveToken: string,
-//   platform: string
+//   platform: string,
+//   hyveAccess: string,   // JWT token
+//   gameId: string        // Game identifier
 // }
 ```
 
@@ -55,7 +74,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 +92,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 +105,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 +120,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 +140,174 @@ 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 using JWT authentication:
+
+```typescript
+// Send a user-level telemetry event
+// Game ID is automatically extracted from 'game-id' URL parameter
+await client.sendTelemetry(
+  'game',                          // Event location
+  'player',                        // Event category
+  'action',                        // Event action
+  'combat',                        // Event sub-category (optional)
+  'attack',                        // Event sub-action (optional)
+  {                                // Event details - auto-stringified (optional)
+    button: 'attack-btn',
+    screenPosition: { x: 100, y: 200 }
+  },
+  {                                // Custom data - auto-stringified (optional)
+    damage: 100,
+    targetId: 'enemy-123',
+    weaponType: 'sword',
+    level: 3
+  },
+  'web-chrome'                     // Platform ID (optional)
+);
+```
+
+**Requirements:**
+- Requires JWT token (from `hyve-access` URL parameter)
+- Requires authenticated user
+- Requires game ID (from `game-id` URL parameter)
+- User ID is automatically extracted from JWT (cannot be spoofed)
+
+**URL Parameters Expected:**
+- `hyve-access` - JWT authentication token
+- `game-id` - Game identifier (associates all telemetry with this game)
+- `hyve-token` or `signature`+`message` - For user authentication
+
+**Features:**
+- Automatically includes `session_id` and `game_id` from client
+- Objects in `event_details` and `custom_data` are auto-stringified to JSON
+- All events tied to authenticated user identity
+
+## API Integration
+
+### JWT Authentication
+The SDK supports JWT tokens and game IDs passed via URL parameters:
+
+```typescript
+// URL: https://game.com?hyve-access=your-jwt-token&game-id=my-game
+
+// Authenticate extracts JWT and game ID automatically
+await client.authenticateFromUrl();
+
+// Check availability
+if (client.hasJwtToken()) {
+  console.log('JWT token:', client.getJwtToken());
+  console.log('Game ID:', client.getGameId());
+}
+```
+
+### 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 (extracts JWT, game ID, user auth)
+- `getUserId()` - Get authenticated user ID (address)
+- `getSessionId()` - Get unique session ID
+- `getGameId()` - Get game ID from URL parameters
+- `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?, customData?, platformId?)` - Send JWT-authenticated analytics event (uses game ID from URL)
+- `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

@@ -2,31 +2,39 @@
  * Telemetry configuration options
  */
 interface TelemetryConfig {
-    /** API key for telemetry service */
-    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
+ * Telemetry event data structure for user-level events (JWT authenticated)
+ * Matches backend SendTelemetryRequest model
+ * Note: hyve_user_id is extracted from JWT by backend, not sent in request
  */
 interface TelemetryEvent {
-    /** Unique session identifier */
+    /** Game identifier (required) */
+    game_id: string;
+    /** Unique session identifier (required) */
     session_id: string;
-    /** Hyve user identifier (address) */
-    hyve_user_id: string;
-    /** Location where the event occurred */
+    /** Platform/user identifier (optional) */
+    platform_id?: string | null;
+    /** Location where the event occurred (required) */
     event_location: string;
-    /** Main category of the event */
+    /** Main category of the event (required) */
     event_category: string;
-    /** Primary action taken */
+    /** Sub-category for more granular classification (optional) */
+    event_sub_category?: string | null;
+    /** Primary action taken (required) */
     event_action: string;
-    /** Sub-category for more granular classification (null if not provided) */
-    event_sub_category: string | null;
-    /** Sub-action for detailed tracking (null if not provided) */
-    event_sub_action: string | null;
-    /** Additional data as JSON string (null if not provided) */
-    event_details: string | null;
+    /** Sub-action for detailed tracking (optional) */
+    event_sub_action?: string | null;
+    /** Event details as JSON string or object (optional) */
+    event_details?: Record<string, any> | string | null;
+    /** Mapping details as JSON string or object (optional) */
+    mapping_details?: Record<string, any> | string | null;
+    /** Custom data as JSON string or object (optional) */
+    custom_data?: Record<string, any> | string | null;
 }
 /**
  * Additional telemetry data that can be passed with events
@@ -35,15 +43,37 @@ 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;
+    private gameId;
     /**
      * Creates a new HyveClient instance
      * @param config Optional telemetry configuration
@@ -56,17 +86,37 @@ declare class HyveClient {
      */
     authenticateFromUrl(urlParams?: URLSearchParams | string): Promise<boolean>;
     /**
-     * Sends a telemetry event
+     * 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
-     * @param additionalData Optional additional data
+     * @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?: string | null, additionalData?: TelemetryAdditionalData | null): Promise<boolean>;
+    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
@@ -82,11 +132,31 @@ 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 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
      */
@@ -108,6 +178,8 @@ declare function parseUrlParams(searchParams: URLSearchParams | string): {
     gameStartTab: string;
     hyveToken: string;
     platform: string;
+    hyveAccess: string;
+    gameId: string;
 };
 /**
  * Validates an EVM signature against a message and user ID
@@ -158,4 +230,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

@@ -2,31 +2,39 @@
  * Telemetry configuration options
  */
 interface TelemetryConfig {
-    /** API key for telemetry service */
-    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
+ * Telemetry event data structure for user-level events (JWT authenticated)
+ * Matches backend SendTelemetryRequest model
+ * Note: hyve_user_id is extracted from JWT by backend, not sent in request
  */
 interface TelemetryEvent {
-    /** Unique session identifier */
+    /** Game identifier (required) */
+    game_id: string;
+    /** Unique session identifier (required) */
     session_id: string;
-    /** Hyve user identifier (address) */
-    hyve_user_id: string;
-    /** Location where the event occurred */
+    /** Platform/user identifier (optional) */
+    platform_id?: string | null;
+    /** Location where the event occurred (required) */
     event_location: string;
-    /** Main category of the event */
+    /** Main category of the event (required) */
     event_category: string;
-    /** Primary action taken */
+    /** Sub-category for more granular classification (optional) */
+    event_sub_category?: string | null;
+    /** Primary action taken (required) */
     event_action: string;
-    /** Sub-category for more granular classification (null if not provided) */
-    event_sub_category: string | null;
-    /** Sub-action for detailed tracking (null if not provided) */
-    event_sub_action: string | null;
-    /** Additional data as JSON string (null if not provided) */
-    event_details: string | null;
+    /** Sub-action for detailed tracking (optional) */
+    event_sub_action?: string | null;
+    /** Event details as JSON string or object (optional) */
+    event_details?: Record<string, any> | string | null;
+    /** Mapping details as JSON string or object (optional) */
+    mapping_details?: Record<string, any> | string | null;
+    /** Custom data as JSON string or object (optional) */
+    custom_data?: Record<string, any> | string | null;
 }
 /**
  * Additional telemetry data that can be passed with events
@@ -35,15 +43,37 @@ 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;
+    private gameId;
     /**
      * Creates a new HyveClient instance
      * @param config Optional telemetry configuration
@@ -56,17 +86,37 @@ declare class HyveClient {
      */
     authenticateFromUrl(urlParams?: URLSearchParams | string): Promise<boolean>;
     /**
-     * Sends a telemetry event
+     * 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
-     * @param additionalData Optional additional data
+     * @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?: string | null, additionalData?: TelemetryAdditionalData | null): Promise<boolean>;
+    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
@@ -82,11 +132,31 @@ 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 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
      */
@@ -108,6 +178,8 @@ declare function parseUrlParams(searchParams: URLSearchParams | string): {
     gameStartTab: string;
     hyveToken: string;
     platform: string;
+    hyveAccess: string;
+    gameId: string;
 };
 /**
  * Validates an EVM signature against a message and user ID
@@ -158,4 +230,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,9 @@ 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") || "",
+    gameId: params.get("game-id") || ""
   };
 }
 function validateSignature(signature, message) {
@@ -186,9 +188,11 @@ function isDomainAllowed(allowedDomains, hostname) {
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
-  telemetryApiUrl;
+  apiBaseUrl;
   sessionId;
   userId = null;
+  jwtToken = null;
+  gameId = null;
   /**
    * Creates a new HyveClient instance
    * @param config Optional telemetry configuration
@@ -199,10 +203,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 +221,18 @@ 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");
+      }
+      if (params.gameId) {
+        this.gameId = params.gameId;
+        console.log("[Hyve SDK] Game ID extracted from game-id parameter:", this.gameId);
+      }
+      if (this.jwtToken) {
+        console.log("[Hyve SDK] Authentication successful via JWT");
+        return true;
+      }
       const authResult = verifyAuthentication({
         hyveToken: params.hyveToken,
         signature: params.signature,
@@ -234,47 +255,51 @@ var HyveClient = class {
     }
   }
   /**
-   * Sends a telemetry event
+   * 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
-   * @param additionalData Optional additional data
+   * @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
    */
-  async sendTelemetry(eventLocation, eventCategory, eventAction, eventSubCategory, eventSubAction, eventDetails, additionalData) {
-    if (!this.telemetryConfig.apiKey) {
-      console.error("[Hyve Telemetry] API key not configured");
+  async sendTelemetry(eventLocation, eventCategory, eventAction, eventSubCategory, eventSubAction, eventDetails, customData, platformId) {
+    if (!this.jwtToken) {
+      console.error("[Hyve Telemetry] JWT token required. Call authenticateFromUrl first.");
       return false;
     }
-    if (!this.userId) {
-      console.warn("[Hyve Telemetry] No user ID - sending anonymous telemetry");
+    if (!this.gameId) {
+      console.error("[Hyve Telemetry] Game ID required. Ensure game-id URL parameter is set.");
+      return false;
     }
     try {
-      let finalEventDetails = null;
-      if (additionalData && Object.keys(additionalData).length > 0) {
-        finalEventDetails = JSON.stringify(additionalData);
-      } else if (eventDetails) {
-        finalEventDetails = eventDetails;
-      }
+      const toJsonString = (data) => {
+        if (!data) return null;
+        return typeof data === "string" ? data : JSON.stringify(data);
+      };
       const telemetryEvent = {
+        game_id: this.gameId,
         session_id: this.sessionId,
-        hyve_user_id: this.userId || "anonymous",
+        platform_id: platformId || null,
         event_location: eventLocation,
         event_category: eventCategory,
         event_action: eventAction,
         event_sub_category: eventSubCategory || null,
         event_sub_action: eventSubAction || null,
-        event_details: finalEventDetails
+        event_details: toJsonString(eventDetails),
+        custom_data: toJsonString(customData)
       };
-      console.log("[Hyve Telemetry] Sending event:", telemetryEvent);
-      const response = await fetch(this.telemetryApiUrl, {
+      console.log("[Hyve Telemetry] Sending user-level event:", telemetryEvent);
+      const telemetryUrl = `${this.apiBaseUrl}/api/v1/telemetry/send`;
+      const response = await fetch(telemetryUrl, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          "X-API-KEY": this.telemetryConfig.apiKey
+          "Authorization": `Bearer ${this.jwtToken}`
         },
         body: JSON.stringify(telemetryEvent)
       });
@@ -291,6 +316,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 +370,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 +392,27 @@ 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 current game ID
+   * @returns Current game ID or null if not available
+   */
+  getGameId() {
+    return this.gameId;
+  }
+  /**
+   * 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 +420,20 @@ 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;
+    this.gameId = null;
     console.log("[Hyve SDK] User logged out");
   }
   /**

package/dist/index.mjs

@@ -8,7 +8,9 @@ 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") || "",
+    gameId: params.get("game-id") || ""
   };
 }
 function validateSignature(signature, message) {
@@ -153,9 +155,11 @@ function isDomainAllowed(allowedDomains, hostname) {
 // src/core/client.ts
 var HyveClient = class {
   telemetryConfig;
-  telemetryApiUrl;
+  apiBaseUrl;
   sessionId;
   userId = null;
+  jwtToken = null;
+  gameId = null;
   /**
    * Creates a new HyveClient instance
    * @param config Optional telemetry configuration
@@ -166,10 +170,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 +188,18 @@ 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");
+      }
+      if (params.gameId) {
+        this.gameId = params.gameId;
+        console.log("[Hyve SDK] Game ID extracted from game-id parameter:", this.gameId);
+      }
+      if (this.jwtToken) {
+        console.log("[Hyve SDK] Authentication successful via JWT");
+        return true;
+      }
       const authResult = verifyAuthentication({
         hyveToken: params.hyveToken,
         signature: params.signature,
@@ -201,47 +222,51 @@ var HyveClient = class {
     }
   }
   /**
-   * Sends a telemetry event
+   * 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
-   * @param additionalData Optional additional data
+   * @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
    */
-  async sendTelemetry(eventLocation, eventCategory, eventAction, eventSubCategory, eventSubAction, eventDetails, additionalData) {
-    if (!this.telemetryConfig.apiKey) {
-      console.error("[Hyve Telemetry] API key not configured");
+  async sendTelemetry(eventLocation, eventCategory, eventAction, eventSubCategory, eventSubAction, eventDetails, customData, platformId) {
+    if (!this.jwtToken) {
+      console.error("[Hyve Telemetry] JWT token required. Call authenticateFromUrl first.");
       return false;
     }
-    if (!this.userId) {
-      console.warn("[Hyve Telemetry] No user ID - sending anonymous telemetry");
+    if (!this.gameId) {
+      console.error("[Hyve Telemetry] Game ID required. Ensure game-id URL parameter is set.");
+      return false;
     }
     try {
-      let finalEventDetails = null;
-      if (additionalData && Object.keys(additionalData).length > 0) {
-        finalEventDetails = JSON.stringify(additionalData);
-      } else if (eventDetails) {
-        finalEventDetails = eventDetails;
-      }
+      const toJsonString = (data) => {
+        if (!data) return null;
+        return typeof data === "string" ? data : JSON.stringify(data);
+      };
       const telemetryEvent = {
+        game_id: this.gameId,
         session_id: this.sessionId,
-        hyve_user_id: this.userId || "anonymous",
+        platform_id: platformId || null,
         event_location: eventLocation,
         event_category: eventCategory,
         event_action: eventAction,
         event_sub_category: eventSubCategory || null,
         event_sub_action: eventSubAction || null,
-        event_details: finalEventDetails
+        event_details: toJsonString(eventDetails),
+        custom_data: toJsonString(customData)
       };
-      console.log("[Hyve Telemetry] Sending event:", telemetryEvent);
-      const response = await fetch(this.telemetryApiUrl, {
+      console.log("[Hyve Telemetry] Sending user-level event:", telemetryEvent);
+      const telemetryUrl = `${this.apiBaseUrl}/api/v1/telemetry/send`;
+      const response = await fetch(telemetryUrl, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          "X-API-KEY": this.telemetryConfig.apiKey
+          "Authorization": `Bearer ${this.jwtToken}`
         },
         body: JSON.stringify(telemetryEvent)
       });
@@ -258,6 +283,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 +337,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 +359,27 @@ 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 current game ID
+   * @returns Current game ID or null if not available
+   */
+  getGameId() {
+    return this.gameId;
+  }
+  /**
+   * 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 +387,20 @@ 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;
+    this.gameId = 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.2.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",
@@ -44,14 +44,14 @@
     "@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"
+    "@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 restricted",
-    "publish:dry-run": "pnpm publish --dry-run --access restricted --no-git-checks"
+    "publish:npm": "pnpm publish --access public",
+    "publish:dry-run": "pnpm publish --dry-run --access public --no-git-checks"
   }
 }