@namzu/browser 2.0.0 → 2.1.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 (47) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/dist/classifier.d.ts +22 -1
  3. package/dist/classifier.d.ts.map +1 -1
  4. package/dist/classifier.js +30 -7
  5. package/dist/classifier.js.map +1 -1
  6. package/dist/errors.d.ts +19 -1
  7. package/dist/errors.d.ts.map +1 -1
  8. package/dist/errors.js +26 -0
  9. package/dist/errors.js.map +1 -1
  10. package/dist/host.d.ts +42 -0
  11. package/dist/host.d.ts.map +1 -1
  12. package/dist/host.js +487 -70
  13. package/dist/host.js.map +1 -1
  14. package/dist/index.d.ts +3 -3
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +2 -2
  17. package/dist/index.js.map +1 -1
  18. package/dist/page-scripts.d.ts +20 -0
  19. package/dist/page-scripts.d.ts.map +1 -1
  20. package/dist/page-scripts.js +110 -0
  21. package/dist/page-scripts.js.map +1 -1
  22. package/dist/reach.d.ts +66 -0
  23. package/dist/reach.d.ts.map +1 -0
  24. package/dist/reach.js +189 -0
  25. package/dist/reach.js.map +1 -0
  26. package/dist/settle.d.ts +40 -0
  27. package/dist/settle.d.ts.map +1 -0
  28. package/dist/settle.js +30 -0
  29. package/dist/settle.js.map +1 -0
  30. package/dist/snapshot.d.ts +80 -2
  31. package/dist/snapshot.d.ts.map +1 -1
  32. package/dist/snapshot.js +326 -20
  33. package/dist/snapshot.js.map +1 -1
  34. package/dist/windows-engine.d.ts +1 -1
  35. package/dist/windows-engine.d.ts.map +1 -1
  36. package/dist/windows-engine.js +3 -1
  37. package/dist/windows-engine.js.map +1 -1
  38. package/package.json +3 -2
  39. package/src/classifier.ts +44 -7
  40. package/src/errors.ts +32 -0
  41. package/src/host.ts +608 -89
  42. package/src/index.ts +4 -0
  43. package/src/page-scripts.ts +108 -0
  44. package/src/reach.ts +211 -0
  45. package/src/settle.ts +60 -0
  46. package/src/snapshot.ts +402 -20
  47. package/src/windows-engine.ts +4 -1
package/src/errors.ts CHANGED
@@ -2,10 +2,13 @@ import type {
2
2
  BrowserActionName,
3
3
  BrowserHumanRequired,
4
4
  BrowserHumanRequiredReason,
5
+ BrowserNoEffect,
5
6
  BrowserOriginMismatch,
6
7
  BrowserOutcomeUnknown,
7
8
  BrowserSiteDenied,
8
9
  BrowserStaleRef,
10
+ BrowserTargetCandidate,
11
+ BrowserTargetUnclear,
9
12
  } from '@namzu/sdk'
10
13
 
11
14
  /**
@@ -114,6 +117,35 @@ export class BrowserOutcomeUnknownError extends Error implements BrowserOutcomeU
114
117
  }
115
118
  }
116
119
 
120
+ /** The action failed before it touched the page: nothing changed, one retry after a fresh snapshot is safe. */
121
+ export class BrowserNoEffectError extends Error implements BrowserNoEffect {
122
+ override readonly name = 'BrowserNoEffectError'
123
+ readonly code = 'browser_no_effect' as const
124
+ readonly outcome = 'unchanged' as const
125
+ readonly retrySafety = 'once-after-snapshot' as const
126
+
127
+ constructor(
128
+ readonly action: BrowserActionName,
129
+ reason: string,
130
+ ) {
131
+ super(`browser_act "${action}" did not happen: ${reason}.`)
132
+ }
133
+ }
134
+
135
+ /** A role/name or text target matched no element or several. Nothing was done. */
136
+ export class BrowserTargetUnclearError extends Error implements BrowserTargetUnclear {
137
+ override readonly name = 'BrowserTargetUnclearError'
138
+ readonly code = 'browser_target_unclear' as const
139
+
140
+ constructor(
141
+ readonly wanted: string,
142
+ readonly matches: number,
143
+ readonly candidates: readonly BrowserTargetCandidate[],
144
+ ) {
145
+ super(matches === 0 ? `No element matches ${wanted}.` : `${matches} elements match ${wanted}.`)
146
+ }
147
+ }
148
+
117
149
  function firstLine(cause: unknown): string {
118
150
  const text = cause instanceof Error ? cause.message : String(cause)
119
151
  const line = text.split('\n')[0] ?? ''