@dominusnode/sdk 1.1.2 → 1.3.0

package/README.md

@@ -28,25 +28,27 @@ pnpm add @dominusnode/sdk
 ## Quick Start
 
 ```typescript
-import { DominusNodeClient } from '@dominusnode/sdk';
+import { DominusNodeClient } from "@dominusnode/sdk";
 
 // Connect with API key
-const client = new DominusNodeClient({ baseUrl: 'https://api.dominusnode.com' });
-await client.connectWithKey('dn_live_your_api_key');
+const client = new DominusNodeClient({
+  baseUrl: "https://api.dominusnode.com",
+});
+await client.connectWithKey("dn_live_your_api_key");
 
 // Check balance
 const balance = await client.wallet.getBalance();
 console.log(`Balance: $${balance.balanceUsd}`);
 
 // Build proxy URL
-const proxyUrl = client.proxy.buildUrl('dn_live_your_key', {
-  protocol: 'http',
-  country: 'US',
-  state: 'california',
-  city: 'losangeles',
+const proxyUrl = client.proxy.buildUrl("dn_live_your_key", {
+  protocol: "http",
+  country: "US",
+  state: "california",
+  city: "losangeles",
 });
 console.log(proxyUrl);
-// => http://user-country_US-state_california-city_losangeles:dn_live_your_key@proxy.dominusnode.com:8080
+// => http://user-country-US-state-california-city-losangeles:dn_live_your_key@proxy.dominusnode.com:8080
 ```
 
 ## Authentication
@@ -58,8 +60,10 @@ The SDK supports three authentication modes. All authenticated requests automati
 Best for server-side scripts and backend integrations. The key is exchanged for a JWT token pair on the first call.
 
 ```typescript
-const client = new DominusNodeClient({ baseUrl: 'https://api.dominusnode.com' });
-await client.connectWithKey('dn_live_your_api_key');
+const client = new DominusNodeClient({
+  baseUrl: "https://api.dominusnode.com",
+});
+await client.connectWithKey("dn_live_your_api_key");
 ```
 
 ### Email + Password
@@ -67,12 +71,17 @@ await client.connectWithKey('dn_live_your_api_key');
 Best for interactive applications where the user logs in with credentials. Supports MFA (TOTP or backup codes).
 
 ```typescript
-const client = new DominusNodeClient({ baseUrl: 'https://api.dominusnode.com' });
-const result = await client.connectWithCredentials('user@example.com', 'SecurePass123!');
+const client = new DominusNodeClient({
+  baseUrl: "https://api.dominusnode.com",
+});
+const result = await client.connectWithCredentials(
+  "user@example.com",
+  "SecurePass123!",
+);
 
 if (result.mfaRequired) {
   // User has 2FA enabled -- need TOTP code
-  await client.completeMfa('123456');
+  await client.completeMfa("123456");
 }
 ```
 
@@ -82,9 +91,9 @@ Use when you already have valid JWT tokens (e.g., stored from a previous session
 
 ```typescript
 const client = new DominusNodeClient({
-  baseUrl: 'https://api.dominusnode.com',
-  accessToken: 'existing_jwt',
-  refreshToken: 'existing_refresh_token',
+  baseUrl: "https://api.dominusnode.com",
+  accessToken: "existing_jwt",
+  refreshToken: "existing_refresh_token",
 });
 ```
 
@@ -93,20 +102,20 @@ const client = new DominusNodeClient({
 Clear all stored tokens locally. Call `client.auth.logout()` first if you also want to revoke refresh tokens server-side.
 
 ```typescript
-await client.auth.logout();  // Revoke server-side refresh tokens
-client.disconnect();          // Clear local token state
+await client.auth.logout(); // Revoke server-side refresh tokens
+client.disconnect(); // Clear local token state
 ```
 
 ## Configuration
 
 ```typescript
 interface DominusNodeConfig {
-  baseUrl?: string;           // Default: 'https://api.dominusnode.com'
-  accessToken?: string;       // Pre-existing access token
-  refreshToken?: string;      // Pre-existing refresh token
-  proxyHost?: string;         // Default: 'proxy.dominusnode.com'
-  httpProxyPort?: number;     // Default: 8080
-  socks5ProxyPort?: number;   // Default: 1080
+  baseUrl?: string; // Default: 'https://api.dominusnode.com'
+  accessToken?: string; // Pre-existing access token
+  refreshToken?: string; // Pre-existing refresh token
+  proxyHost?: string; // Default: 'proxy.dominusnode.com'
+  httpProxyPort?: number; // Default: 8080
+  socks5ProxyPort?: number; // Default: 1080
 }
 ```
 
@@ -122,33 +131,36 @@ Registration, login, MFA management, password changes, and session introspection
 
 ```typescript
 // Register a new account
-const { user } = await client.auth.register('user@example.com', 'SecurePass123!');
+const { user } = await client.auth.register(
+  "user@example.com",
+  "SecurePass123!",
+);
 
 // Login (returns token + user, or mfaRequired flag)
-const result = await client.auth.login('user@example.com', 'SecurePass123!');
+const result = await client.auth.login("user@example.com", "SecurePass123!");
 
 // MFA verify with TOTP code
-await client.auth.verifyMfa('123456');
+await client.auth.verifyMfa("123456");
 
 // MFA verify with backup code
-await client.auth.verifyMfa('12345678', { isBackupCode: true });
+await client.auth.verifyMfa("12345678", { isBackupCode: true });
 
 // MFA setup -- returns secret, otpauthUri, and backup codes
 const setup = await client.auth.mfaSetup();
 // setup.secret, setup.otpauthUri, setup.backupCodes
 
 // MFA enable (confirm with a valid TOTP code)
-await client.auth.mfaEnable('123456');
+await client.auth.mfaEnable("123456");
 
 // MFA disable (requires current password + TOTP code)
-await client.auth.mfaDisable('password', '123456');
+await client.auth.mfaDisable("password", "123456");
 
 // MFA status
 const status = await client.auth.mfaStatus();
 // status.enabled, status.backupCodesRemaining
 
 // Change password
-await client.auth.changePassword('oldpass', 'newpass');
+await client.auth.changePassword("oldpass", "newpass");
 
 // Logout (revokes refresh tokens server-side)
 await client.auth.logout();
@@ -164,7 +176,7 @@ Create, list, and revoke API keys. API keys use the `dn_live_` prefix and are au
 
 ```typescript
 // Create a new API key
-const key = await client.keys.create('my-scraper');
+const key = await client.keys.create("my-scraper");
 // key.key is the full API key (dn_live_xxx) -- shown only once, save it!
 // key.id, key.prefix, key.label, key.created_at
 
@@ -173,7 +185,7 @@ const keys = await client.keys.list();
 // keys.keys[0].id, .prefix, .label, .created_at, .revoked_at
 
 // Revoke an API key by ID
-await client.keys.revoke('key-id');
+await client.keys.revoke("key-id");
 ```
 
 ### Wallet
@@ -202,7 +214,7 @@ const checkout = await client.wallet.topUpStripe(1000); // $10.00
 // checkout.sessionId -- Stripe session ID
 
 // Top up with crypto (amount in cents, currency code)
-const invoice = await client.wallet.topUpCrypto(1000, 'btc');
+const invoice = await client.wallet.topUpCrypto(1000, "btc");
 // invoice.invoiceId   -- NOWPayments invoice ID
 // invoice.invoiceUrl  -- redirect user to pay
 // invoice.payCurrency -- e.g., "btc"
@@ -222,14 +234,21 @@ Query usage records, daily breakdowns, top hosts, and export data as CSV.
 
 ```typescript
 // Usage records with summary (paginated, filterable by date)
-const usage = await client.usage.get({ from: '2024-01-01', to: '2024-01-31', limit: 100 });
+const usage = await client.usage.get({
+  from: "2024-01-01",
+  to: "2024-01-31",
+  limit: 100,
+});
 // usage.summary.totalBytes, .totalCostCents, .requestCount, .totalGB, .totalCostUsd
 // usage.records[0].bytesIn, .bytesOut, .totalBytes, .costCents, .targetHost, .createdAt
 // usage.pagination.limit, .offset, .total
 // usage.period.since, .until
 
 // Daily breakdown (for charts)
-const daily = await client.usage.getDaily({ from: '2024-01-01', to: '2024-01-31' });
+const daily = await client.usage.getDaily({
+  from: "2024-01-01",
+  to: "2024-01-31",
+});
 // daily.days[0].date, .totalBytes, .totalGB, .totalCostCents, .totalCostUsd, .requestCount
 
 // Top target hosts by bandwidth
@@ -237,7 +256,10 @@ const hosts = await client.usage.getTopHosts({ limit: 10 });
 // hosts.hosts[0].targetHost, .totalBytes, .totalGB, .requestCount
 
 // CSV export
-const csv = await client.usage.exportCsv({ from: '2024-01-01', to: '2024-01-31' });
+const csv = await client.usage.exportCsv({
+  from: "2024-01-01",
+  to: "2024-01-31",
+});
 // csv is a raw CSV string
 ```
 
@@ -257,7 +279,7 @@ const plan = await client.plans.getUserPlan();
 // plan.usage.monthlyUsageBytes, .monthlyUsageGB, .limitBytes, .limitGB, .percentUsed
 
 // Change plan
-const result = await client.plans.changePlan('vol100');
+const result = await client.plans.changePlan("vol100");
 // result.message, result.plan
 ```
 
@@ -277,25 +299,25 @@ Build proxy URLs for direct use with HTTP clients, and query proxy health/status
 
 ```typescript
 // Build a basic HTTP proxy URL (no network call -- pure string construction)
-const httpUrl = client.proxy.buildUrl('dn_live_key');
+const httpUrl = client.proxy.buildUrl("dn_live_key");
 // => http://user:dn_live_key@proxy.dominusnode.com:8080
 
 // Build a SOCKS5 proxy URL
-const socksUrl = client.proxy.buildUrl('dn_live_key', { protocol: 'socks5' });
+const socksUrl = client.proxy.buildUrl("dn_live_key", { protocol: "socks5" });
 // => socks5://user:dn_live_key@proxy.dominusnode.com:1080
 
 // Geo-targeted with sticky session
-const geoUrl = client.proxy.buildUrl('dn_live_key', {
-  country: 'US',
-  state: 'california',
-  city: 'losangeles',
-  sessionId: 'sticky123',
+const geoUrl = client.proxy.buildUrl("dn_live_key", {
+  country: "US",
+  state: "california",
+  city: "losangeles",
+  sessionId: "sticky123",
 });
-// => http://user-country_US-state_california-city_losangeles-session_sticky123:dn_live_key@proxy.dominusnode.com:8080
+// => http://user-country-US-state-california-city-losangeles-session-sticky123:dn_live_key@proxy.dominusnode.com:8080
 
 // ASN targeting
-const asnUrl = client.proxy.buildUrl('dn_live_key', { asn: 7922 });
-// => http://user-asn_7922:dn_live_key@proxy.dominusnode.com:8080
+const asnUrl = client.proxy.buildUrl("dn_live_key", { asn: 7922 });
+// => http://user-asn-7922:dn_live_key@proxy.dominusnode.com:8080
 
 // Proxy health (no auth required)
 const health = await client.proxy.getHealth();
@@ -323,24 +345,30 @@ const users = await client.admin.listUsers({ page: 1, limit: 25 });
 // users.pagination.page, .limit, .total, .totalPages
 
 // Get a specific user
-const user = await client.admin.getUser('user-id');
+const user = await client.admin.getUser("user-id");
 // user.user.id, .email, .status, ...
 
 // Suspend a user account
-await client.admin.suspendUser('user-id');
+await client.admin.suspendUser("user-id");
 
 // Reactivate a suspended user
-await client.admin.activateUser('user-id');
+await client.admin.activateUser("user-id");
 
 // Soft-delete a user account
-await client.admin.deleteUser('user-id');
+await client.admin.deleteUser("user-id");
 
 // Revenue statistics (filterable by date range)
-const revenue = await client.admin.getRevenue({ since: '2024-01-01', until: '2024-01-31' });
+const revenue = await client.admin.getRevenue({
+  since: "2024-01-01",
+  until: "2024-01-31",
+});
 // revenue.totalRevenueCents, .totalRevenueUsd, .avgTransactionCents, .transactionCount
 
 // Daily revenue breakdown
-const daily = await client.admin.getDailyRevenue({ since: '2024-01-01', until: '2024-01-31' });
+const daily = await client.admin.getDailyRevenue({
+  since: "2024-01-01",
+  until: "2024-01-31",
+});
 // daily.days[0].date, .revenueCents, .revenueUsd
 
 // System-wide statistics
@@ -360,17 +388,17 @@ import {
   RateLimitError,
   ValidationError,
   NotFoundError,
-} from '@dominusnode/sdk';
+} from "@dominusnode/sdk";
 
 try {
   await client.wallet.getBalance();
 } catch (err) {
   if (err instanceof AuthenticationError) {
     // 401 -- not authenticated or token refresh failed
-    console.error('Not authenticated -- login or provide API key');
+    console.error("Not authenticated -- login or provide API key");
   } else if (err instanceof InsufficientBalanceError) {
     // 402 -- wallet balance too low
-    console.error('Wallet balance too low -- top up first');
+    console.error("Wallet balance too low -- top up first");
   } else if (err instanceof RateLimitError) {
     // 429 -- rate limited (SDK already retried once automatically)
     console.error(`Rate limited -- retry after ${err.retryAfterSeconds}s`);
@@ -388,19 +416,19 @@ try {
 
 All errors include a `statusCode` property (when applicable) and a descriptive `message`.
 
-| Error Class | HTTP Status | Description |
-|---|---|---|
-| `DominusNodeError` | (varies) | Base class for all SDK errors |
-| `AuthenticationError` | 401 | Invalid credentials or expired/revoked tokens |
-| `AuthorizationError` | 403 | Insufficient permissions (e.g., non-admin accessing admin routes) |
-| `InsufficientBalanceError` | 402 | Wallet balance too low for the operation |
-| `RateLimitError` | 429 | Too many requests -- has `retryAfterSeconds` property |
-| `ValidationError` | 400 | Invalid request parameters |
-| `NotFoundError` | 404 | Requested resource does not exist |
-| `ConflictError` | 409 | Resource conflict (e.g., duplicate email registration) |
-| `ServerError` | 500+ | Server-side error |
-| `NetworkError` | -- | Connection failure, DNS resolution error, or timeout |
-| `ProxyError` | -- | Proxy-specific error -- has optional `proxyErrorCode` property |
+| Error Class                | HTTP Status | Description                                                       |
+| -------------------------- | ----------- | ----------------------------------------------------------------- |
+| `DominusNodeError`         | (varies)    | Base class for all SDK errors                                     |
+| `AuthenticationError`      | 401         | Invalid credentials or expired/revoked tokens                     |
+| `AuthorizationError`       | 403         | Insufficient permissions (e.g., non-admin accessing admin routes) |
+| `InsufficientBalanceError` | 402         | Wallet balance too low for the operation                          |
+| `RateLimitError`           | 429         | Too many requests -- has `retryAfterSeconds` property             |
+| `ValidationError`          | 400         | Invalid request parameters                                        |
+| `NotFoundError`            | 404         | Requested resource does not exist                                 |
+| `ConflictError`            | 409         | Resource conflict (e.g., duplicate email registration)            |
+| `ServerError`              | 500+        | Server-side error                                                 |
+| `NetworkError`             | --          | Connection failure, DNS resolution error, or timeout              |
+| `ProxyError`               | --          | Proxy-specific error -- has optional `proxyErrorCode` property    |
 
 ## Using the Proxy URL
 
@@ -409,16 +437,18 @@ The `proxy.buildUrl()` method returns a standard proxy URL string that works wit
 ### With undici (ProxyAgent)
 
 ```typescript
-import { DominusNodeClient } from '@dominusnode/sdk';
-import { ProxyAgent } from 'undici';
+import { DominusNodeClient } from "@dominusnode/sdk";
+import { ProxyAgent } from "undici";
 
-const client = new DominusNodeClient({ baseUrl: 'https://api.dominusnode.com' });
-await client.connectWithKey('dn_live_key');
+const client = new DominusNodeClient({
+  baseUrl: "https://api.dominusnode.com",
+});
+await client.connectWithKey("dn_live_key");
 
-const proxyUrl = client.proxy.buildUrl('dn_live_key', { country: 'US' });
+const proxyUrl = client.proxy.buildUrl("dn_live_key", { country: "US" });
 const agent = new ProxyAgent(proxyUrl);
 
-const response = await fetch('http://httpbin.org/ip', { dispatcher: agent });
+const response = await fetch("http://httpbin.org/ip", { dispatcher: agent });
 const data = await response.json();
 console.log(data.origin); // US IP address
 ```
@@ -433,13 +463,15 @@ curl -x http://user:dn_live_your_key@proxy.dominusnode.com:8080 https://httpbin.
 ### With axios
 
 ```typescript
-import axios from 'axios';
-import { HttpsProxyAgent } from 'https-proxy-agent';
+import axios from "axios";
+import { HttpsProxyAgent } from "https-proxy-agent";
 
-const proxyUrl = client.proxy.buildUrl('dn_live_key', { country: 'DE' });
+const proxyUrl = client.proxy.buildUrl("dn_live_key", { country: "DE" });
 const agent = new HttpsProxyAgent(proxyUrl);
 
-const { data } = await axios.get('https://httpbin.org/ip', { httpsAgent: agent });
+const { data } = await axios.get("https://httpbin.org/ip", {
+  httpsAgent: agent,
+});
 console.log(data.origin); // German IP address
 ```
 
@@ -447,14 +479,14 @@ console.log(data.origin); // German IP address
 
 The proxy URL username field encodes geo-targeting and session parameters using the format `user-param_value-param_value`:
 
-| Option | Type | Description | Example |
-|---|---|---|---|
-| `protocol` | `"http"` or `"socks5"` | Proxy protocol (default: `"http"`) | `{ protocol: 'socks5' }` |
-| `country` | `string` | ISO 3166-1 alpha-2 country code | `{ country: 'US' }` |
-| `state` | `string` | State or region name | `{ state: 'california' }` |
-| `city` | `string` | City name (no spaces) | `{ city: 'losangeles' }` |
-| `asn` | `number` | Autonomous System Number | `{ asn: 7922 }` |
-| `sessionId` | `string` | Sticky session identifier | `{ sessionId: 'abc123' }` |
+| Option      | Type                   | Description                        | Example                   |
+| ----------- | ---------------------- | ---------------------------------- | ------------------------- |
+| `protocol`  | `"http"` or `"socks5"` | Proxy protocol (default: `"http"`) | `{ protocol: 'socks5' }`  |
+| `country`   | `string`               | ISO 3166-1 alpha-2 country code    | `{ country: 'US' }`       |
+| `state`     | `string`               | State or region name               | `{ state: 'california' }` |
+| `city`      | `string`               | City name (no spaces)              | `{ city: 'losangeles' }`  |
+| `asn`       | `number`               | Autonomous System Number           | `{ asn: 7922 }`           |
+| `sessionId` | `string`               | Sticky session identifier          | `{ sessionId: 'abc123' }` |
 
 ## Auto Token Refresh
 
@@ -527,7 +559,7 @@ import type {
   RevenueResponse,
   DailyRevenueEntry,
   DailyRevenueResponse,
-} from '@dominusnode/sdk';
+} from "@dominusnode/sdk";
 ```
 
 ## CommonJS Usage
@@ -535,11 +567,13 @@ import type {
 The SDK ships dual CJS + ESM builds. CommonJS usage works with `require()`:
 
 ```javascript
-const { DominusNodeClient } = require('@dominusnode/sdk');
+const { DominusNodeClient } = require("@dominusnode/sdk");
 
 async function main() {
-  const client = new DominusNodeClient({ baseUrl: 'https://api.dominusnode.com' });
-  await client.connectWithKey('dn_live_your_key');
+  const client = new DominusNodeClient({
+    baseUrl: "https://api.dominusnode.com",
+  });
+  await client.connectWithKey("dn_live_your_key");
 
   const balance = await client.wallet.getBalance();
   console.log(`Balance: $${balance.balanceUsd}`);
@@ -551,20 +585,24 @@ main().catch(console.error);
 ## Complete Example
 
 ```typescript
-import { DominusNodeClient, AuthenticationError, InsufficientBalanceError } from '@dominusnode/sdk';
+import {
+  DominusNodeClient,
+  AuthenticationError,
+  InsufficientBalanceError,
+} from "@dominusnode/sdk";
 
 async function main() {
   // Initialize client
   const client = new DominusNodeClient({
-    baseUrl: 'https://api.dominusnode.com',
-    proxyHost: 'proxy.dominusnode.com',
+    baseUrl: "https://api.dominusnode.com",
+    proxyHost: "proxy.dominusnode.com",
     httpProxyPort: 8080,
     socks5ProxyPort: 1080,
   });
 
   try {
     // Authenticate
-    await client.connectWithKey('dn_live_your_api_key');
+    await client.connectWithKey("dn_live_your_api_key");
 
     // Check who we are
     const { user } = await client.auth.me();
@@ -572,7 +610,9 @@ async function main() {
 
     // Check balance
     const balance = await client.wallet.getBalance();
-    console.log(`Balance: $${balance.balanceUsd} (${balance.balanceCents} cents)`);
+    console.log(
+      `Balance: $${balance.balanceUsd} (${balance.balanceCents} cents)`,
+    );
 
     // If balance is low, create a Stripe checkout
     if (balance.balanceCents < 500) {
@@ -593,26 +633,27 @@ async function main() {
 
     // Get usage stats for this month
     const now = new Date();
-    const firstOfMonth = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-01`;
+    const firstOfMonth = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-01`;
     const usage = await client.usage.get({ from: firstOfMonth });
-    console.log(`This month: ${usage.summary.totalGB.toFixed(2)} GB, $${usage.summary.totalCostUsd}`);
+    console.log(
+      `This month: ${usage.summary.totalGB.toFixed(2)} GB, $${usage.summary.totalCostUsd}`,
+    );
 
     // Build a geo-targeted proxy URL
-    const proxyUrl = client.proxy.buildUrl('dn_live_your_api_key', {
-      country: 'US',
-      state: 'california',
+    const proxyUrl = client.proxy.buildUrl("dn_live_your_api_key", {
+      country: "US",
+      state: "california",
     });
     console.log(`Proxy URL: ${proxyUrl}`);
 
     // Check active sessions
     const sessions = await client.sessions.getActive();
     console.log(`Active sessions: ${sessions.sessions.length}`);
-
   } catch (err) {
     if (err instanceof AuthenticationError) {
-      console.error('Authentication failed:', err.message);
+      console.error("Authentication failed:", err.message);
     } else if (err instanceof InsufficientBalanceError) {
-      console.error('Insufficient balance:', err.message);
+      console.error("Insufficient balance:", err.message);
     } else {
       throw err;
     }
@@ -626,48 +667,48 @@ main();
 
 ## API Reference Summary
 
-| Resource | Method | Description |
-|---|---|---|
-| `auth` | `register(email, password)` | Create a new account |
-| `auth` | `login(email, password)` | Login with credentials |
-| `auth` | `verifyMfa(code, opts?)` | Complete MFA verification |
-| `auth` | `mfaSetup()` | Begin MFA setup (returns secret + backup codes) |
-| `auth` | `mfaEnable(code)` | Confirm and enable MFA |
-| `auth` | `mfaDisable(password, code)` | Disable MFA |
-| `auth` | `mfaStatus()` | Check MFA status |
-| `auth` | `changePassword(current, new)` | Change password |
-| `auth` | `logout()` | Revoke refresh tokens server-side |
-| `auth` | `me()` | Get current user info |
-| `auth` | `verifyKey(apiKey)` | Exchange API key for JWT tokens |
-| `auth` | `refresh(refreshToken)` | Refresh access token (used internally) |
-| `keys` | `create(label?)` | Create a new API key |
-| `keys` | `list()` | List all API keys |
-| `keys` | `revoke(id)` | Revoke an API key |
-| `wallet` | `getBalance()` | Get current balance |
-| `wallet` | `getTransactions(opts?)` | Transaction history (paginated) |
-| `wallet` | `topUpStripe(amountCents)` | Create Stripe checkout session |
-| `wallet` | `topUpCrypto(amountCents, currency)` | Create crypto invoice |
-| `wallet` | `getForecast()` | Spending forecast |
-| `usage` | `get(opts?)` | Usage records with summary |
-| `usage` | `getDaily(opts?)` | Daily usage aggregation |
-| `usage` | `getTopHosts(opts?)` | Top target hosts by bandwidth |
-| `usage` | `exportCsv(opts?)` | Export usage as CSV |
-| `plans` | `list()` | List available plans |
-| `plans` | `getUserPlan()` | Get current user's plan |
-| `plans` | `changePlan(planId)` | Change plan |
-| `sessions` | `getActive()` | Get active proxy sessions |
-| `proxy` | `buildUrl(apiKey, opts?)` | Build proxy URL string (no network call) |
-| `proxy` | `getHealth()` | Proxy health (no auth) |
-| `proxy` | `getStatus()` | Proxy status with provider info |
-| `proxy` | `getConfig()` | Proxy configuration |
-| `admin` | `listUsers(opts?)` | List all users (paginated) |
-| `admin` | `getUser(id)` | Get user details |
-| `admin` | `suspendUser(id)` | Suspend a user |
-| `admin` | `activateUser(id)` | Reactivate a user |
-| `admin` | `deleteUser(id)` | Soft-delete a user |
-| `admin` | `getRevenue(opts?)` | Revenue statistics |
-| `admin` | `getDailyRevenue(opts?)` | Daily revenue breakdown |
-| `admin` | `getStats()` | System-wide statistics |
+| Resource   | Method                               | Description                                     |
+| ---------- | ------------------------------------ | ----------------------------------------------- |
+| `auth`     | `register(email, password)`          | Create a new account                            |
+| `auth`     | `login(email, password)`             | Login with credentials                          |
+| `auth`     | `verifyMfa(code, opts?)`             | Complete MFA verification                       |
+| `auth`     | `mfaSetup()`                         | Begin MFA setup (returns secret + backup codes) |
+| `auth`     | `mfaEnable(code)`                    | Confirm and enable MFA                          |
+| `auth`     | `mfaDisable(password, code)`         | Disable MFA                                     |
+| `auth`     | `mfaStatus()`                        | Check MFA status                                |
+| `auth`     | `changePassword(current, new)`       | Change password                                 |
+| `auth`     | `logout()`                           | Revoke refresh tokens server-side               |
+| `auth`     | `me()`                               | Get current user info                           |
+| `auth`     | `verifyKey(apiKey)`                  | Exchange API key for JWT tokens                 |
+| `auth`     | `refresh(refreshToken)`              | Refresh access token (used internally)          |
+| `keys`     | `create(label?)`                     | Create a new API key                            |
+| `keys`     | `list()`                             | List all API keys                               |
+| `keys`     | `revoke(id)`                         | Revoke an API key                               |
+| `wallet`   | `getBalance()`                       | Get current balance                             |
+| `wallet`   | `getTransactions(opts?)`             | Transaction history (paginated)                 |
+| `wallet`   | `topUpStripe(amountCents)`           | Create Stripe checkout session                  |
+| `wallet`   | `topUpCrypto(amountCents, currency)` | Create crypto invoice                           |
+| `wallet`   | `getForecast()`                      | Spending forecast                               |
+| `usage`    | `get(opts?)`                         | Usage records with summary                      |
+| `usage`    | `getDaily(opts?)`                    | Daily usage aggregation                         |
+| `usage`    | `getTopHosts(opts?)`                 | Top target hosts by bandwidth                   |
+| `usage`    | `exportCsv(opts?)`                   | Export usage as CSV                             |
+| `plans`    | `list()`                             | List available plans                            |
+| `plans`    | `getUserPlan()`                      | Get current user's plan                         |
+| `plans`    | `changePlan(planId)`                 | Change plan                                     |
+| `sessions` | `getActive()`                        | Get active proxy sessions                       |
+| `proxy`    | `buildUrl(apiKey, opts?)`            | Build proxy URL string (no network call)        |
+| `proxy`    | `getHealth()`                        | Proxy health (no auth)                          |
+| `proxy`    | `getStatus()`                        | Proxy status with provider info                 |
+| `proxy`    | `getConfig()`                        | Proxy configuration                             |
+| `admin`    | `listUsers(opts?)`                   | List all users (paginated)                      |
+| `admin`    | `getUser(id)`                        | Get user details                                |
+| `admin`    | `suspendUser(id)`                    | Suspend a user                                  |
+| `admin`    | `activateUser(id)`                   | Reactivate a user                               |
+| `admin`    | `deleteUser(id)`                     | Soft-delete a user                              |
+| `admin`    | `getRevenue(opts?)`                  | Revenue statistics                              |
+| `admin`    | `getDailyRevenue(opts?)`             | Daily revenue breakdown                         |
+| `admin`    | `getStats()`                         | System-wide statistics                          |
 
 ## Requirements
 

package/dist/cjs/auth.d.ts

@@ -3,6 +3,7 @@ import type { User, LoginResult, MfaStatus, MfaSetup } from "./types.js";
 export declare class AuthResource {
     private http;
     constructor(http: HttpClient);
+    private solvePoW;
     register(email: string, password: string): Promise<{
         user: User;
         token?: string;