@qontinui/ui-bridge-wrapper 0.14.0 → 0.15.0

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.
@@ -0,0 +1,488 @@
1
+ 'use strict';
2
+
3
+ // src/types.ts
4
+ var WrapperTransportError = class extends Error {
5
+ code;
6
+ retryable;
7
+ cause;
8
+ /**
9
+ * Optional structured diagnostic payload (error-code-specific shape) so
10
+ * programmatic callers can branch on data instead of parsing the message —
11
+ * e.g. `INJECTED_EXPECT_SELECTOR_UNMET` attaches
12
+ * `{ registeredElements, elementCount }`.
13
+ */
14
+ details;
15
+ constructor(code, message, options = {}) {
16
+ super(message);
17
+ this.name = "WrapperTransportError";
18
+ this.code = code;
19
+ this.retryable = options.retryable ?? false;
20
+ if (options.cause !== void 0) {
21
+ this.cause = options.cause;
22
+ }
23
+ if (options.details !== void 0) {
24
+ this.details = options.details;
25
+ }
26
+ }
27
+ };
28
+
29
+ // src/handler-registry.ts
30
+ var HandlerRegistry = class {
31
+ handlers = /* @__PURE__ */ new Map();
32
+ /**
33
+ * Register (or replace) a handler for `actionId`. Replacement is explicit
34
+ * rather than throwing because live reloading / hot module scenarios need
35
+ * to update handlers without tearing the whole transport down.
36
+ */
37
+ register(actionId, fn) {
38
+ this.handlers.set(actionId, fn);
39
+ }
40
+ /** Remove a handler. Returns `true` if a handler was removed. */
41
+ unregister(actionId) {
42
+ return this.handlers.delete(actionId);
43
+ }
44
+ /** All registered action ids. Stable iteration order (insertion order). */
45
+ list() {
46
+ return Array.from(this.handlers.keys());
47
+ }
48
+ /** Check whether a handler is registered for `actionId`. */
49
+ has(actionId) {
50
+ return this.handlers.has(actionId);
51
+ }
52
+ /**
53
+ * Invoke the handler registered under `actionId`.
54
+ *
55
+ * Throws `WrapperTransportError("NO_HANDLER")` if no handler is registered.
56
+ * Propagates handler errors wrapped as `WrapperTransportError("HANDLER_ERROR")`
57
+ * so callers can uniformly check `err.code`.
58
+ */
59
+ async dispatch(actionId, params, ctx) {
60
+ const handler = this.handlers.get(actionId);
61
+ if (!handler) {
62
+ throw new WrapperTransportError(
63
+ "NO_HANDLER",
64
+ `No handler registered for action '${actionId}'`
65
+ );
66
+ }
67
+ try {
68
+ const result = await handler(params, ctx);
69
+ return result;
70
+ } catch (err) {
71
+ if (err instanceof WrapperTransportError) throw err;
72
+ const message = err instanceof Error ? err.message : String(err);
73
+ throw new WrapperTransportError("HANDLER_ERROR", message, { cause: err });
74
+ }
75
+ }
76
+ };
77
+
78
+ // src/base-transport.ts
79
+ var BaseTransport = class {
80
+ _status = "idle";
81
+ listeners = /* @__PURE__ */ new Set();
82
+ registry;
83
+ readyPromise = null;
84
+ constructor(registry) {
85
+ this.registry = registry ?? new HandlerRegistry();
86
+ }
87
+ get status() {
88
+ return this._status;
89
+ }
90
+ /** Expose the underlying registry so wrappers can register handlers. */
91
+ get handlerRegistry() {
92
+ return this.registry;
93
+ }
94
+ /** Convenience: register a handler on the transport's registry. */
95
+ register(actionId, fn) {
96
+ this.registry.register(actionId, fn);
97
+ }
98
+ /**
99
+ * Idempotent async setup. First call runs `onReady()`; subsequent calls
100
+ * share the same promise until it settles, after which further calls
101
+ * are no-ops if `status === 'ready'`, or re-run setup if it errored.
102
+ */
103
+ async ready() {
104
+ if (this._status === "ready") return;
105
+ if (this._status === "closed") {
106
+ throw new WrapperTransportError("TRANSPORT_CLOSED", `Transport '${this.kind}' is closed`);
107
+ }
108
+ if (this.readyPromise) return this.readyPromise;
109
+ this.setStatus("connecting");
110
+ this.readyPromise = this.onReady().then(() => {
111
+ this.setStatus("ready");
112
+ }).catch((err) => {
113
+ this.setStatus("error");
114
+ this.readyPromise = null;
115
+ throw err;
116
+ });
117
+ return this.readyPromise;
118
+ }
119
+ /** Default dispatch — waits for ready, builds ctx, delegates to registry. */
120
+ async dispatch(actionId, params) {
121
+ await this.ready();
122
+ const ctx = await this.buildContext(actionId, params);
123
+ return this.registry.dispatch(actionId, params, ctx);
124
+ }
125
+ async close() {
126
+ if (this._status === "closed") return;
127
+ try {
128
+ await this.onClose();
129
+ } finally {
130
+ this.setStatus("closed");
131
+ this.listeners.clear();
132
+ this.readyPromise = null;
133
+ }
134
+ }
135
+ onStatusChange(listener) {
136
+ this.listeners.add(listener);
137
+ return () => {
138
+ this.listeners.delete(listener);
139
+ };
140
+ }
141
+ /** Update status and notify listeners. Safe to call from subclasses. */
142
+ setStatus(next) {
143
+ if (this._status === next) return;
144
+ this._status = next;
145
+ for (const l of this.listeners) {
146
+ try {
147
+ l(next);
148
+ } catch {
149
+ }
150
+ }
151
+ }
152
+ /**
153
+ * Subclass hook: build the context object passed to handlers. Default is
154
+ * `undefined` (api transport). Headless/headed override to provide the
155
+ * Playwright `page`; live overrides to provide a response helper.
156
+ */
157
+ async buildContext(_actionId, _params) {
158
+ return void 0;
159
+ }
160
+ };
161
+
162
+ // src/frame-page.ts
163
+ var PNG_SIGNATURE = [137, 80, 78, 71, 13, 10, 26, 10];
164
+ function pngDimensions(buf) {
165
+ if (buf.length < 24 || PNG_SIGNATURE.some((b, i) => buf[i] !== b)) {
166
+ throw new Error("not a PNG (signature mismatch or truncated header)");
167
+ }
168
+ const chunkType = String.fromCharCode(buf[12], buf[13], buf[14], buf[15]);
169
+ if (chunkType !== "IHDR") {
170
+ throw new Error(`PNG does not start with an IHDR chunk (found ${JSON.stringify(chunkType)})`);
171
+ }
172
+ const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
173
+ return { width: view.getUint32(16), height: view.getUint32(20) };
174
+ }
175
+ async function readPageMetrics(page) {
176
+ return page.evaluate(() => ({
177
+ devicePixelRatio: window.devicePixelRatio,
178
+ innerWidth: window.innerWidth,
179
+ innerHeight: window.innerHeight,
180
+ colorScheme: window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light"
181
+ }));
182
+ }
183
+
184
+ // src/screenshot-capture.ts
185
+ var SCREENSHOT_CAPABILITY = "screenshot";
186
+ var SCREENSHOT_ACTION = "getScreenshot";
187
+ var SCREENSHOT_TIMEOUT_MS = 1e4;
188
+ var NO_COMPOSITOR_FRAME = /Unable to capture screenshot/;
189
+ var NO_COMPOSITOR_FRAME_RETRY_MS = 16;
190
+ function toBase64(bytes) {
191
+ const CHUNK = 32768;
192
+ let binary = "";
193
+ for (let i = 0; i < bytes.length; i += CHUNK) {
194
+ binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK));
195
+ }
196
+ return btoa(binary);
197
+ }
198
+ function errorText(err) {
199
+ return err instanceof Error ? err.message : String(err);
200
+ }
201
+ async function captureScreenshotReply(page, options = {}) {
202
+ const timeoutMs = options.timeoutMs ?? SCREENSHOT_TIMEOUT_MS;
203
+ const retryMs = options.retryMs ?? NO_COMPOSITOR_FRAME_RETRY_MS;
204
+ const deadline = Date.now() + timeoutMs;
205
+ let timedOut = false;
206
+ let timer;
207
+ const attempt = async () => {
208
+ let metrics;
209
+ try {
210
+ metrics = await readPageMetrics(page);
211
+ } catch (err) {
212
+ throw new WrapperTransportError(
213
+ "SCREENSHOT_FAILED",
214
+ `could not read the page's viewport: ${errorText(err)}`,
215
+ { cause: err }
216
+ );
217
+ }
218
+ for (; ; ) {
219
+ let png;
220
+ try {
221
+ png = await page.screenshot({ type: "png", scale: "device", fullPage: false });
222
+ } catch (err) {
223
+ const text = errorText(err);
224
+ const noFrameYet = NO_COMPOSITOR_FRAME.test(text);
225
+ if (noFrameYet && !timedOut && Date.now() + retryMs < deadline) {
226
+ await new Promise((r) => setTimeout(r, retryMs));
227
+ if (timedOut) throw err;
228
+ continue;
229
+ }
230
+ throw new WrapperTransportError("SCREENSHOT_FAILED", `screenshot failed: ${text}`, {
231
+ retryable: noFrameYet,
232
+ cause: err
233
+ });
234
+ }
235
+ try {
236
+ pngDimensions(png);
237
+ } catch (err) {
238
+ throw new WrapperTransportError(
239
+ "SCREENSHOT_FAILED",
240
+ `the screenshot is unreadable: ${errorText(err)}`,
241
+ { cause: err }
242
+ );
243
+ }
244
+ return { screenshot: toBase64(png), width: metrics.innerWidth, height: metrics.innerHeight };
245
+ }
246
+ };
247
+ const timeout = new Promise((_, reject) => {
248
+ timer = setTimeout(() => {
249
+ timedOut = true;
250
+ reject(
251
+ new WrapperTransportError(
252
+ "SCREENSHOT_TIMEOUT",
253
+ `screenshot did not complete within ${timeoutMs}ms`,
254
+ { retryable: true }
255
+ )
256
+ );
257
+ }, timeoutMs);
258
+ });
259
+ try {
260
+ return await Promise.race([attempt(), timeout]);
261
+ } finally {
262
+ clearTimeout(timer);
263
+ }
264
+ }
265
+ function registerScreenshotCapture(registrar, page, options = {}) {
266
+ registrar.register(SCREENSHOT_ACTION, () => captureScreenshotReply(page, options));
267
+ }
268
+
269
+ // src/transports/live.ts
270
+ var LiveSessionTransport = class extends BaseTransport {
271
+ kind = "live";
272
+ url;
273
+ appId;
274
+ appName;
275
+ opts;
276
+ wsCtor;
277
+ ws = null;
278
+ ackResolvers = null;
279
+ constructor(config, registry, injected) {
280
+ super(registry);
281
+ if (!config.runnerUrl) {
282
+ throw new WrapperTransportError("INVALID_CONFIG", `Transport kind 'live' requires runnerUrl`);
283
+ }
284
+ this.url = config.runnerUrl;
285
+ this.appId = config.appId;
286
+ this.appName = config.appName;
287
+ this.opts = config.options ?? {};
288
+ const page = this.opts.screenshotPage;
289
+ if (page !== void 0) {
290
+ if (page === null || typeof page.screenshot !== "function" || typeof page.evaluate !== "function") {
291
+ throw new WrapperTransportError(
292
+ "INVALID_CONFIG",
293
+ `options.screenshotPage must expose screenshot() and evaluate() (a Playwright Page does)`
294
+ );
295
+ }
296
+ registerScreenshotCapture(this.registry, page);
297
+ }
298
+ const fromInjection = injected?.webSocketCtor;
299
+ const fromGlobal = typeof globalThis.WebSocket === "function" ? globalThis.WebSocket : void 0;
300
+ const resolved = fromInjection ?? fromGlobal;
301
+ if (!resolved) {
302
+ throw new WrapperTransportError(
303
+ "NO_WEBSOCKET",
304
+ `No WebSocket constructor available. Provide one via the second constructor arg or run in an environment with global WebSocket.`
305
+ );
306
+ }
307
+ this.wsCtor = resolved;
308
+ }
309
+ async onReady() {
310
+ const ws = new this.wsCtor(this.url);
311
+ this.ws = ws;
312
+ ws.addEventListener("message", (ev) => this.handleMessage(ev.data));
313
+ ws.addEventListener("close", () => this.handleClose());
314
+ ws.addEventListener("error", (ev) => this.handleError(ev));
315
+ await new Promise((resolve, reject) => {
316
+ const onOpen = () => {
317
+ try {
318
+ const frame = {
319
+ type: "register",
320
+ transport: "websocket",
321
+ appId: this.appId,
322
+ appName: this.appName,
323
+ appType: this.opts.appType ?? "wrapper"
324
+ };
325
+ if (this.opts.framework !== void 0) frame.framework = this.opts.framework;
326
+ if (this.opts.version !== void 0) frame.version = this.opts.version;
327
+ const capabilities = this.advertisedCapabilities();
328
+ if (capabilities !== void 0) frame.capabilities = capabilities;
329
+ if (this.opts.origin !== void 0) frame.origin = this.opts.origin;
330
+ if (this.opts.pageUrl !== void 0) frame.pageUrl = this.opts.pageUrl;
331
+ ws.send(JSON.stringify(frame));
332
+ } catch (err) {
333
+ reject(err instanceof Error ? err : new Error(String(err)));
334
+ return;
335
+ }
336
+ const timeoutMs = this.opts.handshakeTimeoutMs ?? 1e4;
337
+ const timer = setTimeout(() => {
338
+ this.ackResolvers = null;
339
+ reject(
340
+ new WrapperTransportError(
341
+ "HANDSHAKE_TIMEOUT",
342
+ `Did not receive register ack within ${timeoutMs}ms`
343
+ )
344
+ );
345
+ }, timeoutMs);
346
+ this.ackResolvers = { resolve, reject, timer };
347
+ };
348
+ ws.addEventListener("open", onOpen);
349
+ });
350
+ }
351
+ async onClose() {
352
+ const ws = this.ws;
353
+ this.ws = null;
354
+ if (this.ackResolvers) {
355
+ clearTimeout(this.ackResolvers.timer);
356
+ this.ackResolvers.reject(
357
+ new WrapperTransportError("TRANSPORT_CLOSED", "Transport closed during handshake")
358
+ );
359
+ this.ackResolvers = null;
360
+ }
361
+ if (ws) {
362
+ try {
363
+ ws.close();
364
+ } catch {
365
+ }
366
+ }
367
+ }
368
+ /**
369
+ * The register frame's `capabilities`: the caller's list, plus
370
+ * `"screenshot"` exactly when this transport registered the handler for it.
371
+ * `undefined` (field omitted) when there is nothing to advertise.
372
+ */
373
+ advertisedCapabilities() {
374
+ const declared = this.opts.capabilities;
375
+ if (this.opts.screenshotPage === void 0) return declared;
376
+ const list = [...declared ?? []];
377
+ if (!list.includes(SCREENSHOT_CAPABILITY)) list.push(SCREENSHOT_CAPABILITY);
378
+ return list;
379
+ }
380
+ async buildContext() {
381
+ return { kind: "live", commandId: null };
382
+ }
383
+ handleMessage(data) {
384
+ let frame;
385
+ try {
386
+ const text = typeof data === "string" ? data : String(data);
387
+ frame = JSON.parse(text);
388
+ } catch {
389
+ return;
390
+ }
391
+ switch (frame.type) {
392
+ case "ack":
393
+ case "registered": {
394
+ const f = frame;
395
+ if (!this.ackResolvers) return;
396
+ clearTimeout(this.ackResolvers.timer);
397
+ if (f.ok === false) {
398
+ const err = new WrapperTransportError(
399
+ f.error?.code ?? "REGISTER_FAILED",
400
+ f.error?.message ?? "Runner refused registration"
401
+ );
402
+ this.ackResolvers.reject(err);
403
+ } else {
404
+ this.ackResolvers.resolve();
405
+ }
406
+ this.ackResolvers = null;
407
+ return;
408
+ }
409
+ case "command": {
410
+ const f = frame;
411
+ void this.handleCommand(f);
412
+ return;
413
+ }
414
+ default:
415
+ return;
416
+ }
417
+ }
418
+ async handleCommand(frame) {
419
+ const ctx = { kind: "live", commandId: frame.commandId };
420
+ let response;
421
+ try {
422
+ const result = await this.registry.dispatch(frame.action, frame.payload, ctx);
423
+ response = {
424
+ type: "response",
425
+ commandId: frame.commandId,
426
+ success: true,
427
+ result
428
+ };
429
+ } catch (err) {
430
+ const code = err instanceof WrapperTransportError ? err.code : "HANDLER_ERROR";
431
+ const retryable = err instanceof WrapperTransportError ? err.retryable : false;
432
+ const message = err instanceof Error ? err.message : String(err);
433
+ response = {
434
+ type: "response",
435
+ commandId: frame.commandId,
436
+ success: false,
437
+ error: { code, message, retryable }
438
+ };
439
+ }
440
+ try {
441
+ this.ws?.send(JSON.stringify(response));
442
+ } catch {
443
+ }
444
+ }
445
+ handleClose() {
446
+ if (this._status === "closed") return;
447
+ this.setStatus("closed");
448
+ if (this.ackResolvers) {
449
+ clearTimeout(this.ackResolvers.timer);
450
+ this.ackResolvers.reject(
451
+ new WrapperTransportError("DISCONNECTED", "WebSocket closed before ack")
452
+ );
453
+ this.ackResolvers = null;
454
+ }
455
+ }
456
+ handleError(ev) {
457
+ if (this.ackResolvers) {
458
+ clearTimeout(this.ackResolvers.timer);
459
+ const message = this.extractErrorMessage(ev);
460
+ this.ackResolvers.reject(
461
+ new WrapperTransportError("WEBSOCKET_ERROR", message, { retryable: true })
462
+ );
463
+ this.ackResolvers = null;
464
+ } else {
465
+ this.setStatus("error");
466
+ }
467
+ }
468
+ extractErrorMessage(ev) {
469
+ if (ev && typeof ev === "object" && "message" in ev) {
470
+ const m = ev.message;
471
+ if (typeof m === "string") return m;
472
+ }
473
+ if (ev instanceof Error) return ev.message;
474
+ return "WebSocket error";
475
+ }
476
+ };
477
+
478
+ exports.BaseTransport = BaseTransport;
479
+ exports.HandlerRegistry = HandlerRegistry;
480
+ exports.LiveSessionTransport = LiveSessionTransport;
481
+ exports.SCREENSHOT_ACTION = SCREENSHOT_ACTION;
482
+ exports.SCREENSHOT_CAPABILITY = SCREENSHOT_CAPABILITY;
483
+ exports.SCREENSHOT_TIMEOUT_MS = SCREENSHOT_TIMEOUT_MS;
484
+ exports.WrapperTransportError = WrapperTransportError;
485
+ exports.captureScreenshotReply = captureScreenshotReply;
486
+ exports.registerScreenshotCapture = registerScreenshotCapture;
487
+ //# sourceMappingURL=chunk-Z32CC665.cjs.map
488
+ //# sourceMappingURL=chunk-Z32CC665.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-Z32CC665.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 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 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: this.appName,\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,CA0BzE"}
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"}
@@ -27,8 +27,9 @@
27
27
  * measured exactly that for a Chromium DPR launch flag) therefore cannot be
28
28
  * stamped onto a frame as if it had.
29
29
  */
30
- /** The `prefers-color-scheme` a page rendered in. */
31
- export type FrameColorScheme = 'dark' | 'light';
30
+ import { type FrameColorScheme, type FramePage } from './frame-page.js';
31
+ export { pngDimensions, readPageMetrics, type FrameColorScheme, type FramePage, type PageMetrics, } from './frame-page.js';
32
+ export { captureScreenshotReply, NO_COMPOSITOR_FRAME, NO_COMPOSITOR_FRAME_RETRY_MS, registerScreenshotCapture, SCREENSHOT_ACTION, SCREENSHOT_CAPABILITY, SCREENSHOT_TIMEOUT_MS, type ScreenshotCaptureOptions, type ScreenshotRegistrar, type ScreenshotReply, } from './screenshot-capture.js';
32
33
  /** Whether a snapshot describes the geometry its frame shows. */
33
34
  export interface LockstepRecord {
34
35
  /**
@@ -90,22 +91,6 @@ export interface FrameError {
90
91
  code: 'FRAME_CAPTURE_FAILED' | 'FRAME_SCALE_MISMATCH';
91
92
  message: string;
92
93
  }
93
- /** What the page says about how it is being rendered. */
94
- export interface PageMetrics {
95
- devicePixelRatio: number;
96
- innerWidth: number;
97
- innerHeight: number;
98
- colorScheme: FrameColorScheme;
99
- }
100
- /** The slice of a Playwright `Page` frame capture needs. */
101
- export interface FramePage {
102
- evaluate<R>(fn: () => R | Promise<R>): Promise<R>;
103
- screenshot(options: {
104
- type: 'png';
105
- scale: 'device';
106
- fullPage: false;
107
- }): Promise<Uint8Array>;
108
- }
109
94
  /** Default number of snapshot → frame → snapshot rounds before giving up on verification. */
110
95
  export declare const DEFAULT_LOCKSTEP_ATTEMPTS = 3;
111
96
  /**
@@ -141,14 +126,6 @@ export declare function ensurePrivateDir(dir: string): void;
141
126
  * the new pixels; renaming never puts the new bytes in the old file at all.
142
127
  */
143
128
  export declare function writePrivateFile(path: string, data: string | Uint8Array): void;
144
- /**
145
- * Width and height from a PNG's IHDR chunk. Throws on anything that is not a
146
- * PNG with an IHDR first — a frame whose size cannot be read cannot be mapped.
147
- */
148
- export declare function pngDimensions(buf: Uint8Array): {
149
- width: number;
150
- height: number;
151
- };
152
129
  /**
153
130
  * Substitute `{n}` in the FILE NAME of a `--screenshot` template with the
154
131
  * action's 1-based position. A `{n}` in a directory name is left alone —
@@ -160,8 +137,6 @@ export declare function expandFramePath(template: string, position: number): str
160
137
  export declare function frameTokenInDirectory(template: string): boolean;
161
138
  /** True when the template's file name carries `{n}`, so each action gets its own file. */
162
139
  export declare function frameTokenInFileName(template: string): boolean;
163
- /** Read the page's own rendering metrics — never the flags that requested them. */
164
- export declare function readPageMetrics(page: Pick<FramePage, 'evaluate'>): Promise<PageMetrics>;
165
140
  /**
166
141
  * Each element's box and visibility, keyed by id — the part of a control
167
142
  * snapshot a bbox → pixel mapping depends on. `null` when the snapshot carries