@avalix/chroma 0.0.10 → 0.0.12

package/README.md

@@ -2,8 +2,6 @@
 
 End-to-end testing library for Polkadot wallet interactions using Playwright.
 
-> **⚠️ Active Development**: This library is currently under active development. The API may change and breaking changes can occur between versions. Please pin your version and review changelogs carefully when updating.
-
 ## Installation
 
 ```bash
@@ -27,7 +25,7 @@ This will download the wallet extensions (Polkadot JS and Talisman) to `./.chrom
 ```json
 {
   "scripts": {
-    "prepare": "chroma download-extensions"
+    "test:prepare": "chroma download-extensions"
   }
 }
 ```
@@ -36,258 +34,60 @@ This will download the wallet extensions (Polkadot JS and Talisman) to `./.chrom
 
 ## Quick Start
 
-### Basic Usage
-
 ```typescript
-import { expect, test } from '@avalix/chroma'
+import { createWalletTest, expect } from '@avalix/chroma'
 
-test('should connect wallet and sign transaction', async ({ page, wallets }) => {
+const test = createWalletTest({
+  wallets: [{ type: 'polkadot-js' }]
+})
+
+test('connect wallet and sign transaction', async ({ page, wallets }) => {
   const polkadotJs = wallets['polkadot-js']
 
-  // Import a test account
   await polkadotJs.importMnemonic({
     seed: 'bottom drive obey lake curtain smoke basket hold race lonely fit walk',
     name: 'Test Account',
     password: 'securePassword123'
   })
 
-  // Navigate to your dApp
   await page.goto('http://localhost:3000')
-
-  // Connect wallet
   await page.click('button:has-text("Connect Wallet")')
   await polkadotJs.authorize()
 
-  // Perform transaction
   await page.click('button:has-text("Send Transaction")')
   await polkadotJs.approveTx({ password: 'securePassword123' })
 
-  // Verify transaction success
   await expect(page.locator('.transaction-success')).toBeVisible()
 })
 ```
 
-### Custom Configuration
-
-```typescript
-import { createWalletTest, expect } from '@avalix/chroma'
-
-const customTest = createWalletTest({
-  wallets: [{ type: 'polkadot-js' }],
-  headless: false,
-  slowMo: 100
-})
-
-customTest('test with custom config', async ({ page, wallets }) => {
-  const polkadotJs = wallets['polkadot-js']
-
-  await polkadotJs.importMnemonic({
-    seed: 'your seed phrase here...',
-    name: 'My Test Account'
-  })
-  await page.goto('http://localhost:3000')
-  await polkadotJs.authorize()
-})
-```
-
 ### Multiple Wallets
 
 ```typescript
-import { createWalletTest, expect } from '@avalix/chroma'
+import { createWalletTest } from '@avalix/chroma'
 
-// Test with multiple wallet extensions
-const multiWalletTest = createWalletTest({
-  wallets: [
-    { type: 'polkadot-js' },
-    { type: 'talisman' }
-  ],
-  headless: false,
-  slowMo: 150
+const test = createWalletTest({
+  wallets: [{ type: 'polkadot-js' }, { type: 'talisman' }]
 })
 
-multiWalletTest('test with multiple wallets', async ({ page, wallets }) => {
+test('multi-wallet test', async ({ page, wallets }) => {
   const polkadotJs = wallets['polkadot-js']
   const talisman = wallets.talisman
 
-  // Import to Polkadot JS
-  await polkadotJs.importMnemonic({
-    seed: 'bottom drive obey lake curtain smoke basket hold race lonely fit walk',
-    name: 'Alice'
-  })
-
-  // Import to Talisman using Ethereum private key
-  await talisman.importEthPrivateKey({
-    privateKey: '0x...',
-    name: 'Bob'
-  })
+  await polkadotJs.importMnemonic({ seed: '...', name: 'Alice' })
+  await talisman.importEthPrivateKey({ privateKey: '0x...', name: 'Bob' })
 
   await page.goto('http://localhost:3000')
-
-  // Use specific wallet
   await polkadotJs.authorize()
-  await polkadotJs.approveTx()
 })
 ```
 
 ## Features
 
-- 🔐 **Easy Extension Setup**: Simple command to download wallet extensions
-- 🧪 **Test Fixtures**: Ready-to-use Playwright fixtures for wallet operations
-- 📝 **Account Management**: Import accounts with seed phrases and custom names
-- ✅ **Transaction Approval**: Approve transactions with password authentication
-- 🔗 **dApp Authorization**: Connect wallet to decentralized applications
-- 🔀 **Multi-Wallet Support**: Test with multiple wallet extensions simultaneously
-- ⚙️ **Configurable**: Custom extension paths, headless mode, and slow motion settings
-
-## API Reference
-
-### Core Functions
-
-#### `test` (Default Test Function)
-Pre-configured test function with Polkadot JS extension.
-
-```typescript
-import { test } from '@avalix/chroma'
-
-test('my wallet test', async ({ page, wallets }) => {
-  const polkadotJs = wallets['polkadot-js']
-
-  await polkadotJs.importMnemonic({ seed: '...' })
-  await polkadotJs.authorize()
-})
-```
-
-#### `createWalletTest(options?: ChromaTestOptions)`
-Create a custom test function with specific configuration. Supports single and multi-wallet modes.
-
-```typescript
-import { createWalletTest } from '@avalix/chroma'
-
-// Single wallet (default)
-const test = createWalletTest()
-
-// Single wallet with custom config
-const customTest = createWalletTest({
-  wallets: [{ type: 'polkadot-js' }],
-  headless: false,
-  slowMo: 150
-})
-
-// Multiple wallets
-const multiTest = createWalletTest({
-  wallets: [
-    { type: 'polkadot-js' },
-    { type: 'talisman' }
-  ]
-})
-
-// Usage
-test('example', async ({ page, wallets }) => {
-  const polkadotJs = wallets['polkadot-js']
-
-  await polkadotJs.importMnemonic({ seed: '...' })
-  await polkadotJs.authorize()
-  await polkadotJs.approveTx()
-})
-```
-
-### Test Fixtures
-
-#### `page`
-Playwright page instance with wallet extension(s) loaded.
-
-#### `wallets`
-Typed object containing wallet instances for each configured wallet. Provides full TypeScript autocomplete.
-
-```typescript
-// Base wallet instance (common methods)
-interface BaseWalletInstance {
-  extensionId: string
-  importMnemonic: (options: WalletAccount) => Promise<void>
-  authorize: (options?: { accountName?: string }) => Promise<void>
-  approveTx: (options?: { password?: string }) => Promise<void>
-}
-
-// Polkadot-JS wallet instance
-interface PolkadotJsWalletInstance extends BaseWalletInstance {
-  type: 'polkadot-js'
-}
-
-// Talisman wallet instance (with additional methods)
-interface TalismanWalletInstance extends BaseWalletInstance {
-  type: 'talisman'
-  importEthPrivateKey: (options: { privateKey: string, name?: string, password?: string }) => Promise<void>
-}
-
-// Note: Talisman currently does not support importMnemonic - use importEthPrivateKey instead
-
-// Wallets collection - each wallet has its specific type
-interface Wallets {
-  'polkadot-js': PolkadotJsWalletInstance
-  'talisman': TalismanWalletInstance
-}
-
-interface WalletAccount {
-  seed: string
-  name?: string // Default: 'Test Account'
-  password?: string // Default: 'h3llop0lkadot!'
-}
-```
-
-**Usage:**
-
-```typescript
-test('example', async ({ page, wallets }) => {
-  const polkadotJs = wallets['polkadot-js'] // Type: PolkadotJsWalletInstance
-
-  // Import mnemonic (available on all wallets)
-  await polkadotJs.importMnemonic({
-    seed: 'bottom drive obey lake curtain smoke basket hold race lonely fit walk',
-    name: 'Test Account',
-    password: 'securePassword123'
-  })
-
-  await page.goto('http://localhost:3000')
-  await polkadotJs.authorize()
-  await polkadotJs.approveTx({ password: 'securePassword123' })
-})
-
-// Talisman-specific features
-test('talisman example', async ({ page, wallets }) => {
-  const talisman = wallets.talisman // Type: TalismanWalletInstance
-
-  // Talisman-specific method: import Ethereum private key
-  await talisman.importEthPrivateKey({
-    privateKey: '0x...',
-    name: 'My Account',
-    password: 'mypassword'
-  })
-
-  // Common methods also available
-  await talisman.authorize({ accountName: 'My Account' })
-  await talisman.approveTx()
-})
-```
-
-## Configuration
-
-### Extension Download
-Run the download command to get the required wallet extensions:
-
-```bash
-npx chroma download-extensions
-```
-
-Extensions will be downloaded to `./.chroma` directory in your project root. Add this directory to your `.gitignore`:
-
-```gitignore
-.chroma/
-```
-
-### Browser Settings
-- **Headless Mode**: Disabled by default for better debugging
-- **Slow Motion**: 150ms delay between actions (configurable)
-- **Extension Loading**: Automatically loads configured wallet extensions
+- **Easy Extension Setup** - Download wallet extensions with a single command
+- **Multi-Wallet Support** - Test with multiple wallet extensions simultaneously
+- **TypeScript Support** - Full type safety and autocomplete
+- **VS Code Integration** - Works with [Playwright Test for VS Code](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright)
 
 ## Supported Chains
 
@@ -301,23 +101,16 @@ Extensions will be downloaded to `./.chroma` directory in your project root. Add
 
 | Wallet | Status | Version |
 |--------|--------|---------|
-| Polkadot JS Extension | ✅ Supported | v0.61.7 |
-| Talisman | ✅ Supported | v3.0.5 |
+| Polkadot JS Extension | ✅ Supported | v0.62.6 |
+| Talisman | ✅ Supported | v3.1.13 |
 | SubWallet | ⏳ Planned | - |
+| MetaMask | ⏳ Planned | - |
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 24+
 - @playwright/test ^1.55.0
 
-## Contributing
-
-This project is in active development. Currently focusing on:
-- Polkadot JS Extension and Talisman support
-- Core testing fixtures
-- Additional wallet integrations
-- Documentation improvements
-
 ## License
 
 MIT