entrox-bypass 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,250 @@
-# Temporary Holding Version
+# playwright-captcha
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> AI-powered automated CAPTCHA solving for Playwright browser automation
+
+[![npm version](https://img.shields.io/npm/v/playwright-captcha.svg)](https://www.npmjs.com/package/playwright-captcha)
+[![License: ISC](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
+
+Automated login & CAPTCHA solving built on [Playwright](https://playwright.dev/), [LangChain](https://www.langchain.com/), and Cloudinary. Solves CAPTCHAs in real-time using AI image recognition via OpenRouter (Google Gemma).
+
+## Features
+
+- 🤖 **AI-Powered CAPTCHA Solving** — Uses LLMs to read and solve CAPTCHA images automatically
+- 🔐 **Automated Login Flow** — Full end-to-end browser automation with credentials
+- 📦 **Dual Module Support** — Works with both ESM (`import`) and CJS (`require`)
+- ✍️ **TypeScript First** — Full type definitions included
+- ☁️ **Cloudinary Integration** — Efficient image upload & processing pipeline
+- 🧩 **Modular Design** — Use individual functions or the full automation suite
+
+## Installation
+
+```bash
+npm install playwright-captcha playwright
+npx playwright install chromium
+```
+
+## Quick Start
+
+### Environment Variables
+
+Create a `.env` file with your credentials:
+
+```env
+# Required: Login credentials
+EMAIL=your_email@example.com
+PASSWORD=your_password
+
+# Required: AI CAPTCHA solver
+OPENROUTER_API_KEY=sk-or-v1-your-api-key
+
+# Required: Image hosting
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+```
+
+### Full Automated Login
+
+```javascript
+import { automateLogin } from 'playwright-captcha';
+
+(async () => {
+  const result = await automateLogin({
+    url: 'https://example.com/login',
+    headless: false,                    // Set true for server environments
+    outputScreenshotPath: './result.png' // Optional screenshot after login
+  });
+
+  if (result.success) {
+    console.log('Logged in successfully!');
+    console.log('Current URL:', result.url);
+    console.log('Page title:', result.title);
+  } else {
+    console.error('Login failed:', result.error);
+  }
+})();
+```
+
+### Solve CAPTCHA Manually
+
+```javascript
+import { chromium } from 'playwright';
+import { solveCaptchaFromPage } from 'playwright-captcha';
+
+const browser = await chromium.launch();
+const page = await browser.newPage();
+
+await page.goto('https://example.com/login');
+// ... fill form fields ...
+
+// Extract CAPTCHA text from the page
+const captcha = await solveCaptchaFromPage(page);
+console.log('CAPTCHA text:', captcha.text);       // e.g., "X7K9P"
+console.log('Description:', captcha.description);
+
+await browser.close();
+```
+
+## API Reference
+
+### `automateLogin(options)`
+
+Automates the entire login process including CAPTCHA solving.
+
+**Parameters:**
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `url` | `string` | ✅ Yes | — | Target login page URL |
+| `loginSelector` | `string` | ❌ No | `#login` | CSS selector for email/login field |
+| `passwordSelector` | `string` | ❌ No | `#password` | CSS selector for password field |
+| `captchaInputSelector` | `string` | ❌ No | `#captcha` | CSS selector for CAPTCHA input field |
+| `submitButtonSelector` | `string` | ❌ No | `button[type='submit']` | CSS selector for submit button |
+| `headless` | `boolean` | ❌ No | `false` | Run browser in headless mode |
+| `outputScreenshotPath` | `string` | ❌ No | — | Path to save post-login screenshot |
+| `screenshotDelay` | `number` | ❌ No | — | Milliseconds to wait before screenshot |
+
+**Returns:** `Promise<LoginResult>`
+
+```typescript
+interface LoginResult {
+  success: boolean;
+  url: string;
+  title: string;
+  page: Page;           // Playwright page instance (for further interactions)
+  error?: string;       // Error message if failed
+}
+```
+
+---
+
+### `solveCaptchaFromPage(page, captchaSelector, outputScreenshotPath?)`
+
+Extracts and solves a CAPTCHA image displayed on the page using AI.
+
+**Parameters:**
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `page` | `Page` | ✅ Yes | — | Playwright Page instance |
+| `captchaSelector` | `string` | ❌ No | `img.captcha-image` | CSS selector for the CAPTCHA image |
+| `outputScreenshotPath` | `string` | ❌ No | — | Path to save CAPTCHA screenshot |
+
+**Returns:** `Promise<CaptchaResult>`
+
+```typescript
+interface CaptchaResult {
+  text: string;         // The extracted CAPTCHA text (e.g., "X7K9P")
+  description: string;  // Brief description of the image content
+}
+```
+
+---
+
+## Customization
+
+### Change AI Model
+
+```env
+# In your .env file
+LLM_MODEL=google/gemma-4-26b-a4b-it
+```
+
+Supported models (via OpenRouter):
+- `google/gemma-4-26b-a4b-it` (default)
+- `openai/gpt-4o`
+- `anthropic/claude-3.5-sonnet`
+- See [OpenRouter](https://openrouter.ai/models) for more options
+
+### Custom Selectors
+
+If your login page uses different element selectors:
+
+```javascript
+await automateLogin({
+  url: 'https://example.com/signin',
+  loginSelector: '#email-input',
+  passwordSelector: '#password-input',
+  captchaInputSelector: '#captcha-code',
+  submitButtonSelector: '.btn-signin'
+});
+```
+
+## Architecture
+
+```
+┌─────────────┐    ┌──────────────┐    ┌─────────────┐    ┌──────────┐
+│ Playwright  │───▶│ Cloudinary   │───▶│ OpenRouter   │───▶│   JSON   │
+│ Browser     │    │ (Upload IMG) │    │ (Gemma LLM)  │    │ Response │
+└─────────────┘    └──────────────┘    └─────────────┘    └──────────┘
+        │                                                       │
+        ▼                                                       ▼
+┌─────────────┐                                      ┌──────────────────┐
+│ Fill Form   │◀─────────────────────────────────────│ Extract Text     │
+│ Submit      │                                      └──────────────────┘
+└─────────────┘
+```
+
+## Error Handling
+
+All functions throw descriptive errors:
+
+```javascript
+try {
+  await automateLogin({ url: 'https://example.com/login' });
+} catch (error) {
+  if (error.name === 'LlmError') {
+    console.error('AI service error:', error.message);
+  } else if (error.name === 'CloudinaryError') {
+    console.error('Upload failed:', error.message);
+  } else {
+    console.error('Browser automation error:', error.message);
+  }
+}
+```
+
+## Development
+
+```bash
+# Clone and install dependencies
+git clone <repo-url>
+cd playwright-captcha
+npm install
+
+# Build bundles (ESM + CJS)
+npm run build
+
+# Run tests
+npm test
+
+# TypeScript type checking
+npx tsc --noEmit
+```
+
+## Project Structure
+
+```
+playwright-captcha/
+├── src/
+│   ├── index.ts          # Public API exports
+│   ├── login.ts          # automateLogin implementation
+│   ├── captchaSolve.ts   # CAPTCHA extraction & solving
+│   ├── cloudinary.ts     # Cloudinary upload config
+│   └── llm.ts            # OpenRouter / Gemma integration
+├── types/
+│   └── index.d.ts        # TypeScript declarations
+├── dist/                 # Built packages (ESM + CJS)
+└── test/                 # Test suite
+```
+
+## License
+
+ISC
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome! Feel free to submit a PR.
+
+---
+
+> ⚠️ **Note**: Always use this library responsibly. Ensure you have authorization to automate interactions with any website you're targeting. Respect robots.txt and terms of service.

package/dist/index.cjs

@@ -0,0 +1,271 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  automateLogin: () => automateLogin,
+  default: () => index_default,
+  solveCaptchaFromPage: () => solveCaptchaFromPage
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/llm.ts
+var import_config = require("dotenv/config");
+var import_openai = require("@langchain/openai");
+var import_messages = require("@langchain/core/messages");
+var LlmError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LlmError";
+  }
+};
+var model = new import_openai.ChatOpenAI({
+  model: process.env.LLM_MODEL || "google/gemma-4-26b-a4b-it",
+  temperature: 0,
+  apiKey: process.env.OPENROUTER_API_KEY,
+  configuration: {
+    baseURL: "https://openrouter.ai/api/v1"
+  }
+});
+var getImageDetails = async function(image_url) {
+  if (!process.env.OPENROUTER_API_KEY) {
+    throw new LlmError("OPENROUTER_API_KEY environment variable is required");
+  }
+  const response = await model.invoke([
+    new import_messages.HumanMessage({
+      content: [
+        {
+          type: "text",
+          text: `You are a CAPTCHA solving assistant. Analyze the provided image and return the following in strict JSON format:
+- "text": The exact text or characters shown in the CAPTCHA
+- "description": A brief description of what appears in the image
+
+If there is no text in the image, set "text" to "no text found".
+
+Example response:
+{"text": "X7K9P", "description": "Black text on white background showing alphanumeric characters"}
+
+Return ONLY valid JSON with no markdown formatting.`
+        },
+        {
+          type: "image_url",
+          image_url: {
+            url: image_url
+          }
+        }
+      ]
+    })
+  ]);
+  const content = response.content;
+  if (typeof content === "string") {
+    const jsonString = content.replace(/```json\s*/i, "").replace(/```\s*$/, "").trim();
+    try {
+      return JSON.parse(jsonString);
+    } catch (parseError) {
+      throw new LlmError(`Failed to parse LLM response as JSON: ${parseError}`);
+    }
+  }
+  throw new LlmError("Unexpected LLM response format");
+};
+var llm_default = getImageDetails;
+
+// src/cloudinary.ts
+var import_config2 = require("dotenv/config");
+var import_cloudinary = require("cloudinary");
+var CloudinaryError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CloudinaryError";
+  }
+};
+function validateConfig(config2) {
+  const missing = [];
+  if (!config2.cloud_name) missing.push("CLOUDINARY_CLOUD_NAME");
+  if (!config2.api_key) missing.push("CLOUDINARY_API_KEY");
+  if (!config2.api_secret) missing.push("CLOUDINARY_API_SECRET");
+  if (missing.length > 0) {
+    throw new CloudinaryError(`Missing Cloudinary credentials: ${missing.join(", ")}`);
+  }
+}
+function getConfig() {
+  return {
+    cloud_name: process.env.CLOUDINARY_CLOUD_NAME || "",
+    api_key: process.env.CLOUDINARY_API_KEY || "",
+    api_secret: process.env.CLOUDINARY_API_SECRET || ""
+  };
+}
+var config = getConfig();
+validateConfig(config);
+import_cloudinary.v2.config(config);
+var cloudinary_default = import_cloudinary.v2;
+
+// src/captchaSolve.ts
+async function solveCaptchaFromPage(page, captchaSelector = "img.captcha-image", outputScreenshotPath) {
+  const captchaImage = page.locator(captchaSelector);
+  try {
+    await captchaImage.waitFor({ state: "visible" });
+  } catch (error) {
+    throw new Error(`CAPTCHA element not found or not visible. Selector: ${captchaSelector}`);
+  }
+  if (outputScreenshotPath) {
+    await captchaImage.screenshot({ path: outputScreenshotPath });
+  }
+  let imageData;
+  try {
+    imageData = await captchaImage.evaluate(async (img) => {
+      const response = await fetch(img.src);
+      if (!response.ok) {
+        throw new Error(`Image fetch failed: ${response.status}`);
+      }
+      const blob = await response.blob();
+      return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+          const result = reader.result;
+          const base64 = result.split(",")[1];
+          resolve({
+            mimeType: blob.type || "image/png",
+            base64
+          });
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(blob);
+      });
+    });
+  } catch (error) {
+    throw new Error(`Failed to extract CAPTCHA image: ${error}`);
+  }
+  let uploadResult;
+  try {
+    uploadResult = await cloudinary_default.uploader.upload(
+      `data:${imageData.mimeType};base64,${imageData.base64}`,
+      {
+        folder: "playwright-captcha-images",
+        resource_type: "image",
+        type: "auth"
+      }
+    );
+  } catch (error) {
+    throw new Error(`Failed to upload CAPTCHA image to Cloudinary: ${error}`);
+  }
+  const imageUrl = uploadResult.secure_url;
+  try {
+    const result = await llm_default(imageUrl);
+    return result;
+  } catch (error) {
+    throw new Error(`Failed to solve CAPTCHA using AI: ${error}`);
+  }
+}
+
+// src/login.ts
+var import_playwright = require("playwright");
+async function validateEnv() {
+  const missing = [];
+  if (!process.env.EMAIL || process.env.EMAIL === "dev@example.com") {
+    missing.push("EMAIL - Set to actual email address");
+  }
+  if (!process.env.PASSWORD || process.env.PASSWORD === "22222222") {
+    missing.push("PASSWORD - Set to actual password");
+  }
+  if (missing.length > 0) {
+    console.warn("Warning: The following environment variables are set to defaults or missing:");
+    missing.forEach((m) => console.warn(`  - ${m}`));
+    console.warn("Please update your .env file with real credentials.");
+  }
+}
+async function automateLogin(options) {
+  let browser = null;
+  let context = null;
+  let page = null;
+  try {
+    await validateEnv();
+    browser = await import_playwright.chromium.launch({
+      headless: options.headless ?? false
+    });
+    context = await browser.newContext();
+    page = await context.newPage();
+    await page.goto(options.url, { waitUntil: "domcontentloaded" });
+    const loginSelector = options.loginSelector || "#login";
+    const passwordSelector = options.passwordSelector || "#password";
+    const captchaSelector = "img.captcha-image";
+    const captchaInputSelector = options.captchaInputSelector || "#captcha";
+    const submitButtonSelector = options.submitButtonSelector || "button[type='submit']";
+    await page.locator(loginSelector).fill(process.env.EMAIL || "");
+    await page.locator(passwordSelector).fill(process.env.PASSWORD || "");
+    const captchaResult = await solveCaptchaFromPage(
+      page,
+      captchaSelector,
+      options.outputScreenshotPath ? void 0 : void 0
+    );
+    await page.locator(captchaInputSelector).fill(captchaResult.text);
+    await page.locator(submitButtonSelector).click();
+    try {
+      await page.waitForLoadState("domcontentloaded", { timeout: 15e3 });
+      if (options.screenshotDelay) {
+        await page.waitForTimeout(options.screenshotDelay);
+      }
+      if (options.outputScreenshotPath) {
+        await page.screenshot({ path: options.outputScreenshotPath, fullPage: true });
+      }
+    } catch (error) {
+      console.warn("Warning: Could not wait for post-login state:", error);
+    }
+    return {
+      success: true,
+      url: page.url(),
+      title: await page.title(),
+      page
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    let pageTitle = "";
+    if (page) {
+      try {
+        pageTitle = await page.title();
+      } catch {
+        pageTitle = "failed to get title";
+      }
+    }
+    return {
+      success: false,
+      url: page?.url() || "",
+      title: pageTitle,
+      page,
+      error: errorMessage
+    };
+  } finally {
+    if (browser && !options.headless) {
+      await browser.close().catch(() => {
+      });
+    }
+  }
+}
+
+// src/index.ts
+var index_default = {
+  solveCaptchaFromPage,
+  automateLogin
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  automateLogin,
+  solveCaptchaFromPage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/llm.ts","../src/cloudinary.ts","../src/captchaSolve.ts","../src/login.ts"],"sourcesContent":["import { solveCaptchaFromPage } from \"./captchaSolve.js\";\nimport { automateLogin, LoginOptions, LoginResult } from \"./login.js\";\n\nexport type { CaptchaResult } from \"./llm.js\";\nexport type { LoginOptions, LoginResult } from \"./login.js\";\n\nexport { solveCaptchaFromPage };\nexport { automateLogin };\n\nexport default {\n  solveCaptchaFromPage,\n  automateLogin,\n};\n","import \"dotenv/config\";\nimport { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage } from \"@langchain/core/messages\";\n\ninterface CaptchaResult {\n  text: string;\n  description: string;\n}\n\nclass LlmError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'LlmError';\n  }\n}\n\nconst model = new ChatOpenAI({\n  model: process.env.LLM_MODEL || \"google/gemma-4-26b-a4b-it\",\n  temperature: 0,\n  apiKey: process.env.OPENROUTER_API_KEY,\n  configuration: {\n    baseURL: \"https://openrouter.ai/api/v1\",\n  },\n});\n\nconst getImageDetails = async function (image_url: string): Promise<CaptchaResult> {\n  if (!process.env.OPENROUTER_API_KEY) {\n    throw new LlmError('OPENROUTER_API_KEY environment variable is required');\n  }\n\n  const response = await model.invoke([\n    new HumanMessage({\n      content: [\n        {\n          type: \"text\",\n          text: `You are a CAPTCHA solving assistant. Analyze the provided image and return the following in strict JSON format:\n- \"text\": The exact text or characters shown in the CAPTCHA\n- \"description\": A brief description of what appears in the image\n\nIf there is no text in the image, set \"text\" to \"no text found\".\n\nExample response:\n{\"text\": \"X7K9P\", \"description\": \"Black text on white background showing alphanumeric characters\"}\n\nReturn ONLY valid JSON with no markdown formatting.`,\n        },\n        {\n          type: \"image_url\",\n          image_url: {\n            url: image_url,\n          },\n        },\n      ],\n    }),\n  ]);\n\n  const content = response.content as string | Array<any>;\n  \n  if (typeof content === 'string') {\n    const jsonString = content\n      .replace(/```json\\s*/i, '')\n      .replace(/```\\s*$/, '')\n      .trim();\n    \n    try {\n      return JSON.parse(jsonString);\n    } catch (parseError) {\n      throw new LlmError(`Failed to parse LLM response as JSON: ${parseError}`);\n    }\n  }\n  \n  throw new LlmError('Unexpected LLM response format');\n};\n\nexport default getImageDetails;\nexport type { CaptchaResult };\nexport { LlmError };\n","import 'dotenv/config';\nimport { v2 as cloudinary } from 'cloudinary';\n\ninterface CloudinaryConfig {\n  cloud_name: string;\n  api_key: string;\n  api_secret: string;\n}\n\nclass CloudinaryError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CloudinaryError';\n  }\n}\n\nfunction validateConfig(config: CloudinaryConfig): void {\n  const missing: string[] = [];\n  \n  if (!config.cloud_name) missing.push('CLOUDINARY_CLOUD_NAME');\n  if (!config.api_key) missing.push('CLOUDINARY_API_KEY');\n  if (!config.api_secret) missing.push('CLOUDINARY_API_SECRET');\n  \n  if (missing.length > 0) {\n    throw new CloudinaryError(`Missing Cloudinary credentials: ${missing.join(', ')}`);\n  }\n}\n\nexport interface UploadResult {\n  secure_url: string;\n  public_id: string;\n  format: string;\n  width: number;\n  height: number;\n  bytes: number;\n  resource_type: string;\n  original_filename: string;\n}\n\nexport function getConfig(): CloudinaryConfig {\n  return {\n    cloud_name: process.env.CLOUDINARY_CLOUD_NAME || '',\n    api_key: process.env.CLOUDINARY_API_KEY || '',\n    api_secret: process.env.CLOUDINARY_API_SECRET || '',\n  };\n}\n\nconst config = getConfig();\nvalidateConfig(config);\n\ncloudinary.config(config);\n\nexport default cloudinary;\nexport { CloudinaryError };\n","import { Page } from \"playwright\";\nimport getImageDetails, { CaptchaResult } from \"./llm.js\";\nimport cloudinary from \"./cloudinary.js\";\n\ninterface ScreenshotError extends Error {\n  code: string;\n}\n\nexport async function solveCaptchaFromPage(\n  page: Page,\n  captchaSelector: string = \"img.captcha-image\",\n  outputScreenshotPath?: string\n): Promise<CaptchaResult> {\n  const captchaImage = page.locator(captchaSelector);\n\n  try {\n    await captchaImage.waitFor({ state: \"visible\" });\n  } catch (error) {\n    throw new Error(`CAPTCHA element not found or not visible. Selector: ${captchaSelector}`);\n  }\n\n  if (outputScreenshotPath) {\n    await captchaImage.screenshot({ path: outputScreenshotPath });\n  }\n\n  let imageData: { mimeType: string; base64: string };\n\n  try {\n    imageData = await captchaImage.evaluate(async (img: HTMLImageElement) => {\n      const response = await fetch(img.src);\n\n      if (!response.ok) {\n        throw new Error(`Image fetch failed: ${response.status}`);\n      }\n\n      const blob = await response.blob();\n\n      return new Promise<{ mimeType: string; base64: string }>((resolve, reject) => {\n        const reader = new FileReader();\n\n        reader.onload = () => {\n          const result = reader.result as string;\n          const base64 = result.split(\",\")[1];\n          resolve({\n            mimeType: blob.type || \"image/png\",\n            base64,\n          });\n        };\n\n        reader.onerror = reject;\n        reader.readAsDataURL(blob);\n      });\n    });\n  } catch (error) {\n    throw new Error(`Failed to extract CAPTCHA image: ${error}`);\n  }\n\n  let uploadResult;\n\n  try {\n    uploadResult = await cloudinary.uploader.upload(\n      `data:${imageData.mimeType};base64,${imageData.base64}`,\n      {\n        folder: \"playwright-captcha-images\",\n        resource_type: \"image\",\n        type: \"auth\",\n      }\n    );\n  } catch (error) {\n    throw new Error(`Failed to upload CAPTCHA image to Cloudinary: ${error}`);\n  }\n\n  const imageUrl = uploadResult.secure_url;\n\n  try {\n    const result = await getImageDetails(imageUrl);\n    return result;\n  } catch (error) {\n    throw new Error(`Failed to solve CAPTCHA using AI: ${error}`);\n  }\n}\n","import { chromium, Browser, Page, BrowserContext } from \"playwright\";\nimport { solveCaptchaFromPage } from \"./captchaSolve.js\";\n\nexport interface LoginOptions {\n  url: string;\n  loginSelector?: string;\n  passwordSelector?: string;\n  captchaInputSelector?: string;\n  submitButtonSelector?: string;\n  headless?: boolean;\n  outputScreenshotPath?: string;\n  screenshotDelay?: number;\n}\n\nexport interface LoginResult {\n  success: boolean;\n  url: string;\n  title: string;\n  page: Page;\n  error?: string;\n}\n\nclass BrowserError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BrowserError';\n  }\n}\n\nasync function validateEnv(): Promise<void> {\n  const missing: string[] = [];\n  \n  if (!process.env.EMAIL || process.env.EMAIL === 'dev@example.com') {\n    missing.push('EMAIL - Set to actual email address');\n  }\n  if (!process.env.PASSWORD || process.env.PASSWORD === '22222222') {\n    missing.push('PASSWORD - Set to actual password');\n  }\n  \n  if (missing.length > 0) {\n    console.warn('Warning: The following environment variables are set to defaults or missing:');\n    missing.forEach(m => console.warn(`  - ${m}`));\n    console.warn('Please update your .env file with real credentials.');\n  }\n}\n\nexport async function automateLogin(options: LoginOptions): Promise<LoginResult> {\n  let browser: Browser | null = null;\n  let context: BrowserContext | null = null;\n  let page: Page | null = null;\n\n  try {\n    await validateEnv();\n\n    browser = await chromium.launch({\n      headless: options.headless ?? false,\n    });\n\n    context = await browser.newContext();\n    page = await context.newPage();\n\n    await page.goto(options.url, { waitUntil: \"domcontentloaded\" });\n\n    const loginSelector = options.loginSelector || \"#login\";\n    const passwordSelector = options.passwordSelector || \"#password\";\n    const captchaSelector = \"img.captcha-image\";\n    const captchaInputSelector = options.captchaInputSelector || \"#captcha\";\n    const submitButtonSelector = options.submitButtonSelector || \"button[type='submit']\";\n\n    await page.locator(loginSelector).fill(process.env.EMAIL || \"\");\n    await page.locator(passwordSelector).fill(process.env.PASSWORD || \"\");\n\n    const captchaResult = await solveCaptchaFromPage(\n      page,\n      captchaSelector,\n      options.outputScreenshotPath ? undefined : undefined\n    );\n\n    await page.locator(captchaInputSelector).fill(captchaResult.text);\n    await page.locator(submitButtonSelector).click();\n\n    try {\n      await page.waitForLoadState(\"domcontentloaded\", { timeout: 15000 });\n      \n      if (options.screenshotDelay) {\n        await page.waitForTimeout(options.screenshotDelay);\n      }\n\n      if (options.outputScreenshotPath) {\n        await page.screenshot({ path: options.outputScreenshotPath, fullPage: true });\n      }\n    } catch (error) {\n      console.warn('Warning: Could not wait for post-login state:', error);\n    }\n\n    return {\n      success: true,\n      url: page.url(),\n      title: await page.title(),\n      page,\n    };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    \n    let pageTitle = '';\n    if (page) {\n      try {\n        pageTitle = await page.title();\n      } catch {\n        pageTitle = 'failed to get title';\n      }\n    }\n    \n    return {\n      success: false,\n      url: page?.url() || '',\n      title: pageTitle,\n      page: page!,\n      error: errorMessage,\n    };\n  } finally {\n    if (browser && !options.headless) {\n      await browser.close().catch(() => {});\n    }\n  }\n}\n"],"mappings":"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","names":["import_config","config","cloudinary"]}

package/dist/index.js

@@ -0,0 +1,243 @@
+// src/llm.ts
+import "dotenv/config";
+import { ChatOpenAI } from "@langchain/openai";
+import { HumanMessage } from "@langchain/core/messages";
+var LlmError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LlmError";
+  }
+};
+var model = new ChatOpenAI({
+  model: process.env.LLM_MODEL || "google/gemma-4-26b-a4b-it",
+  temperature: 0,
+  apiKey: process.env.OPENROUTER_API_KEY,
+  configuration: {
+    baseURL: "https://openrouter.ai/api/v1"
+  }
+});
+var getImageDetails = async function(image_url) {
+  if (!process.env.OPENROUTER_API_KEY) {
+    throw new LlmError("OPENROUTER_API_KEY environment variable is required");
+  }
+  const response = await model.invoke([
+    new HumanMessage({
+      content: [
+        {
+          type: "text",
+          text: `You are a CAPTCHA solving assistant. Analyze the provided image and return the following in strict JSON format:
+- "text": The exact text or characters shown in the CAPTCHA
+- "description": A brief description of what appears in the image
+
+If there is no text in the image, set "text" to "no text found".
+
+Example response:
+{"text": "X7K9P", "description": "Black text on white background showing alphanumeric characters"}
+
+Return ONLY valid JSON with no markdown formatting.`
+        },
+        {
+          type: "image_url",
+          image_url: {
+            url: image_url
+          }
+        }
+      ]
+    })
+  ]);
+  const content = response.content;
+  if (typeof content === "string") {
+    const jsonString = content.replace(/```json\s*/i, "").replace(/```\s*$/, "").trim();
+    try {
+      return JSON.parse(jsonString);
+    } catch (parseError) {
+      throw new LlmError(`Failed to parse LLM response as JSON: ${parseError}`);
+    }
+  }
+  throw new LlmError("Unexpected LLM response format");
+};
+var llm_default = getImageDetails;
+
+// src/cloudinary.ts
+import "dotenv/config";
+import { v2 as cloudinary } from "cloudinary";
+var CloudinaryError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CloudinaryError";
+  }
+};
+function validateConfig(config2) {
+  const missing = [];
+  if (!config2.cloud_name) missing.push("CLOUDINARY_CLOUD_NAME");
+  if (!config2.api_key) missing.push("CLOUDINARY_API_KEY");
+  if (!config2.api_secret) missing.push("CLOUDINARY_API_SECRET");
+  if (missing.length > 0) {
+    throw new CloudinaryError(`Missing Cloudinary credentials: ${missing.join(", ")}`);
+  }
+}
+function getConfig() {
+  return {
+    cloud_name: process.env.CLOUDINARY_CLOUD_NAME || "",
+    api_key: process.env.CLOUDINARY_API_KEY || "",
+    api_secret: process.env.CLOUDINARY_API_SECRET || ""
+  };
+}
+var config = getConfig();
+validateConfig(config);
+cloudinary.config(config);
+var cloudinary_default = cloudinary;
+
+// src/captchaSolve.ts
+async function solveCaptchaFromPage(page, captchaSelector = "img.captcha-image", outputScreenshotPath) {
+  const captchaImage = page.locator(captchaSelector);
+  try {
+    await captchaImage.waitFor({ state: "visible" });
+  } catch (error) {
+    throw new Error(`CAPTCHA element not found or not visible. Selector: ${captchaSelector}`);
+  }
+  if (outputScreenshotPath) {
+    await captchaImage.screenshot({ path: outputScreenshotPath });
+  }
+  let imageData;
+  try {
+    imageData = await captchaImage.evaluate(async (img) => {
+      const response = await fetch(img.src);
+      if (!response.ok) {
+        throw new Error(`Image fetch failed: ${response.status}`);
+      }
+      const blob = await response.blob();
+      return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+          const result = reader.result;
+          const base64 = result.split(",")[1];
+          resolve({
+            mimeType: blob.type || "image/png",
+            base64
+          });
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(blob);
+      });
+    });
+  } catch (error) {
+    throw new Error(`Failed to extract CAPTCHA image: ${error}`);
+  }
+  let uploadResult;
+  try {
+    uploadResult = await cloudinary_default.uploader.upload(
+      `data:${imageData.mimeType};base64,${imageData.base64}`,
+      {
+        folder: "playwright-captcha-images",
+        resource_type: "image",
+        type: "auth"
+      }
+    );
+  } catch (error) {
+    throw new Error(`Failed to upload CAPTCHA image to Cloudinary: ${error}`);
+  }
+  const imageUrl = uploadResult.secure_url;
+  try {
+    const result = await llm_default(imageUrl);
+    return result;
+  } catch (error) {
+    throw new Error(`Failed to solve CAPTCHA using AI: ${error}`);
+  }
+}
+
+// src/login.ts
+import { chromium } from "playwright";
+async function validateEnv() {
+  const missing = [];
+  if (!process.env.EMAIL || process.env.EMAIL === "dev@example.com") {
+    missing.push("EMAIL - Set to actual email address");
+  }
+  if (!process.env.PASSWORD || process.env.PASSWORD === "22222222") {
+    missing.push("PASSWORD - Set to actual password");
+  }
+  if (missing.length > 0) {
+    console.warn("Warning: The following environment variables are set to defaults or missing:");
+    missing.forEach((m) => console.warn(`  - ${m}`));
+    console.warn("Please update your .env file with real credentials.");
+  }
+}
+async function automateLogin(options) {
+  let browser = null;
+  let context = null;
+  let page = null;
+  try {
+    await validateEnv();
+    browser = await chromium.launch({
+      headless: options.headless ?? false
+    });
+    context = await browser.newContext();
+    page = await context.newPage();
+    await page.goto(options.url, { waitUntil: "domcontentloaded" });
+    const loginSelector = options.loginSelector || "#login";
+    const passwordSelector = options.passwordSelector || "#password";
+    const captchaSelector = "img.captcha-image";
+    const captchaInputSelector = options.captchaInputSelector || "#captcha";
+    const submitButtonSelector = options.submitButtonSelector || "button[type='submit']";
+    await page.locator(loginSelector).fill(process.env.EMAIL || "");
+    await page.locator(passwordSelector).fill(process.env.PASSWORD || "");
+    const captchaResult = await solveCaptchaFromPage(
+      page,
+      captchaSelector,
+      options.outputScreenshotPath ? void 0 : void 0
+    );
+    await page.locator(captchaInputSelector).fill(captchaResult.text);
+    await page.locator(submitButtonSelector).click();
+    try {
+      await page.waitForLoadState("domcontentloaded", { timeout: 15e3 });
+      if (options.screenshotDelay) {
+        await page.waitForTimeout(options.screenshotDelay);
+      }
+      if (options.outputScreenshotPath) {
+        await page.screenshot({ path: options.outputScreenshotPath, fullPage: true });
+      }
+    } catch (error) {
+      console.warn("Warning: Could not wait for post-login state:", error);
+    }
+    return {
+      success: true,
+      url: page.url(),
+      title: await page.title(),
+      page
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    let pageTitle = "";
+    if (page) {
+      try {
+        pageTitle = await page.title();
+      } catch {
+        pageTitle = "failed to get title";
+      }
+    }
+    return {
+      success: false,
+      url: page?.url() || "",
+      title: pageTitle,
+      page,
+      error: errorMessage
+    };
+  } finally {
+    if (browser && !options.headless) {
+      await browser.close().catch(() => {
+      });
+    }
+  }
+}
+
+// src/index.ts
+var index_default = {
+  solveCaptchaFromPage,
+  automateLogin
+};
+export {
+  automateLogin,
+  index_default as default,
+  solveCaptchaFromPage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm.ts","../src/cloudinary.ts","../src/captchaSolve.ts","../src/login.ts","../src/index.ts"],"sourcesContent":["import \"dotenv/config\";\nimport { ChatOpenAI } from \"@langchain/openai\";\nimport { HumanMessage } from \"@langchain/core/messages\";\n\ninterface CaptchaResult {\n  text: string;\n  description: string;\n}\n\nclass LlmError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'LlmError';\n  }\n}\n\nconst model = new ChatOpenAI({\n  model: process.env.LLM_MODEL || \"google/gemma-4-26b-a4b-it\",\n  temperature: 0,\n  apiKey: process.env.OPENROUTER_API_KEY,\n  configuration: {\n    baseURL: \"https://openrouter.ai/api/v1\",\n  },\n});\n\nconst getImageDetails = async function (image_url: string): Promise<CaptchaResult> {\n  if (!process.env.OPENROUTER_API_KEY) {\n    throw new LlmError('OPENROUTER_API_KEY environment variable is required');\n  }\n\n  const response = await model.invoke([\n    new HumanMessage({\n      content: [\n        {\n          type: \"text\",\n          text: `You are a CAPTCHA solving assistant. Analyze the provided image and return the following in strict JSON format:\n- \"text\": The exact text or characters shown in the CAPTCHA\n- \"description\": A brief description of what appears in the image\n\nIf there is no text in the image, set \"text\" to \"no text found\".\n\nExample response:\n{\"text\": \"X7K9P\", \"description\": \"Black text on white background showing alphanumeric characters\"}\n\nReturn ONLY valid JSON with no markdown formatting.`,\n        },\n        {\n          type: \"image_url\",\n          image_url: {\n            url: image_url,\n          },\n        },\n      ],\n    }),\n  ]);\n\n  const content = response.content as string | Array<any>;\n  \n  if (typeof content === 'string') {\n    const jsonString = content\n      .replace(/```json\\s*/i, '')\n      .replace(/```\\s*$/, '')\n      .trim();\n    \n    try {\n      return JSON.parse(jsonString);\n    } catch (parseError) {\n      throw new LlmError(`Failed to parse LLM response as JSON: ${parseError}`);\n    }\n  }\n  \n  throw new LlmError('Unexpected LLM response format');\n};\n\nexport default getImageDetails;\nexport type { CaptchaResult };\nexport { LlmError };\n","import 'dotenv/config';\nimport { v2 as cloudinary } from 'cloudinary';\n\ninterface CloudinaryConfig {\n  cloud_name: string;\n  api_key: string;\n  api_secret: string;\n}\n\nclass CloudinaryError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CloudinaryError';\n  }\n}\n\nfunction validateConfig(config: CloudinaryConfig): void {\n  const missing: string[] = [];\n  \n  if (!config.cloud_name) missing.push('CLOUDINARY_CLOUD_NAME');\n  if (!config.api_key) missing.push('CLOUDINARY_API_KEY');\n  if (!config.api_secret) missing.push('CLOUDINARY_API_SECRET');\n  \n  if (missing.length > 0) {\n    throw new CloudinaryError(`Missing Cloudinary credentials: ${missing.join(', ')}`);\n  }\n}\n\nexport interface UploadResult {\n  secure_url: string;\n  public_id: string;\n  format: string;\n  width: number;\n  height: number;\n  bytes: number;\n  resource_type: string;\n  original_filename: string;\n}\n\nexport function getConfig(): CloudinaryConfig {\n  return {\n    cloud_name: process.env.CLOUDINARY_CLOUD_NAME || '',\n    api_key: process.env.CLOUDINARY_API_KEY || '',\n    api_secret: process.env.CLOUDINARY_API_SECRET || '',\n  };\n}\n\nconst config = getConfig();\nvalidateConfig(config);\n\ncloudinary.config(config);\n\nexport default cloudinary;\nexport { CloudinaryError };\n","import { Page } from \"playwright\";\nimport getImageDetails, { CaptchaResult } from \"./llm.js\";\nimport cloudinary from \"./cloudinary.js\";\n\ninterface ScreenshotError extends Error {\n  code: string;\n}\n\nexport async function solveCaptchaFromPage(\n  page: Page,\n  captchaSelector: string = \"img.captcha-image\",\n  outputScreenshotPath?: string\n): Promise<CaptchaResult> {\n  const captchaImage = page.locator(captchaSelector);\n\n  try {\n    await captchaImage.waitFor({ state: \"visible\" });\n  } catch (error) {\n    throw new Error(`CAPTCHA element not found or not visible. Selector: ${captchaSelector}`);\n  }\n\n  if (outputScreenshotPath) {\n    await captchaImage.screenshot({ path: outputScreenshotPath });\n  }\n\n  let imageData: { mimeType: string; base64: string };\n\n  try {\n    imageData = await captchaImage.evaluate(async (img: HTMLImageElement) => {\n      const response = await fetch(img.src);\n\n      if (!response.ok) {\n        throw new Error(`Image fetch failed: ${response.status}`);\n      }\n\n      const blob = await response.blob();\n\n      return new Promise<{ mimeType: string; base64: string }>((resolve, reject) => {\n        const reader = new FileReader();\n\n        reader.onload = () => {\n          const result = reader.result as string;\n          const base64 = result.split(\",\")[1];\n          resolve({\n            mimeType: blob.type || \"image/png\",\n            base64,\n          });\n        };\n\n        reader.onerror = reject;\n        reader.readAsDataURL(blob);\n      });\n    });\n  } catch (error) {\n    throw new Error(`Failed to extract CAPTCHA image: ${error}`);\n  }\n\n  let uploadResult;\n\n  try {\n    uploadResult = await cloudinary.uploader.upload(\n      `data:${imageData.mimeType};base64,${imageData.base64}`,\n      {\n        folder: \"playwright-captcha-images\",\n        resource_type: \"image\",\n        type: \"auth\",\n      }\n    );\n  } catch (error) {\n    throw new Error(`Failed to upload CAPTCHA image to Cloudinary: ${error}`);\n  }\n\n  const imageUrl = uploadResult.secure_url;\n\n  try {\n    const result = await getImageDetails(imageUrl);\n    return result;\n  } catch (error) {\n    throw new Error(`Failed to solve CAPTCHA using AI: ${error}`);\n  }\n}\n","import { chromium, Browser, Page, BrowserContext } from \"playwright\";\nimport { solveCaptchaFromPage } from \"./captchaSolve.js\";\n\nexport interface LoginOptions {\n  url: string;\n  loginSelector?: string;\n  passwordSelector?: string;\n  captchaInputSelector?: string;\n  submitButtonSelector?: string;\n  headless?: boolean;\n  outputScreenshotPath?: string;\n  screenshotDelay?: number;\n}\n\nexport interface LoginResult {\n  success: boolean;\n  url: string;\n  title: string;\n  page: Page;\n  error?: string;\n}\n\nclass BrowserError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'BrowserError';\n  }\n}\n\nasync function validateEnv(): Promise<void> {\n  const missing: string[] = [];\n  \n  if (!process.env.EMAIL || process.env.EMAIL === 'dev@example.com') {\n    missing.push('EMAIL - Set to actual email address');\n  }\n  if (!process.env.PASSWORD || process.env.PASSWORD === '22222222') {\n    missing.push('PASSWORD - Set to actual password');\n  }\n  \n  if (missing.length > 0) {\n    console.warn('Warning: The following environment variables are set to defaults or missing:');\n    missing.forEach(m => console.warn(`  - ${m}`));\n    console.warn('Please update your .env file with real credentials.');\n  }\n}\n\nexport async function automateLogin(options: LoginOptions): Promise<LoginResult> {\n  let browser: Browser | null = null;\n  let context: BrowserContext | null = null;\n  let page: Page | null = null;\n\n  try {\n    await validateEnv();\n\n    browser = await chromium.launch({\n      headless: options.headless ?? false,\n    });\n\n    context = await browser.newContext();\n    page = await context.newPage();\n\n    await page.goto(options.url, { waitUntil: \"domcontentloaded\" });\n\n    const loginSelector = options.loginSelector || \"#login\";\n    const passwordSelector = options.passwordSelector || \"#password\";\n    const captchaSelector = \"img.captcha-image\";\n    const captchaInputSelector = options.captchaInputSelector || \"#captcha\";\n    const submitButtonSelector = options.submitButtonSelector || \"button[type='submit']\";\n\n    await page.locator(loginSelector).fill(process.env.EMAIL || \"\");\n    await page.locator(passwordSelector).fill(process.env.PASSWORD || \"\");\n\n    const captchaResult = await solveCaptchaFromPage(\n      page,\n      captchaSelector,\n      options.outputScreenshotPath ? undefined : undefined\n    );\n\n    await page.locator(captchaInputSelector).fill(captchaResult.text);\n    await page.locator(submitButtonSelector).click();\n\n    try {\n      await page.waitForLoadState(\"domcontentloaded\", { timeout: 15000 });\n      \n      if (options.screenshotDelay) {\n        await page.waitForTimeout(options.screenshotDelay);\n      }\n\n      if (options.outputScreenshotPath) {\n        await page.screenshot({ path: options.outputScreenshotPath, fullPage: true });\n      }\n    } catch (error) {\n      console.warn('Warning: Could not wait for post-login state:', error);\n    }\n\n    return {\n      success: true,\n      url: page.url(),\n      title: await page.title(),\n      page,\n    };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    \n    let pageTitle = '';\n    if (page) {\n      try {\n        pageTitle = await page.title();\n      } catch {\n        pageTitle = 'failed to get title';\n      }\n    }\n    \n    return {\n      success: false,\n      url: page?.url() || '',\n      title: pageTitle,\n      page: page!,\n      error: errorMessage,\n    };\n  } finally {\n    if (browser && !options.headless) {\n      await browser.close().catch(() => {});\n    }\n  }\n}\n","import { solveCaptchaFromPage } from \"./captchaSolve.js\";\nimport { automateLogin, LoginOptions, LoginResult } from \"./login.js\";\n\nexport type { CaptchaResult } from \"./llm.js\";\nexport type { LoginOptions, LoginResult } from \"./login.js\";\n\nexport { solveCaptchaFromPage };\nexport { automateLogin };\n\nexport default {\n  solveCaptchaFromPage,\n  automateLogin,\n};\n"],"mappings":"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","names":["config"]}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "entrox-bypass",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Bypass bot detection & CAPTCHAs using AI-powered browser automation",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist/",
+    "types/"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "playwright",
+    "captcha",
+    "bypass",
+    "automation",
+    "browser",
+    "ai",
+    "bot-detection",
+    "cloudinary",
+    "llm",
+    "screenshot"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "@langchain/core": "^1.2.20",
+    "@langchain/openai": "^1.6.3",
+    "cloudinary": "^2.11.0",
+    "dotenv": "^18.0.8",
+    "langchain": "^1.5.19",
+    "playwright": "^1.64.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/jest": "^29.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,42 @@
+import { Page } from 'playwright';
+
+export interface CaptchaResult {
+  text: string;
+  description: string;
+}
+
+export interface LoginOptions {
+  url: string;
+  loginSelector?: string;
+  passwordSelector?: string;
+  captchaInputSelector?: string;
+  submitButtonSelector?: string;
+  headless?: boolean;
+  outputScreenshotPath?: string;
+  screenshotDelay?: number;
+}
+
+export interface LoginResult {
+  success: boolean;
+  url: string;
+  title: string;
+  page: Page;
+  error?: string;
+}
+
+declare function solveCaptchaFromPage(
+  page: Page,
+  captchaSelector?: string,
+  outputScreenshotPath?: string
+): Promise<CaptchaResult>;
+
+declare function automateLogin(options: LoginOptions): Promise<LoginResult>;
+
+declare const _default: {
+  solveCaptchaFromPage: typeof solveCaptchaFromPage;
+  automateLogin: typeof automateLogin;
+};
+
+export { solveCaptchaFromPage };
+export { automateLogin };
+export default _default;