@nifrajs/e2e 0.0.0-stage → 5.14.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.
Files changed (84) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/LICENSE +21 -0
  3. package/README.md +127 -2
  4. package/dist/agent.d.ts +119 -0
  5. package/dist/agent.d.ts.map +1 -0
  6. package/dist/agent.js +312 -0
  7. package/dist/agent.js.map +1 -0
  8. package/dist/cache.d.ts +84 -0
  9. package/dist/cache.d.ts.map +1 -0
  10. package/dist/cache.js +162 -0
  11. package/dist/cache.js.map +1 -0
  12. package/dist/decision.d.ts +54 -0
  13. package/dist/decision.d.ts.map +1 -0
  14. package/dist/decision.js +122 -0
  15. package/dist/decision.js.map +1 -0
  16. package/dist/engine.d.ts +75 -0
  17. package/dist/engine.d.ts.map +1 -0
  18. package/dist/engine.js +13 -0
  19. package/dist/engine.js.map +1 -0
  20. package/dist/evidence.d.ts +14 -0
  21. package/dist/evidence.d.ts.map +1 -0
  22. package/dist/evidence.js +49 -0
  23. package/dist/evidence.js.map +1 -0
  24. package/dist/expect.d.ts +28 -0
  25. package/dist/expect.d.ts.map +1 -0
  26. package/dist/expect.js +88 -0
  27. package/dist/expect.js.map +1 -0
  28. package/dist/fake.d.ts +35 -0
  29. package/dist/fake.d.ts.map +1 -0
  30. package/dist/fake.js +124 -0
  31. package/dist/fake.js.map +1 -0
  32. package/dist/index.d.ts +11 -0
  33. package/dist/index.d.ts.map +1 -0
  34. package/dist/index.js +8 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/internal/record.d.ts +3 -0
  37. package/dist/internal/record.d.ts.map +1 -0
  38. package/dist/internal/record.js +4 -0
  39. package/dist/internal/record.js.map +1 -0
  40. package/dist/locator.d.ts +53 -0
  41. package/dist/locator.d.ts.map +1 -0
  42. package/dist/locator.js +102 -0
  43. package/dist/locator.js.map +1 -0
  44. package/dist/params.d.ts +44 -0
  45. package/dist/params.d.ts.map +1 -0
  46. package/dist/params.js +93 -0
  47. package/dist/params.js.map +1 -0
  48. package/dist/playwright.d.ts +72 -0
  49. package/dist/playwright.d.ts.map +1 -0
  50. package/dist/playwright.js +165 -0
  51. package/dist/playwright.js.map +1 -0
  52. package/dist/replay.d.ts +34 -0
  53. package/dist/replay.d.ts.map +1 -0
  54. package/dist/replay.js +105 -0
  55. package/dist/replay.js.map +1 -0
  56. package/dist/route.d.ts +7 -0
  57. package/dist/route.d.ts.map +1 -0
  58. package/dist/route.js +20 -0
  59. package/dist/route.js.map +1 -0
  60. package/dist/session.d.ts +62 -0
  61. package/dist/session.d.ts.map +1 -0
  62. package/dist/session.js +98 -0
  63. package/dist/session.js.map +1 -0
  64. package/dist/snapshot.d.ts +8 -0
  65. package/dist/snapshot.d.ts.map +1 -0
  66. package/dist/snapshot.js +44 -0
  67. package/dist/snapshot.js.map +1 -0
  68. package/package.json +73 -4
  69. package/src/agent.ts +525 -0
  70. package/src/cache.ts +229 -0
  71. package/src/decision.ts +152 -0
  72. package/src/engine.ts +92 -0
  73. package/src/evidence.ts +58 -0
  74. package/src/expect.ts +171 -0
  75. package/src/fake.ts +185 -0
  76. package/src/index.ts +64 -0
  77. package/src/internal/record.ts +5 -0
  78. package/src/locator.ts +157 -0
  79. package/src/params.ts +128 -0
  80. package/src/playwright.ts +237 -0
  81. package/src/replay.ts +153 -0
  82. package/src/route.ts +26 -0
  83. package/src/session.ts +178 -0
  84. package/src/snapshot.ts +46 -0
package/dist/params.js ADDED
@@ -0,0 +1,93 @@
1
+ export class Secret {
2
+ name;
3
+ #value;
4
+ constructor(name, value) {
5
+ this.name = name;
6
+ this.#value = value;
7
+ }
8
+ static reveal(secret) {
9
+ return secret.#value;
10
+ }
11
+ toJSON() {
12
+ return `[secret:${this.name}]`;
13
+ }
14
+ toString() {
15
+ return `[secret:${this.name}]`;
16
+ }
17
+ }
18
+ export class Unique {
19
+ value;
20
+ constructor(value) {
21
+ this.value = value;
22
+ }
23
+ toString() {
24
+ return this.value;
25
+ }
26
+ }
27
+ export function unique(value) {
28
+ return new Unique(String(value));
29
+ }
30
+ const PLACEHOLDER = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
31
+ export function forModel(text, params) {
32
+ const secrets = new Set();
33
+ const out = text.replace(PLACEHOLDER, (whole, name) => {
34
+ const param = params[name];
35
+ if (param === undefined)
36
+ return whole;
37
+ if (param instanceof Secret) {
38
+ secrets.add(name);
39
+ return whole;
40
+ }
41
+ return String(param);
42
+ });
43
+ return { text: out, secrets: [...secrets] };
44
+ }
45
+ export function forPage(text, params) {
46
+ return text.replace(PLACEHOLDER, (whole, name) => {
47
+ const param = params[name];
48
+ if (param === undefined)
49
+ return whole;
50
+ return param instanceof Secret ? Secret.reveal(param) : String(param);
51
+ });
52
+ }
53
+ export function redactSecrets(text, secrets) {
54
+ let out = text;
55
+ for (const [name, secret] of secrets) {
56
+ const value = Secret.reveal(secret);
57
+ if (value !== "")
58
+ out = out.split(value).join(`{${name}}`);
59
+ }
60
+ return out;
61
+ }
62
+ export function redact(text, params) {
63
+ const secrets = [];
64
+ for (const [name, param] of Object.entries(params)) {
65
+ if (param instanceof Secret)
66
+ secrets.push([name, param]);
67
+ }
68
+ return redactSecrets(text, secrets);
69
+ }
70
+ export function keyParams(params) {
71
+ const entries = Object.entries(params)
72
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
73
+ .map(([name, param]) => [
74
+ name,
75
+ param instanceof Secret ? "<secret>" : param instanceof Unique ? "<unique>" : String(param),
76
+ ]);
77
+ return JSON.stringify(entries);
78
+ }
79
+ export function templatize(text, params) {
80
+ let out = text;
81
+ for (const [name, param] of Object.entries(params)) {
82
+ if (param instanceof Unique && param.value !== "")
83
+ out = out.split(param.value).join(`{${name}}`);
84
+ }
85
+ return out;
86
+ }
87
+ export function fillUnique(text, params) {
88
+ return text.replace(PLACEHOLDER, (whole, name) => {
89
+ const param = params[name];
90
+ return param instanceof Unique ? param.value : whole;
91
+ });
92
+ }
93
+ //# sourceMappingURL=params.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"params.js","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ import { type EngineFactory } from "./engine.js";
2
+ /** The slice of Playwright this engine calls, so the package carries no Playwright types and tests can stand in for it. */
3
+ export interface PwFinder {
4
+ getByRole(role: string, options?: {
5
+ name?: string;
6
+ exact?: boolean;
7
+ }): PwLocator;
8
+ getByLabel(text: string, options?: {
9
+ exact?: boolean;
10
+ }): PwLocator;
11
+ getByText(text: string, options?: {
12
+ exact?: boolean;
13
+ }): PwLocator;
14
+ getByTestId(id: string): PwLocator;
15
+ }
16
+ export interface PwLocator extends PwFinder {
17
+ filter(options: {
18
+ hasText: string;
19
+ }): PwLocator;
20
+ nth(index: number): PwLocator;
21
+ evaluateAll<R>(pageFunction: (elements: readonly unknown[]) => R): Promise<R>;
22
+ click(options: {
23
+ timeout: number;
24
+ }): Promise<void>;
25
+ fill(value: string, options: {
26
+ timeout: number;
27
+ }): Promise<void>;
28
+ press(key: string, options: {
29
+ timeout: number;
30
+ }): Promise<void>;
31
+ }
32
+ export interface PwPage extends PwFinder {
33
+ locator(selector: string): {
34
+ ariaSnapshot(): Promise<string>;
35
+ };
36
+ goto(url: string, options: {
37
+ waitUntil: "load";
38
+ }): Promise<unknown>;
39
+ url(): string;
40
+ evaluate<R>(expression: string): Promise<R>;
41
+ waitForSelector(selector: string, options: {
42
+ state: "attached";
43
+ timeout: number;
44
+ }): Promise<unknown>;
45
+ waitForLoadState(state: "domcontentloaded"): Promise<void>;
46
+ }
47
+ export interface PwContext {
48
+ addCookies(cookies: {
49
+ name: string;
50
+ value: string;
51
+ url: string;
52
+ }[]): Promise<void>;
53
+ newPage(): Promise<PwPage>;
54
+ close(): Promise<void>;
55
+ }
56
+ export interface PwBrowser {
57
+ newContext(): Promise<PwContext>;
58
+ close(): Promise<void>;
59
+ }
60
+ export interface PlaywrightEngineOptions {
61
+ readonly browser?: "chromium" | "firefox" | "webkit";
62
+ readonly headless?: boolean;
63
+ /** ms to wait for `data-nifra-hydrated` before `HYDRATION_TIMEOUT`. Default 5000. */
64
+ readonly hydrationTimeout?: number;
65
+ /** Replaces the Playwright launch; used by tests. */
66
+ readonly launch?: () => Promise<PwBrowser>;
67
+ /** Replaces the dynamic `import()` of `playwright`; used by tests. */
68
+ readonly load?: (specifier: string) => Promise<unknown>;
69
+ }
70
+ /** A browser engine over Playwright (`playwright` is an optional peer, loaded on first use). */
71
+ export declare function playwrightEngine(options?: PlaywrightEngineOptions): EngineFactory;
72
+ //# sourceMappingURL=playwright.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,165 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ import { E2EError, } from "./engine.js";
10
+ const HYDRATION_PROBE = "document.documentElement.hasAttribute('data-nifra-hydrated') ? 'ready' : " +
11
+ "document.querySelector('script[type=module][src]') ? 'pending' : 'none'";
12
+ function toLocator(page, selector) {
13
+ let located;
14
+ for (const step of selector) {
15
+ const scope = located ?? page;
16
+ switch (step.kind) {
17
+ case "role": {
18
+ const options = {};
19
+ if (step.name !== undefined)
20
+ options.name = step.name;
21
+ if (step.exact !== undefined)
22
+ options.exact = step.exact;
23
+ located = scope.getByRole(step.role, options);
24
+ break;
25
+ }
26
+ case "label":
27
+ located = scope.getByLabel(step.text, step.exact === undefined ? undefined : { exact: step.exact });
28
+ break;
29
+ case "text":
30
+ located = scope.getByText(step.text, step.exact === undefined ? undefined : { exact: step.exact });
31
+ break;
32
+ case "testId":
33
+ located = scope.getByTestId(step.id);
34
+ break;
35
+ case "hasText":
36
+ if (located === undefined) {
37
+ throw new E2EError("LOCATOR_NOT_FOUND", "a text filter needs a locator to narrow");
38
+ }
39
+ located = located.filter({ hasText: step.text });
40
+ break;
41
+ case "nth":
42
+ if (located === undefined) {
43
+ throw new E2EError("LOCATOR_NOT_FOUND", "nth needs a locator to pick from");
44
+ }
45
+ located = located.nth(step.index);
46
+ break;
47
+ }
48
+ }
49
+ if (located === undefined) {
50
+ throw new E2EError("LOCATOR_NOT_FOUND", "an empty locator has nothing to find");
51
+ }
52
+ return located;
53
+ }
54
+ function readElements(elements) {
55
+ return elements.map((node) => {
56
+ const el = node;
57
+ const box = el.getBoundingClientRect();
58
+ const shown = el.checkVisibility === undefined ||
59
+ el.checkVisibility({ checkVisibilityCSS: true, visibilityProperty: true });
60
+ const value = typeof el.value === "string" ? el.value : undefined;
61
+ const visible = box.width > 0 && box.height > 0 && shown;
62
+ const text = el.innerText ?? el.textContent ?? "";
63
+ return value === undefined ? { visible, text } : { visible, text, value };
64
+ });
65
+ }
66
+ function translate(error) {
67
+ const message = error instanceof Error ? error.message : String(error);
68
+ if (message.includes("strict mode violation"))
69
+ return new E2EError("LOCATOR_AMBIGUOUS", message);
70
+ if (error instanceof Error && error.name === "TimeoutError")
71
+ return new E2EError("LOCATOR_NOT_FOUND", message);
72
+ return error;
73
+ }
74
+ async function loadBrowser(options) {
75
+ if (options.launch !== undefined)
76
+ return options.launch();
77
+ const load = options.load ?? ((specifier) => import(__rewriteRelativeImportExtension(specifier)));
78
+ let loaded;
79
+ try {
80
+ loaded = (await load("playwright"));
81
+ }
82
+ catch (cause) {
83
+ throw new E2EError("ENGINE_MISSING", "@nifrajs/e2e/playwright needs the playwright package - add it to devDependencies", { cause });
84
+ }
85
+ const type = loaded[options.browser ?? "chromium"];
86
+ if (type === undefined)
87
+ throw new E2EError("ENGINE_MISSING", `playwright has no browser "${options.browser}"`);
88
+ return type.launch({ headless: options.headless ?? true });
89
+ }
90
+ async function settle(page, mode, timeout) {
91
+ if (mode === "off")
92
+ return;
93
+ let state;
94
+ try {
95
+ state = await page.evaluate(HYDRATION_PROBE);
96
+ }
97
+ catch {
98
+ await page.waitForLoadState("domcontentloaded");
99
+ state = await page.evaluate(HYDRATION_PROBE);
100
+ }
101
+ if (state !== "pending")
102
+ return;
103
+ try {
104
+ await page.waitForSelector("html[data-nifra-hydrated]", { state: "attached", timeout });
105
+ }
106
+ catch {
107
+ throw new E2EError("HYDRATION_TIMEOUT", `the page did not set data-nifra-hydrated within ${timeout} ms; pass hydration: "off" if it is not a hydrated nifra page`);
108
+ }
109
+ }
110
+ export function playwrightEngine(options = {}) {
111
+ return async (init) => {
112
+ const browser = await loadBrowser(options);
113
+ const hydrationTimeout = options.hydrationTimeout ?? 5000;
114
+ let context;
115
+ let page;
116
+ try {
117
+ context = await browser.newContext();
118
+ if (init.cookies.length > 0) {
119
+ await context.addCookies(init.cookies.map((cookie) => ({ ...cookie, url: init.baseUrl })));
120
+ }
121
+ page = await context.newPage();
122
+ }
123
+ catch (error) {
124
+ await browser.close();
125
+ throw error;
126
+ }
127
+ const engine = {
128
+ async goto(url) {
129
+ await page.goto(url, { waitUntil: "load" });
130
+ await settle(page, init.hydration, hydrationTimeout);
131
+ },
132
+ async url() {
133
+ return page.url();
134
+ },
135
+ async resolve(selector) {
136
+ return toLocator(page, selector).evaluateAll(readElements);
137
+ },
138
+ async snapshot() {
139
+ await settle(page, init.hydration, hydrationTimeout);
140
+ return page.locator("body").ariaSnapshot();
141
+ },
142
+ async act(selector, action, timeout) {
143
+ await settle(page, init.hydration, hydrationTimeout);
144
+ const locator = toLocator(page, selector);
145
+ try {
146
+ if (action.kind === "tap")
147
+ await locator.click({ timeout });
148
+ else if (action.kind === "fill")
149
+ await locator.fill(action.value, { timeout });
150
+ else
151
+ await locator.press(action.key, { timeout });
152
+ }
153
+ catch (error) {
154
+ throw translate(error);
155
+ }
156
+ },
157
+ async close() {
158
+ await context.close();
159
+ await browser.close();
160
+ },
161
+ };
162
+ return engine;
163
+ };
164
+ }
165
+ //# sourceMappingURL=playwright.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright.js","sourceRoot":"","sources":["../src/playwright.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EACL,QAAQ,GAOT,MAAM,aAAa,CAAA;AAqDpB,MAAM,eAAe,GACnB,2EAA2E;IAC3E,yEAAyE,CAAA;AAE3E,SAAS,SAAS,CAAC,IAAY,EAAE,QAAkB;IACjD,IAAI,OAA8B,CAAA;IAClC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAa,OAAO,IAAI,IAAI,CAAA;QACvC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,OAAO,GAAuC,EAAE,CAAA;gBACtD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;oBAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;gBACrD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;oBAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;gBACxD,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBAC7C,MAAK;YACP,CAAC;YACD,KAAK,OAAO;gBACV,OAAO,GAAG,KAAK,CAAC,UAAU,CACxB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAC7D,CAAA;gBACD,MAAK;YACP,KAAK,MAAM;gBACT,OAAO,GAAG,KAAK,CAAC,SAAS,CACvB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAC7D,CAAA;gBACD,MAAK;YACP,KAAK,QAAQ;gBACX,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACpC,MAAK;YACP,KAAK,SAAS;gBACZ,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,yCAAyC,CAAC,CAAA;gBACpF,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;gBAChD,MAAK;YACP,KAAK,KAAK;gBACR,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,kCAAkC,CAAC,CAAA;gBAC7E,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACjC,MAAK;QACT,CAAC;IACH,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,sCAAsC,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAGD,SAAS,YAAY,CAAC,QAA4B;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAE3B,MAAM,EAAE,GAAG,IAMV,CAAA;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAA;QACtC,MAAM,KAAK,GACT,EAAE,CAAC,eAAe,KAAK,SAAS;YAChC,EAAE,CAAC,eAAe,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5E,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACjE,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAA;QAExD,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,WAAW,IAAI,EAAE,CAAA;QACjD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC3E,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAAE,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAA;IAChG,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QACzD,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAA;IACnD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAgC;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAA;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,SAAiB,EAAE,EAAE,CAAC,MAAM,kCAAC,SAAS,EAAC,CAAC,CAAA;IACvE,IAAI,MAGH,CAAA;IACD,IAAI,CAAC;QAEH,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,CAAkB,CAAA;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,kFAAkF,EAClF,EAAE,KAAK,EAAE,CACV,CAAA;IACH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,CAAA;IAClD,IAAI,IAAI,KAAK,SAAS;QACpB,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,8BAA8B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAA;IACxF,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,IAAmB,EAAE,OAAe;IACtE,IAAI,IAAI,KAAK,KAAK;QAAE,OAAM;IAC1B,IAAI,KAAa,CAAA;IACjB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAS,eAAe,CAAC,CAAA;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAA;QAC/C,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAS,eAAe,CAAC,CAAA;IACtD,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAM;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAChB,mBAAmB,EACnB,mDAAmD,OAAO,+DAA+D,CAC1H,CAAA;IACH,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAA;QACzD,IAAI,OAAkB,CAAA;QACtB,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;YAC5F,CAAC;YACD,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACrB,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,MAAM,GAAW;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG;gBACZ,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC3C,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;YACtD,CAAC;YACD,KAAK,CAAC,GAAG;gBACP,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;YACnB,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,QAAQ;gBACpB,OAAO,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;YAC5D,CAAC;YACD,KAAK,CAAC,QAAQ;gBACZ,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;gBACpD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAA;YAC5C,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAqB,EAAE,OAAO;gBAChD,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;gBACpD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBACzC,IAAI,CAAC;oBACH,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;wBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;yBACtD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;wBAAE,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;;wBACzE,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;gBACnD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,SAAS,CAAC,KAAK,CAAC,CAAA;gBACxB,CAAC;YACH,CAAC;YACD,KAAK,CAAC,KAAK;gBACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;gBACrB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACvB,CAAC;SACF,CAAA;QACD,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}
@@ -0,0 +1,34 @@
1
+ import type { CacheEntry, RecordedAction } from "./cache.js";
2
+ import { type Clock, type Engine, type Selector } from "./engine.js";
3
+ import { type Params } from "./params.js";
4
+ /** Why a replay stopped short of finishing the recorded actions. */
5
+ export type StopReason = "target-not-found" | "ambiguous" | "end-mismatch" | "action-uncertain" | "route-mismatch";
6
+ export type ReplayOutcome = {
7
+ readonly ok: true;
8
+ } | {
9
+ readonly ok: false;
10
+ readonly reason: StopReason;
11
+ readonly detail: string;
12
+ /** The actions that did run, in order; the one that stopped the replay is not among them. */
13
+ readonly performed: readonly RecordedAction[];
14
+ };
15
+ export interface ReplayDeps {
16
+ readonly engine: Engine;
17
+ readonly clock: Clock;
18
+ readonly pollInterval: number;
19
+ readonly actionTimeout: number;
20
+ /** Origin of the app under test, so the port does not count as part of a route. */
21
+ readonly origin: string;
22
+ readonly navigate: (path: string) => Promise<void>;
23
+ /** The redacted, unpruned outline of the page. */
24
+ readonly observe: () => Promise<string>;
25
+ }
26
+ export declare function withoutNth(selector: Selector): Selector;
27
+ export declare function visibleCount(engine: Engine, selector: Selector): Promise<number>;
28
+ /**
29
+ * Re-run recorded actions with no model. Each control is found by the same role, name, label, text
30
+ * or test id it had when recorded and must match exactly as often as it did then: a replay that
31
+ * cannot find its target, or finds more than it should, stops rather than tap a near miss.
32
+ */
33
+ export declare function replayEntry(deps: ReplayDeps, entry: CacheEntry, params: Params): Promise<ReplayOutcome>;
34
+ //# sourceMappingURL=replay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE5D,OAAO,EAAE,KAAK,KAAK,EAAY,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE9E,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAG9D,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,gBAAgB,CAAA;AAEpB,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C,CAAA;AAEL,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CACxC;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAEvD;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CA8ExB"}
package/dist/replay.js ADDED
@@ -0,0 +1,105 @@
1
+ import { targetSelector } from "./decision.js";
2
+ import { E2EError } from "./engine.js";
3
+ import { checkEvidence } from "./evidence.js";
4
+ import { fillUnique, forPage } from "./params.js";
5
+ import { normalizeRoute } from "./route.js";
6
+ export function withoutNth(selector) {
7
+ return selector.filter((step) => step.kind !== "nth");
8
+ }
9
+ export async function visibleCount(engine, selector) {
10
+ return (await engine.resolve(selector)).filter((state) => state.visible).length;
11
+ }
12
+ export async function replayEntry(deps, entry, params) {
13
+ const { engine, clock } = deps;
14
+ const performed = [];
15
+ const stop = (reason, detail) => ({
16
+ ok: false,
17
+ reason,
18
+ detail,
19
+ performed,
20
+ });
21
+ const start = normalizeRoute(await engine.url(), deps.origin);
22
+ if (start !== entry.startRoute) {
23
+ return stop("route-mismatch", `started at ${start}, recorded at ${entry.startRoute}`);
24
+ }
25
+ for (const action of entry.actions) {
26
+ if (action.kind === "goto") {
27
+ try {
28
+ await deps.navigate(forPage(action.path, params));
29
+ }
30
+ catch (error) {
31
+ if (error instanceof E2EError || error instanceof TypeError) {
32
+ return stop("action-uncertain", `goto ${action.path} failed: ${error.message}`);
33
+ }
34
+ throw error;
35
+ }
36
+ performed.push(action);
37
+ continue;
38
+ }
39
+ const selector = targetSelector(action.target);
40
+ if (action.target.nth !== undefined) {
41
+ const settled = await settleMatches(deps, withoutNth(selector), action.matches);
42
+ if (settled !== undefined)
43
+ return stop(settled.reason, settled.detail);
44
+ }
45
+ try {
46
+ if (action.kind === "tap") {
47
+ await engine.act(selector, { kind: "tap" }, deps.actionTimeout);
48
+ }
49
+ else if (action.kind === "fill") {
50
+ await engine.act(selector, { kind: "fill", value: forPage(action.value, params) }, deps.actionTimeout);
51
+ }
52
+ else {
53
+ await engine.act(selector, { kind: "press", key: action.key }, deps.actionTimeout);
54
+ }
55
+ }
56
+ catch (error) {
57
+ if (!(error instanceof E2EError))
58
+ throw error;
59
+ const what = `${action.kind} ${JSON.stringify(action.target)}`;
60
+ if (error.code === "LOCATOR_NOT_FOUND")
61
+ return stop("target-not-found", `${what}: ${error.message}`);
62
+ if (error.code === "LOCATOR_AMBIGUOUS")
63
+ return stop("ambiguous", `${what}: ${error.message}`);
64
+ return stop("action-uncertain", `${what}: ${error.message}`);
65
+ }
66
+ performed.push(action);
67
+ }
68
+ const deadline = clock.now() + deps.actionTimeout;
69
+ for (;;) {
70
+ const route = normalizeRoute(await engine.url(), deps.origin);
71
+ const snapshot = await deps.observe();
72
+ let evidence;
73
+ if (route === entry.end.route) {
74
+ evidence = checkEvidence({
75
+ appeared: entry.end.appeared.map((line) => fillUnique(line, params)),
76
+ disappeared: entry.end.disappeared.map((line) => fillUnique(line, params)),
77
+ }, snapshot);
78
+ }
79
+ else {
80
+ evidence = { ok: false, detail: `ended at ${route}, recorded ${entry.end.route}` };
81
+ }
82
+ if (evidence.ok)
83
+ return { ok: true };
84
+ const remaining = deadline - clock.now();
85
+ if (remaining <= 0)
86
+ return stop("end-mismatch", evidence.detail);
87
+ await clock.sleep(Math.min(deps.pollInterval, remaining));
88
+ }
89
+ }
90
+ async function settleMatches(deps, selector, expected) {
91
+ const deadline = deps.clock.now() + deps.actionTimeout;
92
+ for (;;) {
93
+ const count = await visibleCount(deps.engine, selector);
94
+ if (count === expected)
95
+ return undefined;
96
+ const remaining = deadline - deps.clock.now();
97
+ if (remaining <= 0) {
98
+ return count === 0
99
+ ? { reason: "target-not-found", detail: "no visible element matches the recorded target" }
100
+ : { reason: "ambiguous", detail: `${count} elements match, ${expected} did when recorded` };
101
+ }
102
+ await deps.clock.sleep(Math.min(deps.pollInterval, remaining));
103
+ }
104
+ }
105
+ //# sourceMappingURL=replay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Where a page is, for deciding whether a recording still starts and ends in the same place: the
3
+ * path and query with id-like parts replaced by `:id`, the origin left out when it is the app's own
4
+ * (the port changes every run), the hash dropped.
5
+ */
6
+ export declare function normalizeRoute(url: string, appOrigin: string): string;
7
+ //# sourceMappingURL=route.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYrE"}
package/dist/route.js ADDED
@@ -0,0 +1,20 @@
1
+ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
2
+ function varies(part) {
3
+ if (/^\d+$/.test(part) || UUID.test(part) || /^[0-9a-f]{16,}$/i.test(part))
4
+ return true;
5
+ return part.length >= 20 && /\d/.test(part) && /[A-Za-z]/.test(part);
6
+ }
7
+ export function normalizeRoute(url, appOrigin) {
8
+ const target = new URL(url);
9
+ const origin = target.origin === appOrigin ? "" : target.origin;
10
+ const path = target.pathname
11
+ .split("/")
12
+ .map((part) => (varies(part) ? ":id" : part))
13
+ .join("/");
14
+ const query = [...target.searchParams.entries()]
15
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
16
+ .map(([key, value]) => `${key}=${varies(value) ? ":id" : value}`)
17
+ .join("&");
18
+ return `${origin}${path}${query === "" ? "" : `?${query}`}`;
19
+ }
20
+ //# sourceMappingURL=route.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,iEAAiE,CAAA;AAG9E,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACvF,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtE,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,SAAiB;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ;SACzB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5C,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;SAC7C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;SAChE,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,EAAE,CAAA;AAC7D,CAAC"}
@@ -0,0 +1,62 @@
1
+ import { type E2EApp, type E2EPaths } from "@nifrajs/testing/e2e";
2
+ import { type Agent, type E2EModel } from "./agent.js";
3
+ import { type CacheOptions } from "./cache.js";
4
+ import { type Clock, type EngineFactory, type HydrationMode } from "./engine.js";
5
+ import type { UrlSource } from "./expect.js";
6
+ import { Screen } from "./locator.js";
7
+ /** The `:name` segments of a route path. */
8
+ export type PathParams<P extends string> = P extends `${string}:${infer Rest}` ? Rest extends `${infer Name}/${infer Tail}` ? Name | PathParams<`/${Tail}`> : Rest : never;
9
+ export interface OpenOptions<P extends string> {
10
+ readonly params?: Record<PathParams<P>, string | number>;
11
+ readonly query?: Readonly<Record<string, string | number | boolean>>;
12
+ }
13
+ /** A route with `:params` must be given them; one without takes only an optional query. */
14
+ export type OpenArgs<P extends string> = [PathParams<P>] extends [never] ? [options?: {
15
+ readonly query?: OpenOptions<P>["query"];
16
+ }] : [
17
+ options: {
18
+ readonly params: Record<PathParams<P>, string | number>;
19
+ readonly query?: OpenOptions<P>["query"];
20
+ }
21
+ ];
22
+ export interface E2EOptions {
23
+ /** Defaults to the Playwright engine (`@nifrajs/e2e/playwright`), which needs `playwright` installed. */
24
+ readonly engine?: EngineFactory;
25
+ /** A `testSession().cookies` jar (or anything with `header()`): logs the browser in without a UI login. */
26
+ readonly cookies?: {
27
+ header(): string;
28
+ };
29
+ readonly hydration?: HydrationMode;
30
+ /** ms an action waits for its element. Default 5000. */
31
+ readonly actionTimeout?: number;
32
+ /** ms an assertion retries before it fails. Default 5000. */
33
+ readonly assertionTimeout?: number;
34
+ readonly pollInterval?: number;
35
+ readonly clock?: Clock;
36
+ /** Answers agent steps. Without it `t.agent` rejects with `MODEL_MISSING`; locator tests need none. */
37
+ readonly model?: E2EModel | undefined;
38
+ /** Words every agent step should know: the product, its jargon, what a plan is called. */
39
+ readonly agentContext?: string;
40
+ /** Characters of page outline one model call may carry. Default 12000. */
41
+ readonly snapshotChars?: number;
42
+ /** The replay cache for `agent.act`. On by default; `false` turns it off. */
43
+ readonly cache?: CacheOptions | false;
44
+ }
45
+ export interface E2ESession<App> extends UrlSource, AsyncDisposable {
46
+ readonly baseUrl: string;
47
+ readonly screen: Screen;
48
+ readonly agent: Agent;
49
+ open<P extends E2EPaths<App>>(path: P, ...args: OpenArgs<P>): Promise<void>;
50
+ close(): Promise<void>;
51
+ }
52
+ export declare function parseCookieHeader(header: string): {
53
+ name: string;
54
+ value: string;
55
+ }[];
56
+ export declare function buildPath(pattern: string, params: Readonly<Record<string, string | number>> | undefined, query: Readonly<Record<string, string | number | boolean>> | undefined): string;
57
+ /**
58
+ * Serve `app` on an ephemeral port and drive it from a browser. The session is `AsyncDisposable`:
59
+ * `await using t = await e2e(app)` closes the browser and the server at scope exit.
60
+ */
61
+ export declare function e2e<App extends E2EApp>(app: App, options?: E2EOptions): Promise<E2ESession<App>>;
62
+ //# sourceMappingURL=session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}