@quiesco/protocol 0.1.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/actions.d.ts CHANGED
@@ -156,6 +156,10 @@ export type ActionSpec = {
156
156
  fingers: TimedPoint[][];
157
157
  } | {
158
158
  type: 'pressBack';
159
+ }
160
+ /** What a user does to go back (issue #4): Android back, browser back, iOS back button or edge swipe. */
161
+ | {
162
+ type: 'goBack';
159
163
  } | {
160
164
  type: 'openUrl';
161
165
  url: string;
@@ -234,5 +238,7 @@ export type HostInput = {
234
238
  url: string;
235
239
  } | {
236
240
  kind: 'back';
241
+ } | {
242
+ kind: 'goBack';
237
243
  };
238
244
  //# sourceMappingURL=actions.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}
package/dist/element.d.ts CHANGED
@@ -36,6 +36,23 @@ export interface ElementSummary {
36
36
  props: Record<string, JsonValue>;
37
37
  }
38
38
  /** Compact element tree for diagnostics (`getTree`). */
39
+ /**
40
+ * One entry of the condensed element list in failure evidence (issue #2): only elements with a testID, a
41
+ * label or text of their own, in tree order.
42
+ */
43
+ export interface ElementBrief {
44
+ type: string;
45
+ testID?: string;
46
+ label?: string;
47
+ /** Text of the element itself (not its descendants). */
48
+ text?: string;
49
+ role?: string;
50
+ visible: boolean;
51
+ /** Why it is not visible (see the failure messages). */
52
+ hidden?: string;
53
+ /** Rounded rect. */
54
+ rect?: Rect;
55
+ }
39
56
  export interface TreeNode {
40
57
  type: string;
41
58
  testID?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,+GAA+G;AAC/G,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,4GAA4G;IAC5G,OAAO,EAAE,OAAO,CAAC;IACjB,uHAAuH;IACvH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oBAAoB;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB"}
1
+ {"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,+GAA+G;AAC/G,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,4GAA4G;IAC5G,OAAO,EAAE,OAAO,CAAC;IACjB,uHAAuH;IACvH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED,wDAAwD;AACxD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oBAAoB;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB"}
package/dist/index.d.ts CHANGED
@@ -10,4 +10,5 @@ export * from './matcher.js';
10
10
  export * from './messages.js';
11
11
  export * from './methods.js';
12
12
  export * from './webview.js';
13
+ export * from './run-events.js';
13
14
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
package/dist/index.js CHANGED
@@ -10,4 +10,5 @@ export * from './matcher.js';
10
10
  export * from './messages.js';
11
11
  export * from './methods.js';
12
12
  export * from './webview.js';
13
+ export * from './run-events.js';
13
14
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
package/dist/json.d.ts CHANGED
@@ -3,4 +3,40 @@ export type JsonPrimitive = string | number | boolean | null;
3
3
  export type JsonValue = JsonPrimitive | JsonValue[] | {
4
4
  [key: string]: JsonValue;
5
5
  };
6
+ /**
7
+ * `T` when it survives JSON unchanged, checked structurally (issue #6): unlike `JsonValue`, this accepts
8
+ * interfaces, which have no implicit index signature. Functions, symbols, bigints, `undefined` values and
9
+ * class instances with methods (Date, Map) map to `never`, so passing them is a type error. Optional
10
+ * properties stay optional (a missing key is fine; the agent rejects an explicit `undefined`).
11
+ */
12
+ export type JsonCompatible<T> = T extends JsonPrimitive ? T : T extends (...args: never[]) => unknown ? never : T extends readonly (infer U)[] ? readonly JsonCompatible<U>[] : T extends object ? {
13
+ [K in keyof T]: K extends string ? JsonCompatible<T[K]> : never;
14
+ } : never;
15
+ /**
16
+ * Backdoors the app registers, by name (issue #6). Empty by default: names, arguments and results are then
17
+ * only checked for being JSON. Declare them once, in a file both the app and the tests compile:
18
+ *
19
+ * declare module '@quiesco/agent' {
20
+ * interface Backdoors {
21
+ * 'students.set': (list: Student[]) => void;
22
+ * 'students.get': (id: string) => Student | null;
23
+ * }
24
+ * }
25
+ *
26
+ * and `quiesco.backdoor(...)` in the app and `app.backdoor(...)` in the tests check the name, the arguments
27
+ * and the result. (`@quiesco/core` and `@quiesco/protocol` work as the module name too: it is one
28
+ * interface.)
29
+ */
30
+ export interface Backdoors {
31
+ }
32
+ /** Backdoor names: any string while `Backdoors` is empty, else only the declared ones. */
33
+ export type BackdoorName = [keyof Backdoors] extends [never] ? string : Extract<keyof Backdoors, string>;
34
+ type DeclaredFn<K> = K extends keyof Backdoors ? (Backdoors[K] extends (...args: infer A) => infer R ? (...args: A) => R : never) : never;
35
+ /** What `app.backdoor(name, …)` resolves to: the declared result (`null` for none), else `T`. */
36
+ export type BackdoorResult<K, T> = K extends keyof Backdoors ? (Awaited<ReturnType<DeclaredFn<K>>> extends void | undefined ? null : Awaited<ReturnType<DeclaredFn<K>>>) : T;
37
+ /** The arguments of a declared backdoor. */
38
+ export type BackdoorParams<K> = Parameters<DeclaredFn<K>>;
39
+ /** What the app may register under `name`: the declared function (or an async version of it). */
40
+ export type BackdoorImpl<K> = K extends keyof Backdoors ? (...args: BackdoorParams<K>) => ReturnType<DeclaredFn<K>> | Promise<Awaited<ReturnType<DeclaredFn<K>>>> : (...args: never[]) => unknown;
41
+ export {};
6
42
  //# sourceMappingURL=json.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC"}
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,GACnD,CAAC,GACD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GACrC,KAAK,GACL,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC5B,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAC5B,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAAE,GACnE,KAAK,CAAC;AAEhB;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,SAAS;CAAG;AAE7B,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,SAAS,EAAE,MAAM,CAAC,CAAC;AAEzG,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAE1I,iGAAiG;AACjG,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE7K,4CAA4C;AAC5C,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,iGAAiG;AACjG,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC"}
package/dist/methods.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import type { ActionMode, ActionSpec, HostInput } from './actions.js';
2
2
  import type { AssertionSpec } from './assertions.js';
3
3
  import type { AgentConfig } from './config.js';
4
- import type { ElementSummary, Rect, TreeNode } from './element.js';
4
+ import type { ElementBrief, ElementSummary, Rect, TreeNode } from './element.js';
5
5
  import type { JsonValue } from './json.js';
6
6
  import type { Matcher } from './matcher.js';
7
7
  export type Platform = 'ios' | 'android' | 'web';
@@ -64,10 +64,28 @@ export interface AgentMethods {
64
64
  root: TreeNode | null;
65
65
  };
66
66
  };
67
+ /** The condensed element list for failure evidence, with the route (issue #2). */
68
+ listElements: {
69
+ params: Record<string, never>;
70
+ result: {
71
+ route: string | null;
72
+ elements: ElementBrief[];
73
+ truncated: boolean;
74
+ };
75
+ };
76
+ /** `route`: the focused route the reset ended on (Expo Router apps; issue #1). */
67
77
  reset: {
68
78
  params: Record<string, never>;
69
79
  result: {
70
80
  durationMs: number;
81
+ route?: string;
82
+ };
83
+ };
84
+ /** The focused route (`/students/new`), null without Expo Router (issues #2, #9). */
85
+ route: {
86
+ params: Record<string, never>;
87
+ result: {
88
+ route: string | null;
71
89
  };
72
90
  };
73
91
  backdoor: {
@@ -227,6 +245,16 @@ export interface DeviceInfo {
227
245
  /** The JS engine's default locale (`Intl.DateTimeFormat().resolvedOptions().locale`). */
228
246
  locale?: string;
229
247
  }
248
+ /**
249
+ * Where the app's JS bundle comes from (issue #3), written by `withQuiesco()` when Metro loads its config.
250
+ * `builtAt` (ms since epoch): the dev server's start, or the export. `watching`: whether source changes
251
+ * reach the app; `reason` when not: `CI` (Metro started with CI set) or `export` (a one-off bundle).
252
+ */
253
+ export interface BundleInfo {
254
+ builtAt: number;
255
+ watching: boolean;
256
+ reason?: 'CI' | 'export';
257
+ }
230
258
  /** Methods the AGENT calls on the HOST. */
231
259
  export interface HostMethods {
232
260
  hello: {
@@ -237,6 +265,8 @@ export interface HostMethods {
237
265
  agentVersion: string;
238
266
  /** Whether @quiesco/native is linked (enables the `native` action mode). */
239
267
  nativeModule: boolean;
268
+ /** The JS bundle (issue #3); missing without `withQuiesco()` in the Metro config. */
269
+ bundle?: BundleInfo;
240
270
  };
241
271
  result: {
242
272
  accepted: true;
@@ -1 +1 @@
1
- {"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,159 @@
1
+ /**
2
+ * Run events: what a test runner's Quiesco reporter tells the `quiesco` process while tests run (the
3
+ * progress bar and `quiesco ui`). Runner independent: the cucumber formatter, the Vitest reporter and
4
+ * the Jest reporter all map their own events onto these.
5
+ *
6
+ * Wire format: NDJSON (one JSON object per line) over a local socket whose address the CLI passes in
7
+ * the QUIESCO_EVENTS environment variable (a Unix socket path, or a `\\.\pipe\…` name on Windows).
8
+ * Without the variable a reporter sends nothing.
9
+ *
10
+ * Several connections may send events for one run: the reporter in the runner's main process, and
11
+ * test workers that add evidence (`test:evidence`). Tests are matched by `id`.
12
+ */
13
+ /** Bumped on any incompatible change to the run events. Sent in `hello`. */
14
+ export declare const RUN_EVENTS_PROTOCOL = 1;
15
+ /** Environment variable holding the socket address. */
16
+ export declare const RUN_EVENTS_ENV = "QUIESCO_EVENTS";
17
+ export type RunnerName = 'cucumber' | 'vitest' | 'jest';
18
+ /**
19
+ * - `pending`: cucumber, a pending step (Jest's skipped tests are sent as `skipped`).
20
+ * - `undefined`: cucumber, a step without a definition.
21
+ * - `notRun`: never finished (the run ended or was interrupted first). Set by the consumer, never sent.
22
+ */
23
+ export type TestStatus = 'passed' | 'failed' | 'skipped' | 'todo' | 'pending' | 'undefined' | 'notRun';
24
+ export interface TestRef {
25
+ /**
26
+ * Stable across runs of the same files: cucumber `uri:line`; Vitest its test id; Jest the file and
27
+ * the title path joined with NUL.
28
+ */
29
+ id: string;
30
+ /** Path relative to the project root, `/`-separated. */
31
+ file: string;
32
+ /** 1-based line of the test (the Examples row for a Scenario Outline), when the runner knows it. */
33
+ line?: number;
34
+ /** The test's own title. */
35
+ name: string;
36
+ /** Group titles and the test title, outermost first (cucumber: [feature, rule?, scenario]). */
37
+ path: readonly string[];
38
+ }
39
+ export interface RunError {
40
+ message: string;
41
+ stack?: string;
42
+ /** Expected / actual difference, already formatted by the runner. */
43
+ diff?: string;
44
+ }
45
+ export interface RunCounts {
46
+ passed: number;
47
+ failed: number;
48
+ skipped: number;
49
+ todo: number;
50
+ pending: number;
51
+ undefined: number;
52
+ notRun: number;
53
+ }
54
+ export interface RunEvents {
55
+ /** First event on every connection. */
56
+ hello: {
57
+ protocol: number;
58
+ runner: RunnerName;
59
+ runnerVersion?: string;
60
+ pid: number;
61
+ };
62
+ /**
63
+ * The run starts. `total` is what the runner knows at this point: exact for cucumber, an estimate for
64
+ * Vitest (static parse), the number of tests known so far for Jest (0). `files` are the test files.
65
+ */
66
+ 'run:start': {
67
+ total: number;
68
+ totalIsEstimate: boolean;
69
+ files: readonly string[];
70
+ workers?: number;
71
+ };
72
+ /** A better total (a file was collected). */
73
+ 'total:update': {
74
+ total: number;
75
+ totalIsEstimate: boolean;
76
+ };
77
+ 'file:start': {
78
+ file: string;
79
+ };
80
+ /** `error`: the file failed outside any test (syntax error, error while collecting, BeforeAll). */
81
+ 'file:end': {
82
+ file: string;
83
+ error?: RunError;
84
+ };
85
+ /** `worker`: 0-based index of the worker (device) running the test, when the runner tells. `startedAt`: epoch ms. */
86
+ 'test:start': {
87
+ test: TestRef;
88
+ worker?: number;
89
+ attempt: number;
90
+ startedAt: number;
91
+ };
92
+ 'test:end': {
93
+ test: TestRef;
94
+ status: Exclude<TestStatus, 'notRun'>;
95
+ durationMs: number;
96
+ error?: RunError;
97
+ /** The runner will run this test again (retry): do not count it yet. */
98
+ willRetry: boolean;
99
+ /** Console output of the test, when the runner keeps it per test. */
100
+ logs?: readonly {
101
+ stream: 'stdout' | 'stderr';
102
+ text: string;
103
+ }[];
104
+ worker?: number;
105
+ };
106
+ /** Quiesco evidence files of a failed test (absolute paths), sent from the worker that ran it. */
107
+ 'test:evidence': {
108
+ testId: string;
109
+ files: readonly string[];
110
+ };
111
+ /** An error outside any file (cucumber BeforeAll, Vitest unhandled errors). */
112
+ 'run:error': {
113
+ error: RunError;
114
+ };
115
+ 'run:end': {
116
+ success: boolean;
117
+ interrupted: boolean;
118
+ durationMs: number;
119
+ };
120
+ }
121
+ export type RunEventType = keyof RunEvents;
122
+ export type RunEvent = {
123
+ [K in RunEventType]: {
124
+ type: K;
125
+ } & RunEvents[K];
126
+ }[RunEventType];
127
+ export type RunEventOf<K extends RunEventType> = Extract<RunEvent, {
128
+ type: K;
129
+ }>;
130
+ export declare function isRunEvent(value: unknown): value is RunEvent;
131
+ /** One NDJSON line (with its newline). JSON.stringify never emits a raw newline. */
132
+ export declare function encodeRunEvent(event: RunEvent): string;
133
+ export interface RunEventDecoder {
134
+ /** Feed text as it arrives; complete lines are decoded at once. */
135
+ push(chunk: string): void;
136
+ /** The connection ended: decode a last line without its newline. */
137
+ end(): void;
138
+ }
139
+ /**
140
+ * Splits NDJSON text into events. Lines that are not JSON, or not a known event (a newer reporter),
141
+ * go to `onInvalid` and are skipped: a bad line never stops the stream.
142
+ */
143
+ export declare function createRunEventDecoder(onEvent: (event: RunEvent) => void, onInvalid?: (line: string, reason: string) => void): RunEventDecoder;
144
+ export declare function emptyCounts(): RunCounts;
145
+ /**
146
+ * The tests a runner would run, listed without running them (`quiesco list`, the UI's test tree). Ids
147
+ * match the run events' test ids. Vitest lists `test.each` once (its rows appear after a run).
148
+ */
149
+ export interface TestList {
150
+ runner: RunnerName;
151
+ files: readonly string[];
152
+ tests: readonly TestRef[];
153
+ /** Files that could not be listed (syntax error, error while collecting). */
154
+ errors: readonly {
155
+ file?: string;
156
+ message: string;
157
+ }[];
158
+ }
159
+ //# sourceMappingURL=run-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-events.d.ts","sourceRoot":"","sources":["../src/run-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,uDAAuD;AACvD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEvG,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF;;;OAGG;IACH,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrG,6CAA6C;IAC7C,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,mGAAmG;IACnG,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC/C,qHAAqH;IACrH,YAAY,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,UAAU,EAAE;QACV,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;QACjB,wEAAwE;QACxE,SAAS,EAAE,OAAO,CAAC;QACnB,qEAAqE;QACrE,IAAI,CAAC,EAAE,SAAS;YAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAChE,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,kGAAkG;IAClG,eAAe,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9D,+EAA+E;IAC/E,WAAW,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;IACjC,SAAS,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC;AAC3C,MAAM,MAAM,QAAQ,GAAG;KAAG,CAAC,IAAI,YAAY,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC,CAAC;CAAE,CAAC,YAAY,CAAC,CAAC;AACzF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAehF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,GAAG,IAAI,IAAI,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,EAAE,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAe,GAAG,eAAe,CA8BvJ;AAED,wBAAgB,WAAW,IAAI,SAAS,CAEvC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,EAAE,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD"}
@@ -0,0 +1,78 @@
1
+ /**
2
+ * Run events: what a test runner's Quiesco reporter tells the `quiesco` process while tests run (the
3
+ * progress bar and `quiesco ui`). Runner independent: the cucumber formatter, the Vitest reporter and
4
+ * the Jest reporter all map their own events onto these.
5
+ *
6
+ * Wire format: NDJSON (one JSON object per line) over a local socket whose address the CLI passes in
7
+ * the QUIESCO_EVENTS environment variable (a Unix socket path, or a `\\.\pipe\…` name on Windows).
8
+ * Without the variable a reporter sends nothing.
9
+ *
10
+ * Several connections may send events for one run: the reporter in the runner's main process, and
11
+ * test workers that add evidence (`test:evidence`). Tests are matched by `id`.
12
+ */
13
+ /** Bumped on any incompatible change to the run events. Sent in `hello`. */
14
+ export const RUN_EVENTS_PROTOCOL = 1;
15
+ /** Environment variable holding the socket address. */
16
+ export const RUN_EVENTS_ENV = 'QUIESCO_EVENTS';
17
+ const RUN_EVENT_TYPES = new Set([
18
+ 'hello',
19
+ 'run:start',
20
+ 'total:update',
21
+ 'file:start',
22
+ 'file:end',
23
+ 'test:start',
24
+ 'test:end',
25
+ 'test:evidence',
26
+ 'run:error',
27
+ 'run:end',
28
+ ]);
29
+ export function isRunEvent(value) {
30
+ return typeof value === 'object' && value !== null && typeof value.type === 'string' && RUN_EVENT_TYPES.has(value.type);
31
+ }
32
+ /** One NDJSON line (with its newline). JSON.stringify never emits a raw newline. */
33
+ export function encodeRunEvent(event) {
34
+ return `${JSON.stringify(event)}\n`;
35
+ }
36
+ /**
37
+ * Splits NDJSON text into events. Lines that are not JSON, or not a known event (a newer reporter),
38
+ * go to `onInvalid` and are skipped: a bad line never stops the stream.
39
+ */
40
+ export function createRunEventDecoder(onEvent, onInvalid = () => { }) {
41
+ let buffer = '';
42
+ const line = (text) => {
43
+ if (text.trim() === '')
44
+ return;
45
+ let value;
46
+ try {
47
+ value = JSON.parse(text);
48
+ }
49
+ catch (e) {
50
+ onInvalid(text, e.message);
51
+ return;
52
+ }
53
+ if (isRunEvent(value))
54
+ onEvent(value);
55
+ else
56
+ onInvalid(text, 'not a known run event');
57
+ };
58
+ return {
59
+ push(chunk) {
60
+ buffer += chunk;
61
+ let i;
62
+ while ((i = buffer.indexOf('\n')) !== -1) {
63
+ const text = buffer.slice(0, i);
64
+ buffer = buffer.slice(i + 1);
65
+ line(text);
66
+ }
67
+ },
68
+ end() {
69
+ const rest = buffer;
70
+ buffer = '';
71
+ line(rest);
72
+ },
73
+ };
74
+ }
75
+ export function emptyCounts() {
76
+ return { passed: 0, failed: 0, skipped: 0, todo: 0, pending: 0, undefined: 0, notRun: 0 };
77
+ }
78
+ //# sourceMappingURL=run-events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-events.js","sourceRoot":"","sources":["../src/run-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAiF/C,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAe;IACjE,OAAO;IACP,WAAW;IACX,cAAc;IACd,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,UAAU;IACV,eAAe;IACf,WAAW;IACX,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC;AACxK,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;AACtC,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAkC,EAAE,YAAoD,GAAG,EAAE,GAAE,CAAC;IACpI,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO;QAC/B,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,CAAC,IAAI,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;;YACjC,SAAS,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,OAAO;QACL,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,CAAS,CAAC;YACd,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;QACD,GAAG;YACD,MAAM,IAAI,GAAG,MAAM,CAAC;YACpB,MAAM,GAAG,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC5F,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quiesco/protocol",
3
- "version": "0.1.1",
3
+ "version": "0.3.0",
4
4
  "description": "Shared protocol types and constants between the Quiesco host and agent",
5
5
  "license": "MIT",
6
6
  "author": "h2nology",
package/src/actions.ts CHANGED
@@ -76,6 +76,8 @@ export type ActionSpec =
76
76
  */
77
77
  | { type: 'multiTouch'; matcher?: Matcher; fingers: TimedPoint[][] }
78
78
  | { type: 'pressBack' }
79
+ /** What a user does to go back (issue #4): Android back, browser back, iOS back button or edge swipe. */
80
+ | { type: 'goBack' }
79
81
  | { type: 'openUrl'; url: string }
80
82
  | { type: 'dismissKeyboard' };
81
83
 
@@ -104,4 +106,5 @@ export type HostInput =
104
106
  /** Set the value of the `<input>` at (x, y) as a user would (Playwright fill: date / time inputs). */
105
107
  | { kind: 'fill'; x: number; y: number; value: string }
106
108
  | { kind: 'navigate'; url: string }
107
- | { kind: 'back' };
109
+ | { kind: 'back' }
110
+ | { kind: 'goBack' };
package/src/element.ts CHANGED
@@ -39,6 +39,24 @@ export interface ElementSummary {
39
39
  }
40
40
 
41
41
  /** Compact element tree for diagnostics (`getTree`). */
42
+ /**
43
+ * One entry of the condensed element list in failure evidence (issue #2): only elements with a testID, a
44
+ * label or text of their own, in tree order.
45
+ */
46
+ export interface ElementBrief {
47
+ type: string;
48
+ testID?: string;
49
+ label?: string;
50
+ /** Text of the element itself (not its descendants). */
51
+ text?: string;
52
+ role?: string;
53
+ visible: boolean;
54
+ /** Why it is not visible (see the failure messages). */
55
+ hidden?: string;
56
+ /** Rounded rect. */
57
+ rect?: Rect;
58
+ }
59
+
42
60
  export interface TreeNode {
43
61
  type: string;
44
62
  testID?: string;
package/src/index.ts CHANGED
@@ -10,3 +10,4 @@ export * from './matcher.js';
10
10
  export * from './messages.js';
11
11
  export * from './methods.js';
12
12
  export * from './webview.js';
13
+ export * from './run-events.js';
package/src/json.ts CHANGED
@@ -1,3 +1,51 @@
1
1
  /** Any value that survives JSON.stringify / JSON.parse unchanged. */
2
2
  export type JsonPrimitive = string | number | boolean | null;
3
3
  export type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };
4
+
5
+ /**
6
+ * `T` when it survives JSON unchanged, checked structurally (issue #6): unlike `JsonValue`, this accepts
7
+ * interfaces, which have no implicit index signature. Functions, symbols, bigints, `undefined` values and
8
+ * class instances with methods (Date, Map) map to `never`, so passing them is a type error. Optional
9
+ * properties stay optional (a missing key is fine; the agent rejects an explicit `undefined`).
10
+ */
11
+ export type JsonCompatible<T> = T extends JsonPrimitive
12
+ ? T
13
+ : T extends (...args: never[]) => unknown
14
+ ? never
15
+ : T extends readonly (infer U)[]
16
+ ? readonly JsonCompatible<U>[]
17
+ : T extends object
18
+ ? { [K in keyof T]: K extends string ? JsonCompatible<T[K]> : never }
19
+ : never;
20
+
21
+ /**
22
+ * Backdoors the app registers, by name (issue #6). Empty by default: names, arguments and results are then
23
+ * only checked for being JSON. Declare them once, in a file both the app and the tests compile:
24
+ *
25
+ * declare module '@quiesco/agent' {
26
+ * interface Backdoors {
27
+ * 'students.set': (list: Student[]) => void;
28
+ * 'students.get': (id: string) => Student | null;
29
+ * }
30
+ * }
31
+ *
32
+ * and `quiesco.backdoor(...)` in the app and `app.backdoor(...)` in the tests check the name, the arguments
33
+ * and the result. (`@quiesco/core` and `@quiesco/protocol` work as the module name too: it is one
34
+ * interface.)
35
+ */
36
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type
37
+ export interface Backdoors {}
38
+
39
+ /** Backdoor names: any string while `Backdoors` is empty, else only the declared ones. */
40
+ export type BackdoorName = [keyof Backdoors] extends [never] ? string : Extract<keyof Backdoors, string>;
41
+
42
+ type DeclaredFn<K> = K extends keyof Backdoors ? (Backdoors[K] extends (...args: infer A) => infer R ? (...args: A) => R : never) : never;
43
+
44
+ /** What `app.backdoor(name, …)` resolves to: the declared result (`null` for none), else `T`. */
45
+ export type BackdoorResult<K, T> = K extends keyof Backdoors ? (Awaited<ReturnType<DeclaredFn<K>>> extends void | undefined ? null : Awaited<ReturnType<DeclaredFn<K>>>) : T;
46
+
47
+ /** The arguments of a declared backdoor. */
48
+ export type BackdoorParams<K> = Parameters<DeclaredFn<K>>;
49
+
50
+ /** What the app may register under `name`: the declared function (or an async version of it). */
51
+ export type BackdoorImpl<K> = K extends keyof Backdoors ? (...args: BackdoorParams<K>) => ReturnType<DeclaredFn<K>> | Promise<Awaited<ReturnType<DeclaredFn<K>>>> : (...args: never[]) => unknown;
package/src/methods.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import type { ActionMode, ActionSpec, HostInput } from './actions.js';
2
2
  import type { AssertionSpec } from './assertions.js';
3
3
  import type { AgentConfig } from './config.js';
4
- import type { ElementSummary, Rect, TreeNode } from './element.js';
4
+ import type { ElementBrief, ElementSummary, Rect, TreeNode } from './element.js';
5
5
  import type { JsonValue } from './json.js';
6
6
  import type { Matcher } from './matcher.js';
7
7
 
@@ -37,7 +37,12 @@ export interface AgentMethods {
37
37
  assert: { params: { assertion: AssertionSpec } & SyncOption; result: { elements: ElementSummary[] } & SyncTiming };
38
38
  waitForIdle: { params: { timeoutMs?: number }; result: { waitedMs: number } };
39
39
  getTree: { params: Record<string, never>; result: { root: TreeNode | null } };
40
- reset: { params: Record<string, never>; result: { durationMs: number } };
40
+ /** The condensed element list for failure evidence, with the route (issue #2). */
41
+ listElements: { params: Record<string, never>; result: { route: string | null; elements: ElementBrief[]; truncated: boolean } };
42
+ /** `route`: the focused route the reset ended on (Expo Router apps; issue #1). */
43
+ reset: { params: Record<string, never>; result: { durationMs: number; route?: string } };
44
+ /** The focused route (`/students/new`), null without Expo Router (issues #2, #9). */
45
+ route: { params: Record<string, never>; result: { route: string | null } };
41
46
  backdoor: { params: { name: string; args: JsonValue[] }; result: { value: JsonValue } };
42
47
  getIdleState: { params: Record<string, never>; result: { trackers: TrackerState[] } };
43
48
  /** Replace the agent config at runtime (Phase 6.5 `app.sync.*`); the next `hello` carries it too. */
@@ -119,6 +124,17 @@ export interface DeviceInfo {
119
124
  locale?: string;
120
125
  }
121
126
 
127
+ /**
128
+ * Where the app's JS bundle comes from (issue #3), written by `withQuiesco()` when Metro loads its config.
129
+ * `builtAt` (ms since epoch): the dev server's start, or the export. `watching`: whether source changes
130
+ * reach the app; `reason` when not: `CI` (Metro started with CI set) or `export` (a one-off bundle).
131
+ */
132
+ export interface BundleInfo {
133
+ builtAt: number;
134
+ watching: boolean;
135
+ reason?: 'CI' | 'export';
136
+ }
137
+
122
138
  /** Methods the AGENT calls on the HOST. */
123
139
  export interface HostMethods {
124
140
  hello: {
@@ -129,6 +145,8 @@ export interface HostMethods {
129
145
  agentVersion: string;
130
146
  /** Whether @quiesco/native is linked (enables the `native` action mode). */
131
147
  nativeModule: boolean;
148
+ /** The JS bundle (issue #3); missing without `withQuiesco()` in the Metro config. */
149
+ bundle?: BundleInfo;
132
150
  };
133
151
  result: { accepted: true; sessionId: string; config: AgentConfig };
134
152
  };
@@ -0,0 +1,178 @@
1
+ /**
2
+ * Run events: what a test runner's Quiesco reporter tells the `quiesco` process while tests run (the
3
+ * progress bar and `quiesco ui`). Runner independent: the cucumber formatter, the Vitest reporter and
4
+ * the Jest reporter all map their own events onto these.
5
+ *
6
+ * Wire format: NDJSON (one JSON object per line) over a local socket whose address the CLI passes in
7
+ * the QUIESCO_EVENTS environment variable (a Unix socket path, or a `\\.\pipe\…` name on Windows).
8
+ * Without the variable a reporter sends nothing.
9
+ *
10
+ * Several connections may send events for one run: the reporter in the runner's main process, and
11
+ * test workers that add evidence (`test:evidence`). Tests are matched by `id`.
12
+ */
13
+
14
+ /** Bumped on any incompatible change to the run events. Sent in `hello`. */
15
+ export const RUN_EVENTS_PROTOCOL = 1;
16
+
17
+ /** Environment variable holding the socket address. */
18
+ export const RUN_EVENTS_ENV = 'QUIESCO_EVENTS';
19
+
20
+ export type RunnerName = 'cucumber' | 'vitest' | 'jest';
21
+
22
+ /**
23
+ * - `pending`: cucumber, a pending step (Jest's skipped tests are sent as `skipped`).
24
+ * - `undefined`: cucumber, a step without a definition.
25
+ * - `notRun`: never finished (the run ended or was interrupted first). Set by the consumer, never sent.
26
+ */
27
+ export type TestStatus = 'passed' | 'failed' | 'skipped' | 'todo' | 'pending' | 'undefined' | 'notRun';
28
+
29
+ export interface TestRef {
30
+ /**
31
+ * Stable across runs of the same files: cucumber `uri:line`; Vitest its test id; Jest the file and
32
+ * the title path joined with NUL.
33
+ */
34
+ id: string;
35
+ /** Path relative to the project root, `/`-separated. */
36
+ file: string;
37
+ /** 1-based line of the test (the Examples row for a Scenario Outline), when the runner knows it. */
38
+ line?: number;
39
+ /** The test's own title. */
40
+ name: string;
41
+ /** Group titles and the test title, outermost first (cucumber: [feature, rule?, scenario]). */
42
+ path: readonly string[];
43
+ }
44
+
45
+ export interface RunError {
46
+ message: string;
47
+ stack?: string;
48
+ /** Expected / actual difference, already formatted by the runner. */
49
+ diff?: string;
50
+ }
51
+
52
+ export interface RunCounts {
53
+ passed: number;
54
+ failed: number;
55
+ skipped: number;
56
+ todo: number;
57
+ pending: number;
58
+ undefined: number;
59
+ notRun: number;
60
+ }
61
+
62
+ export interface RunEvents {
63
+ /** First event on every connection. */
64
+ hello: { protocol: number; runner: RunnerName; runnerVersion?: string; pid: number };
65
+ /**
66
+ * The run starts. `total` is what the runner knows at this point: exact for cucumber, an estimate for
67
+ * Vitest (static parse), the number of tests known so far for Jest (0). `files` are the test files.
68
+ */
69
+ 'run:start': { total: number; totalIsEstimate: boolean; files: readonly string[]; workers?: number };
70
+ /** A better total (a file was collected). */
71
+ 'total:update': { total: number; totalIsEstimate: boolean };
72
+ 'file:start': { file: string };
73
+ /** `error`: the file failed outside any test (syntax error, error while collecting, BeforeAll). */
74
+ 'file:end': { file: string; error?: RunError };
75
+ /** `worker`: 0-based index of the worker (device) running the test, when the runner tells. `startedAt`: epoch ms. */
76
+ 'test:start': { test: TestRef; worker?: number; attempt: number; startedAt: number };
77
+ 'test:end': {
78
+ test: TestRef;
79
+ status: Exclude<TestStatus, 'notRun'>;
80
+ durationMs: number;
81
+ error?: RunError;
82
+ /** The runner will run this test again (retry): do not count it yet. */
83
+ willRetry: boolean;
84
+ /** Console output of the test, when the runner keeps it per test. */
85
+ logs?: readonly { stream: 'stdout' | 'stderr'; text: string }[];
86
+ worker?: number;
87
+ };
88
+ /** Quiesco evidence files of a failed test (absolute paths), sent from the worker that ran it. */
89
+ 'test:evidence': { testId: string; files: readonly string[] };
90
+ /** An error outside any file (cucumber BeforeAll, Vitest unhandled errors). */
91
+ 'run:error': { error: RunError };
92
+ 'run:end': { success: boolean; interrupted: boolean; durationMs: number };
93
+ }
94
+
95
+ export type RunEventType = keyof RunEvents;
96
+ export type RunEvent = { [K in RunEventType]: { type: K } & RunEvents[K] }[RunEventType];
97
+ export type RunEventOf<K extends RunEventType> = Extract<RunEvent, { type: K }>;
98
+
99
+ const RUN_EVENT_TYPES: ReadonlySet<string> = new Set<RunEventType>([
100
+ 'hello',
101
+ 'run:start',
102
+ 'total:update',
103
+ 'file:start',
104
+ 'file:end',
105
+ 'test:start',
106
+ 'test:end',
107
+ 'test:evidence',
108
+ 'run:error',
109
+ 'run:end',
110
+ ]);
111
+
112
+ export function isRunEvent(value: unknown): value is RunEvent {
113
+ return typeof value === 'object' && value !== null && typeof (value as { type?: unknown }).type === 'string' && RUN_EVENT_TYPES.has((value as { type: string }).type);
114
+ }
115
+
116
+ /** One NDJSON line (with its newline). JSON.stringify never emits a raw newline. */
117
+ export function encodeRunEvent(event: RunEvent): string {
118
+ return `${JSON.stringify(event)}\n`;
119
+ }
120
+
121
+ export interface RunEventDecoder {
122
+ /** Feed text as it arrives; complete lines are decoded at once. */
123
+ push(chunk: string): void;
124
+ /** The connection ended: decode a last line without its newline. */
125
+ end(): void;
126
+ }
127
+
128
+ /**
129
+ * Splits NDJSON text into events. Lines that are not JSON, or not a known event (a newer reporter),
130
+ * go to `onInvalid` and are skipped: a bad line never stops the stream.
131
+ */
132
+ export function createRunEventDecoder(onEvent: (event: RunEvent) => void, onInvalid: (line: string, reason: string) => void = () => {}): RunEventDecoder {
133
+ let buffer = '';
134
+ const line = (text: string) => {
135
+ if (text.trim() === '') return;
136
+ let value: unknown;
137
+ try {
138
+ value = JSON.parse(text);
139
+ } catch (e) {
140
+ onInvalid(text, (e as Error).message);
141
+ return;
142
+ }
143
+ if (isRunEvent(value)) onEvent(value);
144
+ else onInvalid(text, 'not a known run event');
145
+ };
146
+ return {
147
+ push(chunk) {
148
+ buffer += chunk;
149
+ let i: number;
150
+ while ((i = buffer.indexOf('\n')) !== -1) {
151
+ const text = buffer.slice(0, i);
152
+ buffer = buffer.slice(i + 1);
153
+ line(text);
154
+ }
155
+ },
156
+ end() {
157
+ const rest = buffer;
158
+ buffer = '';
159
+ line(rest);
160
+ },
161
+ };
162
+ }
163
+
164
+ export function emptyCounts(): RunCounts {
165
+ return { passed: 0, failed: 0, skipped: 0, todo: 0, pending: 0, undefined: 0, notRun: 0 };
166
+ }
167
+
168
+ /**
169
+ * The tests a runner would run, listed without running them (`quiesco list`, the UI's test tree). Ids
170
+ * match the run events' test ids. Vitest lists `test.each` once (its rows appear after a run).
171
+ */
172
+ export interface TestList {
173
+ runner: RunnerName;
174
+ files: readonly string[];
175
+ tests: readonly TestRef[];
176
+ /** Files that could not be listed (syntax error, error while collecting). */
177
+ errors: readonly { file?: string; message: string }[];
178
+ }