@quiesco/protocol 0.9.0 → 0.10.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/errors.d.ts CHANGED
@@ -2,7 +2,7 @@ import type { ActionType } from './actions.js';
2
2
  import type { ElementSummary } from './element.js';
3
3
  import type { JsonValue } from './json.js';
4
4
  import type { Matcher } from './matcher.js';
5
- import type { TrackerState } from './methods.js';
5
+ import type { StepTiming, TrackerState } from './methods.js';
6
6
  /** Standard JSON-RPC 2.0 error codes. */
7
7
  export declare const JsonRpcErrorCode: {
8
8
  readonly PARSE_ERROR: -32700;
@@ -33,17 +33,21 @@ export type ErrorName = keyof typeof ErrorCode;
33
33
  /** Structured `error.data` for each Quiesco error code. */
34
34
  export interface ErrorDataMap {
35
35
  /** `reason: 'not-in-window'`: React rendered it, but no window shows it (e.g. a system alert is over the app; Phase 6.12). */
36
+ /** `steps`: a multi-step action's steps before it gave up (issue #78). */
36
37
  ELEMENT_NOT_FOUND: {
37
38
  matcher: Matcher;
38
39
  reason?: 'not-in-window';
40
+ steps?: StepTiming[];
39
41
  };
40
42
  MULTIPLE_MATCHES: {
41
43
  matcher: Matcher;
42
44
  matches: ElementSummary[];
43
45
  };
46
+ /** `steps`: a multi-step action's steps, the last one the step that timed out (issue #78). */
44
47
  SYNC_TIMEOUT: {
45
48
  timeoutMs: number;
46
49
  busy: TrackerState[];
50
+ steps?: StepTiming[];
47
51
  };
48
52
  ASSERTION_FAILED: {
49
53
  expected: JsonValue;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/methods.d.ts CHANGED
@@ -16,6 +16,19 @@ export interface TrackerState {
16
16
  /** Results of query / action / assert / webview / scrollView carry the ms spent waiting for idle (Phase 6.9). */
17
17
  export interface SyncTiming {
18
18
  syncMs?: number;
19
+ /** The steps of a multi-step action (scrollTo, issue #78), for the timeline. */
20
+ steps?: StepTiming[];
21
+ }
22
+ /** One step of a multi-step action (issue #78). */
23
+ export interface StepTiming {
24
+ /** ms from the start of the call to the start of the step (agent clock). */
25
+ atMs: number;
26
+ /** How long the step took (drag and wait for idle). */
27
+ ms: number;
28
+ /** Of which waiting for idle. */
29
+ syncMs: number;
30
+ /** What the step did, e.g. `down`. */
31
+ label: string;
19
32
  }
20
33
  export interface SyncOption {
21
34
  sync?: boolean;
@@ -274,6 +287,8 @@ export interface HostMethods {
274
287
  nativeModule: boolean;
275
288
  /** The JS bundle (issue #3); missing without `withQuiesco()` in the Metro config. */
276
289
  bundle?: BundleInfo;
290
+ /** Whether the build wraps native modules for the `native-module` tracker (issue #74); missing from older agents. */
291
+ nativeModulesWrapped?: boolean;
277
292
  };
278
293
  result: {
279
294
  accepted: true;
@@ -1 +1 @@
1
- {"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEjD,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,sFAAsF;IACtF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wGAAwG;AACxG,iHAAiH;AACjH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,GAAG,UAAU,CAAC;QAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;SAAE,GAAG,UAAU,CAAA;KAAE,CAAC;IAC1G,MAAM,EAAE;QACN,MAAM,EAAE;YAAE,MAAM,EAAE,UAAU,CAAC;YAAC,IAAI,EAAE,UAAU,CAAA;SAAE,GAAG,UAAU,CAAC;QAC9D,6FAA6F;QAC7F,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE,cAAc,CAAC;YAAC,SAAS,CAAC,EAAE,SAAS,CAAA;SAAE,GAAG,UAAU,CAAC;KAC1E,CAAC;IACF,MAAM,EAAE;QAAE,MAAM,EAAE;YAAE,SAAS,EAAE,aAAa,CAAA;SAAE,GAAG,UAAU,CAAC;QAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;SAAE,GAAG,UAAU,CAAA;KAAE,CAAC;IACnH,WAAW,EAAE;QAAE,MAAM,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC9E,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,CAAC;IAC9E,kFAAkF;IAClF,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAChI,kFAAkF;IAClF,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACzF,qFAAqF;IACrF,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3E,QAAQ,EAAE;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,SAAS,EAAE,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,KAAK,EAAE,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;IACxF,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC;IACtF,qGAAqG;IACrG,SAAS,EAAE;QAAE,MAAM,EAAE;YAAE,MAAM,EAAE,WAAW,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;KAAE,CAAC;IAC9E,0FAA0F;IAC1F,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC;IAClE,uGAAuG;IACvG,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3E;;;OAGG;IACH,cAAc,EAAE;QAAE,MAAM,EAAE;YAAE,WAAW,EAAE,WAAW,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACzG;;;;OAIG;IACH,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/F,YAAY,EAAE;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3E;;;OAGG;IACH,gBAAgB,EAAE;QAAE,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QAAC,MAAM,EAAE;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/I;;;;OAIG;IACH,OAAO,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,UAAU,CAAC;QAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,CAAA;KAAE,CAAC;IACjH;;;;;OAKG;IACH,UAAU,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,EAAE,CAAC,EAAE;gBAAE,CAAC,EAAE,MAAM,CAAC;gBAAC,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,UAAU,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,UAAU,CAAC;QAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAA;KAAE,CAAC;CACtJ;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,EAAE,IAAI,CAAC;IACX,+CAA+C;IAC/C,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,sCAAsC;IACtC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,IAAI,EAAE,IAAI,CAAC;IACX,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnD,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,sFAAsF;IACtF,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QACL,MAAM,EAAE;YACN,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YACzB,QAAQ,EAAE,QAAQ,CAAC;YACnB,eAAe,EAAE,MAAM,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC;YACrB,4EAA4E;YAC5E,YAAY,EAAE,OAAO,CAAC;YACtB,qFAAqF;YACrF,MAAM,CAAC,EAAE,UAAU,CAAC;SACrB,CAAC;QACF,MAAM,EAAE;YAAE,QAAQ,EAAE,IAAI,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,WAAW,CAAA;SAAE,CAAC;KACpE,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC;AACjD,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC;AAC/C,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC"}
1
+ {"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../src/methods.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@quiesco/protocol",
3
- "version": "0.9.0",
3
+ "version": "0.10.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/errors.ts CHANGED
@@ -2,7 +2,7 @@ import type { ActionType } from './actions.js';
2
2
  import type { ElementSummary } from './element.js';
3
3
  import type { JsonValue } from './json.js';
4
4
  import type { Matcher } from './matcher.js';
5
- import type { TrackerState } from './methods.js';
5
+ import type { StepTiming, TrackerState } from './methods.js';
6
6
 
7
7
  /** Standard JSON-RPC 2.0 error codes. */
8
8
  export const JsonRpcErrorCode = {
@@ -36,9 +36,11 @@ export type ErrorName = keyof typeof ErrorCode;
36
36
  /** Structured `error.data` for each Quiesco error code. */
37
37
  export interface ErrorDataMap {
38
38
  /** `reason: 'not-in-window'`: React rendered it, but no window shows it (e.g. a system alert is over the app; Phase 6.12). */
39
- ELEMENT_NOT_FOUND: { matcher: Matcher; reason?: 'not-in-window' };
39
+ /** `steps`: a multi-step action's steps before it gave up (issue #78). */
40
+ ELEMENT_NOT_FOUND: { matcher: Matcher; reason?: 'not-in-window'; steps?: StepTiming[] };
40
41
  MULTIPLE_MATCHES: { matcher: Matcher; matches: ElementSummary[] };
41
- SYNC_TIMEOUT: { timeoutMs: number; busy: TrackerState[] };
42
+ /** `steps`: a multi-step action's steps, the last one the step that timed out (issue #78). */
43
+ SYNC_TIMEOUT: { timeoutMs: number; busy: TrackerState[]; steps?: StepTiming[] };
42
44
  ASSERTION_FAILED: { expected: JsonValue; actual: JsonValue; elements: ElementSummary[] };
43
45
  ACTION_NOT_SUPPORTED: { action: ActionType | 'webview'; platform: string; hint?: string };
44
46
  BACKDOOR_NOT_REGISTERED: { name: string; registered: string[] };
package/src/methods.ts CHANGED
@@ -19,6 +19,20 @@ export interface TrackerState {
19
19
  /** Results of query / action / assert / webview / scrollView carry the ms spent waiting for idle (Phase 6.9). */
20
20
  export interface SyncTiming {
21
21
  syncMs?: number;
22
+ /** The steps of a multi-step action (scrollTo, issue #78), for the timeline. */
23
+ steps?: StepTiming[];
24
+ }
25
+
26
+ /** One step of a multi-step action (issue #78). */
27
+ export interface StepTiming {
28
+ /** ms from the start of the call to the start of the step (agent clock). */
29
+ atMs: number;
30
+ /** How long the step took (drag and wait for idle). */
31
+ ms: number;
32
+ /** Of which waiting for idle. */
33
+ syncMs: number;
34
+ /** What the step did, e.g. `down`. */
35
+ label: string;
22
36
  }
23
37
 
24
38
  export interface SyncOption {
@@ -154,6 +168,8 @@ export interface HostMethods {
154
168
  nativeModule: boolean;
155
169
  /** The JS bundle (issue #3); missing without `withQuiesco()` in the Metro config. */
156
170
  bundle?: BundleInfo;
171
+ /** Whether the build wraps native modules for the `native-module` tracker (issue #74); missing from older agents. */
172
+ nativeModulesWrapped?: boolean;
157
173
  };
158
174
  result: { accepted: true; sessionId: string; config: AgentConfig };
159
175
  };