nothing-browser 0.0.21 → 0.1.0

package/piggy/export/index.ts

@@ -0,0 +1,147 @@
+// piggy/export/index.ts
+import { PiggyClient } from "../client";
+import type { CapturedRequest, WebSocketFrame, CapturedCookie } from "../capture";
+import type { SessionPaths } from "../session";
+
+// ─── Intercept ────────────────────────────────────────────────────────────────
+export interface InterceptRule {
+  pattern: string;
+  block?: boolean;
+  redirect?: string;
+  setHeaders?: Record<string, string>;
+  removeHeaders?: string[];
+}
+
+// ─── Cookie types (defined here, imported by session) ────────────────────────
+export interface CookieSetOptions {
+  name: string;
+  value: string;
+  domain: string;
+  path?: string;
+  httpOnly?: boolean;
+  secure?: boolean;
+  expiry?: number;
+}
+
+export interface CookieDeleteOptions {
+  name: string;
+  domain: string;
+}
+
+// ─── Session export types (re-exported from capture) ────────────────────────
+export type { CapturedRequest, WebSocketFrame, CapturedCookie, SessionPaths };
+
+export interface SessionExport {
+  url: string;
+  requests: CapturedRequest[];
+  ws: WebSocketFrame[];
+  cookies: CapturedCookie[];
+}
+
+export interface ExposedFunctionCall {
+  name: string;
+  callId: string;
+  data: string;
+  tabId: string;
+}
+
+// ─── ExportClient ─────────────────────────────────────────────────────────────
+export class ExportClient {
+  constructor(private client: PiggyClient) {}
+
+  // DOM fetch
+  searchCss(query: string, tabId = "default"): Promise<any> {
+    return this.client.send("search.css", { query, tabId });
+  }
+
+  searchId(query: string, tabId = "default"): Promise<any> {
+    return this.client.send("search.id", { query, tabId });
+  }
+
+  // Cookies
+  setCookie(opts: CookieSetOptions, tabId = "default"): Promise<void> {
+    return this.client.send("cookie.set", { ...opts, tabId });
+  }
+
+  deleteCookie(opts: CookieDeleteOptions, tabId = "default"): Promise<void> {
+    return this.client.send("cookie.delete", { ...opts, tabId });
+  }
+
+  // Session
+  sessionReload(tabId = "default"): Promise<void> {
+    return this.client.send("session.reload", { tabId });
+  }
+
+  cookiesPath(): Promise<string> {
+    return this.client.send("session.cookies.path", {});
+  }
+
+  profilePath(): Promise<string> {
+    return this.client.send("session.profile.path", {});
+  }
+
+  wsPath(): Promise<string> {
+    return this.client.send("session.ws.path", {});
+  }
+
+  pingsPath(): Promise<string> {
+    return this.client.send("session.pings.path", {});
+  }
+
+  sessionPaths(): Promise<SessionPaths> {
+    return this.client.send("session.paths", {});
+  }
+
+  setWsSave(enabled: boolean): Promise<void> {
+    return this.client.send("session.ws.save", { enabled });
+  }
+
+  setPingsSave(enabled: boolean): Promise<void> {
+    return this.client.send("session.pings.save", { enabled });
+  }
+
+  // Intercept rules
+  addInterceptRule(rule: InterceptRule, tabId = "default"): Promise<void> {
+    return this.client.send("intercept.rule.add", { ...rule, tabId });
+  }
+
+  clearInterceptRules(tabId = "default"): Promise<void> {
+    return this.client.send("intercept.rule.clear", { tabId });
+  }
+
+  // Session export / import
+  async exportSession(tabId = "default"): Promise<SessionExport> {
+    const raw = await this.client.send<string>("session.export", { tabId });
+    return typeof raw === "string" ? JSON.parse(raw) : raw;
+  }
+
+  importSession(data: SessionExport, tabId = "default"): Promise<void> {
+    return this.client.send("session.import", {
+      data: JSON.stringify(data),
+      tabId,
+    });
+  }
+
+  // Exposed functions
+  exposeFunction(name: string, tabId = "default"): Promise<void> {
+    return this.client.send("expose.function", { name, tabId });
+  }
+
+  resolveExposed(callId: string, result: string, isError = false, tabId = "default"): Promise<void> {
+    return this.client.send("exposed.result", { callId, result, isError, tabId });
+  }
+
+  // Init scripts
+  addInitScript(js: string, tabId = "default"): Promise<void> {
+    return this.client.send("addInitScript", { js, tabId });
+  }
+
+  // Events
+  onExposedFunctionCalled(tabId: string, handler: (call: ExposedFunctionCall) => void): () => void {
+    return this.client.onEvent("exposed_call", tabId, handler);
+  }
+}
+
+export function createExportAPI(client: PiggyClient): ExportClient {
+  return new ExportClient(client);
+}

package/piggy/find/index.d.ts

@@ -0,0 +1,79 @@
+// piggy/find/index.d.ts
+import { PiggyClient } from "../client";
+
+// ─── Element descriptor ───────────────────────────────────────────────────────
+
+export interface ElementDescriptor {
+  tag: string;
+  id: string;
+  cls: string;
+  /** First 400 chars of innerText */
+  text: string;
+  /** First 800 chars of innerHTML */
+  html: string;
+  href: string;
+  src: string;
+  value: string;
+  attrs: Record<string, string>;
+}
+
+// ─── Option types ─────────────────────────────────────────────────────────────
+
+export interface FindByTextOptions {
+  text: string;
+  selector?: string;
+  exact?: boolean;
+}
+
+export interface FindByAttrOptions {
+  attr: string;
+  value?: string;
+  selector?: string;
+}
+
+export interface FindByRoleOptions {
+  role: string;
+  name?: string;
+}
+
+export interface FindClosestOptions {
+  selector: string;
+  ancestor: string;
+}
+
+export interface FindFilterOptions {
+  selector: string;
+  attr: string;
+  value: string;
+}
+
+// ─── FindClient ───────────────────────────────────────────────────────────────
+
+export declare class FindClient {
+  constructor(client: PiggyClient);
+
+  // Multi-result
+  css(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+  all(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+  first(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+  byText(opts: FindByTextOptions, tabId?: string): Promise<ElementDescriptor[]>;
+  byAttr(opts: FindByAttrOptions, tabId?: string): Promise<ElementDescriptor[]>;
+  byTag(tag: string, tabId?: string): Promise<ElementDescriptor[]>;
+  byPlaceholder(text: string, tabId?: string): Promise<ElementDescriptor[]>;
+  byRole(opts: FindByRoleOptions, tabId?: string): Promise<ElementDescriptor[]>;
+  children(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+  filter(opts: FindFilterOptions, tabId?: string): Promise<ElementDescriptor[]>;
+
+  // Traversal
+  closest(opts: FindClosestOptions, tabId?: string): Promise<ElementDescriptor[]>;
+  parent(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+
+  // Boolean / numeric
+  count(selector: string, tabId?: string): Promise<number>;
+  exists(selector: string, tabId?: string): Promise<boolean>;
+  visible(selector: string, tabId?: string): Promise<boolean>;
+  enabled(selector: string, tabId?: string): Promise<boolean>;
+  checked(selector: string, tabId?: string): Promise<boolean>;
+}
+
+export declare function createFindAPI(client: PiggyClient): FindClient;

package/piggy/find/index.ts

@@ -0,0 +1,165 @@
+// piggy/find/index.ts
+import { PiggyClient } from "../client";
+
+// ─── Element descriptor ───────────────────────────────────────────────────────
+// Mirrors __nb_serialize() in PiggyFind.cpp
+
+export interface ElementDescriptor {
+  tag: string;
+  id: string;
+  cls: string;
+  /** First 400 chars of innerText */
+  text: string;
+  /** First 800 chars of innerHTML */
+  html: string;
+  href: string;
+  src: string;
+  value: string;
+  attrs: Record<string, string>;
+}
+
+// ─── Option types ─────────────────────────────────────────────────────────────
+
+export interface FindByTextOptions {
+  text: string;
+  /** Narrow the search to descendants of this CSS selector. */
+  selector?: string;
+  /** If true, innerText must match exactly (trimmed). Default: false. */
+  exact?: boolean;
+}
+
+export interface FindByAttrOptions {
+  attr: string;
+  /** If omitted, matches any element that has the attribute at all. */
+  value?: string;
+  /** Optionally scope to a parent selector. */
+  selector?: string;
+}
+
+export interface FindByRoleOptions {
+  role: string;
+  /** Filter by aria-label or innerText containing this string. */
+  name?: string;
+}
+
+export interface FindClosestOptions {
+  /** CSS selector for the starting element. */
+  selector: string;
+  /** CSS selector for the ancestor to climb to. */
+  ancestor: string;
+}
+
+export interface FindFilterOptions {
+  selector: string;
+  attr: string;
+  value: string;
+}
+
+// ─── FindClient ───────────────────────────────────────────────────────────────
+
+export class FindClient {
+  constructor(private client: PiggyClient) {}
+
+  // ── Multi-result queries ─────────────────────────────────────────────────────
+
+  /** querySelectorAll — returns all matching elements. */
+  css(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.css", { selector, tabId });
+  }
+
+  /** Alias for css() — querySelectorAll. */
+  all(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.all", { selector, tabId });
+  }
+
+  /** querySelector — returns a single-element array or []. */
+  first(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.first", { selector, tabId });
+  }
+
+  /** Find elements whose innerText contains (or exactly matches) the given text. */
+  byText(opts: FindByTextOptions, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byText", { ...opts, tabId });
+  }
+
+  /** Find elements by attribute name and optional value. */
+  byAttr(opts: FindByAttrOptions, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byAttr", { ...opts, tabId });
+  }
+
+  /** getElementsByTagName. */
+  byTag(tag: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byTag", { tag, tabId });
+  }
+
+  /** Find inputs/textareas whose placeholder contains the given text. */
+  byPlaceholder(text: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byPlaceholder", { text, tabId });
+  }
+
+  /** Find elements by ARIA role, optionally filtered by aria-label / innerText. */
+  byRole(opts: FindByRoleOptions, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.byRole", { ...opts, tabId });
+  }
+
+  /** Direct children of the matched element. */
+  children(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.children", { selector, tabId });
+  }
+
+  /**
+   * Filter querySelectorAll results by attribute value substring.
+   * Equivalent to: querySelectorAll(selector).filter(el => el.attr.includes(value))
+   */
+  filter(opts: FindFilterOptions, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.filter", { ...opts, tabId });
+  }
+
+  // ── Single-element traversal ──────────────────────────────────────────────
+
+  /** Walk up the DOM from selector until ancestor matches. */
+  closest(opts: FindClosestOptions, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.closest", { ...opts, tabId });
+  }
+
+  /** parentElement of the matched element. */
+  parent(selector: string, tabId = "default"): Promise<ElementDescriptor[]> {
+    return this.client.send("find.parent", { selector, tabId });
+  }
+
+  // ── Boolean / numeric queries ─────────────────────────────────────────────
+
+  /** Number of elements matching the selector. */
+  count(selector: string, tabId = "default"): Promise<number> {
+    return this.client.send("find.count", { selector, tabId });
+  }
+
+  /** True if at least one element matches the selector. */
+  exists(selector: string, tabId = "default"): Promise<boolean> {
+    return this.client.send("find.exists", { selector, tabId });
+  }
+
+  /**
+   * True if the first matched element is visible
+   * (display !== none, visibility !== hidden, opacity !== 0).
+   */
+  visible(selector: string, tabId = "default"): Promise<boolean> {
+    return this.client.send("find.visible", { selector, tabId });
+  }
+
+  /** True if the first matched element is not disabled. */
+  enabled(selector: string, tabId = "default"): Promise<boolean> {
+    return this.client.send("find.enabled", { selector, tabId });
+  }
+
+  /** True if the first matched checkbox/radio is checked. */
+  checked(selector: string, tabId = "default"): Promise<boolean> {
+    return this.client.send("find.checked", { selector, tabId });
+  }
+}
+
+// ── Factory helper ────────────────────────────────────────────────────────────
+
+export function createFindAPI(client: PiggyClient): FindClient {
+  return new FindClient(client);
+}

package/piggy/http/index.ts

@@ -0,0 +1,65 @@
+// piggy/http/index.ts
+// Mirrors PiggyHttp.cpp — connects to the HTTP server on port 2005.
+// Use this when you want to talk to the browser over HTTP instead of the unix socket.
+
+export interface HttpClientOptions {
+  host?: string;
+  port?: number;
+  key: string;
+}
+
+export class PiggyHttpClient {
+  private baseUrl: string;
+  private key: string;
+
+  constructor(opts: HttpClientOptions) {
+    const host = opts.host ?? "localhost";
+    const port = opts.port ?? 2005;
+    this.baseUrl = `http://${host}:${port}`;
+    this.key = opts.key;
+  }
+
+  // ── Health check ──────────────────────────────────────────────────────────
+
+  async ping(): Promise<boolean> {
+    try {
+      const res = await fetch(this.baseUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Piggy-Key": this.key,
+        },
+        body: "hello",
+      });
+      const text = await res.text();
+      return text.includes("active");
+    } catch {
+      return false;
+    }
+  }
+
+  // ── Send command ──────────────────────────────────────────────────────────
+
+  async send<T = any>(cmd: string, payload: Record<string, any> = {}): Promise<T> {
+    const res = await fetch(this.baseUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Piggy-Key": this.key,
+      },
+      body: JSON.stringify({ id: String(Date.now()), cmd, payload }),
+    });
+
+    if (res.status === 401) throw new Error("Unauthorized — invalid X-Piggy-Key");
+    if (res.status === 400) throw new Error("Bad request — invalid JSON");
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+
+    const data = await res.json() as { ok: boolean; data: T };
+    if (!data.ok) throw new Error(String(data.data) ?? "command failed");
+    return data.data;
+  }
+}
+
+export function createHttpClient(opts: HttpClientOptions): PiggyHttpClient {
+  return new PiggyHttpClient(opts);
+}

package/piggy/human/index.ts

@@ -1,53 +1,115 @@
-// piggy/human/index.ts
-
-export function randomDelay(min: number, max: number): Promise<void> {
-  return new Promise(r => setTimeout(r, Math.floor(Math.random() * (max - min + 1)) + min));
-}
-
-/**
- * Simulates human typing by introducing ~2 random typos and correcting them.
- * Returns an array of { char, isBackspace } actions to replay.
- */
-export function humanTypeSequence(text: string): string[] {
-  const adjacent: Record<string, string[]> = {
-    a: ["q","w","s","z"], b: ["v","g","h","n"], c: ["x","d","f","v"],
-    d: ["s","e","r","f","c","x"], e: ["w","r","d","s"],
-    f: ["d","r","t","g","v","c"], g: ["f","t","y","h","b","v"],
-    h: ["g","y","u","j","n","b"], i: ["u","o","k","j"],
-    j: ["h","u","i","k","m","n"], k: ["j","i","o","l","m"],
-    l: ["k","o","p"], m: ["n","j","k"], n: ["b","h","j","m"],
-    o: ["i","p","l","k"], p: ["o","l"], q: ["w","a"],
-    r: ["e","t","f","d"], s: ["a","w","e","d","x","z"],
-    t: ["r","y","g","f"], u: ["y","i","h","j"],
-    v: ["c","f","g","b"], w: ["q","e","a","s"],
-    x: ["z","s","d","c"], y: ["t","u","g","h"],
-    z: ["a","s","x"],
-  };
-
-  const actions: string[] = [];
-  const typoIndices = new Set<number>();
-
-  // Pick ~2 random positions to typo (skip short strings)
-  if (text.length > 4) {
-    let tries = 0;
-    while (typoIndices.size < 2 && tries < 20) {
-      typoIndices.add(Math.floor(Math.random() * text.length));
-      tries++;
-    }
-  }
-
-  for (let i = 0; i < text.length; i++) {
-    if (typoIndices.has(i)) {
-      const ch = text[i]!.toLowerCase();
-      const neighbors = adjacent[ch];
-        const typo = neighbors
-        ? neighbors[Math.floor(Math.random() * neighbors.length)] ?? ch
-        : ch;
-      actions.push(typo);        // wrong char
-      actions.push("BACKSPACE"); // correct it
-    }
-    actions.push(text[i]!);
-  }
-
-  return actions;
-}
+// piggy/human/index.ts
+import { PiggyClient } from "../client";
+
+// ─── Local utilities ──────────────────────────────────────────────────────────
+
+export function randomDelay(min: number, max: number): Promise<void> {
+  return new Promise(r => setTimeout(r, Math.floor(Math.random() * (max - min + 1)) + min));
+}
+
+export function humanTypeSequence(text: string): string[] {
+  const adjacent: Record<string, string[]> = {
+    a: ["q","w","s","z"], b: ["v","g","h","n"], c: ["x","d","f","v"],
+    d: ["s","e","r","f","c","x"], e: ["w","r","d","s"],
+    f: ["d","r","t","g","v","c"], g: ["f","t","y","h","b","v"],
+    h: ["g","y","u","j","n","b"], i: ["u","o","k","j"],
+    j: ["h","u","i","k","m","n"], k: ["j","i","o","l","m"],
+    l: ["k","o","p"], m: ["n","j","k"], n: ["b","h","j","m"],
+    o: ["i","p","l","k"], p: ["o","l"], q: ["w","a"],
+    r: ["e","t","f","d"], s: ["a","w","e","d","x","z"],
+    t: ["r","y","g","f"], u: ["y","i","h","j"],
+    v: ["c","f","g","b"], w: ["q","e","a","s"],
+    x: ["z","s","d","c"], y: ["t","u","g","h"],
+    z: ["a","s","x"],
+  };
+
+  const actions: string[] = [];
+  const typoIndices = new Set<number>();
+
+  if (text.length > 4) {
+    let tries = 0;
+    while (typoIndices.size < 2 && tries < 20) {
+      typoIndices.add(Math.floor(Math.random() * text.length));
+      tries++;
+    }
+  }
+
+  for (let i = 0; i < text.length; i++) {
+    if (typoIndices.has(i)) {
+      const ch = text[i]!.toLowerCase();
+      const neighbors = adjacent[ch];
+      const typo = neighbors
+        ? neighbors[Math.floor(Math.random() * neighbors.length)] ?? ch
+        : ch;
+      actions.push(typo);
+      actions.push("BACKSPACE");
+    }
+    actions.push(text[i]!);
+  }
+
+  return actions;
+}
+
+// ─── Profile types ────────────────────────────────────────────────────────────
+
+export type TypingSpeed = "slow" | "normal" | "fast";
+export type ClickDelay  = "cautious" | "normal" | "fast";
+export type ScrollSpeed = "slow" | "normal" | "fast";
+
+export interface HumanProfile {
+  typingSpeed: TypingSpeed;
+  clickDelay:  ClickDelay;
+  scrollSpeed: ScrollSpeed;
+  mouseWiggle: boolean;
+}
+
+export interface HumanSetOptions {
+  typingSpeed?: TypingSpeed;
+  clickDelay?:  ClickDelay;
+  scrollSpeed?: ScrollSpeed;
+  mouseWiggle?: boolean;
+}
+
+export interface HumanTypeOptions {
+  selector: string;
+  text:     string;
+  clear?:   boolean;
+  speed?:   number;
+}
+
+export interface HumanClickOptions {
+  selector: string;
+  force?:   boolean;
+  delay?:   number;
+}
+
+// ─── HumanClient ─────────────────────────────────────────────────────────────
+// Maps 1:1 to PiggyHuman.cpp commands
+
+export class HumanClient {
+  constructor(private client: PiggyClient) {}
+
+  // human.set — update global profile
+  set(opts: HumanSetOptions, tabId = "default"): Promise<HumanProfile> {
+    return this.client.send("human.set", { ...opts, tabId });
+  }
+
+  // human.get — read current profile
+  get(tabId = "default"): Promise<HumanProfile> {
+    return this.client.send("human.get", { tabId });
+  }
+
+  // human.type — char-by-char typing with realistic delays
+  type(opts: HumanTypeOptions, tabId = "default"): Promise<void> {
+    return this.client.send("human.type", { ...opts, tabId });
+  }
+
+  // human.click — delayed click with optional force dispatch
+  click(opts: HumanClickOptions, tabId = "default"): Promise<void> {
+    return this.client.send("human.click", { ...opts, tabId });
+  }
+}
+
+export function createHumanAPI(client: PiggyClient): HumanClient {
+  return new HumanClient(client);
+}