browserscale-ts 1.2.0 → 1.3.0

package/dist/options.d.ts

@@ -1,3 +1,4 @@
+import type { Locator } from "./locator.ts";
 /** Mouse button used by {@link CloudBrowser.click}. */
 export type Button = "left" | "right" | "middle";
 /** Mouse phase performed by {@link CloudBrowser.click}. */
@@ -24,6 +25,25 @@ export interface ClickOpts {
      */
     action?: ClickAction;
 }
+/**
+ * Optional customization for {@link CloudBrowser.addReaction}. All fields are
+ * optional; missing or zero values mean "use the server default".
+ */
+export interface ReactionOpts {
+    /**
+     * Override the click target. Omit to click the matched element itself.
+     * Provide a `css()`/`js()` {@link Locator} to click a different element,
+     * resolved in the matched element's frame (e.g. a modal's close "X").
+     * `node()`/`at()` locators are rejected.
+     */
+    on?: Locator;
+    /** Mouse button for the click. Default `"left"`. */
+    button?: Button;
+    /** `1` = single click (default), `2` = double-click. */
+    clickCount?: number;
+    /** Poll cadence in milliseconds for the shared page loop. Default 300. */
+    intervalMs?: number;
+}
 /**
  * Optional customization for {@link CloudBrowser.fill}. All fields are
  * optional; missing values mean "use the server default".
@@ -41,6 +61,17 @@ export interface FillOpts {
      * in the field.
      */
     clearFirst?: boolean;
+    /**
+     * Budget in ms to make the field focusable+clickable (locate, scroll,
+     * settle, un-occlude), mirroring the click timeout. Omit for the server
+     * default (5000). `0` makes fill one-shot (no retry).
+     */
+    timeoutMs?: number;
+    /**
+     * Settle window in ms before the focus click, mirroring the click
+     * steady-time. Omit for the server default (750). `0` skips settling.
+     */
+    steadyMs?: number;
 }
 /**
  * Optional customization for {@link CloudBrowser.selectByIndex},

package/dist/types.d.ts

@@ -101,6 +101,31 @@ export interface OccluderInfo {
      */
     hittableWhileInvisible: boolean;
 }
+/**
+ * ElementRef is a lightweight descriptor of an element — enough to identify it
+ * (and decide what to do) without another DOM round-trip. It names the element
+ * that stole focus in a {@link FillError} focus-loss failure.
+ */
+export interface ElementRef {
+    backendNodeId: number;
+    /** Upper-case tag name, e.g. "INPUT", "BUTTON", "DIV". */
+    tagName: string;
+    /** id attribute, if present. */
+    id?: string;
+    /** name attribute, if present. */
+    name?: string;
+    /** class attribute, if present. */
+    className?: string;
+    /** `<input>` type, if the element is an `<input>`. */
+    inputType?: string;
+    /** Whitespace-collapsed textContent/value snippet (max 120 chars). */
+    text?: string;
+    /**
+     * Whether this element is itself an editable text sink (input / textarea /
+     * contenteditable).
+     */
+    editable: boolean;
+}
 /**
  * WaitConditionStatus is the per-condition diagnostic carried by
  * {@link WaitError} when a {@link CloudBrowser.wait} times out: one entry per
@@ -246,3 +271,37 @@ export interface RentResponse {
     acceptLanguage: string;
     fingerprint: string;
 }
+/**
+ * IceServer is one entry for a WebRTC `RTCPeerConnection`'s `iceServers`
+ * config: a TURN (or STUN) URL plus the short-lived credentials to
+ * authenticate with it. Pass these to your peer before creating the offer.
+ */
+export interface IceServer {
+    /** ICE server URLs (e.g. `turn:relay.example.com:3478?transport=udp`). */
+    urls: string[];
+    /** Short-lived TURN REST username (empty for plain STUN). */
+    username: string;
+    /** Short-lived TURN REST credential (empty for plain STUN). */
+    credential: string;
+}
+/**
+ * ReactionInfo describes a still-pending reaction, as returned by
+ * {@link CloudBrowser.listReactions}. One-shot reactions that have already
+ * fired are gone and never appear here.
+ */
+export interface ReactionInfo {
+    /** Stable id assigned by {@link CloudBrowser.addReaction} (pass to removeReaction). */
+    reactionId: string;
+    /** Set if the reaction matches by CSS selector. */
+    matchSelector: string;
+    /** Set if the reaction matches by JS expression. */
+    matchJsExpression: string;
+    /** Set if the click target differs from the matched element. */
+    actionSelector: string;
+    /** Set if the click target differs from the matched element. */
+    actionJsExpression: string;
+    /** Frame scope: `""` for the main frame, a specific frameId, or `AllFrames`. */
+    frameId: string;
+    /** Whether the match additionally requires the element to be visible. */
+    visible: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserscale-ts",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Official SDK for browserscale — undetected stealth browsers in the cloud. Rent real Chromium sessions with unique fingerprints, built-in proxies, captcha solving, human-like input and live video — scale web scraping and automation without running a single browser yourself.",
   "main": "dist/index.js",
   "type": "module",