@aluvia/sdk 1.4.1 → 2.0.1

package/dist/esm/index.js

@@ -1,9 +1,11 @@
 // Aluvia Client Node
 // Main entry point
 // Public class
-export { AluviaClient } from "./client/AluviaClient.js";
-export { AluviaApi } from "./api/AluviaApi.js";
+export { AluviaClient } from './client/AluviaClient.js';
+export { AluviaApi } from './api/AluviaApi.js';
 // Connect helper
-export { connect } from "./connect.js";
+export { connect } from './connect.js';
 // Public error classes
-export { MissingApiKeyError, InvalidApiKeyError, ApiError, ProxyStartError, ConnectError, } from "./errors.js";
+export { MissingApiKeyError, InvalidApiKeyError, ApiError, ProxyStartError, ConnectError } from './errors.js';
+// Session lock utilities (used by CLI)
+export { writeLock, readLock, removeLock, isProcessAlive, getLogFilePath, validateSessionName, generateSessionName, listSessions, toLockData, } from './session/lock.js';

package/dist/esm/session/lock.js

@@ -3,12 +3,48 @@ import * as path from 'node:path';
 import * as os from 'node:os';
 const LOCK_DIR = path.join(os.tmpdir(), 'aluvia-sdk');
 const ADJECTIVES = [
-    'swift', 'bold', 'calm', 'keen', 'warm', 'bright', 'silent', 'rapid', 'steady', 'clever',
-    'vivid', 'agile', 'noble', 'lucid', 'crisp', 'gentle', 'fierce', 'nimble', 'sturdy', 'witty',
+    'swift',
+    'bold',
+    'calm',
+    'keen',
+    'warm',
+    'bright',
+    'silent',
+    'rapid',
+    'steady',
+    'clever',
+    'vivid',
+    'agile',
+    'noble',
+    'lucid',
+    'crisp',
+    'gentle',
+    'fierce',
+    'nimble',
+    'sturdy',
+    'witty',
 ];
 const NOUNS = [
-    'falcon', 'tiger', 'river', 'maple', 'coral', 'cedar', 'orbit', 'prism', 'flint', 'spark',
-    'ridge', 'ember', 'crane', 'grove', 'stone', 'brook', 'drift', 'crest', 'sage', 'lynx',
+    'falcon',
+    'tiger',
+    'river',
+    'maple',
+    'coral',
+    'cedar',
+    'orbit',
+    'prism',
+    'flint',
+    'spark',
+    'ridge',
+    'ember',
+    'crane',
+    'grove',
+    'stone',
+    'brook',
+    'drift',
+    'crest',
+    'sage',
+    'lynx',
 ];
 function lockFileName(sessionName) {
     return `cli-${sessionName ?? 'default'}.lock`;

package/dist/types/client/AluviaClient.d.ts

@@ -1,5 +1,5 @@
-import type { AluviaClientConnection, AluviaClientOptions } from "./types.js";
-import { AluviaApi } from "../api/AluviaApi.js";
+import type { AluviaClientConnection, AluviaClientOptions } from './types.js';
+import { AluviaApi } from '../api/AluviaApi.js';
 /**
  * AluviaClient is the main entry point for the Aluvia Client.
  *

package/dist/types/client/BlockDetection.d.ts

@@ -1,8 +1,8 @@
-import type { Logger } from "./logger.js";
+import type { Logger } from './logger.js';
 /**
  * Detection block status based on scoring
  */
-export type DetectionBlockStatus = "blocked" | "suspected" | "clear";
+export type DetectionBlockStatus = 'blocked' | 'suspected' | 'clear';
 /**
  * A single detection signal with weight
  */
@@ -10,7 +10,7 @@ export type DetectionSignal = {
     name: string;
     weight: number;
     details: string;
-    source: "fast" | "full";
+    source: 'fast' | 'full';
 };
 /**
  * A single hop in a redirect chain
@@ -28,7 +28,7 @@ export type BlockDetectionResult = {
     blockStatus: DetectionBlockStatus;
     score: number;
     signals: DetectionSignal[];
-    pass: "fast" | "full";
+    pass: 'fast' | 'full';
     persistentBlock: boolean;
     redirectChain: RedirectHop[];
 };

package/dist/types/client/types.d.ts

@@ -1,12 +1,12 @@
-import type { BlockDetectionConfig } from "./BlockDetection.js";
+import type { BlockDetectionConfig } from './BlockDetection.js';
 /**
  * Protocol used to connect to the Aluvia gateway.
  */
-export type GatewayProtocol = "http" | "https";
+export type GatewayProtocol = 'http' | 'https';
 /**
  * Log level for the client.
  */
-export type LogLevel = "silent" | "info" | "debug";
+export type LogLevel = 'silent' | 'info' | 'debug';
 export type PlaywrightProxySettings = {
     server: string;
     username?: string;
@@ -148,8 +148,8 @@ export type AluviaClientConnection = {
      * Useful for: Axios, got, node-fetch (legacy).
      */
     asNodeAgents(): {
-        http: import("node:http").Agent;
-        https: import("node:http").Agent;
+        http: import('node:http').Agent;
+        https: import('node:http').Agent;
     };
     /**
      * Axios adapter config.
@@ -159,8 +159,8 @@ export type AluviaClientConnection = {
      */
     asAxiosConfig(): {
         proxy: false;
-        httpAgent: import("node:http").Agent;
-        httpsAgent: import("node:http").Agent;
+        httpAgent: import('node:http').Agent;
+        httpsAgent: import('node:http').Agent;
     };
     /**
      * got adapter options.
@@ -169,14 +169,14 @@ export type AluviaClientConnection = {
      */
     asGotOptions(): {
         agent: {
-            http: import("node:http").Agent;
-            https: import("node:http").Agent;
+            http: import('node:http').Agent;
+            https: import('node:http').Agent;
         };
     };
     /**
      * undici proxy dispatcher (for undici fetch / undici clients).
      */
-    asUndiciDispatcher(): import("undici").Dispatcher;
+    asUndiciDispatcher(): import('undici').Dispatcher;
     /**
      * Returns a `fetch` function powered by undici that uses the proxy dispatcher per request.
      *
@@ -214,4 +214,4 @@ export type AluviaClientConnection = {
     /** @deprecated Use `close()` instead. */
     stop(): Promise<void>;
 };
-export type { BlockDetectionConfig, BlockDetectionResult, DetectionBlockStatus, DetectionSignal, RedirectHop, } from "./BlockDetection.js";
+export type { BlockDetectionConfig, BlockDetectionResult, DetectionBlockStatus, DetectionSignal, RedirectHop, } from './BlockDetection.js';

package/dist/types/index.d.ts

@@ -1,7 +1,9 @@
-export { AluviaClient } from "./client/AluviaClient.js";
-export { AluviaApi } from "./api/AluviaApi.js";
-export { connect } from "./connect.js";
-export type { ConnectResult } from "./connect.js";
-export { MissingApiKeyError, InvalidApiKeyError, ApiError, ProxyStartError, ConnectError, } from "./errors.js";
-export type { GatewayProtocol, LogLevel, AluviaClientOptions, AluviaClientConnection, PlaywrightProxySettings, BlockDetectionConfig, BlockDetectionResult, DetectionBlockStatus, DetectionSignal, RedirectHop, } from "./client/types.js";
-export type { Account, AccountUsage, AccountPayment, AccountConnection, AccountConnectionDeleteResult, Geo, SuccessEnvelope, ErrorEnvelope, Envelope, } from "./api/types.js";
+export { AluviaClient } from './client/AluviaClient.js';
+export { AluviaApi } from './api/AluviaApi.js';
+export { connect } from './connect.js';
+export type { ConnectResult } from './connect.js';
+export { MissingApiKeyError, InvalidApiKeyError, ApiError, ProxyStartError, ConnectError } from './errors.js';
+export { writeLock, readLock, removeLock, isProcessAlive, getLogFilePath, validateSessionName, generateSessionName, listSessions, toLockData, } from './session/lock.js';
+export type { LockData, LockDetection, SessionInfo } from './session/lock.js';
+export type { GatewayProtocol, LogLevel, AluviaClientOptions, AluviaClientConnection, PlaywrightProxySettings, BlockDetectionConfig, BlockDetectionResult, DetectionBlockStatus, DetectionSignal, RedirectHop, } from './client/types.js';
+export type { Account, AccountUsage, AccountPayment, AccountConnection, AccountConnectionDeleteResult, Geo, SuccessEnvelope, ErrorEnvelope, Envelope, } from './api/types.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aluvia/sdk",
-  "version": "1.4.1",
+  "version": "2.0.1",
   "description": "Aluvia SDK for Node.js - local smart proxy for automation workloads and AI agents",
   "license": "MIT",
   "author": "Aluvia",
@@ -22,31 +22,17 @@
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js"
     },
-    "./cli": {
-      "types": "./dist/types/bin/cli-adapter.d.ts",
-      "import": "./dist/esm/bin/cli-adapter.js",
-      "require": "./dist/cjs/bin/cli-adapter.js"
-    },
     "./package.json": "./package.json"
   },
-  "bin": {
-    "aluvia": "./dist/esm/bin/cli.js",
-    "aluvia-sdk": "./dist/esm/bin/cli.js"
-  },
-  "workspaces": [
-    "mcp"
-  ],
   "files": [
     "dist/**/*",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && node -e \"require('fs').mkdirSync('dist/cjs',{recursive:true});require('fs').writeFileSync('dist/cjs/package.json','{\\\"type\\\":\\\"commonjs\\\"}')\"",
-    "build:all": "npm run build && npm run build -w @aluvia/mcp",
-    "prepare": "npm run build",
-    "test": "node --import tsx --test test/integration.test.ts test/mcp-smoke.test.ts",
-    "test:mcp": "node mcp/test-stdio.mjs",
+    "test": "node --import tsx --test test/*.test.ts",
     "lint": "prettier --check src test",
     "lint:fix": "prettier --write src test"
   },
@@ -61,13 +47,12 @@
     "ai-agent",
     "playwright",
     "puppeteer",
-    "aluvia",
-    "mcp",
-    "model-context-protocol"
+    "aluvia"
   ],
   "devDependencies": {
     "@types/node": "^24.10.2",
     "axios": "^1.13.2",
+    "playwright": "^1.58.2",
     "prettier": "^3.4.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
@@ -75,8 +60,15 @@
   "dependencies": {
     "http-proxy-agent": "^7.0.2",
     "https-proxy-agent": "^7.0.6",
-    "playwright": "^1.58.2",
     "proxy-chain": "^2.6.1",
     "undici": "^6.22.0"
+  },
+  "peerDependencies": {
+    "playwright": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
   }
-}
+}

package/dist/cjs/bin/account.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAccount = handleAccount;
-const api_helpers_js_1 = require("./api-helpers.js");
-const cli_js_1 = require("./cli.js");
-async function handleAccount(args) {
-    const subcommand = args[0];
-    if (!subcommand) {
-        const api = (0, api_helpers_js_1.requireApi)();
-        const account = await api.account.get();
-        return (0, cli_js_1.output)({ account });
-    }
-    if (subcommand === 'usage') {
-        let start;
-        let end;
-        for (let i = 1; i < args.length; i++) {
-            if (args[i] === '--start' && args[i + 1]) {
-                start = args[i + 1];
-                i++;
-            }
-            else if (args[i] === '--end' && args[i + 1]) {
-                end = args[i + 1];
-                i++;
-            }
-        }
-        const api = (0, api_helpers_js_1.requireApi)();
-        const usage = await api.account.usage.get({ start, end });
-        return (0, cli_js_1.output)({ usage });
-    }
-    return (0, cli_js_1.output)({ error: `Unknown account subcommand: '${subcommand}'.` }, 1);
-}

package/dist/cjs/bin/api-helpers.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireApi = requireApi;
-exports.resolveSession = resolveSession;
-exports.requireConnectionId = requireConnectionId;
-const AluviaApi_js_1 = require("../api/AluviaApi.js");
-const lock_js_1 = require("../session/lock.js");
-const cli_js_1 = require("./cli.js");
-/**
- * Create an AluviaApi instance from ALUVIA_API_KEY env var.
- * Calls output() and exits if the key is missing.
- */
-function requireApi() {
-    const apiKey = (process.env.ALUVIA_API_KEY ?? '').trim();
-    if (!apiKey) {
-        return (0, cli_js_1.output)({ error: 'ALUVIA_API_KEY environment variable is required.' }, 1);
-    }
-    return new AluviaApi_js_1.AluviaApi({ apiKey });
-}
-/**
- * Resolve a session by name or auto-select when only one is running.
- * Calls output() and exits on error (no sessions, ambiguous sessions, stale lock).
- */
-function resolveSession(sessionName) {
-    if (sessionName) {
-        const lock = (0, lock_js_1.readLock)(sessionName);
-        if (!lock) {
-            return (0, cli_js_1.output)({ error: `No session found with name '${sessionName}'.` }, 1);
-        }
-        if (!(0, lock_js_1.isProcessAlive)(lock.pid)) {
-            (0, lock_js_1.removeLock)(sessionName);
-            return (0, cli_js_1.output)({ error: `Session '${sessionName}' is no longer running (stale lock cleaned up).` }, 1);
-        }
-        return { session: sessionName, lock };
-    }
-    const sessions = (0, lock_js_1.listSessions)();
-    if (sessions.length === 0) {
-        return (0, cli_js_1.output)({ error: 'No running browser sessions found.' }, 1);
-    }
-    if (sessions.length > 1) {
-        return (0, cli_js_1.output)({
-            error: 'Multiple sessions running. Specify --browser-session <name>.',
-            browserSessions: sessions.map((s) => s.session),
-        }, 1);
-    }
-    const s = sessions[0];
-    return { session: s.session, lock: (0, lock_js_1.toLockData)(s) };
-}
-/**
- * Require a connection ID from lock data.
- * Calls output() and exits if connectionId is missing.
- */
-function requireConnectionId(lock, session) {
-    if (lock.connectionId == null) {
-        return (0, cli_js_1.output)({ error: `Session '${session}' has no connection ID. It may have been started without API access.` }, 1);
-    }
-    return lock.connectionId;
-}

package/dist/cjs/bin/cli-adapter.js

@@ -1,16 +0,0 @@
-"use strict";
-/**
- * Re-exports for @aluvia/mcp. MCP package imports from @aluvia/sdk/cli.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.captureOutput = exports.handleOpen = exports.handleGeos = exports.handleAccount = exports.handleSession = void 0;
-var session_js_1 = require("./session.js");
-Object.defineProperty(exports, "handleSession", { enumerable: true, get: function () { return session_js_1.handleSession; } });
-var account_js_1 = require("./account.js");
-Object.defineProperty(exports, "handleAccount", { enumerable: true, get: function () { return account_js_1.handleAccount; } });
-var geos_js_1 = require("./geos.js");
-Object.defineProperty(exports, "handleGeos", { enumerable: true, get: function () { return geos_js_1.handleGeos; } });
-var open_js_1 = require("./open.js");
-Object.defineProperty(exports, "handleOpen", { enumerable: true, get: function () { return open_js_1.handleOpen; } });
-var mcp_helpers_js_1 = require("./mcp-helpers.js");
-Object.defineProperty(exports, "captureOutput", { enumerable: true, get: function () { return mcp_helpers_js_1.captureOutput; } });

package/dist/cjs/bin/cli.js

@@ -1,245 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.output = output;
-const open_js_1 = require("./open.js");
-const session_js_1 = require("./session.js");
-const account_js_1 = require("./account.js");
-const geos_js_1 = require("./geos.js");
-const lock_js_1 = require("../session/lock.js");
-const mcp_helpers_js_1 = require("./mcp-helpers.js");
-function output(data, exitCode = 0) {
-    if ((0, mcp_helpers_js_1.isCapturing)()) {
-        throw new mcp_helpers_js_1.MCPOutputCapture(data, exitCode);
-    }
-    console.log(JSON.stringify(data));
-    process.exit(exitCode);
-}
-function printHelp(toStderr = false) {
-    const log = toStderr ? console.error : console.log;
-    log("Aluvia CLI\n");
-    log("Usage:");
-    log("  aluvia session start <url> [options]       Start a browser session");
-    log("  aluvia session close [options]              Stop a browser session");
-    log("  aluvia session list                         List active browser sessions");
-    log("  aluvia session get [options]                Get session details and proxy URLs");
-    log("  aluvia session rotate-ip [options]          Rotate IP on a running session");
-    log("  aluvia session set-geo <geo> [options]      Set target geo on a running session");
-    log("  aluvia session set-rules <rules> [options]  Set routing rules on a running session\n");
-    log("  aluvia account                              Show account info");
-    log("  aluvia account usage [options]              Show usage stats");
-    log("  aluvia geos                                 List available geos");
-    log("  aluvia help [--json]                        Show this help\n");
-    log("Session start options:");
-    log("  --connection-id <id>       Use a specific connection ID");
-    log("  --headful                  Run browser in headful mode");
-    log("  --browser-session <name>   Name for this session (auto-generated if omitted)");
-    log("  --auto-unblock             Auto-detect blocks and reload through Aluvia");
-    log("  --disable-block-detection  Disable block detection entirely");
-    log("  --run <script>             Run a script with page, browser, context injected\n");
-    log("Session close options:");
-    log("  --browser-session <name>   Close a specific session");
-    log("  --all                      Close all sessions\n");
-    log("Session targeting (get, rotate-ip, set-geo, set-rules):");
-    log("  --browser-session <name>   Target a specific session (auto-selects if only one)\n");
-    log("Session set-rules:");
-    log('  <rules>                    Comma-separated rules to append (e.g. "a.com,b.com")');
-    log("  --remove <rules>           Remove specific rules instead of appending\n");
-    log("Session set-geo:");
-    log('  <geo>                      Geo code to set (e.g. "US")');
-    log("  --clear                    Clear target geo\n");
-    log("Account usage options:");
-    log("  --start <ISO8601>          Start date filter");
-    log("  --end <ISO8601>            End date filter\n");
-    log("Environment:");
-    log("  ALUVIA_API_KEY   Required. Your Aluvia API key.\n");
-    log("Output:");
-    log("  All commands output JSON to stdout.");
-}
-function printHelpJson() {
-    return output({
-        commands: [
-            {
-                command: "session start <url>",
-                description: "Start a browser session",
-                options: [
-                    {
-                        flag: "--connection-id <id>",
-                        description: "Use a specific connection ID",
-                    },
-                    { flag: "--headful", description: "Run browser in headful mode" },
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Name for this session (auto-generated if omitted)",
-                    },
-                    {
-                        flag: "--auto-unblock",
-                        description: "Auto-detect blocks and reload through Aluvia",
-                    },
-                    {
-                        flag: "--disable-block-detection",
-                        description: "Disable block detection entirely",
-                    },
-                    {
-                        flag: "--run <script>",
-                        description: "Run a script with page, browser, context injected",
-                    },
-                ],
-            },
-            {
-                command: "session close",
-                description: "Stop a browser session",
-                options: [
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Close a specific session",
-                    },
-                    { flag: "--all", description: "Close all sessions" },
-                ],
-            },
-            {
-                command: "session list",
-                description: "List active browser sessions",
-                options: [],
-            },
-            {
-                command: "session get",
-                description: "Get session details and proxy URLs",
-                options: [
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Target a specific session (auto-selects if only one)",
-                    },
-                ],
-            },
-            {
-                command: "session rotate-ip",
-                description: "Rotate IP on a running session",
-                options: [
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Target a specific session (auto-selects if only one)",
-                    },
-                ],
-            },
-            {
-                command: "session set-geo <geo>",
-                description: "Set target geo on a running session",
-                options: [
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Target a specific session (auto-selects if only one)",
-                    },
-                    { flag: "--clear", description: "Clear target geo" },
-                ],
-            },
-            {
-                command: "session set-rules <rules>",
-                description: "Set routing rules on a running session",
-                options: [
-                    {
-                        flag: "--browser-session <name>",
-                        description: "Target a specific session (auto-selects if only one)",
-                    },
-                    {
-                        flag: "--remove <rules>",
-                        description: "Remove specific rules instead of appending",
-                    },
-                ],
-            },
-            {
-                command: "account",
-                description: "Show account info",
-                options: [],
-            },
-            {
-                command: "account usage",
-                description: "Show usage stats",
-                options: [
-                    { flag: "--start <ISO8601>", description: "Start date filter" },
-                    { flag: "--end <ISO8601>", description: "End date filter" },
-                ],
-            },
-            {
-                command: "geos",
-                description: "List available geos",
-                options: [],
-            },
-            {
-                command: "help",
-                description: "Show this help",
-                options: [{ flag: "--json", description: "Output help as JSON" }],
-            },
-        ],
-    });
-}
-function printHelpAndExit(args) {
-    if (args.includes("--json")) {
-        return printHelpJson();
-    }
-    printHelp();
-    process.exit(0);
-}
-function parseDaemonArgs(args) {
-    return (0, session_js_1.parseSessionArgs)(args);
-}
-async function main() {
-    const args = process.argv.slice(2);
-    const command = args[0] ?? "";
-    // Internal: --daemon mode (spawned by `session start` in detached child)
-    if (command === "--daemon") {
-        const parsed = parseDaemonArgs(args.slice(1));
-        if (parsed.sessionName && !(0, lock_js_1.validateSessionName)(parsed.sessionName)) {
-            output({
-                error: "Invalid session name. Use only letters, numbers, hyphens, and underscores.",
-            }, 1);
-        }
-        if (!parsed.url) {
-            return output({ error: "URL is required for daemon mode." }, 1);
-        }
-        await (0, open_js_1.handleOpenDaemon)({
-            url: parsed.url,
-            connectionId: parsed.connectionId,
-            headless: !parsed.headed,
-            sessionName: parsed.sessionName,
-            autoUnblock: parsed.autoUnblock,
-            disableBlockDetection: parsed.disableBlockDetection,
-            run: parsed.run,
-        });
-        return;
-    }
-    // Check for --help / -h anywhere in args (subcommand help)
-    const wantsHelp = args.includes("--help") || args.includes("-h");
-    if (command === "session") {
-        if (wantsHelp)
-            printHelpAndExit(args);
-        await (0, session_js_1.handleSession)(args.slice(1));
-    }
-    else if (command === "account") {
-        if (wantsHelp)
-            printHelpAndExit(args);
-        await (0, account_js_1.handleAccount)(args.slice(1));
-    }
-    else if (command === "geos") {
-        if (wantsHelp)
-            printHelpAndExit(args);
-        await (0, geos_js_1.handleGeos)();
-    }
-    else if (command === "help" ||
-        command === "--help" ||
-        command === "-h" ||
-        command === "") {
-        printHelpAndExit(args);
-    }
-    else {
-        output({ error: `Unknown command: '${command}'. Run "aluvia help" for usage.` }, 1);
-    }
-}
-// Only run CLI when this file is the direct entry point (not when imported by MCP server).
-// Check if process.argv[1] resolves to this CLI file rather than another entry point.
-const isCli = process.argv[1]?.match(/(?:cli)\.[jt]s$/);
-if (isCli) {
-    main().catch((err) => {
-        output({ error: err.message }, 1);
-    });
-}