nothing-browser 0.1.3 → 0.1.4

package/piggy/capture/index.ts

@@ -1,76 +0,0 @@
-// piggy/capture/index.ts
-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 class CaptureClient {
-  constructor(private client: PiggyClient) {}
-
-  start(tabId = "default"): Promise<void> {
-    return this.client.send("capture.start", { tabId });
-  }
-
-  stop(tabId = "default"): Promise<void> {
-    return this.client.send("capture.stop", { tabId });
-  }
-
-  requests(tabId = "default"): Promise<CapturedRequest[]> {
-    return this.client.send("capture.requests", { tabId });
-  }
-
-  ws(tabId = "default"): Promise<WebSocketFrame[]> {
-    return this.client.send("capture.ws", { tabId });
-  }
-
-  cookies(tabId = "default"): Promise<CapturedCookie[]> {
-    return this.client.send("capture.cookies", { tabId });
-  }
-
-  storage(tabId = "default"): Promise<StorageEntry[]> {
-    return this.client.send("capture.storage", { tabId });
-  }
-
-  clear(tabId = "default"): Promise<void> {
-    return this.client.send("capture.clear", { tabId });
-  }
-}
-
-export function createCaptureAPI(client: PiggyClient): CaptureClient {
-  return new CaptureClient(client);
-}

package/piggy/export/index.d.ts

@@ -1,117 +0,0 @@
-// piggy/export/index.d.ts
-import { PiggyClient } from "../client";
-
-export interface CookieSetOptions {
-  name: string;
-  value: string;
-  domain: string;
-  /** @default "/" */
-  path?: string;
-  /** @default false */
-  httpOnly?: boolean;
-  /** @default false */
-  secure?: boolean;
-  /** Unix epoch seconds. Omit for a session cookie. */
-  expiry?: number;
-}
-
-export interface CookieDeleteOptions {
-  name: string;
-  domain: string;
-}
-
-export interface CapturedRequest {
-  method: string;
-  url: string;
-  status: string;
-  type: string;
-  mime: string;
-  reqHeaders: string;
-  reqBody: string;
-  resHeaders: string;
-  resBody: string;
-}
-
-export interface WebSocketFrame {
-  url: string;
-  direction: string;
-  data: string;
-  binary: boolean;
-}
-
-export interface CapturedCookie {
-  name: string;
-  value: string;
-  domain: string;
-}
-
-export interface SessionExport {
-  url: string;
-  requests: CapturedRequest[];
-  ws: WebSocketFrame[];
-  cookies: CapturedCookie[];
-}
-
-export interface SessionPaths {
-  workDir: string;
-  cookies: string;
-  profile: string;
-  ws: string;
-  pings: string;
-}
-
-export interface InterceptRule {
-  pattern: string;
-  block?: boolean;
-  redirect?: string;
-  setHeaders?: Record<string, string>;
-  removeHeaders?: string[];
-}
-
-export interface ExposedFunctionCall {
-  name: string;
-  callId: string;
-  data: string;
-  tabId: string;
-}
-
-export declare class ExportClient {
-  constructor(client: PiggyClient);
-
-  // Cookies
-  setCookie(opts: CookieSetOptions, tabId?: string): Promise<void>;
-  deleteCookie(opts: CookieDeleteOptions, tabId?: string): Promise<void>;
-
-  // Session
-  sessionReload(tabId?: string): Promise<void>;
-  cookiesPath(tabId?: string): Promise<string>;
-  profilePath(tabId?: string): Promise<string>;
-  wsPath(tabId?: string): Promise<string>;
-  pingsPath(tabId?: string): Promise<string>;
-  sessionPaths(tabId?: string): Promise<SessionPaths>;
-  setWsSave(enabled: boolean, tabId?: string): Promise<void>;
-  setPingsSave(enabled: boolean, tabId?: string): Promise<void>;
-
-  // Intercept rules
-  addInterceptRule(rule: InterceptRule, tabId?: string): Promise<void>;
-  clearInterceptRules(tabId?: string): Promise<void>;
-
-  // Session export / import
-  exportSession(tabId?: string): Promise<SessionExport>;
-  importSession(data: SessionExport, tabId?: string): Promise<void>;
-
-  // Exposed functions
-  exposeFunction(name: string, tabId?: string): Promise<void>;
-  resolveExposed(callId: string, result: string, isError?: boolean, tabId?: string): Promise<void>;
-
-  // Init scripts
-  addInitScript(js: string, tabId?: string): Promise<void>;
-
-  // Events
-  onExposedFunctionCalled(
-    tabId: string,
-    handler: (call: ExposedFunctionCall) => void
-  ): () => void;
-}
-
-export declare function createExportAPI(client: PiggyClient): ExportClient;

package/piggy/export/index.ts

@@ -1,147 +0,0 @@
-// 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/expose/index.ts

@@ -1,42 +0,0 @@
-import { PiggyClient } from "../client";
-import logger from "../logger";
-
-export async function exposeFunction(
-  client: PiggyClient,
-  fnName: string,
-  handler: (data: any) => Promise<any> | any,
-  tabId: string
-): Promise<void> {
-  await client.exposeFunction(fnName, handler, tabId);
-  logger.success(`[${tabId}] exposed function: ${fnName}`);
-}
-
-export async function unexposeFunction(
-  client: PiggyClient,
-  fnName: string,
-  tabId: string
-): Promise<void> {
-  await client.unexposeFunction(fnName, tabId);
-  logger.info(`[${tabId}] unexposed function: ${fnName}`);
-}
-
-export async function clearExposedFunctions(
-  client: PiggyClient,
-  tabId: string
-): Promise<void> {
-  await client.clearExposedFunctions(tabId);
-  logger.info(`[${tabId}] cleared all exposed functions`);
-}
-
-export async function exposeAndInject(
-  client: PiggyClient,
-  fnName: string,
-  handler: (data: any) => Promise<any> | any,
-  injectionJs: string | ((fnName: string) => string),
-  tabId: string
-): Promise<void> {
-  await client.exposeFunction(fnName, handler, tabId);
-  const js = typeof injectionJs === "function" ? injectionJs(fnName) : injectionJs;
-  await client.evaluate(js, tabId);
-  logger.success(`[${tabId}] exposed and injected: ${fnName}`);
-}

package/piggy/iframe/index.ts

@@ -1,79 +0,0 @@
-// piggy/iframe/index.ts
-import { PiggyClient } from "../client";
-
-// ─── Descriptor types ─────────────────────────────────────────────────────────
-
-export interface IframeDescriptor {
-  index: number;
-  src:   string;
-  id:    string;
-  name:  string;
-}
-
-// ─── Option types ─────────────────────────────────────────────────────────────
-
-/** 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 };
-
-// ─── IframeClient ─────────────────────────────────────────────────────────────
-
-export class IframeClient {
-  constructor(private client: PiggyClient) {}
-
-  /** List all iframes on the page: index, src, id, name. */
-  list(tabId = "default"): Promise<IframeDescriptor[]> {
-    return this.client.send("iframe.list", { tabId });
-  }
-
-  /** Run arbitrary JS inside the targeted iframe. Returns whatever the script returns. */
-  evaluate(opts: IframeEvaluateOptions, tabId = "default"): Promise<unknown> {
-    return this.client.send("iframe.evaluate", { ...opts, tabId });
-  }
-
-  /** Click a selector inside the targeted iframe. */
-  click(opts: IframeClickOptions, tabId = "default"): Promise<boolean> {
-    return this.client.send("iframe.click", { ...opts, tabId });
-  }
-
-  /** Type text into a selector inside the targeted iframe. */
-  type(opts: IframeTypeOptions, tabId = "default"): Promise<boolean> {
-    return this.client.send("iframe.type", { ...opts, tabId });
-  }
-
-  /** Get innerText of a selector inside the targeted iframe. */
-  text(opts: IframeTextOptions, tabId = "default"): Promise<string> {
-    return this.client.send("iframe.text", { ...opts, tabId });
-  }
-
-  /** Get the full HTML of the targeted iframe. */
-  html(opts: IframeHtmlOptions, tabId = "default"): Promise<string> {
-    return this.client.send("iframe.html", { ...opts, tabId });
-  }
-
-  /** Wait until a selector appears inside the targeted iframe. */
-  waitSel(opts: IframeWaitSelOptions, tabId = "default"): Promise<boolean> {
-    return this.client.send("iframe.waitSel", { ...opts, tabId });
-  }
-}
-
-// ─── Factory helper ───────────────────────────────────────────────────────────
-
-export function createIframeAPI(client: PiggyClient): IframeClient {
-  return new IframeClient(client);
-}
-// Done. One thing worth noting — `IframeTarget` is a discriminated union so TypeScript enforces you pass either `index` or `src`, never both. Usage looks like:
-
-// ```js
-// piggy.google.iframe.list()
-// piggy.google.iframe.click({ index: 0, sel: "#btn" })
-// piggy.google.iframe.evaluate({ src: "https://...", js: "document.title" })
-// ```

package/piggy/intercept/scripts.d.ts

@@ -1,13 +0,0 @@
-/**
- * Generates a script that short-circuits matching fetch/XHR requests
- * and returns a static fake response — the request never hits the network.
- */
-export declare function buildRespondScript(pattern: string, status: number, contentType: string, body: string): string;
-/**
- * Generates a script that lets the request hit the network, then calls
- * an exposed function with { body, status, headers }.
- * The exposed function returns { body?, status?, headers? } modifications
- * or an empty object {} to pass through unchanged.
- */
-export declare function buildModifyResponseScript(pattern: string, exposedFnName: string): string;
-//# sourceMappingURL=scripts.d.ts.map

package/piggy/intercept/scripts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["scripts.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,CAyER;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA0DxF"}

package/piggy/launch/detect.d.ts

@@ -1,3 +0,0 @@
-export type BinaryMode = 'headless' | 'headful';
-export declare function detectBinary(mode?: BinaryMode): string | null;
-//# sourceMappingURL=detect.d.ts.map

package/piggy/launch/detect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["detect.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAOhD,wBAAgB,YAAY,CAAC,IAAI,GAAE,UAAuB,GAAG,MAAM,GAAG,IAAI,CA+BzE"}

package/piggy/launch/spawn.d.ts

@@ -1,6 +0,0 @@
-import { type BinaryMode } from "./detect";
-export declare function killAllBrowsers(): void;
-export declare function spawnBrowser(mode?: BinaryMode): Promise<string>;
-export declare function spawnBrowserOnSocket(socketName: string, mode?: BinaryMode): Promise<void>;
-export declare function killBrowser(): void;
-//# sourceMappingURL=spawn.d.ts.map

package/piggy/launch/spawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["spawn.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AASzD,wBAAgB,eAAe,IAAI,IAAI,CAiBtC;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE,UAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqEjF;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,UAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,WAAW,IAAI,IAAI,CAmBlC"}

package/piggy/logger/index.d.ts

@@ -1,3 +0,0 @@
-declare const logger: import("ernest-logger").Logger;
-export default logger;
-//# sourceMappingURL=index.d.ts.map

package/piggy/logger/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,MAAM,gCAiDV,CAAC;AAKH,eAAe,MAAM,CAAC"}

package/piggy/pool/index.d.ts

@@ -1,12 +0,0 @@
-// piggy/pool/index.d.ts
-import { PiggyClient } from "../client";
-
-export declare class TabPool {
-  constructor(client: PiggyClient, size: number, seedUrl: string, name: string);
-  init(): Promise<void>;
-  acquire(): Promise<string>;
-  release(tabId: string): void;
-  withTab<T>(fn: (tabId: string) => Promise<T>): Promise<T>;
-  close(): Promise<void>;
-  get stats(): { idle: number; busy: number; queued: number; total: number };
-}

package/piggy/pool/index.ts

@@ -1,75 +0,0 @@
-// piggy/pool/index.ts
-import { PiggyClient } from "../client";
-import logger from "../logger";
-
-export class TabPool {
-  private idle: string[] = [];
-  private busy = new Set<string>();
-  private queue: ((tabId: string) => void)[] = [];
-
-  constructor(
-    private client: PiggyClient,
-    private size: number,
-    private seedUrl: string,
-    private name: string
-  ) {}
-
-  async init() {
-    for (let i = 0; i < this.size; i++) {
-      const tabId = await this.client.newTab();
-      await this.client.navigate(this.seedUrl, tabId);
-      this.idle.push(tabId);
-      logger.success(`[${this.name}] pool tab ${i + 1}/${this.size} ready: ${tabId}`);
-    }
-  }
-
-  acquire(): Promise<string> {
-    return new Promise(resolve => {
-      const tabId = this.idle.pop();
-      if (tabId) {
-        this.busy.add(tabId);
-        resolve(tabId);
-      } else {
-        this.queue.push(resolve);
-      }
-    });
-  }
-
-  release(tabId: string) {
-    this.busy.delete(tabId);
-    const next = this.queue.shift();
-    if (next) {
-      this.busy.add(tabId);
-      next(tabId);
-    } else {
-      this.idle.push(tabId);
-    }
-  }
-
-  async withTab<T>(fn: (tabId: string) => Promise<T>): Promise<T> {
-    const tabId = await this.acquire();
-    try {
-      return await fn(tabId);
-    } finally {
-      this.release(tabId);
-    }
-  }
-
-  async close() {
-    for (const tabId of [...this.idle, ...this.busy]) {
-      try { await this.client.closeTab(tabId); } catch {}
-    }
-    this.idle = [];
-    this.busy.clear();
-    this.queue = [];
-  }
-
-  get stats() {
-    return {
-      idle:   this.idle.length,
-      busy:   this.busy.size,
-      queued: this.queue.length,
-      total:  this.size,
-    };
-  }
-}