added captacha verification bypass in this

.gitignore

@@ -1 +1,2 @@
-/node_modules
+/node_modules
+.env

index.html

@@ -278,7 +278,8 @@
             const logSection = document.getElementById('log-section');
             const logContainer = document.getElementById('log-container');
 
-            const API_BASE_URL = 'http://localhost:7860';
+            // const API_BASE_URL = 'http://localhost:7860';
+            const API_BASE_URL = 'https://devusman-studocu-testing.hf.space';
             let pollInterval;
             let lastLoggedMessage = ''; // NEW: Track last message to avoid duplicates
 

package-lock.json

@@ -8,14 +8,17 @@
       "name": "puppeteer-api",
       "version": "1.0.0",
       "dependencies": {
+        "@2captcha/captcha-solver": "^1.3.0",
         "axios": "^1.11.0",
         "cluster": "^0.7.7",
         "cors": "^2.8.5",
+        "dotenv": "^17.2.2",
         "express": "^5.1.0",
         "puppeteer": "^24.16.2",
         "puppeteer-extra": "^3.3.6",
         "puppeteer-extra-plugin-recaptcha": "^3.6.8",
-        "puppeteer-extra-plugin-stealth": "^2.11.2"
+        "puppeteer-extra-plugin-stealth": "^2.11.2",
+        "puppeteer-real-browser": "^1.4.4"
       },
       "devDependencies": {
         "nodemon": "^3.1.10",
@@ -23,6 +26,15 @@
         "typescript": "^5.4.0"
       }
     },
+    "node_modules/@2captcha/captcha-solver": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@2captcha/captcha-solver/-/captcha-solver-1.3.0.tgz",
+      "integrity": "sha512-Rgyr0kv3EAvBtogQOoe2ns1aXo4ZEoi/QW/96Bkvjk5RdEVPzi+C/X8X2HphQo6FanKQ1UqO7Q7T874IYUJ8eg==",
+      "license": "MIT",
+      "dependencies": {
+        "node-fetch": "^2.6.1"
+      }
+    },
     "node_modules/@babel/code-frame": {
       "version": "7.27.1",
       "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
@@ -73,6 +85,12 @@
       "integrity": "sha512-C5Mc6rdnsaJDjO3UpGW/CQTHtCKaYlScZTly4JIu97Jxo/odCiH0ITnDXSJPTOrEKk/ycSZ0AOgTmkDtkOsvIA==",
       "license": "MIT"
     },
+    "node_modules/@types/bezier-js": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/@types/bezier-js/-/bezier-js-4.1.3.tgz",
+      "integrity": "sha512-FNVVCu5mx/rJCWBxLTcL7oOajmGtWtBTDjq6DSUWUI12GeePivrZZXz+UgE0D6VYsLEjvExRO03z4hVtu3pTEQ==",
+      "license": "MIT"
+    },
     "node_modules/@types/debug": {
       "version": "4.1.12",
       "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
@@ -93,7 +111,6 @@
       "resolved": "https://registry.npmjs.org/@types/node/-/node-24.3.0.tgz",
       "integrity": "sha512-aPTXCrfwnDLj4VvXrm+UUCQjNEvJgNA8s5F1cvwQU+3KNltTOkBm1j30uNLyqqPNe7gE3KFzImYoZEfLhp4Yow==",
       "license": "MIT",
-      "optional": true,
       "dependencies": {
         "undici-types": "~7.10.0"
       }
@@ -296,6 +313,26 @@
         }
       }
     },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/basic-ftp": {
       "version": "5.0.5",
       "resolved": "https://registry.npmjs.org/basic-ftp/-/basic-ftp-5.0.5.tgz",
@@ -305,6 +342,16 @@
         "node": ">=10.0.0"
       }
     },
+    "node_modules/bezier-js": {
+      "version": "6.1.4",
+      "resolved": "https://registry.npmjs.org/bezier-js/-/bezier-js-6.1.4.tgz",
+      "integrity": "sha512-PA0FW9ZpcHbojUCMu28z9Vg/fNkwTj5YhusSAjHHDfHDGLxJ6YUKrAN2vk1fP2MMOxVw4Oko16FMlRGVBGqLKg==",
+      "license": "MIT",
+      "funding": {
+        "type": "individual",
+        "url": "https://github.com/Pomax/bezierjs/blob/master/FUNDING.md"
+      }
+    },
     "node_modules/binary-extensions": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
@@ -361,6 +408,30 @@
         "node": ">=8"
       }
     },
+    "node_modules/buffer": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz",
+      "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.1.13"
+      }
+    },
     "node_modules/buffer-crc32": {
       "version": "0.2.13",
       "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-0.2.13.tgz",
@@ -442,6 +513,24 @@
         "fsevents": "~2.3.2"
       }
     },
+    "node_modules/chrome-launcher": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/chrome-launcher/-/chrome-launcher-1.2.0.tgz",
+      "integrity": "sha512-JbuGuBNss258bvGil7FT4HKdC3SC2K7UAEUqiPy3ACS3Yxo3hAW6bvFpCu2HsIJLgTqxgEX6BkujvzZfLpUD0Q==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@types/node": "*",
+        "escape-string-regexp": "^4.0.0",
+        "is-wsl": "^2.2.0",
+        "lighthouse-logger": "^2.0.1"
+      },
+      "bin": {
+        "print-chrome-path": "bin/print-chrome-path.cjs"
+      },
+      "engines": {
+        "node": ">=12.13.0"
+      }
+    },
     "node_modules/chromium-bidi": {
       "version": "7.3.1",
       "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-7.3.1.tgz",
@@ -712,6 +801,18 @@
       "integrity": "sha512-RQ809ykTfJ+dgj9bftdeL2vRVxASAuGU+I9LEx9Ij5TXU5HrgAQVmzi72VA+mkzscE12uzlRv5/tWWv9R9J1SA==",
       "license": "BSD-3-Clause"
     },
+    "node_modules/dotenv": {
+      "version": "17.2.2",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.2.2.tgz",
+      "integrity": "sha512-Sf2LSQP+bOlhKWWyhFsn0UsfdK/kCWRv1iuA2gXAwt3dyNabr6QSj00I2V10pidqz69soatm9ZwZvpQMTIOd5Q==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
     "node_modules/dunder-proto": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
@@ -891,6 +992,18 @@
       "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
       "license": "MIT"
     },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/escodegen": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-2.1.0.tgz",
@@ -1331,6 +1444,17 @@
         "node": ">= 14"
       }
     },
+    "node_modules/ghost-cursor": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/ghost-cursor/-/ghost-cursor-1.4.1.tgz",
+      "integrity": "sha512-K8A8/Co/Jbdqee694qrNsGWBG51DVK5UF2gGKEoZBDx9F1WmoD2SzUoDHWoY7O+TY84s1VrWwwfkVKxI2FoV2Q==",
+      "license": "ISC",
+      "dependencies": {
+        "@types/bezier-js": "4",
+        "bezier-js": "^6.1.3",
+        "debug": "^4.3.4"
+      }
+    },
     "node_modules/glob": {
       "version": "7.2.3",
       "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
@@ -1495,6 +1619,26 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/ignore-by-default": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/ignore-by-default/-/ignore-by-default-1.0.1.tgz",
@@ -1578,6 +1722,21 @@
       "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
       "license": "MIT"
     },
+    "node_modules/is-docker": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+      "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+      "license": "MIT",
+      "bin": {
+        "is-docker": "cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-extendable": {
       "version": "0.1.1",
       "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
@@ -1647,6 +1806,18 @@
       "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
       "license": "MIT"
     },
+    "node_modules/is-wsl": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+      "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+      "license": "MIT",
+      "dependencies": {
+        "is-docker": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -1720,6 +1891,16 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/lighthouse-logger": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/lighthouse-logger/-/lighthouse-logger-2.0.2.tgz",
+      "integrity": "sha512-vWl2+u5jgOQuZR55Z1WM0XDdrJT6mzMP8zHUct7xTlWhuQs+eV0g+QL0RQdFjT54zVmbhLCP8vIVpy1wGn/gCg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "debug": "^4.4.1",
+        "marky": "^1.2.2"
+      }
+    },
     "node_modules/lines-and-columns": {
       "version": "1.2.4",
       "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
@@ -1759,6 +1940,12 @@
       "integrity": "sha512-CkYQrPYZfWnu/DAmVCpTSX/xHpKZ80eKh2lAkyA6AJTef6bW+6JpbQZN5rofum7da+SyN1bi5ctTm+lTfcCW3g==",
       "dev": true
     },
+    "node_modules/marky": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/marky/-/marky-1.3.0.tgz",
+      "integrity": "sha512-ocnPZQLNpvbedwTy9kNrQEsknEfgvcLMvOtz3sFeWApDq1MXH1TqkCIx58xlpESsfwQOnuBO9beyQuNGzVvuhQ==",
+      "license": "Apache-2.0"
+    },
     "node_modules/math-intrinsics": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -1885,6 +2072,13 @@
       "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
       "license": "MIT"
     },
+    "node_modules/nan": {
+      "version": "2.23.0",
+      "resolved": "https://registry.npmjs.org/nan/-/nan-2.23.0.tgz",
+      "integrity": "sha512-1UxuyYGdoQHcGg87Lkqm3FzefucTa0NAiOcuRsDmysep3c1LVCRK2krrUDafMWtjSG04htvAmvg96+SDknOmgQ==",
+      "license": "MIT",
+      "optional": true
+    },
     "node_modules/negotiator": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
@@ -1916,6 +2110,26 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/node-fetch": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
+      "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-url": "^5.0.0"
+      },
+      "engines": {
+        "node": "4.x || >=6.0.0"
+      },
+      "peerDependencies": {
+        "encoding": "^0.1.0"
+      },
+      "peerDependenciesMeta": {
+        "encoding": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/nodemon": {
       "version": "3.1.10",
       "resolved": "https://registry.npmjs.org/nodemon/-/nodemon-3.1.10.tgz",
@@ -2414,6 +2628,20 @@
         }
       }
     },
+    "node_modules/puppeteer-real-browser": {
+      "version": "1.4.4",
+      "resolved": "https://registry.npmjs.org/puppeteer-real-browser/-/puppeteer-real-browser-1.4.4.tgz",
+      "integrity": "sha512-1CYGlL1Y0SdxP55byi9WQ8dtLkyIYBmRpGr+D+cB6uZDrW17+ZxWMnc7CDZfNuNuJaF15DWW5zvChS/ikymdmg==",
+      "license": "ISC",
+      "dependencies": {
+        "chrome-launcher": "^1.1.2",
+        "ghost-cursor": "^1.3.0",
+        "puppeteer-extra": "^3.3.6",
+        "rebrowser-puppeteer-core": "^23.3.1",
+        "tree-kill": "^1.2.2",
+        "xvfb": "^0.4.0"
+      }
+    },
     "node_modules/qs": {
       "version": "6.14.0",
       "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
@@ -2466,6 +2694,74 @@
         "node": ">=8.10.0"
       }
     },
+    "node_modules/rebrowser-puppeteer-core": {
+      "version": "23.10.3",
+      "resolved": "https://registry.npmjs.org/rebrowser-puppeteer-core/-/rebrowser-puppeteer-core-23.10.3.tgz",
+      "integrity": "sha512-oWwuFg3XoZUkAt6Te4zTU6sQeS39I9tctjdSEiDPa76MF47R0IfLX8VQhyRwwzMySqD5L1wambYcWyEAN0b9AA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@puppeteer/browsers": "2.6.1",
+        "chromium-bidi": "0.8.0",
+        "debug": "^4.4.0",
+        "devtools-protocol": "0.0.1367902",
+        "typed-query-selector": "^2.12.0",
+        "ws": "^8.18.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/rebrowser-puppeteer-core/node_modules/@puppeteer/browsers": {
+      "version": "2.6.1",
+      "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-2.6.1.tgz",
+      "integrity": "sha512-aBSREisdsGH890S2rQqK82qmQYU3uFpSH8wcZWHgHzl3LfzsxAKbLNiAG9mO8v1Y0UICBeClICxPJvyr0rcuxg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "extract-zip": "^2.0.1",
+        "progress": "^2.0.3",
+        "proxy-agent": "^6.5.0",
+        "semver": "^7.6.3",
+        "tar-fs": "^3.0.6",
+        "unbzip2-stream": "^1.4.3",
+        "yargs": "^17.7.2"
+      },
+      "bin": {
+        "browsers": "lib/cjs/main-cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/rebrowser-puppeteer-core/node_modules/chromium-bidi": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-0.8.0.tgz",
+      "integrity": "sha512-uJydbGdTw0DEUjhoogGveneJVWX/9YuqkWePzMmkBYwtdAqo5d3J/ovNKFr+/2hWXYmYCr6it8mSSTIj6SS6Ug==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "mitt": "3.0.1",
+        "urlpattern-polyfill": "10.0.0",
+        "zod": "3.23.8"
+      },
+      "peerDependencies": {
+        "devtools-protocol": "*"
+      }
+    },
+    "node_modules/rebrowser-puppeteer-core/node_modules/devtools-protocol": {
+      "version": "0.0.1367902",
+      "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1367902.tgz",
+      "integrity": "sha512-XxtPuC3PGakY6PD7dG66/o8KwJ/LkH2/EKe19Dcw58w53dv4/vSQEkn/SzuyhHE2q4zPgCkxQBxus3VV4ql+Pg==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/rebrowser-puppeteer-core/node_modules/zod": {
+      "version": "3.23.8",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.23.8.tgz",
+      "integrity": "sha512-XBx9AXhXktjUqnepgTiE5flcKIYWi/rme0Eaj+5Y0lftuGBq+jyRu/md4WnuxqgP1ubdpNCsYEYPxrzVHD8d6g==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    },
     "node_modules/require-directory": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
@@ -2741,6 +3037,20 @@
         "node": ">=10"
       }
     },
+    "node_modules/sleep": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/sleep/-/sleep-6.1.0.tgz",
+      "integrity": "sha512-Z1x4JjJxsru75Tqn8F4tnOFeEu3HjtITTsumYUiuz54sGKdISgLCek9AUlXlVVrkhltRFhNUsJDJE76SFHTDIQ==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "nan": "^2.13.2"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
     "node_modules/smart-buffer": {
       "version": "4.2.0",
       "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz",
@@ -2933,7 +3243,6 @@
       "version": "2.3.8",
       "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz",
       "integrity": "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/to-regex-range": {
@@ -2968,6 +3277,21 @@
         "nodetouch": "bin/nodetouch.js"
       }
     },
+    "node_modules/tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
+      "license": "MIT"
+    },
+    "node_modules/tree-kill": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/tree-kill/-/tree-kill-1.2.2.tgz",
+      "integrity": "sha512-L0Orpi8qGpRG//Nd+H90vFB+3iHnue1zSSGmNOOCh1GLJ7rUKVwV2HvijphGQS2UmhUZewS9VgvxYIdgr+fG1A==",
+      "license": "MIT",
+      "bin": {
+        "tree-kill": "cli.js"
+      }
+    },
     "node_modules/tsc-watch": {
       "version": "6.3.1",
       "resolved": "https://registry.npmjs.org/tsc-watch/-/tsc-watch-6.3.1.tgz",
@@ -3036,6 +3360,16 @@
         "node": ">=14.17"
       }
     },
+    "node_modules/unbzip2-stream": {
+      "version": "1.4.3",
+      "resolved": "https://registry.npmjs.org/unbzip2-stream/-/unbzip2-stream-1.4.3.tgz",
+      "integrity": "sha512-mlExGW4w71ebDJviH16lQLtZS32VKqsSfk80GCfUlwT/4/hNRFsoscrF/c++9xinkMzECL1uL9DDwXqFWkruPg==",
+      "license": "MIT",
+      "dependencies": {
+        "buffer": "^5.2.1",
+        "through": "^2.3.8"
+      }
+    },
     "node_modules/undefsafe": {
       "version": "2.0.5",
       "resolved": "https://registry.npmjs.org/undefsafe/-/undefsafe-2.0.5.tgz",
@@ -3047,8 +3381,7 @@
       "version": "7.10.0",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.10.0.tgz",
       "integrity": "sha512-t5Fy/nfn+14LuOc2KNYg75vZqClpAiqscVvMygNnlsHBFpSXdJaYtXMcdNLpl/Qvc3P2cB3s6lOV51nqsFq4ag==",
-      "license": "MIT",
-      "optional": true
+      "license": "MIT"
     },
     "node_modules/uni-global": {
       "version": "1.0.0",
@@ -3077,6 +3410,12 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/urlpattern-polyfill": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/urlpattern-polyfill/-/urlpattern-polyfill-10.0.0.tgz",
+      "integrity": "sha512-H/A06tKD7sS1O1X2SshBVeA5FLycRpjqiBeqGKmBwBDBy28EnRjORxTNe269KSSr5un5qyWi1iL61wLxpd+ZOg==",
+      "license": "MIT"
+    },
     "node_modules/vary": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
@@ -3086,6 +3425,22 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    },
     "node_modules/which": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
@@ -3146,6 +3501,15 @@
         }
       }
     },
+    "node_modules/xvfb": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/xvfb/-/xvfb-0.4.0.tgz",
+      "integrity": "sha512-g55AbjcBL4Bztfn7kiUrR0ne8mMUsFODDJ+HFGf5OuHJqKKccpExX2Qgn7VF2eImw1eoh6+riXHser1J4agrFA==",
+      "license": "MIT",
+      "optionalDependencies": {
+        "sleep": "6.1.0"
+      }
+    },
     "node_modules/y18n": {
       "version": "5.0.8",
       "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",

package.json

@@ -4,14 +4,17 @@
   "main": "server.js",
   "type": "commonjs",
   "dependencies": {
+    "@2captcha/captcha-solver": "^1.3.0",
     "axios": "^1.11.0",
     "cluster": "^0.7.7",
     "cors": "^2.8.5",
+    "dotenv": "^17.2.2",
     "express": "^5.1.0",
     "puppeteer": "^24.16.2",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-recaptcha": "^3.6.8",
-    "puppeteer-extra-plugin-stealth": "^2.11.2"
+    "puppeteer-extra-plugin-stealth": "^2.11.2",
+    "puppeteer-real-browser": "^1.4.4"
   },
   "devDependencies": {
     "nodemon": "^3.1.10",

server.js

@@ -1,7 +1,6 @@
 const express = require('express');
 const puppeteerExtra = require('puppeteer-extra');
 const StealthPlugin = require('puppeteer-extra-plugin-stealth');
-// NEW: Add the recaptcha plugin to help solve Cloudflare and other challenges
 const RecaptchaPlugin = require('puppeteer-extra-plugin-recaptcha');
 const cors = require('cors');
 const { EventEmitter } = require('events');
@@ -9,24 +8,21 @@ const os = require('os');
 const fs = require('fs').promises;
 const path = require('path');
 
-// --- NEW: Configuration for the Solver ---
-// You can optionally provide a 2Captcha API key to solve more complex captchas,
-// but it's often not needed for the initial Cloudflare JS challenge.
 puppeteerExtra.use(
     RecaptchaPlugin({
-        provider: { id: '2captcha', token: 'cc4f0d688032c69ecf359cccdabbacb9' }
+        provider: { id: '2captcha', token: process.env.TWOCAPTCHA_API_KEY || 'YOUR_2CAPTCHA_API_KEY' },
+        throwOnError: false
     })
 );
 puppeteerExtra.use(StealthPlugin());
 
-
 const app = express();
 const port = 7860;
 
 app.use(cors());
 app.use(express.json());
 
-// --- Progress Tracking and Job Storage (No changes) ---
+// --- Progress Tracking and Job Storage ---
 const progressTrackers = new Map();
 const downloadJobs = new Map();
 
@@ -55,13 +51,75 @@ class ProgressTracker extends EventEmitter {
     }
 }
 
-// --- Puppeteer Logic (Updated for Cloudflare Bypass) ---
+// --- Cloudflare Challenge Detection and Handling ---
+const handleCloudflareChallenge = async (page, url, progressTracker, maxRetries = 2) => { // MODIFIED: Reduced maxRetries to 2
+    let retries = 0;
+    while (retries < maxRetries) {
+        try {
+            console.log(`🛡️ Attempt ${retries + 1}: Navigating to ${url}...`);
+            progressTracker?.updateProgress(30 + retries * 2, 'navigating', `Attempt ${retries + 1}: Navigating to document...`);
+
+            await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
+
+            const isCloudflarePage = await page.evaluate(() => {
+                return document.querySelector('title')?.textContent.includes('Verifying you are human') ||
+                    document.querySelector('#challenge-form') ||
+                    document.querySelector('input[name="cf-turnstile-response"]');
+            });
+
+            if (isCloudflarePage) {
+                console.log("⏳ Detected Cloudflare challenge page. Waiting for resolution...");
+                progressTracker?.updateProgress(32 + retries * 2, 'solving_cf', 'Solving Cloudflare challenge...');
+
+                try {
+                    const { captchas, solved } = await page.solveRecaptchas();
+                    if (solved.length > 0) {
+                        console.log("✅ CAPTCHA solved:", solved);
+                        progressTracker?.updateProgress(34 + retries * 2, 'solving_cf', 'CAPTCHA solved successfully');
+                    } else {
+                        console.log("⚠️ No CAPTCHA solved, waiting for JS challenge...");
+                    }
+                } catch (e) {
+                    console.warn("⚠️ CAPTCHA solving failed:", e.message);
+                }
+
+                await page.waitForNavigation({ waitUntil: 'networkidle2', timeout: 30000 }).catch(() => { });
+
+                const isOnTargetPage = await page.evaluate(() => {
+                    return document.querySelector('#search-input') || document.querySelector('.document-content');
+                });
+
+                if (isOnTargetPage) {
+                    console.log("✅ Cloudflare challenge passed! On StuDocu page.");
+                    progressTracker?.updateProgress(40, 'navigation_complete', 'Successfully navigated to document');
+                    return true;
+                } else {
+                    throw new Error("Navigation did not reach target page.");
+                }
+            } else {
+                console.log("✅ No Cloudflare challenge detected. On StuDocu page.");
+                progressTracker?.updateProgress(40, 'navigation_complete', 'Successfully navigated to document');
+                return true;
+            }
+        } catch (e) {
+            console.error(`❌ Attempt ${retries + 1} failed:`, e.message);
+            retries++;
+            if (retries === maxRetries) {
+                const screenshotPath = path.join(os.tmpdir(), `cloudflare_failure_${Date.now()}.png`);
+                await page.screenshot({ path: screenshotPath, fullPage: true });
+                console.log(`📸 Screenshot saved to ${screenshotPath}`);
+                throw new Error(`Failed to bypass Cloudflare after ${maxRetries} attempts: ${e.message}`);
+            }
+            await new Promise(resolve => setTimeout(resolve, 5000));
+        }
+    }
+};
+
+// --- Puppeteer Logic ---
 const bypassCookiesAndRestrictions = async (page, progressTracker) => {
-    // This function remains largely the same but is now called *after* passing Cloudflare.
     progressTracker?.updateProgress(5, 'bypassing', 'Setting up cookie bypass...');
-    // (The implementation of this function is unchanged from your original code)
+
     console.log("🍪 Starting comprehensive cookie and restriction bypass...");
-    // Step 1: Set cookies before page load
     const preCookies = [
         { name: 'cookieConsent', value: 'accepted', domain: '.studocu.com' },
         { name: 'cookie_consent', value: 'true', domain: '.studocu.com' },
@@ -80,10 +138,8 @@ const bypassCookiesAndRestrictions = async (page, progressTracker) => {
         }
     }
 
-    // Step 2: Inject CSS to hide cookie banners immediately
     await page.addStyleTag({
         content: `
-            /* Hide all possible cookie banners */
             [id*="cookie" i]:not(img):not(input), [class*="cookie" i]:not(img):not(input), [data-testid*="cookie" i], [aria-label*="cookie" i],
             .gdpr-banner, .gdpr-popup, .gdpr-modal, .consent-banner, .consent-popup, .consent-modal, .privacy-banner, .privacy-popup, .privacy-modal,
             .cookie-law, .cookie-policy, .cookie-compliance, .onetrust-banner-sdk, #onetrust-consent-sdk, .cmp-banner, .cmp-popup, .cmp-modal,
@@ -95,25 +151,21 @@ const bypassCookiesAndRestrictions = async (page, progressTracker) => {
                 z-index: -9999 !important;
                 pointer-events: none !important;
             }
-            /* Remove blur and premium overlays */
             [class*="blur" i], [class*="premium" i], [class*="paywall" i], [class*="sample-preview-blur" i] {
                 filter: none !important;
                 backdrop-filter: none !important;
                 opacity: 1 !important;
                 visibility: visible !important;
             }
-            /* Ensure document content is visible */
             .document-content, .page-content, [data-page] {
                 filter: none !important;
                 opacity: 1 !important;
                 visibility: visible !important;
                 pointer-events: auto !important;
             }
-            /* Remove fixed overlays */
             .fixed-overlay, .sticky-overlay, .content-overlay {
                 display: none !important;
             }
-            /* Restore scrolling */
             html, body {
                 overflow: auto !important;
                 position: static !important;
@@ -121,24 +173,20 @@ const bypassCookiesAndRestrictions = async (page, progressTracker) => {
         `
     });
 
-    // Step 3: Inject JavaScript to handle dynamic cookie banners
     await page.evaluateOnNewDocument(() => {
-        // Override common cookie consent functions
         window.cookieConsent = { accepted: true };
         window.gtag = () => { };
         window.ga = () => { };
         window.dataLayer = [];
 
-        // Mutation observer to catch dynamically added cookie banners
         const observer = new MutationObserver((mutations) => {
             mutations.forEach((mutation) => {
                 mutation.addedNodes.forEach((node) => {
-                    if (node.nodeType === 1) { // Element node
+                    if (node.nodeType === 1) {
                         const element = node;
                         const text = element.textContent || '';
                         const className = element.className || '';
                         const id = element.id || '';
-                        // Check if this looks like a cookie banner
                         if (
                             text.toLowerCase().includes('cookie') ||
                             text.toLowerCase().includes('consent') ||
@@ -158,7 +206,6 @@ const bypassCookiesAndRestrictions = async (page, progressTracker) => {
         });
         observer.observe(document.body, { childList: true, subtree: true });
 
-        // Set up periodic cleanup
         setInterval(() => {
             const cookieElements = document.querySelectorAll(`
                 [id*="cookie" i]:not(img):not(input), [class*="cookie" i]:not(img):not(input), [data-testid*="cookie" i],
@@ -166,16 +213,15 @@ const bypassCookiesAndRestrictions = async (page, progressTracker) => {
                 .cmp-banner, .cc-banner
             `);
             cookieElements.forEach(el => el.remove());
-            // Restore body scroll
             document.body.style.overflow = 'auto';
             document.documentElement.style.overflow = 'auto';
         }, 1000);
     });
+
     progressTracker?.updateProgress(10, 'bypassing', 'Cookie bypass configured successfully');
     return true;
 };
 
-// --- Other functions (unblurContent, applyPrintStyles) are unchanged ---
 const unblurContent = async (page, progressTracker) => {
     progressTracker?.updateProgress(15, 'unblurring', 'Removing content restrictions...');
 
@@ -301,13 +347,9 @@ const applyPrintStyles = async (page, progressTracker) => {
     progressTracker?.updateProgress(88, 'styling', 'Print styles applied successfully');
 };
 
-
 const studocuDownloader = async (url, options = {}, progressTracker = null) => {
     let browser;
     let userDataDir = null;
-    // NEW: Easy flag for debugging. Set to true to see the browser window.
-    const isDebugging = false;
-
     try {
         progressTracker?.updateProgress(0, 'initializing', 'Starting browser...');
 
@@ -317,29 +359,47 @@ const studocuDownloader = async (url, options = {}, progressTracker = null) => {
 
         console.log("🚀 Launching browser with enhanced stealth configuration...");
         browser = await puppeteerExtra.launch({
-            headless: !isDebugging, // Use the debugging flag
+            headless: true,
             userDataDir: userDataDir,
             args: [
                 '--no-sandbox',
                 '--disable-setuid-sandbox',
-                '--disable-infobars',
                 '--disable-dev-shm-usage',
+                '--disable-accelerated-2d-canvas',
+                '--no-first-run',
+                '--no-zygote',
+                '--disable-gpu',
+                '--disable-features=VizDisplayCompositor',
+                '--disable-background-networking',
+                '--disable-background-timer-throttling',
+                '--disable-renderer-backgrounding',
+                '--disable-backgrounding-occluded-windows',
+                '--disable-ipc-flooding-protection',
+                '--disable-web-security',
+                '--disable-features=site-per-process',
                 '--disable-blink-features=AutomationControlled',
-                '--window-size=1920,1080'
+                '--disable-extensions',
+                '--ignore-certificate-errors'
             ],
             ignoreHTTPSErrors: true,
+            timeout: 300000,
         });
 
         const page = await browser.newPage();
+
         progressTracker?.updateProgress(2, 'initializing', 'Configuring browser settings...');
 
         await page.setUserAgent('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36');
-        await page.setViewport({ width: 1920, height: 1080 });
+        await page.setViewport({ width: 794, height: 1122 });
 
-        // The stealth plugin and other `evaluateOnNewDocument` calls handle this better now.
-        // await page.evaluateOnNewDocument(...) is handled by plugins.
+        await page.evaluateOnNewDocument(() => {
+            Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
+            Object.defineProperty(navigator, 'languages', { get: () => ['en-US', 'en'] });
+            Object.defineProperty(navigator, 'plugins', { get: () => [1, 2, 3, 4, 5] });
+        });
+
+        await bypassCookiesAndRestrictions(page, progressTracker);
 
-        // Request interception logic is unchanged
         await page.setRequestInterception(true);
         page.on('request', (req) => {
             const resourceType = req.resourceType();
@@ -349,6 +409,7 @@ const studocuDownloader = async (url, options = {}, progressTracker = null) => {
                 req.continue();
                 return;
             }
+
             if (
                 ['image', 'media', 'font', 'stylesheet'].includes(resourceType) &&
                 !reqUrl.includes('document') && !reqUrl.includes('page') && !reqUrl.includes('studocu') ||
@@ -371,48 +432,30 @@ const studocuDownloader = async (url, options = {}, progressTracker = null) => {
             }
         });
 
-
-        // --- MODIFIED NAVIGATION LOGIC ---
-        progressTracker?.updateProgress(5, 'navigating', 'Navigating to document...');
-        console.log(`🛡️ Navigating to ${url} and preparing for Cloudflare challenge...`);
-        try {
-            await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 120000 });
-
-            // NEW: Wait for potential Cloudflare challenge to solve and redirect.
-            // We wait for an element that *only* exists on the actual Studocu page.
-            console.log("⏳ Waiting for Cloudflare challenge to be solved...");
-            progressTracker?.updateProgress(8, 'solving_cf', 'Solving Cloudflare challenge...');
-
-            await page.waitForSelector('#search-input', { timeout: 90000 });
-
-            console.log("✅ Cloudflare challenge passed! You are on the Studocu page.");
-            progressTracker?.updateProgress(10, 'navigation_complete', 'Successfully navigated to document');
-
-        } catch (e) {
-            console.error("❌ Failed to bypass Cloudflare or navigate to the page.", e.message);
-            // NEW: Take a screenshot on failure to help debug
-            const screenshotPath = path.join(os.tmpdir(), `cloudflare_failure_${Date.now()}.png`);
-            await page.screenshot({ path: screenshotPath, fullPage: true });
-            console.log(`📸 Screenshot saved to ${screenshotPath}`);
-            throw new Error("Could not bypass Cloudflare. The site may be actively blocking, or the page structure changed.");
-        }
-
-        // --- RESUME NORMAL SCRIPT FLOW ---
-
-        // It's better to bypass cookies *after* landing on the actual page
-        await bypassCookiesAndRestrictions(page, progressTracker);
-
         if (options.email && options.password) {
             progressTracker?.updateProgress(12, 'authenticating', 'Logging into StuDocu...');
-            // ... (Login logic is unchanged)
+
+            console.log("🔑 Logging in to StuDocu...");
+            await page.goto('https://www.studocu.com/en-us/login', { waitUntil: 'domcontentloaded', timeout: 60000 });
+            await page.waitForSelector('#email', { timeout: 10000 });
+            await page.type('#email', options.email);
+            await page.type('#password', options.password);
+            await page.click('button[type="submit"]');
+            try {
+                await page.waitForNavigation({ waitUntil: 'networkidle2', timeout: 15000 });
+                await page.waitForSelector('.user-profile, [data-testid="user-menu"]', { timeout: 5000 });
+                console.log("✅ Login successful.");
+                progressTracker?.updateProgress(18, 'authenticated', 'Login successful');
+            } catch (e) {
+                console.error("❌ Login failed:", e.message);
+                throw new Error("Login failed. Check credentials or try again.");
+            }
         }
 
-        progressTracker?.updateProgress(40, 'loading', 'Page loaded, waiting for content...');
-        await new Promise(resolve => setTimeout(resolve, 2000));
+        await handleCloudflareChallenge(page, url, progressTracker);
 
         await unblurContent(page, progressTracker);
 
-        // ... (The rest of the script is unchanged)
         progressTracker?.updateProgress(45, 'loading', 'Waiting for document content...');
         console.log("⏳ Waiting for document content to load...");
 
@@ -537,7 +580,6 @@ const studocuDownloader = async (url, options = {}, progressTracker = null) => {
         console.log(`✅ PDF generated successfully! Size: ${(pdfBuffer.length / 1024 / 1024).toFixed(2)} MB`);
         return pdfBuffer;
 
-
     } catch (error) {
         progressTracker?.updateProgress(-1, 'error', error.message);
         console.error("❌ Error during PDF generation:", error);
@@ -563,7 +605,7 @@ const studocuDownloader = async (url, options = {}, progressTracker = null) => {
     }
 };
 
-// --- API Routes, Health, and Info Endpoints (Unchanged) ---
+// --- API Routes ---
 app.post('/api/request-download', (req, res) => {
     const { url, email, password } = req.body;
     if (!url || !url.includes('studocu.com')) {
@@ -574,7 +616,7 @@ app.post('/api/request-download', (req, res) => {
     const progressTracker = new ProgressTracker(sessionId);
 
     progressTrackers.set(sessionId, progressTracker);
-    downloadJobs.set(sessionId, { status: 'processing' });
+    downloadJobs.set(sessionId, { status: 'processing', createdAt: Date.now() }); // MODIFIED: Added createdAt
 
     console.log(`🎯 Processing request for: ${url} [Session: ${sessionId}]`);
 
@@ -582,13 +624,22 @@ app.post('/api/request-download', (req, res) => {
 
     studocuDownloader(url, { email, password }, progressTracker)
         .then(pdfBuffer => {
-            downloadJobs.set(sessionId, { status: 'completed', buffer: pdfBuffer });
+            downloadJobs.set(sessionId, { status: 'completed', buffer: pdfBuffer, createdAt: Date.now() });
             progressTrackers.delete(sessionId);
         })
         .catch(error => {
-            downloadJobs.set(sessionId, { status: 'error', message: error.message });
+            downloadJobs.set(sessionId, { status: 'error', message: error.message, createdAt: Date.now() });
             progressTrackers.delete(sessionId);
         });
+
+    // NEW: Timeout for job cleanup
+    setTimeout(() => {
+        if (downloadJobs.has(sessionId) && downloadJobs.get(sessionId).status === 'processing') {
+            downloadJobs.set(sessionId, { status: 'error', message: 'Job timed out after 5 minutes', createdAt: Date.now() });
+            progressTrackers.delete(sessionId);
+            console.log(`🕒 Session ${sessionId} timed out`);
+        }
+    }, 300000); // 5 minutes
 });
 
 app.get('/api/progress/:sessionId', (req, res) => {
@@ -627,7 +678,12 @@ app.get('/api/download/:sessionId', (req, res) => {
     }
 
     if (job.status === 'processing') {
-        return res.status(400).json({ error: 'Download is still processing.' });
+        const elapsed = Date.now() - job.createdAt;
+        if (elapsed > 300000) { // 5 minutes
+            downloadJobs.set(sessionId, { status: 'error', message: 'Download timed out after 5 minutes' });
+            return res.status(500).json({ error: 'Download timed out after 5 minutes.' });
+        }
+        return res.status(400).json({ error: 'Download is still processing. Please try again in a few seconds.' });
     }
 
     if (job.status === 'error') {
@@ -638,11 +694,13 @@ app.get('/api/download/:sessionId', (req, res) => {
         res.setHeader('Content-Type', 'application/pdf');
         res.setHeader('Content-Disposition', 'attachment; filename=studocu-document.pdf');
         res.send(job.buffer);
+        downloadJobs.delete(sessionId); // MODIFIED: Clean up after successful download
     } else {
         res.status(500).json({ error: 'An unknown error occurred.' });
     }
 });
 
+// --- Health and Info Endpoints ---
 app.get('/health', (req, res) => {
     res.json({
         status: 'healthy',
@@ -654,16 +712,17 @@ app.get('/health', (req, res) => {
 
 app.get('/', (req, res) => {
     res.json({
-        message: '🚀 Enhanced StuDocu Downloader API v5.3 - Real-time Progress Tracking with Cloudflare Bypass',
-        version: '5.3.0',
+        message: '🚀 Enhanced StuDocu Downloader API v5.4 - Download Issue Fixed',
+        version: '5.4.0',
         features: [
-            '🛡️ Cloudflare JS Challenge Bypass',
+            '🛡️ Cloudflare CAPTCHA bypass with 2Captcha',
             '🍪 Advanced cookie banner bypass',
             '🔓 Premium content unblurring',
             '🔑 Login support for full access',
             '📊 Real-time progress tracking via polling',
             '📄 Clean PDF generation with print styles',
-            '🕵️ Enhanced stealth to evade bot detection'
+            '🕵️ Enhanced stealth to evade bot detection',
+            '⏱️ Optimized download timeout handling'
         ],
         endpoints: {
             request: 'POST /api/request-download (body: {url, filename?, email?, password?})',
@@ -685,6 +744,6 @@ process.on('SIGINT', () => {
 });
 
 app.listen(port, () => {
-    console.log(`🚀 Enhanced StuDocu Downloader v5.3.0 running on http://localhost:${port}`);
-    console.log(`✨ Features: Cloudflare Bypass, Real-time progress tracking, enhanced stealth, and user feedback`);
+    console.log(`🚀 Enhanced StuDocu Downloader v5.4.0 running on http://localhost:${port}`);
+    console.log(`✨ Features: CAPTCHA bypass, Real-time progress tracking, enhanced stealth, optimized download`);
 });