cloakbrowser 0.3.28 → 0.3.29

package/README.md

@@ -230,6 +230,13 @@ const ctx = await launchPersistentContext({
   userDataDir: './my-profile',
   headless: false,
 });
+
+// Load Chrome extensions
+const ctx = await launchPersistentContext({
+  userDataDir: './my-profile',
+  headless: false,
+  extensionPaths: ['./my-extension'],
+});
 ```
 
 This also gives you cookie and localStorage persistence across sessions.

package/dist/args.d.ts

@@ -1,6 +1,3 @@
-/**
- * Shared argument builder for Playwright and Puppeteer wrappers.
- */
 import type { LaunchOptions } from "./types.js";
 /**
  * Build deduplicated Chromium CLI args from stealth defaults + user overrides.

package/dist/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CA4C1D"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CAuD1D"}

package/dist/args.js

@@ -1,6 +1,7 @@
 /**
  * Shared argument builder for Playwright and Puppeteer wrappers.
  */
+import path from "path";
 import { getDefaultStealthArgs } from "./config.js";
 const DEBUG = /\bcloakbrowser\b/.test(process.env.DEBUG ?? "");
 /**
@@ -53,6 +54,12 @@ export function buildArgs(options) {
             seen.set(k, flag);
         }
     }
+    if (options.extensionPaths?.length) {
+        const absPaths = options.extensionPaths.map(p => path.resolve(p));
+        const joined = absPaths.join(",");
+        seen.set("--load-extension", `--load-extension=${joined}`);
+        seen.set("--disable-extensions-except", `--disable-extensions-except=${joined}`);
+    }
     return [...seen.values()];
 }
 //# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,wBAAwB;IACxB,wEAAwE;IACxE,sEAAsE;IACtE,wEAAwE;IACxE,yEAAyE;IACzE,yCAAyC;IACzC,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC/D,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,wBAAwB,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,IAAI,KAAK;oBAAE,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YACtF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,wBAAwB,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAU,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChB,IAAI,KAAK;oBAAE,OAAO,CAAC,KAAK,CAAC,gCAAgC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/dist/human/actionability.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Playwright-style actionability checks for the humanize layer.
+ *
+ * Checks: attached, visible, stable, enabled, editable, receives pointer events.
+ * Retry loop with backoff matching Playwright internals: [100, 250, 500, 1000]ms.
+ */
+import type { Page, Frame, ElementHandle } from 'playwright-core';
+export declare class ActionabilityError extends Error {
+    selector: string;
+    check: string;
+    constructor(selector: string, check: string, message: string);
+}
+export declare class ElementNotAttachedError extends ActionabilityError {
+    constructor(selector: string);
+}
+export declare class ElementNotVisibleError extends ActionabilityError {
+    constructor(selector: string);
+}
+export declare class ElementNotStableError extends ActionabilityError {
+    constructor(selector: string);
+}
+export declare class ElementNotEnabledError extends ActionabilityError {
+    constructor(selector: string);
+}
+export declare class ElementNotEditableError extends ActionabilityError {
+    constructor(selector: string);
+}
+export declare class ElementNotReceivingEventsError extends ActionabilityError {
+    coveringTag: string;
+    constructor(selector: string, coveringTag?: string);
+}
+export type CheckName = 'attached' | 'visible' | 'enabled' | 'editable' | 'pointer_events';
+export declare const CHECKS_CLICK: ReadonlySet<CheckName>;
+export declare const CHECKS_HOVER: ReadonlySet<CheckName>;
+export declare const CHECKS_INPUT: ReadonlySet<CheckName>;
+export declare const CHECKS_FOCUS: ReadonlySet<CheckName>;
+export declare const CHECKS_CHECK: ReadonlySet<CheckName>;
+export declare function ensureActionable(pageOrFrame: Page | Frame, selector: string, checks: ReadonlySet<CheckName>, timeout?: number, force?: boolean): Promise<void>;
+export declare function ensureStable(pageOrFrame: Page | Frame, selector: string, timeout?: number): Promise<void>;
+export declare function checkPointerEvents(pageOrFrame: Page | Frame, selector: string, x: number, y: number, stealth?: {
+    evaluate(expression: string): Promise<any>;
+} | null, timeout?: number): Promise<void>;
+export declare function ensureActionableHandle(el: ElementHandle, checks: ReadonlySet<CheckName>, timeout?: number, force?: boolean): Promise<void>;
+export declare function checkPointerEventsHandle(el: ElementHandle, x: number, y: number, timeout?: number): Promise<void>;
+//# sourceMappingURL=actionability.d.ts.map

package/dist/human/actionability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionability.d.ts","sourceRoot":"","sources":["../../src/human/actionability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMlE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;gBAEF,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM7D;AAED,qBAAa,uBAAwB,SAAQ,kBAAkB;gBACjD,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,sBAAuB,SAAQ,kBAAkB;gBAChD,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,qBAAsB,SAAQ,kBAAkB;gBAC/C,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,sBAAuB,SAAQ,kBAAkB;gBAChD,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,uBAAwB,SAAQ,kBAAkB;gBACjD,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,8BAA+B,SAAQ,kBAAkB;IACpE,WAAW,EAAE,MAAM,CAAC;gBACR,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,MAAkB;CAK9D;AAMD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAE3F,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAAiE,CAAC;AAClH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAAsD,CAAC;AACvG,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAA6E,CAAC;AAC9H,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAA+C,CAAC;AAChG,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CAAiE,CAAC;AAalH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,IAAI,GAAG,KAAK,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,EAC9B,OAAO,GAAE,MAAc,EACvB,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAiDf;AAkBD,wBAAsB,YAAY,CAChC,WAAW,EAAE,IAAI,GAAG,KAAK,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAwBD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,IAAI,GAAG,KAAK,EACzB,QAAQ,EAAE,MAAM,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,GAAG,IAAI,EAC/D,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAMD,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,EAC9B,OAAO,GAAE,MAAc,EACvB,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,aAAa,EACjB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/human/actionability.js

@@ -0,0 +1,274 @@
+/**
+ * Playwright-style actionability checks for the humanize layer.
+ *
+ * Checks: attached, visible, stable, enabled, editable, receives pointer events.
+ * Retry loop with backoff matching Playwright internals: [100, 250, 500, 1000]ms.
+ */
+// ---------------------------------------------------------------------------
+// Error hierarchy
+// ---------------------------------------------------------------------------
+export class ActionabilityError extends Error {
+    selector;
+    check;
+    constructor(selector, check, message) {
+        super(`Element ${JSON.stringify(selector)} failed ${check} check: ${message}`);
+        this.name = 'ActionabilityError';
+        this.selector = selector;
+        this.check = check;
+    }
+}
+export class ElementNotAttachedError extends ActionabilityError {
+    constructor(selector) {
+        super(selector, 'attached', 'element not found in DOM');
+        this.name = 'ElementNotAttachedError';
+    }
+}
+export class ElementNotVisibleError extends ActionabilityError {
+    constructor(selector) {
+        super(selector, 'visible', 'element is not visible');
+        this.name = 'ElementNotVisibleError';
+    }
+}
+export class ElementNotStableError extends ActionabilityError {
+    constructor(selector) {
+        super(selector, 'stable', 'element position is still changing');
+        this.name = 'ElementNotStableError';
+    }
+}
+export class ElementNotEnabledError extends ActionabilityError {
+    constructor(selector) {
+        super(selector, 'enabled', 'element is disabled');
+        this.name = 'ElementNotEnabledError';
+    }
+}
+export class ElementNotEditableError extends ActionabilityError {
+    constructor(selector) {
+        super(selector, 'editable', 'element is not editable');
+        this.name = 'ElementNotEditableError';
+    }
+}
+export class ElementNotReceivingEventsError extends ActionabilityError {
+    coveringTag;
+    constructor(selector, coveringTag = 'unknown') {
+        super(selector, 'pointer_events', `element is covered by <${coveringTag}>`);
+        this.name = 'ElementNotReceivingEventsError';
+        this.coveringTag = coveringTag;
+    }
+}
+export const CHECKS_CLICK = new Set(['attached', 'visible', 'enabled', 'pointer_events']);
+export const CHECKS_HOVER = new Set(['attached', 'visible', 'pointer_events']);
+export const CHECKS_INPUT = new Set(['attached', 'visible', 'enabled', 'editable', 'pointer_events']);
+export const CHECKS_FOCUS = new Set(['attached', 'visible', 'enabled']);
+export const CHECKS_CHECK = new Set(['attached', 'visible', 'enabled', 'pointer_events']);
+const BACKOFF_MS = [100, 250, 500, 1000];
+function backoffSleep(attempt) {
+    const idx = Math.min(attempt, BACKOFF_MS.length - 1);
+    return new Promise(resolve => setTimeout(resolve, BACKOFF_MS[idx]));
+}
+// ---------------------------------------------------------------------------
+// Pre-scroll actionability
+// ---------------------------------------------------------------------------
+export async function ensureActionable(pageOrFrame, selector, checks, timeout = 30000, force = false) {
+    if (force)
+        return;
+    const deadline = Date.now() + timeout;
+    let attempt = 0;
+    let lastError = null;
+    while (true) {
+        const remainingMs = Math.max(0, deadline - Date.now());
+        if (remainingMs <= 0) {
+            if (lastError)
+                throw lastError;
+            throw new ActionabilityError(selector, 'timeout', 'timeout expired before first check');
+        }
+        try {
+            const loc = pageOrFrame.locator(selector).first();
+            if (checks.has('attached')) {
+                try {
+                    await loc.waitFor({ state: 'attached', timeout: Math.max(1, Math.min(remainingMs, 2000)) });
+                }
+                catch {
+                    throw new ElementNotAttachedError(selector);
+                }
+            }
+            if (checks.has('visible')) {
+                if (!await loc.isVisible())
+                    throw new ElementNotVisibleError(selector);
+            }
+            if (checks.has('enabled')) {
+                if (!await loc.isEnabled())
+                    throw new ElementNotEnabledError(selector);
+            }
+            if (checks.has('editable')) {
+                if (!await loc.isEditable())
+                    throw new ElementNotEditableError(selector);
+            }
+            return;
+        }
+        catch (e) {
+            if (e instanceof ActionabilityError) {
+                lastError = e;
+                if (Date.now() >= deadline)
+                    throw lastError;
+                await backoffSleep(attempt);
+                attempt++;
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Post-scroll stability check
+// ---------------------------------------------------------------------------
+function boxesDiffer(a, b) {
+    return (Math.abs(a.x - b.x) > 1 ||
+        Math.abs(a.y - b.y) > 1 ||
+        Math.abs(a.width - b.width) > 1 ||
+        Math.abs(a.height - b.height) > 1);
+}
+export async function ensureStable(pageOrFrame, selector, timeout = 5000) {
+    const deadline = Date.now() + timeout;
+    let attempt = 0;
+    while (true) {
+        const remainingMs = Math.max(0, deadline - Date.now());
+        if (remainingMs <= 0)
+            throw new ElementNotStableError(selector);
+        const loc = pageOrFrame.locator(selector).first();
+        const box1 = await loc.boundingBox({ timeout: Math.max(1, Math.min(remainingMs, 1000)) });
+        if (!box1)
+            throw new ElementNotAttachedError(selector);
+        await new Promise(r => setTimeout(r, 100));
+        const box2 = await loc.boundingBox({ timeout: Math.max(1, Math.min(remainingMs, 1000)) });
+        if (!box2)
+            throw new ElementNotAttachedError(selector);
+        if (!boxesDiffer(box1, box2))
+            return;
+        if (Date.now() >= deadline)
+            throw new ElementNotStableError(selector);
+        await backoffSleep(attempt);
+        attempt++;
+    }
+}
+// ---------------------------------------------------------------------------
+// Pointer-events check (post-scroll, at actual click coordinates)
+// ---------------------------------------------------------------------------
+const POINTER_EVENTS_LOCATOR_JS = `(expected, coords) => {
+  const target = document.elementFromPoint(coords.x, coords.y);
+  if (!target) return { hit: false, reason: 'no_element_at_point', covering: 'none' };
+  let node = target;
+  while (node) { if (node === expected) return { hit: true }; node = node.parentNode; }
+  if (expected.contains(target)) return { hit: true };
+  return { hit: false, reason: 'covered', covering: target.tagName || 'unknown' };
+}`;
+const POINTER_EVENTS_HANDLE_JS = `(expected, coords) => {
+  const target = document.elementFromPoint(coords.x, coords.y);
+  if (!target) return { hit: false, reason: 'no_element_at_point', covering: 'none' };
+  let node = target;
+  while (node) { if (node === expected) return { hit: true }; node = node.parentNode; }
+  if (expected.contains(target)) return { hit: true };
+  return { hit: false, reason: 'covered', covering: target.tagName || 'unknown' };
+}`;
+export async function checkPointerEvents(pageOrFrame, selector, x, y, stealth, timeout = 5000) {
+    const deadline = Date.now() + timeout;
+    let attempt = 0;
+    const coords = { x, y };
+    while (true) {
+        let result = null;
+        try {
+            const loc = pageOrFrame.locator(selector).first();
+            result = await loc.evaluate(POINTER_EVENTS_LOCATOR_JS, coords);
+        }
+        catch {
+            result = null;
+        }
+        if (result && result.hit)
+            return;
+        const covering = result?.covering ?? 'unknown';
+        if (Date.now() >= deadline)
+            throw new ElementNotReceivingEventsError(selector, covering);
+        await backoffSleep(attempt);
+        attempt++;
+    }
+}
+// ---------------------------------------------------------------------------
+// ElementHandle variant
+// ---------------------------------------------------------------------------
+export async function ensureActionableHandle(el, checks, timeout = 30000, force = false) {
+    if (force)
+        return;
+    const deadline = Date.now() + timeout;
+    let attempt = 0;
+    let lastError = null;
+    const label = '<ElementHandle>';
+    while (true) {
+        const remainingMs = Math.max(0, deadline - Date.now());
+        if (remainingMs <= 0) {
+            if (lastError)
+                throw lastError;
+            throw new ActionabilityError(label, 'timeout', 'timeout expired before first check');
+        }
+        try {
+            if (checks.has('visible')) {
+                try {
+                    await el.waitForElementState('visible', { timeout: Math.max(1, Math.min(remainingMs, 2000)) });
+                }
+                catch {
+                    throw new ElementNotVisibleError(label);
+                }
+            }
+            if (checks.has('enabled')) {
+                try {
+                    await el.waitForElementState('enabled', { timeout: Math.max(1, Math.min(remainingMs, 2000)) });
+                }
+                catch {
+                    throw new ElementNotEnabledError(label);
+                }
+            }
+            if (checks.has('editable')) {
+                try {
+                    await el.waitForElementState('editable', { timeout: Math.max(1, Math.min(remainingMs, 2000)) });
+                }
+                catch {
+                    throw new ElementNotEditableError(label);
+                }
+            }
+            return;
+        }
+        catch (e) {
+            if (e instanceof ActionabilityError) {
+                lastError = e;
+                if (Date.now() >= deadline)
+                    throw lastError;
+                await backoffSleep(attempt);
+                attempt++;
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+}
+export async function checkPointerEventsHandle(el, x, y, timeout = 5000) {
+    const deadline = Date.now() + timeout;
+    let attempt = 0;
+    const coords = { x, y };
+    while (true) {
+        let result;
+        try {
+            result = await el.evaluate(POINTER_EVENTS_HANDLE_JS, coords);
+        }
+        catch {
+            result = null;
+        }
+        if (result && result.hit)
+            return;
+        const covering = result?.covering ?? 'unknown';
+        if (Date.now() >= deadline)
+            throw new ElementNotReceivingEventsError('<ElementHandle>', covering);
+        await backoffSleep(attempt);
+        attempt++;
+    }
+}
+//# sourceMappingURL=actionability.js.map

package/dist/human/actionability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionability.js","sourceRoot":"","sources":["../../src/human/actionability.ts"],"names":[],"mappings":"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"}

package/dist/human/config.d.ts

@@ -50,6 +50,7 @@ export interface HumanConfig {
 export type HumanPreset = 'default' | 'careful';
 export type HumanActionOptions = Partial<HumanConfig> & {
     timeout?: number;
+    force?: boolean;
     human_config?: Partial<HumanConfig>;
 };
 /**

package/dist/human/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/human/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/human/config.ts"],"names":[],"mappings":"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"}

package/dist/human/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/human/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,cAAc,GAAgB;IAClC,WAAW;IACX,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,mBAAmB,EAAE,GAAG;IACxB,kBAAkB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAClB,kBAAkB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAChC,qBAAqB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAEhC,mBAAmB;IACnB,mBAAmB,EAAE,CAAC;IACtB,eAAe,EAAE,EAAE;IACnB,eAAe,EAAE,EAAE;IACnB,gBAAgB,EAAE,GAAG;IACrB,sBAAsB,EAAE,IAAI;IAC5B,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxB,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;IAE1B,iBAAiB;IACjB,qBAAqB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAChC,sBAAsB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC3B,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC5B,mBAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAEjC,eAAe;IACf,aAAa,EAAE,CAAC;IAChB,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;IAE7B,SAAS;IACT,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC5B,qBAAqB,EAAE,GAAG;IAC1B,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC3B,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC5B,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,uBAAuB,EAAE,GAAG;IAC5B,mBAAmB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC9B,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC/B,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAChC,qBAAqB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAEjC,mEAAmE;IACnE,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC5B,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAE1B,wDAAwD;IACxD,oBAAoB,EAAE,KAAK;IAC3B,qBAAqB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;CAClC,CAAC;AAEF,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,cAAc,GAAgB;IAClC,GAAG,cAAc;IAEjB,2BAA2B;IAC3B,YAAY,EAAE,GAAG;IACjB,mBAAmB,EAAE,EAAE;IACvB,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAClB,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;IAChC,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAChC,qBAAqB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAEhC,+BAA+B;IAC/B,sBAAsB,EAAE,IAAI;IAC5B,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAE3B,6CAA6C;IAC7C,qBAAqB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAChC,sBAAsB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClC,gBAAgB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAC3B,iBAAiB,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC;IAE5B,kBAAkB;IAClB,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC7B,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC7B,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC/B,qBAAqB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAEjC,kDAAkD;IAClD,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;CAClC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,OAAO,GAAqC;IAChD,OAAO,EAAE,cAAc;IACvB,OAAO,EAAE,cAAc;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAsB,SAAS,EAC/B,SAAgC;IAEhC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,qBAAqB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACnC,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,GAAgB,EAChB,SAAuC;IAEvC,IAAI,CAAC,SAAS;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;AAClC,CAAC;AAGD,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,kCAAkC;AAClC,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,GAAW;IAC3C,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,KAAuB;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/human/config.ts"],"names":[],"mappings":"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"}

package/dist/human/elementhandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elementhandle.d.ts","sourceRoot":"","sources":["../../src/human/elementhandle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAiD,MAAM,YAAY,CAAC;AA+ClG,UAAU,WAAW;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;CACtB;AAOD,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAuSN;AAOD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAoCN;AAOD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAoCN"}
+{"version":3,"file":"elementhandle.d.ts","sourceRoot":"","sources":["../../src/human/elementhandle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAc,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAiD,MAAM,YAAY,CAAC;AAmDlG,UAAU,WAAW;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,EAAE,OAAO,CAAC;CACtB;AAOD,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAuUN;AAOD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAoCN;AAOD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,IAAI,CAoCN"}

package/dist/human/elementhandle.js

@@ -19,6 +19,7 @@ import { rand, randRange, sleep, mergeConfig } from './config.js';
 import { humanMove, humanClick, clickTarget, humanIdle } from './mouse.js';
 import { humanType } from './keyboard.js';
 import { humanScrollIntoView } from './scroll.js';
+import { ensureActionableHandle, checkPointerEventsHandle, CHECKS_CLICK, CHECKS_HOVER, CHECKS_INPUT, CHECKS_FOCUS, CHECKS_CHECK, } from './actionability.js';
 // --- Platform-aware select-all shortcut ---
 const SELECT_ALL = process.platform === 'darwin' ? 'Meta+a' : 'Control+a';
 // ============================================================================
@@ -135,17 +136,29 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
     // --- el.click() ---
     el.click = async (options) => {
         const callCfg = mergeConfig(cfg, options?.human_config ?? options);
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_CLICK, timeout, force);
         const info = await moveToElement(callCfg);
         if (!info)
             return origElClick(options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await humanClick(raw, info.isInp, callCfg);
     };
     // --- el.dblclick() ---
     el.dblclick = async (options) => {
         const callCfg = mergeConfig(cfg, options?.human_config ?? options);
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_CLICK, timeout, force);
         const info = await moveToElement(callCfg);
         if (!info)
             return origElDblclick(options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await raw.down({ clickCount: 2 });
         await sleep(rand(30, 60));
         await raw.up({ clickCount: 2 });
@@ -153,17 +166,26 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
     // --- el.hover() ---
     el.hover = async (options) => {
         const callCfg = mergeConfig(cfg, options?.human_config ?? options);
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_HOVER, timeout, force);
         const info = await moveToElement(callCfg);
         if (!info)
             return origElHover(options);
-        // Just move — no click
     };
     // --- el.type() ---
     el.type = async (text, options) => {
         const callCfg = mergeConfig(cfg, options?.human_config ?? options);
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_INPUT, timeout, force);
         const info = await moveToElement(callCfg);
         if (!info)
             return origElType(text, options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await humanClick(raw, info.isInp, callCfg);
         await sleep(rand(100, 250));
         let cdpSession = null;
@@ -176,12 +198,17 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
     // --- el.fill() ---
     el.fill = async (value, options) => {
         const callCfg = mergeConfig(cfg, options?.human_config ?? options);
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_INPUT, timeout, force);
         const info = await moveToElement(callCfg);
         if (!info)
             return origElFill(value, options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await humanClick(raw, info.isInp, callCfg);
         await sleep(rand(100, 250));
-        // Clear existing content
         await originals.keyboardPress(SELECT_ALL);
         await sleep(rand(30, 80));
         await originals.keyboardPress('Backspace');
@@ -202,6 +229,10 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
     };
     // --- el.selectOption() ---
     el.selectOption = async (values, options) => {
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_FOCUS, timeout, force);
         const info = await moveToElement();
         if (!info)
             return origElSelectOption(values, options);
@@ -211,33 +242,49 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
     };
     // --- el.check() ---
     el.check = async (options) => {
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_CHECK, timeout, force);
         try {
             const checked = await el.isChecked();
             if (checked)
-                return; // Already checked
+                return;
         }
         catch { }
         const info = await moveToElement();
         if (!info)
             return origElCheck(options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await humanClick(raw, info.isInp, cfg);
     };
     // --- el.uncheck() ---
     el.uncheck = async (options) => {
+        const force = options?.force ?? false;
+        const timeout = options?.timeout ?? 30000;
+        if (!force)
+            await ensureActionableHandle(el, CHECKS_CHECK, timeout, force);
         try {
             const checked = await el.isChecked();
             if (!checked)
-                return; // Already unchecked
+                return;
         }
         catch { }
         const info = await moveToElement();
         if (!info)
             return origElUncheck(options);
+        if (!force)
+            await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
         await humanClick(raw, info.isInp, cfg);
     };
     // --- el.setChecked() ---
     if (origElSetChecked) {
         el.setChecked = async (checked, options) => {
+            const force = options?.force ?? false;
+            const timeout = options?.timeout ?? 30000;
+            if (!force)
+                await ensureActionableHandle(el, CHECKS_CHECK, timeout, force);
             try {
                 const current = await el.isChecked();
                 if (current === checked)
@@ -247,6 +294,8 @@ export function patchSingleElementHandle(el, page, cfg, cursor, raw, rawKb, orig
             const info = await moveToElement();
             if (!info)
                 return origElSetChecked(checked, options);
+            if (!force)
+                await checkPointerEventsHandle(el, cursor.x, cursor.y, Math.min(timeout, 5000));
             await humanClick(raw, info.isInp, cfg);
         };
     }