@phantom/browser-sdk 0.3.5 → 0.3.7

package/README.md

@@ -11,11 +11,12 @@ npm install @phantom/browser-sdk
 ### Injected Provider (Browser Extension)
 
 ```typescript
-import { BrowserSDK, NetworkId } from "@phantom/browser-sdk";
+import { BrowserSDK, NetworkId, AddressType } from "@phantom/browser-sdk";
 
 // Connect to Phantom browser extension
 const sdk = new BrowserSDK({
   providerType: "injected",
+  addressTypes: [AddressType.solana],
 });
 
 const { addresses } = await sdk.connect();
@@ -68,6 +69,7 @@ Uses the Phantom browser extension installed by the user. No additional configur
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "injected",
+  addressTypes: [AddressType.solana],
 });
 ```
 
@@ -89,10 +91,6 @@ const sdk = new BrowserSDK({
   appName: "My DApp", // optional, for branding
   appLogo: "https://myapp.com/logo.png", // optional, for branding
   autoConnect: true, // optional, auto-connect to existing session (default: true for embedded)
-  debug: {
-    enabled: true, // optional, enable debug logging
-    level: "info", // optional, debug level
-  },
 });
 ```
 
@@ -169,6 +167,7 @@ The SDK can automatically reconnect to existing sessions when instantiated, prov
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "embedded",
+  addressTypes: [AddressType.solana],
   // ... other config
   autoConnect: true, // Default: true for embedded, false for injected
 });
@@ -191,6 +190,7 @@ if (sdk.isConnected()) {
 ```typescript
 const sdk = new BrowserSDK({
   providerType: "embedded",
+  addressTypes: [AddressType.solana],
   // ... other config
   autoConnect: false, // Disable auto-connect
 });
@@ -214,7 +214,7 @@ interface BrowserSDKConfig {
   providerType: "injected" | "embedded";
   appName?: string; // Optional app name for branding
   appLogo?: string; // Optional app logo URL for branding
-  addressTypes?: AddressType[]; // Networks to enable (e.g., [AddressType.solana])
+  addressTypes?: [AddressType, ...AddressType[]]; // Networks to enable (e.g., [AddressType.solana])
 
   // Required for embedded provider only
   apiBaseUrl?: string; // Phantom API base URL
@@ -226,13 +226,6 @@ interface BrowserSDKConfig {
   embeddedWalletType?: "app-wallet" | "user-wallet"; // Wallet type
   solanaProvider?: "web3js" | "kit"; // Solana library choice (default: 'web3js')
   autoConnect?: boolean; // Enable auto-connect to existing sessions (default: true)
-
-  // Debug options
-  debug?: {
-    enabled?: boolean; // Enable debug logging
-    level?: "info" | "warn" | "error"; // Debug level
-    callback?: (level: string, message: string, data?: any) => void; // Custom debug callback
-  };
 }
 ```
 
@@ -362,6 +355,110 @@ Attempt auto-connection using existing session. Should be called after setting u
 await sdk.autoConnect();
 ```
 
+## Debug Configuration
+
+The BrowserSDK provides dynamic debug configuration that can be changed at runtime without reinstantiating the SDK. This provides better performance and cleaner architecture.
+
+### Debug Methods
+
+```typescript
+// Enable debug logging
+sdk.enableDebug();
+
+// Disable debug logging  
+sdk.disableDebug();
+
+// Set debug level
+sdk.setDebugLevel(DebugLevel.INFO);
+
+// Set debug callback function
+sdk.setDebugCallback((message) => {
+  console.log(`[${message.category}] ${message.message}`, message.data);
+});
+
+// Configure all debug settings at once
+sdk.configureDebug({
+  enabled: true,
+  level: DebugLevel.DEBUG,
+  callback: (message) => {
+    // Handle debug messages
+    console.log(`[${message.level}] ${message.category}: ${message.message}`);
+  }
+});
+```
+
+### Debug Levels
+
+```typescript
+import { DebugLevel } from "@phantom/browser-sdk";
+
+// Available debug levels (in order of verbosity)
+DebugLevel.ERROR   // 0 - Only error messages
+DebugLevel.WARN    // 1 - Warning and error messages  
+DebugLevel.INFO    // 2 - Info, warning, and error messages
+DebugLevel.DEBUG   // 3 - All debug messages (most verbose)
+```
+
+### Debug Message Structure
+
+Debug callbacks receive a `DebugMessage` object:
+
+```typescript
+interface DebugMessage {
+  timestamp: number;     // Unix timestamp
+  level: DebugLevel;     // Message level
+  category: string;      // Component category (e.g., "BrowserSDK", "ProviderManager")
+  message: string;       // Debug message text
+  data?: any;           // Additional debug data (optional)
+}
+```
+
+### Example: Debug Console Implementation
+
+```typescript
+import { BrowserSDK, DebugLevel } from "@phantom/browser-sdk";
+
+const sdk = new BrowserSDK({
+  providerType: "embedded",
+  // ... other config
+});
+
+// Store debug messages
+const debugMessages: DebugMessage[] = [];
+
+// Set up debug system
+sdk.configureDebug({
+  enabled: true,
+  level: DebugLevel.INFO,
+  callback: (message) => {
+    debugMessages.push(message);
+    
+    // Keep only last 100 messages
+    if (debugMessages.length > 100) {
+      debugMessages.shift();
+    }
+    
+    // Update UI
+    updateDebugConsole();
+  }
+});
+
+// Dynamic debug level changing
+function changeDebugLevel(newLevel: DebugLevel) {
+  sdk.setDebugLevel(newLevel);
+  console.log(`Debug level changed to: ${DebugLevel[newLevel]}`);
+}
+
+// Toggle debug on/off
+function toggleDebug(enabled: boolean) {
+  if (enabled) {
+    sdk.enableDebug();
+  } else {
+    sdk.disableDebug();
+  }
+}
+```
+
 ## Transaction Examples
 
 ### Solana Transactions

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { EmbeddedProviderConfig, AuthOptions, ConnectResult, SignMessageParams, SignMessageResult, SignAndSendTransactionParams, SignedTransaction, WalletAddress, EmbeddedProviderEvent, EventCallback } from '@phantom/embedded-provider-core';
 export { AuthOptions, ConnectResult, SignAndSendTransactionParams, SignMessageParams, SignMessageResult, SignedTransaction, WalletAddress } from '@phantom/embedded-provider-core';
-export { NetworkId } from '@phantom/constants';
+import { AddressType } from '@phantom/client';
 export { AddressType } from '@phantom/client';
+export { NetworkId } from '@phantom/constants';
 
 declare enum DebugLevel {
     ERROR = 0,
@@ -47,17 +48,18 @@ declare const DebugCategory: {
     readonly SESSION: "Session";
 };
 
+interface DebugConfig {
+    enabled?: boolean;
+    level?: DebugLevel;
+    callback?: DebugCallback;
+}
 interface BrowserSDKConfig extends Partial<EmbeddedProviderConfig> {
     providerType: "injected" | "embedded" | (string & Record<never, never>);
+    addressTypes: [AddressType, ...AddressType[]];
     apiBaseUrl?: string;
     organizationId?: string;
     embeddedWalletType?: "app-wallet" | "user-wallet" | (string & Record<never, never>);
     autoConnect?: boolean;
-    debug?: {
-        enabled?: boolean;
-        level?: DebugLevel;
-        callback?: DebugCallback;
-    };
 }
 
 interface Provider {
@@ -145,6 +147,34 @@ declare class BrowserSDK {
      * Only works with embedded providers
      */
     autoConnect(): Promise<void>;
+    /**
+     * Debug configuration methods
+     * These allow dynamic debug configuration without SDK reinstantiation
+     */
+    /**
+     * Enable debug logging
+     */
+    enableDebug(): void;
+    /**
+     * Disable debug logging
+     */
+    disableDebug(): void;
+    /**
+     * Set debug level
+     */
+    setDebugLevel(level: DebugLevel): void;
+    /**
+     * Set debug callback function
+     */
+    setDebugCallback(callback: DebugCallback): void;
+    /**
+     * Configure debug settings all at once
+     */
+    configureDebug(config: {
+        enabled?: boolean;
+        level?: DebugLevel;
+        callback?: DebugCallback;
+    }): void;
 }
 
 /**
@@ -180,4 +210,4 @@ declare function getPlatformName(): string;
  */
 declare function getBrowserDisplayName(): string;
 
-export { BrowserInfo, BrowserSDK, BrowserSDKConfig, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getPlatformName, parseBrowserFromUserAgent };
+export { BrowserInfo, BrowserSDK, BrowserSDKConfig, DEFAULT_AUTH_URL, DEFAULT_WALLET_API_URL, DebugCallback, DebugCategory, DebugConfig, DebugLevel, DebugMessage, Provider, debug, detectBrowser, getBrowserDisplayName, getPlatformName, parseBrowserFromUserAgent };

package/dist/index.js

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  AddressType: () => import_client2.AddressType,
+  AddressType: () => import_client3.AddressType,
   BrowserSDK: () => BrowserSDK,
   DEFAULT_AUTH_URL: () => DEFAULT_AUTH_URL,
   DEFAULT_WALLET_API_URL: () => DEFAULT_WALLET_API_URL,
@@ -138,7 +138,7 @@ var InjectedProvider = class {
     this.browserInjectedCleanupFunctions = [];
     this.eventsInitialized = false;
     debug.log(DebugCategory.INJECTED_PROVIDER, "Initializing InjectedProvider", { config });
-    this.addressTypes = config.addressTypes || [import_client.AddressType.solana, import_client.AddressType.ethereum];
+    this.addressTypes = config.addressTypes;
     debug.log(DebugCategory.INJECTED_PROVIDER, "Address types configured", { addressTypes: this.addressTypes });
     const plugins = [(0, import_browser_injected_sdk.createExtensionPlugin)()];
     if (this.addressTypes.includes(import_client.AddressType.solana)) {
@@ -1058,7 +1058,7 @@ var ProviderManager = class {
     if (type === "injected") {
       provider = new InjectedProvider({
         solanaProvider: this.config.solanaProvider || "web3js",
-        addressTypes: this.config.addressTypes || []
+        addressTypes: this.config.addressTypes
       });
     } else {
       if (!this.config.apiBaseUrl || !this.config.organizationId) {
@@ -1069,7 +1069,7 @@ var ProviderManager = class {
         organizationId: this.config.organizationId,
         authOptions: this.config.authOptions,
         embeddedWalletType: embeddedWalletType || "app-wallet",
-        addressTypes: this.config.addressTypes || [],
+        addressTypes: this.config.addressTypes,
         solanaProvider: this.config.solanaProvider || "web3js",
         appLogo: this.config.appLogo,
         // Optional app logo URL
@@ -1124,20 +1124,10 @@ var ProviderManager = class {
 var import_browser_injected_sdk2 = require("@phantom/browser-injected-sdk");
 var BrowserSDK = class {
   constructor(config) {
-    if (config.debug?.enabled) {
-      debug.enable();
-      if (config.debug.level !== void 0) {
-        debug.setLevel(config.debug.level);
-      }
-      if (config.debug.callback) {
-        debug.setCallback(config.debug.callback);
-      }
-    }
     debug.info(DebugCategory.BROWSER_SDK, "Initializing BrowserSDK", {
       providerType: config.providerType,
       embeddedWalletType: config.embeddedWalletType,
-      addressTypes: config.addressTypes,
-      debugEnabled: config.debug?.enabled
+      addressTypes: config.addressTypes
     });
     if (!["injected", "embedded"].includes(config.providerType)) {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid providerType", { providerType: config.providerType });
@@ -1323,8 +1313,60 @@ var BrowserSDK = class {
       });
     }
   }
+  /**
+   * Debug configuration methods
+   * These allow dynamic debug configuration without SDK reinstantiation
+   */
+  /**
+   * Enable debug logging
+   */
+  enableDebug() {
+    debug.enable();
+    debug.info(DebugCategory.BROWSER_SDK, "Debug logging enabled");
+  }
+  /**
+   * Disable debug logging
+   */
+  disableDebug() {
+    debug.disable();
+  }
+  /**
+   * Set debug level
+   */
+  setDebugLevel(level) {
+    debug.setLevel(level);
+    debug.info(DebugCategory.BROWSER_SDK, "Debug level updated", { level });
+  }
+  /**
+   * Set debug callback function
+   */
+  setDebugCallback(callback) {
+    debug.setCallback(callback);
+    debug.info(DebugCategory.BROWSER_SDK, "Debug callback updated");
+  }
+  /**
+   * Configure debug settings all at once
+   */
+  configureDebug(config) {
+    if (config.enabled !== void 0) {
+      if (config.enabled) {
+        this.enableDebug();
+      } else {
+        this.disableDebug();
+      }
+    }
+    if (config.level !== void 0) {
+      this.setDebugLevel(config.level);
+    }
+    if (config.callback !== void 0) {
+      this.setDebugCallback(config.callback);
+    }
+  }
 };
 
+// src/types.ts
+var import_client2 = require("@phantom/client");
+
 // src/index.ts
 var import_constants3 = require("@phantom/constants");
-var import_client2 = require("@phantom/client");
+var import_client3 = require("@phantom/client");

package/dist/index.mjs

@@ -91,7 +91,7 @@ var InjectedProvider = class {
     this.browserInjectedCleanupFunctions = [];
     this.eventsInitialized = false;
     debug.log(DebugCategory.INJECTED_PROVIDER, "Initializing InjectedProvider", { config });
-    this.addressTypes = config.addressTypes || [AddressType.solana, AddressType.ethereum];
+    this.addressTypes = config.addressTypes;
     debug.log(DebugCategory.INJECTED_PROVIDER, "Address types configured", { addressTypes: this.addressTypes });
     const plugins = [createExtensionPlugin()];
     if (this.addressTypes.includes(AddressType.solana)) {
@@ -1011,7 +1011,7 @@ var ProviderManager = class {
     if (type === "injected") {
       provider = new InjectedProvider({
         solanaProvider: this.config.solanaProvider || "web3js",
-        addressTypes: this.config.addressTypes || []
+        addressTypes: this.config.addressTypes
       });
     } else {
       if (!this.config.apiBaseUrl || !this.config.organizationId) {
@@ -1022,7 +1022,7 @@ var ProviderManager = class {
         organizationId: this.config.organizationId,
         authOptions: this.config.authOptions,
         embeddedWalletType: embeddedWalletType || "app-wallet",
-        addressTypes: this.config.addressTypes || [],
+        addressTypes: this.config.addressTypes,
         solanaProvider: this.config.solanaProvider || "web3js",
         appLogo: this.config.appLogo,
         // Optional app logo URL
@@ -1077,20 +1077,10 @@ var ProviderManager = class {
 import { isPhantomExtensionInstalled } from "@phantom/browser-injected-sdk";
 var BrowserSDK = class {
   constructor(config) {
-    if (config.debug?.enabled) {
-      debug.enable();
-      if (config.debug.level !== void 0) {
-        debug.setLevel(config.debug.level);
-      }
-      if (config.debug.callback) {
-        debug.setCallback(config.debug.callback);
-      }
-    }
     debug.info(DebugCategory.BROWSER_SDK, "Initializing BrowserSDK", {
       providerType: config.providerType,
       embeddedWalletType: config.embeddedWalletType,
-      addressTypes: config.addressTypes,
-      debugEnabled: config.debug?.enabled
+      addressTypes: config.addressTypes
     });
     if (!["injected", "embedded"].includes(config.providerType)) {
       debug.error(DebugCategory.BROWSER_SDK, "Invalid providerType", { providerType: config.providerType });
@@ -1276,13 +1266,65 @@ var BrowserSDK = class {
       });
     }
   }
+  /**
+   * Debug configuration methods
+   * These allow dynamic debug configuration without SDK reinstantiation
+   */
+  /**
+   * Enable debug logging
+   */
+  enableDebug() {
+    debug.enable();
+    debug.info(DebugCategory.BROWSER_SDK, "Debug logging enabled");
+  }
+  /**
+   * Disable debug logging
+   */
+  disableDebug() {
+    debug.disable();
+  }
+  /**
+   * Set debug level
+   */
+  setDebugLevel(level) {
+    debug.setLevel(level);
+    debug.info(DebugCategory.BROWSER_SDK, "Debug level updated", { level });
+  }
+  /**
+   * Set debug callback function
+   */
+  setDebugCallback(callback) {
+    debug.setCallback(callback);
+    debug.info(DebugCategory.BROWSER_SDK, "Debug callback updated");
+  }
+  /**
+   * Configure debug settings all at once
+   */
+  configureDebug(config) {
+    if (config.enabled !== void 0) {
+      if (config.enabled) {
+        this.enableDebug();
+      } else {
+        this.disableDebug();
+      }
+    }
+    if (config.level !== void 0) {
+      this.setDebugLevel(config.level);
+    }
+    if (config.callback !== void 0) {
+      this.setDebugCallback(config.callback);
+    }
+  }
 };
 
+// src/types.ts
+import { AddressType as AddressType2 } from "@phantom/client";
+
 // src/index.ts
 import { NetworkId } from "@phantom/constants";
-import { AddressType as AddressType2 } from "@phantom/client";
+import { AddressType as AddressType3 } from "@phantom/client";
 export {
-  AddressType2 as AddressType,
+  AddressType3 as AddressType,
   BrowserSDK,
   DEFAULT_AUTH_URL,
   DEFAULT_WALLET_API_URL,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phantom/browser-sdk",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Browser SDK for Phantom Wallet with unified interface",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -30,9 +30,9 @@
   "dependencies": {
     "@phantom/base64url": "^0.1.0",
     "@phantom/browser-injected-sdk": "^0.0.9",
-    "@phantom/client": "^0.1.8",
+    "@phantom/client": "^0.1.9",
     "@phantom/constants": "^0.0.3",
-    "@phantom/embedded-provider-core": "^0.1.6",
+    "@phantom/embedded-provider-core": "^0.1.8",
     "@phantom/indexed-db-stamper": "^0.1.4",
     "@phantom/parsers": "^0.0.7",
     "axios": "^1.10.0",