captchakraken 2.8.0 → 3.0.0

package/dist/selectors.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PIECE_SELECTORS = exports.SLIDER_HANDLE_SELECTORS = exports.TEXT_INPUT_SELECTORS = exports.TEXT_INPUT_VENDOR_SELECTORS = exports.SUBMIT_SELECTORS = exports.submitByText = exports.ACCEPTED_SELECTORS = exports.RESPONSE_SELECTORS = exports.WIDGET_PROBES = exports.VENDORS = exports.SELECTORS = void 0;
+/**
+ * Every selector the driver knows, keyed by vendor. Mirrored in python/src/captchakraken/selectors.py; keep both in the
+ * same order, because detection takes the first visible match in table order.
+ */
+const kinds_1 = require("./kinds");
+exports.SELECTORS = {
+    [kinds_1.Vendor.RECAPTCHA]: {
+        hosts: ['google.com/recaptcha', 'recaptcha.net'],
+        challenge: ['iframe[src*="recaptcha/api2/bframe"]'],
+        checkbox: ['iframe[src*="recaptcha/api2/anchor"]:not([src*="size=invisible"])'],
+        response: '[name="g-recaptcha-response"]',
+        checked: '.recaptcha-checkbox-checked',
+        fresh: '.rc-imageselect-instructions, #rc-imageselect',
+        submit: ['#recaptcha-verify-button'],
+        banners: [
+            ['.rc-imageselect-error-select-more', kinds_1.RecaptchaBanner.SELECT_MORE],
+            ['.rc-imageselect-error-dynamic-more', kinds_1.RecaptchaBanner.DYNAMIC_MORE],
+            ['.rc-imageselect-incorrect-response', kinds_1.RecaptchaBanner.REJECTED],
+        ],
+    },
+    // Keyed on the `hcaptcha` substring, not the apex host: challenges are served off newassets.hcaptcha.com.
+    [kinds_1.Vendor.HCAPTCHA]: {
+        hosts: ['hcaptcha.com'],
+        challenge: ['iframe[src*="hcaptcha"][src*="frame=challenge"]'],
+        checkbox: ['iframe[src*="hcaptcha"][src*="frame=checkbox"]'],
+        response: '[name="h-captcha-response"]',
+        checked: '#checkbox[aria-checked="true"]',
+        fresh: '.prompt-text',
+        images: ['.task-image .image', '.task .image', '.challenge-example img', '.image-wrapper img'],
+        submit: ['.button-submit'],
+    },
+    [kinds_1.Vendor.TURNSTILE]: {
+        hosts: ['challenges.cloudflare.com'],
+        checkbox: ['iframe[src*="challenges.cloudflare.com"]', '.cf-turnstile'],
+        response: '[name="cf-turnstile-response"]',
+    },
+    [kinds_1.Vendor.GEETEST]: {
+        hosts: ['geetest.com'],
+        widget: ['.geetest_box', '.geetest_panel_box', '.geetest_popup_window', '.geetest_widget'],
+        accepted: '.geetest_result_tips.geetest_success, .geetest_captcha.geetest_success, .geetest_captcha.geetest_lock_success',
+        submit: ['.geetest_submit'],
+        sliderHandle: ['.geetest_slider_button', '.geetest_btn', '.geetest_slider .geetest_arrow'],
+        piece: ['.geetest_slice'],
+    },
+    // Both in-page and iframe shapes stay (Tencent moved in-host on 2026-08-11; see TRIBAL_KNOWLEDGE.md), and the iframe id
+    // is prefix-anchored: `[id*=tcaptcha]` also matched MTCaptcha's iframe and hid that `.mtcap` matched nothing.
+    [kinds_1.Vendor.TENCENT]: {
+        hosts: ['captcha.gtimg.com', 'captcha.qcloud.com'],
+        widget: ['#tcaptcha_transform_dy', '#tCaptchaDyContent', '.tencent-captcha-dy__content', 'iframe#tcaptcha_iframe_dy', 'iframe[id^="tcaptcha"]', 'iframe[src*="captcha.gtimg.com"]', 'iframe[src*="captcha.qq.com"]'],
+        sliderHandle: ['.tencent-captcha-dy__slider-block', '#tcaptcha_drag_thumb', '.tc-slider-normal', '[id*=slideBlock]'],
+        piece: ['.tencent-captcha-dy__fg-item'],
+    },
+    [kinds_1.Vendor.YIDUN]: {
+        hosts: ['dun.163.com', 'cstaticdun.126.net', 'necaptcha.nosdn.127.net'],
+        widget: ['.yidun_panel', '.yidun'],
+        sliderHandle: ['.yidun_slider', '.yidun_jigsaw'],
+        piece: ['.yidun_jigsaw'],
+    },
+    [kinds_1.Vendor.YANDEX]: {
+        hosts: ['smartcaptcha.yandexcloud.net'],
+        widget: ['iframe[src*="smartcaptcha.yandexcloud.net/advanced"]', 'iframe[src*="smartcaptcha.yandexcloud.net"]', '.CheckboxCaptcha'],
+        textInput: ['.AdvancedCaptcha-Input input', 'input.Textinput-Control', 'input[name="rep"]'],
+    },
+    [kinds_1.Vendor.LEMIN]: {
+        hosts: ['leminnow.com'],
+        widget: ['#lemin-cropped-captcha', '.lemin-captcha-popup'],
+        sliderHandle: ['.lemin-slider-handle', '#lemin-cropped-captcha .slider'],
+        piece: ['.lemin-cropped-puzzle-piece', '#lemin-cropped-captcha canvas + canvas'],
+    },
+    [kinds_1.Vendor.PROSOPO]: {
+        hosts: ['prosopo.io'],
+        widget: ['.prosopo-modalInner', '.procaptcha-checkbox'],
+    },
+    [kinds_1.Vendor.MTCAPTCHA]: {
+        hosts: ['mtcaptcha.com'],
+        widget: ['iframe[src*="service.mtcaptcha.com"]', 'iframe[id^="mtcaptcha-iframe"]', '.mtcaptcha', '.mtcap'],
+        textInput: ['input.mtcap-inputtext', '.mtcap input[type=text]'],
+    },
+    [kinds_1.Vendor.BOTDETECT]: {
+        hosts: [],
+        widget: ['.BDC_CaptchaDiv'],
+        textInput: ['input[id*=captchaCode]', 'input#captchaCode', 'input[id*=validateCaptcha]', '.BDC_CaptchaDiv input[type=text]'],
+    },
+    [kinds_1.Vendor.UNKNOWN]: { hosts: [] },
+};
+exports.VENDORS = Object.entries(exports.SELECTORS);
+const ofEveryVendor = (key) => exports.VENDORS.flatMap(([, s]) => s[key] ?? []);
+/** Every host-page selector with what it names, in detection order: open challenges, then checkboxes, then inline widgets. */
+exports.WIDGET_PROBES = [
+    [kinds_1.FrameRole.CHALLENGE, 'challenge'], [kinds_1.FrameRole.CHECKBOX, 'checkbox'], [kinds_1.FrameRole.UNKNOWN, 'widget'],
+].flatMap(([role, key]) => exports.VENDORS.flatMap(([vendor, s]) => (s[key] ?? []).map((selector) => ({ vendor, role, selector }))));
+exports.RESPONSE_SELECTORS = exports.VENDORS.flatMap(([, s]) => s.response ?? []);
+exports.ACCEPTED_SELECTORS = exports.VENDORS.flatMap(([, s]) => s.accepted ?? []);
+const lower = "translate(., 'ABCDEFGHIJKLMNOPQRSTUVWXYZ', 'abcdefghijklmnopqrstuvwxyz')";
+/** `.//` keeps the xpath relative so a host-page widget cannot reach the form's own submit. */
+const submitByText = (text) => `xpath=.//button[contains(${lower}, '${text}')] | .//div[@role="button" and contains(${lower}, '${text}')]`;
+exports.submitByText = submitByText;
+/** A real Verify/Next/Submit/Skip first; the vendor-named controls are fallbacks. */
+exports.SUBMIT_SELECTORS = [...['verify', 'next', 'submit', 'skip'].map(exports.submitByText), ...ofEveryVendor('submit')];
+// Vendor-named first, generic last: the driver takes the first visible match, and a generic selector
+// reached before the vendor's own is how a captcha's answer ends up in a login form's username box.
+exports.TEXT_INPUT_VENDOR_SELECTORS = ofEveryVendor('textInput');
+exports.TEXT_INPUT_SELECTORS = [...exports.TEXT_INPUT_VENDOR_SELECTORS,
+    'input[name*="captcha" i]', 'input[id*="captcha" i]', 'input[aria-label*="captcha" i]',
+    'input[placeholder*="code" i]', 'input[autocomplete="off"][type=text]',
+    'input[type=text]', 'input:not([type])', 'input[type=tel]', 'textarea',
+];
+// `[draggable=true]` is absent: HTML5 DnD fires dragstart, not pointermove.
+exports.SLIDER_HANDLE_SELECTORS = [...ofEveryVendor('sliderHandle'),
+    '[role="slider"]', '[aria-valuenow]',
+    '[class*="slider"][class*="btn"]', '[class*="slider"][class*="button"]',
+    '[class*="slide"][class*="handle"]', '[class*="drag"][class*="thumb"]',
+];
+exports.PIECE_SELECTORS = [...ofEveryVendor('piece'), '[class*="puzzle"][class*="piece"]', '[class*="jigsaw"]'];

package/dist/slide-geometry.d.ts

@@ -1,33 +1,6 @@
-/**
- * The algebra behind a puzzle-piece slider's closed loop.
- *
- * Split out of solver.ts because it is the one part of this feature that is
- * pure arithmetic, duplicated across the two ports, and impossible to notice
- * drifting: a wrong ratio here does not throw, it just releases the piece in the
- * wrong place, and the puzzle fails the way an unsolved puzzle fails. Keeping it
- * dependency-free means it can be unit-tested with `node --test` alongside
- * limits.ts, against the same cases as
- * `PageSolver._solve_slide_geometry` in the Python port.
- */
-/**
- * Piece width and handle-to-piece travel ratio, from probe measurements.
- *
- * Each measurement is `[handle offset, width of what changed]`, where the width
- * spans the piece's ORIGINAL left edge to its CURRENT right edge — so
- * `width = pieceWidth + ratio x offset`. Two of them determine both unknowns.
- *
- * With only one usable measurement the system is underdetermined, so `ratio` is
- * ASSUMED to be 1 — true of every vendor observed, and the assumption is stated
- * here rather than buried as a default. A ratio solved from implausible
- * measurements (a redraw, a piece that hit the wall between probes) is rejected
- * the same way: better a 1:1 guess that overshoots and gets corrected than a
- * ratio of 0.02 that sends the handle off the track and, under camoufox, into a
- * mouse move that never returns.
- *
- * `pieceWidth: null` means "could not measure" — the caller falls back to
- * steering by the handle's own travel.
- */
 export declare function solveSlideGeometry(widths: Array<[number, number]>, widgetWidth: number): {
     pieceWidth: number | null;
     ratio: number;
 };
+export declare const MIN_PIECE_PX = 3;
+export declare const MAX_PIECE_FRACTION = 0.6;

package/dist/slide-geometry.js

@@ -1,64 +1,38 @@
 "use strict";
-/**
- * The algebra behind a puzzle-piece slider's closed loop.
- *
- * Split out of solver.ts because it is the one part of this feature that is
- * pure arithmetic, duplicated across the two ports, and impossible to notice
- * drifting: a wrong ratio here does not throw, it just releases the piece in the
- * wrong place, and the puzzle fails the way an unsolved puzzle fails. Keeping it
- * dependency-free means it can be unit-tested with `node --test` alongside
- * limits.ts, against the same cases as
- * `PageSolver._solve_slide_geometry` in the Python port.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PIECE_FRACTION = exports.MIN_PIECE_PX = void 0;
 exports.solveSlideGeometry = solveSlideGeometry;
-/**
- * Piece width and handle-to-piece travel ratio, from probe measurements.
- *
- * Each measurement is `[handle offset, width of what changed]`, where the width
- * spans the piece's ORIGINAL left edge to its CURRENT right edge — so
- * `width = pieceWidth + ratio x offset`. Two of them determine both unknowns.
- *
- * With only one usable measurement the system is underdetermined, so `ratio` is
- * ASSUMED to be 1 — true of every vendor observed, and the assumption is stated
- * here rather than buried as a default. A ratio solved from implausible
- * measurements (a redraw, a piece that hit the wall between probes) is rejected
- * the same way: better a 1:1 guess that overshoots and gets corrected than a
- * ratio of 0.02 that sends the handle off the track and, under camoufox, into a
- * mouse move that never returns.
- *
- * `pieceWidth: null` means "could not measure" — the caller falls back to
- * steering by the handle's own travel.
- */
+// Literals here match page_solver.py::_solve_slide_geometry; the ratio is assumed 1:1 unless two probes prove otherwise,
+// which is true of every vendor observed.
 function solveSlideGeometry(widths, widgetWidth) {
     if (!widths.length)
         return { pieceWidth: null, ratio: 1 };
     let ratio = 1;
     let pieceWidth = null;
-    if (widths.length >= 2) {
-        const [o1, w1] = widths[0];
-        const [o2, w2] = widths[widths.length - 1];
-        if (o2 !== o1) {
-            const candidate = (w2 - w1) / (o2 - o1);
-            if (candidate >= MIN_RATIO && candidate <= MAX_RATIO) {
-                ratio = candidate;
-                pieceWidth = w1 - ratio * o1;
-            }
+    // The widest-apart pair, not the last two: 1px rounding between neighbouring probes once gave a ratio of 0.5.
+    const sorted = [...widths].sort((a, b) => a[0] - b[0]);
+    const [o1, w1] = sorted[0];
+    const [o2, w2] = sorted[sorted.length - 1];
+    if (o2 - o1 >= MIN_OFFSET_SPREAD_PX) {
+        const candidate = (w2 - w1) / (o2 - o1);
+        if (candidate >= MIN_RATIO && candidate <= MAX_RATIO) {
+            ratio = candidate;
+            pieceWidth = w1 - ratio * o1;
         }
     }
     if (pieceWidth === null) {
         const [o, w] = widths[widths.length - 1];
         pieceWidth = w - ratio * o;
     }
-    // A piece narrower than a few pixels, or wider than half the widget, is a
-    // measurement of something else — a wholesale redraw, a fade, a spinner.
-    if (pieceWidth < MIN_PIECE_PX || pieceWidth > widgetWidth * MAX_PIECE_FRACTION) {
+    if (pieceWidth < exports.MIN_PIECE_PX || pieceWidth > widgetWidth * exports.MAX_PIECE_FRACTION) {
         return { pieceWidth: null, ratio };
     }
     return { pieceWidth, ratio };
 }
-// Keep these identical to the literals in page_solver.py::_solve_slide_geometry.
+// Box widths are ±1px, so the ratio error is ±2/spread: ±0.13 at 16px against ±0.5 at 4px, multiplied into every correction.
+const MIN_OFFSET_SPREAD_PX = 16.0;
+// A ratio of 0.02 from a redraw sends the handle off the track and, under camoufox, into a mouse move that never returns.
 const MIN_RATIO = 0.2;
 const MAX_RATIO = 3.0;
-const MIN_PIECE_PX = 3.0;
-const MAX_PIECE_FRACTION = 0.6;
+exports.MIN_PIECE_PX = 3.0;
+exports.MAX_PIECE_FRACTION = 0.6;