@qontinui/ui-bridge-wrapper 0.15.0 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -281,6 +281,12 @@ var LiveSessionTransport = class extends BaseTransport {
281
281
  if (!config.runnerUrl) {
282
282
  throw new WrapperTransportError("INVALID_CONFIG", `Transport kind 'live' requires runnerUrl`);
283
283
  }
284
+ if (!config.appId?.trim()) {
285
+ throw new WrapperTransportError(
286
+ "INVALID_CONFIG",
287
+ `Transport kind 'live' requires a non-blank appId (the runner refuses a register frame without one)`
288
+ );
289
+ }
284
290
  this.url = config.runnerUrl;
285
291
  this.appId = config.appId;
286
292
  this.appName = config.appName;
@@ -319,7 +325,8 @@ var LiveSessionTransport = class extends BaseTransport {
319
325
  type: "register",
320
326
  transport: "websocket",
321
327
  appId: this.appId,
322
- appName: this.appName,
328
+ // appName defaults to appId: the runner requires a non-blank one.
329
+ appName: this.appName?.trim() || this.appId,
323
330
  appType: this.opts.appType ?? "wrapper"
324
331
  };
325
332
  if (this.opts.framework !== void 0) frame.framework = this.opts.framework;
@@ -484,5 +491,5 @@ exports.SCREENSHOT_TIMEOUT_MS = SCREENSHOT_TIMEOUT_MS;
484
491
  exports.WrapperTransportError = WrapperTransportError;
485
492
  exports.captureScreenshotReply = captureScreenshotReply;
486
493
  exports.registerScreenshotCapture = registerScreenshotCapture;
487
- //# sourceMappingURL=chunk-Z32CC665.cjs.map
488
- //# sourceMappingURL=chunk-Z32CC665.cjs.map
494
+ //# sourceMappingURL=chunk-3EIJDQJO.cjs.map
495
+ //# sourceMappingURL=chunk-3EIJDQJO.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/types.ts","../src/handler-registry.ts","../src/base-transport.ts","../src/frame-page.ts","../src/screenshot-capture.ts","../src/transports/live.ts"],"names":[],"mappings":"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","file":"chunk-3EIJDQJO.cjs","sourcesContent":["/**\n * Public type surface for `@qontinui/ui-bridge-wrapper`.\n *\n * Wrapper apps pick a single transport (api / headless / headed / live) at\n * runtime but ship the same action code against every one of them. Every\n * concrete transport implements `WrapperTransport` and dispatches action\n * ids to handlers registered on a shared `HandlerRegistry`.\n */\n\nimport type { HandlerRegistry, WrapperHandler } from './handler-registry.js';\n\n/** Supported transport kinds for a wrapper runtime. */\nexport type WrapperTransportKind = 'api' | 'headless' | 'headed' | 'live' | 'injected';\n\n/** Transport lifecycle states surfaced to callers (and React via `useWrapperStatus`). */\nexport type WrapperTransportStatus = 'idle' | 'connecting' | 'ready' | 'error' | 'closed';\n\n/** Configuration accepted by `createTransport`. */\nexport interface TransportConfig {\n /** Which transport to spin up. */\n kind: WrapperTransportKind;\n /**\n * Runner WebSocket URL. Required for the `live` transport. Ignored by\n * `api`, `headless`, and `headed` — they run locally.\n */\n runnerUrl?: string;\n /** Stable app id used on the runner registry (live transport). */\n appId?: string;\n /** Friendly display name used on the runner registry (live transport). */\n appName?: string;\n /**\n * Per-transport options. Shape depends on `kind`:\n * - `api`: `{ handler?: (actionId, params) => unknown }` — convenience only;\n * prefer registering handlers via the returned transport's\n * `handlerRegistry.register(...)`.\n * - `headless` / `headed`:\n * `{ targetUrl: string; viewportWidth?: number; viewportHeight?: number;\n * deviceScaleFactor?: number; colorScheme?: 'light' | 'dark';\n * uiBridgeBase?: string; forwardConsole?: boolean }` — a requested\n * deviceScaleFactor / colorScheme is read back from the page after\n * launch, and a page reporting anything else fails `ready()` with\n * `EMULATION_NOT_APPLIED`. Also `recordHar`, `recordVideo`, `serviceWorkers` and\n * `initRouter`, passed to the launcher's browser context (a peer that\n * ignores them fails `ready()` with `CONTEXT_OPTIONS_NOT_APPLIED`)\n * - `live`: `{ handshakeTimeoutMs?: number; authToken?: string }`\n */\n options?: Record<string, unknown>;\n}\n\n/**\n * Normalized response envelope. Transports may choose to use this as their\n * dispatch return type for wrappers that prefer to branch on `success`\n * rather than catch thrown errors. Our transports throw on error by default\n * (closer to idiomatic JS); wrappers can wrap calls in `tryCommand` below\n * if they want an envelope instead.\n */\nexport interface CommandResponse<T = unknown> {\n success: boolean;\n result?: T;\n error?: { code: string; message: string; retryable?: boolean };\n}\n\n/**\n * Contract every transport implements.\n *\n * `dispatch` resolves with the handler's return value on success, or throws\n * a `WrapperTransportError` on failure. Status transitions are observable\n * via `onStatusChange`.\n */\nexport interface WrapperTransport {\n readonly kind: WrapperTransportKind;\n readonly status: WrapperTransportStatus;\n\n /**\n * The handler registry the transport dispatches through. Wrapper code\n * registers action handlers here during setup:\n *\n * transport.handlerRegistry.register(\"list-unread\", async (params, ctx) => {...});\n *\n * Equivalent to calling `transport.register(actionId, fn)` directly.\n */\n readonly handlerRegistry: HandlerRegistry;\n\n /** Convenience — delegates to `handlerRegistry.register`. */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void;\n\n /** Complete any async setup (browser launch, websocket handshake). */\n ready(): Promise<void>;\n\n /** Invoke a registered action by id. */\n dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult>;\n\n /** Tear everything down. Safe to call multiple times. */\n close(): Promise<void>;\n\n /**\n * Subscribe to status transitions. Returns an unsubscribe function that\n * consumers must call on unmount / shutdown.\n */\n onStatusChange(listener: (s: WrapperTransportStatus) => void): () => void;\n}\n\n/**\n * Structured error emitted by transport dispatch. Concrete transports\n * throw these so callers can introspect `code` / `retryable` without\n * string-matching error messages.\n */\nexport class WrapperTransportError extends Error {\n readonly code: string;\n readonly retryable: boolean;\n readonly cause?: unknown;\n /**\n * Optional structured diagnostic payload (error-code-specific shape) so\n * programmatic callers can branch on data instead of parsing the message —\n * e.g. `INJECTED_EXPECT_SELECTOR_UNMET` attaches\n * `{ registeredElements, elementCount }`.\n */\n readonly details?: unknown;\n\n constructor(\n code: string,\n message: string,\n options: { retryable?: boolean; cause?: unknown; details?: unknown } = {}\n ) {\n super(message);\n this.name = 'WrapperTransportError';\n this.code = code;\n this.retryable = options.retryable ?? false;\n if (options.cause !== undefined) {\n this.cause = options.cause;\n }\n if (options.details !== undefined) {\n this.details = options.details;\n }\n }\n}\n","/**\n * HandlerRegistry\n *\n * Shared by every concrete transport. The transport's `dispatch` method\n * looks up a handler by `actionId`, invokes it with `(params, ctx)`, and\n * awaits the (possibly async) result.\n *\n * The registry deliberately knows nothing about the transport — transports\n * build their own `ctx` object (e.g. `{ page }` for headless, `{ send }` for\n * live) and hand it to the handler. This keeps action code transport-aware\n * only when it explicitly reads `ctx`, and transport-agnostic otherwise.\n */\n\nimport { WrapperTransportError } from './types.js';\n\n/** Generic async handler signature used by every transport. */\nexport type WrapperHandler<TParams = unknown, TResult = unknown, TCtx = unknown> = (\n params: TParams | undefined,\n ctx: TCtx\n) => TResult | Promise<TResult>;\n\n/**\n * Map of `actionId` -> handler. Consumers register handlers during wrapper\n * setup, before the transport starts accepting dispatches.\n */\nexport class HandlerRegistry {\n private readonly handlers = new Map<string, WrapperHandler>();\n\n /**\n * Register (or replace) a handler for `actionId`. Replacement is explicit\n * rather than throwing because live reloading / hot module scenarios need\n * to update handlers without tearing the whole transport down.\n */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void {\n this.handlers.set(actionId, fn as WrapperHandler);\n }\n\n /** Remove a handler. Returns `true` if a handler was removed. */\n unregister(actionId: string): boolean {\n return this.handlers.delete(actionId);\n }\n\n /** All registered action ids. Stable iteration order (insertion order). */\n list(): string[] {\n return Array.from(this.handlers.keys());\n }\n\n /** Check whether a handler is registered for `actionId`. */\n has(actionId: string): boolean {\n return this.handlers.has(actionId);\n }\n\n /**\n * Invoke the handler registered under `actionId`.\n *\n * Throws `WrapperTransportError(\"NO_HANDLER\")` if no handler is registered.\n * Propagates handler errors wrapped as `WrapperTransportError(\"HANDLER_ERROR\")`\n * so callers can uniformly check `err.code`.\n */\n async dispatch<TResult = unknown>(\n actionId: string,\n params?: unknown,\n ctx?: unknown\n ): Promise<TResult> {\n const handler = this.handlers.get(actionId);\n if (!handler) {\n throw new WrapperTransportError(\n 'NO_HANDLER',\n `No handler registered for action '${actionId}'`\n );\n }\n try {\n const result = await handler(params, ctx);\n return result as TResult;\n } catch (err) {\n if (err instanceof WrapperTransportError) throw err;\n const message = err instanceof Error ? err.message : String(err);\n throw new WrapperTransportError('HANDLER_ERROR', message, { cause: err });\n }\n }\n}\n","/**\n * BaseTransport\n *\n * Abstract base class for every transport. Owns the shared `HandlerRegistry`\n * plus a small status + listener state machine. Subclasses implement:\n *\n * - `kind` — static identifier\n * - `onReady()` — async setup (browser launch, ws handshake...)\n * - `onClose()` — async teardown\n * - `buildContext(actionId, params)` — per-dispatch context passed to the\n * registered handler (e.g. `{ page }`)\n *\n * `dispatch` is final; it coordinates `ready()` gating, then routes through\n * the registry. Subclasses that need to marshal dispatches over the wire\n * (like `LiveSessionTransport`) can override `dispatch` directly.\n */\n\nimport { HandlerRegistry, type WrapperHandler } from './handler-registry.js';\nimport type { WrapperTransport, WrapperTransportKind, WrapperTransportStatus } from './types.js';\nimport { WrapperTransportError } from './types.js';\n\nexport abstract class BaseTransport implements WrapperTransport {\n abstract readonly kind: WrapperTransportKind;\n\n protected _status: WrapperTransportStatus = 'idle';\n protected readonly listeners = new Set<(s: WrapperTransportStatus) => void>();\n protected readonly registry: HandlerRegistry;\n private readyPromise: Promise<void> | null = null;\n\n constructor(registry?: HandlerRegistry) {\n this.registry = registry ?? new HandlerRegistry();\n }\n\n get status(): WrapperTransportStatus {\n return this._status;\n }\n\n /** Expose the underlying registry so wrappers can register handlers. */\n get handlerRegistry(): HandlerRegistry {\n return this.registry;\n }\n\n /** Convenience: register a handler on the transport's registry. */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void {\n this.registry.register(actionId, fn);\n }\n\n /**\n * Idempotent async setup. First call runs `onReady()`; subsequent calls\n * share the same promise until it settles, after which further calls\n * are no-ops if `status === 'ready'`, or re-run setup if it errored.\n */\n async ready(): Promise<void> {\n if (this._status === 'ready') return;\n if (this._status === 'closed') {\n throw new WrapperTransportError('TRANSPORT_CLOSED', `Transport '${this.kind}' is closed`);\n }\n if (this.readyPromise) return this.readyPromise;\n\n this.setStatus('connecting');\n this.readyPromise = this.onReady()\n .then(() => {\n this.setStatus('ready');\n })\n .catch((err: unknown) => {\n this.setStatus('error');\n this.readyPromise = null;\n throw err;\n });\n return this.readyPromise;\n }\n\n /** Default dispatch — waits for ready, builds ctx, delegates to registry. */\n async dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult> {\n await this.ready();\n const ctx = await this.buildContext(actionId, params);\n return this.registry.dispatch<TResult>(actionId, params, ctx);\n }\n\n async close(): Promise<void> {\n if (this._status === 'closed') return;\n try {\n await this.onClose();\n } finally {\n this.setStatus('closed');\n this.listeners.clear();\n this.readyPromise = null;\n }\n }\n\n onStatusChange(listener: (s: WrapperTransportStatus) => void): () => void {\n this.listeners.add(listener);\n return () => {\n this.listeners.delete(listener);\n };\n }\n\n /** Update status and notify listeners. Safe to call from subclasses. */\n protected setStatus(next: WrapperTransportStatus): void {\n if (this._status === next) return;\n this._status = next;\n for (const l of this.listeners) {\n try {\n l(next);\n } catch {\n // Listener errors must not affect transport state.\n }\n }\n }\n\n /** Subclass hook: perform async setup. */\n protected abstract onReady(): Promise<void>;\n\n /** Subclass hook: tear down async resources. */\n protected abstract onClose(): Promise<void>;\n\n /**\n * Subclass hook: build the context object passed to handlers. Default is\n * `undefined` (api transport). Headless/headed override to provide the\n * Playwright `page`; live overrides to provide a response helper.\n */\n protected async buildContext(_actionId: string, _params: unknown): Promise<unknown> {\n return undefined;\n }\n}\n","/**\n * The page-side frame helpers: what a capture reads off a Playwright-like page\n * and off the PNG it returns. NODE-FREE by contract — no Node builtin, no\n * `Buffer`, no `process` — because the browser-safe `./live` entry imports it\n * (through `screenshot-capture.ts`). `frame-capture.ts` re-exports all of it.\n */\n\n/** The `prefers-color-scheme` a page rendered in. */\nexport type FrameColorScheme = 'dark' | 'light';\n\n/** What the page says about how it is being rendered. */\nexport interface PageMetrics {\n devicePixelRatio: number;\n innerWidth: number;\n innerHeight: number;\n colorScheme: FrameColorScheme;\n}\n\n/** The slice of a Playwright `Page` frame capture needs. */\nexport interface FramePage {\n evaluate<R>(fn: () => R | Promise<R>): Promise<R>;\n screenshot(options: { type: 'png'; scale: 'device'; fullPage: false }): Promise<Uint8Array>;\n}\n\nconst PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\n\n/**\n * Width and height from a PNG's IHDR chunk. Throws on anything that is not a\n * PNG with an IHDR first — a frame whose size cannot be read cannot be mapped.\n */\nexport function pngDimensions(buf: Uint8Array): { width: number; height: number } {\n if (buf.length < 24 || PNG_SIGNATURE.some((b, i) => buf[i] !== b)) {\n throw new Error('not a PNG (signature mismatch or truncated header)');\n }\n const chunkType = String.fromCharCode(buf[12]!, buf[13]!, buf[14]!, buf[15]!);\n if (chunkType !== 'IHDR') {\n throw new Error(`PNG does not start with an IHDR chunk (found ${JSON.stringify(chunkType)})`);\n }\n const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/** Read the page's own rendering metrics — never the flags that requested them. */\nexport async function readPageMetrics(page: Pick<FramePage, 'evaluate'>): Promise<PageMetrics> {\n return page.evaluate(() => ({\n devicePixelRatio: window.devicePixelRatio,\n innerWidth: window.innerWidth,\n innerHeight: window.innerHeight,\n colorScheme: (window.matchMedia('(prefers-color-scheme: dark)').matches\n ? 'dark'\n : 'light') as FrameColorScheme,\n }));\n}\n","/**\n * `getScreenshot` over a transport. NODE-FREE by contract (no Node builtin,\n * no `Buffer`, no `process`): the browser-safe `./live` entry exports it, and\n * the live transport imports it. `frame-capture.ts` re-exports all of it.\n */\n\nimport { WrapperTransportError } from './types.js';\nimport { pngDimensions, readPageMetrics, type FramePage, type PageMetrics } from './frame-page.js';\n\n/**\n * ---------------------------------------------------------------------------\n * `getScreenshot` over a transport (plan\n * 2026-11-21-vision-capture-cannot-frame-a-websocket-transport-app, Phase 3)\n * ---------------------------------------------------------------------------\n *\n * The runner's vision routes capture a WebSocket-transport app by relaying\n * {@link SCREENSHOT_ACTION} over the app's socket, and only to an app whose\n * register frame advertises {@link SCREENSHOT_CAPABILITY}. The client takes\n * the frame with the page handle it owns: the runner holds none.\n *\n * The reply is the React Native HTTP provider's body shape,\n * `{ screenshot: <base64 png>, width: <CSS px>, height: <CSS px> }`\n * (`ui-bridge-native/src/server/http-server.ts`), so the runner decodes both\n * with one decoder (`frame_from_screenshot_json`).\n */\n\n/**\n * The capability string a client advertises when it answers\n * {@link SCREENSHOT_ACTION}. The runner refuses a WebSocket capture target that\n * does not advertise it (`422 FRAME_SOURCE_UNSUPPORTED`). Advertise it ONLY by\n * registering the handler — {@link registerScreenshotCapture} and\n * `LiveTransportOptions.screenshotPage` do both together, so the advertisement\n * cannot drift from the behaviour.\n */\nexport const SCREENSHOT_CAPABILITY = 'screenshot';\n\n/** The action the runner relays to capture a frame: the native handler's name. */\nexport const SCREENSHOT_ACTION = 'getScreenshot';\n\n/** The capture bound: the native provider's 10 s screenshot timeout. */\nexport const SCREENSHOT_TIMEOUT_MS = 10_000;\n\n/**\n * Chromium's refusal to screenshot a document that has no compositor frame\n * yet — CDP `Page.captureScreenshot` answering `Unable to capture screenshot`,\n * measured on frame 1 right after a reload commit. The only screenshot error\n * that is retried; every other one is final at once.\n */\nexport const NO_COMPOSITOR_FRAME = /Unable to capture screenshot/;\n\n/** The wait between attempts at a frame Chromium refused: about one 60 Hz frame. */\nexport const NO_COMPOSITOR_FRAME_RETRY_MS = 16;\n\n/** The `getScreenshot` reply body. */\nexport interface ScreenshotReply {\n /** The PNG, base64 (no data-URL prefix). */\n screenshot: string;\n /** CSS-pixel viewport width (`innerWidth`) the frame covers. */\n width: number;\n /** CSS-pixel viewport height (`innerHeight`) the frame covers. */\n height: number;\n}\n\n/** Anything a `getScreenshot` handler can be registered on (a transport or its registry). */\nexport interface ScreenshotRegistrar {\n register(actionId: string, fn: (params: unknown, ctx: unknown) => unknown): void;\n}\n\n/** Tuning for {@link registerScreenshotCapture}; the defaults are the contract. */\nexport interface ScreenshotCaptureOptions {\n /** Overall bound on one capture, retries included. Default {@link SCREENSHOT_TIMEOUT_MS}. */\n timeoutMs?: number;\n /** Wait between attempts after a no-compositor-frame refusal. Default {@link NO_COMPOSITOR_FRAME_RETRY_MS}. */\n retryMs?: number;\n}\n\n/**\n * Base64 with no Node `Buffer`: `btoa` is a global in browsers and in Node 16+\n * (this package requires Node 20), so one code path serves both. Built in\n * chunks so a multi-MB frame never spreads millions of arguments at once.\n */\nfunction toBase64(bytes: Uint8Array): string {\n const CHUNK = 0x8000;\n let binary = '';\n for (let i = 0; i < bytes.length; i += CHUNK) {\n binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));\n }\n return btoa(binary);\n}\n\nfunction errorText(err: unknown): string {\n return err instanceof Error ? err.message : String(err);\n}\n\n/**\n * Take one `getScreenshot` reply off `page`, bounded by `timeoutMs` overall.\n *\n * Errors are typed so the runner can carry the code to the caller:\n * `SCREENSHOT_TIMEOUT` (retryable) when the bound is spent, and\n * `SCREENSHOT_FAILED` for a refused or unreadable screenshot — retryable only\n * when the last refusal was Chromium's no-compositor-frame one.\n */\nexport async function captureScreenshotReply(\n page: FramePage,\n options: ScreenshotCaptureOptions = {}\n): Promise<ScreenshotReply> {\n const timeoutMs = options.timeoutMs ?? SCREENSHOT_TIMEOUT_MS;\n const retryMs = options.retryMs ?? NO_COMPOSITOR_FRAME_RETRY_MS;\n const deadline = Date.now() + timeoutMs;\n let timedOut = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n\n const attempt = async (): Promise<ScreenshotReply> => {\n let metrics: PageMetrics;\n try {\n metrics = await readPageMetrics(page);\n } catch (err) {\n throw new WrapperTransportError(\n 'SCREENSHOT_FAILED',\n `could not read the page's viewport: ${errorText(err)}`,\n { cause: err }\n );\n }\n for (;;) {\n let png: Uint8Array;\n try {\n png = await page.screenshot({ type: 'png', scale: 'device', fullPage: false });\n } catch (err) {\n const text = errorText(err);\n const noFrameYet = NO_COMPOSITOR_FRAME.test(text);\n if (noFrameYet && !timedOut && Date.now() + retryMs < deadline) {\n await new Promise((r) => setTimeout(r, retryMs));\n if (timedOut) throw err;\n continue;\n }\n throw new WrapperTransportError('SCREENSHOT_FAILED', `screenshot failed: ${text}`, {\n retryable: noFrameYet,\n cause: err,\n });\n }\n try {\n pngDimensions(png);\n } catch (err) {\n throw new WrapperTransportError(\n 'SCREENSHOT_FAILED',\n `the screenshot is unreadable: ${errorText(err)}`,\n { cause: err }\n );\n }\n return { screenshot: toBase64(png), width: metrics.innerWidth, height: metrics.innerHeight };\n }\n };\n\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(() => {\n timedOut = true;\n reject(\n new WrapperTransportError(\n 'SCREENSHOT_TIMEOUT',\n `screenshot did not complete within ${timeoutMs}ms`,\n { retryable: true }\n )\n );\n }, timeoutMs);\n });\n\n try {\n return await Promise.race([attempt(), timeout]);\n } finally {\n clearTimeout(timer);\n }\n}\n\n/**\n * Register a {@link SCREENSHOT_ACTION} handler that captures `page` — the\n * page-backed counterpart of inject-cli's `registerFrameCapture`, reusable by\n * any transport that owns a page. The caller that advertises\n * {@link SCREENSHOT_CAPABILITY} must call this (the live transport does both\n * from `LiveTransportOptions.screenshotPage`).\n */\nexport function registerScreenshotCapture(\n registrar: ScreenshotRegistrar,\n page: FramePage,\n options: ScreenshotCaptureOptions = {}\n): void {\n registrar.register(SCREENSHOT_ACTION, () => captureScreenshotReply(page, options));\n}\n","/**\n * LiveSessionTransport\n *\n * Connects to the qontinui runner's wrapper-session WebSocket endpoint,\n * registers as a wrapper instance, and translates incoming `command`\n * frames into local handler invocations. Responses flow back as\n * `response` frames matched by `commandId`.\n *\n * Frame shapes match the Phase 1 runner protocol:\n *\n * client -> server:\n * { \"type\": \"register\", \"transport\": \"websocket\",\n * \"appId\", \"appName\", \"appType\",\n * \"framework\"?, \"version\"?, \"capabilities\"?,\n * \"origin\"?, \"pageUrl\"? }\n * { \"type\": \"response\", \"commandId\", \"success\", \"result\"?, \"error\"? }\n *\n * server -> client:\n * { \"type\": \"registered\", \"appId\", \"connId\", \"acceptedAt\" }\n * { \"type\": \"command\", \"commandId\", \"action\", \"payload\"? }\n *\n * The transport also exposes `dispatch` for direct, self-issued commands —\n * useful in tests and in wrappers that want to invoke their own actions\n * without round-tripping through the runner.\n */\n\nimport { BaseTransport } from '../base-transport.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig, WrapperTransportKind } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\nimport { registerScreenshotCapture, SCREENSHOT_CAPABILITY } from '../screenshot-capture.js';\nimport type { FramePage } from '../frame-page.js';\n\n/** Options extracted from `TransportConfig.options` for the live transport. */\nexport interface LiveTransportOptions {\n /** Max time to wait for the server ack after `register`. Defaults to 10 000 ms. */\n handshakeTimeoutMs?: number;\n /** Bearer token for the `Authorization` header on the WebSocket upgrade. */\n authToken?: string;\n /**\n * App-type identifier — required by the runner's `RegisterFrame` schema\n * (`mcp/ws_relay.rs`). Common values: `\"web\"`, `\"mobile\"`, `\"native\"`,\n * `\"extension\"`, `\"wrapper\"`. Defaults to `\"wrapper\"` when not provided.\n */\n appType?: string;\n /** UI framework hint forwarded to `app_registry` (e.g. `\"react\"`, `\"vue\"`). */\n framework?: string;\n /** Wrapper version forwarded to `app_registry`. */\n version?: string;\n /**\n * Capability strings forwarded to `app_registry`. The runner reads\n * `\"screenshot\"` to decide whether it may relay `getScreenshot` to this app.\n * When this process owns a page, do not list it by hand — set\n * {@link screenshotPage}, which registers the handler and advertises the\n * capability together. The one legitimate hand-listing is a caller that\n * registers its OWN `getScreenshot` handler on the registry and has no page\n * to hand over — the browser extension's live relay, which captures through\n * `chrome.tabs.captureVisibleTab` in its service worker. Such a caller must\n * list `\"screenshot\"` only once that registration has succeeded.\n */\n capabilities?: string[];\n /**\n * A page this process owns (a Playwright `Page` satisfies it). When set, the\n * transport registers a `getScreenshot` handler that captures it (see\n * `registerScreenshotCapture` in `screenshot-capture.ts`) and appends\n * `\"screenshot\"` to the register frame's `capabilities`, so the runner's\n * vision routes can frame this app over its socket. Unset: no handler, no\n * capability, and the runner refuses this app as a capture target by name.\n */\n screenshotPage?: FramePage;\n /** Origin URL forwarded to `app_registry` (informational). */\n origin?: string;\n /** Page URL forwarded to `app_registry` (informational). */\n pageUrl?: string;\n}\n\n/** Context delivered to live-session handlers. */\nexport interface LiveContext {\n readonly kind: 'live';\n /** commandId the runner attached to this dispatch, if any. */\n readonly commandId: string | null;\n}\n\n/**\n * Minimal WebSocket contract, intersection of browser `WebSocket` and\n * `ws.WebSocket`. Keeps the transport usable in both Node and browser\n * without pulling `ws` as a hard dep.\n */\ninterface MinimalWebSocket {\n readonly readyState: number;\n send(data: string): void;\n close(code?: number, reason?: string): void;\n addEventListener(type: 'open', listener: () => void): void;\n addEventListener(type: 'close', listener: () => void): void;\n addEventListener(type: 'error', listener: (ev: unknown) => void): void;\n addEventListener(type: 'message', listener: (ev: { data: unknown }) => void): void;\n}\n\ntype WebSocketCtor = new (url: string, protocols?: string | string[]) => MinimalWebSocket;\n\ninterface RegisterFrame {\n type: 'register';\n transport: 'websocket';\n appId?: string;\n /**\n * Required by the runner's `RegisterFrame` deserializer; defaults to\n * `appId` when the caller set none (or a blank one).\n */\n appName: string;\n /**\n * Required by the runner's `RegisterFrame` deserializer; defaults to\n * `\"wrapper\"` if the caller did not configure `options.appType`.\n */\n appType: string;\n framework?: string;\n version?: string;\n capabilities?: string[];\n origin?: string;\n pageUrl?: string;\n}\n\ninterface AckFrame {\n /**\n * Two equivalent post-register acknowledgement shapes are accepted from\n * the runner: the original `{type: \"ack\", ok}` and the more descriptive\n * `{type: \"registered\", appId, connId, acceptedAt}` it actually emits\n * today. Both are treated as a successful handshake; failure is signalled\n * by either `ok: false` or a `type: \"ack\"` with an `error` payload.\n */\n type: 'ack' | 'registered';\n ok?: boolean;\n appId?: string;\n connId?: number;\n acceptedAt?: number;\n error?: { code?: string; message?: string };\n}\n\ninterface CommandFrame {\n type: 'command';\n commandId: string;\n action: string;\n payload?: unknown;\n}\n\ninterface ResponseFrame {\n type: 'response';\n commandId: string;\n success: boolean;\n result?: unknown;\n error?: { code: string; message: string; retryable?: boolean };\n}\n\ntype IncomingFrame = AckFrame | CommandFrame | { type: string; [k: string]: unknown };\n\nexport class LiveSessionTransport extends BaseTransport {\n readonly kind: WrapperTransportKind = 'live';\n\n private readonly url: string;\n private readonly appId?: string;\n private readonly appName?: string;\n private readonly opts: LiveTransportOptions;\n private readonly wsCtor: WebSocketCtor;\n\n private ws: MinimalWebSocket | null = null;\n private ackResolvers: {\n resolve: () => void;\n reject: (err: Error) => void;\n timer: ReturnType<typeof setTimeout>;\n } | null = null;\n\n constructor(\n config: TransportConfig,\n registry?: HandlerRegistry,\n injected?: { webSocketCtor?: WebSocketCtor }\n ) {\n super(registry);\n if (!config.runnerUrl) {\n throw new WrapperTransportError('INVALID_CONFIG', `Transport kind 'live' requires runnerUrl`);\n }\n // The runner's RegisterFrame requires a non-blank appId and appName\n // (qontinui-runner src-tauri/src/mcp/ws_relay.rs): a frame missing either\n // is refused and the socket closed before the ack. Refuse here, where the\n // caller can see why, rather than as DISCONNECTED \"WebSocket closed before ack\".\n if (!config.appId?.trim()) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind 'live' requires a non-blank appId (the runner refuses a register frame without one)`\n );\n }\n this.url = config.runnerUrl;\n this.appId = config.appId;\n this.appName = config.appName;\n this.opts = (config.options ?? {}) as LiveTransportOptions;\n const page = this.opts.screenshotPage;\n if (page !== undefined) {\n if (\n page === null ||\n typeof page.screenshot !== 'function' ||\n typeof page.evaluate !== 'function'\n ) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `options.screenshotPage must expose screenshot() and evaluate() (a Playwright Page does)`\n );\n }\n registerScreenshotCapture(this.registry, page);\n }\n const fromInjection = injected?.webSocketCtor;\n // Prefer the browser's global WebSocket if present; allow the caller\n // to inject a Node-side `ws` implementation.\n const fromGlobal =\n typeof (globalThis as { WebSocket?: WebSocketCtor }).WebSocket === 'function'\n ? ((globalThis as { WebSocket?: WebSocketCtor }).WebSocket as WebSocketCtor)\n : undefined;\n const resolved = fromInjection ?? fromGlobal;\n if (!resolved) {\n throw new WrapperTransportError(\n 'NO_WEBSOCKET',\n `No WebSocket constructor available. Provide one via the second constructor arg or run in an environment with global WebSocket.`\n );\n }\n this.wsCtor = resolved;\n }\n\n protected async onReady(): Promise<void> {\n const ws = new this.wsCtor(this.url);\n this.ws = ws;\n\n ws.addEventListener('message', (ev) => this.handleMessage(ev.data));\n ws.addEventListener('close', () => this.handleClose());\n ws.addEventListener('error', (ev) => this.handleError(ev));\n\n // Wait for `open`, then send `register` and wait for `ack` (or timeout).\n await new Promise<void>((resolve, reject) => {\n const onOpen = () => {\n try {\n const frame: RegisterFrame = {\n type: 'register',\n transport: 'websocket',\n appId: this.appId,\n // appName defaults to appId: the runner requires a non-blank one.\n appName: this.appName?.trim() || this.appId!,\n appType: this.opts.appType ?? 'wrapper',\n };\n if (this.opts.framework !== undefined) frame.framework = this.opts.framework;\n if (this.opts.version !== undefined) frame.version = this.opts.version;\n const capabilities = this.advertisedCapabilities();\n if (capabilities !== undefined) frame.capabilities = capabilities;\n if (this.opts.origin !== undefined) frame.origin = this.opts.origin;\n if (this.opts.pageUrl !== undefined) frame.pageUrl = this.opts.pageUrl;\n ws.send(JSON.stringify(frame));\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)));\n return;\n }\n const timeoutMs = this.opts.handshakeTimeoutMs ?? 10_000;\n const timer = setTimeout(() => {\n this.ackResolvers = null;\n reject(\n new WrapperTransportError(\n 'HANDSHAKE_TIMEOUT',\n `Did not receive register ack within ${timeoutMs}ms`\n )\n );\n }, timeoutMs);\n this.ackResolvers = { resolve, reject, timer };\n };\n ws.addEventListener('open', onOpen);\n });\n }\n\n protected async onClose(): Promise<void> {\n const ws = this.ws;\n this.ws = null;\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n this.ackResolvers.reject(\n new WrapperTransportError('TRANSPORT_CLOSED', 'Transport closed during handshake')\n );\n this.ackResolvers = null;\n }\n if (ws) {\n try {\n ws.close();\n } catch {\n // ignore — best-effort teardown\n }\n }\n }\n\n /**\n * The register frame's `capabilities`: the caller's list, plus\n * `\"screenshot\"` exactly when this transport registered the handler for it.\n * `undefined` (field omitted) when there is nothing to advertise.\n */\n private advertisedCapabilities(): string[] | undefined {\n const declared = this.opts.capabilities;\n if (this.opts.screenshotPage === undefined) return declared;\n const list = [...(declared ?? [])];\n if (!list.includes(SCREENSHOT_CAPABILITY)) list.push(SCREENSHOT_CAPABILITY);\n return list;\n }\n\n protected async buildContext(): Promise<LiveContext> {\n return { kind: 'live', commandId: null };\n }\n\n private handleMessage(data: unknown): void {\n let frame: IncomingFrame;\n try {\n const text = typeof data === 'string' ? data : String(data);\n frame = JSON.parse(text) as IncomingFrame;\n } catch {\n return;\n }\n\n switch (frame.type) {\n case 'ack':\n case 'registered': {\n const f = frame as AckFrame;\n if (!this.ackResolvers) return;\n clearTimeout(this.ackResolvers.timer);\n if (f.ok === false) {\n const err = new WrapperTransportError(\n f.error?.code ?? 'REGISTER_FAILED',\n f.error?.message ?? 'Runner refused registration'\n );\n this.ackResolvers.reject(err);\n } else {\n this.ackResolvers.resolve();\n }\n this.ackResolvers = null;\n return;\n }\n case 'command': {\n const f = frame as CommandFrame;\n void this.handleCommand(f);\n return;\n }\n default:\n return; // ignore unknown frames\n }\n }\n\n private async handleCommand(frame: CommandFrame): Promise<void> {\n const ctx: LiveContext = { kind: 'live', commandId: frame.commandId };\n let response: ResponseFrame;\n try {\n const result = await this.registry.dispatch(frame.action, frame.payload, ctx);\n response = {\n type: 'response',\n commandId: frame.commandId,\n success: true,\n result,\n };\n } catch (err) {\n const code = err instanceof WrapperTransportError ? err.code : 'HANDLER_ERROR';\n const retryable = err instanceof WrapperTransportError ? err.retryable : false;\n const message = err instanceof Error ? err.message : String(err);\n response = {\n type: 'response',\n commandId: frame.commandId,\n success: false,\n error: { code, message, retryable },\n };\n }\n try {\n this.ws?.send(JSON.stringify(response));\n } catch {\n // socket died mid-response; nothing to be done.\n }\n }\n\n private handleClose(): void {\n if (this._status === 'closed') return;\n this.setStatus('closed');\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n this.ackResolvers.reject(\n new WrapperTransportError('DISCONNECTED', 'WebSocket closed before ack')\n );\n this.ackResolvers = null;\n }\n }\n\n private handleError(ev: unknown): void {\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n const message = this.extractErrorMessage(ev);\n this.ackResolvers.reject(\n new WrapperTransportError('WEBSOCKET_ERROR', message, { retryable: true })\n );\n this.ackResolvers = null;\n } else {\n this.setStatus('error');\n }\n }\n\n private extractErrorMessage(ev: unknown): string {\n if (ev && typeof ev === 'object' && 'message' in ev) {\n const m = (ev as { message?: unknown }).message;\n if (typeof m === 'string') return m;\n }\n if (ev instanceof Error) return ev.message;\n return 'WebSocket error';\n }\n}\n"]}
@@ -279,6 +279,12 @@ var LiveSessionTransport = class extends BaseTransport {
279
279
  if (!config.runnerUrl) {
280
280
  throw new WrapperTransportError("INVALID_CONFIG", `Transport kind 'live' requires runnerUrl`);
281
281
  }
282
+ if (!config.appId?.trim()) {
283
+ throw new WrapperTransportError(
284
+ "INVALID_CONFIG",
285
+ `Transport kind 'live' requires a non-blank appId (the runner refuses a register frame without one)`
286
+ );
287
+ }
282
288
  this.url = config.runnerUrl;
283
289
  this.appId = config.appId;
284
290
  this.appName = config.appName;
@@ -317,7 +323,8 @@ var LiveSessionTransport = class extends BaseTransport {
317
323
  type: "register",
318
324
  transport: "websocket",
319
325
  appId: this.appId,
320
- appName: this.appName,
326
+ // appName defaults to appId: the runner requires a non-blank one.
327
+ appName: this.appName?.trim() || this.appId,
321
328
  appType: this.opts.appType ?? "wrapper"
322
329
  };
323
330
  if (this.opts.framework !== void 0) frame.framework = this.opts.framework;
@@ -474,5 +481,5 @@ var LiveSessionTransport = class extends BaseTransport {
474
481
  };
475
482
 
476
483
  export { BaseTransport, HandlerRegistry, LiveSessionTransport, SCREENSHOT_ACTION, SCREENSHOT_CAPABILITY, SCREENSHOT_TIMEOUT_MS, WrapperTransportError, captureScreenshotReply, registerScreenshotCapture };
477
- //# sourceMappingURL=chunk-IKHDNIU4.js.map
478
- //# sourceMappingURL=chunk-IKHDNIU4.js.map
484
+ //# sourceMappingURL=chunk-WI4MTFWJ.js.map
485
+ //# sourceMappingURL=chunk-WI4MTFWJ.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/types.ts","../src/handler-registry.ts","../src/base-transport.ts","../src/frame-page.ts","../src/screenshot-capture.ts","../src/transports/live.ts"],"names":[],"mappings":"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","file":"chunk-WI4MTFWJ.js","sourcesContent":["/**\n * Public type surface for `@qontinui/ui-bridge-wrapper`.\n *\n * Wrapper apps pick a single transport (api / headless / headed / live) at\n * runtime but ship the same action code against every one of them. Every\n * concrete transport implements `WrapperTransport` and dispatches action\n * ids to handlers registered on a shared `HandlerRegistry`.\n */\n\nimport type { HandlerRegistry, WrapperHandler } from './handler-registry.js';\n\n/** Supported transport kinds for a wrapper runtime. */\nexport type WrapperTransportKind = 'api' | 'headless' | 'headed' | 'live' | 'injected';\n\n/** Transport lifecycle states surfaced to callers (and React via `useWrapperStatus`). */\nexport type WrapperTransportStatus = 'idle' | 'connecting' | 'ready' | 'error' | 'closed';\n\n/** Configuration accepted by `createTransport`. */\nexport interface TransportConfig {\n /** Which transport to spin up. */\n kind: WrapperTransportKind;\n /**\n * Runner WebSocket URL. Required for the `live` transport. Ignored by\n * `api`, `headless`, and `headed` — they run locally.\n */\n runnerUrl?: string;\n /** Stable app id used on the runner registry (live transport). */\n appId?: string;\n /** Friendly display name used on the runner registry (live transport). */\n appName?: string;\n /**\n * Per-transport options. Shape depends on `kind`:\n * - `api`: `{ handler?: (actionId, params) => unknown }` — convenience only;\n * prefer registering handlers via the returned transport's\n * `handlerRegistry.register(...)`.\n * - `headless` / `headed`:\n * `{ targetUrl: string; viewportWidth?: number; viewportHeight?: number;\n * deviceScaleFactor?: number; colorScheme?: 'light' | 'dark';\n * uiBridgeBase?: string; forwardConsole?: boolean }` — a requested\n * deviceScaleFactor / colorScheme is read back from the page after\n * launch, and a page reporting anything else fails `ready()` with\n * `EMULATION_NOT_APPLIED`. Also `recordHar`, `recordVideo`, `serviceWorkers` and\n * `initRouter`, passed to the launcher's browser context (a peer that\n * ignores them fails `ready()` with `CONTEXT_OPTIONS_NOT_APPLIED`)\n * - `live`: `{ handshakeTimeoutMs?: number; authToken?: string }`\n */\n options?: Record<string, unknown>;\n}\n\n/**\n * Normalized response envelope. Transports may choose to use this as their\n * dispatch return type for wrappers that prefer to branch on `success`\n * rather than catch thrown errors. Our transports throw on error by default\n * (closer to idiomatic JS); wrappers can wrap calls in `tryCommand` below\n * if they want an envelope instead.\n */\nexport interface CommandResponse<T = unknown> {\n success: boolean;\n result?: T;\n error?: { code: string; message: string; retryable?: boolean };\n}\n\n/**\n * Contract every transport implements.\n *\n * `dispatch` resolves with the handler's return value on success, or throws\n * a `WrapperTransportError` on failure. Status transitions are observable\n * via `onStatusChange`.\n */\nexport interface WrapperTransport {\n readonly kind: WrapperTransportKind;\n readonly status: WrapperTransportStatus;\n\n /**\n * The handler registry the transport dispatches through. Wrapper code\n * registers action handlers here during setup:\n *\n * transport.handlerRegistry.register(\"list-unread\", async (params, ctx) => {...});\n *\n * Equivalent to calling `transport.register(actionId, fn)` directly.\n */\n readonly handlerRegistry: HandlerRegistry;\n\n /** Convenience — delegates to `handlerRegistry.register`. */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void;\n\n /** Complete any async setup (browser launch, websocket handshake). */\n ready(): Promise<void>;\n\n /** Invoke a registered action by id. */\n dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult>;\n\n /** Tear everything down. Safe to call multiple times. */\n close(): Promise<void>;\n\n /**\n * Subscribe to status transitions. Returns an unsubscribe function that\n * consumers must call on unmount / shutdown.\n */\n onStatusChange(listener: (s: WrapperTransportStatus) => void): () => void;\n}\n\n/**\n * Structured error emitted by transport dispatch. Concrete transports\n * throw these so callers can introspect `code` / `retryable` without\n * string-matching error messages.\n */\nexport class WrapperTransportError extends Error {\n readonly code: string;\n readonly retryable: boolean;\n readonly cause?: unknown;\n /**\n * Optional structured diagnostic payload (error-code-specific shape) so\n * programmatic callers can branch on data instead of parsing the message —\n * e.g. `INJECTED_EXPECT_SELECTOR_UNMET` attaches\n * `{ registeredElements, elementCount }`.\n */\n readonly details?: unknown;\n\n constructor(\n code: string,\n message: string,\n options: { retryable?: boolean; cause?: unknown; details?: unknown } = {}\n ) {\n super(message);\n this.name = 'WrapperTransportError';\n this.code = code;\n this.retryable = options.retryable ?? false;\n if (options.cause !== undefined) {\n this.cause = options.cause;\n }\n if (options.details !== undefined) {\n this.details = options.details;\n }\n }\n}\n","/**\n * HandlerRegistry\n *\n * Shared by every concrete transport. The transport's `dispatch` method\n * looks up a handler by `actionId`, invokes it with `(params, ctx)`, and\n * awaits the (possibly async) result.\n *\n * The registry deliberately knows nothing about the transport — transports\n * build their own `ctx` object (e.g. `{ page }` for headless, `{ send }` for\n * live) and hand it to the handler. This keeps action code transport-aware\n * only when it explicitly reads `ctx`, and transport-agnostic otherwise.\n */\n\nimport { WrapperTransportError } from './types.js';\n\n/** Generic async handler signature used by every transport. */\nexport type WrapperHandler<TParams = unknown, TResult = unknown, TCtx = unknown> = (\n params: TParams | undefined,\n ctx: TCtx\n) => TResult | Promise<TResult>;\n\n/**\n * Map of `actionId` -> handler. Consumers register handlers during wrapper\n * setup, before the transport starts accepting dispatches.\n */\nexport class HandlerRegistry {\n private readonly handlers = new Map<string, WrapperHandler>();\n\n /**\n * Register (or replace) a handler for `actionId`. Replacement is explicit\n * rather than throwing because live reloading / hot module scenarios need\n * to update handlers without tearing the whole transport down.\n */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void {\n this.handlers.set(actionId, fn as WrapperHandler);\n }\n\n /** Remove a handler. Returns `true` if a handler was removed. */\n unregister(actionId: string): boolean {\n return this.handlers.delete(actionId);\n }\n\n /** All registered action ids. Stable iteration order (insertion order). */\n list(): string[] {\n return Array.from(this.handlers.keys());\n }\n\n /** Check whether a handler is registered for `actionId`. */\n has(actionId: string): boolean {\n return this.handlers.has(actionId);\n }\n\n /**\n * Invoke the handler registered under `actionId`.\n *\n * Throws `WrapperTransportError(\"NO_HANDLER\")` if no handler is registered.\n * Propagates handler errors wrapped as `WrapperTransportError(\"HANDLER_ERROR\")`\n * so callers can uniformly check `err.code`.\n */\n async dispatch<TResult = unknown>(\n actionId: string,\n params?: unknown,\n ctx?: unknown\n ): Promise<TResult> {\n const handler = this.handlers.get(actionId);\n if (!handler) {\n throw new WrapperTransportError(\n 'NO_HANDLER',\n `No handler registered for action '${actionId}'`\n );\n }\n try {\n const result = await handler(params, ctx);\n return result as TResult;\n } catch (err) {\n if (err instanceof WrapperTransportError) throw err;\n const message = err instanceof Error ? err.message : String(err);\n throw new WrapperTransportError('HANDLER_ERROR', message, { cause: err });\n }\n }\n}\n","/**\n * BaseTransport\n *\n * Abstract base class for every transport. Owns the shared `HandlerRegistry`\n * plus a small status + listener state machine. Subclasses implement:\n *\n * - `kind` — static identifier\n * - `onReady()` — async setup (browser launch, ws handshake...)\n * - `onClose()` — async teardown\n * - `buildContext(actionId, params)` — per-dispatch context passed to the\n * registered handler (e.g. `{ page }`)\n *\n * `dispatch` is final; it coordinates `ready()` gating, then routes through\n * the registry. Subclasses that need to marshal dispatches over the wire\n * (like `LiveSessionTransport`) can override `dispatch` directly.\n */\n\nimport { HandlerRegistry, type WrapperHandler } from './handler-registry.js';\nimport type { WrapperTransport, WrapperTransportKind, WrapperTransportStatus } from './types.js';\nimport { WrapperTransportError } from './types.js';\n\nexport abstract class BaseTransport implements WrapperTransport {\n abstract readonly kind: WrapperTransportKind;\n\n protected _status: WrapperTransportStatus = 'idle';\n protected readonly listeners = new Set<(s: WrapperTransportStatus) => void>();\n protected readonly registry: HandlerRegistry;\n private readyPromise: Promise<void> | null = null;\n\n constructor(registry?: HandlerRegistry) {\n this.registry = registry ?? new HandlerRegistry();\n }\n\n get status(): WrapperTransportStatus {\n return this._status;\n }\n\n /** Expose the underlying registry so wrappers can register handlers. */\n get handlerRegistry(): HandlerRegistry {\n return this.registry;\n }\n\n /** Convenience: register a handler on the transport's registry. */\n register<TParams = unknown, TResult = unknown, TCtx = unknown>(\n actionId: string,\n fn: WrapperHandler<TParams, TResult, TCtx>\n ): void {\n this.registry.register(actionId, fn);\n }\n\n /**\n * Idempotent async setup. First call runs `onReady()`; subsequent calls\n * share the same promise until it settles, after which further calls\n * are no-ops if `status === 'ready'`, or re-run setup if it errored.\n */\n async ready(): Promise<void> {\n if (this._status === 'ready') return;\n if (this._status === 'closed') {\n throw new WrapperTransportError('TRANSPORT_CLOSED', `Transport '${this.kind}' is closed`);\n }\n if (this.readyPromise) return this.readyPromise;\n\n this.setStatus('connecting');\n this.readyPromise = this.onReady()\n .then(() => {\n this.setStatus('ready');\n })\n .catch((err: unknown) => {\n this.setStatus('error');\n this.readyPromise = null;\n throw err;\n });\n return this.readyPromise;\n }\n\n /** Default dispatch — waits for ready, builds ctx, delegates to registry. */\n async dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult> {\n await this.ready();\n const ctx = await this.buildContext(actionId, params);\n return this.registry.dispatch<TResult>(actionId, params, ctx);\n }\n\n async close(): Promise<void> {\n if (this._status === 'closed') return;\n try {\n await this.onClose();\n } finally {\n this.setStatus('closed');\n this.listeners.clear();\n this.readyPromise = null;\n }\n }\n\n onStatusChange(listener: (s: WrapperTransportStatus) => void): () => void {\n this.listeners.add(listener);\n return () => {\n this.listeners.delete(listener);\n };\n }\n\n /** Update status and notify listeners. Safe to call from subclasses. */\n protected setStatus(next: WrapperTransportStatus): void {\n if (this._status === next) return;\n this._status = next;\n for (const l of this.listeners) {\n try {\n l(next);\n } catch {\n // Listener errors must not affect transport state.\n }\n }\n }\n\n /** Subclass hook: perform async setup. */\n protected abstract onReady(): Promise<void>;\n\n /** Subclass hook: tear down async resources. */\n protected abstract onClose(): Promise<void>;\n\n /**\n * Subclass hook: build the context object passed to handlers. Default is\n * `undefined` (api transport). Headless/headed override to provide the\n * Playwright `page`; live overrides to provide a response helper.\n */\n protected async buildContext(_actionId: string, _params: unknown): Promise<unknown> {\n return undefined;\n }\n}\n","/**\n * The page-side frame helpers: what a capture reads off a Playwright-like page\n * and off the PNG it returns. NODE-FREE by contract — no Node builtin, no\n * `Buffer`, no `process` — because the browser-safe `./live` entry imports it\n * (through `screenshot-capture.ts`). `frame-capture.ts` re-exports all of it.\n */\n\n/** The `prefers-color-scheme` a page rendered in. */\nexport type FrameColorScheme = 'dark' | 'light';\n\n/** What the page says about how it is being rendered. */\nexport interface PageMetrics {\n devicePixelRatio: number;\n innerWidth: number;\n innerHeight: number;\n colorScheme: FrameColorScheme;\n}\n\n/** The slice of a Playwright `Page` frame capture needs. */\nexport interface FramePage {\n evaluate<R>(fn: () => R | Promise<R>): Promise<R>;\n screenshot(options: { type: 'png'; scale: 'device'; fullPage: false }): Promise<Uint8Array>;\n}\n\nconst PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\n\n/**\n * Width and height from a PNG's IHDR chunk. Throws on anything that is not a\n * PNG with an IHDR first — a frame whose size cannot be read cannot be mapped.\n */\nexport function pngDimensions(buf: Uint8Array): { width: number; height: number } {\n if (buf.length < 24 || PNG_SIGNATURE.some((b, i) => buf[i] !== b)) {\n throw new Error('not a PNG (signature mismatch or truncated header)');\n }\n const chunkType = String.fromCharCode(buf[12]!, buf[13]!, buf[14]!, buf[15]!);\n if (chunkType !== 'IHDR') {\n throw new Error(`PNG does not start with an IHDR chunk (found ${JSON.stringify(chunkType)})`);\n }\n const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/** Read the page's own rendering metrics — never the flags that requested them. */\nexport async function readPageMetrics(page: Pick<FramePage, 'evaluate'>): Promise<PageMetrics> {\n return page.evaluate(() => ({\n devicePixelRatio: window.devicePixelRatio,\n innerWidth: window.innerWidth,\n innerHeight: window.innerHeight,\n colorScheme: (window.matchMedia('(prefers-color-scheme: dark)').matches\n ? 'dark'\n : 'light') as FrameColorScheme,\n }));\n}\n","/**\n * `getScreenshot` over a transport. NODE-FREE by contract (no Node builtin,\n * no `Buffer`, no `process`): the browser-safe `./live` entry exports it, and\n * the live transport imports it. `frame-capture.ts` re-exports all of it.\n */\n\nimport { WrapperTransportError } from './types.js';\nimport { pngDimensions, readPageMetrics, type FramePage, type PageMetrics } from './frame-page.js';\n\n/**\n * ---------------------------------------------------------------------------\n * `getScreenshot` over a transport (plan\n * 2026-11-21-vision-capture-cannot-frame-a-websocket-transport-app, Phase 3)\n * ---------------------------------------------------------------------------\n *\n * The runner's vision routes capture a WebSocket-transport app by relaying\n * {@link SCREENSHOT_ACTION} over the app's socket, and only to an app whose\n * register frame advertises {@link SCREENSHOT_CAPABILITY}. The client takes\n * the frame with the page handle it owns: the runner holds none.\n *\n * The reply is the React Native HTTP provider's body shape,\n * `{ screenshot: <base64 png>, width: <CSS px>, height: <CSS px> }`\n * (`ui-bridge-native/src/server/http-server.ts`), so the runner decodes both\n * with one decoder (`frame_from_screenshot_json`).\n */\n\n/**\n * The capability string a client advertises when it answers\n * {@link SCREENSHOT_ACTION}. The runner refuses a WebSocket capture target that\n * does not advertise it (`422 FRAME_SOURCE_UNSUPPORTED`). Advertise it ONLY by\n * registering the handler — {@link registerScreenshotCapture} and\n * `LiveTransportOptions.screenshotPage` do both together, so the advertisement\n * cannot drift from the behaviour.\n */\nexport const SCREENSHOT_CAPABILITY = 'screenshot';\n\n/** The action the runner relays to capture a frame: the native handler's name. */\nexport const SCREENSHOT_ACTION = 'getScreenshot';\n\n/** The capture bound: the native provider's 10 s screenshot timeout. */\nexport const SCREENSHOT_TIMEOUT_MS = 10_000;\n\n/**\n * Chromium's refusal to screenshot a document that has no compositor frame\n * yet — CDP `Page.captureScreenshot` answering `Unable to capture screenshot`,\n * measured on frame 1 right after a reload commit. The only screenshot error\n * that is retried; every other one is final at once.\n */\nexport const NO_COMPOSITOR_FRAME = /Unable to capture screenshot/;\n\n/** The wait between attempts at a frame Chromium refused: about one 60 Hz frame. */\nexport const NO_COMPOSITOR_FRAME_RETRY_MS = 16;\n\n/** The `getScreenshot` reply body. */\nexport interface ScreenshotReply {\n /** The PNG, base64 (no data-URL prefix). */\n screenshot: string;\n /** CSS-pixel viewport width (`innerWidth`) the frame covers. */\n width: number;\n /** CSS-pixel viewport height (`innerHeight`) the frame covers. */\n height: number;\n}\n\n/** Anything a `getScreenshot` handler can be registered on (a transport or its registry). */\nexport interface ScreenshotRegistrar {\n register(actionId: string, fn: (params: unknown, ctx: unknown) => unknown): void;\n}\n\n/** Tuning for {@link registerScreenshotCapture}; the defaults are the contract. */\nexport interface ScreenshotCaptureOptions {\n /** Overall bound on one capture, retries included. Default {@link SCREENSHOT_TIMEOUT_MS}. */\n timeoutMs?: number;\n /** Wait between attempts after a no-compositor-frame refusal. Default {@link NO_COMPOSITOR_FRAME_RETRY_MS}. */\n retryMs?: number;\n}\n\n/**\n * Base64 with no Node `Buffer`: `btoa` is a global in browsers and in Node 16+\n * (this package requires Node 20), so one code path serves both. Built in\n * chunks so a multi-MB frame never spreads millions of arguments at once.\n */\nfunction toBase64(bytes: Uint8Array): string {\n const CHUNK = 0x8000;\n let binary = '';\n for (let i = 0; i < bytes.length; i += CHUNK) {\n binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));\n }\n return btoa(binary);\n}\n\nfunction errorText(err: unknown): string {\n return err instanceof Error ? err.message : String(err);\n}\n\n/**\n * Take one `getScreenshot` reply off `page`, bounded by `timeoutMs` overall.\n *\n * Errors are typed so the runner can carry the code to the caller:\n * `SCREENSHOT_TIMEOUT` (retryable) when the bound is spent, and\n * `SCREENSHOT_FAILED` for a refused or unreadable screenshot — retryable only\n * when the last refusal was Chromium's no-compositor-frame one.\n */\nexport async function captureScreenshotReply(\n page: FramePage,\n options: ScreenshotCaptureOptions = {}\n): Promise<ScreenshotReply> {\n const timeoutMs = options.timeoutMs ?? SCREENSHOT_TIMEOUT_MS;\n const retryMs = options.retryMs ?? NO_COMPOSITOR_FRAME_RETRY_MS;\n const deadline = Date.now() + timeoutMs;\n let timedOut = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n\n const attempt = async (): Promise<ScreenshotReply> => {\n let metrics: PageMetrics;\n try {\n metrics = await readPageMetrics(page);\n } catch (err) {\n throw new WrapperTransportError(\n 'SCREENSHOT_FAILED',\n `could not read the page's viewport: ${errorText(err)}`,\n { cause: err }\n );\n }\n for (;;) {\n let png: Uint8Array;\n try {\n png = await page.screenshot({ type: 'png', scale: 'device', fullPage: false });\n } catch (err) {\n const text = errorText(err);\n const noFrameYet = NO_COMPOSITOR_FRAME.test(text);\n if (noFrameYet && !timedOut && Date.now() + retryMs < deadline) {\n await new Promise((r) => setTimeout(r, retryMs));\n if (timedOut) throw err;\n continue;\n }\n throw new WrapperTransportError('SCREENSHOT_FAILED', `screenshot failed: ${text}`, {\n retryable: noFrameYet,\n cause: err,\n });\n }\n try {\n pngDimensions(png);\n } catch (err) {\n throw new WrapperTransportError(\n 'SCREENSHOT_FAILED',\n `the screenshot is unreadable: ${errorText(err)}`,\n { cause: err }\n );\n }\n return { screenshot: toBase64(png), width: metrics.innerWidth, height: metrics.innerHeight };\n }\n };\n\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(() => {\n timedOut = true;\n reject(\n new WrapperTransportError(\n 'SCREENSHOT_TIMEOUT',\n `screenshot did not complete within ${timeoutMs}ms`,\n { retryable: true }\n )\n );\n }, timeoutMs);\n });\n\n try {\n return await Promise.race([attempt(), timeout]);\n } finally {\n clearTimeout(timer);\n }\n}\n\n/**\n * Register a {@link SCREENSHOT_ACTION} handler that captures `page` — the\n * page-backed counterpart of inject-cli's `registerFrameCapture`, reusable by\n * any transport that owns a page. The caller that advertises\n * {@link SCREENSHOT_CAPABILITY} must call this (the live transport does both\n * from `LiveTransportOptions.screenshotPage`).\n */\nexport function registerScreenshotCapture(\n registrar: ScreenshotRegistrar,\n page: FramePage,\n options: ScreenshotCaptureOptions = {}\n): void {\n registrar.register(SCREENSHOT_ACTION, () => captureScreenshotReply(page, options));\n}\n","/**\n * LiveSessionTransport\n *\n * Connects to the qontinui runner's wrapper-session WebSocket endpoint,\n * registers as a wrapper instance, and translates incoming `command`\n * frames into local handler invocations. Responses flow back as\n * `response` frames matched by `commandId`.\n *\n * Frame shapes match the Phase 1 runner protocol:\n *\n * client -> server:\n * { \"type\": \"register\", \"transport\": \"websocket\",\n * \"appId\", \"appName\", \"appType\",\n * \"framework\"?, \"version\"?, \"capabilities\"?,\n * \"origin\"?, \"pageUrl\"? }\n * { \"type\": \"response\", \"commandId\", \"success\", \"result\"?, \"error\"? }\n *\n * server -> client:\n * { \"type\": \"registered\", \"appId\", \"connId\", \"acceptedAt\" }\n * { \"type\": \"command\", \"commandId\", \"action\", \"payload\"? }\n *\n * The transport also exposes `dispatch` for direct, self-issued commands —\n * useful in tests and in wrappers that want to invoke their own actions\n * without round-tripping through the runner.\n */\n\nimport { BaseTransport } from '../base-transport.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig, WrapperTransportKind } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\nimport { registerScreenshotCapture, SCREENSHOT_CAPABILITY } from '../screenshot-capture.js';\nimport type { FramePage } from '../frame-page.js';\n\n/** Options extracted from `TransportConfig.options` for the live transport. */\nexport interface LiveTransportOptions {\n /** Max time to wait for the server ack after `register`. Defaults to 10 000 ms. */\n handshakeTimeoutMs?: number;\n /** Bearer token for the `Authorization` header on the WebSocket upgrade. */\n authToken?: string;\n /**\n * App-type identifier — required by the runner's `RegisterFrame` schema\n * (`mcp/ws_relay.rs`). Common values: `\"web\"`, `\"mobile\"`, `\"native\"`,\n * `\"extension\"`, `\"wrapper\"`. Defaults to `\"wrapper\"` when not provided.\n */\n appType?: string;\n /** UI framework hint forwarded to `app_registry` (e.g. `\"react\"`, `\"vue\"`). */\n framework?: string;\n /** Wrapper version forwarded to `app_registry`. */\n version?: string;\n /**\n * Capability strings forwarded to `app_registry`. The runner reads\n * `\"screenshot\"` to decide whether it may relay `getScreenshot` to this app.\n * When this process owns a page, do not list it by hand — set\n * {@link screenshotPage}, which registers the handler and advertises the\n * capability together. The one legitimate hand-listing is a caller that\n * registers its OWN `getScreenshot` handler on the registry and has no page\n * to hand over — the browser extension's live relay, which captures through\n * `chrome.tabs.captureVisibleTab` in its service worker. Such a caller must\n * list `\"screenshot\"` only once that registration has succeeded.\n */\n capabilities?: string[];\n /**\n * A page this process owns (a Playwright `Page` satisfies it). When set, the\n * transport registers a `getScreenshot` handler that captures it (see\n * `registerScreenshotCapture` in `screenshot-capture.ts`) and appends\n * `\"screenshot\"` to the register frame's `capabilities`, so the runner's\n * vision routes can frame this app over its socket. Unset: no handler, no\n * capability, and the runner refuses this app as a capture target by name.\n */\n screenshotPage?: FramePage;\n /** Origin URL forwarded to `app_registry` (informational). */\n origin?: string;\n /** Page URL forwarded to `app_registry` (informational). */\n pageUrl?: string;\n}\n\n/** Context delivered to live-session handlers. */\nexport interface LiveContext {\n readonly kind: 'live';\n /** commandId the runner attached to this dispatch, if any. */\n readonly commandId: string | null;\n}\n\n/**\n * Minimal WebSocket contract, intersection of browser `WebSocket` and\n * `ws.WebSocket`. Keeps the transport usable in both Node and browser\n * without pulling `ws` as a hard dep.\n */\ninterface MinimalWebSocket {\n readonly readyState: number;\n send(data: string): void;\n close(code?: number, reason?: string): void;\n addEventListener(type: 'open', listener: () => void): void;\n addEventListener(type: 'close', listener: () => void): void;\n addEventListener(type: 'error', listener: (ev: unknown) => void): void;\n addEventListener(type: 'message', listener: (ev: { data: unknown }) => void): void;\n}\n\ntype WebSocketCtor = new (url: string, protocols?: string | string[]) => MinimalWebSocket;\n\ninterface RegisterFrame {\n type: 'register';\n transport: 'websocket';\n appId?: string;\n /**\n * Required by the runner's `RegisterFrame` deserializer; defaults to\n * `appId` when the caller set none (or a blank one).\n */\n appName: string;\n /**\n * Required by the runner's `RegisterFrame` deserializer; defaults to\n * `\"wrapper\"` if the caller did not configure `options.appType`.\n */\n appType: string;\n framework?: string;\n version?: string;\n capabilities?: string[];\n origin?: string;\n pageUrl?: string;\n}\n\ninterface AckFrame {\n /**\n * Two equivalent post-register acknowledgement shapes are accepted from\n * the runner: the original `{type: \"ack\", ok}` and the more descriptive\n * `{type: \"registered\", appId, connId, acceptedAt}` it actually emits\n * today. Both are treated as a successful handshake; failure is signalled\n * by either `ok: false` or a `type: \"ack\"` with an `error` payload.\n */\n type: 'ack' | 'registered';\n ok?: boolean;\n appId?: string;\n connId?: number;\n acceptedAt?: number;\n error?: { code?: string; message?: string };\n}\n\ninterface CommandFrame {\n type: 'command';\n commandId: string;\n action: string;\n payload?: unknown;\n}\n\ninterface ResponseFrame {\n type: 'response';\n commandId: string;\n success: boolean;\n result?: unknown;\n error?: { code: string; message: string; retryable?: boolean };\n}\n\ntype IncomingFrame = AckFrame | CommandFrame | { type: string; [k: string]: unknown };\n\nexport class LiveSessionTransport extends BaseTransport {\n readonly kind: WrapperTransportKind = 'live';\n\n private readonly url: string;\n private readonly appId?: string;\n private readonly appName?: string;\n private readonly opts: LiveTransportOptions;\n private readonly wsCtor: WebSocketCtor;\n\n private ws: MinimalWebSocket | null = null;\n private ackResolvers: {\n resolve: () => void;\n reject: (err: Error) => void;\n timer: ReturnType<typeof setTimeout>;\n } | null = null;\n\n constructor(\n config: TransportConfig,\n registry?: HandlerRegistry,\n injected?: { webSocketCtor?: WebSocketCtor }\n ) {\n super(registry);\n if (!config.runnerUrl) {\n throw new WrapperTransportError('INVALID_CONFIG', `Transport kind 'live' requires runnerUrl`);\n }\n // The runner's RegisterFrame requires a non-blank appId and appName\n // (qontinui-runner src-tauri/src/mcp/ws_relay.rs): a frame missing either\n // is refused and the socket closed before the ack. Refuse here, where the\n // caller can see why, rather than as DISCONNECTED \"WebSocket closed before ack\".\n if (!config.appId?.trim()) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind 'live' requires a non-blank appId (the runner refuses a register frame without one)`\n );\n }\n this.url = config.runnerUrl;\n this.appId = config.appId;\n this.appName = config.appName;\n this.opts = (config.options ?? {}) as LiveTransportOptions;\n const page = this.opts.screenshotPage;\n if (page !== undefined) {\n if (\n page === null ||\n typeof page.screenshot !== 'function' ||\n typeof page.evaluate !== 'function'\n ) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `options.screenshotPage must expose screenshot() and evaluate() (a Playwright Page does)`\n );\n }\n registerScreenshotCapture(this.registry, page);\n }\n const fromInjection = injected?.webSocketCtor;\n // Prefer the browser's global WebSocket if present; allow the caller\n // to inject a Node-side `ws` implementation.\n const fromGlobal =\n typeof (globalThis as { WebSocket?: WebSocketCtor }).WebSocket === 'function'\n ? ((globalThis as { WebSocket?: WebSocketCtor }).WebSocket as WebSocketCtor)\n : undefined;\n const resolved = fromInjection ?? fromGlobal;\n if (!resolved) {\n throw new WrapperTransportError(\n 'NO_WEBSOCKET',\n `No WebSocket constructor available. Provide one via the second constructor arg or run in an environment with global WebSocket.`\n );\n }\n this.wsCtor = resolved;\n }\n\n protected async onReady(): Promise<void> {\n const ws = new this.wsCtor(this.url);\n this.ws = ws;\n\n ws.addEventListener('message', (ev) => this.handleMessage(ev.data));\n ws.addEventListener('close', () => this.handleClose());\n ws.addEventListener('error', (ev) => this.handleError(ev));\n\n // Wait for `open`, then send `register` and wait for `ack` (or timeout).\n await new Promise<void>((resolve, reject) => {\n const onOpen = () => {\n try {\n const frame: RegisterFrame = {\n type: 'register',\n transport: 'websocket',\n appId: this.appId,\n // appName defaults to appId: the runner requires a non-blank one.\n appName: this.appName?.trim() || this.appId!,\n appType: this.opts.appType ?? 'wrapper',\n };\n if (this.opts.framework !== undefined) frame.framework = this.opts.framework;\n if (this.opts.version !== undefined) frame.version = this.opts.version;\n const capabilities = this.advertisedCapabilities();\n if (capabilities !== undefined) frame.capabilities = capabilities;\n if (this.opts.origin !== undefined) frame.origin = this.opts.origin;\n if (this.opts.pageUrl !== undefined) frame.pageUrl = this.opts.pageUrl;\n ws.send(JSON.stringify(frame));\n } catch (err) {\n reject(err instanceof Error ? err : new Error(String(err)));\n return;\n }\n const timeoutMs = this.opts.handshakeTimeoutMs ?? 10_000;\n const timer = setTimeout(() => {\n this.ackResolvers = null;\n reject(\n new WrapperTransportError(\n 'HANDSHAKE_TIMEOUT',\n `Did not receive register ack within ${timeoutMs}ms`\n )\n );\n }, timeoutMs);\n this.ackResolvers = { resolve, reject, timer };\n };\n ws.addEventListener('open', onOpen);\n });\n }\n\n protected async onClose(): Promise<void> {\n const ws = this.ws;\n this.ws = null;\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n this.ackResolvers.reject(\n new WrapperTransportError('TRANSPORT_CLOSED', 'Transport closed during handshake')\n );\n this.ackResolvers = null;\n }\n if (ws) {\n try {\n ws.close();\n } catch {\n // ignore — best-effort teardown\n }\n }\n }\n\n /**\n * The register frame's `capabilities`: the caller's list, plus\n * `\"screenshot\"` exactly when this transport registered the handler for it.\n * `undefined` (field omitted) when there is nothing to advertise.\n */\n private advertisedCapabilities(): string[] | undefined {\n const declared = this.opts.capabilities;\n if (this.opts.screenshotPage === undefined) return declared;\n const list = [...(declared ?? [])];\n if (!list.includes(SCREENSHOT_CAPABILITY)) list.push(SCREENSHOT_CAPABILITY);\n return list;\n }\n\n protected async buildContext(): Promise<LiveContext> {\n return { kind: 'live', commandId: null };\n }\n\n private handleMessage(data: unknown): void {\n let frame: IncomingFrame;\n try {\n const text = typeof data === 'string' ? data : String(data);\n frame = JSON.parse(text) as IncomingFrame;\n } catch {\n return;\n }\n\n switch (frame.type) {\n case 'ack':\n case 'registered': {\n const f = frame as AckFrame;\n if (!this.ackResolvers) return;\n clearTimeout(this.ackResolvers.timer);\n if (f.ok === false) {\n const err = new WrapperTransportError(\n f.error?.code ?? 'REGISTER_FAILED',\n f.error?.message ?? 'Runner refused registration'\n );\n this.ackResolvers.reject(err);\n } else {\n this.ackResolvers.resolve();\n }\n this.ackResolvers = null;\n return;\n }\n case 'command': {\n const f = frame as CommandFrame;\n void this.handleCommand(f);\n return;\n }\n default:\n return; // ignore unknown frames\n }\n }\n\n private async handleCommand(frame: CommandFrame): Promise<void> {\n const ctx: LiveContext = { kind: 'live', commandId: frame.commandId };\n let response: ResponseFrame;\n try {\n const result = await this.registry.dispatch(frame.action, frame.payload, ctx);\n response = {\n type: 'response',\n commandId: frame.commandId,\n success: true,\n result,\n };\n } catch (err) {\n const code = err instanceof WrapperTransportError ? err.code : 'HANDLER_ERROR';\n const retryable = err instanceof WrapperTransportError ? err.retryable : false;\n const message = err instanceof Error ? err.message : String(err);\n response = {\n type: 'response',\n commandId: frame.commandId,\n success: false,\n error: { code, message, retryable },\n };\n }\n try {\n this.ws?.send(JSON.stringify(response));\n } catch {\n // socket died mid-response; nothing to be done.\n }\n }\n\n private handleClose(): void {\n if (this._status === 'closed') return;\n this.setStatus('closed');\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n this.ackResolvers.reject(\n new WrapperTransportError('DISCONNECTED', 'WebSocket closed before ack')\n );\n this.ackResolvers = null;\n }\n }\n\n private handleError(ev: unknown): void {\n if (this.ackResolvers) {\n clearTimeout(this.ackResolvers.timer);\n const message = this.extractErrorMessage(ev);\n this.ackResolvers.reject(\n new WrapperTransportError('WEBSOCKET_ERROR', message, { retryable: true })\n );\n this.ackResolvers = null;\n } else {\n this.setStatus('error');\n }\n }\n\n private extractErrorMessage(ev: unknown): string {\n if (ev && typeof ev === 'object' && 'message' in ev) {\n const m = (ev as { message?: unknown }).message;\n if (typeof m === 'string') return m;\n }\n if (ev instanceof Error) return ev.message;\n return 'WebSocket error';\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"create-transport.d.ts","sourceRoot":"","sources":["../src/create-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CA0CzE"}
1
+ {"version":3,"file":"create-transport.d.ts","sourceRoot":"","sources":["../src/create-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CA2CzE"}
package/dist/index.cjs CHANGED
@@ -1,6 +1,6 @@
1
1
  'use strict';
2
2
 
3
- var chunkZ32CC665_cjs = require('./chunk-Z32CC665.cjs');
3
+ var chunk3EIJDQJO_cjs = require('./chunk-3EIJDQJO.cjs');
4
4
  var module$1 = require('module');
5
5
  var fs = require('fs');
6
6
  var crypto = require('crypto');
@@ -8,7 +8,7 @@ require('path');
8
8
 
9
9
  var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
10
10
  // src/transports/api.ts
11
- var ApiTransport = class extends chunkZ32CC665_cjs.BaseTransport {
11
+ var ApiTransport = class extends chunk3EIJDQJO_cjs.BaseTransport {
12
12
  kind = "api";
13
13
  fallback;
14
14
  constructor(config = { kind: "api" }, registry) {
@@ -39,17 +39,17 @@ var ApiTransport = class extends chunkZ32CC665_cjs.BaseTransport {
39
39
  try {
40
40
  return await this.fallback(actionId, params);
41
41
  } catch (err) {
42
- if (err instanceof chunkZ32CC665_cjs.WrapperTransportError) throw err;
42
+ if (err instanceof chunk3EIJDQJO_cjs.WrapperTransportError) throw err;
43
43
  const message = err instanceof Error ? err.message : String(err);
44
- throw new chunkZ32CC665_cjs.WrapperTransportError("HANDLER_ERROR", message, { cause: err });
44
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError("HANDLER_ERROR", message, { cause: err });
45
45
  }
46
46
  }
47
- throw new chunkZ32CC665_cjs.WrapperTransportError("NO_HANDLER", `No handler registered for action '${actionId}'`);
47
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError("NO_HANDLER", `No handler registered for action '${actionId}'`);
48
48
  }
49
49
  };
50
50
 
51
51
  // src/transports/headless.ts
52
- var HeadlessTransport = class extends chunkZ32CC665_cjs.BaseTransport {
52
+ var HeadlessTransport = class extends chunk3EIJDQJO_cjs.BaseTransport {
53
53
  kind;
54
54
  options;
55
55
  headless;
@@ -64,7 +64,7 @@ var HeadlessTransport = class extends chunkZ32CC665_cjs.BaseTransport {
64
64
  const raw = config.options ?? {};
65
65
  const targetUrl = raw["targetUrl"];
66
66
  if (typeof targetUrl !== "string" || targetUrl.length === 0) {
67
- throw new chunkZ32CC665_cjs.WrapperTransportError(
67
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
68
68
  "INVALID_CONFIG",
69
69
  `Transport kind '${this.kind}' requires options.targetUrl (string)`
70
70
  );
@@ -93,7 +93,7 @@ var HeadlessTransport = class extends chunkZ32CC665_cjs.BaseTransport {
93
93
  */
94
94
  parseContextOptions(raw) {
95
95
  const out = {};
96
- const invalid = (what) => new chunkZ32CC665_cjs.WrapperTransportError("INVALID_CONFIG", `Transport kind '${this.kind}': ${what}`);
96
+ const invalid = (what) => new chunk3EIJDQJO_cjs.WrapperTransportError("INVALID_CONFIG", `Transport kind '${this.kind}': ${what}`);
97
97
  const har = raw["recordHar"];
98
98
  if (har !== void 0) {
99
99
  if (typeof har !== "object" || har === null || typeof har.path !== "string" || har.path.length === 0) {
@@ -144,7 +144,7 @@ var HeadlessTransport = class extends chunkZ32CC665_cjs.BaseTransport {
144
144
  const cause = err instanceof Error ? err.message : String(err);
145
145
  const code = err?.code;
146
146
  if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
147
- throw new chunkZ32CC665_cjs.WrapperTransportError(
147
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
148
148
  "INVALID_CONFIG",
149
149
  `Transport kind '${this.kind}' needs the optional '@qontinui/ui-bridge-headless' peer, which is not installed. Install it and the Chromium browser:
150
150
  npm i @qontinui/ui-bridge-headless && npx playwright install chromium
@@ -153,7 +153,7 @@ var HeadlessTransport = class extends chunkZ32CC665_cjs.BaseTransport {
153
153
  Underlying import error: ${cause}`
154
154
  );
155
155
  }
156
- throw new chunkZ32CC665_cjs.WrapperTransportError(
156
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
157
157
  "INVALID_CONFIG",
158
158
  `'@qontinui/ui-bridge-headless' is installed but failed to load \u2014 this is a broken install (missing transitive dependency or version skew), not a missing peer. Try reinstalling it. Underlying error: ${cause}`
159
159
  );
@@ -195,7 +195,7 @@ Underlying import error: ${cause}`
195
195
  } catch (err) {
196
196
  const cause = err instanceof Error ? err.message : String(err);
197
197
  if (/Executable doesn't exist|browserType\.launch/i.test(cause)) {
198
- throw new chunkZ32CC665_cjs.WrapperTransportError(
198
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
199
199
  "INVALID_CONFIG",
200
200
  `Playwright's Chromium browser is not installed (the '@qontinui/ui-bridge-headless' peer itself loaded fine). Run:
201
201
  npx playwright install chromium
@@ -215,7 +215,7 @@ Underlying launch error: ${cause}`
215
215
  if (contextOptionsRequested && !routerCalled) {
216
216
  await this.onClose().catch(() => {
217
217
  });
218
- throw new chunkZ32CC665_cjs.WrapperTransportError(
218
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
219
219
  "CONTEXT_OPTIONS_NOT_APPLIED",
220
220
  `The installed '@qontinui/ui-bridge-headless' peer launched the tab without calling initRouter, so it predates the recordHar / recordVideo / serviceWorkers / initRouter passthrough (0.8.0, ui-bridge#381) and ignored them: no HAR or video would be written and no route installed. Upgrade it to 0.8.0 or later.`,
221
221
  {
@@ -257,7 +257,7 @@ Underlying launch error: ${cause}`
257
257
  if (problems.length === 0) return;
258
258
  await this.onClose().catch(() => {
259
259
  });
260
- throw new chunkZ32CC665_cjs.WrapperTransportError(
260
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
261
261
  "EMULATION_NOT_APPLIED",
262
262
  `The launched page reports ${problems.join(" and ")}. The installed '@qontinui/ui-bridge-headless' peer most likely predates deviceScaleFactor/colorScheme support (added after 0.5.0) and ignored them; upgrade it. A page measured at an emulation it is not actually rendering at would be stamped with the wrong values.`,
263
263
  { details: { requested: { deviceScaleFactor: wantDpr, colorScheme: wantScheme }, seen } }
@@ -301,7 +301,7 @@ Underlying launch error: ${cause}`
301
301
  }
302
302
  async buildContext() {
303
303
  if (!this.tab) {
304
- throw new chunkZ32CC665_cjs.WrapperTransportError(
304
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
305
305
  "NOT_READY",
306
306
  `Transport '${this.kind}' is not ready; call ready() before dispatch`
307
307
  );
@@ -339,7 +339,7 @@ function loadInjectedBundle() {
339
339
  try {
340
340
  cachedBundle = fs.readFileSync(bundlePath, "utf8");
341
341
  } catch (cause) {
342
- throw new chunkZ32CC665_cjs.WrapperTransportError(
342
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
343
343
  "INJECTED_BUNDLE_MISSING",
344
344
  `Could not read the UI Bridge injected runtime bundle at '${bundlePath}'. Ensure @qontinui/ui-bridge is built (the IIFE is emitted by its tsup build).`,
345
345
  { cause }
@@ -434,7 +434,7 @@ var InjectedTransport = class extends HeadlessTransport {
434
434
  { timeout: this.injected.readyTimeoutMs }
435
435
  );
436
436
  } catch (cause) {
437
- throw new chunkZ32CC665_cjs.WrapperTransportError(
437
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
438
438
  "INJECTED_RUNTIME_NOT_READY",
439
439
  `The injected UI Bridge runtime did not report ready within ${this.injected.readyTimeoutMs}ms. The bundle may have failed to evaluate (check page console / CSP) or the page never reached DOMContentLoaded.`,
440
440
  { cause, retryable: true }
@@ -458,7 +458,7 @@ var InjectedTransport = class extends HeadlessTransport {
458
458
  };
459
459
  });
460
460
  } catch (cause) {
461
- throw new chunkZ32CC665_cjs.WrapperTransportError(
461
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
462
462
  "INJECTED_RUNTIME_NOT_SETTLED",
463
463
  `The injected UI Bridge runtime did not report settled within ${this.injected.readyTimeoutMs}ms. The page kept mutating past its settle cap, or the realm was torn down. Pass options.waitForSettle=false to gate on ready only, or raise options.settleTimeoutMs / readyTimeoutMs.`,
464
464
  { cause, retryable: true }
@@ -469,12 +469,12 @@ var InjectedTransport = class extends HeadlessTransport {
469
469
  const baseMessage = sel ? `The injected runtime settled at its cap without the expected control (selector '${sel}') appearing \u2014 ${state.elementCount} element(s) were registered, but none matched. The control may mount slower than the settle cap (raise options.settleTimeoutMs), the selector may be wrong, or the inject failed. Treat as BLOCKED/UNVERIFIED, not a clean page.` : `The injected runtime settled at its cap with an empty registry (0 elements). The page never rendered interactive content within the settle cap, or the inject failed. Raise options.settleTimeoutMs for a slow page; otherwise treat as BLOCKED/UNVERIFIED.`;
470
470
  const digest = await this.registeredElementDigest(page);
471
471
  if (digest === null) {
472
- throw new chunkZ32CC665_cjs.WrapperTransportError("INJECTED_EXPECT_SELECTOR_UNMET", baseMessage, {
472
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError("INJECTED_EXPECT_SELECTOR_UNMET", baseMessage, {
473
473
  retryable: true
474
474
  });
475
475
  }
476
476
  const summary = digest.length > 0 ? ` Registered: ${digest.map((el) => el.role ? `${el.id} (${el.role})` : el.id).join(", ")}${state.elementCount > digest.length ? ", \u2026" : ""}` : "";
477
- throw new chunkZ32CC665_cjs.WrapperTransportError(
477
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
478
478
  "INJECTED_EXPECT_SELECTOR_UNMET",
479
479
  `${baseMessage}${summary}`,
480
480
  {
@@ -531,7 +531,7 @@ var InjectedTransport = class extends HeadlessTransport {
531
531
  }
532
532
  async buildContext() {
533
533
  if (!this.tab) {
534
- throw new chunkZ32CC665_cjs.WrapperTransportError(
534
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError(
535
535
  "NOT_READY",
536
536
  `Transport 'injected' is not ready; call ready() before dispatch`
537
537
  );
@@ -602,11 +602,11 @@ function createTransport(config) {
602
602
  case "live": {
603
603
  const opts = config.options ?? {};
604
604
  const injected = typeof opts.webSocketCtor === "function" ? { webSocketCtor: opts.webSocketCtor } : void 0;
605
- return new chunkZ32CC665_cjs.LiveSessionTransport(config, void 0, injected);
605
+ return new chunk3EIJDQJO_cjs.LiveSessionTransport(config, void 0, injected);
606
606
  }
607
607
  default: {
608
608
  const kind = config.kind ?? "<missing>";
609
- throw new chunkZ32CC665_cjs.WrapperTransportError("UNKNOWN_TRANSPORT", `Unknown transport kind '${kind}'`);
609
+ throw new chunk3EIJDQJO_cjs.WrapperTransportError("UNKNOWN_TRANSPORT", `Unknown transport kind '${kind}'`);
610
610
  }
611
611
  }
612
612
  }
@@ -614,7 +614,7 @@ function createTransport(config) {
614
614
  // src/helpers/retry.ts
615
615
  var defaultSleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
616
616
  var defaultShouldRetry = (err) => {
617
- if (err instanceof chunkZ32CC665_cjs.WrapperTransportError) {
617
+ if (err instanceof chunk3EIJDQJO_cjs.WrapperTransportError) {
618
618
  return err.retryable;
619
619
  }
620
620
  return true;
@@ -643,7 +643,7 @@ async function withRetry(fn, opts = {}) {
643
643
 
644
644
  // src/helpers/auth.ts
645
645
  var defaultIsAuthError = (err) => {
646
- if (err instanceof chunkZ32CC665_cjs.WrapperTransportError) {
646
+ if (err instanceof chunk3EIJDQJO_cjs.WrapperTransportError) {
647
647
  return /^(AUTH|UNAUTH|401)/i.test(err.code);
648
648
  }
649
649
  const status = err?.status;
@@ -839,39 +839,39 @@ async function startDispatchServer(transport, port, logName) {
839
839
 
840
840
  Object.defineProperty(exports, "BaseTransport", {
841
841
  enumerable: true,
842
- get: function () { return chunkZ32CC665_cjs.BaseTransport; }
842
+ get: function () { return chunk3EIJDQJO_cjs.BaseTransport; }
843
843
  });
844
844
  Object.defineProperty(exports, "HandlerRegistry", {
845
845
  enumerable: true,
846
- get: function () { return chunkZ32CC665_cjs.HandlerRegistry; }
846
+ get: function () { return chunk3EIJDQJO_cjs.HandlerRegistry; }
847
847
  });
848
848
  Object.defineProperty(exports, "LiveSessionTransport", {
849
849
  enumerable: true,
850
- get: function () { return chunkZ32CC665_cjs.LiveSessionTransport; }
850
+ get: function () { return chunk3EIJDQJO_cjs.LiveSessionTransport; }
851
851
  });
852
852
  Object.defineProperty(exports, "SCREENSHOT_ACTION", {
853
853
  enumerable: true,
854
- get: function () { return chunkZ32CC665_cjs.SCREENSHOT_ACTION; }
854
+ get: function () { return chunk3EIJDQJO_cjs.SCREENSHOT_ACTION; }
855
855
  });
856
856
  Object.defineProperty(exports, "SCREENSHOT_CAPABILITY", {
857
857
  enumerable: true,
858
- get: function () { return chunkZ32CC665_cjs.SCREENSHOT_CAPABILITY; }
858
+ get: function () { return chunk3EIJDQJO_cjs.SCREENSHOT_CAPABILITY; }
859
859
  });
860
860
  Object.defineProperty(exports, "SCREENSHOT_TIMEOUT_MS", {
861
861
  enumerable: true,
862
- get: function () { return chunkZ32CC665_cjs.SCREENSHOT_TIMEOUT_MS; }
862
+ get: function () { return chunk3EIJDQJO_cjs.SCREENSHOT_TIMEOUT_MS; }
863
863
  });
864
864
  Object.defineProperty(exports, "WrapperTransportError", {
865
865
  enumerable: true,
866
- get: function () { return chunkZ32CC665_cjs.WrapperTransportError; }
866
+ get: function () { return chunk3EIJDQJO_cjs.WrapperTransportError; }
867
867
  });
868
868
  Object.defineProperty(exports, "captureScreenshotReply", {
869
869
  enumerable: true,
870
- get: function () { return chunkZ32CC665_cjs.captureScreenshotReply; }
870
+ get: function () { return chunk3EIJDQJO_cjs.captureScreenshotReply; }
871
871
  });
872
872
  Object.defineProperty(exports, "registerScreenshotCapture", {
873
873
  enumerable: true,
874
- get: function () { return chunkZ32CC665_cjs.registerScreenshotCapture; }
874
+ get: function () { return chunk3EIJDQJO_cjs.registerScreenshotCapture; }
875
875
  });
876
876
  exports.ApiTransport = ApiTransport;
877
877
  exports.HeadedTransport = HeadedTransport;