@dominusnode/sdk 1.2.0 → 1.5.2

package/README.md

@@ -28,22 +28,24 @@ 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
@@ -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,24 +299,24 @@ 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
 
 // ASN targeting
-const asnUrl = client.proxy.buildUrl('dn_live_key', { asn: 7922 });
+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)
@@ -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.js

@@ -64,7 +64,10 @@ class AuthResource {
             const { challengeId, prefix } = challenge;
             const difficulty = Math.min(challenge.difficulty, 32);
             for (let nonce = 0; nonce < POW_MAX_NONCE; nonce++) {
-                const hash = crypto.createHash("sha256").update(prefix + nonce).digest();
+                const hash = crypto
+                    .createHash("sha256")
+                    .update(prefix + nonce)
+                    .digest();
                 if (countLeadingZeroBits(hash) >= difficulty) {
                     return { challengeId, nonce };
                 }
@@ -99,7 +102,10 @@ class AuthResource {
         return this.http.get("/api/auth/me");
     }
     async changePassword(currentPassword, newPassword) {
-        await this.http.post("/api/auth/change-password", { currentPassword, newPassword });
+        await this.http.post("/api/auth/change-password", {
+            currentPassword,
+            newPassword,
+        });
     }
     async verifyKey(apiKey) {
         return this.http.post("/api/auth/verify-key", { apiKey }, false);

package/dist/cjs/constants.d.ts

@@ -1,5 +1,5 @@
-export declare const SDK_VERSION = "1.0.0";
-export declare const USER_AGENT = "dominusnode-sdk-node/1.0.0";
+export declare const SDK_VERSION = "1.5.2";
+export declare const USER_AGENT = "dominusnode-sdk-node/1.5.2";
 export declare const DEFAULT_BASE_URL = "https://api.dominusnode.com";
 export declare const DEFAULT_PROXY_HOST = "proxy.dominusnode.com";
 export declare const DEFAULT_HTTP_PROXY_PORT = 8080;

package/dist/cjs/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_RATE_LIMIT_RETRIES = exports.TOKEN_REFRESH_BUFFER_MS = exports.DEFAULT_SOCKS5_PROXY_PORT = exports.DEFAULT_HTTP_PROXY_PORT = exports.DEFAULT_PROXY_HOST = exports.DEFAULT_BASE_URL = exports.USER_AGENT = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.0.0";
+exports.SDK_VERSION = "1.5.2";
 exports.USER_AGENT = `dominusnode-sdk-node/${exports.SDK_VERSION}`;
 exports.DEFAULT_BASE_URL = "https://api.dominusnode.com";
 exports.DEFAULT_PROXY_HOST = "proxy.dominusnode.com";

package/dist/cjs/http.js

@@ -48,12 +48,18 @@ function throwForStatus(status, body, headers) {
     if (message.length > 500)
         message = message.slice(0, 500) + "... [truncated]";
     switch (status) {
-        case 400: throw new errors_js_1.ValidationError(message);
-        case 401: throw new errors_js_1.AuthenticationError(message);
-        case 402: throw new errors_js_1.InsufficientBalanceError(message);
-        case 403: throw new errors_js_1.AuthorizationError(message);
-        case 404: throw new errors_js_1.NotFoundError(message);
-        case 409: throw new errors_js_1.ConflictError(message);
+        case 400:
+            throw new errors_js_1.ValidationError(message);
+        case 401:
+            throw new errors_js_1.AuthenticationError(message);
+        case 402:
+            throw new errors_js_1.InsufficientBalanceError(message);
+        case 403:
+            throw new errors_js_1.AuthorizationError(message);
+        case 404:
+            throw new errors_js_1.NotFoundError(message);
+        case 409:
+            throw new errors_js_1.ConflictError(message);
         case 429: {
             const parsed = parseInt(headers.get("retry-after") ?? "60", 10);
             const retryAfter = Number.isFinite(parsed) ? parsed : 60; // NaN guard

package/dist/cjs/index.d.ts

@@ -18,7 +18,7 @@ export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export type { AgenticWallet, AgenticWalletTransaction, AgenticWalletListResponse, AgenticWalletFundResponse, AgenticWalletTransactionsResponse, AgenticWalletDeleteResponse, } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
 export type { Team, TeamMember, TeamInvite, TeamListResponse, TeamMembersResponse, TeamInvitesResponse, TeamKeysResponse, TeamKeyCreateResponse, TeamDeleteResponse, TeamFundResponse, TeamTransactionsResponse, } from "./resources/teams.js";
-export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS, } from "./resources/x402.js";
 export type { X402Info, X402Facilitator, X402PaymentHeaders, X402Pricing, X402Scheme, X402Token, } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
 export type { WalletChallenge, WalletVerifyResult, WalletLinkResult, } from "./resources/wallet-auth.js";

package/dist/cjs/resources/agent-wallet.js

@@ -7,11 +7,16 @@ class AgenticWalletResource {
         this.http = http;
     }
     async create(label, spendingLimitCents = 10000, options) {
-        if (!Number.isInteger(spendingLimitCents) || spendingLimitCents < 0 || spendingLimitCents > 2_147_483_647) {
+        if (!Number.isInteger(spendingLimitCents) ||
+            spendingLimitCents < 0 ||
+            spendingLimitCents > 2_147_483_647) {
             throw new Error("spendingLimitCents must be a non-negative integer <= 2,147,483,647");
         }
-        if (options?.dailyLimitCents !== undefined && options.dailyLimitCents !== null) {
-            if (!Number.isInteger(options.dailyLimitCents) || options.dailyLimitCents < 0 || options.dailyLimitCents > 2_147_483_647) {
+        if (options?.dailyLimitCents !== undefined &&
+            options.dailyLimitCents !== null) {
+            if (!Number.isInteger(options.dailyLimitCents) ||
+                options.dailyLimitCents < 0 ||
+                options.dailyLimitCents > 2_147_483_647) {
                 throw new Error("dailyLimitCents must be a non-negative integer <= 2,147,483,647");
             }
         }
@@ -29,14 +34,19 @@ class AgenticWalletResource {
         return this.http.get(`/api/agent-wallet/${encodeURIComponent(walletId)}`);
     }
     async fund(walletId, amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post(`/api/agent-wallet/${encodeURIComponent(walletId)}/fund`, { amountCents });
     }
     async updateWalletPolicy(walletId, policy) {
-        if (policy.dailyLimitCents !== undefined && policy.dailyLimitCents !== null) {
-            if (!Number.isInteger(policy.dailyLimitCents) || policy.dailyLimitCents < 0 || policy.dailyLimitCents > 2_147_483_647) {
+        if (policy.dailyLimitCents !== undefined &&
+            policy.dailyLimitCents !== null) {
+            if (!Number.isInteger(policy.dailyLimitCents) ||
+                policy.dailyLimitCents < 0 ||
+                policy.dailyLimitCents > 2_147_483_647) {
                 throw new Error("dailyLimitCents must be a non-negative integer <= 2,147,483,647");
             }
         }

package/dist/cjs/resources/mpp.d.ts

@@ -1,4 +1,8 @@
 import type { HttpClient } from "../http.js";
+/** IETF MPP auth scheme name (official spec) */
+export declare const MPP_AUTH_SCHEME = "Payment";
+/** Legacy auth scheme name (backward compat) */
+export declare const MPP_AUTH_SCHEME_LEGACY = "MPP";
 export interface MppInfo {
     supported: boolean;
     enabled: boolean;

package/dist/cjs/resources/mpp.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MppResource = void 0;
+exports.MppResource = exports.MPP_AUTH_SCHEME_LEGACY = exports.MPP_AUTH_SCHEME = void 0;
+/** IETF MPP auth scheme name (official spec) */
+exports.MPP_AUTH_SCHEME = "Payment";
+/** Legacy auth scheme name (backward compat) */
+exports.MPP_AUTH_SCHEME_LEGACY = "MPP";
 /**
  * Micropayment Payment Protocol (MPP) resource.
  *
@@ -49,7 +53,7 @@ class MppResource {
      */
     buildProxyHeaders(credential) {
         return {
-            Authorization: "MPP " + JSON.stringify(credential),
+            Authorization: exports.MPP_AUTH_SCHEME + " " + JSON.stringify(credential),
         };
     }
     /**
@@ -78,7 +82,9 @@ class MppResource {
      * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
      */
     async topUp(amountCents, method) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/mpp/topup", { amountCents, method });
@@ -94,7 +100,9 @@ class MppResource {
      * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
      */
     async openSession(opts) {
-        if (!Number.isInteger(opts.maxDepositCents) || opts.maxDepositCents <= 0 || opts.maxDepositCents > 2_147_483_647) {
+        if (!Number.isInteger(opts.maxDepositCents) ||
+            opts.maxDepositCents <= 0 ||
+            opts.maxDepositCents > 2_147_483_647) {
             throw new Error("maxDepositCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/mpp/session/open", {

package/dist/cjs/resources/teams.js

@@ -25,7 +25,9 @@ class TeamsResource {
         return this.http.delete(`/api/teams/${encodeURIComponent(teamId)}`);
     }
     async fundWallet(teamId, amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/wallet/fund`, { amountCents });
@@ -70,7 +72,9 @@ class TeamsResource {
         return this.http.post(`/api/teams/invites/${encodeURIComponent(token)}/accept`, {});
     }
     async createKey(teamId, label) {
-        return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/keys`, { label });
+        return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/keys`, {
+            label,
+        });
     }
     async listKeys(teamId) {
         return this.http.get(`/api/teams/${encodeURIComponent(teamId)}/keys`);

package/dist/cjs/wallet.js

@@ -22,14 +22,18 @@ class WalletResource {
     }
     /** Create a Stripe checkout session for wallet top-up. */
     async topUpStripe(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/wallet/topup/stripe", { amountCents });
     }
     /** Create a crypto invoice for wallet top-up. Minimum $10 (1000 cents). */
     async topUpCrypto(amountCents, currency) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 1000) {
@@ -40,7 +44,9 @@ class WalletResource {
     }
     /** Create a PayPal order for wallet top-up. Minimum $5 (500 cents). */
     async topUpPaypal(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 500) {

package/dist/esm/auth.js

@@ -28,7 +28,10 @@ export class AuthResource {
             const { challengeId, prefix } = challenge;
             const difficulty = Math.min(challenge.difficulty, 32);
             for (let nonce = 0; nonce < POW_MAX_NONCE; nonce++) {
-                const hash = crypto.createHash("sha256").update(prefix + nonce).digest();
+                const hash = crypto
+                    .createHash("sha256")
+                    .update(prefix + nonce)
+                    .digest();
                 if (countLeadingZeroBits(hash) >= difficulty) {
                     return { challengeId, nonce };
                 }
@@ -63,7 +66,10 @@ export class AuthResource {
         return this.http.get("/api/auth/me");
     }
     async changePassword(currentPassword, newPassword) {
-        await this.http.post("/api/auth/change-password", { currentPassword, newPassword });
+        await this.http.post("/api/auth/change-password", {
+            currentPassword,
+            newPassword,
+        });
     }
     async verifyKey(apiKey) {
         return this.http.post("/api/auth/verify-key", { apiKey }, false);

package/dist/esm/constants.d.ts

@@ -1,5 +1,5 @@
-export declare const SDK_VERSION = "1.0.0";
-export declare const USER_AGENT = "dominusnode-sdk-node/1.0.0";
+export declare const SDK_VERSION = "1.5.2";
+export declare const USER_AGENT = "dominusnode-sdk-node/1.5.2";
 export declare const DEFAULT_BASE_URL = "https://api.dominusnode.com";
 export declare const DEFAULT_PROXY_HOST = "proxy.dominusnode.com";
 export declare const DEFAULT_HTTP_PROXY_PORT = 8080;

package/dist/esm/constants.js

@@ -1,4 +1,4 @@
-export const SDK_VERSION = "1.0.0";
+export const SDK_VERSION = "1.5.2";
 export const USER_AGENT = `dominusnode-sdk-node/${SDK_VERSION}`;
 export const DEFAULT_BASE_URL = "https://api.dominusnode.com";
 export const DEFAULT_PROXY_HOST = "proxy.dominusnode.com";

package/dist/esm/http.js

@@ -45,12 +45,18 @@ function throwForStatus(status, body, headers) {
     if (message.length > 500)
         message = message.slice(0, 500) + "... [truncated]";
     switch (status) {
-        case 400: throw new ValidationError(message);
-        case 401: throw new AuthenticationError(message);
-        case 402: throw new InsufficientBalanceError(message);
-        case 403: throw new AuthorizationError(message);
-        case 404: throw new NotFoundError(message);
-        case 409: throw new ConflictError(message);
+        case 400:
+            throw new ValidationError(message);
+        case 401:
+            throw new AuthenticationError(message);
+        case 402:
+            throw new InsufficientBalanceError(message);
+        case 403:
+            throw new AuthorizationError(message);
+        case 404:
+            throw new NotFoundError(message);
+        case 409:
+            throw new ConflictError(message);
         case 429: {
             const parsed = parseInt(headers.get("retry-after") ?? "60", 10);
             const retryAfter = Number.isFinite(parsed) ? parsed : 60; // NaN guard

package/dist/esm/index.d.ts

@@ -18,7 +18,7 @@ export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export type { AgenticWallet, AgenticWalletTransaction, AgenticWalletListResponse, AgenticWalletFundResponse, AgenticWalletTransactionsResponse, AgenticWalletDeleteResponse, } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
 export type { Team, TeamMember, TeamInvite, TeamListResponse, TeamMembersResponse, TeamInvitesResponse, TeamKeysResponse, TeamKeyCreateResponse, TeamDeleteResponse, TeamFundResponse, TeamTransactionsResponse, } from "./resources/teams.js";
-export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS, } from "./resources/x402.js";
 export type { X402Info, X402Facilitator, X402PaymentHeaders, X402Pricing, X402Scheme, X402Token, } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
 export type { WalletChallenge, WalletVerifyResult, WalletLinkResult, } from "./resources/wallet-auth.js";

package/dist/esm/index.js

@@ -12,7 +12,7 @@ export { AdminResource } from "./admin.js";
 export { SlotsResource } from "./slots.js";
 export { AgenticWalletResource } from "./resources/agent-wallet.js";
 export { TeamsResource } from "./resources/teams.js";
-export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS } from "./resources/x402.js";
+export { X402Resource, X402_PROTOCOL_VERSION, X402_HEADERS, } from "./resources/x402.js";
 export { WalletAuthResource } from "./resources/wallet-auth.js";
 export { MppResource } from "./resources/mpp.js";
 // Infrastructure (HttpClient for advanced custom integrations)

package/dist/esm/resources/agent-wallet.js

@@ -4,11 +4,16 @@ export class AgenticWalletResource {
         this.http = http;
     }
     async create(label, spendingLimitCents = 10000, options) {
-        if (!Number.isInteger(spendingLimitCents) || spendingLimitCents < 0 || spendingLimitCents > 2_147_483_647) {
+        if (!Number.isInteger(spendingLimitCents) ||
+            spendingLimitCents < 0 ||
+            spendingLimitCents > 2_147_483_647) {
             throw new Error("spendingLimitCents must be a non-negative integer <= 2,147,483,647");
         }
-        if (options?.dailyLimitCents !== undefined && options.dailyLimitCents !== null) {
-            if (!Number.isInteger(options.dailyLimitCents) || options.dailyLimitCents < 0 || options.dailyLimitCents > 2_147_483_647) {
+        if (options?.dailyLimitCents !== undefined &&
+            options.dailyLimitCents !== null) {
+            if (!Number.isInteger(options.dailyLimitCents) ||
+                options.dailyLimitCents < 0 ||
+                options.dailyLimitCents > 2_147_483_647) {
                 throw new Error("dailyLimitCents must be a non-negative integer <= 2,147,483,647");
             }
         }
@@ -26,14 +31,19 @@ export class AgenticWalletResource {
         return this.http.get(`/api/agent-wallet/${encodeURIComponent(walletId)}`);
     }
     async fund(walletId, amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post(`/api/agent-wallet/${encodeURIComponent(walletId)}/fund`, { amountCents });
     }
     async updateWalletPolicy(walletId, policy) {
-        if (policy.dailyLimitCents !== undefined && policy.dailyLimitCents !== null) {
-            if (!Number.isInteger(policy.dailyLimitCents) || policy.dailyLimitCents < 0 || policy.dailyLimitCents > 2_147_483_647) {
+        if (policy.dailyLimitCents !== undefined &&
+            policy.dailyLimitCents !== null) {
+            if (!Number.isInteger(policy.dailyLimitCents) ||
+                policy.dailyLimitCents < 0 ||
+                policy.dailyLimitCents > 2_147_483_647) {
                 throw new Error("dailyLimitCents must be a non-negative integer <= 2,147,483,647");
             }
         }

package/dist/esm/resources/mpp.d.ts

@@ -1,4 +1,8 @@
 import type { HttpClient } from "../http.js";
+/** IETF MPP auth scheme name (official spec) */
+export declare const MPP_AUTH_SCHEME = "Payment";
+/** Legacy auth scheme name (backward compat) */
+export declare const MPP_AUTH_SCHEME_LEGACY = "MPP";
 export interface MppInfo {
     supported: boolean;
     enabled: boolean;

package/dist/esm/resources/mpp.js

@@ -1,3 +1,7 @@
+/** IETF MPP auth scheme name (official spec) */
+export const MPP_AUTH_SCHEME = "Payment";
+/** Legacy auth scheme name (backward compat) */
+export const MPP_AUTH_SCHEME_LEGACY = "MPP";
 /**
  * Micropayment Payment Protocol (MPP) resource.
  *
@@ -46,7 +50,7 @@ export class MppResource {
      */
     buildProxyHeaders(credential) {
         return {
-            Authorization: "MPP " + JSON.stringify(credential),
+            Authorization: MPP_AUTH_SCHEME + " " + JSON.stringify(credential),
         };
     }
     /**
@@ -75,7 +79,9 @@ export class MppResource {
      * @param method - Payment method: "tempo", "stripe_spt", or "lightning"
      */
     async topUp(amountCents, method) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/mpp/topup", { amountCents, method });
@@ -91,7 +97,9 @@ export class MppResource {
      * @param opts.poolType - Proxy pool type (e.g. "dc", "residential")
      */
     async openSession(opts) {
-        if (!Number.isInteger(opts.maxDepositCents) || opts.maxDepositCents <= 0 || opts.maxDepositCents > 2_147_483_647) {
+        if (!Number.isInteger(opts.maxDepositCents) ||
+            opts.maxDepositCents <= 0 ||
+            opts.maxDepositCents > 2_147_483_647) {
             throw new Error("maxDepositCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/mpp/session/open", {

package/dist/esm/resources/teams.js

@@ -22,7 +22,9 @@ export class TeamsResource {
         return this.http.delete(`/api/teams/${encodeURIComponent(teamId)}`);
     }
     async fundWallet(teamId, amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/wallet/fund`, { amountCents });
@@ -67,7 +69,9 @@ export class TeamsResource {
         return this.http.post(`/api/teams/invites/${encodeURIComponent(token)}/accept`, {});
     }
     async createKey(teamId, label) {
-        return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/keys`, { label });
+        return this.http.post(`/api/teams/${encodeURIComponent(teamId)}/keys`, {
+            label,
+        });
     }
     async listKeys(teamId) {
         return this.http.get(`/api/teams/${encodeURIComponent(teamId)}/keys`);

package/dist/esm/wallet.js

@@ -19,14 +19,18 @@ export class WalletResource {
     }
     /** Create a Stripe checkout session for wallet top-up. */
     async topUpStripe(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         return this.http.post("/api/wallet/topup/stripe", { amountCents });
     }
     /** Create a crypto invoice for wallet top-up. Minimum $10 (1000 cents). */
     async topUpCrypto(amountCents, currency) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 1000) {
@@ -37,7 +41,9 @@ export class WalletResource {
     }
     /** Create a PayPal order for wallet top-up. Minimum $5 (500 cents). */
     async topUpPaypal(amountCents) {
-        if (!Number.isInteger(amountCents) || amountCents <= 0 || amountCents > 2_147_483_647) {
+        if (!Number.isInteger(amountCents) ||
+            amountCents <= 0 ||
+            amountCents > 2_147_483_647) {
             throw new Error("amountCents must be a positive integer <= 2,147,483,647");
         }
         if (amountCents < 500) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dominusnode/sdk",
-  "version": "1.2.0",
+  "version": "1.5.2",
   "description": "Official Dominus Node SDK for Node.js/TypeScript",
   "author": "Dominus Node",
   "license": "MIT",