@plurnk/plurnk-schemes-http 1.3.12 → 1.5.0

package/dist/index.d.ts

@@ -1,9 +1,8 @@
 export { default } from "./Http.ts";
 export { default as Http } from "./Http.ts";
 export { default as Ws } from "./Ws.ts";
-export { default as Browser } from "./Browser.ts";
-export type { ChromiumEngine, ChromiumFactory, RenderResult } from "./Browser.ts";
 export { default as WebFetcher } from "./WebFetcher.ts";
-export type { WebFetchResult } from "./WebFetcher.ts";
+export { PROJECTION_ID_HEADER, WebMaterializationError } from "./WebFetcher.ts";
+export type { WebFetchResult, WebMaterializedResult } from "./WebFetcher.ts";
 export { default as Guard, GuardBlockedError } from "./Guard.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,16 +1,10 @@
-// Public API barrel for @plurnk/plurnk-schemes-http.
-// The default export is the scheme class plurnk-service registers at boot
-// (plugin discovery scans node_modules/@plurnk/* for `plurnk.kind === "scheme"`).
+// Public package surface. package.json owns plugin registration {§http-manifest}.
 export { default } from "./Http.js";
 export { default as Http } from "./Http.js";
-// The WebSocket scheme (#468/#473) — this package's second first-class scheme,
-// registered `wss` via package.json plurnk.schemes ({ export: "Ws" }); the `ws`
-// prefix rides it (core's schemeNameOf, mirroring https → http).
+// The registered WebSocket handler {§ws}.
 export { default as Ws } from "./Ws.js";
-// Standalone render foundation — exported so a future plurnk browser-
-// troubleshooting MCP package can sit on the same warm-Chromium pool.
-export { default as Browser } from "./Browser.js";
-// The guarded prefetch acquisition seam core's entrySink calls (#454).
+// Automatic entry-acquisition primitive {§prefetch} and its URL check.
 export { default as WebFetcher } from "./WebFetcher.js";
+export { PROJECTION_ID_HEADER, WebMaterializationError } from "./WebFetcher.js";
 export { default as Guard, GuardBlockedError } from "./Guard.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,0EAA0E;AAC1E,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,+EAA+E;AAC/E,gFAAgF;AAChF,iEAAiE;AACjE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAExC,sEAAsE;AACtE,sEAAsE;AACtE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAGlD,uEAAuE;AACvE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,0CAA0C;AAC1C,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAExC,uEAAuE;AACvE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/docs/http.md

@@ -1,60 +1,115 @@
 # http(s)://
 
-Fetch a URL. HTML is rendered (headless browser, post-JS) and returned as
-**markdown by default** (main content; nav/ads/chrome stripped). Non-HTML
-returns its readable content under the response `Content-Type`. Every request
-streams its response: status `102` now, then an ordinary fragmentless READ
-returns the sanitized body. Auxiliary transport/archive channels are never
-presented by default.
-
-Re-reading a URL without `<scope>` **revalidates** it: the prior fetch's validators (`ETag`/
-`Last-Modified`) go out on the next READ, and if the page is unchanged the
-stored copy is served without re-rendering — always fresh, but cheap when
-nothing changed. Within the operator's freshness window a re-read serves the
-stored copy directly, skipping even that check. You just READ again; there's
-no cache flag to manage.
-
-A scoped READ (`READ(url)<start,end>`) observes the already-materialized
-readable response without refetching it. If the URL has not been materialized,
-READ it once without a scope first.
-
-The HTTP method is the **op**:
-
-- `READ(http(s)://…)` — GET.
-- `SEND[200](http(s)://…):body:` — POST the body.
-- `EDIT(http(s)://…):body:` — PUT the body (replaces the whole resource; no `<L>`).
-- `KILL(http(s)://…)` — DELETE the resource.
-
-The ordinary URL is the model-facing markdown for HTML, or readable response
-content for other textual types. Diagnostic channels require explicit access:
-
-- `#html` — faithful rendered DOM for HTML (`text/html`)
-- `#header` — response status line + headers (`text/plain`)
-
-Request headers ride **inside the target** as trailing `{Key: value}` blocks —
-one header per block, so a value may contain commas/colons:
-
-```
-READ(https://api.example.com/v1/me{Authorization: Bearer TOKEN}{Accept: application/json})
-EDIT(https://api.example.com/v1/thing/42{Authorization: Bearer TOKEN}{Content-Type: application/json}):{"done":true}:
+Use a web URL as an addressable entry. Every exact READ acquires or refreshes a
+complete representation when needed, then core selects the channel and applies
+the requested text scope. HTML becomes a readable model-facing body (normally
+Markdown); original server source is retained separately. Auxiliary channels
+are never presented by default.
+
+| Operation                         | Remote action | Effect                                                                     |
+| --------------------------------- | ------------- | -------------------------------------------------------------------------- |
+| `READ(http(s)://…)<scope?>`       | GET if needed | Acquire/reuse the complete response, then return the selected scoped text  |
+| `FIND(http(s)://…):matcher`       | GET if needed | Prepare an exact URL, then return flat match locations                     |
+| `SEND[200](http(s)://…):body:`    | POST          | Submit the body and stream the response                                    |
+| `EDIT(http(s)://…):body:`         | PUT           | Replace the whole remote resource; do not use a line scope                 |
+| `KILL(http(s)://…)`               | DELETE        | Delete the remote resource and stream the response                         |
+
+A path-pattern FIND searches only web entries already materialized in the
+workspace; a pattern cannot discover the remote web. FIND returns navigation
+metadata, not the selected page body. Use READ for content.
+
+Caller cancellation of an exact acquisition returns `499 cancelled`.
+
+| Response                             | `body`                                              | Other channel                                  |
+| ------------------------------------ | --------------------------------------------------- | ---------------------------------------------- |
+| Negotiated origin Markdown           | Exact origin Markdown                               | Independently requested server HTML in `#html` |
+| GET HTML                             | Tavily Markdown or local HTML-reader projection     | Original server HTML in `#html`                |
+| GET `text/event-stream`              | Event `data` chunks after READ `102`                 | Initial response in `#header`                  |
+| Configured textual response          | Complete Fetch-decoded text under its declared type | Status and headers in `#header`                |
+| Origin HTTP `4xx`/`5xx`              | Preserve available origin or independently produced text | Exact status on each origin-backed channel |
+| Binary with a readable projection    | Derived Unicode under the projection output type    | Origin type and projection ID in `#header`     |
+| Binary without a readable projection | No fabricated text representation                   | Exact `415` Problem                            |
+
+Generic public HTML uses configured Tavily as its body producer. A recoverable
+timeout, transport error, `429`, `5xx`, or per-URL extraction failure uses the
+local HTML reader and records terminal body status `203`. Authentication,
+provider rejection, and malformed provider responses are hard failures and do
+not silently switch producers. Any authored target metadata makes HTML use the
+local reader directly. Origin Markdown always wins without Tavily.
+
+Projection presence is structural: a returned projection is accepted even
+when its content is empty. `422 no-readable-projection` means the local route
+produced no model-facing body. An internal projection exception returns
+non-retryable `500 projection-failed`.
+
+A binary response uses the installed mimetype reader when one supplies a
+bounded Unicode projection; raw bytes never enter a durable channel. Without a
+reader, finite GET preparation returns `415 binary-response-unsupported`
+without fabricating an entry. Input above the configured byte ceiling returns
+`413 projection-input-limit`. A streamed POST, PUT, or DELETE response already
+owns lifecycle evidence in `#header`; do not retry a mutation solely to
+retrieve its binary body.
+
+`#header` contains origin and package acquisition evidence. A Tavily attempt
+adds its route, status, timing, any reported request ID and credits, and bounded
+failure evidence. `body`, `header`, and `html` carry independent durable
+producer outcomes; the selected channel determines success. Thus `#html` or
+`#header` can remain readable after a body failure, while a Tavily body can
+succeed without fabricating unavailable server HTML. `SEND[code]` is never the
+remote HTTP status. A direct non-success origin response is still materialized:
+origin-backed channels carry its exact durable `http-response-status` Problem,
+while independently produced Tavily content and acquisition headers retain
+their own outcomes.
+
+For SSE, the response and persisted `#header` establish acquisition. READ then
+returns `102` while events continue. Origin close settles the subscription at
+`200`; later cancellation or transfer failure settles it at `499` or `502`
+without rewriting the initial READ.
+
+Re-reading an exact URL can reuse only a complete GET acquired without
+explicit request metadata whose response had no `Vary` field. Plurnk keeps one
+representation per URL, so any target metadata or `Vary` response bypasses both
+the freshness shortcut and old validators instead of creating a variant store.
+Eligible content is served directly only while both the operator TTL and any
+origin `max-age` or `Expires` lifetime remain live. `no-cache` requires origin
+validation; `no-store` evidence remains in the log but supplies neither content
+nor validators to a later request. Only singular, syntactically valid stored
+validators are sent. A 304 restores a non-page representation only when its
+ETag or Last-Modified value identifies the nominated representation; otherwise
+acquisition fails without serving the stored body. Responses to POST, PUT, and
+DELETE are not reused as later GET representations. A projected GET is reused
+only while the installed reader has the same projection identity. Page bodies
+likewise require the same origin-Markdown, local, Tavily depth/version, or
+local-fallback route. Once stale, a page composite is fully reacquired without
+old validators; an origin 304 cannot certify provider or auxiliary material.
+
+Scope never suppresses acquisition or refresh. The HTTP producer cannot see the
+fragment or text coordinates; after preparation, the fragment (or `body` by
+default) selects a durable channel and core applies the range. Cold and warm
+forms therefore have identical selection and scope semantics.
+
+Request headers ride inside the target as ordered trailing `{Key: value}`
+blocks, one header per block:
+
+```plurnk
+<<READ(https://api.example.com/v1/me{Authorization: Bearer TOKEN}{Accept: application/json})::READ
+<<EDIT(https://api.example.com/v1/thing/42{Authorization: Bearer TOKEN}{Content-Type: application/json}):{"done":true}:EDIT
 ```
 
-Percent-encode `)`, `<`, and `}` inside a header value (the path-encoding rule).
-
-Host handling: a GitHub `…/blob/…` URL is fetched as its `raw.githubusercontent.com`
-source (line-navigable, exact) rather than the JS code-viewer page — so
-`READ(https://github.com/owner/repo/blob/main/src/x.ts)` returns the file's source.
-
-Cancel / cache:
-
-- `SEND[499](http(s)://…)` — cancel an in-flight request (abort the fetch).
-- `SEND[410](http(s)://…)` — drop the locally cached copy, forcing the next READ
-  to full-fetch instead of revalidate. A local cache drop, **not** an HTTP
-  DELETE — use `KILL` to DELETE the remote resource.
+Percent-encode `)`, `<`, and `}` inside a header value.
+An exact FIND forwards these headers when it must acquire the URL, but the
+result remains intentionally ineligible for later cache reuse. Target headers
+are never forwarded to Tavily, so HTML requests carrying any explicit metadata
+use the local HTML-reader projection. Executor-supplied HTML also stays local;
+only generic web acquisition grants Tavily spending authority.
 
-The `SEND[code]` is loop disposition (`102`/`200`/…), never the HTTP status —
-the real `2xx`/`4xx` comes back in `#header`.
+GET acquisition of a GitHub `…/blob/…` URL uses its
+`raw.githubusercontent.com` source. The addressed GitHub URL remains entry
+identity. POST, PUT, and DELETE never use that rewrite.
 
-Status: `102` streaming · `499` cancelled · `502` upstream/render failure.
+| Control                  | Effect                                                                |
+| ------------------------ | --------------------------------------------------------------------- |
+| `SEND[499](http(s)://…)` | Cancel the routed in-flight acquisition                               |
+| `SEND[410](http(s)://…)` | Delete the local stored response; the next READ must acquire it again |
 
-For a persistent, bidirectional connection, see the `wss://` scheme.
+For a persistent bidirectional connection, use `wss://`.

package/docs/wss.md

@@ -1,45 +1,41 @@
 # wss:// — WebSocket
 
-A full-duplex, persistent connection to a WebSocket origin. Unlike `http://`
-(request/response) or SSE (a one-way `http://` event stream), a WebSocket is
-**bidirectional and stateful**: you open it once, then send and receive on the
-same live connection until it closes.
-
-## Ops
-
-| Op | Effect |
-| --- | --- |
-| `READ(wss://host/path)` | Open the socket. Inbound frames stream into the `messages` channel as they arrive; the READ holds until the socket closes. |
-| `SEND[200](wss://host/path):your message:` | Push a message onto the **already-open** socket. READ it first — a SEND with no open socket is a `409`. |
-| `SEND[499](wss://host/path)` | Cancel: closes the open socket. |
-| `KILL(wss://host/path)` | Close the open socket. |
-
-```
-<<READ(wss://echo.websocket.events)::READ
-<<SEND[200](wss://echo.websocket.events):hello:SEND
-<<KILL(wss://echo.websocket.events)::KILL
-```
-
-A READ returns `102 Processing` and the socket's inbound frames accumulate in the
-`messages` channel across turns — read them as they land, the way you read any
-streaming subscription. The connection stays open for concurrent `SEND`s until
-you `KILL` it or the origin closes.
-
-## Model
-
-- **One socket per target, per workspace.** The connection a READ opens is keyed by
-  its path; a later SEND/KILL to the same target acts on that connection.
-- **SSRF-guarded.** The target is resolved and checked before connecting — a
-  `ws://`/`wss://` into loopback, link-local, or RFC-1918/CGNAT space is refused
-  (`403`), the same guard the fetch path uses.
-
-## Day-one limits
-
-- **Text frames only.** Binary frames stringify loosely; structured binary is a
-  follow-up (#468).
-- **No reconnection.** A dropped socket closes the READ; re-READ to reopen.
-- **Default handshake identity.** Custom request headers on the WebSocket
-  handshake aren't wired yet (the standard `WebSocket` constructor has no header
-  slot); pending, tracked on #468.
-
-Runtime: Node ≥22 (global `WebSocket`).
+Use WebSocket for a persistent, bidirectional connection. `wss` is a
+stateful scheme, not an HTTP content type: READ claims a workspace address and
+owns its socket until terminal settlement, while concurrent SEND and KILL
+operations address that owner.
+
+| Operation                             | Effect                                                                                     |
+| ------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `READ(wss://host/path)`               | Claim the address, connect, mark `messages` active on `open`, and stream inbound frames    |
+| A second `READ` of the same address   | Return `409` until the existing owner's terminal cleanup releases the claim                |
+| `SEND[200](wss://host/path):message:` | Send only through an open socket; claimed, connecting, or settling owners return `409`     |
+| `SEND[499](wss://host/path)`          | Cancel the owning READ through its routed subscription handle                              |
+| `KILL(wss://host/path)`               | Close or cancel the claimed owner; an address with no owner is `404`                       |
+
+| Owner state  | Meaning                                              | `SEND[200]`                                      |
+| ------------ | ---------------------------------------------------- | ------------------------------------------------ |
+| `claimed`    | Address reserved while entry/subscription setup runs | `409`; no second ownership path is created       |
+| `connecting` | Native socket exists but has not emitted `open`      | `409`; wait for the active stream event          |
+| `open`       | `open` was observed and the native state is open     | Sends the message                                |
+| `settling`   | A terminal transition owns cleanup                   | `409`; wait for cleanup before another READ      |
+
+The native `open` event plus durable `messages` activation is the acquisition
+boundary. It emits the ordinary metadata-only stream event and returns the READ
+at `102`; later operations from the same worker or client may then SEND or KILL
+the live owner. A close before acquisition is a direct `502` connection
+failure. After acquisition, close, cancellation, and failure settle the retained
+subscription without rewriting the initial READ.
+
+Connection identity includes the workspace, exact `ws`/`wss` protocol, host,
+non-default port, path, and ordered query. A fragment does not change socket
+identity; `messages` is the only current channel.
+
+| Current transport boundary | Behavior                                                                |
+| -------------------------- | ----------------------------------------------------------------------- |
+| Inbound payload            | String event data only; no coercion or binary projection                |
+| Inbound order              | Native event order; one durable write completes before the next begins  |
+| Binary inbound payload     | Keep the text prefix, prune the suffix, settle `415`, and close with private-use code `4003` |
+| Persistence failure        | Keep the successful prefix; prune queued and later frames; settle `500` |
+| Reconnection               | None; READ again after terminal cleanup                                 |
+| Handshake headers          | Target header metadata is not applied                                   |

package/package.json

@@ -1,21 +1,25 @@
 {
     "name": "@plurnk/plurnk-schemes-http",
-    "version": "1.3.12",
-    "description": "http(s):// URI scheme handler for the plurnk agent runtime — fetch + streaming response body.",
+    "version": "1.5.0",
+    "description": "HTTP(S) request/response and WebSocket scheme handlers for the plurnk agent runtime.",
     "keywords": [
         "plurnk",
         "scheme",
         "uri",
         "http",
-        "https"
+        "https",
+        "websocket",
+        "ws",
+        "wss"
     ],
-    "homepage": "https://github.com/plurnk/plurnk-schemes-http#readme",
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-schemes-http#readme",
     "bugs": {
-        "url": "https://github.com/plurnk/plurnk-schemes-http/issues"
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/plurnk/plurnk-schemes-http.git"
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-schemes-http"
     },
     "engines": {
         "node": ">=26"
@@ -49,7 +53,6 @@
     },
     "files": [
         "dist/**/*",
-        "scripts/**/*",
         ".env.defaults",
         "docs/**/*",
         "README.md",
@@ -58,19 +61,17 @@
     "scripts": {
         "test:lint": "tsc --noEmit",
         "test:unit": "node --conditions=plurnk-dev --test --env-file=.env.defaults src/**/*.test.ts",
-        "test:intg": "node --conditions=plurnk-dev --test --env-file=.env.defaults test/integration/**/*.test.ts",
         "test": "npm run test:lint && npm run test:unit",
+        "build:clean": "rm -rf dist",
         "build:dist": "tsc -p tsconfig.build.json",
-        "build": "npm run build:dist",
-        "postinstall": "node scripts/install-browser.mjs",
+        "build": "npm run build:clean && npm run build:dist",
         "prepublishOnly": "npm audit --audit-level=moderate && npm test",
         "prepack": "npm run build"
     },
     "peerDependencies": {
-        "@plurnk/plurnk-schemes": "^1.3.12"
+        "@plurnk/plurnk-schemes": "^1.5.0"
     },
     "dependencies": {
-        "eventsource-parser": "^3.1.0",
-        "playwright": "1.62.0"
+        "eventsource-parser": "^4.0.0"
     }
 }

package/dist/Browser.d.ts

@@ -1,84 +0,0 @@
-interface PwResponse {
-    status(): number;
-    statusText(): string;
-    headers(): Record<string, string>;
-}
-interface PwRoute {
-    request(): {
-        url(): string;
-    };
-    continue(): Promise<void>;
-    abort(): Promise<void>;
-}
-interface PwPage {
-    route(pattern: string, handler: (route: PwRoute) => Promise<void>): Promise<void>;
-    goto(url: string, opts: {
-        waitUntil: "networkidle";
-        timeout: number;
-    }): Promise<PwResponse | null>;
-    setExtraHTTPHeaders(headers: Record<string, string>): Promise<void>;
-    content(): Promise<string>;
-    evaluate<T>(fn: () => T): Promise<T>;
-    close(): Promise<void>;
-}
-interface PwContext {
-    newPage(): Promise<PwPage>;
-    close(): Promise<void>;
-}
-interface PwContextOptions {
-    userAgent: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    deviceScaleFactor: number;
-    isMobile: boolean;
-    hasTouch: boolean;
-}
-interface PwBrowser {
-    newContext(options?: PwContextOptions): Promise<PwContext>;
-    on(event: "disconnected", cb: () => void): void;
-    close(): Promise<void>;
-}
-interface PwLaunchOptions {
-    headless: boolean;
-    chromiumSandbox: boolean;
-    timeout: number;
-    args: ReadonlyArray<string>;
-    channel?: string;
-    executablePath?: string;
-}
-interface PwConnectOptions {
-    timeout: number;
-}
-export interface ChromiumEngine {
-    launch(opts: PwLaunchOptions): Promise<PwBrowser>;
-    connect(endpoint: string, opts: PwConnectOptions): Promise<PwBrowser>;
-    connectOverCDP(endpoint: string, opts: PwConnectOptions): Promise<PwBrowser>;
-}
-export type ChromiumFactory = () => Promise<ChromiumEngine>;
-export type PlaywrightMethod = "launch" | "connect" | "connectOverCDP" | "disabled";
-export interface RenderResult {
-    readonly status: number;
-    readonly statusText: string;
-    readonly headers: ReadonlyArray<readonly [string, string]>;
-    readonly html: string;
-}
-export declare const BROWSER_UA = "Mozilla/5.0 (Linux; Android 13; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36";
-export declare const requireNumEnv: (key: string) => number;
-export default class Browser {
-    #private;
-    constructor(factory?: ChromiumFactory);
-    ready(): Promise<PlaywrightMethod>;
-    render(url: string, { workerId, signal, headers, guard, timeout }: {
-        workerId: number;
-        signal?: AbortSignal;
-        headers?: ReadonlyArray<readonly [string, string]>;
-        guard?: (url: string) => Promise<boolean>;
-        timeout?: number;
-    }): Promise<RenderResult>;
-    closeContext(workerId: number): void;
-    close(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=Browser.d.ts.map

package/dist/Browser.d.ts.map

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