appium-espresso-driver 9.3.6 → 9.3.8

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 (723) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/build/lib/commands/context.d.ts +1 -1
  3. package/build/lib/commands/context.js +1 -1
  4. package/build/lib/commands/element.d.ts +10 -10
  5. package/build/lib/commands/element.js +10 -10
  6. package/build/lib/commands/idling-resources.d.ts +1 -1
  7. package/build/lib/commands/idling-resources.js +1 -1
  8. package/build/lib/commands/misc.d.ts +5 -4
  9. package/build/lib/commands/misc.d.ts.map +1 -1
  10. package/build/lib/commands/misc.js +3 -3
  11. package/build/lib/commands/misc.js.map +1 -1
  12. package/build/lib/commands/services.d.ts +2 -2
  13. package/build/lib/commands/services.js +2 -2
  14. package/build/lib/driver.js +1 -1
  15. package/build/lib/driver.js.map +1 -1
  16. package/espresso-server/app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk +0 -0
  17. package/espresso-server/buildSrc/.gradle/9.7.1/executionHistory/executionHistory.bin +0 -0
  18. package/espresso-server/buildSrc/.gradle/9.7.1/executionHistory/executionHistory.lock +0 -0
  19. package/espresso-server/buildSrc/.gradle/buildOutputCleanup/buildOutputCleanup.lock +0 -0
  20. package/espresso-server/buildSrc/.gradle/buildOutputCleanup/cache.properties +1 -1
  21. package/espresso-server/buildSrc/build/kotlin/compileKotlin/cacheable/last-build.bin +0 -0
  22. package/espresso-server/gradle/libs.versions.toml +1 -1
  23. package/espresso-server/gradle.properties +1 -1
  24. package/espresso-server/library/src/main/java/io/appium/espressoserver/lib/helpers/Version.kt +1 -1
  25. package/lib/commands/context.ts +1 -1
  26. package/lib/commands/element.ts +10 -10
  27. package/lib/commands/idling-resources.ts +1 -1
  28. package/lib/commands/misc.ts +5 -4
  29. package/lib/commands/services.ts +2 -2
  30. package/lib/driver.ts +1 -1
  31. package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi.js +6 -3
  32. package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi.js.map +1 -1
  33. package/node_modules/@appium/base-driver/build/lib/basedriver/commands/timeout.js +1 -1
  34. package/node_modules/@appium/base-driver/build/lib/basedriver/commands/timeout.js.map +1 -1
  35. package/node_modules/@appium/base-driver/build/lib/basedriver/helpers.d.ts.map +1 -1
  36. package/node_modules/@appium/base-driver/build/lib/basedriver/helpers.js +40 -3
  37. package/node_modules/@appium/base-driver/build/lib/basedriver/helpers.js.map +1 -1
  38. package/node_modules/@appium/base-driver/lib/basedriver/commands/bidi.ts +6 -3
  39. package/node_modules/@appium/base-driver/lib/basedriver/commands/timeout.ts +1 -1
  40. package/node_modules/@appium/base-driver/lib/basedriver/helpers.ts +41 -3
  41. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts.map +1 -1
  42. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/asyncbox.js +13 -3
  43. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/asyncbox.js.map +1 -1
  44. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts.map +1 -1
  45. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/asyncbox.js +13 -3
  46. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/asyncbox.js.map +1 -1
  47. package/node_modules/@appium/base-driver/node_modules/asyncbox/lib/asyncbox.ts +20 -3
  48. package/node_modules/@appium/base-driver/node_modules/asyncbox/package.json +1 -1
  49. package/node_modules/@appium/base-driver/package.json +9 -9
  50. package/node_modules/@appium/base-driver/tsconfig.json +1 -1
  51. package/node_modules/@appium/logger/CHANGELOG.md +8 -0
  52. package/node_modules/@appium/logger/package.json +3 -3
  53. package/node_modules/@appium/support/build/lib/fs.d.ts.map +1 -1
  54. package/node_modules/@appium/support/build/lib/fs.js +7 -0
  55. package/node_modules/@appium/support/build/lib/fs.js.map +1 -1
  56. package/node_modules/@appium/support/build/lib/index.d.ts.map +1 -1
  57. package/node_modules/@appium/support/build/lib/net.d.ts.map +1 -1
  58. package/node_modules/@appium/support/build/lib/net.js +6 -2
  59. package/node_modules/@appium/support/build/lib/net.js.map +1 -1
  60. package/node_modules/@appium/support/build/lib/util.d.ts.map +1 -1
  61. package/node_modules/@appium/support/build/lib/util.js +10 -4
  62. package/node_modules/@appium/support/build/lib/util.js.map +1 -1
  63. package/node_modules/@appium/support/build/lib/zip.d.ts.map +1 -1
  64. package/node_modules/@appium/support/build/lib/zip.js +2 -7
  65. package/node_modules/@appium/support/build/lib/zip.js.map +1 -1
  66. package/node_modules/@appium/support/lib/fs.ts +8 -1
  67. package/node_modules/@appium/support/lib/net.ts +7 -2
  68. package/node_modules/@appium/support/lib/util.ts +9 -3
  69. package/node_modules/@appium/support/lib/zip.ts +3 -9
  70. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts.map +1 -1
  71. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.js +13 -3
  72. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.js.map +1 -1
  73. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts.map +1 -1
  74. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.js +13 -3
  75. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.js.map +1 -1
  76. package/node_modules/@appium/support/node_modules/asyncbox/lib/asyncbox.ts +20 -3
  77. package/node_modules/@appium/support/node_modules/asyncbox/package.json +1 -1
  78. package/node_modules/@appium/support/package.json +9 -9
  79. package/node_modules/@appium/types/package.json +4 -4
  80. package/node_modules/@img/sharp-libvips-linux-x64/README.md +1 -1
  81. package/node_modules/@img/sharp-libvips-linux-x64/lib/glib-2.0/include/glibconfig.h +2 -2
  82. package/node_modules/@img/sharp-libvips-linux-x64/lib/{libvips-cpp.so.8.18.6 → libvips-cpp.so.8.18.7} +0 -0
  83. package/node_modules/@img/sharp-libvips-linux-x64/package.json +2 -2
  84. package/node_modules/@img/sharp-libvips-linux-x64/versions.json +11 -11
  85. package/node_modules/@img/sharp-linux-x64/index.cjs +1 -1
  86. package/node_modules/@img/sharp-linux-x64/lib/sharp-linux-x64-0.35.5.node +0 -0
  87. package/node_modules/@img/sharp-linux-x64/package.json +2 -2
  88. package/node_modules/appium-adb/CHANGELOG.md +37 -0
  89. package/node_modules/appium-adb/README.md +1 -1
  90. package/node_modules/appium-adb/build/lib/tools/aab-utils.js +34 -34
  91. package/node_modules/appium-adb/build/lib/tools/aab-utils.js.map +1 -1
  92. package/node_modules/appium-adb/build/lib/tools/android-manifest.js +1 -1
  93. package/node_modules/appium-adb/build/lib/tools/android-manifest.js.map +1 -1
  94. package/node_modules/appium-adb/build/lib/tools/apk-signing.d.ts.map +1 -1
  95. package/node_modules/appium-adb/build/lib/tools/apk-signing.js +21 -9
  96. package/node_modules/appium-adb/build/lib/tools/apk-signing.js.map +1 -1
  97. package/node_modules/appium-adb/build/lib/tools/apks-utils.d.ts.map +1 -1
  98. package/node_modules/appium-adb/build/lib/tools/apks-utils.js +6 -5
  99. package/node_modules/appium-adb/build/lib/tools/apks-utils.js.map +1 -1
  100. package/node_modules/appium-adb/build/lib/tools/app-commands.d.ts.map +1 -1
  101. package/node_modules/appium-adb/build/lib/tools/app-commands.js +63 -62
  102. package/node_modules/appium-adb/build/lib/tools/app-commands.js.map +1 -1
  103. package/node_modules/appium-adb/build/lib/tools/device-settings.js +1 -1
  104. package/node_modules/appium-adb/build/lib/tools/device-settings.js.map +1 -1
  105. package/node_modules/appium-adb/build/lib/tools/lockmgmt.d.ts.map +1 -1
  106. package/node_modules/appium-adb/build/lib/tools/lockmgmt.js +3 -9
  107. package/node_modules/appium-adb/build/lib/tools/lockmgmt.js.map +1 -1
  108. package/node_modules/appium-adb/build/lib/tools/system-calls.d.ts.map +1 -1
  109. package/node_modules/appium-adb/build/lib/tools/system-calls.js +7 -6
  110. package/node_modules/appium-adb/build/lib/tools/system-calls.js.map +1 -1
  111. package/node_modules/appium-adb/build/lib/tools/types.d.ts +4 -0
  112. package/node_modules/appium-adb/build/lib/tools/types.d.ts.map +1 -1
  113. package/node_modules/appium-adb/build/lib/utils/helpers/index.d.ts +1 -0
  114. package/node_modules/appium-adb/build/lib/utils/helpers/index.d.ts.map +1 -1
  115. package/node_modules/appium-adb/build/lib/utils/helpers/index.js +1 -0
  116. package/node_modules/appium-adb/build/lib/utils/helpers/index.js.map +1 -1
  117. package/node_modules/appium-adb/build/lib/utils/helpers/redact.d.ts +19 -0
  118. package/node_modules/appium-adb/build/lib/utils/helpers/redact.d.ts.map +1 -0
  119. package/node_modules/appium-adb/build/lib/utils/helpers/redact.js +57 -0
  120. package/node_modules/appium-adb/build/lib/utils/helpers/redact.js.map +1 -0
  121. package/node_modules/appium-adb/build/lib/utils/index.d.ts +2 -0
  122. package/node_modules/appium-adb/build/lib/utils/index.d.ts.map +1 -1
  123. package/node_modules/appium-adb/build/lib/utils/index.js +2 -0
  124. package/node_modules/appium-adb/build/lib/utils/index.js.map +1 -1
  125. package/node_modules/appium-adb/lib/tools/aab-utils.ts +35 -35
  126. package/node_modules/appium-adb/lib/tools/android-manifest.ts +1 -1
  127. package/node_modules/appium-adb/lib/tools/apk-signing.ts +26 -9
  128. package/node_modules/appium-adb/lib/tools/apks-utils.ts +13 -5
  129. package/node_modules/appium-adb/lib/tools/app-commands.ts +59 -68
  130. package/node_modules/appium-adb/lib/tools/device-settings.ts +1 -1
  131. package/node_modules/appium-adb/lib/tools/lockmgmt.ts +3 -8
  132. package/node_modules/appium-adb/lib/tools/system-calls.ts +15 -6
  133. package/node_modules/appium-adb/lib/tools/types.ts +4 -0
  134. package/node_modules/appium-adb/lib/utils/helpers/index.ts +1 -0
  135. package/node_modules/appium-adb/lib/utils/helpers/redact.ts +59 -0
  136. package/node_modules/appium-adb/lib/utils/index.ts +2 -0
  137. package/node_modules/appium-adb/package.json +10 -13
  138. package/node_modules/appium-android-driver/CHANGELOG.md +31 -0
  139. package/node_modules/appium-android-driver/build/lib/commands/context/exports.d.ts.map +1 -1
  140. package/node_modules/appium-android-driver/build/lib/commands/context/exports.js +10 -6
  141. package/node_modules/appium-android-driver/build/lib/commands/context/exports.js.map +1 -1
  142. package/node_modules/appium-android-driver/build/lib/commands/file-actions.d.ts.map +1 -1
  143. package/node_modules/appium-android-driver/build/lib/commands/file-actions.js +55 -35
  144. package/node_modules/appium-android-driver/build/lib/commands/file-actions.js.map +1 -1
  145. package/node_modules/appium-android-driver/build/lib/commands/log.js +2 -2
  146. package/node_modules/appium-android-driver/build/lib/commands/log.js.map +1 -1
  147. package/node_modules/appium-android-driver/lib/commands/context/exports.ts +10 -6
  148. package/node_modules/appium-android-driver/lib/commands/file-actions.ts +58 -39
  149. package/node_modules/appium-android-driver/lib/commands/log.ts +2 -2
  150. package/node_modules/appium-android-driver/package.json +1 -1
  151. package/node_modules/appium-chromedriver/CHANGELOG.md +68 -0
  152. package/node_modules/appium-chromedriver/README.md +2 -4
  153. package/node_modules/appium-chromedriver/build/lib/commands/version.d.ts.map +1 -1
  154. package/node_modules/appium-chromedriver/build/lib/commands/version.js +9 -0
  155. package/node_modules/appium-chromedriver/build/lib/commands/version.js.map +1 -1
  156. package/node_modules/appium-chromedriver/config/mapping.json +7 -1
  157. package/node_modules/appium-chromedriver/lib/commands/version.ts +10 -0
  158. package/node_modules/appium-chromedriver/package.json +10 -13
  159. package/node_modules/asyncbox/README.md +43 -0
  160. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts +9 -0
  161. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts.map +1 -0
  162. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js +35 -0
  163. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js.map +1 -0
  164. package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts +9 -0
  165. package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts.map +1 -0
  166. package/node_modules/asyncbox/build/cjs/lib/asyncmap.js +23 -0
  167. package/node_modules/asyncbox/build/cjs/lib/asyncmap.js.map +1 -0
  168. package/node_modules/asyncbox/build/cjs/lib/errors.d.ts +9 -0
  169. package/node_modules/asyncbox/build/cjs/lib/errors.d.ts.map +1 -0
  170. package/node_modules/asyncbox/build/cjs/lib/errors.js +20 -0
  171. package/node_modules/asyncbox/build/cjs/lib/errors.js.map +1 -0
  172. package/node_modules/asyncbox/build/cjs/lib/index.d.ts +12 -0
  173. package/node_modules/asyncbox/build/cjs/lib/index.d.ts.map +1 -0
  174. package/node_modules/asyncbox/build/cjs/lib/index.js +24 -0
  175. package/node_modules/asyncbox/build/cjs/lib/index.js.map +1 -0
  176. package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts +3 -0
  177. package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts.map +1 -0
  178. package/node_modules/asyncbox/build/cjs/lib/limit-function.js +15 -0
  179. package/node_modules/asyncbox/build/cjs/lib/limit-function.js.map +1 -0
  180. package/node_modules/asyncbox/build/cjs/lib/lock.d.ts +74 -0
  181. package/node_modules/asyncbox/build/cjs/lib/lock.d.ts.map +1 -0
  182. package/node_modules/asyncbox/build/cjs/lib/lock.js +295 -0
  183. package/node_modules/asyncbox/build/cjs/lib/lock.js.map +1 -0
  184. package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts +15 -0
  185. package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts.map +1 -0
  186. package/node_modules/asyncbox/build/cjs/lib/long-sleep.js +36 -0
  187. package/node_modules/asyncbox/build/cjs/lib/long-sleep.js.map +1 -0
  188. package/node_modules/asyncbox/build/cjs/lib/retry.d.ts +17 -0
  189. package/node_modules/asyncbox/build/cjs/lib/retry.d.ts.map +1 -0
  190. package/node_modules/asyncbox/build/cjs/lib/retry.js +57 -0
  191. package/node_modules/asyncbox/build/cjs/lib/retry.js.map +1 -0
  192. package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts +20 -0
  193. package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts.map +1 -0
  194. package/node_modules/asyncbox/build/cjs/lib/sleep.js +61 -0
  195. package/node_modules/asyncbox/build/cjs/lib/sleep.js.map +1 -0
  196. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts +18 -0
  197. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts.map +1 -0
  198. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js +51 -0
  199. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js.map +1 -0
  200. package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts +16 -0
  201. package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts.map +1 -0
  202. package/node_modules/asyncbox/build/cjs/lib/with-timeout.js +45 -0
  203. package/node_modules/asyncbox/build/cjs/lib/with-timeout.js.map +1 -0
  204. package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts +9 -0
  205. package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts.map +1 -0
  206. package/node_modules/asyncbox/build/esm/lib/asyncfilter.js +32 -0
  207. package/node_modules/asyncbox/build/esm/lib/asyncfilter.js.map +1 -0
  208. package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts +9 -0
  209. package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts.map +1 -0
  210. package/node_modules/asyncbox/build/esm/lib/asyncmap.js +20 -0
  211. package/node_modules/asyncbox/build/esm/lib/asyncmap.js.map +1 -0
  212. package/node_modules/asyncbox/build/esm/lib/errors.d.ts +9 -0
  213. package/node_modules/asyncbox/build/esm/lib/errors.d.ts.map +1 -0
  214. package/node_modules/asyncbox/build/esm/lib/errors.js +15 -0
  215. package/node_modules/asyncbox/build/esm/lib/errors.js.map +1 -0
  216. package/node_modules/asyncbox/build/esm/lib/index.d.ts +12 -0
  217. package/node_modules/asyncbox/build/esm/lib/index.d.ts.map +1 -0
  218. package/node_modules/asyncbox/build/esm/lib/index.js +10 -0
  219. package/node_modules/asyncbox/build/esm/lib/index.js.map +1 -0
  220. package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts +3 -0
  221. package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts.map +1 -0
  222. package/node_modules/asyncbox/build/esm/lib/limit-function.js +12 -0
  223. package/node_modules/asyncbox/build/esm/lib/limit-function.js.map +1 -0
  224. package/node_modules/asyncbox/build/esm/lib/lock.d.ts +74 -0
  225. package/node_modules/asyncbox/build/esm/lib/lock.d.ts.map +1 -0
  226. package/node_modules/asyncbox/build/esm/lib/lock.js +291 -0
  227. package/node_modules/asyncbox/build/esm/lib/lock.js.map +1 -0
  228. package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts +15 -0
  229. package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts.map +1 -0
  230. package/node_modules/asyncbox/build/esm/lib/long-sleep.js +33 -0
  231. package/node_modules/asyncbox/build/esm/lib/long-sleep.js.map +1 -0
  232. package/node_modules/asyncbox/build/esm/lib/retry.d.ts +17 -0
  233. package/node_modules/asyncbox/build/esm/lib/retry.d.ts.map +1 -0
  234. package/node_modules/asyncbox/build/esm/lib/retry.js +53 -0
  235. package/node_modules/asyncbox/build/esm/lib/retry.js.map +1 -0
  236. package/node_modules/asyncbox/build/esm/lib/sleep.d.ts +20 -0
  237. package/node_modules/asyncbox/build/esm/lib/sleep.d.ts.map +1 -0
  238. package/node_modules/asyncbox/build/esm/lib/sleep.js +58 -0
  239. package/node_modules/asyncbox/build/esm/lib/sleep.js.map +1 -0
  240. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts +18 -0
  241. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts.map +1 -0
  242. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js +48 -0
  243. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js.map +1 -0
  244. package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts +16 -0
  245. package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts.map +1 -0
  246. package/node_modules/asyncbox/build/esm/lib/with-timeout.js +42 -0
  247. package/node_modules/asyncbox/build/esm/lib/with-timeout.js.map +1 -0
  248. package/node_modules/asyncbox/lib/asyncfilter.ts +38 -0
  249. package/node_modules/asyncbox/lib/asyncmap.ts +29 -0
  250. package/node_modules/asyncbox/lib/errors.ts +15 -0
  251. package/node_modules/asyncbox/lib/index.ts +21 -0
  252. package/node_modules/asyncbox/lib/limit-function.ts +18 -0
  253. package/node_modules/asyncbox/lib/lock.ts +360 -0
  254. package/node_modules/asyncbox/lib/long-sleep.ts +38 -0
  255. package/node_modules/asyncbox/lib/retry.ts +61 -0
  256. package/node_modules/asyncbox/lib/sleep.ts +79 -0
  257. package/node_modules/asyncbox/lib/wait-for-condition.ts +52 -0
  258. package/node_modules/asyncbox/lib/with-timeout.ts +43 -0
  259. package/node_modules/asyncbox/package.json +8 -8
  260. package/node_modules/bare-fs/binding.c +52 -23
  261. package/node_modules/bare-fs/index.d.ts +12 -10
  262. package/node_modules/bare-fs/index.js +43 -10
  263. package/node_modules/bare-fs/package.json +2 -1
  264. package/node_modules/bare-fs/prebuilds/android-arm/bare-fs.bare +0 -0
  265. package/node_modules/bare-fs/prebuilds/android-arm64/bare-fs.bare +0 -0
  266. package/node_modules/bare-fs/prebuilds/android-ia32/bare-fs.bare +0 -0
  267. package/node_modules/bare-fs/prebuilds/android-x64/bare-fs.bare +0 -0
  268. package/node_modules/bare-fs/prebuilds/darwin-arm64/bare-fs.bare +0 -0
  269. package/node_modules/bare-fs/prebuilds/darwin-x64/bare-fs.bare +0 -0
  270. package/node_modules/bare-fs/prebuilds/ios-arm64/bare-fs.bare +0 -0
  271. package/node_modules/bare-fs/prebuilds/ios-arm64-simulator/bare-fs.bare +0 -0
  272. package/node_modules/bare-fs/prebuilds/ios-x64-simulator/bare-fs.bare +0 -0
  273. package/node_modules/bare-fs/prebuilds/linux-arm64/bare-fs.bare +0 -0
  274. package/node_modules/bare-fs/prebuilds/linux-x64/bare-fs.bare +0 -0
  275. package/node_modules/bare-fs/prebuilds/win32-arm64/bare-fs.bare +0 -0
  276. package/node_modules/bare-fs/prebuilds/win32-x64/bare-fs.bare +0 -0
  277. package/node_modules/bare-url/README.md +4 -0
  278. package/node_modules/bare-url/index.d.ts +3 -0
  279. package/node_modules/bare-url/index.js +42 -18
  280. package/node_modules/bare-url/lib/errors.js +4 -0
  281. package/node_modules/bare-url/package.json +1 -1
  282. package/node_modules/bare-url/prebuilds/android-arm/bare-url.bare +0 -0
  283. package/node_modules/bare-url/prebuilds/android-arm64/bare-url.bare +0 -0
  284. package/node_modules/bare-url/prebuilds/android-ia32/bare-url.bare +0 -0
  285. package/node_modules/bare-url/prebuilds/android-x64/bare-url.bare +0 -0
  286. package/node_modules/bare-url/prebuilds/darwin-arm64/bare-url.bare +0 -0
  287. package/node_modules/bare-url/prebuilds/darwin-x64/bare-url.bare +0 -0
  288. package/node_modules/bare-url/prebuilds/ios-arm64/bare-url.bare +0 -0
  289. package/node_modules/bare-url/prebuilds/ios-arm64-simulator/bare-url.bare +0 -0
  290. package/node_modules/bare-url/prebuilds/ios-x64-simulator/bare-url.bare +0 -0
  291. package/node_modules/bare-url/prebuilds/linux-arm64/bare-url.bare +0 -0
  292. package/node_modules/bare-url/prebuilds/linux-x64/bare-url.bare +0 -0
  293. package/node_modules/bare-url/prebuilds/win32-arm64/bare-url.bare +0 -0
  294. package/node_modules/bare-url/prebuilds/win32-x64/bare-url.bare +0 -0
  295. package/node_modules/bplist-creator/README.md +26 -6
  296. package/node_modules/bplist-creator/dist/index.cjs +508 -0
  297. package/node_modules/bplist-creator/dist/index.cjs.map +7 -0
  298. package/node_modules/bplist-creator/dist/index.d.cts +12 -0
  299. package/node_modules/bplist-creator/dist/index.d.ts +12 -0
  300. package/node_modules/bplist-creator/dist/index.mjs +472 -0
  301. package/node_modules/bplist-creator/dist/index.mjs.map +7 -0
  302. package/node_modules/bplist-creator/package.json +43 -9
  303. package/node_modules/bplist-parser/README.md +37 -3
  304. package/node_modules/bplist-parser/dist/index.cjs +385 -0
  305. package/node_modules/bplist-parser/dist/index.cjs.map +7 -0
  306. package/node_modules/bplist-parser/dist/index.d.cts +13 -0
  307. package/node_modules/bplist-parser/dist/index.d.ts +13 -0
  308. package/node_modules/bplist-parser/{bplistParser.js → dist/index.mjs} +141 -171
  309. package/node_modules/bplist-parser/dist/index.mjs.map +7 -0
  310. package/node_modules/bplist-parser/package.json +39 -12
  311. package/node_modules/follow-redirects/index.js +10 -1
  312. package/node_modules/follow-redirects/package.json +1 -1
  313. package/node_modules/io.appium.settings/CHANGELOG.md +72 -0
  314. package/node_modules/io.appium.settings/README.md +126 -0
  315. package/node_modules/io.appium.settings/apks/settings_apk-debug.apk +0 -0
  316. package/node_modules/io.appium.settings/build/lib/client.d.ts +4 -0
  317. package/node_modules/io.appium.settings/build/lib/client.d.ts.map +1 -1
  318. package/node_modules/io.appium.settings/build/lib/client.js +4 -0
  319. package/node_modules/io.appium.settings/build/lib/client.js.map +1 -1
  320. package/node_modules/io.appium.settings/build/lib/commands/clipboard.d.ts.map +1 -1
  321. package/node_modules/io.appium.settings/build/lib/commands/clipboard.js +1 -1
  322. package/node_modules/io.appium.settings/build/lib/commands/clipboard.js.map +1 -1
  323. package/node_modules/io.appium.settings/build/lib/commands/jpeg-stream.d.ts +55 -0
  324. package/node_modules/io.appium.settings/build/lib/commands/jpeg-stream.d.ts.map +1 -0
  325. package/node_modules/io.appium.settings/build/lib/commands/jpeg-stream.js +156 -0
  326. package/node_modules/io.appium.settings/build/lib/commands/jpeg-stream.js.map +1 -0
  327. package/node_modules/io.appium.settings/build/lib/commands/media-projection.d.ts.map +1 -1
  328. package/node_modules/io.appium.settings/build/lib/commands/media-projection.js.map +1 -1
  329. package/node_modules/io.appium.settings/build/lib/commands/media.js +1 -1
  330. package/node_modules/io.appium.settings/build/lib/commands/media.js.map +1 -1
  331. package/node_modules/io.appium.settings/build/lib/commands/network.js +1 -1
  332. package/node_modules/io.appium.settings/build/lib/commands/network.js.map +1 -1
  333. package/node_modules/io.appium.settings/build/lib/commands/types.d.ts +65 -0
  334. package/node_modules/io.appium.settings/build/lib/commands/types.d.ts.map +1 -1
  335. package/node_modules/io.appium.settings/build/lib/commands/video-stream.d.ts +56 -0
  336. package/node_modules/io.appium.settings/build/lib/commands/video-stream.d.ts.map +1 -0
  337. package/node_modules/io.appium.settings/build/lib/commands/video-stream.js +166 -0
  338. package/node_modules/io.appium.settings/build/lib/commands/video-stream.js.map +1 -0
  339. package/node_modules/io.appium.settings/build/lib/constants.d.ts +7 -0
  340. package/node_modules/io.appium.settings/build/lib/constants.d.ts.map +1 -1
  341. package/node_modules/io.appium.settings/build/lib/constants.js +7 -0
  342. package/node_modules/io.appium.settings/build/lib/constants.js.map +1 -1
  343. package/node_modules/io.appium.settings/build/lib/index.js +1 -1
  344. package/node_modules/io.appium.settings/build/lib/index.js.map +1 -1
  345. package/node_modules/io.appium.settings/build/lib/{utils.d.ts → utils/apk-path.d.ts} +1 -1
  346. package/node_modules/io.appium.settings/build/lib/utils/apk-path.d.ts.map +1 -0
  347. package/node_modules/io.appium.settings/build/lib/{utils.js → utils/apk-path.js} +1 -1
  348. package/node_modules/io.appium.settings/build/lib/utils/apk-path.js.map +1 -0
  349. package/node_modules/io.appium.settings/build/lib/utils/index.d.ts +5 -0
  350. package/node_modules/io.appium.settings/build/lib/utils/index.d.ts.map +1 -0
  351. package/node_modules/io.appium.settings/build/lib/utils/index.js +4 -0
  352. package/node_modules/io.appium.settings/build/lib/utils/index.js.map +1 -0
  353. package/node_modules/io.appium.settings/build/lib/utils/streaming-protocol.d.ts +47 -0
  354. package/node_modules/io.appium.settings/build/lib/utils/streaming-protocol.d.ts.map +1 -0
  355. package/node_modules/io.appium.settings/build/lib/utils/streaming-protocol.js +67 -0
  356. package/node_modules/io.appium.settings/build/lib/utils/streaming-protocol.js.map +1 -0
  357. package/node_modules/io.appium.settings/build/lib/utils/streaming-transport.d.ts +142 -0
  358. package/node_modules/io.appium.settings/build/lib/utils/streaming-transport.d.ts.map +1 -0
  359. package/node_modules/io.appium.settings/build/lib/utils/streaming-transport.js +416 -0
  360. package/node_modules/io.appium.settings/build/lib/utils/streaming-transport.js.map +1 -0
  361. package/node_modules/io.appium.settings/lib/client.ts +5 -0
  362. package/node_modules/io.appium.settings/lib/commands/clipboard.ts +1 -0
  363. package/node_modules/io.appium.settings/lib/commands/jpeg-stream.ts +175 -0
  364. package/node_modules/io.appium.settings/lib/commands/media-projection.ts +1 -5
  365. package/node_modules/io.appium.settings/lib/commands/media.ts +1 -1
  366. package/node_modules/io.appium.settings/lib/commands/network.ts +1 -1
  367. package/node_modules/io.appium.settings/lib/commands/types.ts +70 -0
  368. package/node_modules/io.appium.settings/lib/commands/video-stream.ts +185 -0
  369. package/node_modules/io.appium.settings/lib/constants.ts +10 -0
  370. package/node_modules/io.appium.settings/lib/index.ts +1 -1
  371. package/node_modules/io.appium.settings/lib/utils/index.ts +4 -0
  372. package/node_modules/io.appium.settings/lib/utils/streaming-protocol.ts +93 -0
  373. package/node_modules/io.appium.settings/lib/utils/streaming-transport.ts +450 -0
  374. package/node_modules/io.appium.settings/package.json +17 -20
  375. package/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel-react-native.d.ts.map +1 -0
  376. package/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel-react-native.js.map +1 -0
  377. package/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel.d.ts +5 -0
  378. package/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel.js +7 -0
  379. package/node_modules/lru-cache/dist/commonjs/react-native/index.d.ts +1400 -0
  380. package/node_modules/lru-cache/dist/commonjs/react-native/index.d.ts.map +1 -0
  381. package/node_modules/lru-cache/dist/commonjs/react-native/index.js +1733 -0
  382. package/node_modules/lru-cache/dist/commonjs/react-native/index.js.map +1 -0
  383. package/node_modules/lru-cache/dist/commonjs/react-native/perf.d.ts +12 -0
  384. package/node_modules/lru-cache/dist/commonjs/react-native/perf.d.ts.map +1 -0
  385. package/node_modules/lru-cache/dist/commonjs/react-native/perf.js +10 -0
  386. package/node_modules/lru-cache/dist/commonjs/react-native/perf.js.map +1 -0
  387. package/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel-react-native.d.ts.map +1 -0
  388. package/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel-react-native.js.map +1 -0
  389. package/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel.d.ts +5 -0
  390. package/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel.js +4 -0
  391. package/node_modules/lru-cache/dist/esm/react-native/index.d.ts +1400 -0
  392. package/node_modules/lru-cache/dist/esm/react-native/index.d.ts.map +1 -0
  393. package/node_modules/lru-cache/dist/esm/react-native/index.js +1729 -0
  394. package/node_modules/lru-cache/dist/esm/react-native/index.js.map +1 -0
  395. package/node_modules/lru-cache/dist/esm/react-native/perf.d.ts +12 -0
  396. package/node_modules/lru-cache/dist/esm/react-native/perf.d.ts.map +1 -0
  397. package/node_modules/lru-cache/dist/esm/react-native/perf.js +7 -0
  398. package/node_modules/lru-cache/dist/esm/react-native/perf.js.map +1 -0
  399. package/node_modules/lru-cache/package.json +27 -1
  400. package/node_modules/morgan/README.md +49 -10
  401. package/node_modules/morgan/index.js +24 -6
  402. package/node_modules/morgan/package.json +6 -6
  403. package/node_modules/on-finished/index.js +14 -2
  404. package/node_modules/on-finished/package.json +11 -7
  405. package/node_modules/qs/.github/THREAT_MODEL.md +4 -2
  406. package/node_modules/qs/CHANGELOG.md +38 -14
  407. package/node_modules/qs/README.md +31 -3
  408. package/node_modules/qs/dist/qs.js +20 -20
  409. package/node_modules/qs/lib/parse.js +94 -4
  410. package/node_modules/qs/lib/stringify.js +4 -4
  411. package/node_modules/qs/lib/utils.js +130 -6
  412. package/node_modules/qs/package.json +4 -4
  413. package/node_modules/qs/test/parse.js +174 -0
  414. package/node_modules/qs/test/stringify.js +263 -33
  415. package/node_modules/qs/test/utils.js +184 -0
  416. package/node_modules/readable-stream/lib/internal/shims/process.js +19 -0
  417. package/node_modules/readable-stream/lib/internal/streams/destroy.js +1 -1
  418. package/node_modules/readable-stream/lib/internal/streams/duplexify.js +1 -1
  419. package/node_modules/readable-stream/lib/internal/streams/end-of-stream.js +1 -1
  420. package/node_modules/readable-stream/lib/internal/streams/from.js +1 -1
  421. package/node_modules/readable-stream/lib/internal/streams/legacy.js +6 -1
  422. package/node_modules/readable-stream/lib/internal/streams/pipeline.js +1 -1
  423. package/node_modules/readable-stream/lib/internal/streams/readable.js +1 -1
  424. package/node_modules/readable-stream/lib/internal/streams/writable.js +1 -1
  425. package/node_modules/readable-stream/package.json +3 -2
  426. package/node_modules/sharp/dist/index.d.cts +2 -2
  427. package/node_modules/sharp/dist/index.d.mts +3 -3
  428. package/node_modules/sharp/dist/is.cjs +8 -2
  429. package/node_modules/sharp/dist/is.mjs +8 -2
  430. package/node_modules/sharp/dist/operation.cjs +2 -2
  431. package/node_modules/sharp/dist/operation.mjs +2 -2
  432. package/node_modules/sharp/dist/output.cjs +1 -0
  433. package/node_modules/sharp/dist/output.mjs +1 -0
  434. package/node_modules/sharp/dist/resize.cjs +14 -14
  435. package/node_modules/sharp/dist/resize.mjs +14 -14
  436. package/node_modules/sharp/dist/sharp.cjs +3 -3
  437. package/node_modules/sharp/dist/sharp.mjs +3 -3
  438. package/node_modules/sharp/lib/index.d.ts +2 -2
  439. package/node_modules/sharp/package.json +35 -35
  440. package/node_modules/sharp/src/binding.gyp +1 -1
  441. package/node_modules/sharp/src/common.cc +4 -4
  442. package/node_modules/sharp/src/common.h +2 -2
  443. package/node_modules/sharp/src/pipeline.cc +31 -6
  444. package/node_modules/sharp/src/utilities.cc +1 -1
  445. package/node_modules/stream-buffers/.codeclimate.yml +12 -0
  446. package/node_modules/stream-buffers/.eslintignore +1 -0
  447. package/node_modules/stream-buffers/.eslintrc +25 -0
  448. package/node_modules/stream-buffers/.github/workflows/codeql-analysis.yml +71 -0
  449. package/node_modules/stream-buffers/.github/workflows/node.js.yml +31 -0
  450. package/node_modules/stream-buffers/.mailmap +1 -0
  451. package/node_modules/stream-buffers/.nvmrc +1 -0
  452. package/node_modules/stream-buffers/README.md +65 -65
  453. package/node_modules/stream-buffers/lib/constants.js +8 -6
  454. package/node_modules/stream-buffers/lib/readable_streambuffer.js +114 -136
  455. package/node_modules/stream-buffers/lib/streambuffer.js +5 -3
  456. package/node_modules/stream-buffers/lib/writable_streambuffer.js +72 -97
  457. package/node_modules/stream-buffers/package.json +7 -5
  458. package/node_modules/tar-stream/package.json +7 -7
  459. package/node_modules/type-fest/index.d.ts +7 -7
  460. package/node_modules/type-fest/package.json +2 -1
  461. package/node_modules/type-fest/readme.md +7 -16
  462. package/node_modules/type-fest/source/all-extend.d.ts +9 -7
  463. package/node_modules/type-fest/source/array-reverse.d.ts +13 -12
  464. package/node_modules/type-fest/source/array-tail.d.ts +3 -3
  465. package/node_modules/type-fest/source/delimiter-case.d.ts +1 -1
  466. package/node_modules/type-fest/source/get.d.ts +1 -1
  467. package/node_modules/type-fest/source/int-closed-range.d.ts +4 -1
  468. package/node_modules/type-fest/source/int-range.d.ts +56 -9
  469. package/node_modules/type-fest/source/internal/array.d.ts +14 -13
  470. package/node_modules/type-fest/source/internal/numeric.d.ts +0 -38
  471. package/node_modules/type-fest/source/internal/object.d.ts +30 -1
  472. package/node_modules/type-fest/source/is-boolean-literal.d.ts +39 -0
  473. package/node_modules/type-fest/source/is-literal.d.ts +43 -269
  474. package/node_modules/type-fest/source/is-numeric-literal.d.ts +50 -0
  475. package/node_modules/type-fest/source/is-string-literal.d.ts +72 -0
  476. package/node_modules/type-fest/source/is-symbol-literal.d.ts +39 -0
  477. package/node_modules/type-fest/source/is-tuple.d.ts +3 -3
  478. package/node_modules/type-fest/source/jsonify.d.ts +1 -5
  479. package/node_modules/type-fest/source/merge-deep.d.ts +3 -3
  480. package/node_modules/type-fest/source/remove-prefix.d.ts +1 -1
  481. package/node_modules/type-fest/source/remove-suffix.d.ts +1 -1
  482. package/node_modules/type-fest/source/rename-keys.d.ts +163 -0
  483. package/node_modules/type-fest/source/set-required.d.ts +10 -9
  484. package/node_modules/type-fest/source/shared-union-fields-deep.d.ts +6 -4
  485. package/node_modules/type-fest/source/some-extend.d.ts +9 -7
  486. package/node_modules/type-fest/source/split-on-rest-element.d.ts +14 -13
  487. package/node_modules/type-fest/source/split.d.ts +22 -11
  488. package/node_modules/type-fest/source/string-repeat.d.ts +1 -1
  489. package/node_modules/type-fest/source/string-to-array.d.ts +1 -1
  490. package/node_modules/type-fest/source/tsconfig-json.d.ts +1 -1
  491. package/node_modules/type-fest/source/typed-array.d.ts +6 -0
  492. package/node_modules/type-fest/source/union-max.d.ts +56 -0
  493. package/node_modules/type-fest/source/writable.d.ts +2 -2
  494. package/node_modules/xpath/LICENSE +22 -22
  495. package/node_modules/xpath/package.json +43 -43
  496. package/node_modules/xpath/xpath.d.ts +51 -51
  497. package/node_modules/xpath/xpath.js +17 -2
  498. package/package.json +5 -5
  499. package/node_modules/@appium/base-driver/node_modules/axios/CHANGELOG.md +0 -1872
  500. package/node_modules/@appium/base-driver/node_modules/axios/LICENSE +0 -7
  501. package/node_modules/@appium/base-driver/node_modules/axios/MIGRATION_GUIDE.md +0 -877
  502. package/node_modules/@appium/base-driver/node_modules/axios/README.md +0 -2623
  503. package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.js +0 -5509
  504. package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.min.js +0 -5
  505. package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.min.js.map +0 -1
  506. package/node_modules/@appium/base-driver/node_modules/axios/dist/browser/axios.cjs +0 -5469
  507. package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.js +0 -5490
  508. package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.min.js +0 -3
  509. package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.min.js.map +0 -1
  510. package/node_modules/@appium/base-driver/node_modules/axios/dist/node/axios.cjs +0 -6356
  511. package/node_modules/@appium/base-driver/node_modules/axios/index.d.cts +0 -762
  512. package/node_modules/@appium/base-driver/node_modules/axios/index.d.ts +0 -783
  513. package/node_modules/@appium/base-driver/node_modules/axios/index.js +0 -45
  514. package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/README.md +0 -36
  515. package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/adapters.js +0 -132
  516. package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/fetch.js +0 -643
  517. package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/http.js +0 -1406
  518. package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/xhr.js +0 -228
  519. package/node_modules/@appium/base-driver/node_modules/axios/lib/axios.js +0 -89
  520. package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/CancelToken.js +0 -135
  521. package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/CanceledError.js +0 -22
  522. package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/isCancel.js +0 -5
  523. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/Axios.js +0 -301
  524. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/AxiosError.js +0 -219
  525. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/AxiosHeaders.js +0 -474
  526. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/InterceptorManager.js +0 -72
  527. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/README.md +0 -8
  528. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/buildFullPath.js +0 -88
  529. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/dispatchRequest.js +0 -89
  530. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/mergeConfig.js +0 -174
  531. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/setFormDataHeaders.js +0 -27
  532. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/settle.js +0 -27
  533. package/node_modules/@appium/base-driver/node_modules/axios/lib/core/transformData.js +0 -28
  534. package/node_modules/@appium/base-driver/node_modules/axios/lib/defaults/index.js +0 -177
  535. package/node_modules/@appium/base-driver/node_modules/axios/lib/defaults/transitional.js +0 -10
  536. package/node_modules/@appium/base-driver/node_modules/axios/lib/env/README.md +0 -3
  537. package/node_modules/@appium/base-driver/node_modules/axios/lib/env/classes/FormData.js +0 -2
  538. package/node_modules/@appium/base-driver/node_modules/axios/lib/env/data.js +0 -1
  539. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/AxiosTransformStream.js +0 -156
  540. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +0 -59
  541. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/Http2Sessions.js +0 -119
  542. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/HttpStatusCode.js +0 -78
  543. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/README.md +0 -7
  544. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +0 -29
  545. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/bind.js +0 -14
  546. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/buildURL.js +0 -69
  547. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/callbackify.js +0 -18
  548. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/combineURLs.js +0 -23
  549. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/composeSignals.js +0 -68
  550. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/cookies.js +0 -64
  551. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/deprecatedMethod.js +0 -31
  552. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/estimateDataURLDecodedBytes.js +0 -166
  553. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/formDataToJSON.js +0 -125
  554. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/formDataToStream.js +0 -119
  555. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/fromDataURI.js +0 -68
  556. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isAbsoluteURL.js +0 -19
  557. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isAxiosError.js +0 -14
  558. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isURLSameOrigin.js +0 -16
  559. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/null.js +0 -2
  560. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/parseHeaders.js +0 -71
  561. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/parseProtocol.js +0 -6
  562. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/progressEventReducer.js +0 -54
  563. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/readBlob.js +0 -15
  564. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/resolveConfig.js +0 -105
  565. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/sanitizeHeaderValue.js +0 -60
  566. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/shouldBypassProxy.js +0 -329
  567. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/speedometer.js +0 -55
  568. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/spread.js +0 -28
  569. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/throttle.js +0 -44
  570. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/toFormData.js +0 -286
  571. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/toURLEncodedForm.js +0 -19
  572. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/trackStream.js +0 -89
  573. package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/validator.js +0 -112
  574. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/Blob.js +0 -3
  575. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/FormData.js +0 -3
  576. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +0 -4
  577. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/index.js +0 -13
  578. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/common/utils.js +0 -52
  579. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/index.js +0 -7
  580. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/Buffer.js +0 -11
  581. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/FormData.js +0 -3
  582. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +0 -4
  583. package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/index.js +0 -37
  584. package/node_modules/@appium/base-driver/node_modules/axios/lib/utils.js +0 -1029
  585. package/node_modules/@appium/base-driver/node_modules/axios/package.json +0 -203
  586. package/node_modules/@appium/support/node_modules/axios/CHANGELOG.md +0 -1872
  587. package/node_modules/@appium/support/node_modules/axios/LICENSE +0 -7
  588. package/node_modules/@appium/support/node_modules/axios/MIGRATION_GUIDE.md +0 -877
  589. package/node_modules/@appium/support/node_modules/axios/README.md +0 -2623
  590. package/node_modules/@appium/support/node_modules/axios/dist/axios.js +0 -5509
  591. package/node_modules/@appium/support/node_modules/axios/dist/axios.min.js +0 -5
  592. package/node_modules/@appium/support/node_modules/axios/dist/axios.min.js.map +0 -1
  593. package/node_modules/@appium/support/node_modules/axios/dist/browser/axios.cjs +0 -5469
  594. package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.js +0 -5490
  595. package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.min.js +0 -3
  596. package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.min.js.map +0 -1
  597. package/node_modules/@appium/support/node_modules/axios/dist/node/axios.cjs +0 -6356
  598. package/node_modules/@appium/support/node_modules/axios/index.d.cts +0 -762
  599. package/node_modules/@appium/support/node_modules/axios/index.d.ts +0 -783
  600. package/node_modules/@appium/support/node_modules/axios/index.js +0 -45
  601. package/node_modules/@appium/support/node_modules/axios/lib/adapters/README.md +0 -36
  602. package/node_modules/@appium/support/node_modules/axios/lib/adapters/adapters.js +0 -132
  603. package/node_modules/@appium/support/node_modules/axios/lib/adapters/fetch.js +0 -643
  604. package/node_modules/@appium/support/node_modules/axios/lib/adapters/http.js +0 -1406
  605. package/node_modules/@appium/support/node_modules/axios/lib/adapters/xhr.js +0 -228
  606. package/node_modules/@appium/support/node_modules/axios/lib/axios.js +0 -89
  607. package/node_modules/@appium/support/node_modules/axios/lib/cancel/CancelToken.js +0 -135
  608. package/node_modules/@appium/support/node_modules/axios/lib/cancel/CanceledError.js +0 -22
  609. package/node_modules/@appium/support/node_modules/axios/lib/cancel/isCancel.js +0 -5
  610. package/node_modules/@appium/support/node_modules/axios/lib/core/Axios.js +0 -301
  611. package/node_modules/@appium/support/node_modules/axios/lib/core/AxiosError.js +0 -219
  612. package/node_modules/@appium/support/node_modules/axios/lib/core/AxiosHeaders.js +0 -474
  613. package/node_modules/@appium/support/node_modules/axios/lib/core/InterceptorManager.js +0 -72
  614. package/node_modules/@appium/support/node_modules/axios/lib/core/README.md +0 -8
  615. package/node_modules/@appium/support/node_modules/axios/lib/core/buildFullPath.js +0 -88
  616. package/node_modules/@appium/support/node_modules/axios/lib/core/dispatchRequest.js +0 -89
  617. package/node_modules/@appium/support/node_modules/axios/lib/core/mergeConfig.js +0 -174
  618. package/node_modules/@appium/support/node_modules/axios/lib/core/setFormDataHeaders.js +0 -27
  619. package/node_modules/@appium/support/node_modules/axios/lib/core/settle.js +0 -27
  620. package/node_modules/@appium/support/node_modules/axios/lib/core/transformData.js +0 -28
  621. package/node_modules/@appium/support/node_modules/axios/lib/defaults/index.js +0 -177
  622. package/node_modules/@appium/support/node_modules/axios/lib/defaults/transitional.js +0 -10
  623. package/node_modules/@appium/support/node_modules/axios/lib/env/README.md +0 -3
  624. package/node_modules/@appium/support/node_modules/axios/lib/env/classes/FormData.js +0 -2
  625. package/node_modules/@appium/support/node_modules/axios/lib/env/data.js +0 -1
  626. package/node_modules/@appium/support/node_modules/axios/lib/helpers/AxiosTransformStream.js +0 -156
  627. package/node_modules/@appium/support/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +0 -59
  628. package/node_modules/@appium/support/node_modules/axios/lib/helpers/Http2Sessions.js +0 -119
  629. package/node_modules/@appium/support/node_modules/axios/lib/helpers/HttpStatusCode.js +0 -78
  630. package/node_modules/@appium/support/node_modules/axios/lib/helpers/README.md +0 -7
  631. package/node_modules/@appium/support/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +0 -29
  632. package/node_modules/@appium/support/node_modules/axios/lib/helpers/bind.js +0 -14
  633. package/node_modules/@appium/support/node_modules/axios/lib/helpers/buildURL.js +0 -69
  634. package/node_modules/@appium/support/node_modules/axios/lib/helpers/callbackify.js +0 -18
  635. package/node_modules/@appium/support/node_modules/axios/lib/helpers/combineURLs.js +0 -23
  636. package/node_modules/@appium/support/node_modules/axios/lib/helpers/composeSignals.js +0 -68
  637. package/node_modules/@appium/support/node_modules/axios/lib/helpers/cookies.js +0 -64
  638. package/node_modules/@appium/support/node_modules/axios/lib/helpers/deprecatedMethod.js +0 -31
  639. package/node_modules/@appium/support/node_modules/axios/lib/helpers/estimateDataURLDecodedBytes.js +0 -166
  640. package/node_modules/@appium/support/node_modules/axios/lib/helpers/formDataToJSON.js +0 -125
  641. package/node_modules/@appium/support/node_modules/axios/lib/helpers/formDataToStream.js +0 -119
  642. package/node_modules/@appium/support/node_modules/axios/lib/helpers/fromDataURI.js +0 -68
  643. package/node_modules/@appium/support/node_modules/axios/lib/helpers/isAbsoluteURL.js +0 -19
  644. package/node_modules/@appium/support/node_modules/axios/lib/helpers/isAxiosError.js +0 -14
  645. package/node_modules/@appium/support/node_modules/axios/lib/helpers/isURLSameOrigin.js +0 -16
  646. package/node_modules/@appium/support/node_modules/axios/lib/helpers/null.js +0 -2
  647. package/node_modules/@appium/support/node_modules/axios/lib/helpers/parseHeaders.js +0 -71
  648. package/node_modules/@appium/support/node_modules/axios/lib/helpers/parseProtocol.js +0 -6
  649. package/node_modules/@appium/support/node_modules/axios/lib/helpers/progressEventReducer.js +0 -54
  650. package/node_modules/@appium/support/node_modules/axios/lib/helpers/readBlob.js +0 -15
  651. package/node_modules/@appium/support/node_modules/axios/lib/helpers/resolveConfig.js +0 -105
  652. package/node_modules/@appium/support/node_modules/axios/lib/helpers/sanitizeHeaderValue.js +0 -60
  653. package/node_modules/@appium/support/node_modules/axios/lib/helpers/shouldBypassProxy.js +0 -329
  654. package/node_modules/@appium/support/node_modules/axios/lib/helpers/speedometer.js +0 -55
  655. package/node_modules/@appium/support/node_modules/axios/lib/helpers/spread.js +0 -28
  656. package/node_modules/@appium/support/node_modules/axios/lib/helpers/throttle.js +0 -44
  657. package/node_modules/@appium/support/node_modules/axios/lib/helpers/toFormData.js +0 -286
  658. package/node_modules/@appium/support/node_modules/axios/lib/helpers/toURLEncodedForm.js +0 -19
  659. package/node_modules/@appium/support/node_modules/axios/lib/helpers/trackStream.js +0 -89
  660. package/node_modules/@appium/support/node_modules/axios/lib/helpers/validator.js +0 -112
  661. package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/Blob.js +0 -3
  662. package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/FormData.js +0 -3
  663. package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +0 -4
  664. package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/index.js +0 -13
  665. package/node_modules/@appium/support/node_modules/axios/lib/platform/common/utils.js +0 -52
  666. package/node_modules/@appium/support/node_modules/axios/lib/platform/index.js +0 -7
  667. package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/Buffer.js +0 -11
  668. package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/FormData.js +0 -3
  669. package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +0 -4
  670. package/node_modules/@appium/support/node_modules/axios/lib/platform/node/index.js +0 -37
  671. package/node_modules/@appium/support/node_modules/axios/lib/utils.js +0 -1029
  672. package/node_modules/@appium/support/node_modules/axios/package.json +0 -203
  673. package/node_modules/@img/sharp-linux-x64/lib/sharp-linux-x64-0.35.4.node +0 -0
  674. package/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts +0 -103
  675. package/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts.map +0 -1
  676. package/node_modules/asyncbox/build/cjs/lib/asyncbox.js +0 -311
  677. package/node_modules/asyncbox/build/cjs/lib/asyncbox.js.map +0 -1
  678. package/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts +0 -103
  679. package/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts.map +0 -1
  680. package/node_modules/asyncbox/build/esm/lib/asyncbox.js +0 -298
  681. package/node_modules/asyncbox/build/esm/lib/asyncbox.js.map +0 -1
  682. package/node_modules/asyncbox/lib/asyncbox.ts +0 -382
  683. package/node_modules/big-integer/BigInteger.d.ts +0 -2393
  684. package/node_modules/big-integer/BigInteger.js +0 -1453
  685. package/node_modules/big-integer/BigInteger.min.js +0 -1
  686. package/node_modules/big-integer/LICENSE +0 -24
  687. package/node_modules/big-integer/README.md +0 -589
  688. package/node_modules/big-integer/bower.json +0 -29
  689. package/node_modules/big-integer/package.json +0 -48
  690. package/node_modules/big-integer/tsconfig.json +0 -24
  691. package/node_modules/bplist-creator/bplistCreator.d.ts +0 -8
  692. package/node_modules/bplist-creator/bplistCreator.js +0 -460
  693. package/node_modules/bplist-creator/test/airplay.bplist +0 -0
  694. package/node_modules/bplist-creator/test/binaryData.bplist +0 -0
  695. package/node_modules/bplist-creator/test/creatorTest.js +0 -211
  696. package/node_modules/bplist-creator/test/iTunes-small.bplist +0 -0
  697. package/node_modules/bplist-creator/test/integers.bplist +0 -0
  698. package/node_modules/bplist-creator/test/sample1.bplist +0 -0
  699. package/node_modules/bplist-creator/test/sample2.bplist +0 -0
  700. package/node_modules/bplist-creator/test/uid.bplist +0 -0
  701. package/node_modules/bplist-creator/test/utf16.bplist +0 -0
  702. package/node_modules/bplist-parser/.editorconfig +0 -12
  703. package/node_modules/bplist-parser/.eslintignore +0 -1
  704. package/node_modules/bplist-parser/.eslintrc.js +0 -296
  705. package/node_modules/bplist-parser/bplistParser.d.ts +0 -8
  706. package/node_modules/io.appium.settings/build/lib/utils.d.ts.map +0 -1
  707. package/node_modules/io.appium.settings/build/lib/utils.js.map +0 -1
  708. package/node_modules/on-finished/HISTORY.md +0 -98
  709. package/node_modules/stream-buffers/.travis.yml +0 -28
  710. package/node_modules/stream-buffers/coverage/coverage.json +0 -1
  711. package/node_modules/stream-buffers/coverage/lcov-report/base.css +0 -182
  712. package/node_modules/stream-buffers/coverage/lcov-report/index.html +0 -73
  713. package/node_modules/stream-buffers/coverage/lcov-report/lib/constants.js.html +0 -63
  714. package/node_modules/stream-buffers/coverage/lcov-report/lib/index.html +0 -112
  715. package/node_modules/stream-buffers/coverage/lcov-report/lib/readable_streambuffer.js.html +0 -453
  716. package/node_modules/stream-buffers/coverage/lcov-report/lib/streambuffer.js.html +0 -54
  717. package/node_modules/stream-buffers/coverage/lcov-report/lib/writable_streambuffer.js.html +0 -336
  718. package/node_modules/stream-buffers/coverage/lcov-report/prettify.css +0 -1
  719. package/node_modules/stream-buffers/coverage/lcov-report/prettify.js +0 -1
  720. package/node_modules/stream-buffers/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  721. package/node_modules/stream-buffers/coverage/lcov-report/sorter.js +0 -156
  722. package/node_modules/stream-buffers/coverage/lcov.info +0 -305
  723. /package/node_modules/io.appium.settings/lib/{utils.ts → utils/apk-path.ts} +0 -0
@@ -0,0 +1,175 @@
1
+ import {randomUUID} from 'node:crypto';
2
+
3
+ import type {ADB} from 'appium-adb';
4
+ import {waitForCondition} from 'asyncbox';
5
+
6
+ import type {SettingsApp} from '../client.js';
7
+ import {
8
+ JPEG_STREAM_ACTION_START,
9
+ JPEG_STREAM_ACTION_STOP,
10
+ JPEG_STREAM_SERVICE_NAME,
11
+ SETTINGS_HELPER_ID,
12
+ STREAMING_ACTIVITY_NAME,
13
+ } from '../constants.js';
14
+ import {StreamTransport, validateLocalPortOpts} from '../utils/index.js';
15
+ import type {JpegFrame, StartJpegStreamOpts} from './types.js';
16
+
17
+ const STREAM_STARTUP_TIMEOUT_MS = 10 * 1000;
18
+ const STREAM_STOP_TIMEOUT_MS = 3 * 1000;
19
+
20
+ /**
21
+ * Creates a new instance of the live JPEG frame streaming session.
22
+ * The stream only works since Android API 29+
23
+ *
24
+ * @returns The streaming session instance
25
+ */
26
+ export function makeJpegStreamSession(this: SettingsApp): JpegStreamSession {
27
+ return new JpegStreamSession(this.adb);
28
+ }
29
+
30
+ function validateJpegStreamOpts(opts: StartJpegStreamOpts): void {
31
+ const {fps, quality, scale} = opts;
32
+ if (fps !== undefined && (!Number.isInteger(fps) || fps <= 0)) {
33
+ throw new TypeError(`fps must be a positive integer, got ${fps}`);
34
+ }
35
+ if (quality !== undefined && (!Number.isInteger(quality) || quality < 1 || quality > 100)) {
36
+ throw new TypeError(`quality must be an integer between 1 and 100, got ${quality}`);
37
+ }
38
+ if (scale !== undefined && (!Number.isInteger(scale) || scale < 1 || scale > 100)) {
39
+ throw new TypeError(`scale must be an integer between 1 and 100, got ${scale}`);
40
+ }
41
+ validateLocalPortOpts(opts);
42
+ }
43
+
44
+ /**
45
+ * Live JPEG frame streaming session for the device screen.
46
+ * This class provides methods to start, stop, and consume a continuous
47
+ * sequence of JPEG-encoded frames over a local socket (API 29+).
48
+ */
49
+ export class JpegStreamSession {
50
+ private transport: StreamTransport | null = null;
51
+
52
+ /**
53
+ * Creates a new JpegStreamSession instance.
54
+ *
55
+ * @param adb - ADB instance for device communication
56
+ */
57
+ constructor(private readonly adb: ADB) {}
58
+
59
+ /**
60
+ * Checks if the JPEG stream is currently running.
61
+ */
62
+ async isRunning(): Promise<boolean> {
63
+ const stdout = await this.adb.shell(['dumpsys', 'activity', 'services', JPEG_STREAM_SERVICE_NAME]);
64
+ return stdout.includes(JPEG_STREAM_SERVICE_NAME);
65
+ }
66
+
67
+ /**
68
+ * Starts the live JPEG frame stream.
69
+ * If a stream is already running, this method returns false without starting a new one.
70
+ *
71
+ * @param opts Streaming options including fps, quality, scale, and the local port to use
72
+ * @returns True if the stream was started successfully, false if already running
73
+ * @throws {Error} If the stream fails to start within the timeout period
74
+ */
75
+ async start(opts: StartJpegStreamOpts = {}): Promise<boolean> {
76
+ validateJpegStreamOpts(opts);
77
+ if (await this.isRunning()) {
78
+ return false;
79
+ }
80
+
81
+ const {fps, quality, scale, localPort, localPortRange} = opts;
82
+ // Socket names are validated on-device against ^[a-zA-Z0-9._-]{1,200}$, so this
83
+ // must not contain a "/" - unlike JPEG_STREAM_SERVICE_NAME.
84
+ const socketName = `${SETTINGS_HELPER_ID}.jpegstream.${randomUUID()}`;
85
+ const args = [
86
+ 'am',
87
+ 'start',
88
+ '-n',
89
+ STREAMING_ACTIVITY_NAME,
90
+ '-a',
91
+ JPEG_STREAM_ACTION_START,
92
+ '--es',
93
+ 'socket_name',
94
+ socketName,
95
+ ];
96
+ if (fps) {
97
+ args.push('--es', 'fps', `${fps}`);
98
+ }
99
+ if (quality) {
100
+ args.push('--es', 'quality', `${quality}`);
101
+ }
102
+ if (scale) {
103
+ args.push('--es', 'scale', `${scale}`);
104
+ }
105
+
106
+ await this.adb.shell(args);
107
+ try {
108
+ await waitForCondition(async () => await this.isRunning(), {
109
+ waitMs: STREAM_STARTUP_TIMEOUT_MS,
110
+ intervalMs: 300,
111
+ });
112
+ } catch {
113
+ throw new Error(
114
+ `The JPEG stream is not running after ${STREAM_STARTUP_TIMEOUT_MS}ms. ` +
115
+ `Please check the logcat output for more details.`,
116
+ );
117
+ }
118
+
119
+ this.transport = await StreamTransport.connect(this.adb, socketName, {localPort, localPortRange});
120
+ return true;
121
+ }
122
+
123
+ /**
124
+ * Yields JPEG frames as they arrive from the device.
125
+ * `start()` must be called before iterating.
126
+ *
127
+ * A device rotation reconfigures the capture pipeline to the new dimensions, so a
128
+ * later frame's width/height (decoded from its own JPEG header) may differ from
129
+ * the first frame's - consumers should not assume a fixed size across the stream.
130
+ */
131
+ async *frames(): AsyncGenerator<JpegFrame> {
132
+ if (!this.transport) {
133
+ throw new Error('The JPEG stream has not been started. Call start() first.');
134
+ }
135
+ for await (const frame of this.transport.frames()) {
136
+ yield {
137
+ data: frame.data,
138
+ sequence: Number(frame.sequence),
139
+ timestampMicros: Number(frame.timestampMicros),
140
+ };
141
+ }
142
+ }
143
+
144
+ /**
145
+ * Stops the currently running JPEG stream.
146
+ *
147
+ * @returns True if the stream was stopped successfully, false if it was not running
148
+ * @throws {Error} If the stream fails to stop within the timeout period
149
+ */
150
+ async stop(): Promise<boolean> {
151
+ try {
152
+ if (!(await this.isRunning())) {
153
+ // The on-device service may have already stopped itself (e.g. the client
154
+ // disconnected), leaving a local transport/adb-forward that still needs closing.
155
+ return false;
156
+ }
157
+
158
+ await this.adb.shell(['am', 'start', '-n', STREAMING_ACTIVITY_NAME, '-a', JPEG_STREAM_ACTION_STOP]);
159
+ try {
160
+ await waitForCondition(async () => !(await this.isRunning()), {
161
+ waitMs: STREAM_STOP_TIMEOUT_MS,
162
+ intervalMs: 300,
163
+ });
164
+ } catch {
165
+ throw new Error(`The attempt to stop the current JPEG stream timed out after ${STREAM_STOP_TIMEOUT_MS}ms`);
166
+ }
167
+ return true;
168
+ } finally {
169
+ if (this.transport) {
170
+ await this.transport.close();
171
+ this.transport = null;
172
+ }
173
+ }
174
+ }
175
+ }
@@ -48,16 +48,12 @@ const RECORDINGS_ROOT = `/storage/emulated/0/Android/data/${SETTINGS_HELPER_ID}/
48
48
  * using Android's MediaProjection API (API 29+).
49
49
  */
50
50
  export class MediaProjectionRecorder {
51
- private readonly adb: ADB;
52
-
53
51
  /**
54
52
  * Creates a new MediaProjectionRecorder instance.
55
53
  *
56
54
  * @param adb - ADB instance for device communication
57
55
  */
58
- constructor(adb: ADB) {
59
- this.adb = adb;
60
- }
56
+ constructor(private readonly adb: ADB) {}
61
57
 
62
58
  /**
63
59
  * Checks if the recording is currently running.
@@ -13,7 +13,7 @@ import {LOG_PREFIX} from '../logger.js';
13
13
  export async function scanMedia(this: SettingsApp, destination: string): Promise<void> {
14
14
  this.log.debug(LOG_PREFIX, `Scanning '${destination}' for media files`);
15
15
  await this.checkBroadcast(
16
- ['-n', MEDIA_SCAN_RECEIVER, '-a', MEDIA_SCAN_ACTION, '--es', 'path', destination],
16
+ ['-n', MEDIA_SCAN_RECEIVER, '-a', MEDIA_SCAN_ACTION, '--es', 'path', `'${destination.replace(/'/g, `'"'"'`)}'`],
17
17
  'scan media',
18
18
  );
19
19
  }
@@ -51,7 +51,7 @@ export async function setDataState(this: SettingsApp, on: boolean, isEmulator =
51
51
  try {
52
52
  await this.adb.shell(['cmd', 'phone', 'data', on ? 'enable' : 'disable']);
53
53
  } catch (e: any) {
54
- throw new Error(`Cannot change the data state. Original error: ${e.stderr || e.message}`);
54
+ throw new Error(`Cannot change the data state. Original error: ${e.stderr || e.message}`, {cause: e});
55
55
  }
56
56
  }
57
57
  }
@@ -37,6 +37,76 @@ export interface StartMediaProjectionRecordingOpts {
37
37
  filename?: string;
38
38
  }
39
39
 
40
+ /**
41
+ * Options for choosing the local TCP port used to bridge a live stream's
42
+ * on-device socket to the host via `adb forward`. At most one of these may be
43
+ * provided; if neither is given, an OS-assigned ephemeral port is used.
44
+ */
45
+ export interface LocalPortOpts {
46
+ /** Use this exact local TCP port. Throws if it's already in use. */
47
+ localPort?: number;
48
+ /** Pick the first free local TCP port from this inclusive [min, max] range. */
49
+ localPortRange?: [number, number];
50
+ }
51
+
52
+ /**
53
+ * Options for starting a live JPEG frame streaming session.
54
+ */
55
+ export interface StartJpegStreamOpts extends LocalPortOpts {
56
+ /** Frames per second requested; actual rate may be lower on constrained devices. Default 60. */
57
+ fps?: number;
58
+ /** JPEG quality, 1-100. Default 80. */
59
+ quality?: number;
60
+ /** Percentage (1-100) to scale the captured frame to before JPEG encoding. Default 100. */
61
+ scale?: number;
62
+ }
63
+
64
+ /**
65
+ * Options for starting a live H.264/HEVC video streaming session.
66
+ */
67
+ export interface StartVideoStreamOpts extends LocalPortOpts {
68
+ /** Default 'h264'. */
69
+ codec?: 'h264' | 'hevc';
70
+ /** Default 30. */
71
+ fps?: number;
72
+ /** Default 4000000 (4 Mbps). */
73
+ bitrate?: number;
74
+ /** Same "WxH" syntax/allowed values as StartMediaProjectionRecordingOpts.resolution. */
75
+ resolution?: string;
76
+ /** Interleave an AAC audio track captured via AudioPlaybackCaptureConfiguration. Default false. */
77
+ audio?: boolean;
78
+ }
79
+
80
+ /**
81
+ * A single JPEG-encoded frame of the device screen.
82
+ */
83
+ export interface JpegFrame {
84
+ /** The raw JPEG-encoded image bytes. */
85
+ data: Buffer;
86
+ /** Monotonically increasing frame sequence number. */
87
+ sequence: number;
88
+ /** Frame timestamp, in microseconds since the stream session started. */
89
+ timestampMicros: number;
90
+ }
91
+
92
+ /**
93
+ * A single encoded access unit from a live video stream: either a video NAL
94
+ * unit (Annex-B, H.264/HEVC) or an AAC audio unit (ADTS-framed).
95
+ */
96
+ export interface AccessUnit {
97
+ track: 'video' | 'audio';
98
+ /** The raw access unit bytes. */
99
+ data: Buffer;
100
+ /** Monotonically increasing sequence number, per track. */
101
+ sequence: number;
102
+ /** Presentation timestamp, in microseconds since the stream session started. */
103
+ timestampMicros: number;
104
+ /** Whether this is a video keyframe (always false for audio units). */
105
+ isKeyFrame: boolean;
106
+ /** Whether this unit carries codec configuration data (e.g. SPS/PPS) rather than actual samples. */
107
+ isConfig: boolean;
108
+ }
109
+
40
110
  /**
41
111
  * Supported locale information.
42
112
  */
@@ -0,0 +1,185 @@
1
+ import {randomUUID} from 'node:crypto';
2
+
3
+ import type {ADB} from 'appium-adb';
4
+ import {waitForCondition} from 'asyncbox';
5
+
6
+ import type {SettingsApp} from '../client.js';
7
+ import {
8
+ SETTINGS_HELPER_ID,
9
+ STREAMING_ACTIVITY_NAME,
10
+ VIDEO_STREAM_ACTION_START,
11
+ VIDEO_STREAM_ACTION_STOP,
12
+ VIDEO_STREAM_SERVICE_NAME,
13
+ } from '../constants.js';
14
+ import {StreamTrack, StreamTransport, validateLocalPortOpts} from '../utils/index.js';
15
+ import type {AccessUnit, StartVideoStreamOpts} from './types.js';
16
+
17
+ const STREAM_STARTUP_TIMEOUT_MS = 10 * 1000;
18
+ const STREAM_STOP_TIMEOUT_MS = 3 * 1000;
19
+
20
+ /**
21
+ * Creates a new instance of the live H.264/HEVC video streaming session.
22
+ * The stream only works since Android API 29+
23
+ *
24
+ * @returns The streaming session instance
25
+ */
26
+ export function makeVideoStreamSession(this: SettingsApp): VideoStreamSession {
27
+ return new VideoStreamSession(this.adb);
28
+ }
29
+
30
+ function validateVideoStreamOpts(opts: StartVideoStreamOpts): void {
31
+ const {codec, fps, bitrate} = opts;
32
+ if (codec !== undefined && codec !== 'h264' && codec !== 'hevc') {
33
+ throw new TypeError(`codec must be either 'h264' or 'hevc', got ${codec}`);
34
+ }
35
+ if (fps !== undefined && (!Number.isInteger(fps) || fps <= 0)) {
36
+ throw new TypeError(`fps must be a positive integer, got ${fps}`);
37
+ }
38
+ if (bitrate !== undefined && (!Number.isInteger(bitrate) || bitrate <= 0)) {
39
+ throw new TypeError(`bitrate must be a positive integer, got ${bitrate}`);
40
+ }
41
+ validateLocalPortOpts(opts);
42
+ }
43
+
44
+ /**
45
+ * Live H.264/HEVC video streaming session for the device screen, with an
46
+ * optional interleaved AAC audio track.
47
+ */
48
+ export class VideoStreamSession {
49
+ private transport: StreamTransport | null = null;
50
+
51
+ /**
52
+ * Creates a new VideoStreamSession instance.
53
+ *
54
+ * @param adb - ADB instance for device communication
55
+ */
56
+ constructor(private readonly adb: ADB) {}
57
+
58
+ /**
59
+ * Checks if the video stream is currently running.
60
+ */
61
+ async isRunning(): Promise<boolean> {
62
+ const stdout = await this.adb.shell(['dumpsys', 'activity', 'services', VIDEO_STREAM_SERVICE_NAME]);
63
+ return stdout.includes(VIDEO_STREAM_SERVICE_NAME);
64
+ }
65
+
66
+ /**
67
+ * Starts the live video stream.
68
+ * If a stream is already running, this method returns false without starting a new one.
69
+ *
70
+ * @param opts Streaming options including codec, fps, bitrate, resolution, audio, and the local port to use
71
+ * @returns True if the stream was started successfully, false if already running
72
+ * @throws {Error} If the stream fails to start within the timeout period
73
+ */
74
+ async start(opts: StartVideoStreamOpts = {}): Promise<boolean> {
75
+ validateVideoStreamOpts(opts);
76
+ if (await this.isRunning()) {
77
+ return false;
78
+ }
79
+
80
+ const {codec, fps, bitrate, resolution, audio, localPort, localPortRange} = opts;
81
+ // Socket names are validated on-device against ^[a-zA-Z0-9._-]{1,200}$, so this
82
+ // must not contain a "/" - unlike VIDEO_STREAM_SERVICE_NAME.
83
+ const socketName = `${SETTINGS_HELPER_ID}.videostream.${randomUUID()}`;
84
+ const args = [
85
+ 'am',
86
+ 'start',
87
+ '-n',
88
+ STREAMING_ACTIVITY_NAME,
89
+ '-a',
90
+ VIDEO_STREAM_ACTION_START,
91
+ '--es',
92
+ 'socket_name',
93
+ socketName,
94
+ ];
95
+ if (codec) {
96
+ args.push('--es', 'codec', codec);
97
+ }
98
+ if (fps) {
99
+ args.push('--es', 'fps', `${fps}`);
100
+ }
101
+ if (bitrate) {
102
+ args.push('--es', 'bitrate', `${bitrate}`);
103
+ }
104
+ if (resolution) {
105
+ args.push('--es', 'resolution', resolution);
106
+ }
107
+ if (audio !== undefined) {
108
+ args.push('--es', 'audio', audio ? 'true' : 'false');
109
+ }
110
+
111
+ await this.adb.shell(args);
112
+ try {
113
+ await waitForCondition(async () => await this.isRunning(), {
114
+ waitMs: STREAM_STARTUP_TIMEOUT_MS,
115
+ intervalMs: 300,
116
+ });
117
+ } catch {
118
+ throw new Error(
119
+ `The video stream is not running after ${STREAM_STARTUP_TIMEOUT_MS}ms. ` +
120
+ `Please check the logcat output for more details.`,
121
+ );
122
+ }
123
+
124
+ this.transport = await StreamTransport.connect(this.adb, socketName, {localPort, localPortRange});
125
+ return true;
126
+ }
127
+
128
+ /**
129
+ * Yields access units (video NAL units and, if enabled, AAC audio units) as
130
+ * they arrive from the device. `start()` must be called before iterating.
131
+ *
132
+ * A CONFIG unit is normally seen only once, at the start of the stream, but a
133
+ * device rotation makes the on-device encoder restart mid-stream: a second (or
134
+ * later) CONFIG unit means the video's dimensions changed and the decoder must be
135
+ * reconfigured with these new SPS/PPS bytes, not treated as an error. `sequence`
136
+ * keeps increasing across such a restart, it is never reset.
137
+ */
138
+ async *accessUnits(): AsyncGenerator<AccessUnit> {
139
+ if (!this.transport) {
140
+ throw new Error('The video stream has not been started. Call start() first.');
141
+ }
142
+ for await (const frame of this.transport.frames()) {
143
+ yield {
144
+ track: frame.track === StreamTrack.Audio ? 'audio' : 'video',
145
+ data: frame.data,
146
+ sequence: Number(frame.sequence),
147
+ timestampMicros: Number(frame.timestampMicros),
148
+ isKeyFrame: frame.isKeyFrame,
149
+ isConfig: frame.isConfig,
150
+ };
151
+ }
152
+ }
153
+
154
+ /**
155
+ * Stops the currently running video stream.
156
+ *
157
+ * @returns True if the stream was stopped successfully, false if it was not running
158
+ * @throws {Error} If the stream fails to stop within the timeout period
159
+ */
160
+ async stop(): Promise<boolean> {
161
+ try {
162
+ if (!(await this.isRunning())) {
163
+ // The on-device service may have already stopped itself (e.g. the client
164
+ // disconnected), leaving a local transport/adb-forward that still needs closing.
165
+ return false;
166
+ }
167
+
168
+ await this.adb.shell(['am', 'start', '-n', STREAMING_ACTIVITY_NAME, '-a', VIDEO_STREAM_ACTION_STOP]);
169
+ try {
170
+ await waitForCondition(async () => !(await this.isRunning()), {
171
+ waitMs: STREAM_STOP_TIMEOUT_MS,
172
+ intervalMs: 300,
173
+ });
174
+ } catch {
175
+ throw new Error(`The attempt to stop the current video stream timed out after ${STREAM_STOP_TIMEOUT_MS}ms`);
176
+ }
177
+ return true;
178
+ } finally {
179
+ if (this.transport) {
180
+ await this.transport.close();
181
+ this.transport = null;
182
+ }
183
+ }
184
+ }
185
+ }
@@ -43,3 +43,13 @@ export const RECORDING_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.recorder.RecorderS
43
43
  export const RECORDING_ACTIVITY_NAME = `${SETTINGS_HELPER_ID}/io.appium.settings.Settings`;
44
44
  export const RECORDING_ACTION_START = `${SETTINGS_HELPER_ID}.recording.ACTION_START`;
45
45
  export const RECORDING_ACTION_STOP = `${SETTINGS_HELPER_ID}.recording.ACTION_STOP`;
46
+
47
+ export const STREAMING_ACTIVITY_NAME = RECORDING_ACTIVITY_NAME;
48
+
49
+ export const JPEG_STREAM_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.streaming.JpegStreamService`;
50
+ export const JPEG_STREAM_ACTION_START = `${SETTINGS_HELPER_ID}.streaming.jpeg.ACTION_START`;
51
+ export const JPEG_STREAM_ACTION_STOP = `${SETTINGS_HELPER_ID}.streaming.jpeg.ACTION_STOP`;
52
+
53
+ export const VIDEO_STREAM_SERVICE_NAME = `${SETTINGS_HELPER_ID}/.streaming.VideoStreamService`;
54
+ export const VIDEO_STREAM_ACTION_START = `${SETTINGS_HELPER_ID}.streaming.video.ACTION_START`;
55
+ export const VIDEO_STREAM_ACTION_STOP = `${SETTINGS_HELPER_ID}.streaming.video.ACTION_STOP`;
@@ -1,4 +1,4 @@
1
- import {getSettingsApkPath} from './utils.js';
1
+ import {getSettingsApkPath} from './utils/index.js';
2
2
 
3
3
  export const path = getSettingsApkPath();
4
4
  export * from './constants.js';
@@ -0,0 +1,4 @@
1
+ export {getSettingsApkPath} from './apk-path.js';
2
+ export {createParserState, parseFrames, StreamTrack} from './streaming-protocol.js';
3
+ export type {FrameParserState, StreamFrame} from './streaming-protocol.js';
4
+ export {BoundedFrameQueue, resolveLocalPort, StreamTransport, validateLocalPortOpts} from './streaming-transport.js';
@@ -0,0 +1,93 @@
1
+ /**
2
+ * Track discriminator for a streamed frame, matching the on-device
3
+ * `io.appium.settings.streaming.Frame.Track` enum ordinals.
4
+ */
5
+ export enum StreamTrack {
6
+ Jpeg = 0,
7
+ Video = 1,
8
+ Audio = 2,
9
+ }
10
+
11
+ const FLAG_CONFIG = 0x01;
12
+ const FLAG_KEYFRAME = 0x02;
13
+ const FLAG_EOS = 0x04;
14
+
15
+ /**
16
+ * A single parsed frame/access-unit read off the streaming socket.
17
+ */
18
+ export interface StreamFrame {
19
+ track: StreamTrack;
20
+ sequence: bigint;
21
+ timestampMicros: bigint;
22
+ data: Buffer;
23
+ isConfig: boolean;
24
+ isKeyFrame: boolean;
25
+ isEndOfStream: boolean;
26
+ }
27
+
28
+ const HEADER_SIZE = 28;
29
+ const MAGIC = Buffer.from('APST', 'ascii');
30
+
31
+ /**
32
+ * Incremental parser state, carried across chunk boundaries.
33
+ */
34
+ export interface FrameParserState {
35
+ buf: Buffer;
36
+ }
37
+
38
+ /**
39
+ * Creates a fresh, empty parser state for use with {@link parseFrames}.
40
+ *
41
+ * @returns A new, empty FrameParserState
42
+ */
43
+ export function createParserState(): FrameParserState {
44
+ return {buf: Buffer.alloc(0)};
45
+ }
46
+
47
+ /**
48
+ * Parses as many complete frames as are available in `state.buf` + `chunk`,
49
+ * carrying over any trailing partial frame in `state` for the next call.
50
+ *
51
+ * Wire format (big-endian, matches `io.appium.settings.streaming.StreamProtocol`):
52
+ * offset 0 (4 bytes): magic "APST"; offset 4 (1 byte): version;
53
+ * offset 5 (1 byte): track; offset 6 (1 byte): flags; offset 7: reserved;
54
+ * offset 8 (8 bytes): sequence; offset 16 (8 bytes): timestampMicros;
55
+ * offset 24 (4 bytes): payloadLength; followed by `payloadLength` payload bytes.
56
+ *
57
+ * @throws {Error} If the stream desynchronizes (unexpected magic bytes)
58
+ */
59
+ export function* parseFrames(state: FrameParserState, chunk: Buffer): Generator<StreamFrame> {
60
+ state.buf = state.buf.length ? Buffer.concat([state.buf, chunk]) : chunk;
61
+ for (;;) {
62
+ if (state.buf.length < HEADER_SIZE) {
63
+ return;
64
+ }
65
+ if (!state.buf.subarray(0, 4).equals(MAGIC)) {
66
+ throw new Error('Stream desynchronized: unexpected magic bytes in the streaming protocol header');
67
+ }
68
+
69
+ const payloadLength = state.buf.readUInt32BE(24);
70
+ const totalLength = HEADER_SIZE + payloadLength;
71
+ if (state.buf.length < totalLength) {
72
+ return;
73
+ }
74
+
75
+ const track = state.buf.readUInt8(5) as StreamTrack;
76
+ const flags = state.buf.readUInt8(6);
77
+ const sequence = state.buf.readBigUInt64BE(8);
78
+ const timestampMicros = state.buf.readBigUInt64BE(16);
79
+ const data = Buffer.from(state.buf.subarray(HEADER_SIZE, totalLength));
80
+
81
+ state.buf = state.buf.subarray(totalLength);
82
+
83
+ yield {
84
+ track,
85
+ sequence,
86
+ timestampMicros,
87
+ data,
88
+ isConfig: (flags & FLAG_CONFIG) !== 0,
89
+ isKeyFrame: (flags & FLAG_KEYFRAME) !== 0,
90
+ isEndOfStream: (flags & FLAG_EOS) !== 0,
91
+ };
92
+ }
93
+ }