@lavarage/telemetry 1.0.0 → 1.1.0

package/README.md

@@ -22,7 +22,9 @@ const telemetry = new LavarageTelemetry({
 telemetry.interceptFetch();
 
 // Connect wallet (triggers login event)
-telemetry.setWallet('YourWalletAddress123...');
+// Wallet platform is automatically detected (MetaMask, Phantom, etc.)
+// or you can specify it manually:
+telemetry.setWallet('YourWalletAddress123...', 'MetaMask');
 
 // Track trading pair views
 telemetry.trackPairView('SOL/USDC', { source: 'homepage' });
@@ -206,12 +208,25 @@ All telemetry operations are wrapped in try-catch blocks. Telemetry errors will
 
 ### Methods
 
-#### `setWallet(walletAddress: string)`
+#### `setWallet(walletAddress: string, walletPlatform?: string)`
+
+Set the current wallet address and trigger a login event. The wallet platform (e.g., 'MetaMask', 'Phantom', 'WalletConnect') is automatically detected from the browser environment, but you can also specify it manually.
 
-Set the current wallet address and trigger a login event.
+**Supported auto-detected platforms:**
+- MetaMask
+- Coinbase Wallet
+- Trust Wallet
+- WalletConnect
+- Phantom (Solana)
+- Solflare (Solana)
+- Generic Ethereum/Solana providers
 
 ```typescript
+// Auto-detect wallet platform
 telemetry.setWallet('YourWalletAddress123...');
+
+// Or specify manually
+telemetry.setWallet('YourWalletAddress123...', 'MetaMask');
 ```
 
 #### `interceptFetch()`
@@ -425,12 +440,12 @@ await telemetry.sendLog(
 );
 ```
 
-#### `setWallet(walletAddress: string)`
+#### `setWallet(walletAddress: string, walletPlatform?: string)`
 
-Set the default wallet address for subsequent events. This is optional for backend use since you can specify the wallet in each log call.
+Set the default wallet address for subsequent events. This is optional for backend use since you can specify the wallet in each log call. You can also optionally specify the wallet platform.
 
 ```typescript
-telemetry.setWallet('WalletAddress123...');
+telemetry.setWallet('WalletAddress123...', 'MetaMask');
 // Now all events will use this wallet by default
 telemetry.logWalletEvent(
   null, // Will use the wallet set above

package/dist/index.d.ts

@@ -17,6 +17,11 @@ export declare class LavarageTelemetry {
     constructor(config: TelemetryConfig);
     private generateSessionId;
     private generateRequestId;
+    /**
+     * Detect wallet platform/provider from browser environment
+     * Checks for common wallet providers like MetaMask, Phantom, WalletConnect, etc.
+     */
+    private detectWalletPlatform;
     private normalizeHostFilter;
     private shouldCaptureHost;
     private matchesHost;
@@ -29,7 +34,7 @@ export declare class LavarageTelemetry {
     private flush;
     private initializeCapture;
     private trackError;
-    setWallet(walletAddress: string): void;
+    setWallet(walletAddress: string, walletPlatform?: string): void;
     interceptFetch(): void;
     interceptAxios(axiosInstance: any): void;
     trackPairView(pair: string, metadata?: object): void;

package/dist/index.js

@@ -33,6 +33,77 @@ class LavarageTelemetry {
     generateRequestId() {
         return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
     }
+    /**
+     * Detect wallet platform/provider from browser environment
+     * Checks for common wallet providers like MetaMask, Phantom, WalletConnect, etc.
+     */
+    detectWalletPlatform() {
+        if (typeof window === 'undefined') {
+            return null;
+        }
+        try {
+            const win = window;
+            // Check for Ethereum wallets
+            if (win.ethereum) {
+                // MetaMask
+                if (win.ethereum.isMetaMask) {
+                    return 'MetaMask';
+                }
+                // Coinbase Wallet
+                if (win.ethereum.isCoinbaseWallet) {
+                    return 'Coinbase Wallet';
+                }
+                // Trust Wallet
+                if (win.ethereum.isTrust) {
+                    return 'Trust Wallet';
+                }
+                // WalletConnect
+                if (win.ethereum.isWalletConnect) {
+                    return 'WalletConnect';
+                }
+                // Generic Ethereum provider
+                if (win.ethereum.providers && Array.isArray(win.ethereum.providers)) {
+                    // Multiple providers detected, try to identify
+                    for (const provider of win.ethereum.providers) {
+                        if (provider.isMetaMask)
+                            return 'MetaMask';
+                        if (provider.isCoinbaseWallet)
+                            return 'Coinbase Wallet';
+                        if (provider.isTrust)
+                            return 'Trust Wallet';
+                    }
+                }
+                // Check provider name/version
+                if (win.ethereum.providerName) {
+                    return win.ethereum.providerName;
+                }
+                // Default to generic Ethereum
+                return 'Ethereum';
+            }
+            // Check for Solana wallets
+            if (win.solana) {
+                // Phantom
+                if (win.solana.isPhantom) {
+                    return 'Phantom';
+                }
+                // Solflare
+                if (win.solana.isSolflare) {
+                    return 'Solflare';
+                }
+                // Generic Solana
+                return 'Solana';
+            }
+            // Check for other wallet providers
+            if (win.web3) {
+                return 'Web3';
+            }
+            return null;
+        }
+        catch (error) {
+            // Silently fail detection
+            return null;
+        }
+    }
     normalizeHostFilter(input) {
         if (!input) {
             return { mode: 'all' };
@@ -211,17 +282,24 @@ class LavarageTelemetry {
         if (typeof fetch !== 'undefined') {
             return fetch;
         }
-        // Try to use node-fetch if available (for older Node.js)
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const nodeFetch = require('node-fetch');
-            // Handle both node-fetch v2 (default export) and v3 (named export)
-            return (nodeFetch.default || nodeFetch);
+        // In browser environments, fetch should always be available
+        if (typeof window !== 'undefined') {
+            throw new Error('fetch is not available in browser environment');
         }
-        catch {
-            // Silently fail - will be caught in flush method
-            throw new Error('fetch is not available. Please use Node.js 18+ or install node-fetch');
+        // Only try to use node-fetch in Node.js environments (for older Node.js versions)
+        // This code will be tree-shaken by bundlers for browser builds
+        if (typeof require !== 'undefined') {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const nodeFetch = require('node-fetch');
+                // Handle both node-fetch v2 (default export) and v3 (named export)
+                return (nodeFetch.default || nodeFetch);
+            }
+            catch {
+                // node-fetch not available
+            }
         }
+        throw new Error('fetch is not available. Please use Node.js 18+ or install node-fetch');
     }
     async flush(useKeepalive = false) {
         if (this.eventQueue.length === 0) {
@@ -318,9 +396,11 @@ class LavarageTelemetry {
             url: typeof window !== 'undefined' ? window.location.href : '',
         });
     }
-    setWallet(walletAddress) {
+    setWallet(walletAddress, walletPlatform) {
         try {
             this.wallet = walletAddress;
+            // Detect wallet platform if not provided
+            const detectedPlatform = walletPlatform || this.detectWalletPlatform();
             // Track login event
             this.enqueue({
                 type: 'login',
@@ -329,6 +409,7 @@ class LavarageTelemetry {
                 timestamp: Date.now(),
                 sessionId: this.sessionId,
                 userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : '',
+                walletPlatform: detectedPlatform || null,
             });
         }
         catch (error) {

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@lavarage/telemetry",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Production telemetry SDK for Lavarage and partner applications",
   "main": "dist/index.js",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "browser": {
+    "./dist/index.js": "./dist/index.js",
+    "node-fetch": false
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -13,9 +18,6 @@
   "keywords": ["telemetry", "analytics", "monitoring", "lavarage"],
   "author": "Lavarage",
   "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
   "peerDependencies": {
     "node-fetch": "^2.6.0 || ^3.0.0"
   },