Merge pull request #1 from pawanpaudel93/feat/browser-profiles

feat: browser profiles

Author: pawanpaudel93

README.md

@@ -76,9 +76,13 @@ const wallet = new NodeArweaveWallet({
   port: 3737,              // Optional: port number (default: 3737, use 0 for random)
   freePort: false,         // Optional: auto-free port if in use (default: false)
   requestTimeout: 300000,  // Optional: request timeout in ms (default: 5 minutes)
+  browser: 'chrome',       // Optional: specify browser (default: system default)
+  browserProfile: 'Work',  // Optional: specify browser profile
 })
 ```
 
+See [Configuration](#️-configuration) for more information.
+
 #### `wallet.initialize()`
 
 Starts the local server and opens the browser for wallet connection.
@@ -94,7 +98,7 @@ Connects to the wallet with specified permissions, app info and gateway.
 ```typescript
 await wallet.connect(['ACCESS_ADDRESS', 'SIGN_TRANSACTION'], {
   name: 'My App',
-  logo: 'https://example.com/logo.png',
+  logo: 'https://arweave.net/azW8iYR5A6bPXyS6WpMmw-qLTXNleS-vv4LJDR9Hf-s',
 })
 ```
 
@@ -448,6 +452,70 @@ const wallet = new NodeArweaveWallet({
 
 **Note:** The timeout applies to individual wallet operations (signing, encrypting, etc.). If the user doesn't respond within this time, the operation will fail with a timeout error.
 
+**Browser Options:**
+
+You can specify which browser to open for wallet connection:
+
+```typescript
+// Use a specific browser by name
+const wallet = new NodeArweaveWallet({ browser: 'chrome' })    // Google Chrome
+const wallet = new NodeArweaveWallet({ browser: 'firefox' })   // Firefox
+const wallet = new NodeArweaveWallet({ browser: 'edge' })      // Microsoft Edge
+const wallet = new NodeArweaveWallet({ browser: 'brave' })     // Brave Browser
+const wallet = new NodeArweaveWallet({ browser: 'opera' })     // Opera
+
+// Disable auto-opening (you'll need to open the URL manually)
+const wallet = new NodeArweaveWallet({ browser: false })
+```
+
+**Browser Profile Options:**
+
+You can also specify a browser profile to use:
+
+```typescript
+// Chromium-based browsers (Chrome, Edge, Brave, Opera, Vivaldi)
+// Use profile directory name OR display name (auto-resolved)
+const wallet = new NodeArweaveWallet({ 
+  browser: 'chrome',
+  browserProfile: 'Profile 1'  // or 'Default', 'Profile 2', 'Work', 'Personal', etc.
+})
+
+// Firefox-based browsers (Firefox, Zen)
+// Use profile name exactly as shown in profile manager
+const wallet = new NodeArweaveWallet({ 
+  browser: 'firefox',
+  browserProfile: 'dev-edition-default'  // or your custom profile name
+})
+
+// Opera (Note: Opera doesn't support profile arguments, profile option is ignored)
+const wallet = new NodeArweaveWallet({ 
+  browser: 'opera'
+  // browserProfile is not supported for Opera
+})
+```
+
+**Important:** The library automatically resolves display names to directory names for some Chromium-based browsers!
+
+- **Chrome/Edge/Brave/Vivaldi:** You can use either the display name ("Work") or directory name ("Profile 2")
+- **Firefox/Zen:** Use the profile name exactly as shown in the profile manager
+- **Opera:** Profile selection is not supported (profile option is ignored)
+
+**How to find your profile name:**
+
+1. **Chrome/Edge/Brave/Vivaldi:**
+   - Open `chrome://version/` (or `edge://version/`, `brave://version/`, `vivaldi://version/`)
+   - Look for "Profile Path"
+   - You can use either:
+     - The display name shown in the browser UI: `'Work'`, `'Personal'`
+     - The directory name (last part of path): `'Default'`, `'Profile 1'`, `'Profile 2'`
+
+2. **Firefox/Zen:**
+   - Run `firefox -P` (or `zen -P`) to open the profile manager
+   - Use the exact profile name shown (e.g., `'default-release'`, `'dev-edition-default'`)
+
+3. **Opera:**
+   - Profile selection is not supported by Opera's command-line interface
+
 ## 💡 Usage Examples
 
 ### CLI Tool Example

package.json

@@ -60,7 +60,8 @@
     "@dha-team/arbundles": "catalog:",
     "arweave": "catalog:",
     "kill-port": "catalog:",
-    "nanoid": "catalog:"
+    "nanoid": "catalog:",
+    "open": "catalog:"
   },
   "devDependencies": {
     "@antfu/eslint-config": "catalog:cli",

pnpm-lock.yaml

@@ -13,6 +13,7 @@ catalog:
   html-minifier-terser: ^7.2.0
   kill-port: ^2.0.1
   nanoid: ^5.1.6
+  open: ^10.2.0
   prettier: ^3.6.2
   terser: ^5.44.0