@qontinui/ui-bridge-wrapper 0.6.0 → 0.7.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.
- package/dist/capture-specs-cli.cjs +105 -56
- package/dist/capture-specs-cli.cjs.map +1 -1
- package/dist/cli-args.d.ts +10 -72
- package/dist/cli-args.d.ts.map +1 -1
- package/dist/index.cjs +66 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +66 -2
- package/dist/index.js.map +1 -1
- package/dist/inject-cli.cjs +117 -26
- package/dist/inject-cli.cjs.map +1 -1
- package/dist/login-web-cli.cjs +121 -68
- package/dist/login-web-cli.cjs.map +1 -1
- package/dist/session-storage-capture.d.ts +31 -4
- package/dist/session-storage-capture.d.ts.map +1 -1
- package/dist/transports/injected.d.ts +19 -0
- package/dist/transports/injected.d.ts.map +1 -1
- package/dist/types.d.ts +8 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +6 -4
|
@@ -5,18 +5,59 @@ var fs = require('fs');
|
|
|
5
5
|
var path = require('path');
|
|
6
6
|
var url = require('url');
|
|
7
7
|
var module$1 = require('module');
|
|
8
|
+
var ui_bridge_cli_args_star = require('@qontinui/ui-bridge-cli-args');
|
|
8
9
|
|
|
9
10
|
var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
|
|
10
11
|
function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
|
|
11
12
|
|
|
13
|
+
function _interopNamespace(e) {
|
|
14
|
+
if (e && e.__esModule) return e;
|
|
15
|
+
var n = Object.create(null);
|
|
16
|
+
if (e) {
|
|
17
|
+
Object.keys(e).forEach(function (k) {
|
|
18
|
+
if (k !== 'default') {
|
|
19
|
+
var d = Object.getOwnPropertyDescriptor(e, k);
|
|
20
|
+
Object.defineProperty(n, k, d.get ? d : {
|
|
21
|
+
enumerable: true,
|
|
22
|
+
get: function () { return e[k]; }
|
|
23
|
+
});
|
|
24
|
+
}
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
n.default = e;
|
|
28
|
+
return Object.freeze(n);
|
|
29
|
+
}
|
|
30
|
+
|
|
12
31
|
var fs__default = /*#__PURE__*/_interopDefault(fs);
|
|
13
32
|
var path__default = /*#__PURE__*/_interopDefault(path);
|
|
33
|
+
var ui_bridge_cli_args_star__namespace = /*#__PURE__*/_interopNamespace(ui_bridge_cli_args_star);
|
|
34
|
+
|
|
35
|
+
var __defProp = Object.defineProperty;
|
|
36
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
37
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
38
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
39
|
+
var __copyProps = (to, from, except, desc) => {
|
|
40
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
41
|
+
for (let key of __getOwnPropNames(from))
|
|
42
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
43
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
44
|
+
}
|
|
45
|
+
return to;
|
|
46
|
+
};
|
|
47
|
+
var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
|
|
14
48
|
|
|
15
49
|
// src/types.ts
|
|
16
50
|
var WrapperTransportError = class extends Error {
|
|
17
51
|
code;
|
|
18
52
|
retryable;
|
|
19
53
|
cause;
|
|
54
|
+
/**
|
|
55
|
+
* Optional structured diagnostic payload (error-code-specific shape) so
|
|
56
|
+
* programmatic callers can branch on data instead of parsing the message —
|
|
57
|
+
* e.g. `INJECTED_EXPECT_SELECTOR_UNMET` attaches
|
|
58
|
+
* `{ registeredElements, elementCount }`.
|
|
59
|
+
*/
|
|
60
|
+
details;
|
|
20
61
|
constructor(code, message, options = {}) {
|
|
21
62
|
super(message);
|
|
22
63
|
this.name = "WrapperTransportError";
|
|
@@ -25,6 +66,9 @@ var WrapperTransportError = class extends Error {
|
|
|
25
66
|
if (options.cause !== void 0) {
|
|
26
67
|
this.cause = options.cause;
|
|
27
68
|
}
|
|
69
|
+
if (options.details !== void 0) {
|
|
70
|
+
this.details = options.details;
|
|
71
|
+
}
|
|
28
72
|
}
|
|
29
73
|
};
|
|
30
74
|
|
|
@@ -355,6 +399,8 @@ var HeadedTransport = class extends HeadlessTransport {
|
|
|
355
399
|
};
|
|
356
400
|
var require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('capture-specs-cli.cjs', document.baseURI).href)));
|
|
357
401
|
var cachedBundle = null;
|
|
402
|
+
var DIGEST_MAX_ELEMENTS = 10;
|
|
403
|
+
var DIGEST_TIMEOUT_MS = 5e3;
|
|
358
404
|
function loadInjectedBundle() {
|
|
359
405
|
if (cachedBundle !== null) return cachedBundle;
|
|
360
406
|
let bundlePath;
|
|
@@ -481,14 +527,66 @@ var InjectedTransport = class extends HeadlessTransport {
|
|
|
481
527
|
}
|
|
482
528
|
if (state.settledByTimeout && !state.expectSatisfied) {
|
|
483
529
|
const sel = this.injected.expectSelector;
|
|
530
|
+
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.`;
|
|
531
|
+
const digest = await this.registeredElementDigest(page);
|
|
532
|
+
if (digest === null) {
|
|
533
|
+
throw new WrapperTransportError("INJECTED_EXPECT_SELECTOR_UNMET", baseMessage, {
|
|
534
|
+
retryable: true
|
|
535
|
+
});
|
|
536
|
+
}
|
|
537
|
+
const summary = digest.length > 0 ? ` Registered: ${digest.map((el) => el.role ? `${el.id} (${el.role})` : el.id).join(", ")}${state.elementCount > digest.length ? ", \u2026" : ""}` : "";
|
|
484
538
|
throw new WrapperTransportError(
|
|
485
539
|
"INJECTED_EXPECT_SELECTOR_UNMET",
|
|
486
|
-
|
|
487
|
-
{
|
|
540
|
+
`${baseMessage}${summary}`,
|
|
541
|
+
{
|
|
542
|
+
retryable: true,
|
|
543
|
+
details: { registeredElements: digest, elementCount: state.elementCount }
|
|
544
|
+
}
|
|
488
545
|
);
|
|
489
546
|
}
|
|
490
547
|
}
|
|
491
548
|
}
|
|
549
|
+
/**
|
|
550
|
+
* Best-effort digest of the first {@link DIGEST_MAX_ELEMENTS} registered
|
|
551
|
+
* interactive elements, read through the in-page dispatcher's
|
|
552
|
+
* `getControlSnapshot` action (the snapshot's per-element projection is
|
|
553
|
+
* already redaction-safe — we never read raw DOM labels here). Returns
|
|
554
|
+
* `null` on ANY failure or timeout: this feeds error diagnostics only, and a
|
|
555
|
+
* broken page realm must never mask the error being reported.
|
|
556
|
+
*/
|
|
557
|
+
async registeredElementDigest(page) {
|
|
558
|
+
let timer;
|
|
559
|
+
try {
|
|
560
|
+
const snapshotPromise = page.evaluate(
|
|
561
|
+
() => window.__uiBridgeInjected.execute("getControlSnapshot", { skipSettle: true })
|
|
562
|
+
);
|
|
563
|
+
const snapshot = await Promise.race([
|
|
564
|
+
snapshotPromise,
|
|
565
|
+
new Promise((_, reject) => {
|
|
566
|
+
timer = setTimeout(() => reject(new Error("digest fetch timed out")), DIGEST_TIMEOUT_MS);
|
|
567
|
+
})
|
|
568
|
+
]);
|
|
569
|
+
if (!snapshot || typeof snapshot !== "object") return null;
|
|
570
|
+
const elements = snapshot.elements;
|
|
571
|
+
if (!Array.isArray(elements)) return null;
|
|
572
|
+
const digest = [];
|
|
573
|
+
for (const el of elements.slice(0, DIGEST_MAX_ELEMENTS)) {
|
|
574
|
+
if (!el || typeof el !== "object") continue;
|
|
575
|
+
const e = el;
|
|
576
|
+
if (typeof e.id !== "string") continue;
|
|
577
|
+
digest.push({
|
|
578
|
+
id: e.id,
|
|
579
|
+
...typeof e.role === "string" ? { role: e.role } : {},
|
|
580
|
+
...typeof e.label === "string" ? { label: e.label } : {}
|
|
581
|
+
});
|
|
582
|
+
}
|
|
583
|
+
return digest;
|
|
584
|
+
} catch {
|
|
585
|
+
return null;
|
|
586
|
+
} finally {
|
|
587
|
+
if (timer !== void 0) clearTimeout(timer);
|
|
588
|
+
}
|
|
589
|
+
}
|
|
492
590
|
async buildContext() {
|
|
493
591
|
if (!this.tab) {
|
|
494
592
|
throw new WrapperTransportError(
|
|
@@ -757,57 +855,8 @@ function createTransport(config) {
|
|
|
757
855
|
}
|
|
758
856
|
|
|
759
857
|
// src/cli-args.ts
|
|
760
|
-
var
|
|
761
|
-
|
|
762
|
-
return value.startsWith("--");
|
|
763
|
-
}
|
|
764
|
-
function consumeValue(flag, raw, error) {
|
|
765
|
-
if (raw === void 0) return null;
|
|
766
|
-
if (isFlagShaped(raw)) {
|
|
767
|
-
throw error(`${flag} expects a value but got the flag '${raw}' \u2014 did you omit ${flag}'s argument?`);
|
|
768
|
-
}
|
|
769
|
-
return raw;
|
|
770
|
-
}
|
|
771
|
-
var ArgReader = class {
|
|
772
|
-
argv;
|
|
773
|
-
error;
|
|
774
|
-
/**
|
|
775
|
-
* @param argv Already sliced past `node script`.
|
|
776
|
-
* @param known All flags the bin recognizes (union the bin's set with {@link COMMON_FLAGS}).
|
|
777
|
-
* @param error Factory producing the bin's domain error type.
|
|
778
|
-
*/
|
|
779
|
-
constructor(argv, known, error) {
|
|
780
|
-
this.argv = argv;
|
|
781
|
-
this.error = error;
|
|
782
|
-
for (const arg of argv) {
|
|
783
|
-
if (isFlagShaped(arg) && !known.has(arg)) {
|
|
784
|
-
throw error(`Unknown flag: ${arg}`);
|
|
785
|
-
}
|
|
786
|
-
}
|
|
787
|
-
}
|
|
788
|
-
/** True if `name` appears as a bare boolean flag. */
|
|
789
|
-
has(name) {
|
|
790
|
-
return this.argv.includes(name);
|
|
791
|
-
}
|
|
792
|
-
/**
|
|
793
|
-
* Value following the value-flag `name`, or `null` when the flag is absent OR
|
|
794
|
-
* has no following token (the caller defaults it). Throws when the following
|
|
795
|
-
* token is flag-shaped — the swallow this kit exists to kill. Delegates to
|
|
796
|
-
* {@link consumeValue} so the guard (and its message) live in exactly one
|
|
797
|
-
* place for both the indexOf-style and switch-style parsers.
|
|
798
|
-
*/
|
|
799
|
-
value(name) {
|
|
800
|
-
const i = this.argv.indexOf(name);
|
|
801
|
-
if (i < 0 || i + 1 >= this.argv.length) return null;
|
|
802
|
-
return consumeValue(name, this.argv[i + 1], this.error);
|
|
803
|
-
}
|
|
804
|
-
};
|
|
805
|
-
function makeLogger(prefix, quiet) {
|
|
806
|
-
if (quiet) return () => {
|
|
807
|
-
};
|
|
808
|
-
return (m) => process.stderr.write(`${prefix} ${m}
|
|
809
|
-
`) ;
|
|
810
|
-
}
|
|
858
|
+
var cli_args_exports = {};
|
|
859
|
+
__reExport(cli_args_exports, ui_bridge_cli_args_star__namespace);
|
|
811
860
|
|
|
812
861
|
// src/login-drive.ts
|
|
813
862
|
var isCognito = (u) => /auth\.qontinui\.io|amazoncognito\.com|\/oauth2\//i.test(u);
|
|
@@ -1003,7 +1052,7 @@ function computeLoginUrl(targets, origin) {
|
|
|
1003
1052
|
}
|
|
1004
1053
|
function parseArgs(argv) {
|
|
1005
1054
|
const mkError = (m) => new CaptureCliArgError(m);
|
|
1006
|
-
const reader = new ArgReader(argv, KNOWN_FLAGS, mkError);
|
|
1055
|
+
const reader = new cli_args_exports.ArgReader(argv, KNOWN_FLAGS, mkError);
|
|
1007
1056
|
const valueOf = (name) => reader.value(name);
|
|
1008
1057
|
const has = (name) => reader.has(name);
|
|
1009
1058
|
const help = has("--help") || has("-h");
|
|
@@ -1046,7 +1095,7 @@ var KNOWN_FLAGS = /* @__PURE__ */ new Set([
|
|
|
1046
1095
|
"--pages",
|
|
1047
1096
|
"--device",
|
|
1048
1097
|
"--timeout",
|
|
1049
|
-
...COMMON_FLAGS
|
|
1098
|
+
...cli_args_exports.COMMON_FLAGS
|
|
1050
1099
|
]);
|
|
1051
1100
|
function validateArgs(args) {
|
|
1052
1101
|
if (args.help) return;
|
|
@@ -1072,7 +1121,7 @@ ${USAGE}`);
|
|
|
1072
1121
|
process.exit(0);
|
|
1073
1122
|
}
|
|
1074
1123
|
const { email, password, out, origin, device, timeoutMs } = args;
|
|
1075
|
-
const log = makeLogger("[capture]", args.quiet);
|
|
1124
|
+
const log = (0, cli_args_exports.makeLogger)("[capture]", args.quiet);
|
|
1076
1125
|
const targets = args.pages ?? defaultTargets(origin, device);
|
|
1077
1126
|
const { loginUrl } = computeLoginUrl(targets, origin);
|
|
1078
1127
|
const transport = createTransport({
|