@toon-protocol/connector 3.3.0 → 3.3.2

package/dist/test-utils/mock-factories.d.ts

@@ -0,0 +1,22 @@
+import { ethers } from 'ethers';
+import type { Logger } from 'pino';
+import type { TreasuryWallet } from '../wallet/treasury-wallet';
+import type { FraudDetector } from '../wallet/wallet-security';
+export declare const TEST_EVM_ADDRESS = "0x742d35Cc6634C0532925a3b844Bc454321f0bEb0";
+export declare const TEST_AGENT_ID = "test-agent-001";
+export declare const TEST_PASSWORD = "TestP@ssw0rd12345678";
+export declare function createMockTreasuryWallet(overrides?: Partial<jest.Mocked<TreasuryWallet>>): jest.Mocked<TreasuryWallet>;
+export interface MockFraudDetectorOptions {
+    shouldDetectFraud?: boolean;
+    fraudScore?: number;
+    fraudReason?: string;
+}
+export declare function createMockFraudDetector(options?: MockFraudDetectorOptions, overrides?: Partial<jest.Mocked<FraudDetector>>): jest.Mocked<FraudDetector>;
+export interface MockEvmProviderOptions {
+    balance?: bigint;
+    chainId?: bigint;
+    networkName?: string;
+}
+export declare function createMockEvmProvider(options?: MockEvmProviderOptions, overrides?: Partial<jest.Mocked<ethers.Provider>>): jest.Mocked<ethers.Provider>;
+export declare function createMockLogger(): jest.Mocked<Logger>;
+//# sourceMappingURL=mock-factories.d.ts.map

package/dist/test-utils/mock-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-factories.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-factories.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAQnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,2BAA2B,CAAC;AAOjF,eAAO,MAAM,gBAAgB,+CAA+C,CAAC;AAG7E,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAG9C,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAuMpD,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAC/C,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAQ7B;AAMD,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,wBAA6B,EACtC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAa5B;AAMD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,EACpC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAChD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAc9B;AASD,wBAAgB,gBAAgB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAgBtD"}

package/dist/test-utils/mock-factories.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_PASSWORD = exports.TEST_AGENT_ID = exports.TEST_EVM_ADDRESS = void 0;
+exports.createMockTreasuryWallet = createMockTreasuryWallet;
+exports.createMockFraudDetector = createMockFraudDetector;
+exports.createMockEvmProvider = createMockEvmProvider;
+exports.createMockLogger = createMockLogger;
+exports.TEST_EVM_ADDRESS = '0x742d35Cc6634C0532925a3b844Bc454321f0bEb0';
+exports.TEST_AGENT_ID = 'test-agent-001';
+exports.TEST_PASSWORD = 'TestP@ssw0rd12345678';
+function createMockTreasuryWallet(overrides) {
+    return {
+        sendETH: jest.fn().mockResolvedValue({ hash: '0x' + '1'.repeat(64), to: exports.TEST_EVM_ADDRESS }),
+        sendERC20: jest.fn().mockResolvedValue({ hash: '0x' + '1'.repeat(64), to: exports.TEST_EVM_ADDRESS }),
+        getBalance: jest.fn().mockResolvedValue(BigInt('10000000000000000000')),
+        evmAddress: exports.TEST_EVM_ADDRESS,
+        ...overrides,
+    };
+}
+function createMockFraudDetector(options = {}, overrides) {
+    const { shouldDetectFraud = false, fraudScore = 0, fraudReason = 'Test fraud' } = options;
+    const defaultResult = {
+        detected: shouldDetectFraud,
+        score: fraudScore,
+        reason: shouldDetectFraud ? fraudReason : undefined,
+    };
+    return {
+        analyzeTransaction: jest.fn().mockResolvedValue(defaultResult),
+        ...overrides,
+    };
+}
+function createMockEvmProvider(options = {}, overrides) {
+    const { balance = BigInt('1000000000000000000'), chainId = 8453n, networkName = 'base', } = options;
+    return {
+        getBalance: jest.fn().mockResolvedValue(balance),
+        getNetwork: jest.fn().mockResolvedValue({ chainId, name: networkName }),
+        getTransactionReceipt: jest.fn().mockResolvedValue({ status: 1 }),
+        waitForTransaction: jest.fn().mockResolvedValue({ status: 1 }),
+        ...overrides,
+    };
+}
+function createMockLogger() {
+    const mockLogger = {
+        trace: jest.fn().mockReturnThis(),
+        debug: jest.fn().mockReturnThis(),
+        info: jest.fn().mockReturnThis(),
+        warn: jest.fn().mockReturnThis(),
+        error: jest.fn().mockReturnThis(),
+        fatal: jest.fn().mockReturnThis(),
+        child: jest.fn(),
+        level: 'silent',
+    };
+    mockLogger.child.mockReturnValue(mockLogger);
+    return mockLogger;
+}
+//# sourceMappingURL=mock-factories.js.map

package/dist/test-utils/mock-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-factories.js","sourceRoot":"","sources":["../../src/test-utils/mock-factories.ts"],"names":[],"mappings":"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"}

package/dist/transport/direct-transport-provider.d.ts

@@ -0,0 +1,12 @@
+import type http from 'http';
+import type { TransportProvider } from './transport-provider';
+export declare class DirectTransportProvider implements TransportProvider {
+    private readonly _externalUrl;
+    constructor(externalUrl: string);
+    createAgent(_peerUrl: string): http.Agent | undefined;
+    getExternalUrl(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=direct-transport-provider.d.ts.map

package/dist/transport/direct-transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-transport-provider.d.ts","sourceRoot":"","sources":["../../src/transport/direct-transport-provider.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAU9D,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAM1B,WAAW,EAAE,MAAM;IAQ/B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,SAAS;IAKrD,cAAc,IAAI,MAAM;IAKlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/transport/direct-transport-provider.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectTransportProvider = void 0;
+class DirectTransportProvider {
+    _externalUrl;
+    constructor(externalUrl) {
+        if (!externalUrl) {
+            throw new Error('DirectTransportProvider: externalUrl must not be empty');
+        }
+        this._externalUrl = externalUrl;
+    }
+    createAgent(_peerUrl) {
+        return undefined;
+    }
+    getExternalUrl() {
+        return this._externalUrl;
+    }
+    async start() {
+    }
+    async stop() {
+    }
+    async healthCheck() {
+        return true;
+    }
+}
+exports.DirectTransportProvider = DirectTransportProvider;
+//# sourceMappingURL=direct-transport-provider.js.map

package/dist/transport/direct-transport-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-transport-provider.js","sourceRoot":"","sources":["../../src/transport/direct-transport-provider.ts"],"names":[],"mappings":";;;AAuBA,MAAa,uBAAuB;IACjB,YAAY,CAAS;IAMtC,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAGD,WAAW,CAAC,QAAgB;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAGD,KAAK,CAAC,KAAK;IAEX,CAAC;IAGD,KAAK,CAAC,IAAI;IAEV,CAAC;IAGD,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAtCD,0DAsCC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,7 @@
+export { type TransportProvider } from './transport-provider';
+export { DirectTransportProvider } from './direct-transport-provider';
+export { SocksTransportProvider, type SocksTransportProviderOptions, } from './socks-transport-provider';
+export { ManagedAnonClient, createDefaultAnonFactory, type ManagedAnonClientOptions, type AnonFactoryOptions, type AnonSdkHandle, } from './managed-anon-client';
+export { parseSocks5hUrl, type ParsedSocks5Url } from './socks-url';
+export { probeTcpPort, waitForTcpPort } from './probe-tcp-port';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForTcpPort = exports.probeTcpPort = exports.parseSocks5hUrl = exports.createDefaultAnonFactory = exports.ManagedAnonClient = exports.SocksTransportProvider = exports.DirectTransportProvider = void 0;
+var direct_transport_provider_1 = require("./direct-transport-provider");
+Object.defineProperty(exports, "DirectTransportProvider", { enumerable: true, get: function () { return direct_transport_provider_1.DirectTransportProvider; } });
+var socks_transport_provider_1 = require("./socks-transport-provider");
+Object.defineProperty(exports, "SocksTransportProvider", { enumerable: true, get: function () { return socks_transport_provider_1.SocksTransportProvider; } });
+var managed_anon_client_1 = require("./managed-anon-client");
+Object.defineProperty(exports, "ManagedAnonClient", { enumerable: true, get: function () { return managed_anon_client_1.ManagedAnonClient; } });
+Object.defineProperty(exports, "createDefaultAnonFactory", { enumerable: true, get: function () { return managed_anon_client_1.createDefaultAnonFactory; } });
+var socks_url_1 = require("./socks-url");
+Object.defineProperty(exports, "parseSocks5hUrl", { enumerable: true, get: function () { return socks_url_1.parseSocks5hUrl; } });
+var probe_tcp_port_1 = require("./probe-tcp-port");
+Object.defineProperty(exports, "probeTcpPort", { enumerable: true, get: function () { return probe_tcp_port_1.probeTcpPort; } });
+Object.defineProperty(exports, "waitForTcpPort", { enumerable: true, get: function () { return probe_tcp_port_1.waitForTcpPort; } });
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":";;;AASA,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA;AAChC,uEAGoC;AAFlC,kIAAA,sBAAsB,OAAA;AAGxB,6DAM+B;AAL7B,wHAAA,iBAAiB,OAAA;AACjB,+HAAA,wBAAwB,OAAA;AAK1B,yCAAoE;AAA3D,4GAAA,eAAe,OAAA;AACxB,mDAAgE;AAAvD,8GAAA,YAAY,OAAA;AAAE,gHAAA,cAAc,OAAA"}

package/dist/transport/managed-anon-client.d.ts

@@ -0,0 +1,47 @@
+import type pino from 'pino';
+export interface AnonSdkHandle {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getSOCKSPort(): number;
+}
+export interface AnonFactoryOptions {
+    displayLog: boolean;
+    useExecFile: boolean;
+    socksPort: number;
+    orPort: 0;
+    binaryPath?: string;
+    configFilePath?: string;
+    hiddenServiceDir?: string;
+    hiddenServicePort?: number;
+    autoTermsAgreement?: boolean;
+}
+export interface ManagedAnonClientOptions {
+    socksProxy: string;
+    hiddenServiceDir?: string;
+    hiddenServicePort?: number;
+    binaryPath?: string;
+    startupTimeoutMs?: number;
+    stopTimeoutMs?: number;
+    logger: pino.Logger;
+    anonFactory: (opts: AnonFactoryOptions) => AnonSdkHandle;
+}
+export declare class ManagedAnonClient {
+    private readonly _opts;
+    private readonly _logger;
+    private readonly _socksHost;
+    private readonly _socksPort;
+    private _sdk;
+    private _started;
+    private _lastHealthyFlag;
+    private _consecutiveProbeFailures;
+    constructor(options: ManagedAnonClientOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    healthCheck(): Promise<boolean>;
+    private _buildFactoryOptions;
+    private _bestEffortStop;
+}
+export declare function createDefaultAnonFactory(): Promise<(opts: AnonFactoryOptions) => AnonSdkHandle>;
+//# sourceMappingURL=managed-anon-client.d.ts.map

package/dist/transport/managed-anon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-anon-client.d.ts","sourceRoot":"","sources":["../../src/transport/managed-anon-client.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B,MAAM,WAAW,aAAa;IAE5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,SAAS,IAAI,OAAO,CAAC;IAErB,YAAY,IAAI,MAAM,CAAC;CACxB;AAOD,MAAM,WAAW,kBAAkB;IAEjC,UAAU,EAAE,OAAO,CAAC;IAEpB,WAAW,EAAE,OAAO,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,CAAC,CAAC;IAEV,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAKD,MAAM,WAAW,wBAAwB;IAEvC,UAAU,EAAE,MAAM,CAAC;IAEnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAMpB,WAAW,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,aAAa,CAAC;CAC1D;AASD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,IAAI,CAA4B;IAMxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,yBAAyB,CAAK;gBAE1B,OAAO,EAAE,wBAAwB;IAevC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8EtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2E3B,SAAS,IAAI,OAAO;IAQd,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YA8CvB,oBAAoB;YA2DpB,eAAe;CAa9B;AAiBD,wBAAsB,wBAAwB,IAAI,OAAO,CACvD,CAAC,IAAI,EAAE,kBAAkB,KAAK,aAAa,CAC5C,CAyCA"}

package/dist/transport/managed-anon-client.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManagedAnonClient = void 0;
+exports.createDefaultAnonFactory = createDefaultAnonFactory;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path_1 = tslib_1.__importDefault(require("path"));
+const probe_tcp_port_1 = require("./probe-tcp-port");
+const socks_url_1 = require("./socks-url");
+const DEFAULT_STARTUP_TIMEOUT_MS = 60_000;
+const DEFAULT_STOP_TIMEOUT_MS = 10_000;
+class ManagedAnonClient {
+    _opts;
+    _logger;
+    _socksHost;
+    _socksPort;
+    _sdk;
+    _started = false;
+    _lastHealthyFlag = true;
+    _consecutiveProbeFailures = 0;
+    constructor(options) {
+        this._opts = options;
+        this._logger = options.logger.child({ component: 'managed-anon-client' });
+        const { host, port } = (0, socks_url_1.parseSocks5hUrl)(options.socksProxy);
+        this._socksHost = host;
+        this._socksPort = port;
+    }
+    async start() {
+        if (this._started && this._sdk) {
+            return;
+        }
+        const factoryOpts = await this._buildFactoryOptions();
+        let sdk;
+        try {
+            sdk = this._opts.anonFactory(factoryOpts);
+        }
+        catch (err) {
+            const cause = err;
+            if (cause?.code === 'MODULE_NOT_FOUND') {
+                throw new Error(`Managed ATOR transport requires the optional dependency ` +
+                    `"@anyone-protocol/anyone-client" but it was not found. ` +
+                    `Install it with: npm install @anyone-protocol/anyone-client`, { cause });
+            }
+            throw new Error(`Failed to construct @anyone-protocol/anyone-client SDK handle: ${cause?.message ?? String(err)}`, { cause });
+        }
+        try {
+            await sdk.start();
+        }
+        catch (err) {
+            const cause = err;
+            await this._bestEffortStop(sdk);
+            this._sdk = undefined;
+            this._started = false;
+            if (cause?.code === 'ENOENT' || /ENOENT/.test(cause?.message ?? '')) {
+                const hint = this._opts.binaryPath
+                    ? ` at configured binaryPath="${this._opts.binaryPath}"`
+                    : ' (the bundled binary shipped by @anyone-protocol/anyone-client could not be spawned)';
+                throw new Error(`anon binary not found${hint}. Install @anyone-protocol/anyone-client ` +
+                    `and ensure a compatible binary is available for this platform ` +
+                    `(npm install @anyone-protocol/anyone-client).`, { cause });
+            }
+            throw new Error(`Failed to start managed anon SDK: ${cause?.message ?? String(err)}`, {
+                cause,
+            });
+        }
+        const startupTimeoutMs = this._opts.startupTimeoutMs ?? DEFAULT_STARTUP_TIMEOUT_MS;
+        const socksPort = sdk.getSOCKSPort?.() ?? this._socksPort;
+        try {
+            await (0, probe_tcp_port_1.waitForTcpPort)(this._socksHost, socksPort, startupTimeoutMs);
+        }
+        catch (err) {
+            const cause = err;
+            await this._bestEffortStop(sdk);
+            this._sdk = undefined;
+            this._started = false;
+            throw new Error(`Managed anon SOCKS port ${socksPort} did not bind within ${startupTimeoutMs}ms timeout ` +
+                `(awaiting TCP readiness on ${this._socksHost}:${socksPort})`, { cause });
+        }
+        this._sdk = sdk;
+        this._started = true;
+        this._lastHealthyFlag = true;
+        this._logger.info({ event: 'managed_anon_started', socksPort }, 'Managed anon client started');
+    }
+    async stop() {
+        const sdk = this._sdk;
+        if (!sdk || !this._started) {
+            this._sdk = undefined;
+            this._started = false;
+            return;
+        }
+        this._sdk = undefined;
+        this._started = false;
+        const stopTimeoutMs = this._opts.stopTimeoutMs ?? DEFAULT_STOP_TIMEOUT_MS;
+        let timer;
+        const timeoutPromise = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('timeout'), stopTimeoutMs);
+        });
+        let raceSettled = false;
+        const sdkStopPromise = sdk.stop();
+        sdkStopPromise.catch((lateErr) => {
+            if (raceSettled) {
+                this._logger.warn({
+                    event: 'managed_anon_stop_late_error',
+                    errorMessage: lateErr?.message ?? String(lateErr),
+                }, 'Managed anon SDK stop() rejected after the stop race had already settled');
+            }
+        });
+        try {
+            const result = await Promise.race([sdkStopPromise.then(() => 'ok'), timeoutPromise]);
+            raceSettled = true;
+            if (result === 'timeout') {
+                const stillRunning = safeIsRunning(sdk);
+                this._logger.warn({
+                    event: 'managed_anon_stop_timeout',
+                    stopTimeoutMs,
+                    sdkStillRunning: stillRunning,
+                }, 'Managed anon SDK stop() did not resolve within timeout; ' +
+                    (stillRunning ? 'operator intervention may be required' : 'proceeding with shutdown'));
+            }
+            else {
+                this._logger.info({ event: 'managed_anon_stopped' }, 'Managed anon client stopped');
+            }
+        }
+        catch (err) {
+            raceSettled = true;
+            const cause = err;
+            this._logger.warn({
+                event: 'managed_anon_stop_error',
+                errorMessage: cause?.message ?? String(err),
+            }, 'Managed anon SDK stop() threw; continuing shutdown');
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    isRunning() {
+        return this._started && safeIsRunning(this._sdk);
+    }
+    async healthCheck() {
+        if (!this._started || !this._sdk) {
+            return false;
+        }
+        const ok = safeIsRunning(this._sdk);
+        if (!ok && this._lastHealthyFlag) {
+            this._lastHealthyFlag = false;
+            this._logger.warn({ event: 'managed_anon_crash_detected' }, 'Managed anon SDK reports not running (binary may have crashed)');
+        }
+        else if (ok && !this._lastHealthyFlag) {
+            this._lastHealthyFlag = true;
+        }
+        if (ok) {
+            try {
+                await (0, probe_tcp_port_1.probeTcpPort)(this._socksHost, this._sdk.getSOCKSPort(), 250);
+                this._consecutiveProbeFailures = 0;
+            }
+            catch (err) {
+                this._consecutiveProbeFailures += 1;
+                if (this._consecutiveProbeFailures >= 2) {
+                    this._logger.warn({
+                        event: 'managed_anon_probe_failed',
+                        consecutiveFailures: this._consecutiveProbeFailures,
+                        errorMessage: err?.message ?? String(err),
+                    }, 'Managed anon SOCKS port probe failed on 2+ consecutive health checks');
+                    return false;
+                }
+            }
+        }
+        return ok;
+    }
+    async _buildFactoryOptions() {
+        const opts = {
+            displayLog: this._opts.logger.level === 'debug' || this._opts.logger.level === 'trace',
+            useExecFile: false,
+            socksPort: this._socksPort,
+            orPort: 0,
+            binaryPath: this._opts.binaryPath,
+            autoTermsAgreement: true,
+        };
+        if (this._opts.hiddenServiceDir) {
+            opts.hiddenServiceDir = this._opts.hiddenServiceDir;
+            if (this._opts.hiddenServicePort !== undefined) {
+                opts.hiddenServicePort = this._opts.hiddenServicePort;
+            }
+            try {
+                await fs_1.promises.mkdir(this._opts.hiddenServiceDir, { recursive: true });
+                const anonrcPath = path_1.default.join(this._opts.hiddenServiceDir, 'anonrc');
+                let anonrcExists = false;
+                try {
+                    await fs_1.promises.access(anonrcPath);
+                    anonrcExists = true;
+                }
+                catch {
+                    anonrcExists = false;
+                }
+                if (!anonrcExists) {
+                    const anonrc = `# Written by ManagedAnonClient (Epic 35 / Story 35.5) on first boot.\n` +
+                        `# Edit freely — ManagedAnonClient will NOT overwrite this file on subsequent starts.\n` +
+                        `AgreeToTerms 1\n` +
+                        `SocksPort ${this._socksPort}\n` +
+                        `HiddenServiceDir ${this._opts.hiddenServiceDir}\n` +
+                        (this._opts.hiddenServicePort !== undefined
+                            ? `HiddenServicePort ${this._opts.hiddenServicePort} 127.0.0.1:${this._opts.hiddenServicePort}\n`
+                            : '');
+                    await fs_1.promises.writeFile(anonrcPath, anonrc, { encoding: 'utf8', flag: 'wx' });
+                }
+                opts.configFilePath = anonrcPath;
+                opts.configFile = anonrcPath;
+            }
+            catch (err) {
+                this._logger.debug({ event: 'managed_anon_anonrc_write_failed', error: err.message }, 'Could not write anonrc; continuing with native options only');
+            }
+        }
+        return opts;
+    }
+    async _bestEffortStop(sdk) {
+        try {
+            await sdk.stop();
+        }
+        catch (err) {
+            this._logger.warn({
+                event: 'managed_anon_cleanup_stop_failed',
+                errorMessage: err.message,
+            }, 'Best-effort SDK stop() during failure cleanup threw; ignoring');
+        }
+    }
+}
+exports.ManagedAnonClient = ManagedAnonClient;
+function safeIsRunning(sdk) {
+    if (!sdk)
+        return false;
+    try {
+        return sdk.isRunning() === true;
+    }
+    catch {
+        return false;
+    }
+}
+async function createDefaultAnonFactory() {
+    let mod;
+    const pkg = '@anyone-protocol/anyone-client';
+    try {
+        mod = require(pkg);
+    }
+    catch {
+        try {
+            mod = await new Function('p', 'return import(p)')(pkg);
+        }
+        catch (err) {
+            const cause = err;
+            const wrapped = new Error(`Managed ATOR transport requires the optional dependency ` +
+                `"@anyone-protocol/anyone-client" but it was not found. ` +
+                `Install it with: npm install @anyone-protocol/anyone-client`, { cause });
+            wrapped.code = 'MODULE_NOT_FOUND';
+            throw wrapped;
+        }
+    }
+    const AnonCtor = mod?.Process ?? mod?.Anon ?? mod?.default?.Process ?? mod?.default?.Anon ?? mod?.default;
+    if (typeof AnonCtor !== 'function') {
+        throw new Error('@anyone-protocol/anyone-client did not export a `Process` or `Anon` constructor; ' +
+            'SDK surface may have changed.');
+    }
+    return (opts) => new AnonCtor(opts);
+}
+//# sourceMappingURL=managed-anon-client.js.map

package/dist/transport/managed-anon-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-anon-client.js","sourceRoot":"","sources":["../../src/transport/managed-anon-client.ts"],"names":[],"mappings":";;;AA+aA,4DA2CC;;AAlcD,2BAAqC;AACrC,wDAAwB;AAExB,qDAAgE;AAChE,2CAA8C;AAsE9C,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAMvC,MAAa,iBAAiB;IACX,KAAK,CAA2B;IAChC,OAAO,CAAc;IACrB,UAAU,CAAS;IACnB,UAAU,CAAS;IAC5B,IAAI,CAA4B;IAMhC,QAAQ,GAAG,KAAK,CAAC;IACjB,gBAAgB,GAAG,IAAI,CAAC;IACxB,yBAAyB,GAAG,CAAC,CAAC;IAEtC,YAAY,OAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAE1E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAA,2BAAe,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAQD,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAGtD,IAAI,GAAkB,CAAC;QACvB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAA4B,CAAC;YAC3C,IAAI,KAAK,EAAE,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,0DAA0D;oBACxD,yDAAyD;oBACzD,6DAA6D,EAC/D,EAAE,KAAK,EAAE,CACV,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kEAAkE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EACjG,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QAGD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAA4B,CAAC;YAC3C,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU;oBAChC,CAAC,CAAC,8BAA8B,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG;oBACxD,CAAC,CAAC,sFAAsF,CAAC;gBAC3F,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,2CAA2C;oBACrE,gEAAgE;oBAChE,+CAA+C,EACjD,EAAE,KAAK,EAAE,CACV,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE;gBACpF,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAGD,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;QACnF,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,IAAA,+BAAc,EAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAY,CAAC;YAC3B,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,2BAA2B,SAAS,wBAAwB,gBAAgB,aAAa;gBACvF,8BAA8B,IAAI,CAAC,UAAU,IAAI,SAAS,GAAG,EAC/D,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,EAAE,6BAA6B,CAAC,CAAC;IACjG,CAAC;IAMD,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAE3B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QAEtB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,uBAAuB,CAAC;QAE1E,IAAI,KAAiC,CAAC;QACtC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACxD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAQH,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,cAAc,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAClC,cAAc,CAAC,KAAK,CAAC,CAAC,OAAgB,EAAE,EAAE;YACxC,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CACf;oBACE,KAAK,EAAE,8BAA8B;oBACrC,YAAY,EAAG,OAAiB,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;iBAC7D,EACD,0EAA0E,CAC3E,CAAC;YACJ,CAAC;QAGH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAa,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;YAC9F,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CACf;oBACE,KAAK,EAAE,2BAA2B;oBAClC,aAAa;oBACb,eAAe,EAAE,YAAY;iBAC9B,EACD,0DAA0D;oBACxD,CAAC,YAAY,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CACxF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,6BAA6B,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,GAAG,IAAI,CAAC;YACnB,MAAM,KAAK,GAAG,GAAY,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CACf;gBACE,KAAK,EAAE,yBAAyB;gBAChC,YAAY,EAAE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;aAC5C,EACD,oDAAoD,CACrD,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAKD,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAMD,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjC,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,EAAE,KAAK,EAAE,6BAA6B,EAAE,EACxC,gEAAgE,CACjE,CAAC;QACJ,CAAC;aAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,CAAC;QAKD,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,IAAA,6BAAY,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;gBACnE,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,yBAAyB,IAAI,CAAC,CAAC;gBACpC,IAAI,IAAI,CAAC,yBAAyB,IAAI,CAAC,EAAE,CAAC;oBACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CACf;wBACE,KAAK,EAAE,2BAA2B;wBAClC,mBAAmB,EAAE,IAAI,CAAC,yBAAyB;wBACnD,YAAY,EAAG,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;qBACrD,EACD,sEAAsE,CACvE,CAAC;oBACF,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAQO,KAAK,CAAC,oBAAoB;QAChC,MAAM,IAAI,GAAuB;YAC/B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO;YACtF,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YACjC,kBAAkB,EAAE,IAAI;SACzB,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAGhC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC;YACpD,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;YACxD,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,aAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBAMpE,IAAI,YAAY,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,aAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;oBAC7B,YAAY,GAAG,IAAI,CAAC;gBACtB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY,GAAG,KAAK,CAAC;gBACvB,CAAC;gBACD,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,MAAM,MAAM,GACV,wEAAwE;wBACxE,wFAAwF;wBACxF,kBAAkB;wBAClB,aAAa,IAAI,CAAC,UAAU,IAAI;wBAChC,oBAAoB,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI;wBACnD,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;4BACzC,CAAC,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,iBAAiB,cAAc,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI;4BACjG,CAAC,CAAC,EAAE,CAAC,CAAC;oBACV,MAAM,aAAG,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5E,CAAC;gBAKD,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;gBAChC,IAAqD,CAAC,UAAU,GAAG,UAAU,CAAC;YACjF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,EAAE,KAAK,EAAE,kCAAkC,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,EAC5E,6DAA6D,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,GAAkB;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,IAAI,CACf;gBACE,KAAK,EAAE,kCAAkC;gBACzC,YAAY,EAAG,GAAa,CAAC,OAAO;aACrC,EACD,+DAA+D,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AArTD,8CAqTC;AAGD,SAAS,aAAa,CAAC,GAA8B;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAOM,KAAK,UAAU,wBAAwB;IAI5C,IAAI,GAAQ,CAAC;IAIb,MAAM,GAAG,GAAG,gCAAgC,CAAC;IAC7C,IAAI,CAAC;QAGH,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YAEH,GAAG,GAAG,MAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAiC,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAA4B,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,KAAK,CACvB,0DAA0D;gBACxD,yDAAyD;gBACzD,6DAA6D,EAC/D,EAAE,KAAK,EAAE,CACV,CAAC;YAGD,OAAiC,CAAC,IAAI,GAAG,kBAAkB,CAAC;YAC7D,MAAM,OAAO,CAAC;QAChB,CAAC;IACH,CAAC;IAID,MAAM,QAAQ,GACZ,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC;IAC3F,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,+BAA+B,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,IAAwB,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAkB,CAAC;AAC3E,CAAC"}

package/dist/transport/probe-tcp-port.d.ts

@@ -0,0 +1,3 @@
+export declare function probeTcpPort(host: string, port: number, timeoutMs: number): Promise<void>;
+export declare function waitForTcpPort(host: string, port: number, overallTimeoutMs: number, perProbeTimeoutMs?: number, pollIntervalMs?: number): Promise<void>;
+//# sourceMappingURL=probe-tcp-port.d.ts.map

package/dist/transport/probe-tcp-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-tcp-port.d.ts","sourceRoot":"","sources":["../../src/transport/probe-tcp-port.ts"],"names":[],"mappings":"AAyBA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCzF;AAeD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,SAAM,EACvB,cAAc,SAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/transport/probe-tcp-port.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probeTcpPort = probeTcpPort;
+exports.waitForTcpPort = waitForTcpPort;
+const tslib_1 = require("tslib");
+const net_1 = tslib_1.__importDefault(require("net"));
+function probeTcpPort(host, port, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const socket = net_1.default.createConnection({ host, port });
+        let settled = false;
+        const cleanup = () => {
+            socket.removeAllListeners();
+            socket.destroy();
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once('connect', () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve();
+        });
+        socket.once('timeout', () => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(new Error(`probe timed out after ${timeoutMs}ms`));
+        });
+        socket.once('error', (err) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(err);
+        });
+    });
+}
+async function waitForTcpPort(host, port, overallTimeoutMs, perProbeTimeoutMs = 250, pollIntervalMs = 100) {
+    const deadline = Date.now() + overallTimeoutMs;
+    let lastErr;
+    while (Date.now() < deadline) {
+        const remaining = deadline - Date.now();
+        const probeTimeout = Math.min(perProbeTimeoutMs, Math.max(1, remaining));
+        try {
+            await probeTcpPort(host, port, probeTimeout);
+            return;
+        }
+        catch (err) {
+            lastErr = err;
+        }
+        if (Date.now() + pollIntervalMs >= deadline)
+            break;
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    throw new Error(`TCP port ${host}:${port} did not become ready within ${overallTimeoutMs}ms timeout` +
+        (lastErr ? ` (last error: ${lastErr.message})` : ''));
+}
+//# sourceMappingURL=probe-tcp-port.js.map

package/dist/transport/probe-tcp-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-tcp-port.js","sourceRoot":"","sources":["../../src/transport/probe-tcp-port.ts"],"names":[],"mappings":";;AAyBA,oCAiCC;AAeD,wCA4BC;;AAtFD,sDAAsB;AAUtB,SAAgB,YAAY,CAAC,IAAY,EAAE,IAAY,EAAE,SAAiB;IACxE,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,aAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,SAAS,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAClC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAeM,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAY,EACZ,gBAAwB,EACxB,iBAAiB,GAAG,GAAG,EACvB,cAAc,GAAG,GAAG;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;IAC/C,IAAI,OAA0B,CAAC;IAE/B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAY,CAAC;QACzB,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,IAAI,QAAQ;YAAE,MAAM;QACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,IAAI,IAAI,gCAAgC,gBAAgB,YAAY;QAClF,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACvD,CAAC;AACJ,CAAC"}

package/dist/transport/socks-transport-provider.d.ts

@@ -0,0 +1,29 @@
+import type http from 'http';
+import type pino from 'pino';
+import type { ManagedAnonClient } from './managed-anon-client';
+import type { TransportProvider } from './transport-provider';
+export interface SocksTransportProviderOptions {
+    socksProxy: string;
+    externalUrl: string;
+    logger: pino.Logger;
+    managedClient?: ManagedAnonClient;
+    resolveExternalUrlOnStart?: () => Promise<string>;
+}
+export declare class SocksTransportProvider implements TransportProvider {
+    private readonly _socksProxy;
+    private _externalUrl;
+    private readonly _logger;
+    private readonly _proxyHost;
+    private readonly _proxyPort;
+    private readonly _managedClient;
+    private readonly _resolveExternalUrlOnStart;
+    private _managedHealthy;
+    constructor(options: SocksTransportProviderOptions);
+    createAgent(peerUrl: string): http.Agent;
+    getExternalUrl(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    private _probeProxy;
+}
+//# sourceMappingURL=socks-transport-provider.d.ts.map

package/dist/transport/socks-transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socks-transport-provider.d.ts","sourceRoot":"","sources":["../../src/transport/socks-transport-provider.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,WAAW,6BAA6B;IAE5C,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAOpB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAQlC,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAcD,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAsC;IACjF,OAAO,CAAC,eAAe,CAAQ;gBAOnB,OAAO,EAAE,6BAA6B;IA+ClD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK;IAOxC,cAAc,IAAI,MAAM;IAalB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA+DrC,OAAO,CAAC,WAAW;CAGpB"}