@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.
- package/README.md +55 -1
- package/dist/capture-specs-cli.cjs +249 -119
- package/dist/capture-specs-cli.cjs.map +1 -1
- package/dist/capture-specs-cli.d.ts +3 -17
- package/dist/capture-specs-cli.d.ts.map +1 -1
- package/dist/cli-args.d.ts +75 -0
- package/dist/cli-args.d.ts.map +1 -0
- package/dist/index.cjs +46 -12
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +46 -12
- package/dist/index.js.map +1 -1
- package/dist/inject-cli.cjs +80 -31
- package/dist/inject-cli.cjs.map +1 -1
- package/dist/inject-cli.d.ts.map +1 -1
- package/dist/login-drive.d.ts +71 -0
- package/dist/login-drive.d.ts.map +1 -0
- package/dist/login-web-cli.cjs +306 -140
- package/dist/login-web-cli.cjs.map +1 -1
- package/dist/login-web-cli.d.ts +15 -21
- package/dist/login-web-cli.d.ts.map +1 -1
- package/dist/react/index.cjs +4 -4
- package/dist/react/index.cjs.map +1 -1
- package/dist/react/index.js +4 -4
- package/dist/react/index.js.map +1 -1
- package/dist/transports/headless.d.ts.map +1 -1
- package/package.json +1 -1
package/dist/inject-cli.cjs
CHANGED
|
@@ -228,19 +228,53 @@ var HeadlessTransport = class extends BaseTransport {
|
|
|
228
228
|
};
|
|
229
229
|
}
|
|
230
230
|
async onReady() {
|
|
231
|
-
|
|
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
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
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]
|
|
865
|
+
args.relay = consumeValue("--relay", argv[++i], mkError);
|
|
817
866
|
break;
|
|
818
867
|
case "--auth-token":
|
|
819
|
-
args.authToken = argv[++i]
|
|
868
|
+
args.authToken = consumeValue("--auth-token", argv[++i], mkError);
|
|
820
869
|
break;
|
|
821
870
|
case "--app-id":
|
|
822
|
-
args.appId = argv[++i]
|
|
871
|
+
args.appId = consumeValue("--app-id", argv[++i], mkError);
|
|
823
872
|
break;
|
|
824
873
|
case "--app-name":
|
|
825
|
-
args.appName = argv[++i]
|
|
874
|
+
args.appName = consumeValue("--app-name", argv[++i], mkError);
|
|
826
875
|
break;
|
|
827
876
|
case "--tab-id":
|
|
828
|
-
args.tabId = argv[++i]
|
|
877
|
+
args.tabId = consumeValue("--tab-id", argv[++i], mkError);
|
|
829
878
|
break;
|
|
830
879
|
case "--exec": {
|
|
831
|
-
const raw = argv[++i];
|
|
832
|
-
if (raw ===
|
|
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 ===
|
|
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 ===
|
|
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 ===
|
|
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 ===
|
|
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 ===
|
|
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>"})`);
|