@ceki/sdk 1.12.0 → 1.13.0

package/dist/index.d.cts

@@ -242,14 +242,23 @@ declare class Browser {
         method: string;
         params?: Record<string, unknown>;
     }, timeout?: number): Promise<unknown>;
-    navigate(url: string, timeout?: number): Promise<{
+    private _humanizeForCall;
+    navigate(url: string, timeout?: number, opts?: {
+        human?: boolean;
+    }): Promise<{
         url: string;
         frameId?: string;
     }>;
-    click(x: number, y: number): Promise<void>;
+    click(x: number, y: number, opts?: {
+        human?: boolean;
+    }): Promise<void>;
     private _sendKeystroke;
-    type(text: string): Promise<void>;
-    scroll(opts?: ScrollOptions): Promise<void>;
+    type(text: string, opts?: {
+        human?: boolean;
+    }): Promise<void>;
+    scroll(opts?: ScrollOptions & {
+        human?: boolean;
+    }): Promise<void>;
     screenshot(opts?: ScreenshotOptions): Promise<{
         data: string;
     } | Buffer>;

package/dist/index.d.ts

@@ -242,14 +242,23 @@ declare class Browser {
         method: string;
         params?: Record<string, unknown>;
     }, timeout?: number): Promise<unknown>;
-    navigate(url: string, timeout?: number): Promise<{
+    private _humanizeForCall;
+    navigate(url: string, timeout?: number, opts?: {
+        human?: boolean;
+    }): Promise<{
         url: string;
         frameId?: string;
     }>;
-    click(x: number, y: number): Promise<void>;
+    click(x: number, y: number, opts?: {
+        human?: boolean;
+    }): Promise<void>;
     private _sendKeystroke;
-    type(text: string): Promise<void>;
-    scroll(opts?: ScrollOptions): Promise<void>;
+    type(text: string, opts?: {
+        human?: boolean;
+    }): Promise<void>;
+    scroll(opts?: ScrollOptions & {
+        human?: boolean;
+    }): Promise<void>;
     screenshot(opts?: ScreenshotOptions): Promise<{
         data: string;
     } | Buffer>;

package/dist/index.js

@@ -655,27 +655,39 @@ var Browser = class _Browser {
       this._sendRaw(msg);
     });
   }
-  async navigate(url, timeout = 3e4) {
-    if (this._humanizer) await this._humanizer.before("navigate");
+  // task 427 — per-call kill-switch. human=false bypasses humanizer timings
+  // AND tells the extension to skip mouse-jitter via the `_ceki_raw` marker
+  // (see cdp.ts). human=true forces humanizer; human undefined = session
+  // default. Global env CEKI_HUMAN_DISABLE=1 nulls this._humanizer in the
+  // constructor so all paths become raw.
+  _humanizeForCall(human) {
+    if (human === false) return null;
+    return this._humanizer;
+  }
+  async navigate(url, timeout = 3e4, opts) {
+    const h = this._humanizeForCall(opts?.human);
+    if (h) await h.before("navigate");
     const result = await this.send({ method: "Page.navigate", params: { url } }, timeout);
-    if (this._humanizer) await this._humanizer.after("navigate");
+    if (h) await h.after("navigate");
     return {
       url: String(result?.url ?? url),
       frameId: result?.frameId ? String(result.frameId) : void 0
     };
   }
-  async click(x, y) {
-    if (this._humanizer) await this._humanizer.before("click");
+  async click(x, y, opts) {
+    const h = this._humanizeForCall(opts?.human);
+    if (h) await h.before("click");
+    const rawFlag = h === null ? { _ceki_raw: true } : {};
     await this.send({
       method: "Input.dispatchMouseEvent",
-      params: { type: "mousePressed", x, y, button: "left", clickCount: 1 }
+      params: { type: "mousePressed", x, y, button: "left", clickCount: 1, ...rawFlag }
     });
     await this.send({
       method: "Input.dispatchMouseEvent",
       params: { type: "mouseReleased", x, y, button: "left", clickCount: 1 }
     });
     this._lastPointer = [x, y];
-    if (this._humanizer) await this._humanizer.after("click");
+    if (h) await h.after("click");
   }
   async _sendKeystroke(char) {
     const mapping = keymapForChar(char);
@@ -721,9 +733,10 @@ var Browser = class _Browser {
       });
     }
   }
-  async type(text) {
-    if (this._humanizer) {
-      await this._humanizer.before("type");
+  async type(text, opts) {
+    const h = this._humanizeForCall(opts?.human);
+    if (h) {
+      await h.before("type");
       if (this._lastPointer) {
         const [px, py] = this._lastPointer;
         await this.send({
@@ -736,10 +749,10 @@ var Browser = class _Browser {
         });
       }
     }
-    const human = this._humanizer ? ["natural", "careful"].includes(this._humanizer.profile.name) ? this._humanizer.profile.name : "natural" : null;
+    const human = h ? ["natural", "careful"].includes(h.profile.name) ? h.profile.name : "natural" : null;
     await this.send({ method: "Ceki.typeText", params: { text, human } });
-    if (this._humanizer) {
-      await this._humanizer.after("type");
+    if (h) {
+      await h.after("type");
     }
   }
   async scroll(opts) {
@@ -747,13 +760,14 @@ var Browser = class _Browser {
     const y = opts?.y ?? 0;
     const deltaX = opts?.deltaX ?? 0;
     const deltaY = opts?.deltaY ?? -300;
-    if (this._humanizer) await this._humanizer.before("scroll");
+    const h = this._humanizeForCall(opts?.human);
+    if (h) await h.before("scroll");
     await this.send({
       method: "Input.dispatchMouseEvent",
       params: { type: "mouseWheel", x, y, deltaX, deltaY }
     });
     this._lastPointer = [x, y];
-    if (this._humanizer) await this._humanizer.after("scroll");
+    if (h) await h.after("scroll");
   }
   async screenshot(opts) {
     const format = opts?.format ?? "base64";