fetch-tor-proxy 1.0.0

package/build/TorProcessManager.d.ts

@@ -0,0 +1,21 @@
+import { SocksProxyAgent } from 'socks-proxy-agent';
+export interface TorProcessManagerOptions {
+    torBinaryPath?: string;
+    torConfigPath?: string;
+    bootstrapTimeoutMs?: number;
+}
+export declare class TorProcessManager {
+    private readonly torBinaryPath;
+    private readonly torConfigPath;
+    private readonly bootstrapTimeoutMs;
+    private torProcess;
+    private isReady;
+    private startupPromise;
+    private readonly isWindows;
+    constructor(options?: TorProcessManagerOptions);
+    start(): Promise<void>;
+    stop(): void;
+    createAgent(proxyUrl: string): SocksProxyAgent;
+    private resetState;
+}
+//# sourceMappingURL=TorProcessManager.d.ts.map

package/build/TorProcessManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorProcessManager.d.ts","sourceRoot":"","sources":["../src/TorProcessManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,wBAAwB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAE5C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;gBAE9C,OAAO,CAAC,EAAE,wBAAwB;IAMxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0E5B,IAAI,IAAI,IAAI;IAiBZ,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAI9C,OAAO,CAAC,UAAU;CAIrB"}

package/build/TorProcessManager.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorProcessManager = void 0;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+class TorProcessManager {
+    constructor(options) {
+        this.torProcess = null;
+        this.isReady = false;
+        this.startupPromise = null;
+        this.isWindows = process.platform === 'win32';
+        this.torBinaryPath = options?.torBinaryPath ?? path_1.default.join(__dirname, '..', 'tor-expert-bundle', 'tor');
+        this.torConfigPath = options?.torConfigPath ?? path_1.default.join(__dirname, '..', 'tor-expert-bundle', 'torrc');
+        this.bootstrapTimeoutMs = options?.bootstrapTimeoutMs ?? 30000;
+    }
+    async start() {
+        if (!this.isWindows) {
+            // On Linux/macOS, assume Tor is managed externally (service/container/etc.).
+            this.isReady = true;
+            return;
+        }
+        if (this.isReady) {
+            return;
+        }
+        if (this.startupPromise) {
+            return this.startupPromise;
+        }
+        this.startupPromise = new Promise((resolve, reject) => {
+            const torProcess = (0, child_process_1.spawn)(this.torBinaryPath, ['-f', this.torConfigPath]);
+            this.torProcess = torProcess;
+            let settled = false;
+            let timeout;
+            const cleanup = () => {
+                clearTimeout(timeout);
+                torProcess.stdout?.removeListener('data', onStdout);
+                torProcess.removeListener('error', onError);
+                torProcess.removeListener('close', onClose);
+            };
+            const settle = (fn) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                fn();
+            };
+            const onStdout = (data) => {
+                if (data.toString().includes('Bootstrapped 100%')) {
+                    this.isReady = true;
+                    settle(() => resolve());
+                }
+            };
+            const onError = (error) => {
+                this.resetState();
+                settle(() => reject(error));
+            };
+            const onClose = (code) => {
+                const exitedBeforeReady = !this.isReady;
+                this.resetState();
+                if (exitedBeforeReady) {
+                    settle(() => reject(new Error(`Tor process exited before bootstrap completed (code: ${code ?? 'unknown'}).`)));
+                }
+            };
+            timeout = setTimeout(() => {
+                this.stop();
+                settle(() => reject(new Error(`Tor bootstrap timed out after ${this.bootstrapTimeoutMs} ms.`)));
+            }, this.bootstrapTimeoutMs);
+            torProcess.stdout?.on('data', onStdout);
+            torProcess.on('error', onError);
+            torProcess.on('close', onClose);
+        }).finally(() => {
+            this.startupPromise = null;
+        });
+        return this.startupPromise;
+    }
+    stop() {
+        if (!this.isWindows) {
+            return;
+        }
+        if (!this.torProcess) {
+            this.resetState();
+            return;
+        }
+        if (!this.torProcess.killed) {
+            this.torProcess.kill();
+        }
+        this.resetState();
+    }
+    createAgent(proxyUrl) {
+        return new socks_proxy_agent_1.SocksProxyAgent(proxyUrl);
+    }
+    resetState() {
+        this.torProcess = null;
+        this.isReady = false;
+    }
+}
+exports.TorProcessManager = TorProcessManager;
+//# sourceMappingURL=TorProcessManager.js.map

package/build/TorProcessManager.js.map

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

package/build/index.d.ts

@@ -0,0 +1,9 @@
+import { RequestInit, Response } from 'node-fetch';
+import { TorProcessManager } from './TorProcessManager';
+export interface ProxiedFetchOptions extends RequestInit {
+    killTor?: boolean;
+    proxyUrl?: string;
+}
+export declare function proxiedFetch(url: string, options?: ProxiedFetchOptions): Promise<Response>;
+export { proxiedFetch as fetch, TorProcessManager };
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAsB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBhG;AAED,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,iBAAiB,EAAE,CAAC"}

package/build/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorProcessManager = void 0;
+exports.proxiedFetch = proxiedFetch;
+exports.fetch = proxiedFetch;
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const TorProcessManager_1 = require("./TorProcessManager");
+Object.defineProperty(exports, "TorProcessManager", { enumerable: true, get: function () { return TorProcessManager_1.TorProcessManager; } });
+const torProcessManager = new TorProcessManager_1.TorProcessManager();
+async function proxiedFetch(url, options) {
+    const { killTor = true, proxyUrl = 'socks5h://127.0.0.1:9050', ...fetchOptions } = options ?? {};
+    await torProcessManager.start();
+    try {
+        return await (0, node_fetch_1.default)(url, {
+            ...fetchOptions,
+            agent: torProcessManager.createAgent(proxyUrl)
+        });
+    }
+    catch (error) {
+        console.error(`Error fetching ${url} through proxy ${proxyUrl}:`, error);
+        throw error;
+    }
+    finally {
+        if (killTor) {
+            torProcessManager.stop();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAWA,oCAsBC;AAEwB,6BAAK;AAnC9B,4DAAkE;AAElE,2DAAwD;AAiCxB,kGAjCvB,qCAAiB,OAiCuB;AA1BjD,MAAM,iBAAiB,GAAG,IAAI,qCAAiB,EAAE,CAAC;AAE3C,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,OAA6B;IACzE,MAAM,EACF,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,0BAA0B,EACrC,GAAG,YAAY,EAClB,GAAG,OAAO,IAAI,EAAE,CAAC;IAElB,MAAM,iBAAiB,CAAC,KAAK,EAAE,CAAC;IAEhC,IAAI,CAAC;QACD,OAAO,MAAM,IAAA,oBAAa,EAAC,GAAG,EAAE;YAC5B,GAAG,YAAY;YACf,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,QAAQ,CAAC;SACjD,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,kBAAkB,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,IAAI,OAAO,EAAE,CAAC;YACV,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;AACL,CAAC"}

package/build/tests/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/build/tests/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/tests/test.ts"],"names":[],"mappings":""}

package/build/tests/test.js

@@ -0,0 +1,25 @@
+"use strict";
+// proxiedFetch("https://api.ipify.org?format=json")
+// .then((response) => response.json() as Promise<{ ip: string }>)
+// .then((data: { ip: string }) => {
+//     console.log("Your IP address is:", data.ip);
+// })
+// .catch((error) => {
+//     console.error("Error fetching IP address:", error);
+// });
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+async function func() {
+    const response = await (0, __1.proxiedFetch)("https://api.ipify.org?format=json", { killTor: false });
+    const data = await response.text();
+    console.log("Your IP address is:", data);
+}
+async function test() {
+    for (let i = 0; i < 5; i++) {
+        await func();
+    }
+}
+test().catch((error) => {
+    console.error("Error in test:", error);
+});
+//# sourceMappingURL=test.js.map

package/build/tests/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/tests/test.ts"],"names":[],"mappings":";AACA,oDAAoD;AACpD,kEAAkE;AAClE,oCAAoC;AACpC,mDAAmD;AACnD,KAAK;AACL,sBAAsB;AACtB,0DAA0D;AAC1D,MAAM;;AAEN,0BAAkC;AAElC,KAAK,UAAU,IAAI;IACf,MAAM,QAAQ,GAAG,MAAM,IAAA,gBAAY,EAAC,mCAAmC,EAAE,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,IAAI;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,EAAE,CAAC;IACjB,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "fetch-tor-proxy",
+  "version": "1.0.0",
+  "description": "Allows fetching resources through a proxy server, with support for authentication and custom headers.",
+  "main": "src/index.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "npx rimraf -rf dist build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.35",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "node-fetch": "^3.3.2",
+    "socks-proxy-agent": "^8.0.5"
+  },
+  "type": "module"
+}

package/src/TorProcessManager.ts

@@ -0,0 +1,126 @@
+import { ChildProcess, spawn } from 'child_process';
+import path from 'path';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+
+export interface TorProcessManagerOptions {
+    torBinaryPath?: string;
+    torConfigPath?: string;
+    bootstrapTimeoutMs?: number;
+}
+
+export class TorProcessManager {
+    private readonly torBinaryPath: string;
+    private readonly torConfigPath: string;
+    private readonly bootstrapTimeoutMs: number;
+
+    private torProcess: ChildProcess | null = null;
+    private isReady = false;
+    private startupPromise: Promise<void> | null = null;
+    private readonly isWindows = process.platform === 'win32';
+
+    constructor(options?: TorProcessManagerOptions) {
+        this.torBinaryPath = options?.torBinaryPath ?? path.join(__dirname, '..', 'tor-expert-bundle', 'tor');
+        this.torConfigPath = options?.torConfigPath ?? path.join(__dirname, '..', 'tor-expert-bundle', 'torrc');
+        this.bootstrapTimeoutMs = options?.bootstrapTimeoutMs ?? 30_000;
+    }
+
+    async start(): Promise<void> {
+        if (!this.isWindows) {
+            // On Linux/macOS, assume Tor is managed externally (service/container/etc.).
+            this.isReady = true;
+            return;
+        }
+
+        if (this.isReady) {
+            return;
+        }
+
+        if (this.startupPromise) {
+            return this.startupPromise;
+        }
+
+        this.startupPromise = new Promise<void>((resolve, reject) => {
+            const torProcess = spawn(this.torBinaryPath, ['-f', this.torConfigPath]);
+            this.torProcess = torProcess;
+
+            let settled = false;
+            let timeout: NodeJS.Timeout;
+
+            const cleanup = () => {
+                clearTimeout(timeout);
+                torProcess.stdout?.removeListener('data', onStdout);
+                torProcess.removeListener('error', onError);
+                torProcess.removeListener('close', onClose);
+            };
+
+            const settle = (fn: () => void) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                fn();
+            };
+
+            const onStdout = (data: Buffer) => {
+                if (data.toString().includes('Bootstrapped 100%')) {
+                    this.isReady = true;
+                    settle(() => resolve());
+                }
+            };
+
+            const onError = (error: Error) => {
+                this.resetState();
+                settle(() => reject(error));
+            };
+
+            const onClose = (code: number | null) => {
+                const exitedBeforeReady = !this.isReady;
+                this.resetState();
+
+                if (exitedBeforeReady) {
+                    settle(() => reject(new Error(`Tor process exited before bootstrap completed (code: ${code ?? 'unknown'}).`)));
+                }
+            };
+
+            timeout = setTimeout(() => {
+                this.stop();
+                settle(() => reject(new Error(`Tor bootstrap timed out after ${this.bootstrapTimeoutMs} ms.`)));
+            }, this.bootstrapTimeoutMs);
+
+            torProcess.stdout?.on('data', onStdout);
+            torProcess.on('error', onError);
+            torProcess.on('close', onClose);
+        }).finally(() => {
+            this.startupPromise = null;
+        });
+
+        return this.startupPromise;
+    }
+
+    stop(): void {
+        if (!this.isWindows) {
+            return;
+        }
+
+        if (!this.torProcess) {
+            this.resetState();
+            return;
+        }
+
+        if (!this.torProcess.killed) {
+            this.torProcess.kill();
+        }
+
+        this.resetState();
+    }
+
+    createAgent(proxyUrl: string): SocksProxyAgent {
+        return new SocksProxyAgent(proxyUrl);
+    }
+
+    private resetState(): void {
+        this.torProcess = null;
+        this.isReady = false;
+    }
+}

package/src/index.ts

@@ -0,0 +1,37 @@
+import originalFetch, { RequestInit, Response } from 'node-fetch';
+
+import { TorProcessManager } from './TorProcessManager';
+
+export interface ProxiedFetchOptions extends RequestInit {
+    killTor?: boolean;
+    proxyUrl?: string;
+}
+
+const torProcessManager = new TorProcessManager();
+
+export async function proxiedFetch(url: string, options?: ProxiedFetchOptions): Promise<Response> {
+    const {
+        killTor = true,
+        proxyUrl = 'socks5h://127.0.0.1:9050',
+        ...fetchOptions
+    } = options ?? {};
+
+    await torProcessManager.start();
+
+    try {
+        return await originalFetch(url, {
+            ...fetchOptions,
+            agent: torProcessManager.createAgent(proxyUrl)
+        });
+    } catch (error) {
+        console.error(`Error fetching ${url} through proxy ${proxyUrl}:`, error);
+        throw error;
+    } finally {
+        if (killTor) {
+            torProcessManager.stop();
+        }
+    }
+}
+
+export { proxiedFetch as fetch, TorProcessManager };
+

package/src/tests/test.ts

@@ -0,0 +1,27 @@
+
+// proxiedFetch("https://api.ipify.org?format=json")
+// .then((response) => response.json() as Promise<{ ip: string }>)
+// .then((data: { ip: string }) => {
+//     console.log("Your IP address is:", data.ip);
+// })
+// .catch((error) => {
+//     console.error("Error fetching IP address:", error);
+// });
+
+import { proxiedFetch } from "..";
+
+async function func() {
+    const response = await proxiedFetch("https://api.ipify.org?format=json", {killTor: false});
+    const data = await response.text();
+    console.log("Your IP address is:", data);
+}
+
+async function test() {
+    for (let i = 0; i < 5; i++) {
+        await func();
+    }
+}
+
+test().catch((error) => {
+    console.error("Error in test:", error);
+});