@dominusnode/sdk 1.0.0

package/dist/cjs/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/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/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/cjs/usage.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageResource = void 0;
+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}` : ""}`);
+    }
+}
+exports.UsageResource = UsageResource;

package/dist/cjs/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/cjs/wallet.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletResource = void 0;
+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");
+    }
+}
+exports.WalletResource = WalletResource;

package/dist/esm/admin.d.ts

@@ -0,0 +1,71 @@
+import type { HttpClient } from "./http.js";
+import type { AdminUser, SystemStats } from "./types.js";
+export interface DateRangeOptions {
+    since?: string;
+    until?: string;
+}
+export interface ListUsersResponse {
+    users: AdminUser[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+export interface GetUserResponse {
+    user: AdminUser;
+}
+export interface RevenueResponse {
+    totalRevenueCents: number;
+    totalRevenueUsd: number;
+    avgTransactionCents: number;
+    avgTransactionUsd: number;
+    transactionCount: number;
+    topupCount: number;
+    period: {
+        since: string;
+        until: string;
+    };
+}
+export interface DailyRevenueEntry {
+    date: string;
+    revenueCents: number;
+    revenueUsd: number;
+}
+export interface DailyRevenueResponse {
+    days: DailyRevenueEntry[];
+    period: {
+        since: string;
+        until: string;
+    };
+}
+export declare class AdminResource {
+    private http;
+    constructor(http: HttpClient);
+    /** List all users (paginated). Requires admin privileges. */
+    listUsers(opts?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ListUsersResponse>;
+    /** Get detailed info for a specific user. Requires admin privileges. */
+    getUser(id: string): Promise<GetUserResponse>;
+    /** Suspend a user account. Requires admin privileges. */
+    suspendUser(id: string): Promise<{
+        message: string;
+    }>;
+    /** Reactivate a suspended user account. Requires admin privileges. */
+    activateUser(id: string): Promise<{
+        message: string;
+    }>;
+    /** Soft-delete a user account. Requires admin privileges. */
+    deleteUser(id: string): Promise<{
+        message: string;
+    }>;
+    /** Get revenue statistics for a date range. Requires admin privileges. */
+    getRevenue(opts?: DateRangeOptions): Promise<RevenueResponse>;
+    /** Get daily revenue breakdown. Requires admin privileges. */
+    getDailyRevenue(opts?: DateRangeOptions): Promise<DailyRevenueResponse>;
+    /** Get system-wide statistics. Requires admin privileges. */
+    getStats(): Promise<SystemStats>;
+}

package/dist/esm/admin.js

@@ -0,0 +1,56 @@
+export class AdminResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all users (paginated). Requires admin privileges. */
+    async listUsers(opts) {
+        const params = new URLSearchParams();
+        if (opts?.page !== undefined)
+            params.set("page", String(opts.page));
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.http.get(`/api/admin/users${qs ? `?${qs}` : ""}`);
+    }
+    /** Get detailed info for a specific user. Requires admin privileges. */
+    async getUser(id) {
+        return this.http.get(`/api/admin/users/${encodeURIComponent(id)}`);
+    }
+    /** Suspend a user account. Requires admin privileges. */
+    async suspendUser(id) {
+        return this.http.put(`/api/admin/users/${encodeURIComponent(id)}/suspend`);
+    }
+    /** Reactivate a suspended user account. Requires admin privileges. */
+    async activateUser(id) {
+        return this.http.put(`/api/admin/users/${encodeURIComponent(id)}/activate`);
+    }
+    /** Soft-delete a user account. Requires admin privileges. */
+    async deleteUser(id) {
+        return this.http.delete(`/api/admin/users/${encodeURIComponent(id)}`);
+    }
+    /** Get revenue statistics for a date range. Requires admin privileges. */
+    async getRevenue(opts) {
+        const params = new URLSearchParams();
+        if (opts?.since)
+            params.set("since", opts.since);
+        if (opts?.until)
+            params.set("until", opts.until);
+        const qs = params.toString();
+        return this.http.get(`/api/admin/revenue${qs ? `?${qs}` : ""}`);
+    }
+    /** Get daily revenue breakdown. Requires admin privileges. */
+    async getDailyRevenue(opts) {
+        const params = new URLSearchParams();
+        if (opts?.since)
+            params.set("since", opts.since);
+        if (opts?.until)
+            params.set("until", opts.until);
+        const qs = params.toString();
+        return this.http.get(`/api/admin/revenue/daily${qs ? `?${qs}` : ""}`);
+    }
+    /** Get system-wide statistics. Requires admin privileges. */
+    async getStats() {
+        return this.http.get("/api/admin/stats");
+    }
+}

package/dist/esm/auth.d.ts

@@ -0,0 +1,47 @@
+import type { HttpClient } from "./http.js";
+import type { User, LoginResult, MfaStatus, MfaSetup } from "./types.js";
+export declare class AuthResource {
+    private http;
+    constructor(http: HttpClient);
+    register(email: string, password: string): Promise<{
+        user: User;
+        token?: string;
+        refreshToken?: string;
+    }>;
+    login(email: string, password: string): Promise<LoginResult & {
+        token?: string;
+        refreshToken?: string;
+    }>;
+    verifyMfa(code: string, opts?: {
+        mfaChallengeToken?: string;
+        isBackupCode?: boolean;
+    }): Promise<{
+        user: User;
+        token: string;
+        refreshToken: string;
+    }>;
+    refresh(refreshToken: string): Promise<{
+        token: string;
+        refreshToken?: string;
+    }>;
+    logout(): Promise<void>;
+    me(): Promise<{
+        user: User;
+    }>;
+    changePassword(currentPassword: string, newPassword: string): Promise<void>;
+    verifyKey(apiKey: string): Promise<{
+        valid: boolean;
+        token: string;
+        refreshToken: string;
+        userId: string;
+        email: string;
+    }>;
+    mfaSetup(): Promise<MfaSetup>;
+    mfaEnable(code: string): Promise<{
+        enabled: boolean;
+    }>;
+    mfaDisable(password: string, code: string): Promise<{
+        enabled: boolean;
+    }>;
+    mfaStatus(): Promise<MfaStatus>;
+}

package/dist/esm/auth.js

@@ -0,0 +1,42 @@
+export class AuthResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async register(email, password) {
+        return this.http.post("/api/auth/register", { email, password }, false);
+    }
+    async login(email, password) {
+        return this.http.post("/api/auth/login", { email, password }, false);
+    }
+    async verifyMfa(code, opts) {
+        return this.http.post("/api/auth/mfa/verify", { code, ...opts }, false);
+    }
+    async refresh(refreshToken) {
+        return this.http.post("/api/auth/refresh", { refreshToken }, false);
+    }
+    async logout() {
+        await this.http.post("/api/auth/logout", {});
+    }
+    async me() {
+        return this.http.get("/api/auth/me");
+    }
+    async changePassword(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);
+    }
+    async mfaSetup() {
+        return this.http.post("/api/auth/mfa/setup", {});
+    }
+    async mfaEnable(code) {
+        return this.http.post("/api/auth/mfa/enable", { code });
+    }
+    async mfaDisable(password, code) {
+        return this.http.post("/api/auth/mfa/disable", { password, code });
+    }
+    async mfaStatus() {
+        return this.http.get("/api/auth/mfa/status");
+    }
+}

package/dist/esm/client.d.ts

@@ -0,0 +1,56 @@
+import { AuthResource } from "./auth.js";
+import { KeysResource } from "./keys.js";
+import { WalletResource } from "./wallet.js";
+import { UsageResource } from "./usage.js";
+import { PlansResource } from "./plans.js";
+import { SessionsResource } from "./sessions.js";
+import { ProxyResource } from "./proxy.js";
+import { AdminResource } from "./admin.js";
+import { SlotsResource } from "./slots.js";
+import { AgenticWalletResource } from "./resources/agent-wallet.js";
+import { TeamsResource } from "./resources/teams.js";
+import { X402Resource } from "./resources/x402.js";
+import { WalletAuthResource } from "./resources/wallet-auth.js";
+import type { DominusNodeConfig, LoginResult } from "./types.js";
+export declare class DominusNodeClient {
+    readonly auth: AuthResource;
+    readonly keys: KeysResource;
+    readonly wallet: WalletResource;
+    readonly usage: UsageResource;
+    readonly plans: PlansResource;
+    readonly sessions: SessionsResource;
+    readonly proxy: ProxyResource;
+    readonly admin: AdminResource;
+    readonly slots: SlotsResource;
+    readonly agenticWallets: AgenticWalletResource;
+    readonly teams: TeamsResource;
+    readonly x402: X402Resource;
+    readonly walletAuth: WalletAuthResource;
+    private tokenManager;
+    private http;
+    private apiKey;
+    constructor(config?: DominusNodeConfig);
+    /**
+     * Authenticate with an API key.
+     * Verifies the key against the server and stores the resulting JWT tokens
+     * for subsequent authenticated requests.
+     */
+    connectWithKey(apiKey: string): Promise<void>;
+    /**
+     * Authenticate with email and password.
+     * If MFA is required, the returned result will have `mfaRequired: true`.
+     * Call `completeMfa()` to finish authentication in that case.
+     */
+    connectWithCredentials(email: string, password: string): Promise<LoginResult>;
+    /**
+     * Complete MFA verification after a login that returned `mfaRequired: true`.
+     */
+    completeMfa(code: string, opts?: {
+        mfaChallengeToken?: string;
+        isBackupCode?: boolean;
+    }): Promise<void>;
+    /**
+     * Disconnect: revoke refresh tokens server-side (best-effort) and clear all stored tokens.
+     */
+    disconnect(): Promise<void>;
+}