appium-session-recorder 0.0.1 → 0.0.3

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 (74) hide show
  1. package/README.md +34 -16
  2. package/dist/index.js +32422 -0
  3. package/dist/ui/assets/index-CUcJNRfB.css +1 -0
  4. package/dist/ui/assets/index-Cl_X3tPj.js +4 -0
  5. package/{src → dist}/ui/index.html +2 -1
  6. package/package.json +10 -3
  7. package/bun.lock +0 -731
  8. package/src/cli/arg-parser.ts +0 -311
  9. package/src/cli/commands/drive.ts +0 -147
  10. package/src/cli/commands/index.ts +0 -54
  11. package/src/cli/commands/proxy.ts +0 -41
  12. package/src/cli/commands/screen.ts +0 -73
  13. package/src/cli/commands/selectors.ts +0 -42
  14. package/src/cli/commands/session.ts +0 -64
  15. package/src/cli/commands/types.ts +0 -11
  16. package/src/cli/index.ts +0 -158
  17. package/src/cli/prompts.ts +0 -64
  18. package/src/cli/response.ts +0 -44
  19. package/src/core/appium/client.ts +0 -248
  20. package/src/core/index.ts +0 -5
  21. package/src/core/selectors/generate-candidates.ts +0 -155
  22. package/src/core/selectors/score-candidates.ts +0 -184
  23. package/src/core/types.ts +0 -79
  24. package/src/core/xml/parse-source.ts +0 -197
  25. package/src/index.ts +0 -7
  26. package/src/server/appium-client.ts +0 -24
  27. package/src/server/index.ts +0 -6
  28. package/src/server/interaction-recorder.ts +0 -74
  29. package/src/server/proxy-middleware.ts +0 -68
  30. package/src/server/routes.ts +0 -53
  31. package/src/server/server.ts +0 -43
  32. package/src/server/types.ts +0 -34
  33. package/src/ui/bun.lock +0 -311
  34. package/src/ui/package.json +0 -20
  35. package/src/ui/src/App.css +0 -12
  36. package/src/ui/src/App.tsx +0 -41
  37. package/src/ui/src/components/ActionCarousel.css +0 -128
  38. package/src/ui/src/components/ActionCarousel.tsx +0 -92
  39. package/src/ui/src/components/Inspector.css +0 -314
  40. package/src/ui/src/components/Inspector.tsx +0 -265
  41. package/src/ui/src/components/InteractionCard.css +0 -159
  42. package/src/ui/src/components/InteractionCard.tsx +0 -60
  43. package/src/ui/src/components/MainInspector.css +0 -304
  44. package/src/ui/src/components/MainInspector.tsx +0 -304
  45. package/src/ui/src/components/Stats.css +0 -27
  46. package/src/ui/src/components/Timeline.css +0 -31
  47. package/src/ui/src/components/Timeline.tsx +0 -37
  48. package/src/ui/src/hooks/useInteractions.ts +0 -73
  49. package/src/ui/src/index.tsx +0 -11
  50. package/src/ui/src/services/api.ts +0 -41
  51. package/src/ui/src/styles/tokens.css +0 -126
  52. package/src/ui/src/types.ts +0 -34
  53. package/src/ui/src/utils/__tests__/locators.test.ts +0 -304
  54. package/src/ui/src/utils/__tests__/xml-parser.test.ts +0 -326
  55. package/src/ui/src/utils/locators.ts +0 -14
  56. package/src/ui/src/utils/xml-parser.ts +0 -45
  57. package/src/ui/tsconfig.json +0 -34
  58. package/src/ui/tsconfig.node.json +0 -11
  59. package/src/ui/vite.config.ts +0 -22
  60. package/tests/cli/arg-parser.test.ts +0 -397
  61. package/tests/cli/drive-commands.test.ts +0 -151
  62. package/tests/cli/selectors-best.test.ts +0 -42
  63. package/tests/cli/session-commands.test.ts +0 -53
  64. package/tests/core/selector-candidates.test.ts +0 -83
  65. package/tests/core/selector-scoring.test.ts +0 -75
  66. package/tests/core/xml-parser.test.ts +0 -56
  67. package/tests/server/appium-client.test.ts +0 -229
  68. package/tests/server/interaction-recorder.test.ts +0 -377
  69. package/tests/server/proxy-middleware.test.ts +0 -343
  70. package/tests/server/routes.test.ts +0 -305
  71. package/tsconfig.json +0 -26
  72. package/vitest.config.ts +0 -16
  73. package/vitest.ui.config.ts +0 -15
  74. package/workflow.gif +0 -0
package/README.md CHANGED
@@ -22,7 +22,7 @@ A modern Appium recorder and automation CLI with real-time UI visualization, ses
22
22
 
23
23
  ### Prerequisites
24
24
 
25
- - [Bun](https://bun.sh/) runtime installed
25
+ - [Node.js](https://nodejs.org/) >= 18 or [Bun](https://bun.sh/) runtime
26
26
  - [Appium](https://appium.io/) server installed
27
27
 
28
28
  ### Start Appium Server
@@ -38,14 +38,13 @@ The recorder proxy itself does not require `--allow-cors` for normal usage.
38
38
  ### Installation
39
39
 
40
40
  ```bash
41
- cd appium-session-recorder # (or your cloned folder name)
42
- bun install
41
+ npm i -g appium-session-recorder
43
42
  ```
44
43
 
45
44
  ### Run the CLI
46
45
 
47
46
  ```bash
48
- bun run cli
47
+ appium-recorder
49
48
  ```
50
49
 
51
50
  The CLI will interactively prompt you for:
@@ -56,13 +55,13 @@ The CLI will interactively prompt you for:
56
55
  Alternatively, use command-line arguments:
57
56
 
58
57
  ```bash
59
- bun run cli --port 8080 --appium-url http://192.168.1.100:4723
58
+ appium-recorder --port 8080 --appium-url http://192.168.1.100:4723
60
59
  ```
61
60
 
62
61
  Or run command mode (JSON output by default):
63
62
 
64
63
  ```bash
65
- bun run cli session create --appium-url http://127.0.0.1:4723 --caps-file ./caps.json --pretty
64
+ appium-recorder session create --appium-url http://127.0.0.1:4723 --caps-file ./caps.json --pretty
66
65
  ```
67
66
 
68
67
  ### Configure Appium Inspector
@@ -102,7 +101,7 @@ This project is intended for **local testing and development**. It runs an unaut
102
101
  ### Command Mode (JSON)
103
102
 
104
103
  ```bash
105
- bun run cli <group> <command> [flags]
104
+ appium-recorder <group> <command> [flags]
106
105
  ```
107
106
 
108
107
  Available command groups:
@@ -117,7 +116,7 @@ Global command flags:
117
116
 
118
117
  - `--pretty` pretty-print JSON
119
118
  - `--output <path>` persist JSON output to a file
120
- - Legacy mode (`bun run cli [legacy-options]`) does not accept `--pretty` or `--output`
119
+ - Legacy mode (`appium-recorder [legacy-options]`) does not accept `--pretty` or `--output`
121
120
 
122
121
  ### Agent Skill
123
122
 
@@ -139,17 +138,12 @@ appium --port 4723 --allow-cors
139
138
 
140
139
  2. (Optional) Install skill globally for Codex:
141
140
 
142
- ```bash
143
- mkdir -p ~/.codex/skills
144
- cp -R ./skills/appium-cli-selector-navigator ~/.codex/skills/appium-cli-selector-navigator
145
- ```
146
-
147
141
  ```bash
148
142
  mkdir -p ~/.claude/skills
149
143
  cp -R ./skills/appium-cli-selector-navigator ~/.claude/skills/appium-cli-selector-navigator
150
144
  ```
151
145
 
152
- Restart Codex after installing the global skill.
146
+ Restart Claude after installing the global skill.
153
147
 
154
148
  3. Create a capabilities file (example iOS Safari):
155
149
 
@@ -242,7 +236,7 @@ appium-recorder session delete \
242
236
  ### Legacy CLI Options (Backwards Compatible)
243
237
 
244
238
  ```bash
245
- bun run cli [options]
239
+ appium-recorder [options]
246
240
 
247
241
  OPTIONS:
248
242
  -p, --port <number> Proxy server port (default: 4724)
@@ -265,7 +259,7 @@ APPIUM_URL=http://192.168.1.100:4723
265
259
  PROXY_PORT=8080
266
260
  PROXY_HOST=127.0.0.1
267
261
 
268
- bun run cli
262
+ appium-recorder
269
263
  ```
270
264
 
271
265
  ## 🎨 UI Features
@@ -297,6 +291,22 @@ bun run cli
297
291
 
298
292
  ## 🔧 Development
299
293
 
294
+ ### Setup
295
+
296
+ ```bash
297
+ git clone https://github.com/JustasMonkev/appium-session-recorder.git
298
+ cd appium-session-recorder
299
+ bun install
300
+ ```
301
+
302
+ ### Run from Source
303
+
304
+ ```bash
305
+ bun run cli
306
+ ```
307
+
308
+ This is equivalent to `appium-recorder` but runs directly from source. All examples in this README that use `appium-recorder` can be replaced with `bun run cli` during development.
309
+
300
310
  ### Build the UI
301
311
 
302
312
  ```bash
@@ -315,6 +325,14 @@ bun run dev
315
325
  bun run cli
316
326
  ```
317
327
 
328
+ ### Run Tests
329
+
330
+ ```bash
331
+ bun run test # Run all tests
332
+ bun run test:watch # Watch mode
333
+ bun run test:coverage # With coverage
334
+ ```
335
+
318
336
  ### Build for Production
319
337
 
320
338
  ```bash