@qontinui/ui-bridge-wrapper 0.4.1 → 0.5.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/README.md +12 -4
- package/dist/capture-specs-cli.cjs +56 -26
- package/dist/capture-specs-cli.cjs.map +1 -1
- package/dist/cli-args.d.ts +11 -1
- package/dist/cli-args.d.ts.map +1 -1
- package/dist/index.cjs +43 -16
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +43 -16
- package/dist/index.js.map +1 -1
- package/dist/inject-cli.cjs +145 -29
- package/dist/inject-cli.cjs.map +1 -1
- package/dist/inject-cli.d.ts +29 -1
- package/dist/inject-cli.d.ts.map +1 -1
- package/dist/login-drive.d.ts.map +1 -1
- package/dist/login-web-cli.cjs +184 -34
- package/dist/login-web-cli.cjs.map +1 -1
- package/dist/login-web-cli.d.ts +5 -1
- 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/session-storage-capture.d.ts +78 -0
- package/dist/session-storage-capture.d.ts.map +1 -0
- package/dist/transports/headless.d.ts +16 -0
- package/dist/transports/headless.d.ts.map +1 -1
- package/package.json +2 -2
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/types.ts","../src/handler-registry.ts","../src/base-transport.ts","../src/transports/api.ts","../src/transports/headless.ts","../src/transports/headed.ts","../src/transports/injected.ts","../src/transports/live.ts","../src/create-transport.ts","../src/helpers/retry.ts","../src/helpers/auth.ts","../src/helpers/schema.ts","../src/manifest-only.ts"],"names":["require","createRequire","readFileSync"],"mappings":";;;;;;;AAwGO,IAAM,qBAAA,GAAN,cAAoC,KAAA,CAAM;AAAA,EACtC,IAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EAET,WAAA,CACE,IAAA,EACA,OAAA,EACA,OAAA,GAAoD,EAAC,EACrD;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,KAAA;AACtC,IAAA,IAAI,OAAA,CAAQ,UAAU,MAAA,EAAW;AAC/B,MAAA,IAAA,CAAK,QAAQ,OAAA,CAAQ,KAAA;AAAA,IACvB;AAAA,EACF;AACF;;;ACjGO,IAAM,kBAAN,MAAsB;AAAA,EACV,QAAA,uBAAe,GAAA,EAA4B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5D,QAAA,CACE,UACA,EAAA,EACM;AACN,IAAA,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,QAAA,EAAU,EAAoB,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,WAAW,QAAA,EAA2B;AACpC,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,QAAQ,CAAA;AAAA,EACtC;AAAA;AAAA,EAGA,IAAA,GAAiB;AACf,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA;AAAA,EACxC;AAAA;AAAA,EAGA,IAAI,QAAA,EAA2B;AAC7B,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,QAAQ,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,QAAA,CACJ,QAAA,EACA,MAAA,EACA,GAAA,EACkB;AAClB,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,QAAQ,CAAA;AAC1C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,YAAA;AAAA,QACA,qCAAqC,QAAQ,CAAA,CAAA;AAAA,OAC/C;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA;AACxC,MAAA,OAAO,MAAA;AAAA,IACT,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,GAAA,YAAe,uBAAuB,MAAM,GAAA;AAChD,MAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,MAAA,MAAM,IAAI,qBAAA,CAAsB,eAAA,EAAiB,SAAS,EAAE,KAAA,EAAO,KAAK,CAAA;AAAA,IAC1E;AAAA,EACF;AACF;;;AC9DO,IAAe,gBAAf,MAAyD;AAAA,EAGpD,OAAA,GAAkC,MAAA;AAAA,EACzB,SAAA,uBAAgB,GAAA,EAAyC;AAAA,EACzD,QAAA;AAAA,EACX,YAAA,GAAqC,IAAA;AAAA,EAE7C,YAAY,QAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,QAAA,GAAW,QAAA,IAAY,IAAI,eAAA,EAAgB;AAAA,EAClD;AAAA,EAEA,IAAI,MAAA,GAAiC;AACnC,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,eAAA,GAAmC;AACrC,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA;AAAA,EAGA,QAAA,CACE,UACA,EAAA,EACM;AACN,IAAA,IAAA,CAAK,QAAA,CAAS,QAAA,CAAS,QAAA,EAAU,EAAE,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI,IAAA,CAAK,YAAY,OAAA,EAAS;AAC9B,IAAA,IAAI,IAAA,CAAK,YAAY,QAAA,EAAU;AAC7B,MAAA,MAAM,IAAI,qBAAA,CAAsB,kBAAA,EAAoB,CAAA,WAAA,EAAc,IAAA,CAAK,IAAI,CAAA,WAAA,CAAa,CAAA;AAAA,IAC1F;AACA,IAAA,IAAI,IAAA,CAAK,YAAA,EAAc,OAAO,IAAA,CAAK,YAAA;AAEnC,IAAA,IAAA,CAAK,UAAU,YAAY,CAAA;AAC3B,IAAA,IAAA,CAAK,YAAA,GAAe,IAAA,CAAK,OAAA,EAAQ,CAC9B,KAAK,MAAM;AACV,MAAA,IAAA,CAAK,UAAU,OAAO,CAAA;AAAA,IACxB,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,GAAA,KAAiB;AACvB,MAAA,IAAA,CAAK,UAAU,OAAO,CAAA;AACtB,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AACpB,MAAA,MAAM,GAAA;AAAA,IACR,CAAC,CAAA;AACH,IAAA,OAAO,IAAA,CAAK,YAAA;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,QAAA,CAA4B,QAAA,EAAkB,MAAA,EAAoC;AACtF,IAAA,MAAM,KAAK,KAAA,EAAM;AACjB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,YAAA,CAAa,UAAU,MAAM,CAAA;AACpD,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,QAAA,CAAkB,QAAA,EAAU,QAAQ,GAAG,CAAA;AAAA,EAC9D;AAAA,EAEA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAI,IAAA,CAAK,YAAY,QAAA,EAAU;AAC/B,IAAA,IAAI;AACF,MAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,IACrB,CAAA,SAAE;AACA,MAAA,IAAA,CAAK,UAAU,QAAQ,CAAA;AACvB,MAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AACrB,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,eAAe,QAAA,EAA2D;AACxE,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,EACF;AAAA;AAAA,EAGU,UAAU,IAAA,EAAoC;AACtD,IAAA,IAAI,IAAA,CAAK,YAAY,IAAA,EAAM;AAC3B,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AACf,IAAA,KAAA,MAAW,CAAA,IAAK,KAAK,SAAA,EAAW;AAC9B,MAAA,IAAI;AACF,QAAA,CAAA,CAAE,IAAI,CAAA;AAAA,MACR,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAgB,YAAA,CAAa,SAAA,EAAmB,OAAA,EAAoC;AAClF,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;ACjGO,IAAM,YAAA,GAAN,cAA2B,aAAA,CAAc;AAAA,EACrC,IAAA,GAA6B,KAAA;AAAA,EACrB,QAAA;AAAA,EAEjB,YAAY,MAAA,GAA0B,EAAE,IAAA,EAAM,KAAA,IAAS,QAAA,EAA4B;AACjF,IAAA,KAAA,CAAM,QAAQ,CAAA;AACd,IAAA,MAAM,OAAA,GAAW,OAAO,OAAA,EAA+C,OAAA;AACvE,IAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,MAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAAA,IAClB;AAAA,EACF;AAAA,EAEA,MAAgB,OAAA,GAAyB;AAAA,EAEzC;AAAA,EAEA,MAAgB,OAAA,GAAyB;AAAA,EAEzC;AAAA,EAEA,MAAgB,YAAA,GAAoC;AAClD,IAAA,OAAO,EAAE,MAAM,KAAA,EAAM;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAA,CAA4B,QAAA,EAAkB,MAAA,EAAoC;AACtF,IAAA,MAAM,KAAK,KAAA,EAAM;AACjB,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,QAAQ,CAAA,EAAG;AAC/B,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,YAAA,EAAa;AACpC,MAAA,OAAO,IAAA,CAAK,QAAA,CAAS,QAAA,CAAkB,QAAA,EAAU,QAAQ,GAAG,CAAA;AAAA,IAC9D;AACA,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA,IAAI;AACF,QAAA,OAAQ,MAAM,IAAA,CAAK,QAAA,CAAS,QAAA,EAAU,MAAM,CAAA;AAAA,MAC9C,SAAS,GAAA,EAAK;AACZ,QAAA,IAAI,GAAA,YAAe,uBAAuB,MAAM,GAAA;AAChD,QAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,QAAA,MAAM,IAAI,qBAAA,CAAsB,eAAA,EAAiB,SAAS,EAAE,KAAA,EAAO,KAAK,CAAA;AAAA,MAC1E;AAAA,IACF;AACA,IAAA,MAAM,IAAI,qBAAA,CAAsB,YAAA,EAAc,CAAA,kCAAA,EAAqC,QAAQ,CAAA,CAAA,CAAG,CAAA;AAAA,EAChG;AACF;;;AChBO,IAAM,iBAAA,GAAN,cAAgC,aAAA,CAAc;AAAA,EAC1C,IAAA;AAAA,EACU,OAAA;AAAA,EACA,QAAA;AAAA,EAET,GAAA,GAOC,IAAA;AAAA,EAEX,WAAA,CACE,MAAA,EACA,QAAA,EACA,SAAA,GAAiE,EAAC,EAClE;AACA,IAAA,KAAA,CAAM,QAAQ,CAAA;AACd,IAAA,IAAA,CAAK,IAAA,GAAO,UAAU,IAAA,IAAQ,UAAA;AAC9B,IAAA,IAAA,CAAK,QAAA,GAAW,UAAU,QAAA,IAAY,IAAA;AACtC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,YAAA,CAAa,MAAM,CAAA;AAAA,EACzC;AAAA,EAEQ,aAAa,MAAA,EAAmD;AACtE,IAAA,MAAM,GAAA,GAAO,MAAA,CAAO,OAAA,IAAW,EAAC;AAChC,IAAA,MAAM,SAAA,GAAY,IAAI,WAAW,CAAA;AACjC,IAAA,IAAI,OAAO,SAAA,KAAc,QAAA,IAAY,SAAA,CAAU,WAAW,CAAA,EAAG;AAC3D,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,gBAAA;AAAA,QACA,CAAA,gBAAA,EAAmB,KAAK,IAAI,CAAA,qCAAA;AAAA,OAC9B;AAAA,IACF;AACA,IAAA,OAAO;AAAA,MACL,SAAA;AAAA,MACA,aAAA,EACE,OAAO,GAAA,CAAI,eAAe,MAAM,QAAA,GAAY,GAAA,CAAI,eAAe,CAAA,GAAe,MAAA;AAAA,MAChF,cAAA,EACE,OAAO,GAAA,CAAI,gBAAgB,MAAM,QAAA,GAAY,GAAA,CAAI,gBAAgB,CAAA,GAAe,MAAA;AAAA,MAClF,YAAA,EACE,OAAO,GAAA,CAAI,cAAc,MAAM,QAAA,GAAY,GAAA,CAAI,cAAc,CAAA,GAAe,MAAA;AAAA,MAC9E,iBAAA,EACE,OAAO,GAAA,CAAI,mBAAmB,MAAM,QAAA,GAC/B,GAAA,CAAI,mBAAmB,CAAA,GACxB,MAAA;AAAA,MACN,SAAA,EAAW,OAAO,GAAA,CAAI,WAAW,MAAM,QAAA,GAAY,GAAA,CAAI,WAAW,CAAA,GAAe,MAAA;AAAA,MACjF,cAAA,EACE,OAAO,GAAA,CAAI,gBAAgB,MAAM,SAAA,GAAa,GAAA,CAAI,gBAAgB,CAAA,GAAgB;AAAA,KACtF;AAAA,EACF;AAAA,EAEA,MAAgB,OAAA,GAAyB;AAOvC,IAAA,IAAI,iBAAA;AACJ,IAAA,IAAI;AACF,MAAA,CAAC,EAAE,iBAAA,EAAkB,GAAI,MAAM,OAAO,8BAA8B,CAAA;AAAA,IACtE,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,QAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC7D,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,gBAAA;AAAA,QACA,CAAA,gBAAA,EAAmB,KAAK,IAAI,CAAA;AAAA;AAAA;AAAA;AAAA,yBAAA,EAME,KAAK,CAAA;AAAA,OACrC;AAAA,IACF;AAGA,IAAA,MAAM,WAAA,GAAc,MAAM,IAAA,CAAK,gBAAA,EAAiB;AAEhD,IAAA,MAAM,GAAA,GAAM,MAAM,iBAAA,CAAkB;AAAA,MAClC,GAAA,EAAK,KAAK,OAAA,CAAQ,SAAA;AAAA,MAClB,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,YAAA,EAAc,KAAK,OAAA,CAAQ,YAAA;AAAA,MAC3B,iBAAA,EAAmB,KAAK,OAAA,CAAQ,iBAAA;AAAA,MAChC,aAAA,EAAe,KAAK,OAAA,CAAQ,aAAA;AAAA,MAC5B,cAAA,EAAgB,KAAK,OAAA,CAAQ,cAAA;AAAA,MAC7B,SAAA,EAAW,KAAK,OAAA,CAAQ,SAAA;AAAA,MACxB,cAAA,EAAgB,KAAK,OAAA,CAAQ,cAAA;AAAA,MAC7B,WAAA,EAAa,WAAA,CAAY,MAAA,GAAS,CAAA,GAAI,WAAA,GAAc;AAAA,KACrD,CAAA;AAED,IAAA,IAAA,CAAK,GAAA,GAAM;AAAA,MACT,SAAS,GAAA,CAAI,OAAA;AAAA,MACb,SAAS,GAAA,CAAI,OAAA;AAAA,MACb,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,oBAAoB,GAAA,CAAI,kBAAA;AAAA,MACxB,OAAO,GAAA,CAAI,KAAA;AAAA,MACX,OAAO,GAAA,CAAI;AAAA,KACb;AAIA,IAAA,MAAM,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAgB,gBAAA,GAAsC;AACpD,IAAA,OAAO,EAAC;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,YAAY,KAAA,EAA4B;AAAA,EAExD;AAAA,EAEA,MAAgB,OAAA,GAAyB;AACvC,IAAA,IAAI,CAAC,KAAK,GAAA,EAAK;AACf,IAAA,MAAM,IAAI,IAAA,CAAK,GAAA;AACf,IAAA,IAAA,CAAK,GAAA,GAAM,IAAA;AACX,IAAA,MAAM,EAAE,KAAA,EAAM;AAAA,EAChB;AAAA,EAEA,MAAgB,YAAA,GAAyC;AACvD,IAAA,IAAI,CAAC,KAAK,GAAA,EAAK;AACb,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,WAAA;AAAA,QACA,CAAA,WAAA,EAAc,KAAK,IAAI,CAAA,4CAAA;AAAA,OACzB;AAAA,IACF;AACA,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,IAAA,EAAM,KAAK,GAAA,CAAI,IAAA;AAAA,MACf,cAAA,EAAgB,KAAK,GAAA,CAAI,OAAA;AAAA,MACzB,OAAA,EAAS,KAAK,GAAA,CAAI,OAAA;AAAA,MAClB,kBAAA,EAAoB,KAAK,GAAA,CAAI,kBAAA;AAAA,MAC7B,KAAA,EAAO,KAAK,GAAA,CAAI;AAAA,KAClB;AAAA,EACF;AACF;;;AC/LO,IAAM,eAAA,GAAN,cAA8B,iBAAA,CAAkB;AAAA,EACrD,WAAA,CAAY,QAAyB,QAAA,EAA4B;AAC/D,IAAA,KAAA,CAAM,QAAQ,QAAA,EAAU,EAAE,MAAM,QAAA,EAAU,QAAA,EAAU,OAAO,CAAA;AAAA,EAC7D;AACF;ACeA,IAAMA,QAAAA,GAAUC,sBAAA,CAAc,2PAAe,CAAA;AAG7C,IAAI,YAAA,GAA8B,IAAA;AAGlC,SAAS,kBAAA,GAA6B;AACpC,EAAA,IAAI,YAAA,KAAiB,MAAM,OAAO,YAAA;AAClC,EAAA,IAAI,UAAA;AACJ,EAAA,IAAI;AACF,IAAA,UAAA,GAAaD,QAAAA,CAAQ,QAAQ,+CAA+C,CAAA;AAAA,EAC9E,CAAA,CAAA,MAAQ;AAGN,IAAA,MAAM,OAAA,GAAUA,QAAAA,CAAQ,OAAA,CAAQ,kCAAkC,CAAA;AAClE,IAAA,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,gBAAA,EAAkB,gCAAgC,CAAA;AAAA,EACjF;AACA,EAAA,IAAI;AACF,IAAA,YAAA,GAAeE,eAAA,CAAa,YAAY,MAAM,CAAA;AAAA,EAChD,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,qBAAA;AAAA,MACR,yBAAA;AAAA,MACA,4DAA4D,UAAU,CAAA,+EAAA,CAAA;AAAA,MAEtE,EAAE,KAAA;AAAM,KACV;AAAA,EACF;AACA,EAAA,OAAO,YAAA;AACT;AA0FO,IAAM,iBAAA,GAAN,cAAgC,iBAAA,CAAkB;AAAA,EACtC,QAAA;AAAA,EAEjB,WAAA,CAAY,QAAyB,QAAA,EAA4B;AAC/D,IAAA,MAAM,GAAA,GAAO,MAAA,CAAO,OAAA,IAAW,EAAC;AAChC,IAAA,MAAM,MAAA,GAAS,GAAA,CAAI,QAAQ,CAAA,KAAM,IAAA;AACjC,IAAA,KAAA,CAAM,MAAA,EAAQ,UAAU,EAAE,IAAA,EAAM,YAAY,QAAA,EAAU,CAAC,QAAQ,CAAA;AAC/D,IAAA,IAAA,CAAK,QAAA,GAAW;AAAA,MACd,MAAA;AAAA,MACA,cAAA,EACE,OAAO,GAAA,CAAI,gBAAgB,MAAM,QAAA,GAAY,GAAA,CAAI,gBAAgB,CAAA,GAAe,GAAA;AAAA,MAClF,aAAA,EAAe,GAAA,CAAI,eAAe,CAAA,KAAM,KAAA;AAAA,MACxC,aAAA,EACE,OAAO,GAAA,CAAI,eAAe,MAAM,QAAA,GAAY,GAAA,CAAI,eAAe,CAAA,GAAe,MAAA;AAAA,MAChF,eAAA,EACE,OAAO,GAAA,CAAI,iBAAiB,MAAM,QAAA,GAAY,GAAA,CAAI,iBAAiB,CAAA,GAAe,MAAA;AAAA,MACpF,cAAA,EACE,OAAO,GAAA,CAAI,gBAAgB,CAAA,KAAM,QAAA,IAAa,GAAA,CAAI,gBAAgB,CAAA,CAAa,MAAA,GAAS,CAAA,GACnF,GAAA,CAAI,gBAAgB,CAAA,GACrB,MAAA;AAAA,MACN,SAAA,EAAW,OAAO,GAAA,CAAI,WAAW,MAAM,QAAA,GAAY,GAAA,CAAI,WAAW,CAAA,GAAe,MAAA;AAAA,MACjF,oBAAA,EAAsB,uBAAuB,GAAA,CAAI,sBAAsB,CAAC,CAAA,GACnE,GAAA,CAAI,sBAAsB,CAAA,GAC3B,MAAA;AAAA,MACJ,KAAA,EAAO,OAAO,GAAA,CAAI,OAAO,MAAM,QAAA,GAAY,GAAA,CAAI,OAAO,CAAA,GAAe,MAAA;AAAA,MACrE,OAAA,EAAS,OAAO,GAAA,CAAI,SAAS,MAAM,QAAA,GAAY,GAAA,CAAI,SAAS,CAAA,GAAe,MAAA;AAAA,MAC3E,KAAA,EAAO,OAAO,GAAA,CAAI,OAAO,MAAM,QAAA,GAAY,GAAA,CAAI,OAAO,CAAA,GAAe;AAAA,KACvE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,cAAA,GAAiD;AACvD,IAAA,MAAM,MAA+B,EAAC;AACtC,IAAA,MAAM,IAAA,GAAO,KAAK,OAAA,CAAQ,YAAA;AAC1B,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,GAAA,CAAI,YAAA,GAAe,IAAA;AACnB,MAAA,IAAI,KAAK,QAAA,CAAS,SAAA,EAAW,GAAA,CAAI,SAAA,GAAY,KAAK,QAAA,CAAS,SAAA;AAC3D,MAAA,IAAI,KAAK,QAAA,CAAS,oBAAA;AAChB,QAAA,GAAA,CAAI,oBAAA,GAAuB,KAAK,QAAA,CAAS,oBAAA;AAC3C,MAAA,IAAI,KAAK,QAAA,CAAS,KAAA,EAAO,GAAA,CAAI,KAAA,GAAQ,KAAK,QAAA,CAAS,KAAA;AACnD,MAAA,IAAI,KAAK,QAAA,CAAS,OAAA,EAAS,GAAA,CAAI,OAAA,GAAU,KAAK,QAAA,CAAS,OAAA;AACvD,MAAA,IAAI,KAAK,QAAA,CAAS,KAAA,EAAO,GAAA,CAAI,KAAA,GAAQ,KAAK,QAAA,CAAS,KAAA;AAAA,IACrD;AACA,IAAA,IAAI,IAAA,CAAK,SAAS,aAAA,KAAkB,MAAA;AAClC,MAAA,GAAA,CAAI,aAAA,GAAgB,KAAK,QAAA,CAAS,aAAA;AACpC,IAAA,IAAI,IAAA,CAAK,SAAS,eAAA,KAAoB,MAAA;AACpC,MAAA,GAAA,CAAI,eAAA,GAAkB,KAAK,QAAA,CAAS,eAAA;AACtC,IAAA,IAAI,IAAA,CAAK,SAAS,cAAA,KAAmB,MAAA;AACnC,MAAA,GAAA,CAAI,cAAA,GAAiB,KAAK,QAAA,CAAS,cAAA;AACrC,IAAA,OAAO,OAAO,IAAA,CAAK,GAAG,CAAA,CAAE,MAAA,GAAS,IAAI,GAAA,GAAM,IAAA;AAAA,EAC7C;AAAA,EAEA,MAAyB,gBAAA,GAAsC;AAC7D,IAAA,MAAM,UAAoB,EAAC;AAE3B,IAAA,MAAM,GAAA,GAAM,KAAK,cAAA,EAAe;AAChC,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,OAAA,CAAQ,KAAK,CAAA,kCAAA,EAAqC,IAAA,CAAK,SAAA,CAAU,GAAG,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,IAC1E;AACA,IAAA,OAAA,CAAQ,IAAA,CAAK,oBAAoB,CAAA;AACjC,IAAA,OAAO,OAAA;AAAA,EACT;AAAA,EAEA,MAAyB,YAAY,IAAA,EAA2B;AAI9D,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,eAAA;AAAA,QACT,MACG,MAAA,CAAmE,kBAAA,EAChE,KAAA,KAAU,IAAA;AAAA,QAChB,KAAA,CAAA;AAAA,QACA,EAAE,OAAA,EAAS,IAAA,CAAK,QAAA,CAAS,cAAA;AAAe,OAC1C;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,4BAAA;AAAA,QACA,CAAA,2DAAA,EACK,IAAA,CAAK,QAAA,CAAS,cAAc,CAAA,iHAAA,CAAA;AAAA,QAEjC,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA;AAAK,OAC3B;AAAA,IACF;AAQA,IAAA,IAAI,IAAA,CAAK,SAAS,aAAA,EAAe;AAC/B,MAAA,IAAI,KAAA;AAMJ,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,eAAA;AAAA,UACT,MAEI,MAAA,CACA,kBAAA,EAAoB,OAAA,KAAY,IAAA;AAAA,UACpC,KAAA,CAAA;AAAA,UACA,EAAE,OAAA,EAAS,IAAA,CAAK,QAAA,CAAS,cAAA;AAAe,SAC1C;AACA,QAAA,KAAA,GAAQ,MAAM,IAAA,CAAK,QAAA,CAAS,MAAM;AAChC,UAAA,MAAM,MACJ,MAAA,CAQA,kBAAA;AACF,UAAA,OAAO;AAAA,YACL,OAAA,EAAS,KAAK,OAAA,KAAY,IAAA;AAAA,YAC1B,gBAAA,EAAkB,KAAK,gBAAA,KAAqB,IAAA;AAAA,YAC5C,eAAA,EAAiB,KAAK,eAAA,KAAoB,IAAA;AAAA,YAC1C,YAAA,EAAc,KAAK,YAAA,IAAgB;AAAA,WACrC;AAAA,QACF,CAAC,CAAA;AAAA,MACH,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,IAAI,qBAAA;AAAA,UACR,8BAAA;AAAA,UACA,CAAA,6DAAA,EACK,IAAA,CAAK,QAAA,CAAS,cAAc,CAAA,sLAAA,CAAA;AAAA,UAGjC,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA;AAAK,SAC3B;AAAA,MACF;AAQA,MAAA,IAAI,KAAA,CAAM,gBAAA,IAAoB,CAAC,KAAA,CAAM,eAAA,EAAiB;AACpD,QAAA,MAAM,GAAA,GAAM,KAAK,QAAA,CAAS,cAAA;AAC1B,QAAA,MAAM,IAAI,qBAAA;AAAA,UACR,gCAAA;AAAA,UACA,MACI,CAAA,gFAAA,EACgB,GAAG,CAAA,oBAAA,EAAkB,KAAA,CAAM,YAAY,CAAA,gOAAA,CAAA,GAIvD,CAAA,2PAAA,CAAA;AAAA,UAIJ,EAAE,WAAW,IAAA;AAAK,SACpB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAyB,YAAA,GAAyC;AAChE,IAAA,IAAI,CAAC,KAAK,GAAA,EAAK;AACb,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,WAAA;AAAA,QACA,CAAA,+DAAA;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,EAAE,MAAM,OAAA,EAAS,cAAA,EAAgB,SAAS,kBAAA,EAAoB,KAAA,KAAU,IAAA,CAAK,GAAA;AAEnF,IAAA,MAAM,OAAA,GAAU,CAAc,MAAA,EAAgB,OAAA,KAC5C,IAAA,CAAK,QAAA;AAAA,MACH,CAAC,IAAA,KAEG,MAAA,CAGA,kBAAA,CAAmB,OAAA,CAAQ,KAAK,CAAC,CAAA,EAAG,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,MAC/C,CAAC,QAAQ,OAAO;AAAA,KAClB;AAEF,IAAA,MAAM,WAAA,GAAc,MAClB,IAAA,CAAK,QAAA,CAAS,MAAM;AAClB,MAAA,MAAM,MACJ,MAAA,CAQA,kBAAA;AACF,MAAA,OAAO;AAAA,QACL,OAAA,EAAS,KAAK,OAAA,KAAY,IAAA;AAAA,QAC1B,YAAA,EAAc,KAAK,YAAA,IAAgB,CAAA;AAAA,QACnC,gBAAA,EAAkB,KAAK,gBAAA,KAAqB,IAAA;AAAA,QAC5C,eAAA,EAAiB,KAAK,eAAA,KAAoB;AAAA,OAC5C;AAAA,IACF,CAAC,CAAA;AAEH,IAAA,MAAM,WAAA,GAAc,CAAC,SAAA,KACnB,IAAA,CAAK,QAAA;AAAA,MACH,CAAC,EAAA,KAAsB;AACrB,QAAA,MAAM,MACJ,MAAA,CAcA,kBAAA;AACF,QAAA,IAAI,KAAK,WAAA,EAAa,OAAO,GAAA,CAAI,WAAA,CAAY,MAAM,MAAS,CAAA;AAC5D,QAAA,OAAO,QAAQ,OAAA,CAAQ;AAAA,UACrB,OAAA,EAAS,KAAK,OAAA,KAAY,IAAA;AAAA,UAC1B,YAAA,EAAc,KAAK,YAAA,IAAgB,CAAA;AAAA,UACnC,gBAAA,EAAkB,KAAK,gBAAA,KAAqB,IAAA;AAAA,UAC5C,eAAA,EAAiB,KAAK,eAAA,KAAoB;AAAA,SAC3C,CAAA;AAAA,MACH,CAAA;AAAA,MACC,SAAA,IAAa;AAAA,KAChB;AAEF,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,UAAA;AAAA,MACN,IAAA;AAAA,MACA,cAAA;AAAA,MACA,OAAA;AAAA,MACA,kBAAA;AAAA,MACA,KAAA,EAAO,IAAA;AAAA,MACP,KAAA;AAAA,MACA,WAAA;AAAA,MACA,WAAA;AAAA,MACA,OAAA;AAAA,MACA,MAAM,CAAC,QAAA,KAAuC,QAAQ,MAAA,EAAQ,QAAA,IAAY,EAAE,CAAA;AAAA,MAC5E,GAAA,EAAK,CAAC,EAAA,EAAY,OAAA,KAChB,QAAQ,sBAAA,EAAwB,EAAE,EAAA,EAAI,OAAA,EAAS,CAAA;AAAA,MACjD,UAAU,CAAC,OAAA,KAAsC,QAAQ,oBAAA,EAAsB,OAAA,IAAW,EAAE,CAAA;AAAA,MAC5F,MAAA,EAAQ,CAAC,IAAA,KAAkC,OAAA,CAAQ,YAAY,IAAI;AAAA,KACrE;AAAA,EACF;AACF;AAEA,SAAS,uBAAuB,KAAA,EAAyB;AACvD,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AAChD,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,OAAO,OAAO,CAAA,CAAE,MAAA,KAAW,QAAA,IAAY,OAAO,EAAE,SAAA,KAAc,QAAA;AAChE;;;ACzRO,IAAM,oBAAA,GAAN,cAAmC,aAAA,CAAc;AAAA,EAC7C,IAAA,GAA6B,MAAA;AAAA,EAErB,GAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,IAAA;AAAA,EACA,MAAA;AAAA,EAET,EAAA,GAA8B,IAAA;AAAA,EAC9B,YAAA,GAIG,IAAA;AAAA,EAEX,WAAA,CACE,MAAA,EACA,QAAA,EACA,QAAA,EACA;AACA,IAAA,KAAA,CAAM,QAAQ,CAAA;AACd,IAAA,IAAI,CAAC,OAAO,SAAA,EAAW;AACrB,MAAA,MAAM,IAAI,qBAAA,CAAsB,gBAAA,EAAkB,CAAA,wCAAA,CAA0C,CAAA;AAAA,IAC9F;AACA,IAAA,IAAA,CAAK,MAAM,MAAA,CAAO,SAAA;AAClB,IAAA,IAAA,CAAK,QAAQ,MAAA,CAAO,KAAA;AACpB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAQ,MAAA,CAAO,OAAA,IAAW,EAAC;AAChC,IAAA,MAAM,gBAAgB,QAAA,EAAU,aAAA;AAGhC,IAAA,MAAM,aACJ,OAAQ,UAAA,CAA6C,SAAA,KAAc,UAAA,GAC7D,WAA6C,SAAA,GAC/C,MAAA;AACN,IAAA,MAAM,WAAW,aAAA,IAAiB,UAAA;AAClC,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,MAAM,IAAI,qBAAA;AAAA,QACR,cAAA;AAAA,QACA,CAAA,8HAAA;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,MAAA,GAAS,QAAA;AAAA,EAChB;AAAA,EAEA,MAAgB,OAAA,GAAyB;AACvC,IAAA,MAAM,EAAA,GAAK,IAAI,IAAA,CAAK,MAAA,CAAO,KAAK,GAAG,CAAA;AACnC,IAAA,IAAA,CAAK,EAAA,GAAK,EAAA;AAEV,IAAA,EAAA,CAAG,gBAAA,CAAiB,WAAW,CAAC,EAAA,KAAO,KAAK,aAAA,CAAc,EAAA,CAAG,IAAI,CAAC,CAAA;AAClE,IAAA,EAAA,CAAG,gBAAA,CAAiB,OAAA,EAAS,MAAM,IAAA,CAAK,aAAa,CAAA;AACrD,IAAA,EAAA,CAAG,iBAAiB,OAAA,EAAS,CAAC,OAAO,IAAA,CAAK,WAAA,CAAY,EAAE,CAAC,CAAA;AAGzD,IAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC3C,MAAA,MAAM,SAAS,MAAM;AACnB,QAAA,IAAI;AACF,UAAA,MAAM,KAAA,GAAuB;AAAA,YAC3B,IAAA,EAAM,UAAA;AAAA,YACN,SAAA,EAAW,WAAA;AAAA,YACX,OAAO,IAAA,CAAK,KAAA;AAAA,YACZ,SAAS,IAAA,CAAK,OAAA;AAAA,YACd,OAAA,EAAS,IAAA,CAAK,IAAA,CAAK,OAAA,IAAW;AAAA,WAChC;AACA,UAAA,IAAI,KAAK,IAAA,CAAK,SAAA,KAAc,QAAW,KAAA,CAAM,SAAA,GAAY,KAAK,IAAA,CAAK,SAAA;AACnE,UAAA,IAAI,KAAK,IAAA,CAAK,OAAA,KAAY,QAAW,KAAA,CAAM,OAAA,GAAU,KAAK,IAAA,CAAK,OAAA;AAC/D,UAAA,IAAI,KAAK,IAAA,CAAK,YAAA,KAAiB,QAAW,KAAA,CAAM,YAAA,GAAe,KAAK,IAAA,CAAK,YAAA;AACzE,UAAA,IAAI,KAAK,IAAA,CAAK,MAAA,KAAW,QAAW,KAAA,CAAM,MAAA,GAAS,KAAK,IAAA,CAAK,MAAA;AAC7D,UAAA,IAAI,KAAK,IAAA,CAAK,OAAA,KAAY,QAAW,KAAA,CAAM,OAAA,GAAU,KAAK,IAAA,CAAK,OAAA;AAC/D,UAAA,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAA;AAAA,QAC/B,SAAS,GAAA,EAAK;AACZ,UAAA,MAAA,CAAO,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAC1D,UAAA;AAAA,QACF;AACA,QAAA,MAAM,SAAA,GAAY,IAAA,CAAK,IAAA,CAAK,kBAAA,IAAsB,GAAA;AAClD,QAAA,MAAM,KAAA,GAAQ,WAAW,MAAM;AAC7B,UAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AACpB,UAAA,MAAA;AAAA,YACE,IAAI,qBAAA;AAAA,cACF,mBAAA;AAAA,cACA,uCAAuC,SAAS,CAAA,EAAA;AAAA;AAClD,WACF;AAAA,QACF,GAAG,SAAS,CAAA;AACZ,QAAA,IAAA,CAAK,YAAA,GAAe,EAAE,OAAA,EAAS,MAAA,EAAQ,KAAA,EAAM;AAAA,MAC/C,CAAA;AACA,MAAA,EAAA,CAAG,gBAAA,CAAiB,QAAQ,MAAM,CAAA;AAAA,IACpC,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,MAAgB,OAAA,GAAyB;AACvC,IAAA,MAAM,KAAK,IAAA,CAAK,EAAA;AAChB,IAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AACV,IAAA,IAAI,KAAK,YAAA,EAAc;AACrB,MAAA,YAAA,CAAa,IAAA,CAAK,aAAa,KAAK,CAAA;AACpC,MAAA,IAAA,CAAK,YAAA,CAAa,MAAA;AAAA,QAChB,IAAI,qBAAA,CAAsB,kBAAA,EAAoB,mCAAmC;AAAA,OACnF;AACA,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB;AACA,IAAA,IAAI,EAAA,EAAI;AACN,MAAA,IAAI;AACF,QAAA,EAAA,CAAG,KAAA,EAAM;AAAA,MACX,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAgB,YAAA,GAAqC;AACnD,IAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,IAAA,EAAK;AAAA,EACzC;AAAA,EAEQ,cAAc,IAAA,EAAqB;AACzC,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAM,OAAO,OAAO,IAAA,KAAS,QAAA,GAAW,IAAA,GAAO,OAAO,IAAI,CAAA;AAC1D,MAAA,KAAA,GAAQ,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,IACzB,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AAEA,IAAA,QAAQ,MAAM,IAAA;AAAM,MAClB,KAAK,KAAA;AAAA,MACL,KAAK,YAAA,EAAc;AACjB,QAAA,MAAM,CAAA,GAAI,KAAA;AACV,QAAA,IAAI,CAAC,KAAK,YAAA,EAAc;AACxB,QAAA,YAAA,CAAa,IAAA,CAAK,aAAa,KAAK,CAAA;AACpC,QAAA,IAAI,CAAA,CAAE,OAAO,KAAA,EAAO;AAClB,UAAA,MAAM,MAAM,IAAI,qBAAA;AAAA,YACd,CAAA,CAAE,OAAO,IAAA,IAAQ,iBAAA;AAAA,YACjB,CAAA,CAAE,OAAO,OAAA,IAAW;AAAA,WACtB;AACA,UAAA,IAAA,CAAK,YAAA,CAAa,OAAO,GAAG,CAAA;AAAA,QAC9B,CAAA,MAAO;AACL,UAAA,IAAA,CAAK,aAAa,OAAA,EAAQ;AAAA,QAC5B;AACA,QAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AACpB,QAAA;AAAA,MACF;AAAA,MACA,KAAK,SAAA,EAAW;AACd,QAAA,MAAM,CAAA,GAAI,KAAA;AACV,QAAA,KAAK,IAAA,CAAK,cAAc,CAAC,CAAA;AACzB,QAAA;AAAA,MACF;AAAA,MACA;AACE,QAAA;AAAA;AACJ,EACF;AAAA,EAEA,MAAc,cAAc,KAAA,EAAoC;AAC9D,IAAA,MAAM,MAAmB,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,MAAM,SAAA,EAAU;AACpE,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,QAAA,CAAS,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAA,CAAM,OAAA,EAAS,GAAG,CAAA;AAC5E,MAAA,QAAA,GAAW;AAAA,QACT,IAAA,EAAM,UAAA;AAAA,QACN,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,OAAA,EAAS,IAAA;AAAA,QACT;AAAA,OACF;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAA,GAAO,GAAA,YAAe,qBAAA,GAAwB,GAAA,CAAI,IAAA,GAAO,eAAA;AAC/D,MAAA,MAAM,SAAA,GAAY,GAAA,YAAe,qBAAA,GAAwB,GAAA,CAAI,SAAA,GAAY,KAAA;AACzE,MAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,MAAA,QAAA,GAAW;AAAA,QACT,IAAA,EAAM,UAAA;AAAA,QACN,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,OAAA,EAAS,KAAA;AAAA,QACT,KAAA,EAAO,EAAE,IAAA,EAAM,OAAA,EAAS,SAAA;AAAU,OACpC;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,EAAA,EAAI,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAC,CAAA;AAAA,IACxC,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEQ,WAAA,GAAoB;AAC1B,IAAA,IAAI,IAAA,CAAK,YAAY,QAAA,EAAU;AAC/B,IAAA,IAAA,CAAK,UAAU,QAAQ,CAAA;AACvB,IAAA,IAAI,KAAK,YAAA,EAAc;AACrB,MAAA,YAAA,CAAa,IAAA,CAAK,aAAa,KAAK,CAAA;AACpC,MAAA,IAAA,CAAK,YAAA,CAAa,MAAA;AAAA,QAChB,IAAI,qBAAA,CAAsB,cAAA,EAAgB,6BAA6B;AAAA,OACzE;AACA,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB;AAAA,EACF;AAAA,EAEQ,YAAY,EAAA,EAAmB;AACrC,IAAA,IAAI,KAAK,YAAA,EAAc;AACrB,MAAA,YAAA,CAAa,IAAA,CAAK,aAAa,KAAK,CAAA;AACpC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,mBAAA,CAAoB,EAAE,CAAA;AAC3C,MAAA,IAAA,CAAK,YAAA,CAAa,MAAA;AAAA,QAChB,IAAI,qBAAA,CAAsB,iBAAA,EAAmB,SAAS,EAAE,SAAA,EAAW,MAAM;AAAA,OAC3E;AACA,MAAA,IAAA,CAAK,YAAA,GAAe,IAAA;AAAA,IACtB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,UAAU,OAAO,CAAA;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,oBAAoB,EAAA,EAAqB;AAC/C,IAAA,IAAI,EAAA,IAAM,OAAO,EAAA,KAAO,QAAA,IAAY,aAAa,EAAA,EAAI;AACnD,MAAA,MAAM,IAAK,EAAA,CAA6B,OAAA;AACxC,MAAA,IAAI,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,CAAA;AAAA,IACpC;AACA,IAAA,IAAI,EAAA,YAAc,KAAA,EAAO,OAAO,EAAA,CAAG,OAAA;AACnC,IAAA,OAAO,iBAAA;AAAA,EACT;AACF;;;ACpUO,SAAS,gBAAgB,MAAA,EAA2C;AACzE,EAAA,QAAQ,OAAO,IAAA;AAAM,IACnB,KAAK,KAAA;AACH,MAAA,OAAO,IAAI,aAAa,MAAM,CAAA;AAAA,IAChC,KAAK,UAAA;AACH,MAAA,OAAO,IAAI,kBAAkB,MAAM,CAAA;AAAA,IACrC,KAAK,QAAA;AACH,MAAA,OAAO,IAAI,gBAAgB,MAAM,CAAA;AAAA,IACnC,KAAK,UAAA;AACH,MAAA,OAAO,IAAI,kBAAkB,MAAM,CAAA;AAAA,IACrC,KAAK,MAAA,EAAQ;AAIX,MAAA,MAAM,IAAA,GAAQ,MAAA,CAAO,OAAA,IAAW,EAAC;AACjC,MAAA,MAAM,QAAA,GACJ,OAAO,IAAA,CAAK,aAAA,KAAkB,aAC1B,EAAE,aAAA,EAAe,IAAA,CAAK,aAAA,EAAuB,GAC7C,MAAA;AACN,MAAA,OAAO,IAAI,oBAAA,CAAqB,MAAA,EAAQ,MAAA,EAAW,QAAQ,CAAA;AAAA,IAC7D;AAAA,IACA,SAAS;AACP,MAAA,MAAM,IAAA,GAAQ,OAA6B,IAAA,IAAQ,WAAA;AACnD,MAAA,MAAM,IAAI,qBAAA,CAAsB,mBAAA,EAAqB,CAAA,wBAAA,EAA2B,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,IACzF;AAAA;AAEJ;;;ACdA,IAAM,YAAA,GAAe,CAAC,EAAA,KACpB,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AAElD,IAAM,kBAAA,GAAqB,CAAC,GAAA,KAA0B;AACpD,EAAA,IAAI,eAAe,qBAAA,EAAuB;AACxC,IAAA,OAAO,GAAA,CAAI,SAAA;AAAA,EACb;AACA,EAAA,OAAO,IAAA;AACT,CAAA;AAEA,eAAsB,SAAA,CAAa,EAAA,EAAsB,IAAA,GAAyB,EAAC,EAAe;AAChG,EAAA,MAAM,WAAW,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,YAAY,CAAC,CAAA;AAC/C,EAAA,MAAM,OAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,UAAU,GAAG,CAAA;AAC3C,EAAA,MAAM,MAAM,IAAA,CAAK,GAAA,CAAI,IAAA,EAAM,IAAA,CAAK,cAAc,GAAK,CAAA;AACnD,EAAA,MAAM,WAAA,GAAc,KAAK,WAAA,IAAe,kBAAA;AACxC,EAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,IAAS,YAAA;AAE5B,EAAA,IAAI,OAAA;AACJ,EAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,QAAA,EAAU,OAAA,EAAA,EAAW;AACpD,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,EAAA,EAAG;AAAA,IAClB,SAAS,GAAA,EAAK;AACZ,MAAA,OAAA,GAAU,GAAA;AACV,MAAA,IAAI,YAAY,QAAA,IAAY,CAAC,WAAA,CAAY,GAAA,EAAK,OAAO,CAAA,EAAG;AACtD,QAAA,MAAM,GAAA;AAAA,MACR;AACA,MAAA,MAAM,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,GAAO,CAAA,KAAM,UAAU,CAAA,CAAE,CAAA;AACrD,MAAA,MAAM,MAAM,KAAK,CAAA;AAAA,IACnB;AAAA,EACF;AAEA,EAAA,MAAM,OAAA;AACR;;;AC1CA,IAAM,kBAAA,GAAqB,CAAC,GAAA,KAA0B;AACpD,EAAA,IAAI,eAAe,qBAAA,EAAuB;AACxC,IAAA,OAAO,qBAAA,CAAsB,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AAAA,EAC5C;AACA,EAAA,MAAM,SAAU,GAAA,EAAqC,MAAA;AACrD,EAAA,IAAI,MAAA,KAAW,KAAK,OAAO,IAAA;AAC3B,EAAA,MAAM,OAAQ,GAAA,EAAmC,IAAA;AACjD,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,sBAAsB,IAAA,CAAK,IAAI,GAAG,OAAO,IAAA;AACzE,EAAA,OAAO,KAAA;AACT,CAAA;AAEA,eAAsB,eAAA,CACpB,EAAA,EACA,OAAA,EACA,IAAA,GAA+B,EAAC,EACpB;AACZ,EAAA,MAAM,WAAA,GAAc,KAAK,WAAA,IAAe,kBAAA;AACxC,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,EAAA,EAAG;AAAA,EAClB,SAAS,GAAA,EAAK;AACZ,IAAA,IAAI,CAAC,WAAA,CAAY,GAAG,CAAA,EAAG,MAAM,GAAA;AAC7B,IAAA,MAAM,OAAA,EAAQ;AACd,IAAA,OAAO,EAAA,EAAG;AAAA,EACZ;AACF;;;ACZA,IAAM,eAAA,uBAAsB,GAAA,CAAI;AAAA,EAC9B,QAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAC,CAAA;AAID,SAAS,UAAU,KAAA,EAAoD;AACrE,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,KAAA,KAAU,MAAA,EAAW,OAAO,IAAA;AAClD,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,IAAI,CAAC,eAAA,CAAgB,GAAA,CAAI,KAAK,CAAA,EAAG;AAG/B,MAAA,OAAO,EAAE,MAAM,KAAA,EAAM;AAAA,IACvB;AACA,IAAA,OAAO,EAAE,MAAM,KAAA,EAAM;AAAA,EACvB;AACA,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,OAAO,EAAE,GAAG,KAAA,EAAM;AAAA,EACpB;AACA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,cACd,KAAA,EACyB;AACzB,EAAA,MAAM,aAAsD,EAAC;AAC7D,EAAA,MAAM,WAAqB,EAAC;AAC5B,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC9C,IAAA,MAAM,UAAA,GAAa,UAAU,GAAG,CAAA;AAChC,IAAA,IAAI,CAAC,UAAA,EAAY;AACjB,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,IAAA,EAAK,GAAI,UAAA;AAG9B,IAAA,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA;AAClB,IAAA,IAAI,aAAa,IAAA,EAAM;AACrB,MAAA,QAAA,CAAS,KAAK,GAAG,CAAA;AAAA,IACnB;AAAA,EACF;AACA,EAAA,MAAM,MAAA,GAAkC;AAAA,IACtC,IAAA,EAAM,QAAA;AAAA,IACN,UAAA;AAAA,IACA,oBAAA,EAAsB;AAAA,GACxB;AACA,EAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AACvB,IAAA,MAAA,CAAO,UAAU,CAAA,GAAI,QAAA;AAAA,EACvB;AACA,EAAA,OAAO,MAAA;AACT;;;ACDA,SAAS,oBAAoB,IAAA,EAAsC;AACjE,EAAA,OAAO,IAAA,CAAK,SAAS,iBAAiB,CAAA;AACxC;AAQA,eAAsB,iBAAiB,IAAA,EAIpB;AACjB,EAAA,MAAM,QAAA,GAAiC;AAAA,IACrC,eAAA,EAAiB,CAAA;AAAA,IACjB,UAAU,IAAA,CAAK,QAAA;AAAA,IACf,OAAA,EAAS,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MAChC,IAAI,CAAA,CAAE,EAAA;AAAA,MACN,aAAa,CAAA,CAAE,WAAA;AAAA,MACf,SAAA,EAAW,EAAE,SAAA,IAAa;AAAA,KAC5B,CAAE;AAAA,GACJ;AACA,EAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAC;AAAA,CAAI,CAAA;AACpD,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EAC7B,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AAUA,eAAsB,qBAAqB,IAAA,EAAmD;AAC5F,EAAA,MAAM,OAAO,IAAA,CAAK,IAAA,IAAQ,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC9C,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,QAAA,CAAS,EAAA;AAE9C,EAAA,IAAI,mBAAA,CAAoB,IAAI,CAAA,EAAG;AAC7B,IAAA,MAAM,gBAAA,CAAiB;AAAA,MACrB,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,SAAS,IAAA,CAAK;AAAA,KACf,CAAA;AAED,IAAA,MAAM,IAAI,MAAM,aAAa,CAAA;AAAA,EAC/B;AAEA,EAAA,MAAM,IAAA,CAAK,UAAU,KAAA,EAAM;AAS3B,EAAA,MAAM,WAAA,GAAc,SAAA,CAAU,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAC,CAAA;AACzD,EAAA,IAAI,eAAe,IAAA,EAAM;AACvB,IAAA,MAAM,mBAAA,CAAoB,IAAA,CAAK,SAAA,EAAW,WAAA,EAAa,OAAO,CAAA;AAAA,EAChE;AAEA,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,IACb,CAAA,CAAA,EAAI,OAAO,CAAA,mBAAA,EAAsB,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAClD,WAAA,IAAe,IAAA,GAAO,CAAA,OAAA,EAAU,WAAW,CAAA,CAAA,GAAK,EAClD,CAAA;AAAA;AAAA,GACF;AAEA,EAAA,MAAM,QAAA,GAAW,OAAO,MAAA,KAA2C;AACjE,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,CAAA,EAAI,OAAO,cAAc,MAAM,CAAA;AAAA,CAA0B,CAAA;AAC9E,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,IAC7B,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,CAAA,EAAI,OAAO,kBAAkB,GAAG;AAAA,CAAI,CAAA;AAAA,IAC3D;AACA,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAAA,EAChB,CAAA;AACA,EAAA,OAAA,CAAQ,EAAA,CAAG,QAAA,EAAU,CAAC,CAAA,KAAM;AAC1B,IAAA,KAAK,SAAS,CAAC,CAAA;AAAA,EACjB,CAAC,CAAA;AACD,EAAA,OAAA,CAAQ,EAAA,CAAG,SAAA,EAAW,CAAC,CAAA,KAAM;AAC3B,IAAA,KAAK,SAAS,CAAC,CAAA;AAAA,EACjB,CAAC,CAAA;AAGD,EAAA,OAAO,IAAI,QAAe,MAAM;AAAA,EAEhC,CAAC,CAAA;AACH;AAEA,SAAS,UAAU,GAAA,EAAwC;AACzD,EAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AACjB,EAAA,MAAM,CAAA,GAAI,OAAO,GAAG,CAAA;AACpB,EAAA,OAAO,MAAA,CAAO,UAAU,CAAC,CAAA,IAAK,IAAI,CAAA,IAAK,CAAA,GAAI,QAAS,CAAA,GAAI,IAAA;AAC1D;AAgBA,eAAe,mBAAA,CACb,SAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,MAAM,IAAA,GAAO,MAAM,OAAO,MAAW,CAAA;AACrC,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,YAAA,CAAa,CAAC,KAAK,GAAA,KAAQ;AAC7C,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,KAAA,IAAS,GAAA,CAAI,QAAQ,SAAA,EAAW;AACjD,MAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,MAAA,GAAA,CAAI,IAAI,IAAA,CAAK,SAAA,CAAU,EAAE,EAAA,EAAI,IAAA,EAAM,CAAC,CAAA;AACpC,MAAA;AAAA,IACF;AACA,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,MAAA,IAAU,GAAA,CAAI,QAAQ,WAAA,EAAa;AACpD,MAAA,IAAI,IAAA,GAAO,EAAA;AACX,MAAA,GAAA,CAAI,YAAY,MAAM,CAAA;AACtB,MAAA,GAAA,CAAI,EAAA,CAAG,MAAA,EAAQ,CAAC,KAAA,KAAkB;AAChC,QAAA,IAAA,IAAQ,KAAA;AAER,QAAA,IAAI,IAAA,CAAK,MAAA,GAAS,EAAA,GAAK,IAAA,GAAO,IAAA,EAAM;AAClC,UAAA,GAAA,CAAI,OAAA,EAAQ;AAAA,QACd;AAAA,MACF,CAAC,CAAA;AACD,MAAA,GAAA,CAAI,EAAA,CAAG,OAAO,MAAM;AAClB,QAAA,IAAI,MAAA;AACJ,QAAA,IAAI;AACF,UAAA,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,IAAA,IAAQ,IAAI,CAAA;AAAA,QAClC,SAAS,GAAA,EAAK;AACZ,UAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,CAAA,kBAAA,EAAqB,GAAG,CAAA,CAAA,EAAI,CAAC,CAAA;AAC7E,UAAA;AAAA,QACF;AACA,QAAA,MAAM,SAAS,OAAO,MAAA,CAAO,MAAA,KAAW,QAAA,GAAW,OAAO,MAAA,GAAS,EAAA;AACnE,QAAA,IAAI,CAAC,MAAA,EAAQ;AACX,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,SAAS,KAAA,EAAO,KAAA,EAAO,gCAAA,EAAkC,CAAC,CAAA;AACnF,UAAA;AAAA,QACF;AACA,QAAA,SAAA,CACG,SAAS,MAAA,EAAQ,MAAA,CAAO,MAAM,CAAA,CAC9B,IAAA,CAAK,CAAC,MAAA,KAAW;AAChB,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,SAAS,IAAA,EAAM,IAAA,EAAM,MAAA,EAAQ,CAAC,CAAA;AAAA,QACzD,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,GAAA,KAAiB;AACvB,UAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,SAAS,KAAA,EAAO,KAAA,EAAO,GAAA,EAAK,CAAC,CAAA;AAAA,QACxD,CAAC,CAAA;AAAA,MACL,CAAC,CAAA;AACD,MAAA,GAAA,CAAI,EAAA,CAAG,SAAS,MAAM;AAGpB,QAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,CAAA,EAAI,OAAO,CAAA;AAAA,CAAmC,CAAA;AAAA,MACrE,CAAC,CAAA;AACD,MAAA;AAAA,IACF;AACA,IAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,IAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,SAAS,KAAA,EAAO,KAAA,EAAO,WAAA,EAAa,CAAC,CAAA;AAAA,EAChE,CAAC,CAAA;AAED,EAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC3C,IAAA,MAAA,CAAO,IAAA,CAAK,SAAS,MAAM,CAAA;AAC3B,IAAA,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,WAAA,EAAa,MAAM;AACrC,MAAA,MAAA,CAAO,cAAA,CAAe,SAAS,MAAM,CAAA;AACrC,MAAA,OAAA,EAAQ;AAAA,IACV,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.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 * uiBridgeBase?: string; forwardConsole?: boolean }`\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 constructor(\n code: string,\n message: string,\n options: { retryable?: boolean; cause?: 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 }\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 * ApiTransport\n *\n * The thinnest of the four transports. It carries no I/O of its own — all\n * it does is hold a `HandlerRegistry`, go `ready` immediately, and route\n * dispatches through the registry. Wrappers that target a remote API\n * (REST, GraphQL, gRPC, SDK…) put their `fetch` / SDK calls inside the\n * registered handlers.\n *\n * For compatibility with the spec, `TransportConfig.options.handler` is\n * honored as a fallback for unregistered action ids.\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';\n\n/**\n * Context shape passed to api-transport handlers. Empty by default; wrappers\n * can cast `ctx as ApiContext & { mySdk }` if they stash shared state on the\n * transport instance.\n */\nexport interface ApiContext {\n readonly kind: 'api';\n}\n\n/** Catch-all fallback handler signature, used for `options.handler` support. */\nexport type ApiFallbackHandler = (actionId: string, params?: unknown) => unknown | Promise<unknown>;\n\nexport class ApiTransport extends BaseTransport {\n readonly kind: WrapperTransportKind = 'api';\n private readonly fallback?: ApiFallbackHandler;\n\n constructor(config: TransportConfig = { kind: 'api' }, registry?: HandlerRegistry) {\n super(registry);\n const handler = (config.options as { handler?: unknown } | undefined)?.handler;\n if (typeof handler === 'function') {\n this.fallback = handler as ApiFallbackHandler;\n }\n }\n\n protected async onReady(): Promise<void> {\n // Nothing to warm up.\n }\n\n protected async onClose(): Promise<void> {\n // Nothing to tear down.\n }\n\n protected async buildContext(): Promise<ApiContext> {\n return { kind: 'api' };\n }\n\n /**\n * Override dispatch to fall back to `options.handler` when no explicit\n * registration exists for `actionId`.\n */\n async dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult> {\n await this.ready();\n if (this.registry.has(actionId)) {\n const ctx = await this.buildContext();\n return this.registry.dispatch<TResult>(actionId, params, ctx);\n }\n if (this.fallback) {\n try {\n return (await this.fallback(actionId, params)) 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 throw new WrapperTransportError('NO_HANDLER', `No handler registered for action '${actionId}'`);\n }\n}\n","/**\n * HeadlessTransport\n *\n * Wraps `@qontinui/ui-bridge-headless`'s `launchHeadlessTab` to own a\n * Playwright Chromium lifecycle. The transport's job is lifecycle only:\n *\n * - Launch the browser on `ready()` and navigate to `options.targetUrl`.\n * - Expose the `page` / `context` / `browser` via a `HeadlessContext`\n * that each handler receives.\n * - Close everything on `close()`.\n *\n * Action code lives in the wrapper's handler registrations, not in the\n * transport. Headless and headed differ only in the `headless` flag.\n */\n\nimport type { Browser, BrowserContext, Page } from 'playwright';\nimport { BaseTransport } from '../base-transport.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig, WrapperTransportKind } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\n\n/** Options extracted from `TransportConfig.options` for headless/headed. */\nexport interface HeadlessTransportOptions {\n /** URL to navigate to on first `ready()`. Required. */\n targetUrl: string;\n /** Viewport width in px. Defaults to 1280. */\n viewportWidth?: number;\n /** Viewport height in px. Defaults to 720. */\n viewportHeight?: number;\n /**\n * UI Bridge relay base URL. If provided, `ready()` blocks until the relay\n * confirms the tab registered. Mirrors `launchHeadlessTab` behavior.\n */\n uiBridgeBase?: string;\n /** Max time to wait for UI Bridge registration. Defaults to 30 000. */\n waitForUiBridgeMs?: number;\n /** User agent override. */\n userAgent?: string;\n /** Forward browser console/page errors to the Node process stderr. */\n forwardConsole?: boolean;\n}\n\n/** Context shape delivered to each headless/headed handler. */\nexport interface HeadlessContext {\n readonly kind: 'headless' | 'headed' | 'injected';\n readonly page: Page;\n readonly browserContext: BrowserContext;\n readonly browser: Browser;\n /** True once the UI Bridge relay confirmed the tab is registered. */\n readonly uiBridgeRegistered: boolean;\n /** Relay-assigned tab id, when known. */\n readonly tabId: string | null;\n}\n\n/**\n * Shared implementation used by both `HeadlessTransport` and\n * `HeadedTransport` — they differ only in the `headless` launch flag and\n * their reported `kind`.\n */\nexport class HeadlessTransport extends BaseTransport {\n readonly kind: WrapperTransportKind;\n protected readonly options: HeadlessTransportOptions;\n protected readonly headless: boolean;\n\n protected tab: {\n browser: Browser;\n context: BrowserContext;\n page: Page;\n uiBridgeRegistered: boolean;\n tabId: string | null;\n close: () => Promise<void>;\n } | null = null;\n\n constructor(\n config: TransportConfig,\n registry?: HandlerRegistry,\n overrides: { kind?: WrapperTransportKind; headless?: boolean } = {}\n ) {\n super(registry);\n this.kind = overrides.kind ?? 'headless';\n this.headless = overrides.headless ?? true;\n this.options = this.parseOptions(config);\n }\n\n private parseOptions(config: TransportConfig): HeadlessTransportOptions {\n const raw = (config.options ?? {}) as Record<string, unknown>;\n const targetUrl = raw['targetUrl'];\n if (typeof targetUrl !== 'string' || targetUrl.length === 0) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind '${this.kind}' requires options.targetUrl (string)`\n );\n }\n return {\n targetUrl,\n viewportWidth:\n typeof raw['viewportWidth'] === 'number' ? (raw['viewportWidth'] as number) : undefined,\n viewportHeight:\n typeof raw['viewportHeight'] === 'number' ? (raw['viewportHeight'] as number) : undefined,\n uiBridgeBase:\n typeof raw['uiBridgeBase'] === 'string' ? (raw['uiBridgeBase'] as string) : undefined,\n waitForUiBridgeMs:\n typeof raw['waitForUiBridgeMs'] === 'number'\n ? (raw['waitForUiBridgeMs'] as number)\n : undefined,\n userAgent: typeof raw['userAgent'] === 'string' ? (raw['userAgent'] as string) : undefined,\n forwardConsole:\n typeof raw['forwardConsole'] === 'boolean' ? (raw['forwardConsole'] as boolean) : undefined,\n };\n }\n\n protected async onReady(): Promise<void> {\n // Lazy-import so api-only wrappers that never build the headless transport\n // don't pay the Playwright resolution cost. `@qontinui/ui-bridge-headless`\n // is an OPTIONAL peer (package.json peerDependenciesMeta), so the import is\n // NOT guaranteed resolvable — a bare `npx @qontinui/ui-bridge-wrapper …`\n // does not install peers. Catch the resolution failure and surface an\n // actionable install hint instead of a raw ERR_MODULE_NOT_FOUND.\n let launchHeadlessTab: typeof import('@qontinui/ui-bridge-headless')['launchHeadlessTab'];\n try {\n ({ launchHeadlessTab } = await import('@qontinui/ui-bridge-headless'));\n } catch (err) {\n const cause = err instanceof Error ? err.message : String(err);\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind '${this.kind}' needs the optional '@qontinui/ui-bridge-headless' ` +\n `peer, which is not installed. Install it and the Chromium browser:\\n` +\n ` npm i @qontinui/ui-bridge-headless && npx playwright install chromium\\n` +\n `(bare \\`npx @qontinui/ui-bridge-wrapper …\\` does NOT install peers — pass each ` +\n `peer with \\`-p\\`, e.g.\\n` +\n ` npx -y -p @qontinui/ui-bridge-wrapper -p @qontinui/ui-bridge -p @qontinui/ui-bridge-headless -p playwright ui-bridge-login-web …)\\n` +\n `Underlying import error: ${cause}`\n );\n }\n\n // Subclasses (injected) supply init-scripts to run before first paint.\n const initScripts = await this.buildInitScripts();\n\n const tab = await launchHeadlessTab({\n url: this.options.targetUrl,\n headless: this.headless,\n uiBridgeBase: this.options.uiBridgeBase,\n waitForUiBridgeMs: this.options.waitForUiBridgeMs,\n viewportWidth: this.options.viewportWidth,\n viewportHeight: this.options.viewportHeight,\n userAgent: this.options.userAgent,\n forwardConsole: this.options.forwardConsole,\n initScripts: initScripts.length > 0 ? initScripts : undefined,\n });\n\n this.tab = {\n browser: tab.browser,\n context: tab.context,\n page: tab.page,\n uiBridgeRegistered: tab.uiBridgeRegistered,\n tabId: tab.tabId,\n close: tab.close,\n };\n\n // Subclass hook: block until the page-side runtime is ready (e.g. the\n // injected bundle reports `window.__uiBridgeInjected.ready === true`).\n await this.afterLaunch(tab.page);\n }\n\n /**\n * Subclass hook: init-scripts to register on the browser context before the\n * first navigation (via `context.addInitScript`). Default: none. Injected\n * mode overrides this to inject the config + runtime bundle pre-paint.\n */\n protected async buildInitScripts(): Promise<string[]> {\n return [];\n }\n\n /**\n * Subclass hook: run after launch + navigation, before `ready()` resolves.\n * Default: no-op. Injected mode overrides it to await the in-page runtime.\n */\n protected async afterLaunch(_page: Page): Promise<void> {\n // no-op for headless/headed\n }\n\n protected async onClose(): Promise<void> {\n if (!this.tab) return;\n const t = this.tab;\n this.tab = null;\n await t.close();\n }\n\n protected async buildContext(): Promise<HeadlessContext> {\n if (!this.tab) {\n throw new WrapperTransportError(\n 'NOT_READY',\n `Transport '${this.kind}' is not ready; call ready() before dispatch`\n );\n }\n return {\n kind: this.kind as 'headless' | 'headed',\n page: this.tab.page,\n browserContext: this.tab.context,\n browser: this.tab.browser,\n uiBridgeRegistered: this.tab.uiBridgeRegistered,\n tabId: this.tab.tabId,\n };\n }\n}\n","/**\n * HeadedTransport\n *\n * Identical to `HeadlessTransport` except the browser is launched visibly.\n * Kept as its own class so wrappers and docs can refer to the transport\n * kind directly, and so future divergence (e.g. devtools-auto-open for\n * headed) doesn't require refactoring the shared parent.\n */\n\nimport { HeadlessTransport } from './headless.js';\nimport type { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig } from '../types.js';\n\nexport class HeadedTransport extends HeadlessTransport {\n constructor(config: TransportConfig, registry?: HandlerRegistry) {\n super(config, registry, { kind: 'headed', headless: false });\n }\n}\n","/**\n * InjectedTransport\n *\n * The fourth-and-a-half delivery mode: drive UI Bridge's **semantic**\n * automation (find / act / snapshot / assert) against a page that ships\n * **zero** UI Bridge code, by injecting the engine bundle at automation time.\n *\n * Subclasses {@link HeadlessTransport} to reuse the Chromium launch/close\n * lifecycle. It differs in exactly two ways (plan §3.1):\n * 1. it injects `@qontinui/ui-bridge`'s `dist/injected/bundle.global.js`\n * (plus an optional relay-config sibling) as init-scripts BEFORE first\n * paint, so `window.__uiBridgeInjected` exists before the page's own\n * scripts run;\n * 2. `buildContext()` returns an {@link InjectedContext} exposing semantic\n * methods backed by the in-page runtime via `page.evaluate`, instead of\n * the raw Playwright `page`.\n *\n * The production page is unchanged — nothing is shipped onto the real site;\n * the control surface exists only inside the browser this transport launched\n * (plan §3.6). When `options.uiBridgeBase` is set, the injected runtime also\n * registers as a relay tab (Variant B) so existing orchestrators drive it\n * through the same `/control/*` plane as embedded apps.\n */\n\nimport { createRequire } from 'node:module';\nimport { readFileSync } from 'node:fs';\nimport type { Page } from 'playwright';\nimport { HeadlessTransport, type HeadlessContext } from './headless.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\n\nconst require = createRequire(import.meta.url);\n\n/** Lazily-loaded, cached injected runtime bundle (the IIFE text). */\nlet cachedBundle: string | null = null;\n\n/** Resolve + read `@qontinui/ui-bridge`'s injected runtime IIFE bundle. */\nfunction loadInjectedBundle(): string {\n if (cachedBundle !== null) return cachedBundle;\n let bundlePath: string;\n try {\n bundlePath = require.resolve('@qontinui/ui-bridge/injected/bundle.global.js');\n } catch {\n // Fallback for resolvers that don't honor the subpath export: locate the\n // package root via its package.json and join the dist path.\n const pkgJson = require.resolve('@qontinui/ui-bridge/package.json');\n bundlePath = pkgJson.replace(/package\\.json$/, 'dist/injected/bundle.global.js');\n }\n try {\n cachedBundle = readFileSync(bundlePath, 'utf8');\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_BUNDLE_MISSING',\n `Could not read the UI Bridge injected runtime bundle at '${bundlePath}'. ` +\n `Ensure @qontinui/ui-bridge is built (the IIFE is emitted by its tsup build).`,\n { cause }\n );\n }\n return cachedBundle;\n}\n\n/** Injected-specific options parsed from `TransportConfig.options`. */\ninterface InjectedExtraOptions {\n /** Launch with a visible window (debugging). Default false (headless). */\n headed: boolean;\n /** Max ms to wait for `window.__uiBridgeInjected.ready`. Default 30000. */\n readyTimeoutMs: number;\n /**\n * Whether `ready()` waits for the in-page runtime to report `settled` (DOM\n * quiet after content appeared), not merely `ready` (runtime live, registry\n * possibly still empty on a client-rendered SPA). Default true — this is the\n * fix that lets a driver snapshot immediately after `ready()` without polling\n * through hydration. Set false to revert to ready-only gating.\n */\n waitForSettle: boolean;\n /** Quiet window (ms) before the runtime declares itself settled. Default 500. */\n settleQuietMs?: number;\n /** Hard cap (ms) after which the runtime settles regardless. Default 10000. */\n settleTimeoutMs?: number;\n /**\n * CSS selector that must match before the DOM counts as settled. Without it,\n * settle fires on any content going quiet — which can be unrelated chrome that\n * paints before a lazily-mounted target control. With it, `ready()` waits for\n * the TARGET; and if the selector never matches before the settle cap,\n * `afterLaunch` throws `INJECTED_EXPECT_SELECTOR_UNMET` instead of returning a\n * page that's missing the control.\n */\n expectSelector?: string;\n /** Bearer token for the auth-gated relay (Variant B). */\n authToken?: string;\n /** Strict per-user tab-scoping metadata for relay heartbeats (Variant B). */\n registrationMetadata?: { userId: string; sessionId: string };\n /** App id reported to the relay registry (Variant B). */\n appId?: string;\n /** Display name reported to the relay registry (Variant B). */\n appName?: string;\n /** Stable per-tab id override (Variant B). */\n tabId?: string;\n}\n\n/** In-page settle state surfaced by {@link InjectedContext.settleState}/`whenSettled`. */\nexport interface InjectedSettleState {\n /** True once the DOM has settled (gated quiet window, or the hard cap). */\n settled: boolean;\n /** Interactive elements registered as of the most recent seed pass. */\n elementCount: number;\n /** True when settle was forced by the cap rather than a clean quiet window. */\n settledByTimeout: boolean;\n /** Whether the gating condition (content / expectSelector) was met. */\n expectSatisfied: boolean;\n}\n\n/**\n * Semantic context delivered to each injected handler. Extends\n * {@link HeadlessContext} (so drivers still get the raw `page` / `browser` /\n * `browserContext` handles for lower-level access) and adds the semantic\n * surface. `execute` is the generic escape hatch (any relay action id); the\n * named methods are typed conveniences over the most common ones. All run in\n * the page realm via `page.evaluate(window.__uiBridgeInjected.execute(...))`.\n */\nexport interface InjectedContext extends HeadlessContext {\n readonly kind: 'injected';\n /** True once the injected runtime reported ready (always true post-`ready()`). */\n readonly ready: boolean;\n /**\n * Re-read the in-page runtime's current settle state. After `ready()` with\n * the default `waitForSettle`, this is already `settled: true`; it's exposed\n * for drivers that disabled settle-gating or want the live element count.\n * `settledByTimeout` + `expectSatisfied: false` means the gate never met.\n */\n settleState(): Promise<InjectedSettleState>;\n /**\n * Wait for the in-page runtime to report settled (DOM quiet after content),\n * or `timeoutMs`. Useful after a soft-navigation re-render when the caller\n * wants to re-settle before the next assertion.\n */\n whenSettled(timeoutMs?: number): Promise<InjectedSettleState>;\n /** Run any relay action against the in-page runtime. */\n execute<T = unknown>(action: string, payload?: unknown): Promise<T>;\n /** Semantic find — by label / text / role / type / testId. */\n find(criteria?: Record<string, unknown>): Promise<unknown>;\n /** Act on an element by registry id: `{ action: 'click' | 'type' | ... }`. */\n act(id: string, request: Record<string, unknown>): Promise<unknown>;\n /** Read the interactive-element control snapshot. */\n snapshot(options?: Record<string, unknown>): Promise<unknown>;\n /** Assert a user-visible outcome (NL `{assertion}` or `{target,type,expected}`). */\n assert(spec: Record<string, unknown>): Promise<unknown>;\n}\n\nexport class InjectedTransport extends HeadlessTransport {\n private readonly injected: InjectedExtraOptions;\n\n constructor(config: TransportConfig, registry?: HandlerRegistry) {\n const raw = (config.options ?? {}) as Record<string, unknown>;\n const headed = raw['headed'] === true;\n super(config, registry, { kind: 'injected', headless: !headed });\n this.injected = {\n headed,\n readyTimeoutMs:\n typeof raw['readyTimeoutMs'] === 'number' ? (raw['readyTimeoutMs'] as number) : 30_000,\n waitForSettle: raw['waitForSettle'] !== false,\n settleQuietMs:\n typeof raw['settleQuietMs'] === 'number' ? (raw['settleQuietMs'] as number) : undefined,\n settleTimeoutMs:\n typeof raw['settleTimeoutMs'] === 'number' ? (raw['settleTimeoutMs'] as number) : undefined,\n expectSelector:\n typeof raw['expectSelector'] === 'string' && (raw['expectSelector'] as string).length > 0\n ? (raw['expectSelector'] as string)\n : undefined,\n authToken: typeof raw['authToken'] === 'string' ? (raw['authToken'] as string) : undefined,\n registrationMetadata: isRegistrationMetadata(raw['registrationMetadata'])\n ? (raw['registrationMetadata'] as { userId: string; sessionId: string })\n : undefined,\n appId: typeof raw['appId'] === 'string' ? (raw['appId'] as string) : undefined,\n appName: typeof raw['appName'] === 'string' ? (raw['appName'] as string) : undefined,\n tabId: typeof raw['tabId'] === 'string' ? (raw['tabId'] as string) : undefined,\n };\n }\n\n /**\n * Build the `__uiBridgeInjectedConfig` injected ahead of the bundle, or null\n * if there's nothing to configure. Carries the relay fields (Variant B only,\n * when `uiBridgeBase` is set) AND the settle-tuning fields (both variants).\n */\n private injectedConfig(): Record<string, unknown> | null {\n const cfg: Record<string, unknown> = {};\n const base = this.options.uiBridgeBase;\n if (base) {\n cfg.uiBridgeBase = base;\n if (this.injected.authToken) cfg.authToken = this.injected.authToken;\n if (this.injected.registrationMetadata)\n cfg.registrationMetadata = this.injected.registrationMetadata;\n if (this.injected.appId) cfg.appId = this.injected.appId;\n if (this.injected.appName) cfg.appName = this.injected.appName;\n if (this.injected.tabId) cfg.tabId = this.injected.tabId;\n }\n if (this.injected.settleQuietMs !== undefined)\n cfg.settleQuietMs = this.injected.settleQuietMs;\n if (this.injected.settleTimeoutMs !== undefined)\n cfg.settleTimeoutMs = this.injected.settleTimeoutMs;\n if (this.injected.expectSelector !== undefined)\n cfg.expectSelector = this.injected.expectSelector;\n return Object.keys(cfg).length > 0 ? cfg : null;\n }\n\n protected override async buildInitScripts(): Promise<string[]> {\n const scripts: string[] = [];\n // Config first so it exists when the bundle's init-script runs.\n const cfg = this.injectedConfig();\n if (cfg) {\n scripts.push(`window.__uiBridgeInjectedConfig = ${JSON.stringify(cfg)};`);\n }\n scripts.push(loadInjectedBundle());\n return scripts;\n }\n\n protected override async afterLaunch(page: Page): Promise<void> {\n // Resolve `ready()` only once the in-page runtime reports ready\n // (success criterion 1). The bundle flips `ready` after seeding the\n // registry on DOM-ready.\n try {\n await page.waitForFunction(\n () =>\n (window as unknown as { __uiBridgeInjected?: { ready?: boolean } }).__uiBridgeInjected\n ?.ready === true,\n undefined,\n { timeout: this.injected.readyTimeoutMs }\n );\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_RUNTIME_NOT_READY',\n `The injected UI Bridge runtime did not report ready within ` +\n `${this.injected.readyTimeoutMs}ms. The bundle may have failed to ` +\n `evaluate (check page console / CSP) or the page never reached DOMContentLoaded.`,\n { cause, retryable: true }\n );\n }\n\n // Then wait for the DOM to SETTLE (content painted + quiet) so the driver\n // can snapshot immediately after ready() without polling through SPA\n // hydration. The runtime always settles eventually (its own hard cap), so\n // this resolves the in-page `whenSettled()` rather than racing a Playwright\n // poll; we still bound the outer wait by readyTimeoutMs as a backstop in\n // case the page realm wedged.\n if (this.injected.waitForSettle) {\n let state: {\n settled: boolean;\n settledByTimeout: boolean;\n expectSatisfied: boolean;\n elementCount: number;\n };\n try {\n await page.waitForFunction(\n () =>\n (\n window as unknown as { __uiBridgeInjected?: { settled?: boolean } }\n ).__uiBridgeInjected?.settled === true,\n undefined,\n { timeout: this.injected.readyTimeoutMs }\n );\n state = await page.evaluate(() => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n settled?: boolean;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n elementCount?: number;\n };\n }\n ).__uiBridgeInjected;\n return {\n settled: api?.settled === true,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n elementCount: api?.elementCount ?? 0,\n };\n });\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_RUNTIME_NOT_SETTLED',\n `The injected UI Bridge runtime did not report settled within ` +\n `${this.injected.readyTimeoutMs}ms. The page kept mutating past its ` +\n `settle cap, or the realm was torn down. Pass options.waitForSettle=false ` +\n `to gate on ready only, or raise options.settleTimeoutMs / readyTimeoutMs.`,\n { cause, retryable: true }\n );\n }\n\n // The runtime settled, but distinguish a clean settle from \"the cap fired\n // while the gating condition was still unmet\". With an expectSelector that\n // means the target control never appeared; without one it means the page\n // stayed empty. Either way the page is NOT drivable — surface it as a\n // structured error rather than handing back a control-less page that the\n // caller would mis-read as a clean snapshot.\n if (state.settledByTimeout && !state.expectSatisfied) {\n const sel = this.injected.expectSelector;\n throw new WrapperTransportError(\n 'INJECTED_EXPECT_SELECTOR_UNMET',\n sel\n ? `The injected runtime settled at its cap without the expected control ` +\n `(selector '${sel}') appearing — ${state.elementCount} element(s) were ` +\n `registered, but none matched. The control may mount slower than the ` +\n `settle cap (raise options.settleTimeoutMs), the selector may be wrong, ` +\n `or the inject failed. Treat as BLOCKED/UNVERIFIED, not a clean page.`\n : `The injected runtime settled at its cap with an empty registry ` +\n `(0 elements). The page never rendered interactive content within ` +\n `the settle cap, or the inject failed. Raise options.settleTimeoutMs ` +\n `for a slow page; otherwise treat as BLOCKED/UNVERIFIED.`,\n { retryable: true }\n );\n }\n }\n }\n\n protected override async buildContext(): Promise<InjectedContext> {\n if (!this.tab) {\n throw new WrapperTransportError(\n 'NOT_READY',\n `Transport 'injected' is not ready; call ready() before dispatch`\n );\n }\n const { page, context: browserContext, browser, uiBridgeRegistered, tabId } = this.tab;\n\n const execute = <T = unknown>(action: string, payload?: unknown): Promise<T> =>\n page.evaluate(\n (args: [string, unknown]) =>\n (\n window as unknown as {\n __uiBridgeInjected: { execute(a: string, p?: unknown): Promise<unknown> };\n }\n ).__uiBridgeInjected.execute(args[0], args[1]),\n [action, payload] as [string, unknown]\n ) as Promise<T>;\n\n const settleState = (): Promise<InjectedSettleState> =>\n page.evaluate(() => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n settled?: boolean;\n elementCount?: number;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n };\n }\n ).__uiBridgeInjected;\n return {\n settled: api?.settled === true,\n elementCount: api?.elementCount ?? 0,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n };\n });\n\n const whenSettled = (timeoutMs?: number): Promise<InjectedSettleState> =>\n page.evaluate(\n (ms: number | null) => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n whenSettled?: (t?: number) => Promise<{\n settled: boolean;\n elementCount: number;\n settledByTimeout: boolean;\n expectSatisfied: boolean;\n }>;\n settled?: boolean;\n elementCount?: number;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n };\n }\n ).__uiBridgeInjected;\n if (api?.whenSettled) return api.whenSettled(ms ?? undefined);\n return Promise.resolve({\n settled: api?.settled === true,\n elementCount: api?.elementCount ?? 0,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n });\n },\n (timeoutMs ?? null) as number | null\n );\n\n return {\n kind: 'injected',\n page,\n browserContext,\n browser,\n uiBridgeRegistered,\n ready: true,\n tabId,\n settleState,\n whenSettled,\n execute,\n find: (criteria?: Record<string, unknown>) => execute('find', criteria ?? {}),\n act: (id: string, request: Record<string, unknown>) =>\n execute('executeElementAction', { id, request }),\n snapshot: (options?: Record<string, unknown>) => execute('getControlSnapshot', options ?? {}),\n assert: (spec: Record<string, unknown>) => execute('aiAssert', spec),\n };\n }\n}\n\nfunction isRegistrationMetadata(value: unknown): boolean {\n if (!value || typeof value !== 'object') return false;\n const v = value as Record<string, unknown>;\n return typeof v.userId === 'string' && typeof v.sessionId === 'string';\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';\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 /** Capability strings forwarded to `app_registry` (informational). */\n capabilities?: string[];\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 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 if (this.opts.capabilities !== undefined) frame.capabilities = this.opts.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 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","/**\n * `createTransport` factory\n *\n * Pulls the transport class out of `TransportConfig.kind` and wires it up.\n * Kept as a separate module so tree-shaking can drop unused transports\n * (e.g. an api-only wrapper won't bundle headless / live code paths if the\n * user imports `ApiTransport` directly instead of routing through\n * `createTransport`).\n */\n\nimport { ApiTransport } from './transports/api.js';\nimport { HeadlessTransport } from './transports/headless.js';\nimport { HeadedTransport } from './transports/headed.js';\nimport { InjectedTransport } from './transports/injected.js';\nimport { LiveSessionTransport } from './transports/live.js';\nimport type { TransportConfig, WrapperTransport } from './types.js';\nimport { WrapperTransportError } from './types.js';\n\nexport function createTransport(config: TransportConfig): WrapperTransport {\n switch (config.kind) {\n case 'api':\n return new ApiTransport(config);\n case 'headless':\n return new HeadlessTransport(config);\n case 'headed':\n return new HeadedTransport(config);\n case 'injected':\n return new InjectedTransport(config);\n case 'live': {\n // Allow Node wrappers to pass `ws` via `options.webSocketCtor` without\n // constructing `LiveSessionTransport` directly. In the browser, leave\n // undefined so the transport picks up `globalThis.WebSocket`.\n const opts = (config.options ?? {}) as { webSocketCtor?: unknown };\n const injected =\n typeof opts.webSocketCtor === 'function'\n ? { webSocketCtor: opts.webSocketCtor as never }\n : undefined;\n return new LiveSessionTransport(config, undefined, injected);\n }\n default: {\n const kind = (config as { kind?: string }).kind ?? '<missing>';\n throw new WrapperTransportError('UNKNOWN_TRANSPORT', `Unknown transport kind '${kind}'`);\n }\n }\n}\n","/**\n * `withRetry`\n *\n * Exponential-backoff retry helper. Transports surface retryable errors\n * with `err.retryable === true` (see `WrapperTransportError`); wrappers\n * can pass their own predicate via `shouldRetry` when the default\n * retry-every-error behavior is too aggressive.\n *\n * Defaults: 3 attempts, 200 ms base, doubling delay (200 / 400 / 800).\n */\n\nimport { WrapperTransportError } from '../types.js';\n\nexport interface WithRetryOptions {\n /** Total attempt count, including the first call. Defaults to 3. */\n attempts?: number;\n /** Base delay in ms. Defaults to 200. Doubles between attempts. */\n baseMs?: number;\n /** Max cap on any single backoff wait. Defaults to 5 000 ms. */\n maxDelayMs?: number;\n /**\n * Predicate that decides whether to retry a given error. Defaults to\n * `err.retryable === true` for `WrapperTransportError`, `true`\n * otherwise (network/unknown errors are presumed transient).\n */\n shouldRetry?: (err: unknown, attempt: number) => boolean;\n /** Sleep implementation hook — defaults to `setTimeout`. Overridden in tests. */\n sleep?: (ms: number) => Promise<void>;\n}\n\nconst defaultSleep = (ms: number): Promise<void> =>\n new Promise((resolve) => setTimeout(resolve, ms));\n\nconst defaultShouldRetry = (err: unknown): boolean => {\n if (err instanceof WrapperTransportError) {\n return err.retryable;\n }\n return true;\n};\n\nexport async function withRetry<T>(fn: () => Promise<T>, opts: WithRetryOptions = {}): Promise<T> {\n const attempts = Math.max(1, opts.attempts ?? 3);\n const base = Math.max(0, opts.baseMs ?? 200);\n const cap = Math.max(base, opts.maxDelayMs ?? 5_000);\n const shouldRetry = opts.shouldRetry ?? defaultShouldRetry;\n const sleep = opts.sleep ?? defaultSleep;\n\n let lastErr: unknown;\n for (let attempt = 1; attempt <= attempts; attempt++) {\n try {\n return await fn();\n } catch (err) {\n lastErr = err;\n if (attempt === attempts || !shouldRetry(err, attempt)) {\n throw err;\n }\n const delay = Math.min(cap, base * 2 ** (attempt - 1));\n await sleep(delay);\n }\n }\n // Unreachable — loop either returns or throws — but TS can't prove it.\n throw lastErr;\n}\n","/**\n * `withAuthRefresh`\n *\n * Runs `fn` once; if it throws an auth-expired error, invokes `refresh`\n * (expected to refresh tokens / re-authenticate) and re-runs `fn` exactly\n * once. Designed for wrappers whose `api` transport handlers call\n * third-party APIs with short-lived access tokens.\n *\n * Consumers can override the detector via `isAuthError`. The default\n * treats `WrapperTransportError` with codes matching `/^(AUTH|UNAUTH|401)/i`\n * as auth errors, and errors with a numeric `status === 401` property.\n */\n\nimport { WrapperTransportError } from '../types.js';\n\nexport interface WithAuthRefreshOptions {\n /** Custom detector for \"this error means we need to refresh auth\". */\n isAuthError?: (err: unknown) => boolean;\n}\n\nconst defaultIsAuthError = (err: unknown): boolean => {\n if (err instanceof WrapperTransportError) {\n return /^(AUTH|UNAUTH|401)/i.test(err.code);\n }\n const status = (err as { status?: unknown } | null)?.status;\n if (status === 401) return true;\n const code = (err as { code?: unknown } | null)?.code;\n if (typeof code === 'string' && /^(AUTH|UNAUTH|401)/i.test(code)) return true;\n return false;\n};\n\nexport async function withAuthRefresh<T>(\n fn: () => Promise<T>,\n refresh: () => Promise<void>,\n opts: WithAuthRefreshOptions = {}\n): Promise<T> {\n const isAuthError = opts.isAuthError ?? defaultIsAuthError;\n try {\n return await fn();\n } catch (err) {\n if (!isAuthError(err)) throw err;\n await refresh();\n return fn();\n }\n}\n","/**\n * `paramSchemaOf`\n *\n * Tiny helper that produces a JSON-Schema-subset object from a plain\n * descriptor, matching the shape `useUIComponent` already exposes on its\n * `actions[].paramSchema` field. The existing SDK contract says \"no\n * runtime validation is performed\" — this helper's only job is to surface\n * parameter names and types on the runner's `/control/component/:id`\n * endpoint so callers can discover the action signature.\n *\n * Accepted descriptor values:\n * - a JSON-Schema type name string (`\"string\"`, `\"number\"`, ...)\n * - an object already shaped like JSON Schema (`{ type: \"string\", enum: [...] }`)\n * - `null` / `undefined` → field omitted\n *\n * Example:\n *\n * ```ts\n * paramSchemaOf({ email: 'string', password: 'string', remember: 'boolean' })\n * // => {\n * // type: 'object',\n * // properties: {\n * // email: { type: 'string' },\n * // password: { type: 'string' },\n * // remember: { type: 'boolean' },\n * // },\n * // required: ['email', 'password', 'remember'],\n * // additionalProperties: false,\n * // }\n * ```\n */\n\nconst PRIMITIVE_TYPES = new Set([\n 'string',\n 'number',\n 'integer',\n 'boolean',\n 'object',\n 'array',\n 'null',\n]);\n\ntype SchemaValue = string | Record<string, unknown> | null | undefined;\n\nfunction normalize(value: SchemaValue): Record<string, unknown> | null {\n if (value === null || value === undefined) return null;\n if (typeof value === 'string') {\n if (!PRIMITIVE_TYPES.has(value)) {\n // Unknown string — surface it as a type anyway so introspection\n // surfaces *something* rather than silently dropping the field.\n return { type: value };\n }\n return { type: value };\n }\n if (typeof value === 'object') {\n return { ...value };\n }\n return null;\n}\n\nexport function paramSchemaOf<T extends Record<string, SchemaValue>>(\n shape: T\n): Record<string, unknown> {\n const properties: Record<string, Record<string, unknown>> = {};\n const required: string[] = [];\n for (const [key, raw] of Object.entries(shape)) {\n const normalized = normalize(raw);\n if (!normalized) continue;\n const { optional, ...rest } = normalized as Record<string, unknown> & {\n optional?: unknown;\n };\n properties[key] = rest;\n if (optional !== true) {\n required.push(key);\n }\n }\n const schema: Record<string, unknown> = {\n type: 'object',\n properties,\n additionalProperties: false,\n };\n if (required.length > 0) {\n schema['required'] = required;\n }\n return schema;\n}\n","/**\n * `--manifest-only` mode + Node entrypoint helper.\n *\n * Wrapper packages use `runWrapperEntrypoint` as their `index-node.ts` main\n * loop. The helper covers two modes off the same `process.argv`:\n *\n * 1. Default (no `--manifest-only`): bring the transport up, log readiness,\n * and park on SIGINT/SIGTERM. Identical to what each wrapper used to\n * hand-roll.\n * 2. `--manifest-only`: print one line of JSON describing the wrapper's\n * `qontinui.wrapper` manifest plus the registered actions' paramSchemas\n * to stdout, close the transport, and `process.exit(0)` without ever\n * starting the WS server. Used by the runner's WrapperRegistry for\n * cheap discovery.\n *\n * The helper accepts the manifest object directly (sourced by the caller from\n * its own package.json) so the framework stays agnostic to package layout.\n */\nimport type { WrapperTransport } from './types.js';\n\n/**\n * Action metadata surfaced to the runner via `--manifest-only`. Each wrapper\n * supplies one of these per registered action so the runner can discover\n * paramSchemas without spawning the WS server.\n */\nexport interface ManifestActionMeta {\n id: string;\n paramSchema: Record<string, unknown>;\n /**\n * If `true`, the runner's DispatchRouter serializes calls to this action\n * via a per-(wrapper, action) mutex. Defaults to `false`.\n */\n exclusive?: boolean;\n}\n\n/** Shape of the `qontinui.wrapper` field in a wrapper's package.json. */\nexport interface WrapperManifest {\n manifestVersion: 1;\n id: string;\n displayName: string;\n description?: string;\n transport: 'api' | 'headless' | 'headed' | 'live';\n categories?: string[];\n envVars?: Array<{\n name: string;\n required?: boolean;\n secret?: boolean;\n description?: string;\n }>;\n /** Forward-compatible: extra fields are preserved verbatim. */\n [extra: string]: unknown;\n}\n\n/** Options accepted by `runWrapperEntrypoint`. */\nexport interface RunWrapperEntrypointOptions {\n /** Transport produced by `createTransport` and pre-populated with handlers. */\n transport: WrapperTransport;\n /** The wrapper's own `qontinui.wrapper` manifest (already parsed from package.json). */\n manifest: WrapperManifest;\n /** Action metadata. Order is preserved in the emitted JSON. */\n actions: ReadonlyArray<ManifestActionMeta>;\n /**\n * Friendly name used for stdout/stderr log prefixes. Defaults to\n * `manifest.id` so logs are stable across wrappers.\n */\n logName?: string;\n /**\n * Optional override for argv parsing. Defaults to `process.argv.slice(2)`.\n * Lets tests inject a fixed flag list without touching `process`.\n */\n argv?: ReadonlyArray<string>;\n}\n\n/** Stable JSON envelope written to stdout in `--manifest-only` mode. */\nexport interface ManifestOnlyEnvelope {\n manifestVersion: 1;\n manifest: WrapperManifest;\n actions: Array<{\n id: string;\n paramSchema: Record<string, unknown>;\n exclusive: boolean;\n }>;\n}\n\nfunction hasManifestOnlyFlag(argv: ReadonlyArray<string>): boolean {\n return argv.includes('--manifest-only');\n}\n\n/**\n * Print the manifest envelope to stdout and tear the transport down. Exits\n * the process with code 0 on success or 1 on transport-close failure.\n *\n * Safe to call before `transport.ready()` — the WS server is never started.\n */\nexport async function emitManifestOnly(opts: {\n transport: WrapperTransport;\n manifest: WrapperManifest;\n actions: ReadonlyArray<ManifestActionMeta>;\n}): Promise<never> {\n const envelope: ManifestOnlyEnvelope = {\n manifestVersion: 1,\n manifest: opts.manifest,\n actions: opts.actions.map((a) => ({\n id: a.id,\n paramSchema: a.paramSchema,\n exclusive: a.exclusive ?? false,\n })),\n };\n process.stdout.write(`${JSON.stringify(envelope)}\\n`);\n try {\n await opts.transport.close();\n } catch {\n // Manifest already emitted; close failure shouldn't mask the result.\n }\n process.exit(0);\n}\n\n/**\n * Single entrypoint helper that branches on `--manifest-only` or runs the\n * standard daemon loop (transport.ready() + SIGINT/SIGTERM). Returns a\n * promise that never resolves in daemon mode (we park on the signal\n * handlers) and never resolves in manifest-only mode either (we\n * `process.exit(0)`). The return type is `Promise<never>` so callers don't\n * accidentally chain code after it.\n */\nexport async function runWrapperEntrypoint(opts: RunWrapperEntrypointOptions): Promise<never> {\n const argv = opts.argv ?? process.argv.slice(2);\n const logName = opts.logName ?? opts.manifest.id;\n\n if (hasManifestOnlyFlag(argv)) {\n await emitManifestOnly({\n transport: opts.transport,\n manifest: opts.manifest,\n actions: opts.actions,\n });\n // emitManifestOnly never returns, but TS can't see that.\n throw new Error('unreachable');\n }\n\n await opts.transport.ready();\n\n // When the runner spawns the wrapper as a daemon, it expects a tiny\n // HTTP server at `http://127.0.0.1:<WRAPPER_PORT>/dispatch` so it can\n // route action calls to us. The api transport doesn't bind a port on\n // its own (it's a pure in-process dispatcher), so we open one here\n // when WRAPPER_PORT is set in the environment. Skipped silently when\n // unset — that's the \"run standalone, no runner\" mode used in tests\n // and the `_probe-*.mjs` scripts.\n const wrapperPort = parsePort(process.env['WRAPPER_PORT']);\n if (wrapperPort != null) {\n await startDispatchServer(opts.transport, wrapperPort, logName);\n }\n\n process.stdout.write(\n `[${logName}] ready (transport=${opts.transport.kind}${\n wrapperPort != null ? `, port=${wrapperPort}` : ''\n }); press Ctrl+C to exit.\\n`\n );\n\n const shutdown = async (signal: NodeJS.Signals): Promise<never> => {\n process.stdout.write(`[${logName}] received ${signal}, closing transport...\\n`);\n try {\n await opts.transport.close();\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[${logName}] close error: ${msg}\\n`);\n }\n process.exit(0);\n };\n process.on('SIGINT', (s) => {\n void shutdown(s);\n });\n process.on('SIGTERM', (s) => {\n void shutdown(s);\n });\n\n // Park forever; the signal handlers are the only exit path.\n return new Promise<never>(() => {\n /* never resolves */\n });\n}\n\nfunction parsePort(raw: string | undefined): number | null {\n if (!raw) return null;\n const n = Number(raw);\n return Number.isInteger(n) && n > 0 && n < 65_536 ? n : null;\n}\n\n/**\n * Bind a tiny HTTP server on `127.0.0.1:<port>` exposing two endpoints:\n *\n * - `GET /health` — returns `{ ok: true }` so the runner's manager can\n * poll for readiness.\n * - `POST /dispatch` — body `{ action, params }`, dispatches via the\n * transport's `HandlerRegistry`, and returns\n * `{ success: true, data: <result> }` on success or\n * `{ success: false, error: <message> }` on failure.\n *\n * Loopback-only by design — the wrapper's port is meant for the runner\n * to talk to it, never an external client. Uses Node's built-in `http`\n * module to avoid pulling in a framework dep.\n */\nasync function startDispatchServer(\n transport: WrapperTransport,\n port: number,\n logName: string\n): Promise<void> {\n const http = await import('node:http');\n const server = http.createServer((req, res) => {\n if (req.method === 'GET' && req.url === '/health') {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ ok: true }));\n return;\n }\n if (req.method === 'POST' && req.url === '/dispatch') {\n let body = '';\n req.setEncoding('utf8');\n req.on('data', (chunk: string) => {\n body += chunk;\n // Defensive cap — generous enough for any reasonable params payload.\n if (body.length > 10 * 1024 * 1024) {\n req.destroy();\n }\n });\n req.on('end', () => {\n let parsed: { action?: unknown; params?: unknown };\n try {\n parsed = JSON.parse(body || '{}') as typeof parsed;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.writeHead(400, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: `bad request body: ${msg}` }));\n return;\n }\n const action = typeof parsed.action === 'string' ? parsed.action : '';\n if (!action) {\n res.writeHead(400, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: 'missing required field: action' }));\n return;\n }\n transport\n .dispatch(action, parsed.params)\n .then((result) => {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: true, data: result }));\n })\n .catch((err: unknown) => {\n const msg = err instanceof Error ? err.message : String(err);\n res.writeHead(500, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: msg }));\n });\n });\n req.on('error', () => {\n // Connection-level errors get logged to stderr; we don't have a\n // response stream to write to once the request errors.\n process.stderr.write(`[${logName}] request error during dispatch\\n`);\n });\n return;\n }\n res.writeHead(404, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: 'not found' }));\n });\n\n await new Promise<void>((resolve, reject) => {\n server.once('error', reject);\n server.listen(port, '127.0.0.1', () => {\n server.removeListener('error', reject);\n resolve();\n });\n });\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/types.ts","../src/handler-registry.ts","../src/base-transport.ts","../src/transports/api.ts","../src/transports/headless.ts","../src/transports/headed.ts","../src/transports/injected.ts","../src/transports/live.ts","../src/create-transport.ts","../src/helpers/retry.ts","../src/helpers/auth.ts","../src/helpers/schema.ts","../src/manifest-only.ts"],"names":["require","createRequire","readFileSync"],"mappings":"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","file":"index.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 * uiBridgeBase?: string; forwardConsole?: boolean }`\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 constructor(\n code: string,\n message: string,\n options: { retryable?: boolean; cause?: 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 }\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 * ApiTransport\n *\n * The thinnest of the four transports. It carries no I/O of its own — all\n * it does is hold a `HandlerRegistry`, go `ready` immediately, and route\n * dispatches through the registry. Wrappers that target a remote API\n * (REST, GraphQL, gRPC, SDK…) put their `fetch` / SDK calls inside the\n * registered handlers.\n *\n * For compatibility with the spec, `TransportConfig.options.handler` is\n * honored as a fallback for unregistered action ids.\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';\n\n/**\n * Context shape passed to api-transport handlers. Empty by default; wrappers\n * can cast `ctx as ApiContext & { mySdk }` if they stash shared state on the\n * transport instance.\n */\nexport interface ApiContext {\n readonly kind: 'api';\n}\n\n/** Catch-all fallback handler signature, used for `options.handler` support. */\nexport type ApiFallbackHandler = (actionId: string, params?: unknown) => unknown | Promise<unknown>;\n\nexport class ApiTransport extends BaseTransport {\n readonly kind: WrapperTransportKind = 'api';\n private readonly fallback?: ApiFallbackHandler;\n\n constructor(config: TransportConfig = { kind: 'api' }, registry?: HandlerRegistry) {\n super(registry);\n const handler = (config.options as { handler?: unknown } | undefined)?.handler;\n if (typeof handler === 'function') {\n this.fallback = handler as ApiFallbackHandler;\n }\n }\n\n protected async onReady(): Promise<void> {\n // Nothing to warm up.\n }\n\n protected async onClose(): Promise<void> {\n // Nothing to tear down.\n }\n\n protected async buildContext(): Promise<ApiContext> {\n return { kind: 'api' };\n }\n\n /**\n * Override dispatch to fall back to `options.handler` when no explicit\n * registration exists for `actionId`.\n */\n async dispatch<TResult = unknown>(actionId: string, params?: unknown): Promise<TResult> {\n await this.ready();\n if (this.registry.has(actionId)) {\n const ctx = await this.buildContext();\n return this.registry.dispatch<TResult>(actionId, params, ctx);\n }\n if (this.fallback) {\n try {\n return (await this.fallback(actionId, params)) 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 throw new WrapperTransportError('NO_HANDLER', `No handler registered for action '${actionId}'`);\n }\n}\n","/**\n * HeadlessTransport\n *\n * Wraps `@qontinui/ui-bridge-headless`'s `launchHeadlessTab` to own a\n * Playwright Chromium lifecycle. The transport's job is lifecycle only:\n *\n * - Launch the browser on `ready()` and navigate to `options.targetUrl`.\n * - Expose the `page` / `context` / `browser` via a `HeadlessContext`\n * that each handler receives.\n * - Close everything on `close()`.\n *\n * Action code lives in the wrapper's handler registrations, not in the\n * transport. Headless and headed differ only in the `headless` flag.\n */\n\nimport type { Browser, BrowserContext, Page } from 'playwright';\nimport { BaseTransport } from '../base-transport.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig, WrapperTransportKind } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\n\n/** Options extracted from `TransportConfig.options` for headless/headed. */\nexport interface HeadlessTransportOptions {\n /** URL to navigate to on first `ready()`. Required. */\n targetUrl: string;\n /** Viewport width in px. Defaults to 1280. */\n viewportWidth?: number;\n /** Viewport height in px. Defaults to 720. */\n viewportHeight?: number;\n /**\n * UI Bridge relay base URL. If provided, `ready()` blocks until the relay\n * confirms the tab registered. Mirrors `launchHeadlessTab` behavior.\n */\n uiBridgeBase?: string;\n /** Max time to wait for UI Bridge registration. Defaults to 30 000. */\n waitForUiBridgeMs?: number;\n /** User agent override. */\n userAgent?: string;\n /** Forward browser console/page errors to the Node process stderr. */\n forwardConsole?: boolean;\n /**\n * Extra Chromium command-line arguments passed through to\n * `chromium.launch({ args })` (e.g. the LNA-disable flags needed to fetch\n * a loopback relay from an https page). Plan 2026-06-12 item 2.\n */\n launchArgs?: string[];\n /**\n * Path to a Playwright `storageState` JSON file (cookies + localStorage)\n * to seed the browser context with before the first navigation. Lets a\n * previously-captured authenticated session (e.g. from\n * `ui-bridge-login-web --storage-state-out`) carry past a login wall so an\n * autonomous loop can drive a login-walled page repeatedly without\n * re-driving the hosted-UI login. Threaded to `launchHeadlessTab`'s\n * `storageStatePath`.\n */\n storageStatePath?: string;\n}\n\n/**\n * Local structural type for `@qontinui/ui-bridge-headless`'s `launchHeadlessTab`,\n * declared here so the wrapper's `tsc` build does NOT depend on the headless\n * package's declaration files.\n *\n * Headless is an OPTIONAL peer (package.json `peerDependenciesMeta`): a clean\n * checkout that only ever uses the api/relay transports never installs it, so a\n * `typeof import('@qontinui/ui-bridge-headless')` type reference would make the\n * build fail to resolve the module. It is also brittle against dist/source skew\n * in the workspace link (a stale headless `dist/*.d.ts` would fail the wrapper\n * build even though the runtime `await import()` resolves the up-to-date impl).\n *\n * Only the call shape the wrapper actually uses is modelled. The runtime import\n * stays lazy (`await import(...)`) and is the single source of truth for the\n * real implementation.\n */\ninterface LaunchHeadlessTabArgs {\n url: string;\n headless: boolean;\n uiBridgeBase?: string;\n waitForUiBridgeMs?: number;\n viewportWidth?: number;\n viewportHeight?: number;\n userAgent?: string;\n forwardConsole?: boolean;\n initScripts?: string[];\n launchArgs?: string[];\n storageStatePath?: string;\n}\n\ninterface LaunchedHeadlessTab {\n browser: Browser;\n context: BrowserContext;\n page: Page;\n uiBridgeRegistered: boolean;\n tabId: string | null;\n close: () => Promise<void>;\n}\n\ntype LaunchHeadlessTabFn = (args: LaunchHeadlessTabArgs) => Promise<LaunchedHeadlessTab>;\n\n/** Context shape delivered to each headless/headed handler. */\nexport interface HeadlessContext {\n readonly kind: 'headless' | 'headed' | 'injected';\n readonly page: Page;\n readonly browserContext: BrowserContext;\n readonly browser: Browser;\n /** True once the UI Bridge relay confirmed the tab is registered. */\n readonly uiBridgeRegistered: boolean;\n /** Relay-assigned tab id, when known. */\n readonly tabId: string | null;\n}\n\n/**\n * Shared implementation used by both `HeadlessTransport` and\n * `HeadedTransport` — they differ only in the `headless` launch flag and\n * their reported `kind`.\n */\nexport class HeadlessTransport extends BaseTransport {\n readonly kind: WrapperTransportKind;\n protected readonly options: HeadlessTransportOptions;\n protected readonly headless: boolean;\n\n protected tab: {\n browser: Browser;\n context: BrowserContext;\n page: Page;\n uiBridgeRegistered: boolean;\n tabId: string | null;\n close: () => Promise<void>;\n } | null = null;\n\n constructor(\n config: TransportConfig,\n registry?: HandlerRegistry,\n overrides: { kind?: WrapperTransportKind; headless?: boolean } = {}\n ) {\n super(registry);\n this.kind = overrides.kind ?? 'headless';\n this.headless = overrides.headless ?? true;\n this.options = this.parseOptions(config);\n }\n\n private parseOptions(config: TransportConfig): HeadlessTransportOptions {\n const raw = (config.options ?? {}) as Record<string, unknown>;\n const targetUrl = raw['targetUrl'];\n if (typeof targetUrl !== 'string' || targetUrl.length === 0) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind '${this.kind}' requires options.targetUrl (string)`\n );\n }\n return {\n targetUrl,\n viewportWidth:\n typeof raw['viewportWidth'] === 'number' ? (raw['viewportWidth'] as number) : undefined,\n viewportHeight:\n typeof raw['viewportHeight'] === 'number' ? (raw['viewportHeight'] as number) : undefined,\n uiBridgeBase:\n typeof raw['uiBridgeBase'] === 'string' ? (raw['uiBridgeBase'] as string) : undefined,\n waitForUiBridgeMs:\n typeof raw['waitForUiBridgeMs'] === 'number'\n ? (raw['waitForUiBridgeMs'] as number)\n : undefined,\n userAgent: typeof raw['userAgent'] === 'string' ? (raw['userAgent'] as string) : undefined,\n forwardConsole:\n typeof raw['forwardConsole'] === 'boolean' ? (raw['forwardConsole'] as boolean) : undefined,\n launchArgs:\n Array.isArray(raw['launchArgs']) &&\n (raw['launchArgs'] as unknown[]).every((a) => typeof a === 'string')\n ? (raw['launchArgs'] as string[])\n : undefined,\n storageStatePath:\n typeof raw['storageStatePath'] === 'string'\n ? (raw['storageStatePath'] as string)\n : undefined,\n };\n }\n\n protected async onReady(): Promise<void> {\n // Lazy-import so api-only wrappers that never build the headless transport\n // don't pay the Playwright resolution cost. `@qontinui/ui-bridge-headless`\n // is an OPTIONAL peer (package.json peerDependenciesMeta), so the import is\n // NOT guaranteed resolvable — a bare `npx @qontinui/ui-bridge-wrapper …`\n // does not install peers. Catch the resolution failure and surface an\n // actionable install hint instead of a raw ERR_MODULE_NOT_FOUND.\n // Typed via the local `LaunchHeadlessTabFn` (see above) rather than a\n // `typeof import(...)` reference, so this build never needs the optional\n // peer's declaration files. The specifier is split out of the literal so\n // bundlers/`tsc` cannot eagerly resolve the optional peer at build time.\n let launchHeadlessTab: LaunchHeadlessTabFn;\n const headlessSpecifier = '@qontinui/ui-bridge-headless';\n try {\n const mod = (await import(headlessSpecifier)) as {\n launchHeadlessTab: LaunchHeadlessTabFn;\n };\n ({ launchHeadlessTab } = mod);\n } catch (err) {\n const cause = err instanceof Error ? err.message : String(err);\n const code = (err as NodeJS.ErrnoException | undefined)?.code;\n // Only a genuine resolution failure means \"the peer is not installed\".\n // Anything else (a broken install, a missing TRANSITIVE dep, version\n // skew making the module throw on evaluation) must NOT tell the user to\n // install a package they already have.\n if (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND') {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Transport kind '${this.kind}' needs the optional '@qontinui/ui-bridge-headless' ` +\n `peer, which is not installed. Install it and the Chromium browser:\\n` +\n ` npm i @qontinui/ui-bridge-headless && npx playwright install chromium\\n` +\n `(bare \\`npx @qontinui/ui-bridge-wrapper …\\` does NOT install peers — pass each ` +\n `peer with \\`-p\\`, e.g.\\n` +\n ` npx -y -p @qontinui/ui-bridge-wrapper -p @qontinui/ui-bridge -p @qontinui/ui-bridge-headless -p playwright ui-bridge-login-web …)\\n` +\n `Underlying import error: ${cause}`\n );\n }\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `'@qontinui/ui-bridge-headless' is installed but failed to load — this is a ` +\n `broken install (missing transitive dependency or version skew), not a ` +\n `missing peer. Try reinstalling it. Underlying error: ${cause}`\n );\n }\n\n // Subclasses (injected) supply init-scripts to run before first paint.\n const initScripts = await this.buildInitScripts();\n\n let tab: Awaited<ReturnType<typeof launchHeadlessTab>>;\n try {\n tab = await launchHeadlessTab({\n url: this.options.targetUrl,\n headless: this.headless,\n uiBridgeBase: this.options.uiBridgeBase,\n waitForUiBridgeMs: this.options.waitForUiBridgeMs,\n viewportWidth: this.options.viewportWidth,\n viewportHeight: this.options.viewportHeight,\n userAgent: this.options.userAgent,\n forwardConsole: this.options.forwardConsole,\n initScripts: initScripts.length > 0 ? initScripts : undefined,\n launchArgs:\n this.options.launchArgs && this.options.launchArgs.length > 0\n ? this.options.launchArgs\n : undefined,\n storageStatePath: this.options.storageStatePath,\n });\n } catch (err) {\n const cause = err instanceof Error ? err.message : String(err);\n // The other half of the first-run story: the peer resolved but the\n // Chromium binary was never installed. Playwright's raw \"Executable\n // doesn't exist at <path>\" surfaces several frames deep — translate it\n // into the same actionable shape as the missing-peer error above.\n if (/Executable doesn't exist|browserType\\.launch/i.test(cause)) {\n throw new WrapperTransportError(\n 'INVALID_CONFIG',\n `Playwright's Chromium browser is not installed (the ` +\n `'@qontinui/ui-bridge-headless' peer itself loaded fine). Run:\\n` +\n ` npx playwright install chromium\\n` +\n `Underlying launch error: ${cause}`\n );\n }\n throw err;\n }\n\n this.tab = {\n browser: tab.browser,\n context: tab.context,\n page: tab.page,\n uiBridgeRegistered: tab.uiBridgeRegistered,\n tabId: tab.tabId,\n close: tab.close,\n };\n\n // Subclass hook: block until the page-side runtime is ready (e.g. the\n // injected bundle reports `window.__uiBridgeInjected.ready === true`).\n await this.afterLaunch(tab.page);\n }\n\n /**\n * Subclass hook: init-scripts to register on the browser context before the\n * first navigation (via `context.addInitScript`). Default: none. Injected\n * mode overrides this to inject the config + runtime bundle pre-paint.\n */\n protected async buildInitScripts(): Promise<string[]> {\n return [];\n }\n\n /**\n * Subclass hook: run after launch + navigation, before `ready()` resolves.\n * Default: no-op. Injected mode overrides it to await the in-page runtime.\n */\n protected async afterLaunch(_page: Page): Promise<void> {\n // no-op for headless/headed\n }\n\n protected async onClose(): Promise<void> {\n if (!this.tab) return;\n const t = this.tab;\n this.tab = null;\n await t.close();\n }\n\n protected async buildContext(): Promise<HeadlessContext> {\n if (!this.tab) {\n throw new WrapperTransportError(\n 'NOT_READY',\n `Transport '${this.kind}' is not ready; call ready() before dispatch`\n );\n }\n return {\n kind: this.kind as 'headless' | 'headed',\n page: this.tab.page,\n browserContext: this.tab.context,\n browser: this.tab.browser,\n uiBridgeRegistered: this.tab.uiBridgeRegistered,\n tabId: this.tab.tabId,\n };\n }\n}\n","/**\n * HeadedTransport\n *\n * Identical to `HeadlessTransport` except the browser is launched visibly.\n * Kept as its own class so wrappers and docs can refer to the transport\n * kind directly, and so future divergence (e.g. devtools-auto-open for\n * headed) doesn't require refactoring the shared parent.\n */\n\nimport { HeadlessTransport } from './headless.js';\nimport type { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig } from '../types.js';\n\nexport class HeadedTransport extends HeadlessTransport {\n constructor(config: TransportConfig, registry?: HandlerRegistry) {\n super(config, registry, { kind: 'headed', headless: false });\n }\n}\n","/**\n * InjectedTransport\n *\n * The fourth-and-a-half delivery mode: drive UI Bridge's **semantic**\n * automation (find / act / snapshot / assert) against a page that ships\n * **zero** UI Bridge code, by injecting the engine bundle at automation time.\n *\n * Subclasses {@link HeadlessTransport} to reuse the Chromium launch/close\n * lifecycle. It differs in exactly two ways (plan §3.1):\n * 1. it injects `@qontinui/ui-bridge`'s `dist/injected/bundle.global.js`\n * (plus an optional relay-config sibling) as init-scripts BEFORE first\n * paint, so `window.__uiBridgeInjected` exists before the page's own\n * scripts run;\n * 2. `buildContext()` returns an {@link InjectedContext} exposing semantic\n * methods backed by the in-page runtime via `page.evaluate`, instead of\n * the raw Playwright `page`.\n *\n * The production page is unchanged — nothing is shipped onto the real site;\n * the control surface exists only inside the browser this transport launched\n * (plan §3.6). When `options.uiBridgeBase` is set, the injected runtime also\n * registers as a relay tab (Variant B) so existing orchestrators drive it\n * through the same `/control/*` plane as embedded apps.\n */\n\nimport { createRequire } from 'node:module';\nimport { readFileSync } from 'node:fs';\nimport type { Page } from 'playwright';\nimport { HeadlessTransport, type HeadlessContext } from './headless.js';\nimport { HandlerRegistry } from '../handler-registry.js';\nimport type { TransportConfig } from '../types.js';\nimport { WrapperTransportError } from '../types.js';\n\nconst require = createRequire(import.meta.url);\n\n/** Lazily-loaded, cached injected runtime bundle (the IIFE text). */\nlet cachedBundle: string | null = null;\n\n/** Resolve + read `@qontinui/ui-bridge`'s injected runtime IIFE bundle. */\nfunction loadInjectedBundle(): string {\n if (cachedBundle !== null) return cachedBundle;\n let bundlePath: string;\n try {\n bundlePath = require.resolve('@qontinui/ui-bridge/injected/bundle.global.js');\n } catch {\n // Fallback for resolvers that don't honor the subpath export: locate the\n // package root via its package.json and join the dist path.\n const pkgJson = require.resolve('@qontinui/ui-bridge/package.json');\n bundlePath = pkgJson.replace(/package\\.json$/, 'dist/injected/bundle.global.js');\n }\n try {\n cachedBundle = readFileSync(bundlePath, 'utf8');\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_BUNDLE_MISSING',\n `Could not read the UI Bridge injected runtime bundle at '${bundlePath}'. ` +\n `Ensure @qontinui/ui-bridge is built (the IIFE is emitted by its tsup build).`,\n { cause }\n );\n }\n return cachedBundle;\n}\n\n/** Injected-specific options parsed from `TransportConfig.options`. */\ninterface InjectedExtraOptions {\n /** Launch with a visible window (debugging). Default false (headless). */\n headed: boolean;\n /** Max ms to wait for `window.__uiBridgeInjected.ready`. Default 30000. */\n readyTimeoutMs: number;\n /**\n * Whether `ready()` waits for the in-page runtime to report `settled` (DOM\n * quiet after content appeared), not merely `ready` (runtime live, registry\n * possibly still empty on a client-rendered SPA). Default true — this is the\n * fix that lets a driver snapshot immediately after `ready()` without polling\n * through hydration. Set false to revert to ready-only gating.\n */\n waitForSettle: boolean;\n /** Quiet window (ms) before the runtime declares itself settled. Default 500. */\n settleQuietMs?: number;\n /** Hard cap (ms) after which the runtime settles regardless. Default 10000. */\n settleTimeoutMs?: number;\n /**\n * CSS selector that must match before the DOM counts as settled. Without it,\n * settle fires on any content going quiet — which can be unrelated chrome that\n * paints before a lazily-mounted target control. With it, `ready()` waits for\n * the TARGET; and if the selector never matches before the settle cap,\n * `afterLaunch` throws `INJECTED_EXPECT_SELECTOR_UNMET` instead of returning a\n * page that's missing the control.\n */\n expectSelector?: string;\n /** Bearer token for the auth-gated relay (Variant B). */\n authToken?: string;\n /** Strict per-user tab-scoping metadata for relay heartbeats (Variant B). */\n registrationMetadata?: { userId: string; sessionId: string };\n /** App id reported to the relay registry (Variant B). */\n appId?: string;\n /** Display name reported to the relay registry (Variant B). */\n appName?: string;\n /** Stable per-tab id override (Variant B). */\n tabId?: string;\n}\n\n/** In-page settle state surfaced by {@link InjectedContext.settleState}/`whenSettled`. */\nexport interface InjectedSettleState {\n /** True once the DOM has settled (gated quiet window, or the hard cap). */\n settled: boolean;\n /** Interactive elements registered as of the most recent seed pass. */\n elementCount: number;\n /** True when settle was forced by the cap rather than a clean quiet window. */\n settledByTimeout: boolean;\n /** Whether the gating condition (content / expectSelector) was met. */\n expectSatisfied: boolean;\n}\n\n/**\n * Semantic context delivered to each injected handler. Extends\n * {@link HeadlessContext} (so drivers still get the raw `page` / `browser` /\n * `browserContext` handles for lower-level access) and adds the semantic\n * surface. `execute` is the generic escape hatch (any relay action id); the\n * named methods are typed conveniences over the most common ones. All run in\n * the page realm via `page.evaluate(window.__uiBridgeInjected.execute(...))`.\n */\nexport interface InjectedContext extends HeadlessContext {\n readonly kind: 'injected';\n /** True once the injected runtime reported ready (always true post-`ready()`). */\n readonly ready: boolean;\n /**\n * Re-read the in-page runtime's current settle state. After `ready()` with\n * the default `waitForSettle`, this is already `settled: true`; it's exposed\n * for drivers that disabled settle-gating or want the live element count.\n * `settledByTimeout` + `expectSatisfied: false` means the gate never met.\n */\n settleState(): Promise<InjectedSettleState>;\n /**\n * Wait for the in-page runtime to report settled (DOM quiet after content),\n * or `timeoutMs`. Useful after a soft-navigation re-render when the caller\n * wants to re-settle before the next assertion.\n */\n whenSettled(timeoutMs?: number): Promise<InjectedSettleState>;\n /** Run any relay action against the in-page runtime. */\n execute<T = unknown>(action: string, payload?: unknown): Promise<T>;\n /** Semantic find — by label / text / role / type / testId. */\n find(criteria?: Record<string, unknown>): Promise<unknown>;\n /** Act on an element by registry id: `{ action: 'click' | 'type' | ... }`. */\n act(id: string, request: Record<string, unknown>): Promise<unknown>;\n /** Read the interactive-element control snapshot. */\n snapshot(options?: Record<string, unknown>): Promise<unknown>;\n /** Assert a user-visible outcome (NL `{assertion}` or `{target,type,expected}`). */\n assert(spec: Record<string, unknown>): Promise<unknown>;\n}\n\nexport class InjectedTransport extends HeadlessTransport {\n private readonly injected: InjectedExtraOptions;\n\n constructor(config: TransportConfig, registry?: HandlerRegistry) {\n const raw = (config.options ?? {}) as Record<string, unknown>;\n const headed = raw['headed'] === true;\n super(config, registry, { kind: 'injected', headless: !headed });\n this.injected = {\n headed,\n readyTimeoutMs:\n typeof raw['readyTimeoutMs'] === 'number' ? (raw['readyTimeoutMs'] as number) : 30_000,\n waitForSettle: raw['waitForSettle'] !== false,\n settleQuietMs:\n typeof raw['settleQuietMs'] === 'number' ? (raw['settleQuietMs'] as number) : undefined,\n settleTimeoutMs:\n typeof raw['settleTimeoutMs'] === 'number' ? (raw['settleTimeoutMs'] as number) : undefined,\n expectSelector:\n typeof raw['expectSelector'] === 'string' && (raw['expectSelector'] as string).length > 0\n ? (raw['expectSelector'] as string)\n : undefined,\n authToken: typeof raw['authToken'] === 'string' ? (raw['authToken'] as string) : undefined,\n registrationMetadata: isRegistrationMetadata(raw['registrationMetadata'])\n ? (raw['registrationMetadata'] as { userId: string; sessionId: string })\n : undefined,\n appId: typeof raw['appId'] === 'string' ? (raw['appId'] as string) : undefined,\n appName: typeof raw['appName'] === 'string' ? (raw['appName'] as string) : undefined,\n tabId: typeof raw['tabId'] === 'string' ? (raw['tabId'] as string) : undefined,\n };\n }\n\n /**\n * Build the `__uiBridgeInjectedConfig` injected ahead of the bundle, or null\n * if there's nothing to configure. Carries the relay fields (Variant B only,\n * when `uiBridgeBase` is set) AND the settle-tuning fields (both variants).\n */\n private injectedConfig(): Record<string, unknown> | null {\n const cfg: Record<string, unknown> = {};\n const base = this.options.uiBridgeBase;\n if (base) {\n cfg.uiBridgeBase = base;\n if (this.injected.authToken) cfg.authToken = this.injected.authToken;\n if (this.injected.registrationMetadata)\n cfg.registrationMetadata = this.injected.registrationMetadata;\n if (this.injected.appId) cfg.appId = this.injected.appId;\n if (this.injected.appName) cfg.appName = this.injected.appName;\n if (this.injected.tabId) cfg.tabId = this.injected.tabId;\n }\n if (this.injected.settleQuietMs !== undefined)\n cfg.settleQuietMs = this.injected.settleQuietMs;\n if (this.injected.settleTimeoutMs !== undefined)\n cfg.settleTimeoutMs = this.injected.settleTimeoutMs;\n if (this.injected.expectSelector !== undefined)\n cfg.expectSelector = this.injected.expectSelector;\n return Object.keys(cfg).length > 0 ? cfg : null;\n }\n\n protected override async buildInitScripts(): Promise<string[]> {\n const scripts: string[] = [];\n // Config first so it exists when the bundle's init-script runs.\n const cfg = this.injectedConfig();\n if (cfg) {\n scripts.push(`window.__uiBridgeInjectedConfig = ${JSON.stringify(cfg)};`);\n }\n scripts.push(loadInjectedBundle());\n return scripts;\n }\n\n protected override async afterLaunch(page: Page): Promise<void> {\n // Resolve `ready()` only once the in-page runtime reports ready\n // (success criterion 1). The bundle flips `ready` after seeding the\n // registry on DOM-ready.\n try {\n await page.waitForFunction(\n () =>\n (window as unknown as { __uiBridgeInjected?: { ready?: boolean } }).__uiBridgeInjected\n ?.ready === true,\n undefined,\n { timeout: this.injected.readyTimeoutMs }\n );\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_RUNTIME_NOT_READY',\n `The injected UI Bridge runtime did not report ready within ` +\n `${this.injected.readyTimeoutMs}ms. The bundle may have failed to ` +\n `evaluate (check page console / CSP) or the page never reached DOMContentLoaded.`,\n { cause, retryable: true }\n );\n }\n\n // Then wait for the DOM to SETTLE (content painted + quiet) so the driver\n // can snapshot immediately after ready() without polling through SPA\n // hydration. The runtime always settles eventually (its own hard cap), so\n // this resolves the in-page `whenSettled()` rather than racing a Playwright\n // poll; we still bound the outer wait by readyTimeoutMs as a backstop in\n // case the page realm wedged.\n if (this.injected.waitForSettle) {\n let state: {\n settled: boolean;\n settledByTimeout: boolean;\n expectSatisfied: boolean;\n elementCount: number;\n };\n try {\n await page.waitForFunction(\n () =>\n (\n window as unknown as { __uiBridgeInjected?: { settled?: boolean } }\n ).__uiBridgeInjected?.settled === true,\n undefined,\n { timeout: this.injected.readyTimeoutMs }\n );\n state = await page.evaluate(() => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n settled?: boolean;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n elementCount?: number;\n };\n }\n ).__uiBridgeInjected;\n return {\n settled: api?.settled === true,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n elementCount: api?.elementCount ?? 0,\n };\n });\n } catch (cause) {\n throw new WrapperTransportError(\n 'INJECTED_RUNTIME_NOT_SETTLED',\n `The injected UI Bridge runtime did not report settled within ` +\n `${this.injected.readyTimeoutMs}ms. The page kept mutating past its ` +\n `settle cap, or the realm was torn down. Pass options.waitForSettle=false ` +\n `to gate on ready only, or raise options.settleTimeoutMs / readyTimeoutMs.`,\n { cause, retryable: true }\n );\n }\n\n // The runtime settled, but distinguish a clean settle from \"the cap fired\n // while the gating condition was still unmet\". With an expectSelector that\n // means the target control never appeared; without one it means the page\n // stayed empty. Either way the page is NOT drivable — surface it as a\n // structured error rather than handing back a control-less page that the\n // caller would mis-read as a clean snapshot.\n if (state.settledByTimeout && !state.expectSatisfied) {\n const sel = this.injected.expectSelector;\n throw new WrapperTransportError(\n 'INJECTED_EXPECT_SELECTOR_UNMET',\n sel\n ? `The injected runtime settled at its cap without the expected control ` +\n `(selector '${sel}') appearing — ${state.elementCount} element(s) were ` +\n `registered, but none matched. The control may mount slower than the ` +\n `settle cap (raise options.settleTimeoutMs), the selector may be wrong, ` +\n `or the inject failed. Treat as BLOCKED/UNVERIFIED, not a clean page.`\n : `The injected runtime settled at its cap with an empty registry ` +\n `(0 elements). The page never rendered interactive content within ` +\n `the settle cap, or the inject failed. Raise options.settleTimeoutMs ` +\n `for a slow page; otherwise treat as BLOCKED/UNVERIFIED.`,\n { retryable: true }\n );\n }\n }\n }\n\n protected override async buildContext(): Promise<InjectedContext> {\n if (!this.tab) {\n throw new WrapperTransportError(\n 'NOT_READY',\n `Transport 'injected' is not ready; call ready() before dispatch`\n );\n }\n const { page, context: browserContext, browser, uiBridgeRegistered, tabId } = this.tab;\n\n const execute = <T = unknown>(action: string, payload?: unknown): Promise<T> =>\n page.evaluate(\n (args: [string, unknown]) =>\n (\n window as unknown as {\n __uiBridgeInjected: { execute(a: string, p?: unknown): Promise<unknown> };\n }\n ).__uiBridgeInjected.execute(args[0], args[1]),\n [action, payload] as [string, unknown]\n ) as Promise<T>;\n\n const settleState = (): Promise<InjectedSettleState> =>\n page.evaluate(() => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n settled?: boolean;\n elementCount?: number;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n };\n }\n ).__uiBridgeInjected;\n return {\n settled: api?.settled === true,\n elementCount: api?.elementCount ?? 0,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n };\n });\n\n const whenSettled = (timeoutMs?: number): Promise<InjectedSettleState> =>\n page.evaluate(\n (ms: number | null) => {\n const api = (\n window as unknown as {\n __uiBridgeInjected?: {\n whenSettled?: (t?: number) => Promise<{\n settled: boolean;\n elementCount: number;\n settledByTimeout: boolean;\n expectSatisfied: boolean;\n }>;\n settled?: boolean;\n elementCount?: number;\n settledByTimeout?: boolean;\n expectSatisfied?: boolean;\n };\n }\n ).__uiBridgeInjected;\n if (api?.whenSettled) return api.whenSettled(ms ?? undefined);\n return Promise.resolve({\n settled: api?.settled === true,\n elementCount: api?.elementCount ?? 0,\n settledByTimeout: api?.settledByTimeout === true,\n expectSatisfied: api?.expectSatisfied === true,\n });\n },\n (timeoutMs ?? null) as number | null\n );\n\n return {\n kind: 'injected',\n page,\n browserContext,\n browser,\n uiBridgeRegistered,\n ready: true,\n tabId,\n settleState,\n whenSettled,\n execute,\n find: (criteria?: Record<string, unknown>) => execute('find', criteria ?? {}),\n act: (id: string, request: Record<string, unknown>) =>\n execute('executeElementAction', { id, request }),\n snapshot: (options?: Record<string, unknown>) => execute('getControlSnapshot', options ?? {}),\n assert: (spec: Record<string, unknown>) => execute('aiAssert', spec),\n };\n }\n}\n\nfunction isRegistrationMetadata(value: unknown): boolean {\n if (!value || typeof value !== 'object') return false;\n const v = value as Record<string, unknown>;\n return typeof v.userId === 'string' && typeof v.sessionId === 'string';\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';\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 /** Capability strings forwarded to `app_registry` (informational). */\n capabilities?: string[];\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 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 if (this.opts.capabilities !== undefined) frame.capabilities = this.opts.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 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","/**\n * `createTransport` factory\n *\n * Pulls the transport class out of `TransportConfig.kind` and wires it up.\n * Kept as a separate module so tree-shaking can drop unused transports\n * (e.g. an api-only wrapper won't bundle headless / live code paths if the\n * user imports `ApiTransport` directly instead of routing through\n * `createTransport`).\n */\n\nimport { ApiTransport } from './transports/api.js';\nimport { HeadlessTransport } from './transports/headless.js';\nimport { HeadedTransport } from './transports/headed.js';\nimport { InjectedTransport } from './transports/injected.js';\nimport { LiveSessionTransport } from './transports/live.js';\nimport type { TransportConfig, WrapperTransport } from './types.js';\nimport { WrapperTransportError } from './types.js';\n\nexport function createTransport(config: TransportConfig): WrapperTransport {\n switch (config.kind) {\n case 'api':\n return new ApiTransport(config);\n case 'headless':\n return new HeadlessTransport(config);\n case 'headed':\n return new HeadedTransport(config);\n case 'injected':\n return new InjectedTransport(config);\n case 'live': {\n // Allow Node wrappers to pass `ws` via `options.webSocketCtor` without\n // constructing `LiveSessionTransport` directly. In the browser, leave\n // undefined so the transport picks up `globalThis.WebSocket`.\n const opts = (config.options ?? {}) as { webSocketCtor?: unknown };\n const injected =\n typeof opts.webSocketCtor === 'function'\n ? { webSocketCtor: opts.webSocketCtor as never }\n : undefined;\n return new LiveSessionTransport(config, undefined, injected);\n }\n default: {\n const kind = (config as { kind?: string }).kind ?? '<missing>';\n throw new WrapperTransportError('UNKNOWN_TRANSPORT', `Unknown transport kind '${kind}'`);\n }\n }\n}\n","/**\n * `withRetry`\n *\n * Exponential-backoff retry helper. Transports surface retryable errors\n * with `err.retryable === true` (see `WrapperTransportError`); wrappers\n * can pass their own predicate via `shouldRetry` when the default\n * retry-every-error behavior is too aggressive.\n *\n * Defaults: 3 attempts, 200 ms base, doubling delay (200 / 400 / 800).\n */\n\nimport { WrapperTransportError } from '../types.js';\n\nexport interface WithRetryOptions {\n /** Total attempt count, including the first call. Defaults to 3. */\n attempts?: number;\n /** Base delay in ms. Defaults to 200. Doubles between attempts. */\n baseMs?: number;\n /** Max cap on any single backoff wait. Defaults to 5 000 ms. */\n maxDelayMs?: number;\n /**\n * Predicate that decides whether to retry a given error. Defaults to\n * `err.retryable === true` for `WrapperTransportError`, `true`\n * otherwise (network/unknown errors are presumed transient).\n */\n shouldRetry?: (err: unknown, attempt: number) => boolean;\n /** Sleep implementation hook — defaults to `setTimeout`. Overridden in tests. */\n sleep?: (ms: number) => Promise<void>;\n}\n\nconst defaultSleep = (ms: number): Promise<void> =>\n new Promise((resolve) => setTimeout(resolve, ms));\n\nconst defaultShouldRetry = (err: unknown): boolean => {\n if (err instanceof WrapperTransportError) {\n return err.retryable;\n }\n return true;\n};\n\nexport async function withRetry<T>(fn: () => Promise<T>, opts: WithRetryOptions = {}): Promise<T> {\n const attempts = Math.max(1, opts.attempts ?? 3);\n const base = Math.max(0, opts.baseMs ?? 200);\n const cap = Math.max(base, opts.maxDelayMs ?? 5_000);\n const shouldRetry = opts.shouldRetry ?? defaultShouldRetry;\n const sleep = opts.sleep ?? defaultSleep;\n\n let lastErr: unknown;\n for (let attempt = 1; attempt <= attempts; attempt++) {\n try {\n return await fn();\n } catch (err) {\n lastErr = err;\n if (attempt === attempts || !shouldRetry(err, attempt)) {\n throw err;\n }\n const delay = Math.min(cap, base * 2 ** (attempt - 1));\n await sleep(delay);\n }\n }\n // Unreachable — loop either returns or throws — but TS can't prove it.\n throw lastErr;\n}\n","/**\n * `withAuthRefresh`\n *\n * Runs `fn` once; if it throws an auth-expired error, invokes `refresh`\n * (expected to refresh tokens / re-authenticate) and re-runs `fn` exactly\n * once. Designed for wrappers whose `api` transport handlers call\n * third-party APIs with short-lived access tokens.\n *\n * Consumers can override the detector via `isAuthError`. The default\n * treats `WrapperTransportError` with codes matching `/^(AUTH|UNAUTH|401)/i`\n * as auth errors, and errors with a numeric `status === 401` property.\n */\n\nimport { WrapperTransportError } from '../types.js';\n\nexport interface WithAuthRefreshOptions {\n /** Custom detector for \"this error means we need to refresh auth\". */\n isAuthError?: (err: unknown) => boolean;\n}\n\nconst defaultIsAuthError = (err: unknown): boolean => {\n if (err instanceof WrapperTransportError) {\n return /^(AUTH|UNAUTH|401)/i.test(err.code);\n }\n const status = (err as { status?: unknown } | null)?.status;\n if (status === 401) return true;\n const code = (err as { code?: unknown } | null)?.code;\n if (typeof code === 'string' && /^(AUTH|UNAUTH|401)/i.test(code)) return true;\n return false;\n};\n\nexport async function withAuthRefresh<T>(\n fn: () => Promise<T>,\n refresh: () => Promise<void>,\n opts: WithAuthRefreshOptions = {}\n): Promise<T> {\n const isAuthError = opts.isAuthError ?? defaultIsAuthError;\n try {\n return await fn();\n } catch (err) {\n if (!isAuthError(err)) throw err;\n await refresh();\n return fn();\n }\n}\n","/**\n * `paramSchemaOf`\n *\n * Tiny helper that produces a JSON-Schema-subset object from a plain\n * descriptor, matching the shape `useUIComponent` already exposes on its\n * `actions[].paramSchema` field. The existing SDK contract says \"no\n * runtime validation is performed\" — this helper's only job is to surface\n * parameter names and types on the runner's `/control/component/:id`\n * endpoint so callers can discover the action signature.\n *\n * Accepted descriptor values:\n * - a JSON-Schema type name string (`\"string\"`, `\"number\"`, ...)\n * - an object already shaped like JSON Schema (`{ type: \"string\", enum: [...] }`)\n * - `null` / `undefined` → field omitted\n *\n * Example:\n *\n * ```ts\n * paramSchemaOf({ email: 'string', password: 'string', remember: 'boolean' })\n * // => {\n * // type: 'object',\n * // properties: {\n * // email: { type: 'string' },\n * // password: { type: 'string' },\n * // remember: { type: 'boolean' },\n * // },\n * // required: ['email', 'password', 'remember'],\n * // additionalProperties: false,\n * // }\n * ```\n */\n\nconst PRIMITIVE_TYPES = new Set([\n 'string',\n 'number',\n 'integer',\n 'boolean',\n 'object',\n 'array',\n 'null',\n]);\n\ntype SchemaValue = string | Record<string, unknown> | null | undefined;\n\nfunction normalize(value: SchemaValue): Record<string, unknown> | null {\n if (value === null || value === undefined) return null;\n if (typeof value === 'string') {\n if (!PRIMITIVE_TYPES.has(value)) {\n // Unknown string — surface it as a type anyway so introspection\n // surfaces *something* rather than silently dropping the field.\n return { type: value };\n }\n return { type: value };\n }\n if (typeof value === 'object') {\n return { ...value };\n }\n return null;\n}\n\nexport function paramSchemaOf<T extends Record<string, SchemaValue>>(\n shape: T\n): Record<string, unknown> {\n const properties: Record<string, Record<string, unknown>> = {};\n const required: string[] = [];\n for (const [key, raw] of Object.entries(shape)) {\n const normalized = normalize(raw);\n if (!normalized) continue;\n const { optional, ...rest } = normalized as Record<string, unknown> & {\n optional?: unknown;\n };\n properties[key] = rest;\n if (optional !== true) {\n required.push(key);\n }\n }\n const schema: Record<string, unknown> = {\n type: 'object',\n properties,\n additionalProperties: false,\n };\n if (required.length > 0) {\n schema['required'] = required;\n }\n return schema;\n}\n","/**\n * `--manifest-only` mode + Node entrypoint helper.\n *\n * Wrapper packages use `runWrapperEntrypoint` as their `index-node.ts` main\n * loop. The helper covers two modes off the same `process.argv`:\n *\n * 1. Default (no `--manifest-only`): bring the transport up, log readiness,\n * and park on SIGINT/SIGTERM. Identical to what each wrapper used to\n * hand-roll.\n * 2. `--manifest-only`: print one line of JSON describing the wrapper's\n * `qontinui.wrapper` manifest plus the registered actions' paramSchemas\n * to stdout, close the transport, and `process.exit(0)` without ever\n * starting the WS server. Used by the runner's WrapperRegistry for\n * cheap discovery.\n *\n * The helper accepts the manifest object directly (sourced by the caller from\n * its own package.json) so the framework stays agnostic to package layout.\n */\nimport type { WrapperTransport } from './types.js';\n\n/**\n * Action metadata surfaced to the runner via `--manifest-only`. Each wrapper\n * supplies one of these per registered action so the runner can discover\n * paramSchemas without spawning the WS server.\n */\nexport interface ManifestActionMeta {\n id: string;\n paramSchema: Record<string, unknown>;\n /**\n * If `true`, the runner's DispatchRouter serializes calls to this action\n * via a per-(wrapper, action) mutex. Defaults to `false`.\n */\n exclusive?: boolean;\n}\n\n/** Shape of the `qontinui.wrapper` field in a wrapper's package.json. */\nexport interface WrapperManifest {\n manifestVersion: 1;\n id: string;\n displayName: string;\n description?: string;\n transport: 'api' | 'headless' | 'headed' | 'live';\n categories?: string[];\n envVars?: Array<{\n name: string;\n required?: boolean;\n secret?: boolean;\n description?: string;\n }>;\n /** Forward-compatible: extra fields are preserved verbatim. */\n [extra: string]: unknown;\n}\n\n/** Options accepted by `runWrapperEntrypoint`. */\nexport interface RunWrapperEntrypointOptions {\n /** Transport produced by `createTransport` and pre-populated with handlers. */\n transport: WrapperTransport;\n /** The wrapper's own `qontinui.wrapper` manifest (already parsed from package.json). */\n manifest: WrapperManifest;\n /** Action metadata. Order is preserved in the emitted JSON. */\n actions: ReadonlyArray<ManifestActionMeta>;\n /**\n * Friendly name used for stdout/stderr log prefixes. Defaults to\n * `manifest.id` so logs are stable across wrappers.\n */\n logName?: string;\n /**\n * Optional override for argv parsing. Defaults to `process.argv.slice(2)`.\n * Lets tests inject a fixed flag list without touching `process`.\n */\n argv?: ReadonlyArray<string>;\n}\n\n/** Stable JSON envelope written to stdout in `--manifest-only` mode. */\nexport interface ManifestOnlyEnvelope {\n manifestVersion: 1;\n manifest: WrapperManifest;\n actions: Array<{\n id: string;\n paramSchema: Record<string, unknown>;\n exclusive: boolean;\n }>;\n}\n\nfunction hasManifestOnlyFlag(argv: ReadonlyArray<string>): boolean {\n return argv.includes('--manifest-only');\n}\n\n/**\n * Print the manifest envelope to stdout and tear the transport down. Exits\n * the process with code 0 on success or 1 on transport-close failure.\n *\n * Safe to call before `transport.ready()` — the WS server is never started.\n */\nexport async function emitManifestOnly(opts: {\n transport: WrapperTransport;\n manifest: WrapperManifest;\n actions: ReadonlyArray<ManifestActionMeta>;\n}): Promise<never> {\n const envelope: ManifestOnlyEnvelope = {\n manifestVersion: 1,\n manifest: opts.manifest,\n actions: opts.actions.map((a) => ({\n id: a.id,\n paramSchema: a.paramSchema,\n exclusive: a.exclusive ?? false,\n })),\n };\n process.stdout.write(`${JSON.stringify(envelope)}\\n`);\n try {\n await opts.transport.close();\n } catch {\n // Manifest already emitted; close failure shouldn't mask the result.\n }\n process.exit(0);\n}\n\n/**\n * Single entrypoint helper that branches on `--manifest-only` or runs the\n * standard daemon loop (transport.ready() + SIGINT/SIGTERM). Returns a\n * promise that never resolves in daemon mode (we park on the signal\n * handlers) and never resolves in manifest-only mode either (we\n * `process.exit(0)`). The return type is `Promise<never>` so callers don't\n * accidentally chain code after it.\n */\nexport async function runWrapperEntrypoint(opts: RunWrapperEntrypointOptions): Promise<never> {\n const argv = opts.argv ?? process.argv.slice(2);\n const logName = opts.logName ?? opts.manifest.id;\n\n if (hasManifestOnlyFlag(argv)) {\n await emitManifestOnly({\n transport: opts.transport,\n manifest: opts.manifest,\n actions: opts.actions,\n });\n // emitManifestOnly never returns, but TS can't see that.\n throw new Error('unreachable');\n }\n\n await opts.transport.ready();\n\n // When the runner spawns the wrapper as a daemon, it expects a tiny\n // HTTP server at `http://127.0.0.1:<WRAPPER_PORT>/dispatch` so it can\n // route action calls to us. The api transport doesn't bind a port on\n // its own (it's a pure in-process dispatcher), so we open one here\n // when WRAPPER_PORT is set in the environment. Skipped silently when\n // unset — that's the \"run standalone, no runner\" mode used in tests\n // and the `_probe-*.mjs` scripts.\n const wrapperPort = parsePort(process.env['WRAPPER_PORT']);\n if (wrapperPort != null) {\n await startDispatchServer(opts.transport, wrapperPort, logName);\n }\n\n process.stdout.write(\n `[${logName}] ready (transport=${opts.transport.kind}${\n wrapperPort != null ? `, port=${wrapperPort}` : ''\n }); press Ctrl+C to exit.\\n`\n );\n\n const shutdown = async (signal: NodeJS.Signals): Promise<never> => {\n process.stdout.write(`[${logName}] received ${signal}, closing transport...\\n`);\n try {\n await opts.transport.close();\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[${logName}] close error: ${msg}\\n`);\n }\n process.exit(0);\n };\n process.on('SIGINT', (s) => {\n void shutdown(s);\n });\n process.on('SIGTERM', (s) => {\n void shutdown(s);\n });\n\n // Park forever; the signal handlers are the only exit path.\n return new Promise<never>(() => {\n /* never resolves */\n });\n}\n\nfunction parsePort(raw: string | undefined): number | null {\n if (!raw) return null;\n const n = Number(raw);\n return Number.isInteger(n) && n > 0 && n < 65_536 ? n : null;\n}\n\n/**\n * Bind a tiny HTTP server on `127.0.0.1:<port>` exposing two endpoints:\n *\n * - `GET /health` — returns `{ ok: true }` so the runner's manager can\n * poll for readiness.\n * - `POST /dispatch` — body `{ action, params }`, dispatches via the\n * transport's `HandlerRegistry`, and returns\n * `{ success: true, data: <result> }` on success or\n * `{ success: false, error: <message> }` on failure.\n *\n * Loopback-only by design — the wrapper's port is meant for the runner\n * to talk to it, never an external client. Uses Node's built-in `http`\n * module to avoid pulling in a framework dep.\n */\nasync function startDispatchServer(\n transport: WrapperTransport,\n port: number,\n logName: string\n): Promise<void> {\n const http = await import('node:http');\n const server = http.createServer((req, res) => {\n if (req.method === 'GET' && req.url === '/health') {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ ok: true }));\n return;\n }\n if (req.method === 'POST' && req.url === '/dispatch') {\n let body = '';\n req.setEncoding('utf8');\n req.on('data', (chunk: string) => {\n body += chunk;\n // Defensive cap — generous enough for any reasonable params payload.\n if (body.length > 10 * 1024 * 1024) {\n req.destroy();\n }\n });\n req.on('end', () => {\n let parsed: { action?: unknown; params?: unknown };\n try {\n parsed = JSON.parse(body || '{}') as typeof parsed;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.writeHead(400, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: `bad request body: ${msg}` }));\n return;\n }\n const action = typeof parsed.action === 'string' ? parsed.action : '';\n if (!action) {\n res.writeHead(400, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: 'missing required field: action' }));\n return;\n }\n transport\n .dispatch(action, parsed.params)\n .then((result) => {\n res.writeHead(200, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: true, data: result }));\n })\n .catch((err: unknown) => {\n const msg = err instanceof Error ? err.message : String(err);\n res.writeHead(500, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: msg }));\n });\n });\n req.on('error', () => {\n // Connection-level errors get logged to stderr; we don't have a\n // response stream to write to once the request errors.\n process.stderr.write(`[${logName}] request error during dispatch\\n`);\n });\n return;\n }\n res.writeHead(404, { 'Content-Type': 'application/json' });\n res.end(JSON.stringify({ success: false, error: 'not found' }));\n });\n\n await new Promise<void>((resolve, reject) => {\n server.once('error', reject);\n server.listen(port, '127.0.0.1', () => {\n server.removeListener('error', reject);\n resolve();\n });\n });\n}\n"]}
|
package/dist/index.js
CHANGED
|
@@ -219,36 +219,63 @@ var HeadlessTransport = class extends BaseTransport {
|
|
|
219
219
|
uiBridgeBase: typeof raw["uiBridgeBase"] === "string" ? raw["uiBridgeBase"] : void 0,
|
|
220
220
|
waitForUiBridgeMs: typeof raw["waitForUiBridgeMs"] === "number" ? raw["waitForUiBridgeMs"] : void 0,
|
|
221
221
|
userAgent: typeof raw["userAgent"] === "string" ? raw["userAgent"] : void 0,
|
|
222
|
-
forwardConsole: typeof raw["forwardConsole"] === "boolean" ? raw["forwardConsole"] : void 0
|
|
222
|
+
forwardConsole: typeof raw["forwardConsole"] === "boolean" ? raw["forwardConsole"] : void 0,
|
|
223
|
+
launchArgs: Array.isArray(raw["launchArgs"]) && raw["launchArgs"].every((a) => typeof a === "string") ? raw["launchArgs"] : void 0,
|
|
224
|
+
storageStatePath: typeof raw["storageStatePath"] === "string" ? raw["storageStatePath"] : void 0
|
|
223
225
|
};
|
|
224
226
|
}
|
|
225
227
|
async onReady() {
|
|
226
228
|
let launchHeadlessTab;
|
|
229
|
+
const headlessSpecifier = "@qontinui/ui-bridge-headless";
|
|
227
230
|
try {
|
|
228
|
-
|
|
231
|
+
const mod = await import(headlessSpecifier);
|
|
232
|
+
({ launchHeadlessTab } = mod);
|
|
229
233
|
} catch (err) {
|
|
230
234
|
const cause = err instanceof Error ? err.message : String(err);
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
235
|
+
const code = err?.code;
|
|
236
|
+
if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
|
|
237
|
+
throw new WrapperTransportError(
|
|
238
|
+
"INVALID_CONFIG",
|
|
239
|
+
`Transport kind '${this.kind}' needs the optional '@qontinui/ui-bridge-headless' peer, which is not installed. Install it and the Chromium browser:
|
|
234
240
|
npm i @qontinui/ui-bridge-headless && npx playwright install chromium
|
|
235
241
|
(bare \`npx @qontinui/ui-bridge-wrapper \u2026\` does NOT install peers \u2014 pass each peer with \`-p\`, e.g.
|
|
236
242
|
npx -y -p @qontinui/ui-bridge-wrapper -p @qontinui/ui-bridge -p @qontinui/ui-bridge-headless -p playwright ui-bridge-login-web \u2026)
|
|
237
243
|
Underlying import error: ${cause}`
|
|
244
|
+
);
|
|
245
|
+
}
|
|
246
|
+
throw new WrapperTransportError(
|
|
247
|
+
"INVALID_CONFIG",
|
|
248
|
+
`'@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}`
|
|
238
249
|
);
|
|
239
250
|
}
|
|
240
251
|
const initScripts = await this.buildInitScripts();
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
+
let tab;
|
|
253
|
+
try {
|
|
254
|
+
tab = await launchHeadlessTab({
|
|
255
|
+
url: this.options.targetUrl,
|
|
256
|
+
headless: this.headless,
|
|
257
|
+
uiBridgeBase: this.options.uiBridgeBase,
|
|
258
|
+
waitForUiBridgeMs: this.options.waitForUiBridgeMs,
|
|
259
|
+
viewportWidth: this.options.viewportWidth,
|
|
260
|
+
viewportHeight: this.options.viewportHeight,
|
|
261
|
+
userAgent: this.options.userAgent,
|
|
262
|
+
forwardConsole: this.options.forwardConsole,
|
|
263
|
+
initScripts: initScripts.length > 0 ? initScripts : void 0,
|
|
264
|
+
launchArgs: this.options.launchArgs && this.options.launchArgs.length > 0 ? this.options.launchArgs : void 0,
|
|
265
|
+
storageStatePath: this.options.storageStatePath
|
|
266
|
+
});
|
|
267
|
+
} catch (err) {
|
|
268
|
+
const cause = err instanceof Error ? err.message : String(err);
|
|
269
|
+
if (/Executable doesn't exist|browserType\.launch/i.test(cause)) {
|
|
270
|
+
throw new WrapperTransportError(
|
|
271
|
+
"INVALID_CONFIG",
|
|
272
|
+
`Playwright's Chromium browser is not installed (the '@qontinui/ui-bridge-headless' peer itself loaded fine). Run:
|
|
273
|
+
npx playwright install chromium
|
|
274
|
+
Underlying launch error: ${cause}`
|
|
275
|
+
);
|
|
276
|
+
}
|
|
277
|
+
throw err;
|
|
278
|
+
}
|
|
252
279
|
this.tab = {
|
|
253
280
|
browser: tab.browser,
|
|
254
281
|
context: tab.context,
|