@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,82 @@
1
+ /**
2
+ * `getScreenshot` over a transport. NODE-FREE by contract (no Node builtin,
3
+ * no `Buffer`, no `process`): the browser-safe `./live` entry exports it, and
4
+ * the live transport imports it. `frame-capture.ts` re-exports all of it.
5
+ */
6
+ import { type FramePage } from './frame-page.js';
7
+ /**
8
+ * ---------------------------------------------------------------------------
9
+ * `getScreenshot` over a transport (plan
10
+ * 2026-11-21-vision-capture-cannot-frame-a-websocket-transport-app, Phase 3)
11
+ * ---------------------------------------------------------------------------
12
+ *
13
+ * The runner's vision routes capture a WebSocket-transport app by relaying
14
+ * {@link SCREENSHOT_ACTION} over the app's socket, and only to an app whose
15
+ * register frame advertises {@link SCREENSHOT_CAPABILITY}. The client takes
16
+ * the frame with the page handle it owns: the runner holds none.
17
+ *
18
+ * The reply is the React Native HTTP provider's body shape,
19
+ * `{ screenshot: <base64 png>, width: <CSS px>, height: <CSS px> }`
20
+ * (`ui-bridge-native/src/server/http-server.ts`), so the runner decodes both
21
+ * with one decoder (`frame_from_screenshot_json`).
22
+ */
23
+ /**
24
+ * The capability string a client advertises when it answers
25
+ * {@link SCREENSHOT_ACTION}. The runner refuses a WebSocket capture target that
26
+ * does not advertise it (`422 FRAME_SOURCE_UNSUPPORTED`). Advertise it ONLY by
27
+ * registering the handler — {@link registerScreenshotCapture} and
28
+ * `LiveTransportOptions.screenshotPage` do both together, so the advertisement
29
+ * cannot drift from the behaviour.
30
+ */
31
+ export declare const SCREENSHOT_CAPABILITY = "screenshot";
32
+ /** The action the runner relays to capture a frame: the native handler's name. */
33
+ export declare const SCREENSHOT_ACTION = "getScreenshot";
34
+ /** The capture bound: the native provider's 10 s screenshot timeout. */
35
+ export declare const SCREENSHOT_TIMEOUT_MS = 10000;
36
+ /**
37
+ * Chromium's refusal to screenshot a document that has no compositor frame
38
+ * yet — CDP `Page.captureScreenshot` answering `Unable to capture screenshot`,
39
+ * measured on frame 1 right after a reload commit. The only screenshot error
40
+ * that is retried; every other one is final at once.
41
+ */
42
+ export declare const NO_COMPOSITOR_FRAME: RegExp;
43
+ /** The wait between attempts at a frame Chromium refused: about one 60 Hz frame. */
44
+ export declare const NO_COMPOSITOR_FRAME_RETRY_MS = 16;
45
+ /** The `getScreenshot` reply body. */
46
+ export interface ScreenshotReply {
47
+ /** The PNG, base64 (no data-URL prefix). */
48
+ screenshot: string;
49
+ /** CSS-pixel viewport width (`innerWidth`) the frame covers. */
50
+ width: number;
51
+ /** CSS-pixel viewport height (`innerHeight`) the frame covers. */
52
+ height: number;
53
+ }
54
+ /** Anything a `getScreenshot` handler can be registered on (a transport or its registry). */
55
+ export interface ScreenshotRegistrar {
56
+ register(actionId: string, fn: (params: unknown, ctx: unknown) => unknown): void;
57
+ }
58
+ /** Tuning for {@link registerScreenshotCapture}; the defaults are the contract. */
59
+ export interface ScreenshotCaptureOptions {
60
+ /** Overall bound on one capture, retries included. Default {@link SCREENSHOT_TIMEOUT_MS}. */
61
+ timeoutMs?: number;
62
+ /** Wait between attempts after a no-compositor-frame refusal. Default {@link NO_COMPOSITOR_FRAME_RETRY_MS}. */
63
+ retryMs?: number;
64
+ }
65
+ /**
66
+ * Take one `getScreenshot` reply off `page`, bounded by `timeoutMs` overall.
67
+ *
68
+ * Errors are typed so the runner can carry the code to the caller:
69
+ * `SCREENSHOT_TIMEOUT` (retryable) when the bound is spent, and
70
+ * `SCREENSHOT_FAILED` for a refused or unreadable screenshot — retryable only
71
+ * when the last refusal was Chromium's no-compositor-frame one.
72
+ */
73
+ export declare function captureScreenshotReply(page: FramePage, options?: ScreenshotCaptureOptions): Promise<ScreenshotReply>;
74
+ /**
75
+ * Register a {@link SCREENSHOT_ACTION} handler that captures `page` — the
76
+ * page-backed counterpart of inject-cli's `registerFrameCapture`, reusable by
77
+ * any transport that owns a page. The caller that advertises
78
+ * {@link SCREENSHOT_CAPABILITY} must call this (the live transport does both
79
+ * from `LiveTransportOptions.screenshotPage`).
80
+ */
81
+ export declare function registerScreenshotCapture(registrar: ScreenshotRegistrar, page: FramePage, options?: ScreenshotCaptureOptions): void;
82
+ //# sourceMappingURL=screenshot-capture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"screenshot-capture.d.ts","sourceRoot":"","sources":["../src/screenshot-capture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAkC,KAAK,SAAS,EAAoB,MAAM,iBAAiB,CAAC;AAEnG;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAiC,CAAC;AAElE,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAC;CAClF;AAED,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoBD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAkE1B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAEN"}
@@ -45,21 +45,19 @@
45
45
  * and makes the action answer `success: false` (exit 1), never a gap silently
46
46
  * closed up.
47
47
  */
48
- import { type FrameColorScheme, type FramePage } from './frame-capture.js';
48
+ import { NO_COMPOSITOR_FRAME, NO_COMPOSITOR_FRAME_RETRY_MS, type FrameColorScheme, type FramePage } from './frame-capture.js';
49
49
  /** The CLI-side action id. No in-page action is named this. */
50
50
  export declare const CAPTURE_TIMELINE_ACTION = "captureTimeline";
51
51
  export declare const MAX_TIMELINE_FRAMES = 120;
52
52
  export declare const MAX_TIMELINE_INTERVAL_MS = 10000;
53
53
  export declare const DEFAULT_TIMELINE_READY_TIMEOUT_MS = 30000;
54
54
  /**
55
- * Chromium's refusal to screenshot a document that has no compositor frame
56
- * yet — CDP `Page.captureScreenshot` answering `Unable to capture screenshot`,
57
- * measured on frame 1 right after a reload commit. The ONLY screenshot error
58
- * {@link takeFrameByDeadline} retries; every other one is final at once.
55
+ * Chromium's no-compositor-frame refusal and its retry wait now live beside
56
+ * the other frame helpers, so the `getScreenshot` handler retries the same
57
+ * one error. The ONLY screenshot error {@link takeFrameByDeadline} retries;
58
+ * every other one is final at once.
59
59
  */
60
- export declare const NO_COMPOSITOR_FRAME: RegExp;
61
- /** The wait between attempts at a frame Chromium refused: about one 60 Hz frame. */
62
- export declare const NO_COMPOSITOR_FRAME_RETRY_MS = 16;
60
+ export { NO_COMPOSITOR_FRAME, NO_COMPOSITOR_FRAME_RETRY_MS };
63
61
  /**
64
62
  * The most sleeps one frame's wait for its due time may take: one for the
65
63
  * wait, two more for timers that fire a millisecond early. A constant, so the
@@ -1 +1 @@
1
- {"version":3,"file":"timeline-capture.d.ts","sourceRoot":"","sources":["../src/timeline-capture.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"timeline-capture.d.ts","sourceRoot":"","sources":["../src/timeline-capture.ts"],"names":[],"mappings":"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"}
@@ -26,6 +26,7 @@
26
26
  import { BaseTransport } from '../base-transport.js';
27
27
  import { HandlerRegistry } from '../handler-registry.js';
28
28
  import type { TransportConfig, WrapperTransportKind } from '../types.js';
29
+ import type { FramePage } from '../frame-page.js';
29
30
  /** Options extracted from `TransportConfig.options` for the live transport. */
30
31
  export interface LiveTransportOptions {
31
32
  /** Max time to wait for the server ack after `register`. Defaults to 10 000 ms. */
@@ -42,8 +43,27 @@ export interface LiveTransportOptions {
42
43
  framework?: string;
43
44
  /** Wrapper version forwarded to `app_registry`. */
44
45
  version?: string;
45
- /** Capability strings forwarded to `app_registry` (informational). */
46
+ /**
47
+ * Capability strings forwarded to `app_registry`. The runner reads
48
+ * `"screenshot"` to decide whether it may relay `getScreenshot` to this app.
49
+ * When this process owns a page, do not list it by hand — set
50
+ * {@link screenshotPage}, which registers the handler and advertises the
51
+ * capability together. The one legitimate hand-listing is a caller that
52
+ * registers its OWN `getScreenshot` handler on the registry and has no page
53
+ * to hand over — the browser extension's live relay, which captures through
54
+ * `chrome.tabs.captureVisibleTab` in its service worker. Such a caller must
55
+ * list `"screenshot"` only once that registration has succeeded.
56
+ */
46
57
  capabilities?: string[];
58
+ /**
59
+ * A page this process owns (a Playwright `Page` satisfies it). When set, the
60
+ * transport registers a `getScreenshot` handler that captures it (see
61
+ * `registerScreenshotCapture` in `screenshot-capture.ts`) and appends
62
+ * `"screenshot"` to the register frame's `capabilities`, so the runner's
63
+ * vision routes can frame this app over its socket. Unset: no handler, no
64
+ * capability, and the runner refuses this app as a capture target by name.
65
+ */
66
+ screenshotPage?: FramePage;
47
67
  /** Origin URL forwarded to `app_registry` (informational). */
48
68
  origin?: string;
49
69
  /** Page URL forwarded to `app_registry` (informational). */
@@ -86,6 +106,12 @@ export declare class LiveSessionTransport extends BaseTransport {
86
106
  });
87
107
  protected onReady(): Promise<void>;
88
108
  protected onClose(): Promise<void>;
109
+ /**
110
+ * The register frame's `capabilities`: the caller's list, plus
111
+ * `"screenshot"` exactly when this transport registered the handler for it.
112
+ * `undefined` (field omitted) when there is nothing to advertise.
113
+ */
114
+ private advertisedCapabilities;
89
115
  protected buildContext(): Promise<LiveContext>;
90
116
  private handleMessage;
91
117
  private handleCommand;
@@ -1 +1 @@
1
- {"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/transports/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGzE,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,UAAU,gBAAgB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,KAAK,aAAa,GAAG,KAAK,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,gBAAgB,CAAC;AAoD1F,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,YAAY,CAIJ;gBAGd,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,eAAe,EAC1B,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,aAAa,CAAA;KAAE;cA2B9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cA6CxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cAmBxB,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAIpD,OAAO,CAAC,aAAa;YAqCP,aAAa;IA6B3B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,mBAAmB;CAQ5B"}
1
+ {"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/transports/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;GAIG;AACH,UAAU,gBAAgB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC3D,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AAED,KAAK,aAAa,GAAG,KAAK,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,gBAAgB,CAAC;AAoD1F,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,YAAY,CAIJ;gBAGd,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,eAAe,EAC1B,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,aAAa,CAAA;KAAE;cAyC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;cA8CxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;cAQd,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAIpD,OAAO,CAAC,aAAa;YAqCP,aAAa;IA6B3B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,mBAAmB;CAQ5B"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qontinui/ui-bridge-wrapper",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "description": "Runtime for building UI Bridge wrapper apps — transport-agnostic semantic actions.",
5
5
  "main": "./dist/index.cjs",
6
6
  "module": "./dist/index.js",
@@ -12,6 +12,11 @@
12
12
  "import": "./dist/index.js",
13
13
  "require": "./dist/index.cjs"
14
14
  },
15
+ "./live": {
16
+ "types": "./dist/live/index.d.ts",
17
+ "import": "./dist/live/index.js",
18
+ "require": "./dist/live/index.cjs"
19
+ },
15
20
  "./react": {
16
21
  "types": "./dist/react/index.d.ts",
17
22
  "import": "./dist/react/index.js",
@@ -28,8 +33,8 @@
28
33
  "README.md"
29
34
  ],
30
35
  "scripts": {
31
- "build": "tsup && tsc -p tsconfig.build.json",
32
- "dev": "tsup --watch",
36
+ "build": "rimraf dist && tsup && tsc -p tsconfig.build.json",
37
+ "dev": "rimraf dist && tsup --watch",
33
38
  "typecheck": "tsc --noEmit && tsc -p tsconfig.vitest.json",
34
39
  "test": "vitest run",
35
40
  "test:smoke": "vitest run smoke --reporter=default --reporter=json --outputFile.json=.smoke-report.json && node ../../test-support/assert-no-skipped-tests.mjs .smoke-report.json",