nothing-browser 0.0.21 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 BunElysiaReact
+Copyright (c) 2026 BunElysiaReact
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/human/index.js

@@ -52,7 +52,31 @@ function humanTypeSequence(text) {
   }
   return actions;
 }
+
+class HumanClient {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  set(opts, tabId = "default") {
+    return this.client.send("human.set", { ...opts, tabId });
+  }
+  get(tabId = "default") {
+    return this.client.send("human.get", { tabId });
+  }
+  type(opts, tabId = "default") {
+    return this.client.send("human.type", { ...opts, tabId });
+  }
+  click(opts, tabId = "default") {
+    return this.client.send("human.click", { ...opts, tabId });
+  }
+}
+function createHumanAPI(client) {
+  return new HumanClient(client);
+}
 export {
   randomDelay,
-  humanTypeSequence
+  humanTypeSequence,
+  createHumanAPI,
+  HumanClient
 };

package/dist/piggy/captcha/index.d.ts

@@ -0,0 +1,39 @@
+import { PiggyClient } from "../client";
+export interface CaptchaState {
+    detected: boolean;
+    paused: boolean;
+    type: string;
+}
+export interface BlockState {
+    detected: boolean;
+    type: string;
+}
+export declare class CaptchaClient {
+    private client;
+    constructor(client: PiggyClient);
+    status(tabId?: string): Promise<CaptchaState>;
+    resolve(tabId?: string): Promise<void>;
+    pause(tabId?: string): Promise<void>;
+    check(tabId?: string): Promise<void>;
+    setAutoRetry(enabled: boolean): Promise<void>;
+    blockStatus(tabId?: string): Promise<BlockState>;
+    blockRetry(tabId?: string): Promise<void>;
+    onCaptcha(tabId: string, handler: (data: {
+        captchaType: string;
+        tabId: string;
+    }) => void): () => void;
+    onCaptchaResolved(tabId: string, handler: (data: {
+        tabId: string;
+    }) => void): () => void;
+    onBlocked(tabId: string, handler: (data: {
+        blockType: string;
+        tabId: string;
+    }) => void): () => void;
+    onBlockRetry(tabId: string, handler: (data: {
+        tabId: string;
+        proxy: string;
+    }) => void): () => void;
+    waitForResolution(tabId?: string, timeoutMs?: number): Promise<void>;
+}
+export declare function createCaptchaAPI(client: PiggyClient): CaptchaClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/captcha/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/captcha/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIvC,MAAM,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhD,OAAO,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,WAAW,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAInD,UAAU,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAIrG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAIxF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAInG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAMlG,iBAAiB,CAAC,KAAK,SAAY,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBzE;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAEnE"}

package/dist/piggy/capture/index.d.ts

@@ -0,0 +1,48 @@
+import { PiggyClient } from "../client";
+export interface CapturedRequest {
+    method: string;
+    url: string;
+    status: string;
+    type: string;
+    mime: string;
+    reqHeaders: string;
+    reqBody: string;
+    resHeaders: string;
+    resBody: string;
+    size: number;
+    timestamp: string;
+}
+export interface WebSocketFrame {
+    connectionId: string;
+    url: string;
+    direction: string;
+    data: string;
+    binary: boolean;
+    timestamp: string;
+}
+export interface CapturedCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    httpOnly: boolean;
+    secure: boolean;
+    expires: string;
+}
+export interface StorageEntry {
+    key: string;
+    value: string;
+}
+export declare class CaptureClient {
+    private client;
+    constructor(client: PiggyClient);
+    start(tabId?: string): Promise<void>;
+    stop(tabId?: string): Promise<void>;
+    requests(tabId?: string): Promise<CapturedRequest[]>;
+    ws(tabId?: string): Promise<WebSocketFrame[]>;
+    cookies(tabId?: string): Promise<CapturedCookie[]>;
+    storage(tabId?: string): Promise<StorageEntry[]>;
+    clear(tabId?: string): Promise<void>;
+}
+export declare function createCaptureAPI(client: PiggyClient): CaptureClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/capture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/capture/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,QAAQ,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIvD,EAAE,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIhD,OAAO,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIrD,OAAO,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAInD,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAEnE"}

package/dist/piggy/dialog/index.d.ts

@@ -0,0 +1,28 @@
+import { PiggyClient } from "../client";
+export interface DialogState {
+    pending: boolean;
+    type: string;
+    message: string;
+    defaultValue: string;
+}
+interface DialogEventData {
+    dialogType: string;
+    message: string;
+    defaultValue: string;
+    tabId: string;
+}
+export declare class DialogClient {
+    private client;
+    constructor(client: PiggyClient);
+    accept(tabId?: string, text?: string): Promise<void>;
+    dismiss(tabId?: string): Promise<void>;
+    status(tabId?: string): Promise<DialogState>;
+    setAutoAction(tabId: string | undefined, action: "accept" | "dismiss" | ""): Promise<void>;
+    upload(selector: string, filePath: string, tabId?: string): Promise<void>;
+    onDialog(tabId: string, handler: (data: DialogEventData) => void): () => void;
+    waitAndAccept(tabId?: string, text?: string, timeoutMs?: number): Promise<DialogEventData>;
+    waitAndDismiss(tabId?: string, timeoutMs?: number): Promise<DialogEventData>;
+}
+export declare function createDialogAPI(client: PiggyClient): DialogClient;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/dialog/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAGD,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,MAAM,CAAC,KAAK,SAAY,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C,aAAa,CAAC,KAAK,oBAAY,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GACvC,MAAM,IAAI;IAIb,aAAa,CAAC,KAAK,SAAY,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB7F,cAAc,CAAC,KAAK,SAAY,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;CAehF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}

package/dist/piggy/export/index.d.ts

@@ -0,0 +1,62 @@
+import { PiggyClient } from "../client";
+import type { CapturedRequest, WebSocketFrame, CapturedCookie } from "../capture";
+import type { SessionPaths } from "../session";
+export interface InterceptRule {
+    pattern: string;
+    block?: boolean;
+    redirect?: string;
+    setHeaders?: Record<string, string>;
+    removeHeaders?: string[];
+}
+export interface CookieSetOptions {
+    name: string;
+    value: string;
+    domain: string;
+    path?: string;
+    httpOnly?: boolean;
+    secure?: boolean;
+    expiry?: number;
+}
+export interface CookieDeleteOptions {
+    name: string;
+    domain: string;
+}
+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;
+}
+export declare class ExportClient {
+    private client;
+    constructor(client: PiggyClient);
+    searchCss(query: string, tabId?: string): Promise<any>;
+    searchId(query: string, tabId?: string): Promise<any>;
+    setCookie(opts: CookieSetOptions, tabId?: string): Promise<void>;
+    deleteCookie(opts: CookieDeleteOptions, tabId?: string): Promise<void>;
+    sessionReload(tabId?: string): Promise<void>;
+    cookiesPath(): Promise<string>;
+    profilePath(): Promise<string>;
+    wsPath(): Promise<string>;
+    pingsPath(): Promise<string>;
+    sessionPaths(): Promise<SessionPaths>;
+    setWsSave(enabled: boolean): Promise<void>;
+    setPingsSave(enabled: boolean): Promise<void>;
+    addInterceptRule(rule: InterceptRule, tabId?: string): Promise<void>;
+    clearInterceptRules(tabId?: string): Promise<void>;
+    exportSession(tabId?: string): Promise<SessionExport>;
+    importSession(data: SessionExport, tabId?: string): Promise<void>;
+    exposeFunction(name: string, tabId?: string): Promise<void>;
+    resolveExposed(callId: string, result: string, isError?: boolean, tabId?: string): Promise<void>;
+    addInitScript(js: string, tabId?: string): Promise<void>;
+    onExposedFunctionCalled(tabId: string, handler: (call: ExposedFunctionCall) => void): () => void;
+}
+export declare function createExportAPI(client: PiggyClient): ExportClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/export/index.d.ts.map

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

package/dist/piggy/find/index.d.ts

@@ -0,0 +1,52 @@
+import { PiggyClient } from "../client";
+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>;
+}
+export declare class FindClient {
+    private client;
+    constructor(client: PiggyClient);
+    /** querySelectorAll — returns all matching elements. */
+    css(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Alias for css(). */
+    all(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** querySelector — returns a single-element array or []. */
+    first(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements whose innerText contains the given text. */
+    byText(text: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements by attribute name (and optional value). */
+    byAttr(attr: string, value?: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** getElementsByTagName. */
+    byTag(tag: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find inputs/textareas whose placeholder contains the given text. */
+    byPlaceholder(text: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Find elements by ARIA role, optionally filtered by accessible name. */
+    byRole(role: string, name?: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Direct children of the matched element. */
+    children(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** parentElement of the matched element. */
+    parent(selector: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Walk up the DOM from selector until ancestor matches. */
+    closest(selector: string, ancestor: string, tabId?: string): Promise<ElementDescriptor[]>;
+    /** Number of elements matching the selector. */
+    count(selector: string, tabId?: string): Promise<number>;
+    /** True if at least one element matches. */
+    exists(selector: string, tabId?: string): Promise<boolean>;
+    /** True if the first matched element is visible. */
+    visible(selector: string, tabId?: string): Promise<boolean>;
+    /** True if the first matched element is not disabled. */
+    enabled(selector: string, tabId?: string): Promise<boolean>;
+    /** True if the first matched checkbox/radio is checked. */
+    checked(selector: string, tabId?: string): Promise<boolean>;
+}
+export declare function createFindAPI(client: PiggyClient): FindClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/find/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/find/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAKxC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAI,MAAM,CAAC;IACd,EAAE,EAAK,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAG,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAOD,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIvC,wDAAwD;IACxD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItE,uBAAuB;IACvB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItE,4DAA4D;IAC5D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxE,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrE,4DAA4D;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrF,4BAA4B;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAInE,uEAAuE;IACvE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI5E,0EAA0E;IAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIpF,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI3E,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAM5F,gDAAgD;IAChD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,oDAAoD;IACpD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,yDAAyD;IACzD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAE7D"}

package/dist/piggy/http/index.d.ts

@@ -0,0 +1,14 @@
+export interface HttpClientOptions {
+    host?: string;
+    port?: number;
+    key: string;
+}
+export declare class PiggyHttpClient {
+    private baseUrl;
+    private key;
+    constructor(opts: HttpClientOptions);
+    ping(): Promise<boolean>;
+    send<T = any>(cmd: string, payload?: Record<string, any>): Promise<T>;
+}
+export declare function createHttpClient(opts: HttpClientOptions): PiggyHttpClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/http/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;gBAER,IAAI,EAAE,iBAAiB;IAS7B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBxB,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAkBhF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAEzE"}

package/dist/piggy/human/index.d.ts

@@ -1,7 +1,39 @@
+import { PiggyClient } from "../client";
 export declare function randomDelay(min: number, max: number): Promise<void>;
-/**
- * Simulates human typing by introducing ~2 random typos and correcting them.
- * Returns an array of { char, isBackspace } actions to replay.
- */
 export declare function humanTypeSequence(text: string): string[];
+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;
+}
+export declare class HumanClient {
+    private client;
+    constructor(client: PiggyClient);
+    set(opts: HumanSetOptions, tabId?: string): Promise<HumanProfile>;
+    get(tabId?: string): Promise<HumanProfile>;
+    type(opts: HumanTypeOptions, tabId?: string): Promise<void>;
+    click(opts: HumanClickOptions, tabId?: string): Promise<void>;
+}
+export declare function createHumanAPI(client: PiggyClient): HumanClient;
 //# sourceMappingURL=index.d.ts.map

package/dist/piggy/human/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/human/index.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0CxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/human/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAyCxD;AAID,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,UAAU,GAAI,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAG,UAAU,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAG,UAAU,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,OAAO,CAAC;IAClB,KAAK,CAAC,EAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAI,OAAO,CAAC;IAClB,KAAK,CAAC,EAAI,MAAM,CAAC;CAClB;AAKD,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAGvC,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAKpE,GAAG,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAK7C,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE/D"}

package/dist/piggy/iframe/index.d.ts

@@ -0,0 +1,53 @@
+import { PiggyClient } from "../client";
+export interface IframeDescriptor {
+    index: number;
+    src: string;
+    id: string;
+    name: string;
+}
+/** Target an iframe by its index or src. One must be provided. */
+export type IframeTarget = {
+    index: number;
+    src?: never;
+} | {
+    src: string;
+    index?: never;
+};
+export type IframeEvaluateOptions = IframeTarget & {
+    js: string;
+};
+export type IframeClickOptions = IframeTarget & {
+    sel: string;
+};
+export type IframeTypeOptions = IframeTarget & {
+    sel: string;
+    text: string;
+};
+export type IframeTextOptions = IframeTarget & {
+    sel: string;
+};
+export type IframeHtmlOptions = IframeTarget;
+export type IframeWaitSelOptions = IframeTarget & {
+    sel: string;
+    timeout?: number;
+};
+export declare class IframeClient {
+    private client;
+    constructor(client: PiggyClient);
+    /** List all iframes on the page: index, src, id, name. */
+    list(tabId?: string): Promise<IframeDescriptor[]>;
+    /** Run arbitrary JS inside the targeted iframe. Returns whatever the script returns. */
+    evaluate(opts: IframeEvaluateOptions, tabId?: string): Promise<unknown>;
+    /** Click a selector inside the targeted iframe. */
+    click(opts: IframeClickOptions, tabId?: string): Promise<boolean>;
+    /** Type text into a selector inside the targeted iframe. */
+    type(opts: IframeTypeOptions, tabId?: string): Promise<boolean>;
+    /** Get innerText of a selector inside the targeted iframe. */
+    text(opts: IframeTextOptions, tabId?: string): Promise<string>;
+    /** Get the full HTML of the targeted iframe. */
+    html(opts: IframeHtmlOptions, tabId?: string): Promise<string>;
+    /** Wait until a selector appears inside the targeted iframe. */
+    waitSel(opts: IframeWaitSelOptions, tabId?: string): Promise<boolean>;
+}
+export declare function createIframeAPI(client: PiggyClient): IframeClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/iframe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/iframe/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,EAAE,EAAK,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;CACf;AAID,kEAAkE;AAClE,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAM,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAO,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACjF,MAAM,MAAM,iBAAiB,GAAO,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAO,YAAY,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAI,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrF,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,0DAA0D;IAC1D,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIpD,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,mDAAmD;IACnD,KAAK,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,4DAA4D;IAC5D,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlE,8DAA8D;IAC9D,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,gDAAgD;IAChD,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAGzE;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}

package/dist/piggy/interactions/index.d.ts

@@ -0,0 +1,24 @@
+import { PiggyClient } from "../client";
+export interface MousePosition {
+    x: number;
+    y: number;
+}
+export declare class InteractionsClient {
+    private client;
+    constructor(client: PiggyClient);
+    click(selector: string, tabId?: string): Promise<boolean>;
+    dblclick(selector: string, tabId?: string): Promise<boolean>;
+    hover(selector: string, tabId?: string): Promise<boolean>;
+    type(selector: string, text: string, tabId?: string): Promise<boolean>;
+    typeClear(selector: string, text: string, tabId?: string): Promise<boolean>;
+    select(selector: string, value: string, tabId?: string): Promise<boolean>;
+    scrollTo(selector: string, tabId?: string): Promise<boolean>;
+    scrollBy(px: number, tabId?: string): Promise<boolean>;
+    keyPress(key: string, tabId?: string): Promise<boolean>;
+    keyCombo(combo: string, tabId?: string): Promise<boolean>;
+    mouseMove(x: number, y: number, tabId?: string): Promise<boolean>;
+    mouseDrag(from: MousePosition, to: MousePosition, tabId?: string): Promise<boolean>;
+    evaluate(js: string, tabId?: string): Promise<unknown>;
+}
+export declare function createInteractionsAPI(client: PiggyClient): InteractionsClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/interactions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/interactions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qBAAa,kBAAkB;IACjB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5D,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAG1D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,CAE7E"}

package/dist/piggy/media/index.d.ts

@@ -0,0 +1,11 @@
+import { PiggyClient } from "../client";
+export declare class MediaClient {
+    private client;
+    constructor(client: PiggyClient);
+    screenshot(filePath?: string, tabId?: string): Promise<string>;
+    pdf(filePath?: string, tabId?: string): Promise<string>;
+    blockImages(tabId?: string): Promise<void>;
+    unblockImages(tabId?: string): Promise<void>;
+}
+export declare function createMediaAPI(client: PiggyClient): MediaClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/media/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIjC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjE,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhE,WAAW,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,aAAa,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE/D"}

package/dist/piggy/navigation/index.d.ts

@@ -0,0 +1,16 @@
+import { PiggyClient } from "../client";
+export declare class NavigationClient {
+    private client;
+    constructor(client: PiggyClient);
+    navigate(url: string, tabId?: string): Promise<void>;
+    reload(tabId?: string): Promise<void>;
+    goBack(tabId?: string): Promise<void>;
+    goForward(tabId?: string): Promise<void>;
+    url(tabId?: string): Promise<string>;
+    title(tabId?: string): Promise<string>;
+    content(tabId?: string): Promise<string>;
+    waitForNavigation(tabId?: string): Promise<void>;
+    waitForSelector(selector: string, timeout?: number, tabId?: string): Promise<void>;
+}
+export declare function createNavigationAPI(client: PiggyClient): NavigationClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/navigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAIvC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,MAAM,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,MAAM,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,SAAS,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,GAAG,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzC,OAAO,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,iBAAiB,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAQ,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAEzE"}

package/dist/piggy/provide/index.d.ts

@@ -0,0 +1,98 @@
+import { PiggyClient } from "../client";
+export interface ProvideOptions {
+    /** CSS selector for the target element(s). */
+    selector: string;
+    /**
+     * Optional parent selector to scope the query under.
+     * Equivalent to: parent.querySelector(selector)
+     */
+    parent?: string;
+}
+export interface ProvideAttrOptions extends ProvideOptions {
+    /** The attribute name to extract. */
+    attr: string;
+}
+export interface ProvideListOptions extends ProvideOptions {
+    /** Optional child selector to scope list items. */
+    itemSel?: string;
+}
+export interface ProvideTable {
+    headers: string[];
+    rows: string[][];
+}
+export interface ProvideLink {
+    text: string;
+    href: string;
+}
+export interface ProvideImage {
+    alt: string;
+    src: string;
+}
+export interface ProvideForm {
+    [name: string]: string;
+}
+export interface ProvidePage {
+    title: string;
+    url: string;
+    html: string;
+    text: string;
+}
+export interface ProvideDiv {
+    tag: string;
+    id: string;
+    cls: string;
+    text: string;
+    html: string;
+    children: ProvideDiv[];
+}
+export interface ProvideMeta {
+    [name: string]: string;
+}
+export interface ProvideSelectOption {
+    text: string;
+    value: string;
+    selected: boolean;
+}
+export interface ProvideSelect {
+    value: string;
+    options: ProvideSelectOption[];
+}
+export declare class ProvideClient {
+    private client;
+    constructor(client: PiggyClient);
+    /** innerText of the first matched element. */
+    text(opts: ProvideOptions, tabId?: string): Promise<string>;
+    /** innerText of all matched elements. */
+    textAll(opts: ProvideOptions, tabId?: string): Promise<string[]>;
+    /** Single attribute value from the first matched element. */
+    attr(opts: ProvideAttrOptions, tabId?: string): Promise<string>;
+    /** Attribute value from all matched elements. */
+    attrAll(opts: ProvideAttrOptions, tabId?: string): Promise<string[]>;
+    /** innerHTML of the first matched element. */
+    html(opts: ProvideOptions, tabId?: string): Promise<string>;
+    /** Extract a table into headers + rows. */
+    table(opts: ProvideOptions, tabId?: string): Promise<ProvideTable>;
+    /** Extract a list of text items, optionally scoped to child items. */
+    list(opts: ProvideListOptions, tabId?: string): Promise<string[]>;
+    /** All links inside the matched selector. */
+    links(opts: ProvideOptions, tabId?: string): Promise<ProvideLink[]>;
+    /** All images inside the matched selector. */
+    images(opts: ProvideOptions, tabId?: string): Promise<ProvideImage[]>;
+    /** Form field name→value map. */
+    form(opts: ProvideOptions, tabId?: string): Promise<ProvideForm>;
+    /** Full page info: title, url, html, text. No selector needed. */
+    page(tabId?: string): Promise<ProvidePage>;
+    /** Structured div tree: tag, id, cls, text, html, children[]. */
+    div(opts: ProvideOptions, tabId?: string): Promise<ProvideDiv>;
+    /** All <meta> name→content pairs. No selector needed. */
+    meta(tabId?: string): Promise<ProvideMeta>;
+    /** <select> current value + all options. */
+    select(opts: ProvideOptions, tabId?: string): Promise<ProvideSelect>;
+    /**
+     * Parse JSON from element innerText or script[type=application/json].
+     * selector is optional — defaults to the first matching JSON script tag.
+     */
+    json(opts?: Partial<ProvideOptions>, tabId?: string): Promise<unknown>;
+}
+export declare function createProvideAPI(client: PiggyClient): ProvideClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/piggy/provide/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/provide/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAKxC,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAK,MAAM,EAAE,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAI,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAO,MAAM,CAAC;IACjB,EAAE,EAAQ,MAAM,CAAC;IACjB,GAAG,EAAO,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAM,MAAM,CAAC;IACjB,KAAK,EAAK,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAI,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAOD,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC,8CAA8C;IAC9C,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAInE,6DAA6D;IAC7D,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlE,iDAAiD;IACjD,OAAO,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvE,8CAA8C;IAC9C,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,2CAA2C;IAC3C,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrE,sEAAsE;IACtE,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpE,6CAA6C;IAC7C,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAItE,8CAA8C;IAC9C,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIxE,iCAAiC;IACjC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAInE,kEAAkE;IAClE,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjE,yDAAyD;IACzD,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIvE;;;OAGG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAG1E;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAEnE"}