nothing-browser 0.0.14 → 0.0.15

package/dist/piggy/cache/memory.d.ts

@@ -4,3 +4,4 @@ export declare function del(key: string): void;
 export declare function clear(): void;
 export declare function size(): number;
 export declare function keys(): string[];
+//# sourceMappingURL=memory.d.ts.map

package/dist/piggy/cache/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../piggy/cache/memory.ts"],"names":[],"mappings":"AASA,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAQ3C;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,QAExD;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,QAE9B;AAED,wBAAgB,KAAK,SAEpB;AAED,wBAAgB,IAAI,WAEnB;AAED,wBAAgB,IAAI,aAEnB"}

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

@@ -76,3 +76,4 @@ export declare class PiggyClient {
     unexposeFunction(name: string, tabId?: string): Promise<void>;
     clearExposedFunctions(tabId?: string): Promise<void>;
 }
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -4,3 +4,4 @@ export declare function randomDelay(min: number, max: number): Promise<void>;
  * Returns an array of { char, isBackspace } actions to replay.
  */
 export declare function humanTypeSequence(text: string): string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -10,3 +10,4 @@ export declare function buildRespondScript(pattern: string, status: number, cont
  * or an empty object {} to pass through unchanged.
  */
 export declare function buildModifyResponseScript(pattern: string, exposedFnName: string): string;
+//# sourceMappingURL=scripts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../piggy/intercept/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/dist/piggy/launch/detect.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../piggy/launch/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/dist/piggy/launch/spawn.d.ts

@@ -3,3 +3,4 @@ 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/dist/piggy/launch/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../piggy/launch/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/dist/piggy/logger/index.d.ts

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

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

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

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

@@ -1,3 +1,4 @@
 export default function open(): {
     name: string;
 };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/open/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,IAAI;;EAI3B"}

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

@@ -4,3 +4,4 @@ export declare function setClient(c: PiggyClient | null): void;
 export declare function setHumanMode(v: boolean): void;
 export declare function createSiteObject(name: string, registeredUrl: string, client: PiggyClient, tabId: string): any;
 export declare function createExposedAPI<T extends Record<string, (data: any) => any>>(site: any, apiName: string, handlers: T): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/register/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,eAAO,IAAI,SAAS,SAAQ,CAAC;AAE7B,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,QAAuB;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,QAAoB;AAgB3D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,OAmcvG;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASrI"}

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

@@ -18,3 +18,4 @@ export declare const routeRegistry: Map<string, RouteConfig>;
 export declare const keepAliveSites: Set<string>;
 export declare function startServer(port: number, hostname?: string): Promise<Elysia>;
 export declare function stopServer(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../piggy/server/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,GAAG,CAAC;CACV,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,IAAI,EAAE,GAAG,KACN,OAAO,CAAC,GAAG,CAAC,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC1C,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,aAAa,0BAAiC,CAAC;AAC5D,eAAO,MAAM,cAAc,aAAoB,CAAC;AAmBhD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAoFrF;AAED,wBAAgB,UAAU,SAGzB"}

package/dist/piggy.d.ts

@@ -1,3 +1,222 @@
-declare const piggy: any;
+import { type BinaryMode } from "./piggy/launch/detect";
+import type { Logger } from "ernest-logger";
+import type { Elysia } from "elysia";
+import type { RouteHandler, BeforeMiddleware, RouteConfig } from "./piggy/server";
+export type TabMode = "tab" | "process";
+/** Returned by createSiteObject — full API surface of a registered site. */
+export interface SiteObject {
+    /** Internal name used when registering. */
+    _name: string;
+    /** Internal CDP / socket tab ID. */
+    _tabId: string;
+    navigate(url?: string, opts?: {
+        retries?: number;
+    }): Promise<void>;
+    reload(): Promise<void>;
+    goBack(): Promise<void>;
+    goForward(): Promise<void>;
+    waitForNavigation(): Promise<void>;
+    title(): Promise<string>;
+    /** Returns the last known URL (synchronous — does NOT hit the browser). */
+    url(): string;
+    content(): Promise<string>;
+    wait(ms: number): Promise<void>;
+    waitForSelector(selector: string, timeout?: number): Promise<void>;
+    waitForVisible(selector: string, timeout?: number): Promise<void>;
+    waitForResponse(pattern: string, timeout?: number): Promise<void>;
+    addInitScript(js: string | (() => void)): Promise<SiteObject>;
+    on(event: "navigate", handler: (url: string) => void): () => void;
+    on(event: string, handler: (data: unknown) => void): () => void;
+    off(event: string, handler: (data: unknown) => void): void;
+    click(selector: string, opts?: {
+        retries?: number;
+        timeout?: number;
+    }): Promise<boolean>;
+    doubleClick(selector: string): Promise<boolean>;
+    hover(selector: string): Promise<boolean>;
+    type(selector: string, text: string, opts?: {
+        delay?: number;
+        retries?: number;
+        fact?: boolean;
+        wpm?: number;
+    }): Promise<boolean>;
+    select(selector: string, value: string): Promise<boolean>;
+    evaluate<T = unknown>(js: string | ((...args: unknown[]) => T), ...args: unknown[]): Promise<T>;
+    keyboard: {
+        press(key: string): Promise<boolean>;
+        combo(combo: string): Promise<boolean>;
+    };
+    mouse: {
+        move(x: number, y: number): Promise<boolean>;
+        drag(from: {
+            x: number;
+            y: number;
+        }, to: {
+            x: number;
+            y: number;
+        }): Promise<boolean>;
+    };
+    scroll: {
+        to(selector: string): Promise<boolean>;
+        by(px: number): Promise<boolean>;
+    };
+    fetchText(selector: string): Promise<string | null>;
+    fetchLinks(selector: string): Promise<string[]>;
+    fetchImages(selector: string): Promise<string[]>;
+    search: {
+        css(query: string): Promise<unknown>;
+        id(query: string): Promise<unknown>;
+    };
+    screenshot(filePath?: string): Promise<string>;
+    pdf(filePath?: string): Promise<string>;
+    blockImages(): Promise<void>;
+    unblockImages(): Promise<void>;
+    cookies: {
+        set(name: string, value: string, domain: string, path?: string): Promise<void>;
+        get(name: string): Promise<unknown>;
+        delete(name: string): Promise<void>;
+        list(): Promise<unknown[]>;
+    };
+    intercept: {
+        block(pattern: string): Promise<void>;
+        redirect(pattern: string, redirectUrl: string): Promise<void>;
+        headers(pattern: string, headers: Record<string, string>): Promise<void>;
+        respond(pattern: string, handlerOrResponse: {
+            status?: number;
+            contentType?: string;
+            body: string;
+        } | ((req: {
+            url: string;
+            method: string;
+        }) => {
+            status?: number;
+            contentType?: string;
+            body: string;
+        })): Promise<SiteObject>;
+        modifyResponse(pattern: string, handler: (response: {
+            body: string;
+            status: number;
+            headers: Record<string, string>;
+        }) => Promise<{
+            body?: string;
+            status?: number;
+            headers?: Record<string, string>;
+        } | void> | void): Promise<SiteObject>;
+        clear(): Promise<void>;
+    };
+    capture: {
+        start(): Promise<void>;
+        stop(): Promise<void>;
+        requests(): Promise<unknown[]>;
+        ws(): Promise<unknown[]>;
+        cookies(): Promise<unknown[]>;
+        storage(): Promise<unknown>;
+        clear(): Promise<void>;
+    };
+    session: {
+        export(): Promise<unknown>;
+        import(data: unknown): Promise<void>;
+    };
+    exposeFunction(fnName: string, handler: (data: unknown) => Promise<unknown> | unknown): Promise<SiteObject>;
+    unexposeFunction(fnName: string): Promise<SiteObject>;
+    clearExposedFunctions(): Promise<SiteObject>;
+    exposeAndInject(fnName: string, handler: (data: unknown) => Promise<unknown> | unknown, injectionJs: string | ((fnName: string) => string)): Promise<SiteObject>;
+    api(path: string, handler: RouteHandler, opts?: {
+        ttl?: number;
+        before?: BeforeMiddleware[];
+        method?: "GET" | "POST" | "PUT" | "DELETE";
+    }): SiteObject;
+    noclose(): SiteObject;
+    close(): Promise<void>;
+}
+export interface RouteSummary {
+    site: string;
+    method: RouteConfig["method"];
+    path: string;
+    ttl: number;
+    middlewareCount: number;
+}
+/**
+ * Proxy that runs the same method on every site in parallel (Promise.all).
+ * The return type mirrors the SiteObject API but every method returns
+ * `Promise<ReturnType[]>` instead of a single value.
+ */
+export type AllProxy = {
+    [K in keyof SiteObject]: SiteObject[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => Promise<R[]> : SiteObject[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<R[]> : never;
+};
+/**
+ * Proxy that runs the same method on every site in parallel and returns a
+ * Record keyed by site `_name`.
+ */
+export type DiffProxy = {
+    [K in keyof SiteObject]: SiteObject[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => Promise<Record<string, R>> : SiteObject[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Record<string, R>> : never;
+};
+export interface LaunchOptions {
+    /** Whether to open a separate browser process per registered site or share a single one via tabs. Default: `"tab"`. */
+    mode?: TabMode;
+    /** Whether to run the browser binary in headed or headless mode. Default: `"headless"`. */
+    binary?: BinaryMode;
+}
+export interface RegisterOptions {
+    /** Override the binary mode for this site's dedicated process (only used when `mode === "process"`). */
+    binary?: BinaryMode;
+}
+export interface ServeOptions {
+    hostname?: string;
+}
+export interface Piggy {
+    /**
+     * Spawns the Nothing Browser binary and connects the internal socket client.
+     * Must be called before any other method.
+     */
+    launch(opts?: LaunchOptions): Promise<Piggy>;
+    /**
+     * Registers a named site at the given URL.
+     * After registration `piggy[name]` is available as a `SiteObject`.
+     */
+    register(name: string, url: string, opts?: RegisterOptions): Promise<Piggy>;
+    /** Enables or disables human-simulation mode (random delays, typos, smooth scrolling). */
+    actHuman(enable: boolean): Piggy;
+    /** Changes the tab/process mode *before* the next `register()` call. */
+    mode(m: TabMode): Piggy;
+    /** Exposes a Node.js function to the browser's global scope on the default (or specified) tab. */
+    expose(name: string, handler: (data: unknown) => Promise<unknown> | unknown, tabId?: string): Promise<Piggy>;
+    /** Removes a previously exposed function from the browser. */
+    unexpose(name: string, tabId?: string): Promise<Piggy>;
+    /** Starts an Elysia HTTP server that exposes all registered `.api()` routes. */
+    serve(port: number, opts?: ServeOptions): Promise<Elysia>;
+    /** Stops the running Elysia server. */
+    stopServer(): void;
+    /** Returns a summary of every mounted HTTP route. */
+    routes(): RouteSummary[];
+    /**
+     * Returns a proxy that calls the same method on **all** given sites in
+     * parallel (via `Promise.all`) and returns an array of results.
+     */
+    all(sites: SiteObject[]): AllProxy;
+    /**
+     * Returns a proxy that calls the same method on **all** given sites in
+     * parallel and returns a `Record<siteName, result>` object.
+     */
+    diff(sites: SiteObject[]): DiffProxy;
+    /**
+     * Gracefully shuts down all tabs and the browser process.
+     * Pass `{ force: true }` to skip graceful close and kill immediately.
+     */
+    close(opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** Detects the Nothing Browser binary path for the given mode. */
+    detect(mode?: BinaryMode): string | null;
+    /** The ernest-logger instance used internally. */
+    logger: Logger;
+    /**
+     * After `piggy.register("mysite", url)` you can access the site as
+     * `piggy.mysite`.  The index signature covers those dynamic properties.
+     */
+    [site: string]: SiteObject | unknown;
+}
+declare const piggy: Piggy;
 export default piggy;
 export { piggy };
+//# sourceMappingURL=piggy.d.ts.map

package/dist/piggy.d.ts.map

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

package/dist/piggy.js

@@ -21830,7 +21830,7 @@ var piggy = {
   routes: () => Array.from(routeRegistry.entries()).map(([key, cfg]) => {
     const [site] = key.split(":");
     return {
-      site,
+      site: site ?? key,
       method: cfg.method,
       path: `/${site}${cfg.path}`,
       ttl: cfg.ttl,
@@ -21838,10 +21838,10 @@ var piggy = {
     };
   }),
   all: (sites) => new Proxy({}, {
-    get: (_, method) => (...args) => Promise.all(sites.map((s) => s[method]?.(...args)))
+    get: (_target, method) => (...args) => Promise.all(sites.map((s) => s[method]?.(...args)))
   }),
   diff: (sites) => new Proxy({}, {
-    get: (_, method) => async (...args) => {
+    get: (_target, method) => async (...args) => {
       const results = await Promise.all(sites.map((s) => s[method]?.(...args)));
       return Object.fromEntries(sites.map((s, i) => [s._name ?? i, results[i]]));
     }

package/package.json

@@ -1,14 +1,29 @@
 {
   "name": "nothing-browser",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Browser automation library powered by Nothing Browser",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "homepage": "https://github.com/ernest-tech-house-co-operation/nothing-browser#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ernest-tech-house-co-operation/nothing-browser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ernest-tech-house-co-operation/nothing-browser/issues"
+  },
+  "author": {
+    "name": "Pease Ernest",
+    "email": "pease@ernest.com",
+    "url": "https://github.com/ernest-tech-house-co-operation"
+  },
+  "license": "MIT",
+  "main": "./dist/piggy.js",
+  "types": "./dist/piggy.d.ts",
   "exports": {
     ".": {
       "bun": "./piggy.ts",
       "node": "./dist/piggy.js",
-      "default": "./dist/piggy.js"
+      "default": "./dist/piggy.js",
+      "types": "./dist/piggy.d.ts"
     },
     "./register": {
       "bun": "./piggy/register/index.ts",
@@ -26,16 +41,13 @@
       "types": "./dist/logger/index.d.ts"
     }
   },
-
-
   "scripts": {
-    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "build:types": "tsc --project tsconfig.json --emitDeclarationOnly --outDir dist",
     "build:js": "bun build ./piggy.ts --outdir ./dist --target node && bun build ./piggy/client/index.ts --outdir ./dist/client --target node && bun build ./piggy/register/index.ts --outdir ./dist/register --target node && bun build ./piggy/server/index.ts --outdir ./dist/server --target node && bun build ./piggy/logger/index.ts --outdir ./dist/logger --target node && bun build ./piggy/launch/detect.ts --outdir ./dist/launch --target node && bun build ./piggy/launch/spawn.ts --outdir ./dist/launch --target node && bun build ./piggy/cache/memory.ts --outdir ./dist/cache --target node && bun build ./piggy/human/index.ts --outdir ./dist/human --target node",
-    "build": "bun run build:types && bun run build:js",
+    "build": "bun run clean && bun run build:types && bun run build:js",
     "prepublishOnly": "bun run build"
   },
-
-
   "dependencies": {
     "elysia": "^1.0.0"
   },
@@ -43,9 +55,9 @@
     "elysia": "^1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
+    "@types/node": "^20.0.0",
     "bun-types": "latest",
-    "typescript": "^6.0.3"
+    "typescript": "^5.8.0"
   },
   "engines": {
     "node": ">=18.0.0",
@@ -66,7 +78,5 @@
     "webdriver",
     "chromium",
     "nothing-browser"
-  ],
-  "author": "",
-  "license": "MIT"
+  ]
 }

package/piggy.ts

@@ -5,24 +5,321 @@ import { PiggyClient } from "./piggy/client";
 import { setClient, setHumanMode, createSiteObject } from "./piggy/register";
 import { routeRegistry, keepAliveSites, startServer, stopServer } from "./piggy/server";
 import logger from "./piggy/logger";
+import type { Logger } from "ernest-logger";
+import type { Elysia } from "elysia";
+import type { RouteHandler, BeforeMiddleware, RouteConfig } from "./piggy/server";
 
-type TabMode = "tab" | "process";
-type SiteObject = ReturnType<typeof createSiteObject>;
+// ── Core types ───────────────────────────────────────────────────────────────
+
+export type TabMode = "tab" | "process";
+
+/** Returned by createSiteObject — full API surface of a registered site. */
+export interface SiteObject {
+  /** Internal name used when registering. */
+  _name: string;
+  /** Internal CDP / socket tab ID. */
+  _tabId: string;
+
+  // ── Navigation ─────────────────────────────────────────────────────────────
+  navigate(url?: string, opts?: { retries?: number }): Promise<void>;
+  reload(): Promise<void>;
+  goBack(): Promise<void>;
+  goForward(): Promise<void>;
+  waitForNavigation(): Promise<void>;
+
+  title(): Promise<string>;
+  /** Returns the last known URL (synchronous — does NOT hit the browser). */
+  url(): string;
+  content(): Promise<string>;
+
+  // ── Timing ────────────────────────────────────────────────────────────────
+  wait(ms: number): Promise<void>;
+  waitForSelector(selector: string, timeout?: number): Promise<void>;
+  waitForVisible(selector: string, timeout?: number): Promise<void>;
+  waitForResponse(pattern: string, timeout?: number): Promise<void>;
+
+  // ── Init script ───────────────────────────────────────────────────────────
+  addInitScript(js: string | (() => void)): Promise<SiteObject>;
+
+  // ── Event emitter ─────────────────────────────────────────────────────────
+  on(event: "navigate", handler: (url: string) => void): () => void;
+  on(event: string, handler: (data: unknown) => void): () => void;
+  off(event: string, handler: (data: unknown) => void): void;
+
+  // ── Interactions ──────────────────────────────────────────────────────────
+  click(selector: string, opts?: { retries?: number; timeout?: number }): Promise<boolean>;
+  doubleClick(selector: string): Promise<boolean>;
+  hover(selector: string): Promise<boolean>;
+  type(
+    selector: string,
+    text: string,
+    opts?: { delay?: number; retries?: number; fact?: boolean; wpm?: number }
+  ): Promise<boolean>;
+  select(selector: string, value: string): Promise<boolean>;
+  evaluate<T = unknown>(js: string | ((...args: unknown[]) => T), ...args: unknown[]): Promise<T>;
+
+  keyboard: {
+    press(key: string): Promise<boolean>;
+    combo(combo: string): Promise<boolean>;
+  };
+
+  mouse: {
+    move(x: number, y: number): Promise<boolean>;
+    drag(from: { x: number; y: number }, to: { x: number; y: number }): Promise<boolean>;
+  };
+
+  scroll: {
+    to(selector: string): Promise<boolean>;
+    by(px: number): Promise<boolean>;
+  };
+
+  // ── Fetch ─────────────────────────────────────────────────────────────────
+  fetchText(selector: string): Promise<string | null>;
+  fetchLinks(selector: string): Promise<string[]>;
+  fetchImages(selector: string): Promise<string[]>;
+
+  search: {
+    css(query: string): Promise<unknown>;
+    id(query: string): Promise<unknown>;
+  };
+
+  // ── Screenshot / PDF ──────────────────────────────────────────────────────
+  screenshot(filePath?: string): Promise<string>;
+  pdf(filePath?: string): Promise<string>;
+  blockImages(): Promise<void>;
+  unblockImages(): Promise<void>;
+
+  // ── Cookies ───────────────────────────────────────────────────────────────
+  cookies: {
+    set(name: string, value: string, domain: string, path?: string): Promise<void>;
+    get(name: string): Promise<unknown>;
+    delete(name: string): Promise<void>;
+    list(): Promise<unknown[]>;
+  };
+
+  // ── Interception ──────────────────────────────────────────────────────────
+  intercept: {
+    block(pattern: string): Promise<void>;
+    redirect(pattern: string, redirectUrl: string): Promise<void>;
+    headers(pattern: string, headers: Record<string, string>): Promise<void>;
+    respond(
+      pattern: string,
+      handlerOrResponse:
+        | { status?: number; contentType?: string; body: string }
+        | ((req: { url: string; method: string }) => {
+            status?: number;
+            contentType?: string;
+            body: string;
+          })
+    ): Promise<SiteObject>;
+    modifyResponse(
+      pattern: string,
+      handler: (response: {
+        body: string;
+        status: number;
+        headers: Record<string, string>;
+      }) => Promise<{ body?: string; status?: number; headers?: Record<string, string> } | void> | void
+    ): Promise<SiteObject>;
+    clear(): Promise<void>;
+  };
+
+  // ── Network capture ───────────────────────────────────────────────────────
+  capture: {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    requests(): Promise<unknown[]>;
+    ws(): Promise<unknown[]>;
+    cookies(): Promise<unknown[]>;
+    storage(): Promise<unknown>;
+    clear(): Promise<void>;
+  };
+
+  // ── Session ───────────────────────────────────────────────────────────────
+  session: {
+    export(): Promise<unknown>;
+    import(data: unknown): Promise<void>;
+  };
+
+  // ── Expose / unexpose functions ───────────────────────────────────────────
+  exposeFunction(
+    fnName: string,
+    handler: (data: unknown) => Promise<unknown> | unknown
+  ): Promise<SiteObject>;
+  unexposeFunction(fnName: string): Promise<SiteObject>;
+  clearExposedFunctions(): Promise<SiteObject>;
+  exposeAndInject(
+    fnName: string,
+    handler: (data: unknown) => Promise<unknown> | unknown,
+    injectionJs: string | ((fnName: string) => string)
+  ): Promise<SiteObject>;
+
+  // ── Elysia route registration ─────────────────────────────────────────────
+  api(
+    path: string,
+    handler: RouteHandler,
+    opts?: {
+      ttl?: number;
+      before?: BeforeMiddleware[];
+      method?: "GET" | "POST" | "PUT" | "DELETE";
+    }
+  ): SiteObject;
+
+  noclose(): SiteObject;
+  close(): Promise<void>;
+}
+
+// ── Route summary returned by piggy.routes() ─────────────────────────────────
+
+export interface RouteSummary {
+  site: string;
+  method: RouteConfig["method"];
+  path: string;
+  ttl: number;
+  middlewareCount: number;
+}
+
+// ── Multi-site proxy helpers ──────────────────────────────────────────────────
+
+/**
+ * Proxy that runs the same method on every site in parallel (Promise.all).
+ * The return type mirrors the SiteObject API but every method returns
+ * `Promise<ReturnType[]>` instead of a single value.
+ */
+export type AllProxy = {
+  [K in keyof SiteObject]: SiteObject[K] extends (...args: infer A) => Promise<infer R>
+    ? (...args: A) => Promise<R[]>
+    : SiteObject[K] extends (...args: infer A) => infer R
+      ? (...args: A) => Promise<R[]>
+      : never;
+};
+
+/**
+ * Proxy that runs the same method on every site in parallel and returns a
+ * Record keyed by site `_name`.
+ */
+export type DiffProxy = {
+  [K in keyof SiteObject]: SiteObject[K] extends (...args: infer A) => Promise<infer R>
+    ? (...args: A) => Promise<Record<string, R>>
+    : SiteObject[K] extends (...args: infer A) => infer R
+      ? (...args: A) => Promise<Record<string, R>>
+      : never;
+};
+
+// ── Launch / register option bags ────────────────────────────────────────────
+
+export interface LaunchOptions {
+  /** Whether to open a separate browser process per registered site or share a single one via tabs. Default: `"tab"`. */
+  mode?: TabMode;
+  /** Whether to run the browser binary in headed or headless mode. Default: `"headless"`. */
+  binary?: BinaryMode;
+}
+
+export interface RegisterOptions {
+  /** Override the binary mode for this site's dedicated process (only used when `mode === "process"`). */
+  binary?: BinaryMode;
+}
+
+export interface ServeOptions {
+  hostname?: string;
+}
+
+// ── The Piggy object type ─────────────────────────────────────────────────────
+
+export interface Piggy {
+  // ── Lifecycle ──────────────────────────────────────────────────────────────
+  /**
+   * Spawns the Nothing Browser binary and connects the internal socket client.
+   * Must be called before any other method.
+   */
+  launch(opts?: LaunchOptions): Promise<Piggy>;
+
+  /**
+   * Registers a named site at the given URL.
+   * After registration `piggy[name]` is available as a `SiteObject`.
+   */
+  register(name: string, url: string, opts?: RegisterOptions): Promise<Piggy>;
+
+  // ── Global controls ────────────────────────────────────────────────────────
+  /** Enables or disables human-simulation mode (random delays, typos, smooth scrolling). */
+  actHuman(enable: boolean): Piggy;
+
+  /** Changes the tab/process mode *before* the next `register()` call. */
+  mode(m: TabMode): Piggy;
+
+  // ── Global function exposure ───────────────────────────────────────────────
+  /** Exposes a Node.js function to the browser's global scope on the default (or specified) tab. */
+  expose(
+    name: string,
+    handler: (data: unknown) => Promise<unknown> | unknown,
+    tabId?: string
+  ): Promise<Piggy>;
+
+  /** Removes a previously exposed function from the browser. */
+  unexpose(name: string, tabId?: string): Promise<Piggy>;
+
+  // ── Elysia server ─────────────────────────────────────────────────────────
+  /** Starts an Elysia HTTP server that exposes all registered `.api()` routes. */
+  serve(port: number, opts?: ServeOptions): Promise<Elysia>;
+
+  /** Stops the running Elysia server. */
+  stopServer(): void;
+
+  // ── Introspection ─────────────────────────────────────────────────────────
+  /** Returns a summary of every mounted HTTP route. */
+  routes(): RouteSummary[];
+
+  // ── Multi-site helpers ────────────────────────────────────────────────────
+  /**
+   * Returns a proxy that calls the same method on **all** given sites in
+   * parallel (via `Promise.all`) and returns an array of results.
+   */
+  all(sites: SiteObject[]): AllProxy;
+
+  /**
+   * Returns a proxy that calls the same method on **all** given sites in
+   * parallel and returns a `Record<siteName, result>` object.
+   */
+  diff(sites: SiteObject[]): DiffProxy;
+
+  // ── Shutdown ──────────────────────────────────────────────────────────────
+  /**
+   * Gracefully shuts down all tabs and the browser process.
+   * Pass `{ force: true }` to skip graceful close and kill immediately.
+   */
+  close(opts?: { force?: boolean }): Promise<void>;
+
+  // ── Utilities ─────────────────────────────────────────────────────────────
+  /** Detects the Nothing Browser binary path for the given mode. */
+  detect(mode?: BinaryMode): string | null;
+
+  /** The ernest-logger instance used internally. */
+  logger: Logger;
+
+  // ── Dynamic site keys ─────────────────────────────────────────────────────
+  /**
+   * After `piggy.register("mysite", url)` you can access the site as
+   * `piggy.mysite`.  The index signature covers those dynamic properties.
+   */
+  [site: string]: SiteObject | unknown;
+}
+
+// ── Module-private state ──────────────────────────────────────────────────────
 
 let _client: PiggyClient | null = null;
 let _tabMode: TabMode = "tab";
 const _extraProcs: { socket: string; client: PiggyClient }[] = [];
 const _sites: Record<string, SiteObject> = {};
 
-// CREATE THE PIGGY OBJECT AS A PLAIN OBJECT - NOT A PROXY
-const piggy: any = {
+// ── The piggy singleton ───────────────────────────────────────────────────────
+
+const piggy: Piggy = {
   // ── Lifecycle ───────────────────────────────────────────────────────────────
 
-  launch: async (opts?: { mode?: TabMode; binary?: BinaryMode }) => {
+  launch: async (opts?: LaunchOptions): Promise<Piggy> => {
     _tabMode = opts?.mode ?? "tab";
     const binaryMode: BinaryMode = opts?.binary ?? "headless";
     await spawnBrowser(binaryMode);
-    await new Promise(r => setTimeout(r, 500));
+    await new Promise<void>((r) => setTimeout(r, 500));
     _client = new PiggyClient();
     await _client.connect();
     setClient(_client);
@@ -30,7 +327,7 @@ const piggy: any = {
     return piggy;
   },
 
-  register: async (name: string, url: string, opts?: { binary?: BinaryMode }) => {
+  register: async (name: string, url: string, opts?: RegisterOptions): Promise<Piggy> => {
     if (!url?.trim()) throw new Error(`No URL for site "${name}"`);
     const binaryMode: BinaryMode = opts?.binary ?? "headless";
 
@@ -38,21 +335,20 @@ const piggy: any = {
     if (_tabMode === "tab") {
       if (!_client) throw new Error("No client. Call piggy.launch() first.");
       tabId = await _client.newTab();
-      // HERE IT IS - CREATE SITE OBJECT AND ASSIGN DIRECTLY
-      const siteObj = createSiteObject(name, url, _client, tabId);
+      const siteObj: SiteObject = createSiteObject(name, url, _client, tabId);
       _sites[name] = siteObj;
-      piggy[name] = siteObj;  // DIRECT ASSIGNMENT - NO PROXY
+      (piggy as Record<string, unknown>)[name] = siteObj;
       logger.success(`[${name}] registered as tab ${tabId}`);
     } else {
       const socketName = `piggy_${name}`;
       await spawnBrowserOnSocket(socketName, binaryMode);
-      await new Promise(r => setTimeout(r, 500));
+      await new Promise<void>((r) => setTimeout(r, 500));
       const c = new PiggyClient(socketName);
       await c.connect();
       _extraProcs.push({ socket: socketName, client: c });
-      const siteObj = createSiteObject(name, url, c, "default");
+      const siteObj: SiteObject = createSiteObject(name, url, c, "default");
       _sites[name] = siteObj;
-      piggy[name] = siteObj;  // DIRECT ASSIGNMENT - NO PROXY
+      (piggy as Record<string, unknown>)[name] = siteObj;
       logger.success(`[${name}] registered as process on "${socketName}"`);
     }
 
@@ -61,24 +357,31 @@ const piggy: any = {
 
   // ── Global controls ─────────────────────────────────────────────────────────
 
-  actHuman: (enable: boolean) => {
+  actHuman: (enable: boolean): Piggy => {
     setHumanMode(enable);
     logger.info(`[piggy] actHuman: ${enable}`);
     return piggy;
   },
 
-  mode: (m: TabMode) => { _tabMode = m; return piggy; },
+  mode: (m: TabMode): Piggy => {
+    _tabMode = m;
+    return piggy;
+  },
 
   // ── Expose Function (global) ─────────────────────────────────────────────────
 
-  expose: async (name: string, handler: (data: any) => Promise<any> | any, tabId = "default") => {
+  expose: async (
+    name: string,
+    handler: (data: unknown) => Promise<unknown> | unknown,
+    tabId = "default"
+  ): Promise<Piggy> => {
     if (!_client) throw new Error("No client. Call piggy.launch() first.");
     await _client.exposeFunction(name, handler, tabId);
     logger.success(`[piggy] exposed global function: ${name}`);
     return piggy;
   },
 
-  unexpose: async (name: string, tabId = "default") => {
+  unexpose: async (name: string, tabId = "default"): Promise<Piggy> => {
     if (!_client) throw new Error("No client. Call piggy.launch() first.");
     await _client.unexposeFunction(name, tabId);
     logger.info(`[piggy] unexposed function: ${name}`);
@@ -87,18 +390,18 @@ const piggy: any = {
 
   // ── Elysia server ────────────────────────────────────────────────────────────
 
-  serve: (port: number, opts?: { hostname?: string }) =>
+  serve: (port: number, opts?: ServeOptions): Promise<Elysia> =>
     startServer(port, opts?.hostname),
 
   stopServer,
 
   // ── Route listing ────────────────────────────────────────────────────────────
 
-  routes: () =>
-    Array.from(routeRegistry.entries()).map(([key, cfg]) => {
+  routes: (): RouteSummary[] =>
+    Array.from(routeRegistry.entries()).map(([key, cfg]): RouteSummary => {
       const [site] = key.split(":");
       return {
-        site,
+        site: site ?? key,
         method: cfg.method,
         path: `/${site}${cfg.path}`,
         ttl: cfg.ttl,
@@ -108,24 +411,33 @@ const piggy: any = {
 
   // ── Multi-site ───────────────────────────────────────────────────────────────
 
-  all: (sites: SiteObject[]) =>
-    new Proxy({} as any, {
-      get: (_, method: string) =>
-        (...args: any[]) => Promise.all(sites.map((s: any) => s[method]?.(...args))),
+  all: (sites: SiteObject[]): AllProxy =>
+    new Proxy({} as AllProxy, {
+      get: (_target, method: string) =>
+        (...args: unknown[]) =>
+          Promise.all(
+            sites.map((s) =>
+              (s as unknown as Record<string, (...a: unknown[]) => unknown>)[method]?.(...args)
+            )
+          ),
     }),
 
-  diff: (sites: SiteObject[]) =>
-    new Proxy({} as any, {
-      get: (_, method: string) =>
-        async (...args: any[]) => {
-          const results = await Promise.all(sites.map((s: any) => s[method]?.(...args)));
-          return Object.fromEntries(sites.map((s: any, i) => [s._name ?? i, results[i]]));
+  diff: (sites: SiteObject[]): DiffProxy =>
+    new Proxy({} as DiffProxy, {
+      get: (_target, method: string) =>
+        async (...args: unknown[]) => {
+          const results = await Promise.all(
+            sites.map((s) =>
+              (s as unknown as Record<string, (...a: unknown[]) => unknown>)[method]?.(...args)
+            )
+          );
+          return Object.fromEntries(sites.map((s, i) => [s._name ?? i, results[i]]));
         },
     }),
 
   // ── Shutdown ─────────────────────────────────────────────────────────────────
 
-  close: async (opts?: { force?: boolean }) => {
+  close: async (opts?: { force?: boolean }): Promise<void> => {
     stopServer();
     if (opts?.force) {
       for (const { client: c } of _extraProcs) c.disconnect();
@@ -153,6 +465,5 @@ const piggy: any = {
   logger,
 };
 
-// NO PROXY WRAPPER - EXPORT THE PLAIN OBJECT DIRECTLY
 export default piggy;
 export { piggy };