undetected-puppeteer-core 24.34.0

package/README.md

@@ -0,0 +1,114 @@
+# undetected-puppeteer-core
+
+A drop-in replacement for [puppeteer-core](https://www.npmjs.com/package/puppeteer-core) with [rebrowser-patches](https://github.com/rebrowser/rebrowser-patches) automatically applied.
+
+This package makes puppeteer-core less detectable by anti-bot systems by patching known detection vectors.
+
+## Installation
+
+Simply replace `puppeteer-core` with `undetected-puppeteer-core` in your `package.json`:
+
+```json
+{
+  "dependencies": {
+    "puppeteer-core": "npm:undetected-puppeteer-core@^24.34.0"
+  }
+}
+```
+
+Then run:
+
+```bash
+npm install
+```
+
+**That's it!** No code changes required. Your existing imports will continue to work:
+
+```javascript
+const puppeteer = require('puppeteer-core');
+// or
+import puppeteer from 'puppeteer-core';
+```
+
+The rebrowser-patches are automatically applied during the postinstall phase.
+
+## Versioning
+
+This package follows the same version numbers as `puppeteer-core`. When a new version of puppeteer-core is released, we publish a matching version with the patches applied.
+
+| puppeteer-core | undetected-puppeteer-core |
+|----------------|---------------------------|
+| 24.34.0        | 24.34.0                   |
+| ...            | ...                       |
+
+## How It Works
+
+1. You install this package using npm's package aliasing feature
+2. npm resolves `puppeteer-core` to `undetected-puppeteer-core`
+3. During installation, `puppeteer-core` is installed as a dependency
+4. The postinstall script applies `rebrowser-patches` automatically
+5. Your code uses `require('puppeteer-core')` which loads our patched version
+
+## What Gets Patched
+
+The rebrowser-patches project patches various detection vectors in puppeteer-core. For the full list of patches, see the [rebrowser-patches documentation](https://github.com/rebrowser/rebrowser-patches).
+
+## Requirements
+
+- Node.js >= 18.0.0
+- A Chrome/Chromium executable (puppeteer-core does not download Chrome automatically)
+
+## TypeScript Support
+
+Full TypeScript support is included. All types from puppeteer-core are available:
+
+```typescript
+import puppeteer, { Browser, Page } from 'puppeteer-core';
+
+async function main(): Promise<void> {
+  const browser: Browser = await puppeteer.launch({
+    executablePath: '/path/to/chrome',
+  });
+  const page: Page = await browser.newPage();
+  // ...
+}
+```
+
+## Example
+
+```javascript
+const puppeteer = require('puppeteer-core');
+
+(async () => {
+  const browser = await puppeteer.launch({
+    executablePath: '/path/to/chrome',
+    headless: false,
+  });
+
+  const page = await browser.newPage();
+  await page.goto('https://example.com');
+
+  // Your automation code here...
+
+  await browser.close();
+})();
+```
+
+## Troubleshooting
+
+### Patches failed to apply
+
+If you see a warning that patches failed to apply during installation, you can try running them manually:
+
+```bash
+npx rebrowser-patches@latest patch --packagePath ./node_modules/undetected-puppeteer-core/node_modules/puppeteer-core
+```
+
+## License
+
+MIT
+
+## Credits
+
+- [puppeteer-core](https://github.com/puppeteer/puppeteer) - The original puppeteer library
+- [rebrowser-patches](https://github.com/rebrowser/rebrowser-patches) - The patches that make puppeteer less detectable

package/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * TypeScript declarations for undetected-puppeteer-core
+ *
+ * This package re-exports all types from puppeteer-core.
+ * The API is identical to puppeteer-core.
+ */
+
+export * from 'puppeteer-core';
+export { default } from 'puppeteer-core';

package/index.js

@@ -0,0 +1,19 @@
+/**
+ * undetected-puppeteer-core
+ *
+ * A proxy package for puppeteer-core with rebrowser-patches applied.
+ * This package re-exports everything from puppeteer-core, but with
+ * patches applied during installation to make it less detectable
+ * by anti-bot systems.
+ *
+ * Usage is identical to puppeteer-core:
+ *
+ * const puppeteer = require('undetected-puppeteer-core');
+ * // or
+ * import puppeteer from 'undetected-puppeteer-core';
+ *
+ * const browser = await puppeteer.launch({ executablePath: '/path/to/chrome' });
+ */
+
+// Re-export everything from puppeteer-core
+module.exports = require('puppeteer-core');

package/index.mjs

@@ -0,0 +1,11 @@
+/**
+ * undetected-puppeteer-core (ESM)
+ *
+ * A proxy package for puppeteer-core with rebrowser-patches applied.
+ * This package re-exports everything from puppeteer-core, but with
+ * patches applied during installation to make it less detectable
+ * by anti-bot systems.
+ */
+
+export * from 'puppeteer-core';
+export { default } from 'puppeteer-core';

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "undetected-puppeteer-core",
+  "version": "24.34.0",
+  "description": "Drop-in replacement for puppeteer-core with rebrowser-patches applied for stealth browsing",
+  "main": "index.js",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./index.mjs"
+      },
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "keywords": [
+    "puppeteer",
+    "puppeteer-core",
+    "stealth",
+    "undetected",
+    "rebrowser",
+    "patches",
+    "automation",
+    "headless",
+    "chrome",
+    "chromium"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "puppeteer-core": "24.34.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Spaaark-io/undetected-puppeteer-core.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/postinstall.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * Postinstall script that applies rebrowser-patches to puppeteer-core
+ * This makes puppeteer-core less detectable by anti-bot systems
+ */
+
+function findPuppeteerCorePath() {
+  // Try to find puppeteer-core in various possible locations
+  const possiblePaths = [
+    // When this package is installed as a dependency
+    path.resolve(__dirname, 'node_modules', 'puppeteer-core'),
+    // When installed in a monorepo or hoisted
+    path.resolve(__dirname, '..', 'puppeteer-core'),
+    // Fallback: try to resolve from require
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p) && fs.existsSync(path.join(p, 'package.json'))) {
+      return p;
+    }
+  }
+
+  // Try using require.resolve as last resort
+  try {
+    const puppeteerMain = require.resolve('puppeteer-core');
+    // Go up from the main file to the package root
+    let dir = path.dirname(puppeteerMain);
+    while (dir !== path.dirname(dir)) {
+      if (fs.existsSync(path.join(dir, 'package.json'))) {
+        const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+        if (pkg.name === 'puppeteer-core') {
+          return dir;
+        }
+      }
+      dir = path.dirname(dir);
+    }
+  } catch (e) {
+    // Ignore resolution errors
+  }
+
+  return null;
+}
+
+function applyPatches() {
+  console.log('[undetected-puppeteer-core] Applying rebrowser-patches...');
+
+  const puppeteerCorePath = findPuppeteerCorePath();
+
+  if (!puppeteerCorePath) {
+    console.error('[undetected-puppeteer-core] Could not find puppeteer-core package path');
+    console.error('[undetected-puppeteer-core] Please ensure puppeteer-core is installed');
+    process.exit(1);
+  }
+
+  console.log(`[undetected-puppeteer-core] Found puppeteer-core at: ${puppeteerCorePath}`);
+
+  try {
+    // Run rebrowser-patches to patch puppeteer-core
+    const command = `npx rebrowser-patches@latest patch --packagePath "${puppeteerCorePath}"`;
+    console.log(`[undetected-puppeteer-core] Running: ${command}`);
+
+    execSync(command, {
+      stdio: 'inherit',
+      cwd: __dirname
+    });
+
+    console.log('[undetected-puppeteer-core] Patches applied successfully!');
+  } catch (error) {
+    console.error('[undetected-puppeteer-core] Failed to apply patches:', error.message);
+    // Don't exit with error code to not break installation
+    // The package will still work, just without patches
+    console.warn('[undetected-puppeteer-core] Continuing without patches...');
+  }
+}
+
+// Only run if this script is executed directly (not required as a module)
+if (require.main === module) {
+  applyPatches();
+}
+
+module.exports = { applyPatches, findPuppeteerCorePath };