@dominusnode/sdk 1.0.0

package/dist/esm/token-manager.js

@@ -0,0 +1,101 @@
+import { TOKEN_REFRESH_BUFFER_MS } from "./constants.js";
+import { AuthenticationError } from "./errors.js";
+export class TokenManager {
+    accessToken = null;
+    refreshTokenValue = null;
+    refreshPromise = null;
+    refreshFn = null;
+    setTokens(access, refresh) {
+        this.accessToken = access;
+        if (refresh)
+            this.refreshTokenValue = refresh;
+    }
+    setRefreshFunction(fn) {
+        this.refreshFn = fn;
+    }
+    getAccessToken() {
+        return this.accessToken;
+    }
+    getRefreshToken() {
+        return this.refreshTokenValue;
+    }
+    isExpired(token) {
+        try {
+            const parts = token.split(".");
+            if (parts.length !== 3)
+                return true;
+            const payload = JSON.parse(Buffer.from(parts[1].replace(/-/g, "+").replace(/_/g, "/"), "base64").toString());
+            return payload.exp * 1000 < Date.now() + TOKEN_REFRESH_BUFFER_MS;
+        }
+        catch {
+            return true;
+        }
+    }
+    async getValidToken() {
+        if (this.accessToken && !this.isExpired(this.accessToken)) {
+            return this.accessToken;
+        }
+        if (!this.refreshTokenValue || !this.refreshFn) {
+            throw new AuthenticationError("No valid token and cannot refresh");
+        }
+        // Singleton refresh
+        if (this.refreshPromise)
+            return this.refreshPromise;
+        this.refreshPromise = (async () => {
+            try {
+                const result = await this.refreshFn(this.refreshTokenValue);
+                this.accessToken = result.accessToken;
+                if (result.refreshToken) {
+                    this.refreshTokenValue = result.refreshToken;
+                }
+                return this.accessToken;
+            }
+            catch (err) {
+                // Clear tokens on refresh failure to prevent rapid-fire retry loops
+                this.accessToken = null;
+                this.refreshTokenValue = null;
+                throw err;
+            }
+            finally {
+                this.refreshPromise = null;
+            }
+        })();
+        return this.refreshPromise;
+    }
+    /**
+     * Force a token refresh regardless of expiry state.
+     * Used after a 401 response to avoid re-using a rejected token.
+     */
+    async forceRefresh() {
+        if (!this.refreshTokenValue || !this.refreshFn) {
+            throw new AuthenticationError("No valid token and cannot refresh");
+        }
+        // Singleton refresh (reuse in-flight refresh if one is already happening)
+        if (this.refreshPromise)
+            return this.refreshPromise;
+        this.refreshPromise = (async () => {
+            try {
+                const result = await this.refreshFn(this.refreshTokenValue);
+                this.accessToken = result.accessToken;
+                if (result.refreshToken) {
+                    this.refreshTokenValue = result.refreshToken;
+                }
+                return this.accessToken;
+            }
+            catch (err) {
+                this.accessToken = null;
+                this.refreshTokenValue = null;
+                throw err;
+            }
+            finally {
+                this.refreshPromise = null;
+            }
+        })();
+        return this.refreshPromise;
+    }
+    clear() {
+        this.accessToken = null;
+        this.refreshTokenValue = null;
+        this.refreshPromise = null;
+    }
+}

package/dist/esm/types.d.ts

@@ -0,0 +1,154 @@
+export interface DominusNodeConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    accessToken?: string;
+    refreshToken?: string;
+    proxyHost?: string;
+    httpProxyPort?: number;
+    socks5ProxyPort?: number;
+}
+export interface User {
+    id: string;
+    email: string;
+    is_admin: boolean;
+    created_at?: string;
+}
+export interface ApiKey {
+    id: string;
+    key_prefix: string;
+    label: string;
+    created_at: string;
+    raw?: string;
+}
+export interface Wallet {
+    balance_cents: number;
+    currency: string;
+}
+export interface WalletTransaction {
+    id: string;
+    type: "topup" | "debit" | "refund";
+    amount_cents: number;
+    description: string;
+    created_at: string;
+}
+export interface UsageRecord {
+    date: string;
+    bytes_in: number;
+    bytes_out: number;
+    total_bytes: number;
+    cost_cents: number;
+    request_count: number;
+}
+export interface TopHost {
+    target_host: string;
+    total_bytes: number;
+    request_count: number;
+}
+export interface Plan {
+    id: string;
+    name: string;
+    price_per_gb_cents: number;
+    monthly_bandwidth_bytes: number;
+    is_default: boolean;
+}
+export interface ActiveSession {
+    id: string;
+    started_at: string;
+    status: string;
+}
+export interface ProxyUrlOptions {
+    protocol?: "http" | "socks5";
+    country?: string;
+    state?: string;
+    city?: string;
+    asn?: number;
+    sessionId?: string;
+}
+export interface ProxyHealth {
+    status: string;
+    providers?: unknown;
+}
+export interface ProxyConfig {
+    httpProxy: {
+        host: string;
+        port: number;
+    };
+    socks5Proxy: {
+        host: string;
+        port: number;
+    };
+    supportedCountries: string[];
+    blockedCountries: string[];
+    geoTargeting?: {
+        stateSupport: boolean;
+        citySupport: boolean;
+        asnSupport: boolean;
+    };
+}
+export interface StripeCheckout {
+    url: string;
+    sessionId: string;
+}
+export interface CryptoInvoice {
+    invoiceId: string;
+    paymentUrl: string;
+    amount: number;
+    currency: string;
+}
+export interface PaypalOrder {
+    orderId: string;
+    approvalUrl: string;
+    amountCents: number;
+}
+export interface AdminUser {
+    id: string;
+    email: string;
+    status: string;
+    is_admin: boolean;
+    created_at: string;
+    balance_cents: number;
+}
+export interface RevenueStats {
+    total_revenue_cents: number;
+    total_topups_cents: number;
+    total_usage_cents: number;
+    user_count: number;
+}
+export interface DailyRevenue {
+    date: string;
+    revenue_cents: number;
+}
+export interface SystemStats {
+    active_sessions: number;
+    total_users: number;
+    total_bandwidth_bytes: number;
+}
+export interface MfaStatus {
+    enabled: boolean;
+    backupCodesRemaining: number;
+}
+export interface MfaSetup {
+    secret: string;
+    otpauthUri: string;
+    backupCodes: string[];
+}
+export interface LoginResult {
+    user?: User;
+    mfaRequired?: boolean;
+}
+export interface TokenPair {
+    accessToken: string;
+    refreshToken: string;
+}
+export interface SlotsInfo {
+    total: number;
+    used: number;
+    remaining: number;
+    unlimited: boolean;
+}
+export interface WaitlistJoinResult {
+    message: string;
+}
+export interface WaitlistCount {
+    pending: number;
+}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/usage.d.ts

@@ -0,0 +1,80 @@
+import type { HttpClient } from "./http.js";
+export interface DateRangeOptions {
+    from?: string;
+    to?: string;
+}
+export interface UsageSummary {
+    totalBytes: number;
+    totalCostCents: number;
+    requestCount: number;
+    totalGB: number;
+    totalCostUsd: number;
+}
+export interface UsageResponse {
+    summary: UsageSummary;
+    records: Array<{
+        id: string;
+        sessionId: string;
+        bytesIn: number;
+        bytesOut: number;
+        totalBytes: number;
+        costCents: number;
+        proxyType: string;
+        targetHost: string;
+        createdAt: string;
+    }>;
+    pagination: {
+        limit: number;
+        offset: number;
+        total: number;
+    };
+    period: {
+        since: string;
+        until: string;
+    };
+}
+export interface DailyUsageDay {
+    date: string;
+    totalBytes: number;
+    totalGB: number;
+    totalCostCents: number;
+    totalCostUsd: number;
+    requestCount: number;
+}
+export interface DailyUsageResponse {
+    days: DailyUsageDay[];
+    period: {
+        since: string;
+        until: string;
+    };
+}
+export interface TopHostEntry {
+    targetHost: string;
+    totalBytes: number;
+    totalGB: number;
+    requestCount: number;
+}
+export interface TopHostsResponse {
+    hosts: TopHostEntry[];
+    period: {
+        since: string;
+        until: string;
+    };
+}
+export declare class UsageResource {
+    private http;
+    constructor(http: HttpClient);
+    /** Get detailed usage records with summary. */
+    get(opts?: DateRangeOptions & {
+        limit?: number;
+        offset?: number;
+    }): Promise<UsageResponse>;
+    /** Get daily usage aggregation for charts. */
+    getDaily(opts?: DateRangeOptions): Promise<DailyUsageResponse>;
+    /** Get top target hosts by bandwidth. */
+    getTopHosts(opts?: DateRangeOptions & {
+        limit?: number;
+    }): Promise<TopHostsResponse>;
+    /** Export usage records as CSV string. */
+    exportCsv(opts?: DateRangeOptions): Promise<string>;
+}

package/dist/esm/usage.js

@@ -0,0 +1,52 @@
+export class UsageResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get detailed usage records with summary. */
+    async get(opts) {
+        const params = new URLSearchParams();
+        if (opts?.from)
+            params.set("since", opts.from);
+        if (opts?.to)
+            params.set("until", opts.to);
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.http.get(`/api/usage${qs ? `?${qs}` : ""}`);
+    }
+    /** Get daily usage aggregation for charts. */
+    async getDaily(opts) {
+        const params = new URLSearchParams();
+        if (opts?.from)
+            params.set("since", opts.from);
+        if (opts?.to)
+            params.set("until", opts.to);
+        const qs = params.toString();
+        return this.http.get(`/api/usage/daily${qs ? `?${qs}` : ""}`);
+    }
+    /** Get top target hosts by bandwidth. */
+    async getTopHosts(opts) {
+        const params = new URLSearchParams();
+        if (opts?.from)
+            params.set("since", opts.from);
+        if (opts?.to)
+            params.set("until", opts.to);
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.http.get(`/api/usage/top-hosts${qs ? `?${qs}` : ""}`);
+    }
+    /** Export usage records as CSV string. */
+    async exportCsv(opts) {
+        const params = new URLSearchParams();
+        if (opts?.from)
+            params.set("since", opts.from);
+        if (opts?.to)
+            params.set("until", opts.to);
+        const qs = params.toString();
+        return this.http.get(`/api/usage/export${qs ? `?${qs}` : ""}`);
+    }
+}

package/dist/esm/wallet.d.ts

@@ -0,0 +1,59 @@
+import type { HttpClient } from "./http.js";
+import type { WalletTransaction } from "./types.js";
+export interface WalletBalanceResponse {
+    balanceCents: number;
+    balanceUsd: number;
+    currency: string;
+    lastToppedUp: string | null;
+}
+export interface TransactionsResponse {
+    transactions: Array<{
+        id: string;
+        type: WalletTransaction["type"];
+        amountCents: number;
+        amountUsd: number;
+        description: string;
+        paymentProvider: string | null;
+        createdAt: string;
+    }>;
+}
+export interface StripeCheckoutResponse {
+    sessionId: string;
+    url: string;
+}
+export interface CryptoInvoiceResponse {
+    invoiceId: string;
+    invoiceUrl: string;
+    payCurrency: string;
+    priceAmount: number;
+}
+export interface PaypalOrderResponse {
+    orderId: string;
+    approvalUrl: string;
+    amountCents: number;
+}
+export interface ForecastResponse {
+    dailyAvgCents: number;
+    daysRemaining: number | null;
+    trend: "up" | "down" | "stable";
+    trendPct: number;
+}
+export declare class WalletResource {
+    private http;
+    constructor(http: HttpClient);
+    /** Get current wallet balance. */
+    getBalance(): Promise<WalletBalanceResponse>;
+    /** Get wallet transaction history. */
+    getTransactions(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TransactionsResponse>;
+    /** Create a Stripe checkout session for wallet top-up. */
+    topUpStripe(amountCents: number): Promise<StripeCheckoutResponse>;
+    /** Create a crypto invoice for wallet top-up. Minimum $10 (1000 cents). */
+    topUpCrypto(amountCents: number, currency: string): Promise<CryptoInvoiceResponse>;
+    /** Create a PayPal order for wallet top-up. Minimum $5 (500 cents). */
+    topUpPaypal(amountCents: number): Promise<PaypalOrderResponse>;
+    /** Get spending forecast based on recent usage. */
+    getForecast(): Promise<ForecastResponse>;
+}

package/dist/esm/wallet.js

@@ -0,0 +1,52 @@
+export class WalletResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get current wallet balance. */
+    async getBalance() {
+        return this.http.get("/api/wallet");
+    }
+    /** Get wallet transaction history. */
+    async getTransactions(opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.http.get(`/api/wallet/transactions${qs ? `?${qs}` : ""}`);
+    }
+    /** Create a Stripe checkout session for wallet top-up. */
+    async topUpStripe(amountCents) {
+        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) {
+            throw new Error("amountCents must be a positive integer <= 2,147,483,647");
+        }
+        if (amountCents < 1000) {
+            throw new Error("Minimum crypto top-up is $10.00 (1000 cents)");
+        }
+        const amountUsd = amountCents / 100;
+        return this.http.post("/api/wallet/topup/crypto", { amountUsd, currency });
+    }
+    /** 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) {
+            throw new Error("amountCents must be a positive integer <= 2,147,483,647");
+        }
+        if (amountCents < 500) {
+            throw new Error("Minimum PayPal top-up is $5.00 (500 cents)");
+        }
+        return this.http.post("/api/wallet/topup/paypal", { amountCents });
+    }
+    /** Get spending forecast based on recent usage. */
+    async getForecast() {
+        return this.http.get("/api/wallet/forecast");
+    }
+}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/admin.ts","../src/auth.ts","../src/client.ts","../src/constants.ts","../src/errors.ts","../src/http.ts","../src/index.ts","../src/keys.ts","../src/plans.ts","../src/proxy.ts","../src/sessions.ts","../src/slots.ts","../src/token-manager.ts","../src/types.ts","../src/usage.ts","../src/wallet.ts","../src/resources/agent-wallet.ts","../src/resources/teams.ts"],"version":"5.9.3"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@dominusnode/sdk",
+  "version": "1.0.0",
+  "description": "Official Dominus Node SDK for Node.js/TypeScript",
+  "author": "Dominus Node",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.0"
+  }
+}