arn-browser 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",

package/src/utility/proxy-utility/custom-proxy.d.ts

@@ -91,3 +91,38 @@ export function isProxyAlive(proxyHost: string, proxyPort: number): Promise<stri
  * @param timeout - Request timeout in ms.
  */
 export function nativeGet(url: string, agent?: any, timeout?: number): Promise<string>;
+
+/**
+ * Proxy configuration object returned by fetchAwsProxy.
+ */
+export interface ProxyConfig {
+	type: "socks5" | "http";
+	host: string;
+	port: number;
+	user: string | null;
+	pass: string | null;
+}
+
+/**
+ * Parameters for fetchAwsProxy function.
+ */
+export interface FetchAwsProxyParams {
+	instance_name: string;
+	/**
+	 * If true, uses getActiveProxyWithStartStop (hard reset).
+	 * If false, uses getActiveProxy (IP cycling).
+	 * @default true
+	 */
+	useStartStop?: boolean;
+	/**
+	 * The proxy type. Determines the port (socks5: 10001, http: 9001).
+	 * @default 'socks5'
+	 */
+	proxy_type?: "socks5" | "http";
+}
+
+/**
+ * Fetches an active AWS proxy and returns it in a standardized format.
+ * @returns The proxy configuration object or null if not found.
+ */
+export function fetchAwsProxy(params: FetchAwsProxyParams): Promise<ProxyConfig | null>;

package/src/utility/proxy-utility/custom-proxy.js

@@ -623,3 +623,43 @@ export async function isProxyAlive(proxyHost, proxyPort) {
 
 	return null;
 }
+
+// ==========================================
+// SECTION 8: HIGH-LEVEL PROXY FETCH
+// ==========================================
+
+/**
+ * @typedef {Object} ProxyConfig
+ * @property {'socks5'|'http'} type - The proxy type.
+ * @property {string} host - The proxy host IP address.
+ * @property {number} port - The proxy port.
+ * @property {string|null} user - The proxy username (null if not required).
+ * @property {string|null} pass - The proxy password (null if not required).
+ */
+
+/**
+ * Fetches an active AWS proxy and returns it in a standardized format.
+ *
+ * @param {Object} params - The parameters object.
+ * @param {string} params.instance_name - The name of the EC2 instance.
+ * @param {boolean} [params.useStartStop=true] - If true, uses getActiveProxyWithStartStop (hard reset).
+ *                                               If false, uses getActiveProxy (IP cycling).
+ * @param {'socks5'|'http'} [params.proxy_type='socks5'] - The proxy type (socks5: port 10001, http: port 9001).
+ * @returns {Promise<ProxyConfig|null>} - The proxy configuration object or null if not found.
+ */
+export const fetchAwsProxy = async ({ instance_name, useStartStop = true, proxy_type = "socks5" }) => {
+	let getawsproxy;
+	if (useStartStop) {
+		getawsproxy = await getActiveProxyWithStartStop({ instance_name: instance_name });
+	} else {
+		getawsproxy = await getActiveProxy({ instance_name: instance_name });
+	}
+	if (!getawsproxy) {
+		console.log("Aws proxy not found");
+		return null;
+	}
+	/** @type {ProxyConfig} */
+	const port = proxy_type === "socks5" ? 10001 : 9001;
+	let temp_proxy = { type: proxy_type, host: getawsproxy, port: port, user: null, pass: null };
+	return temp_proxy;
+};