proxy-rotator-js 1.1.1 → 1.3.1

package/dist/cjs/src/Queue.cjs

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class Queue {
+    constructor() {
+        this.items = {};
+        this.frontIndex = 0;
+        this.backIndex = 0;
+    }
+    enqueue(item) {
+        this.items[this.backIndex] = item;
+        this.backIndex++;
+        return item;
+    }
+    dequeue() {
+        const item = this.items[this.frontIndex];
+        delete this.items[this.frontIndex];
+        this.frontIndex++;
+        return item;
+    }
+    remove(index) {
+        if (index < this.frontIndex || index >= this.backIndex) {
+            return 'Invalid index';
+        }
+        const item = this.items[index];
+        for (let i = index; i < this.backIndex; i++) {
+            this.items[i] = this.items[i + 1];
+        }
+        delete this.items[this.backIndex - 1];
+        this.backIndex--;
+        return item;
+    }
+    /** Remove item at position (0 = first in queue). */
+    removeAt(position) {
+        if (position < 0 || position >= this.size) {
+            return 'Invalid index';
+        }
+        return this.remove(this.frontIndex + position);
+    }
+    peek() {
+        return this.items[this.frontIndex];
+    }
+    printQueue() {
+        return this.items;
+    }
+    toArray() {
+        const arr = [];
+        for (let i = this.frontIndex; i < this.backIndex; i++) {
+            arr.push(this.items[i]);
+        }
+        return arr;
+    }
+    toObject() {
+        const obj = {};
+        for (let i = this.frontIndex; i < this.backIndex; i++) {
+            obj[i] = this.items[i];
+        }
+        return obj;
+    }
+    get size() {
+        return this.backIndex - this.frontIndex;
+    }
+}
+exports.default = Queue;
+//# sourceMappingURL=Queue.js.map

package/dist/cjs/src/Queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../../src/Queue.ts"],"names":[],"mappings":";;AAAA,MAAqB,KAAK;IAA1B;QACU,UAAK,GAAsB,EAAE,CAAC;QAC9B,eAAU,GAAG,CAAC,CAAC;QACf,cAAS,GAAG,CAAC,CAAC;IA+DxB,CAAC;IA7DC,OAAO,CAAC,IAAO;QACb,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvD,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,QAAQ,CAAC,QAAgB;QACvB,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO,eAAe,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAAsB,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;CACF;AAlED,wBAkEC"}

package/dist/cjs/src/utils/geo.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCountryFromIp = getCountryFromIp;
+const maxmind_1 = __importDefault(require("maxmind"));
+const path_1 = __importDefault(require("path"));
+function getDbPath() {
+    return (process.env.GEO_DB_PATH ||
+        path_1.default.join(process.cwd(), 'assets', 'GeoLite2-Country.mmdb'));
+}
+let _reader = null;
+async function getReader() {
+    if (!_reader) {
+        _reader = await maxmind_1.default.open(getDbPath());
+    }
+    return _reader;
+}
+async function getCountryFromIp(ip) {
+    const reader = await getReader();
+    const result = reader.get(ip);
+    if (!result?.country)
+        return null;
+    return {
+        iso: result.country.iso_code ?? 'Unknown',
+        name: result.country.names?.en ?? 'Unknown',
+        continent: result.continent?.code ?? 'Unknown',
+    };
+}
+//# sourceMappingURL=geo.js.map

package/dist/cjs/src/utils/geo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../../../../src/utils/geo.ts"],"names":[],"mappings":";;;;;AAyBA,4CAWC;AApCD,sDAAqE;AACrE,gDAAwB;AAExB,SAAS,SAAS;IAChB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,IAAI,OAAO,GAAmC,IAAI,CAAC;AAEnD,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,MAAM,iBAAO,CAAC,IAAI,CAAkB,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAQM,KAAK,UAAU,gBAAgB,CAAC,EAAU;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAE9B,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,IAAI,CAAC;IAElC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS;QACzC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,SAAS;QAC3C,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,SAAS;KAC/C,CAAC;AACJ,CAAC"}

package/dist/cjs/src/utils/makeRequestWithProxy.cjs

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = makeRequestWithProxy;
+const axios_1 = __importDefault(require("axios"));
+async function makeRequestWithProxy(proxy, options = {}) {
+    try {
+        const response = await axios_1.default.get('https://api.ipify.org?format=json', {
+            proxy: {
+                host: proxy.host,
+                port: Number(proxy.port),
+                protocol: 'http',
+            },
+        });
+        if (!options.quiet) {
+            console.log(response.data);
+        }
+        return response.data;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=makeRequestWithProxy.js.map

package/dist/cjs/src/utils/makeRequestWithProxy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeRequestWithProxy.js","sourceRoot":"","sources":["../../../../src/utils/makeRequestWithProxy.ts"],"names":[],"mappings":";;;;;AAaA,uCAmBC;AAhCD,kDAA0B;AAaX,KAAK,UAAU,oBAAoB,CAChD,KAAkB,EAClB,UAAuC,EAAE;IAEzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,mCAAmC,EAAE;YACpE,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;gBACxB,QAAQ,EAAE,MAAM;aACjB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,QAAQ,CAAC,IAAsB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import ProxyRotator from './src/ProxyRotator.js';
+import Proxy from './src/Proxy.js';
+export default ProxyRotator;
+export { ProxyRotator, Proxy };
+export type { ProxyRotatorOptions, ReturnAs, PoolStatus, ProxyTestResult, ProxyTestResults, } from './src/ProxyRotator.js';
+export type { ProxyStatus, ProxyInfo, ProxyObj } from './src/Proxy.js';
+export type { GeoCountry } from './src/utils/geo.js';
+export type { ProxyConfig } from './src/utils/makeRequestWithProxy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAEnC,eAAe,YAAY,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAE/B,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import ProxyRotator from './src/ProxyRotator.js';
+import Proxy from './src/Proxy.js';
+export default ProxyRotator;
+export { ProxyRotator, Proxy };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAEnC,eAAe,YAAY,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/dist/src/Proxy.d.ts

@@ -0,0 +1,44 @@
+import type { GeoCountry } from './utils/geo.js';
+export type ProxyStatus = 'new' | 'alive' | 'dead';
+export interface ProxyInfo {
+    protocol: string | null;
+    ip: string;
+    host: string;
+    port: string;
+    country?: GeoCountry | null;
+}
+export interface ProxyObj extends ProxyInfo {
+    status: ProxyStatus;
+    changeTimeStamp: number;
+}
+export default class Proxy {
+    readonly protocol: string | null;
+    readonly ip: string;
+    readonly host: string;
+    readonly port: string;
+    readonly proxy: string;
+    status: ProxyStatus;
+    changeTimeStamp: number;
+    country: GeoCountry | null;
+    constructor(proxy: string, protocol?: string | null, assumeAlive?: boolean, country?: GeoCountry | null);
+    toString(): string;
+    get(): ProxyInfo;
+    obj(): ProxyObj;
+    setCountry(country: GeoCountry | null): void;
+    kill(): void;
+    setDead(): void;
+    setAlive(): void;
+    setNew(): void;
+    isDead(): boolean;
+    isAlive(): boolean;
+    isNew(): boolean;
+    revive(): void;
+    reset(): void;
+    equals(proxy: string | Proxy): boolean;
+    timeSinceStatusChange(): number;
+    print(): void;
+    getIp(): string;
+    getPort(): string;
+    getProtocol(): string | null;
+}
+//# sourceMappingURL=Proxy.d.ts.map

package/dist/src/Proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Proxy.d.ts","sourceRoot":"","sources":["../../src/Proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAQ;gBAGhC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,WAAW,GAAE,OAAe,EAC5B,OAAO,GAAE,UAAU,GAAG,IAAW;IAmBnC,QAAQ,IAAI,MAAM;IAIlB,GAAG,IAAI,SAAS;IAUhB,GAAG,IAAI,QAAQ;IAYf,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAI5C,IAAI,IAAI,IAAI;IAKZ,OAAO,IAAI,IAAI;IAKf,QAAQ,IAAI,IAAI;IAKhB,MAAM,IAAI,IAAI;IAKd,MAAM,IAAI,OAAO;IAIjB,OAAO,IAAI,OAAO;IAIlB,KAAK,IAAI,OAAO;IAIhB,MAAM,IAAI,IAAI;IAKd,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO;IAKtC,qBAAqB,IAAI,MAAM;IAI/B,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,MAAM;IAIf,OAAO,IAAI,MAAM;IAIjB,WAAW,IAAI,MAAM,GAAG,IAAI;CAG7B"}

package/dist/src/Proxy.js

@@ -0,0 +1,100 @@
+export default class Proxy {
+    constructor(proxy, protocol = null, assumeAlive = false, country = null) {
+        this.country = null;
+        if (proxy.includes('://')) {
+            this.protocol = proxy.split('://')[0];
+            this.ip = proxy.split('://')[1].split(':')[0];
+            this.host = this.ip;
+            this.port = proxy.split('://')[1].split(':')[1];
+        }
+        else {
+            this.protocol = protocol;
+            this.ip = proxy.split(':')[0];
+            this.host = this.ip;
+            this.port = proxy.split(':')[1];
+        }
+        this.proxy = `${this.protocol ? this.protocol + '://' : ''}${this.ip}:${this.port}`;
+        this.status = assumeAlive ? 'alive' : 'new';
+        this.changeTimeStamp = Date.now();
+        this.country = country ?? null;
+    }
+    toString() {
+        return `${this.protocol ? this.protocol + '://' : ''}${this.ip}:${this.port}`;
+    }
+    get() {
+        return {
+            protocol: this.protocol,
+            ip: this.ip,
+            host: this.host,
+            port: this.port,
+            country: this.country ?? undefined,
+        };
+    }
+    obj() {
+        return {
+            protocol: this.protocol,
+            ip: this.ip,
+            host: this.host,
+            port: this.port,
+            status: this.status,
+            changeTimeStamp: this.changeTimeStamp,
+            country: this.country ?? undefined,
+        };
+    }
+    setCountry(country) {
+        this.country = country;
+    }
+    kill() {
+        this.status = 'dead';
+        this.changeTimeStamp = Date.now();
+    }
+    setDead() {
+        this.status = 'dead';
+        this.changeTimeStamp = Date.now();
+    }
+    setAlive() {
+        this.status = 'alive';
+        this.changeTimeStamp = Date.now();
+    }
+    setNew() {
+        this.status = 'new';
+        this.changeTimeStamp = Date.now();
+    }
+    isDead() {
+        return this.status === 'dead';
+    }
+    isAlive() {
+        return this.status === 'alive';
+    }
+    isNew() {
+        return this.status === 'new';
+    }
+    revive() {
+        this.status = 'alive';
+        this.changeTimeStamp = Date.now();
+    }
+    reset() {
+        this.status = 'new';
+        this.changeTimeStamp = Date.now();
+    }
+    equals(proxy) {
+        const other = typeof proxy === 'string' ? new Proxy(proxy) : proxy;
+        return this.ip === other.ip && this.port === other.port;
+    }
+    timeSinceStatusChange() {
+        return Date.now() - this.changeTimeStamp;
+    }
+    print() {
+        console.log(this.get());
+    }
+    getIp() {
+        return this.ip;
+    }
+    getPort() {
+        return this.port;
+    }
+    getProtocol() {
+        return this.protocol;
+    }
+}
+//# sourceMappingURL=Proxy.js.map

package/dist/src/Proxy.js.map

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

package/dist/src/ProxyRotator.d.ts

@@ -0,0 +1,104 @@
+import Proxy from './Proxy.js';
+import type { ProxyObj } from './Proxy.js';
+export type ReturnAs = 'string' | 'object';
+/** Result from a single proxy test. */
+export interface ProxyTestResult {
+    proxy: string;
+    working: boolean;
+    expectedIp: string;
+    actualIp: string | null;
+    error?: string;
+}
+/** Result from test_proxies(). */
+export interface ProxyTestResults {
+    results: ProxyTestResult[];
+    summary: {
+        total: number;
+        working: number;
+        notWorking: number;
+    };
+}
+/** Status of the pool returned by status(). */
+export interface PoolStatus {
+    pool: {
+        size: number;
+        proxies: string[];
+    };
+    graveyard: {
+        size: number;
+        proxies: string[];
+    };
+    config: {
+        revive_timer: number;
+        returnAs: ReturnAs;
+        protocol: string | null;
+        shuffle: boolean;
+        assume_aliveness: boolean;
+        check_on_next: boolean;
+        fetchGeo: boolean;
+    };
+}
+export interface ProxyRotatorOptions {
+    returnAs?: ReturnAs | 'str' | 'obj';
+    revive_timer?: number;
+    shuffle?: boolean;
+    protocol?: string | null;
+    assume_aliveness?: boolean;
+    check_on_next?: boolean;
+    /** If true, fetches country geolocation when adding proxies. Default true. */
+    fetchGeo?: boolean;
+}
+export default class ProxyRotator {
+    private pool;
+    private graveyard;
+    revive_timer: number;
+    returnAs: ReturnAs;
+    protocol: string | null;
+    shuffle: boolean;
+    assume_aliveness: boolean;
+    check_on_next: boolean;
+    fetchGeo: boolean;
+    constructor(proxies?: null | string | string[], options?: ProxyRotatorOptions);
+    getGraveyard(): string[];
+    getGraveyardSize(): number;
+    getPool(): string[];
+    getPoolSize(): number;
+    /** Returns the status of the pool as a JSON-serializable object. */
+    status(): PoolStatus;
+    add(proxies: string | string[]): Promise<void>;
+    /** Parse a file of proxies (newline-, space-, or comma-separated) and add each to the pool. */
+    add_file(filename: string): Promise<void>;
+    /** Fetch country geolocation for all proxies in pool and graveyard. */
+    refreshGeo(): Promise<void>;
+    private _add;
+    /** Treat a string as either a file path (add all proxies from file) or a single proxy "ip:port" / "protocol://ip:port". */
+    private _processOne;
+    /** Sync add used by constructor (no geo). Use add() for geo lookup. */
+    private _addSync;
+    /** True if the string is an existing file path. */
+    private _isFilePath;
+    remove(proxy: string | string[]): void;
+    private _remove;
+    getAlive(): string | undefined;
+    setAlive(proxy: string | Proxy): void;
+    resurect(proxy: string | Proxy): void;
+    setDead(proxy: string | Proxy): void;
+    kill(proxy: string | Proxy): void;
+    next(options?: {
+        returnAs?: ReturnAs | 'str' | 'obj';
+    }): string | ProxyObj | null;
+    private _shuffleArray;
+    private _handleReturnAsInput;
+    private _parseFile;
+    private _isArray;
+    private _resurection;
+    test_proxies(options?: {
+        /** "console" prints to stdout; "json" returns results. Default "console". */
+        output?: 'console' | 'json';
+    }): Promise<void | ProxyTestResults>;
+    test: (options?: {
+        /** "console" prints to stdout; "json" returns results. Default "console". */
+        output?: "console" | "json";
+    }) => Promise<void | ProxyTestResults>;
+}
+//# sourceMappingURL=ProxyRotator.d.ts.map

package/dist/src/ProxyRotator.d.ts.map

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