@qontinui/ui-bridge-wrapper 0.4.0 → 0.4.2

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.
@@ -228,19 +228,53 @@ var HeadlessTransport = class extends BaseTransport {
228
228
  };
229
229
  }
230
230
  async onReady() {
231
- const { launchHeadlessTab } = await import('@qontinui/ui-bridge-headless');
231
+ let launchHeadlessTab;
232
+ try {
233
+ ({ launchHeadlessTab } = await import('@qontinui/ui-bridge-headless'));
234
+ } catch (err) {
235
+ const cause = err instanceof Error ? err.message : String(err);
236
+ const code = err?.code;
237
+ if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
238
+ throw new WrapperTransportError(
239
+ "INVALID_CONFIG",
240
+ `Transport kind '${this.kind}' needs the optional '@qontinui/ui-bridge-headless' peer, which is not installed. Install it and the Chromium browser:
241
+ npm i @qontinui/ui-bridge-headless && npx playwright install chromium
242
+ (bare \`npx @qontinui/ui-bridge-wrapper \u2026\` does NOT install peers \u2014 pass each peer with \`-p\`, e.g.
243
+ npx -y -p @qontinui/ui-bridge-wrapper -p @qontinui/ui-bridge -p @qontinui/ui-bridge-headless -p playwright ui-bridge-login-web \u2026)
244
+ Underlying import error: ${cause}`
245
+ );
246
+ }
247
+ throw new WrapperTransportError(
248
+ "INVALID_CONFIG",
249
+ `'@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}`
250
+ );
251
+ }
232
252
  const initScripts = await this.buildInitScripts();
233
- const tab = await launchHeadlessTab({
234
- url: this.options.targetUrl,
235
- headless: this.headless,
236
- uiBridgeBase: this.options.uiBridgeBase,
237
- waitForUiBridgeMs: this.options.waitForUiBridgeMs,
238
- viewportWidth: this.options.viewportWidth,
239
- viewportHeight: this.options.viewportHeight,
240
- userAgent: this.options.userAgent,
241
- forwardConsole: this.options.forwardConsole,
242
- initScripts: initScripts.length > 0 ? initScripts : void 0
243
- });
253
+ let tab;
254
+ try {
255
+ tab = await launchHeadlessTab({
256
+ url: this.options.targetUrl,
257
+ headless: this.headless,
258
+ uiBridgeBase: this.options.uiBridgeBase,
259
+ waitForUiBridgeMs: this.options.waitForUiBridgeMs,
260
+ viewportWidth: this.options.viewportWidth,
261
+ viewportHeight: this.options.viewportHeight,
262
+ userAgent: this.options.userAgent,
263
+ forwardConsole: this.options.forwardConsole,
264
+ initScripts: initScripts.length > 0 ? initScripts : void 0
265
+ });
266
+ } catch (err) {
267
+ const cause = err instanceof Error ? err.message : String(err);
268
+ if (/Executable doesn't exist|browserType\.launch/i.test(cause)) {
269
+ throw new WrapperTransportError(
270
+ "INVALID_CONFIG",
271
+ `Playwright's Chromium browser is not installed (the '@qontinui/ui-bridge-headless' peer itself loaded fine). Run:
272
+ npx playwright install chromium
273
+ Underlying launch error: ${cause}`
274
+ );
275
+ }
276
+ throw err;
277
+ }
244
278
  this.tab = {
245
279
  browser: tab.browser,
246
280
  context: tab.context,
@@ -686,6 +720,18 @@ function createTransport(config) {
686
720
  }
687
721
  }
688
722
 
723
+ // src/cli-args.ts
724
+ function isFlagShaped(value) {
725
+ return value.startsWith("--");
726
+ }
727
+ function consumeValue(flag, raw, error) {
728
+ if (raw === void 0) return null;
729
+ if (isFlagShaped(raw)) {
730
+ throw error(`${flag} expects a value but got the flag '${raw}' \u2014 did you omit ${flag}'s argument?`);
731
+ }
732
+ return raw;
733
+ }
734
+
689
735
  // src/inject-cli.ts
690
736
  var USAGE = `ui-bridge-inject \u2014 drive UI Bridge's injected transport against a UI-Bridge-free page
691
737
 
@@ -793,6 +839,7 @@ function parseArgs(argv) {
793
839
  quiet: false,
794
840
  help: false
795
841
  };
842
+ const mkError = (m) => new InjectCliArgError(m);
796
843
  for (let i = 0; i < argv.length; i++) {
797
844
  const arg = argv[i];
798
845
  switch (arg) {
@@ -809,35 +856,37 @@ function parseArgs(argv) {
809
856
  case "--exec-stdin":
810
857
  args.execStdin = true;
811
858
  break;
859
+ // String value-flags: guard each consumed value against the flag-shaped
860
+ // swallow (`--url --headed` must error, not capture `--headed` as the url).
812
861
  case "--url":
813
- args.url = argv[++i] ?? "";
862
+ args.url = consumeValue("--url", argv[++i], mkError) ?? "";
814
863
  break;
815
864
  case "--relay":
816
- args.relay = argv[++i] ?? null;
865
+ args.relay = consumeValue("--relay", argv[++i], mkError);
817
866
  break;
818
867
  case "--auth-token":
819
- args.authToken = argv[++i] ?? null;
868
+ args.authToken = consumeValue("--auth-token", argv[++i], mkError);
820
869
  break;
821
870
  case "--app-id":
822
- args.appId = argv[++i] ?? null;
871
+ args.appId = consumeValue("--app-id", argv[++i], mkError);
823
872
  break;
824
873
  case "--app-name":
825
- args.appName = argv[++i] ?? null;
874
+ args.appName = consumeValue("--app-name", argv[++i], mkError);
826
875
  break;
827
876
  case "--tab-id":
828
- args.tabId = argv[++i] ?? null;
877
+ args.tabId = consumeValue("--tab-id", argv[++i], mkError);
829
878
  break;
830
879
  case "--exec": {
831
- const raw = argv[++i];
832
- if (raw === void 0) {
880
+ const raw = consumeValue("--exec", argv[++i], mkError);
881
+ if (raw === null) {
833
882
  throw new InjectCliArgError(`--exec expects '<action> <json-payload>' (got <missing>)`);
834
883
  }
835
884
  args.execActions.push(parseExecValue(raw));
836
885
  break;
837
886
  }
838
887
  case "--registration-metadata": {
839
- const raw = argv[++i];
840
- if (raw === void 0) {
888
+ const raw = consumeValue("--registration-metadata", argv[++i], mkError);
889
+ if (raw === null) {
841
890
  throw new InjectCliArgError(
842
891
  `--registration-metadata expects JSON {"userId","sessionId"} (got <missing>)`
843
892
  );
@@ -859,8 +908,8 @@ function parseArgs(argv) {
859
908
  break;
860
909
  }
861
910
  case "--ready-timeout": {
862
- const raw = argv[++i];
863
- const n = raw === void 0 ? NaN : Number.parseInt(raw, 10);
911
+ const raw = consumeValue("--ready-timeout", argv[++i], mkError);
912
+ const n = raw === null ? NaN : Number.parseInt(raw, 10);
864
913
  if (!Number.isFinite(n) || n <= 0) {
865
914
  throw new InjectCliArgError(
866
915
  `--ready-timeout expects a positive integer (got ${raw ?? "<missing>"})`
@@ -873,8 +922,8 @@ function parseArgs(argv) {
873
922
  args.waitForSettle = false;
874
923
  break;
875
924
  case "--settle-quiet": {
876
- const raw = argv[++i];
877
- const n = raw === void 0 ? NaN : Number.parseInt(raw, 10);
925
+ const raw = consumeValue("--settle-quiet", argv[++i], mkError);
926
+ const n = raw === null ? NaN : Number.parseInt(raw, 10);
878
927
  if (!Number.isFinite(n) || n < 0) {
879
928
  throw new InjectCliArgError(
880
929
  `--settle-quiet expects a non-negative integer (got ${raw ?? "<missing>"})`
@@ -884,8 +933,8 @@ function parseArgs(argv) {
884
933
  break;
885
934
  }
886
935
  case "--settle-timeout": {
887
- const raw = argv[++i];
888
- const n = raw === void 0 ? NaN : Number.parseInt(raw, 10);
936
+ const raw = consumeValue("--settle-timeout", argv[++i], mkError);
937
+ const n = raw === null ? NaN : Number.parseInt(raw, 10);
889
938
  if (!Number.isFinite(n) || n <= 0) {
890
939
  throw new InjectCliArgError(
891
940
  `--settle-timeout expects a positive integer (got ${raw ?? "<missing>"})`
@@ -895,15 +944,15 @@ function parseArgs(argv) {
895
944
  break;
896
945
  }
897
946
  case "--expect-selector": {
898
- const raw = argv[++i];
899
- if (raw === void 0 || raw.length === 0) {
947
+ const raw = consumeValue("--expect-selector", argv[++i], mkError);
948
+ if (raw === null || raw.length === 0) {
900
949
  throw new InjectCliArgError(`--expect-selector expects a CSS selector (got <missing>)`);
901
950
  }
902
951
  args.expectSelector = raw;
903
952
  break;
904
953
  }
905
954
  case "--viewport": {
906
- const raw = argv[++i];
955
+ const raw = consumeValue("--viewport", argv[++i], mkError);
907
956
  const match = raw?.match(/^(\d+)x(\d+)$/);
908
957
  if (!match) {
909
958
  throw new InjectCliArgError(`--viewport expects WxH (got ${raw ?? "<missing>"})`);