appium-espresso-driver 9.3.7 → 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 (195) hide show
  1. package/CHANGELOG.md +6 -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/library/src/main/java/io/appium/espressoserver/lib/helpers/Version.kt +1 -1
  23. package/lib/commands/context.ts +1 -1
  24. package/lib/commands/element.ts +10 -10
  25. package/lib/commands/idling-resources.ts +1 -1
  26. package/lib/commands/misc.ts +5 -4
  27. package/lib/commands/services.ts +2 -2
  28. package/lib/driver.ts +1 -1
  29. package/node_modules/@appium/base-driver/node_modules/asyncbox/LICENSE +203 -0
  30. package/node_modules/@appium/base-driver/node_modules/asyncbox/README.md +215 -0
  31. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/types.d.ts +84 -0
  32. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/types.d.ts.map +1 -0
  33. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/types.js +3 -0
  34. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/lib/types.js.map +1 -0
  35. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/cjs/package.json +3 -0
  36. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/types.d.ts +84 -0
  37. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/types.d.ts.map +1 -0
  38. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/types.js +2 -0
  39. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/lib/types.js.map +1 -0
  40. package/node_modules/@appium/base-driver/node_modules/asyncbox/build/esm/package.json +3 -0
  41. package/node_modules/@appium/base-driver/node_modules/asyncbox/lib/types.ts +88 -0
  42. package/node_modules/@appium/base-driver/node_modules/asyncbox/package.json +74 -0
  43. package/node_modules/@appium/support/node_modules/asyncbox/LICENSE +203 -0
  44. package/node_modules/@appium/support/node_modules/asyncbox/README.md +215 -0
  45. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts +103 -0
  46. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts.map +1 -0
  47. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.js +311 -0
  48. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/asyncbox.js.map +1 -0
  49. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/types.d.ts +84 -0
  50. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/types.d.ts.map +1 -0
  51. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/types.js +3 -0
  52. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/lib/types.js.map +1 -0
  53. package/node_modules/@appium/support/node_modules/asyncbox/build/cjs/package.json +3 -0
  54. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts +103 -0
  55. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts.map +1 -0
  56. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.js +298 -0
  57. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/asyncbox.js.map +1 -0
  58. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/types.d.ts +84 -0
  59. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/types.d.ts.map +1 -0
  60. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/types.js +2 -0
  61. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/lib/types.js.map +1 -0
  62. package/node_modules/@appium/support/node_modules/asyncbox/build/esm/package.json +3 -0
  63. package/node_modules/@appium/support/node_modules/asyncbox/lib/asyncbox.ts +382 -0
  64. package/node_modules/@appium/support/node_modules/asyncbox/lib/types.ts +88 -0
  65. package/node_modules/@appium/support/node_modules/asyncbox/package.json +74 -0
  66. package/node_modules/appium-android-driver/CHANGELOG.md +6 -0
  67. package/node_modules/appium-android-driver/build/lib/commands/context/exports.d.ts.map +1 -1
  68. package/node_modules/appium-android-driver/build/lib/commands/context/exports.js +9 -5
  69. package/node_modules/appium-android-driver/build/lib/commands/context/exports.js.map +1 -1
  70. package/node_modules/appium-android-driver/lib/commands/context/exports.ts +9 -5
  71. package/node_modules/appium-android-driver/package.json +1 -1
  72. package/node_modules/appium-chromedriver/CHANGELOG.md +14 -0
  73. package/node_modules/appium-chromedriver/build/lib/commands/version.d.ts.map +1 -1
  74. package/node_modules/appium-chromedriver/build/lib/commands/version.js +9 -0
  75. package/node_modules/appium-chromedriver/build/lib/commands/version.js.map +1 -1
  76. package/node_modules/appium-chromedriver/config/mapping.json +1 -0
  77. package/node_modules/appium-chromedriver/lib/commands/version.ts +10 -0
  78. package/node_modules/appium-chromedriver/package.json +2 -2
  79. package/node_modules/asyncbox/README.md +43 -0
  80. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts +9 -0
  81. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts.map +1 -0
  82. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js +35 -0
  83. package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js.map +1 -0
  84. package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts +9 -0
  85. package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts.map +1 -0
  86. package/node_modules/asyncbox/build/cjs/lib/asyncmap.js +23 -0
  87. package/node_modules/asyncbox/build/cjs/lib/asyncmap.js.map +1 -0
  88. package/node_modules/asyncbox/build/cjs/lib/errors.d.ts +9 -0
  89. package/node_modules/asyncbox/build/cjs/lib/errors.d.ts.map +1 -0
  90. package/node_modules/asyncbox/build/cjs/lib/errors.js +20 -0
  91. package/node_modules/asyncbox/build/cjs/lib/errors.js.map +1 -0
  92. package/node_modules/asyncbox/build/cjs/lib/index.d.ts +12 -0
  93. package/node_modules/asyncbox/build/cjs/lib/index.d.ts.map +1 -0
  94. package/node_modules/asyncbox/build/cjs/lib/index.js +24 -0
  95. package/node_modules/asyncbox/build/cjs/lib/index.js.map +1 -0
  96. package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts +3 -0
  97. package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts.map +1 -0
  98. package/node_modules/asyncbox/build/cjs/lib/limit-function.js +15 -0
  99. package/node_modules/asyncbox/build/cjs/lib/limit-function.js.map +1 -0
  100. package/node_modules/asyncbox/build/cjs/lib/lock.d.ts +74 -0
  101. package/node_modules/asyncbox/build/cjs/lib/lock.d.ts.map +1 -0
  102. package/node_modules/asyncbox/build/cjs/lib/lock.js +295 -0
  103. package/node_modules/asyncbox/build/cjs/lib/lock.js.map +1 -0
  104. package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts +15 -0
  105. package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts.map +1 -0
  106. package/node_modules/asyncbox/build/cjs/lib/long-sleep.js +36 -0
  107. package/node_modules/asyncbox/build/cjs/lib/long-sleep.js.map +1 -0
  108. package/node_modules/asyncbox/build/cjs/lib/retry.d.ts +17 -0
  109. package/node_modules/asyncbox/build/cjs/lib/retry.d.ts.map +1 -0
  110. package/node_modules/asyncbox/build/cjs/lib/retry.js +57 -0
  111. package/node_modules/asyncbox/build/cjs/lib/retry.js.map +1 -0
  112. package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts +20 -0
  113. package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts.map +1 -0
  114. package/node_modules/asyncbox/build/cjs/lib/sleep.js +61 -0
  115. package/node_modules/asyncbox/build/cjs/lib/sleep.js.map +1 -0
  116. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts +18 -0
  117. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts.map +1 -0
  118. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js +51 -0
  119. package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js.map +1 -0
  120. package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts +16 -0
  121. package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts.map +1 -0
  122. package/node_modules/asyncbox/build/cjs/lib/with-timeout.js +45 -0
  123. package/node_modules/asyncbox/build/cjs/lib/with-timeout.js.map +1 -0
  124. package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts +9 -0
  125. package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts.map +1 -0
  126. package/node_modules/asyncbox/build/esm/lib/asyncfilter.js +32 -0
  127. package/node_modules/asyncbox/build/esm/lib/asyncfilter.js.map +1 -0
  128. package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts +9 -0
  129. package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts.map +1 -0
  130. package/node_modules/asyncbox/build/esm/lib/asyncmap.js +20 -0
  131. package/node_modules/asyncbox/build/esm/lib/asyncmap.js.map +1 -0
  132. package/node_modules/asyncbox/build/esm/lib/errors.d.ts +9 -0
  133. package/node_modules/asyncbox/build/esm/lib/errors.d.ts.map +1 -0
  134. package/node_modules/asyncbox/build/esm/lib/errors.js +15 -0
  135. package/node_modules/asyncbox/build/esm/lib/errors.js.map +1 -0
  136. package/node_modules/asyncbox/build/esm/lib/index.d.ts +12 -0
  137. package/node_modules/asyncbox/build/esm/lib/index.d.ts.map +1 -0
  138. package/node_modules/asyncbox/build/esm/lib/index.js +10 -0
  139. package/node_modules/asyncbox/build/esm/lib/index.js.map +1 -0
  140. package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts +3 -0
  141. package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts.map +1 -0
  142. package/node_modules/asyncbox/build/esm/lib/limit-function.js +12 -0
  143. package/node_modules/asyncbox/build/esm/lib/limit-function.js.map +1 -0
  144. package/node_modules/asyncbox/build/esm/lib/lock.d.ts +74 -0
  145. package/node_modules/asyncbox/build/esm/lib/lock.d.ts.map +1 -0
  146. package/node_modules/asyncbox/build/esm/lib/lock.js +291 -0
  147. package/node_modules/asyncbox/build/esm/lib/lock.js.map +1 -0
  148. package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts +15 -0
  149. package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts.map +1 -0
  150. package/node_modules/asyncbox/build/esm/lib/long-sleep.js +33 -0
  151. package/node_modules/asyncbox/build/esm/lib/long-sleep.js.map +1 -0
  152. package/node_modules/asyncbox/build/esm/lib/retry.d.ts +17 -0
  153. package/node_modules/asyncbox/build/esm/lib/retry.d.ts.map +1 -0
  154. package/node_modules/asyncbox/build/esm/lib/retry.js +53 -0
  155. package/node_modules/asyncbox/build/esm/lib/retry.js.map +1 -0
  156. package/node_modules/asyncbox/build/esm/lib/sleep.d.ts +20 -0
  157. package/node_modules/asyncbox/build/esm/lib/sleep.d.ts.map +1 -0
  158. package/node_modules/asyncbox/build/esm/lib/sleep.js +58 -0
  159. package/node_modules/asyncbox/build/esm/lib/sleep.js.map +1 -0
  160. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts +18 -0
  161. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts.map +1 -0
  162. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js +48 -0
  163. package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js.map +1 -0
  164. package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts +16 -0
  165. package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts.map +1 -0
  166. package/node_modules/asyncbox/build/esm/lib/with-timeout.js +42 -0
  167. package/node_modules/asyncbox/build/esm/lib/with-timeout.js.map +1 -0
  168. package/node_modules/asyncbox/lib/asyncfilter.ts +38 -0
  169. package/node_modules/asyncbox/lib/asyncmap.ts +29 -0
  170. package/node_modules/asyncbox/lib/errors.ts +15 -0
  171. package/node_modules/asyncbox/lib/index.ts +21 -0
  172. package/node_modules/asyncbox/lib/limit-function.ts +18 -0
  173. package/node_modules/asyncbox/lib/lock.ts +360 -0
  174. package/node_modules/asyncbox/lib/long-sleep.ts +38 -0
  175. package/node_modules/asyncbox/lib/retry.ts +61 -0
  176. package/node_modules/asyncbox/lib/sleep.ts +79 -0
  177. package/node_modules/asyncbox/lib/wait-for-condition.ts +52 -0
  178. package/node_modules/asyncbox/lib/with-timeout.ts +43 -0
  179. package/node_modules/asyncbox/package.json +8 -8
  180. package/node_modules/io.appium.settings/CHANGELOG.md +7 -0
  181. package/node_modules/io.appium.settings/apks/settings_apk-debug.apk +0 -0
  182. package/node_modules/io.appium.settings/package.json +2 -2
  183. package/node_modules/on-finished/index.js +14 -2
  184. package/node_modules/on-finished/package.json +11 -7
  185. package/package.json +4 -4
  186. package/node_modules/on-finished/HISTORY.md +0 -98
  187. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/cjs/lib/asyncbox.d.ts +0 -0
  188. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/cjs/lib/asyncbox.d.ts.map +0 -0
  189. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/cjs/lib/asyncbox.js +0 -0
  190. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/cjs/lib/asyncbox.js.map +0 -0
  191. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/esm/lib/asyncbox.d.ts +0 -0
  192. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/esm/lib/asyncbox.d.ts.map +0 -0
  193. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/esm/lib/asyncbox.js +0 -0
  194. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/build/esm/lib/asyncbox.js.map +0 -0
  195. /package/node_modules/{asyncbox → @appium/base-driver/node_modules/asyncbox}/lib/asyncbox.ts +0 -0
@@ -0,0 +1,33 @@
1
+ import { sleep } from './sleep.js';
2
+ const LONG_SLEEP_THRESHOLD = 5000; // anything over 5000ms will turn into a spin
3
+ /**
4
+ * Sometimes `Promise.delay` or `setTimeout` are inaccurate for large wait
5
+ * times. To safely wait for these long times (e.g. in the 5+ minute range), you
6
+ * can use `longSleep`.
7
+ *
8
+ * You can also pass a `progressCb` option which is a callback function that
9
+ * receives an object with the properties `elapsedMs`, `timeLeft`, and
10
+ * `progress`. This will be called on every wait interval so you can do your
11
+ * wait logging or whatever.
12
+ * @param ms - The number of milliseconds to wait
13
+ * @param options - Options for controlling the long sleep behavior
14
+ */
15
+ export async function longSleep(ms, { thresholdMs = LONG_SLEEP_THRESHOLD, intervalMs = 1000, progressCb = null } = {}) {
16
+ if (ms < thresholdMs) {
17
+ return await sleep(ms);
18
+ }
19
+ const endAt = performance.now() + ms;
20
+ let timeLeft;
21
+ let elapsedMs = 0;
22
+ do {
23
+ const pre = performance.now();
24
+ await sleep(intervalMs);
25
+ const post = performance.now();
26
+ timeLeft = endAt - post;
27
+ elapsedMs = elapsedMs + (post - pre);
28
+ if (typeof progressCb === 'function') {
29
+ progressCb({ elapsedMs: Math.round(elapsedMs), timeLeft: Math.round(timeLeft), progress: elapsedMs / ms });
30
+ }
31
+ } while (timeLeft > 0);
32
+ }
33
+ //# sourceMappingURL=long-sleep.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"long-sleep.js","sourceRoot":"","sources":["../../../lib/long-sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAGjC,MAAM,oBAAoB,GAAG,IAAI,CAAC,CAAC,6CAA6C;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAU,EACV,EAAC,WAAW,GAAG,oBAAoB,EAAE,UAAU,GAAG,IAAI,EAAE,UAAU,GAAG,IAAI,KAAsB,EAAE;IAEjG,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;QACrB,OAAO,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACrC,IAAI,QAAgB,CAAC;IACrB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,GAAG,CAAC;QACF,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC/B,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;QACxB,SAAS,GAAG,SAAS,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QACrC,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,UAAU,CAAC,EAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,EAAE,EAAC,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC,QAAQ,QAAQ,GAAG,CAAC,EAAE;AACzB,CAAC"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * An async/await way of running a method until it doesn't throw an error
3
+ * @param times - The maximum number of times to retry the function
4
+ * @param fn - The async function to retry
5
+ * @param args - Arguments to pass to the function
6
+ */
7
+ export declare function retry<T = any>(times: number, fn: (...args: any[]) => Promise<T>, ...args: any[]): Promise<T | null>;
8
+ /**
9
+ * You can also use `retryInterval` to add a sleep in between retries. This can
10
+ * be useful if you want to throttle how fast we retry.
11
+ * @param times - The maximum number of times to retry the function
12
+ * @param sleepMs - The number of milliseconds to wait between retries
13
+ * @param fn - The async function to retry
14
+ * @param args - Arguments to pass to the function
15
+ */
16
+ export declare function retryInterval<T = any>(times: number, sleepMs: number, fn: (...args: any[]) => Promise<T>, ...args: any[]): Promise<T | null>;
17
+ //# sourceMappingURL=retry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../lib/retry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,CAAC,GAAG,GAAG,EACjC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAgBnB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,GAAG,EACzC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAiBnB"}
@@ -0,0 +1,53 @@
1
+ import { sleep } from './sleep.js';
2
+ /**
3
+ * An async/await way of running a method until it doesn't throw an error
4
+ * @param times - The maximum number of times to retry the function
5
+ * @param fn - The async function to retry
6
+ * @param args - Arguments to pass to the function
7
+ */
8
+ export async function retry(times, fn, ...args) {
9
+ let tries = 0;
10
+ let done = false;
11
+ let res = null;
12
+ while (!done && tries < times) {
13
+ tries++;
14
+ try {
15
+ res = await fn(...args);
16
+ done = true;
17
+ }
18
+ catch (err) {
19
+ if (tries >= times) {
20
+ throw err;
21
+ }
22
+ }
23
+ }
24
+ return res;
25
+ }
26
+ /**
27
+ * You can also use `retryInterval` to add a sleep in between retries. This can
28
+ * be useful if you want to throttle how fast we retry.
29
+ * @param times - The maximum number of times to retry the function
30
+ * @param sleepMs - The number of milliseconds to wait between retries
31
+ * @param fn - The async function to retry
32
+ * @param args - Arguments to pass to the function
33
+ */
34
+ export async function retryInterval(times, sleepMs, fn, ...args) {
35
+ let count = 0;
36
+ const wrapped = async () => {
37
+ count++;
38
+ let res;
39
+ try {
40
+ res = await fn(...args);
41
+ }
42
+ catch (e) {
43
+ // do not pause when finished the last retry
44
+ if (count !== times) {
45
+ await sleep(sleepMs);
46
+ }
47
+ throw e;
48
+ }
49
+ return res;
50
+ };
51
+ return await retry(times, wrapped);
52
+ }
53
+ //# sourceMappingURL=retry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../lib/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,KAAa,EACb,EAAkC,EAClC,GAAG,IAAW;IAEd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,GAAG,GAAa,IAAI,CAAC;IACzB,OAAO,CAAC,IAAI,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACxB,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;gBACnB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAAe,EACf,EAAkC,EAClC,GAAG,IAAW;IAEd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,KAAK,IAAgB,EAAE;QACrC,KAAK,EAAE,CAAC;QACR,IAAI,GAAM,CAAC;QACX,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,4CAA4C;YAC5C,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBACpB,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,OAAO,MAAM,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { CancellablePromise, SleepOptions } from './types.js';
2
+ /**
3
+ * An async/await version of `setTimeout`. The returned promise has a `cancel()` method that clears
4
+ * the timer and usually rejects with {@link PromiseCancellationError} unless you use the object form with
5
+ * `cancelError: null` to resolve on cancel.
6
+ *
7
+ * @param ms - Milliseconds to wait
8
+ * @returns A thenable you can `await`; call `.cancel()` to abort early.
9
+ */
10
+ export declare function sleep(ms: number): CancellablePromise<void>;
11
+ /**
12
+ * Object form: `ms` plus optional `cancelError` (non-empty string or `Error`, `null` to resolve on
13
+ * cancel, or omitted / `undefined` / `''` for default {@link PromiseCancellationError}). Any non-array
14
+ * object with a finite `ms` is accepted at runtime (including class instances), matching structural typing.
15
+ *
16
+ * @param options - Duration and optional cancellation behavior
17
+ * @returns A thenable you can `await`; call `.cancel()` to abort early.
18
+ */
19
+ export declare function sleep(options: SleepOptions): CancellablePromise<void>;
20
+ //# sourceMappingURL=sleep.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../lib/sleep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,kBAAkB,EAAY,YAAY,EAAC,MAAM,YAAY,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC5D;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,58 @@
1
+ import { PromiseCancellationError } from './errors.js';
2
+ export function sleep(arg) {
3
+ const { ms, cancelError } = parseSleepArg(arg);
4
+ let timeoutId;
5
+ let resolveFn;
6
+ let rejectFn;
7
+ const promise = new Promise((resolve, reject) => {
8
+ resolveFn = resolve;
9
+ rejectFn = reject;
10
+ timeoutId = setTimeout(resolve, ms);
11
+ });
12
+ promise.cancel = () => {
13
+ if (timeoutId) {
14
+ clearTimeout(timeoutId);
15
+ timeoutId = undefined;
16
+ }
17
+ if (cancelError === null) {
18
+ resolveFn?.(undefined);
19
+ }
20
+ else {
21
+ let err;
22
+ if (typeof cancelError === 'string' && cancelError) {
23
+ err = new PromiseCancellationError(cancelError);
24
+ }
25
+ else if (cancelError instanceof Error) {
26
+ err = cancelError;
27
+ }
28
+ else {
29
+ err = new PromiseCancellationError();
30
+ }
31
+ rejectFn?.(err);
32
+ }
33
+ resolveFn = undefined;
34
+ rejectFn = undefined;
35
+ };
36
+ return promise;
37
+ }
38
+ /** Non-array object values (including class instances); excludes `null` and arrays. */
39
+ function isSleepArgObject(value) {
40
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
41
+ }
42
+ function parseSleepArg(arg) {
43
+ if (typeof arg === 'number') {
44
+ if (!Number.isFinite(arg)) {
45
+ throw new TypeError('sleep: expected a finite number or an object with ms');
46
+ }
47
+ return { ms: arg };
48
+ }
49
+ if (isSleepArgObject(arg)) {
50
+ const ms = arg.ms;
51
+ if (typeof ms !== 'number' || !Number.isFinite(ms)) {
52
+ throw new TypeError('sleep: options.ms must be a finite number');
53
+ }
54
+ return { ms, cancelError: arg.cancelError };
55
+ }
56
+ throw new TypeError('sleep: expected a finite number or an object with ms');
57
+ }
58
+ //# sourceMappingURL=sleep.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../lib/sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,wBAAwB,EAAC,MAAM,aAAa,CAAC;AAqBrD,MAAM,UAAU,KAAK,CAAC,GAAa;IACjC,MAAM,EAAC,EAAE,EAAE,WAAW,EAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,SAAqC,CAAC;IAC1C,IAAI,SAA8C,CAAC;IACnD,IAAI,QAA8C,CAAC;IAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpD,SAAS,GAAG,OAAO,CAAC;QACpB,QAAQ,GAAG,MAAM,CAAC;QAClB,SAAS,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC,CAA6B,CAAC;IAE/B,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE;QACpB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,GAAU,CAAC;YACf,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;gBACnD,GAAG,GAAG,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,WAAW,YAAY,KAAK,EAAE,CAAC;gBACxC,GAAG,GAAG,WAAW,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,GAAG,GAAG,IAAI,wBAAwB,EAAE,CAAC;YACvC,CAAC;YACD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,SAAS,GAAG,SAAS,CAAC;QACtB,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uFAAuF;AACvF,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,GAAa;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,EAAC,EAAE,EAAE,GAAG,EAAC,CAAC;IACnB,CAAC;IACD,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,EAAC,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAgD,EAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;AAC9E,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { WaitForConditionOptions } from './types.js';
2
+ /**
3
+ * Takes a condition (a function returning a boolean or boolean promise), and
4
+ * waits until the condition is true.
5
+ *
6
+ * Throws a `/Condition unmet/` error if the condition has not been satisfied
7
+ * within the allocated time, unless an error is provided in the options, as the
8
+ * `error` property, which is either thrown itself, or used as the message.
9
+ *
10
+ * The condition result is returned if it is not falsy. If the condition throws an
11
+ * error then this exception will be immediately passed through.
12
+ *
13
+ * The default options are: `{ waitMs: 5000, intervalMs: 500 }`
14
+ * @param condFn - The condition function to evaluate
15
+ * @param options - Options for controlling the wait behavior
16
+ */
17
+ export declare function waitForCondition<T>(condFn: () => Promise<T> | T, options?: WaitForConditionOptions): Promise<T>;
18
+ //# sourceMappingURL=wait-for-condition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait-for-condition.d.ts","sourceRoot":"","sources":["../../../lib/wait-for-condition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,CAAC,CAAC,CA8BZ"}
@@ -0,0 +1,48 @@
1
+ import { sleep } from './sleep.js';
2
+ /**
3
+ * Takes a condition (a function returning a boolean or boolean promise), and
4
+ * waits until the condition is true.
5
+ *
6
+ * Throws a `/Condition unmet/` error if the condition has not been satisfied
7
+ * within the allocated time, unless an error is provided in the options, as the
8
+ * `error` property, which is either thrown itself, or used as the message.
9
+ *
10
+ * The condition result is returned if it is not falsy. If the condition throws an
11
+ * error then this exception will be immediately passed through.
12
+ *
13
+ * The default options are: `{ waitMs: 5000, intervalMs: 500 }`
14
+ * @param condFn - The condition function to evaluate
15
+ * @param options - Options for controlling the wait behavior
16
+ */
17
+ export async function waitForCondition(condFn, options = {}) {
18
+ const opts = {
19
+ ...options,
20
+ waitMs: typeof options.waitMs === 'number' ? options.waitMs : 5000,
21
+ intervalMs: typeof options.intervalMs === 'number' ? options.intervalMs : 500,
22
+ };
23
+ const debug = opts.logger ? opts.logger.debug.bind(opts.logger) : () => undefined;
24
+ const error = opts.error;
25
+ const begunAt = performance.now();
26
+ const endAt = begunAt + opts.waitMs;
27
+ const spin = async function spin() {
28
+ const result = await condFn();
29
+ if (result) {
30
+ return result;
31
+ }
32
+ const now = performance.now();
33
+ const waited = Math.round(now - begunAt);
34
+ const remainingTime = endAt - now;
35
+ if (now < endAt) {
36
+ debug(`Waited for ${waited} ms so far`);
37
+ await sleep(Math.min(opts.intervalMs, remainingTime));
38
+ return await spin();
39
+ }
40
+ // if there is an error option, it is either a string message or an error itself
41
+ if (error) {
42
+ throw typeof error === 'string' ? new Error(error) : error;
43
+ }
44
+ throw new Error(`Condition unmet after ${waited} ms. Timing out.`);
45
+ };
46
+ return await spin();
47
+ }
48
+ //# sourceMappingURL=wait-for-condition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait-for-condition.js","sourceRoot":"","sources":["../../../lib/wait-for-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAGjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA4B,EAC5B,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAmE;QAC3E,GAAG,OAAO;QACV,MAAM,EAAE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAClE,UAAU,EAAE,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;KAC9E,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,UAAU,IAAI;QAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,KAAK,GAAG,GAAG,CAAC;QAClC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,cAAc,MAAM,YAAY,CAAC,CAAC;YACxC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;YACtD,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,gFAAgF;QAChF,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,kBAAkB,CAAC,CAAC;IACrE,CAAC,CAAC;IACF,OAAO,MAAM,IAAI,EAAE,CAAC;AACtB,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Resolves with `promise` or rejects if it does not settle before `timeoutMs`.
3
+ *
4
+ * If the deadline passes first: with no third argument (or a falsy non-error value), rejects
5
+ * with {@link TimeoutError} whose message includes `timeoutMs`; with a non-empty string,
6
+ * rejects with {@link TimeoutError} using that message; with an `Error` instance, rejects
7
+ * with that same instance.
8
+ *
9
+ * @param promise - Promise to race against the timeout.
10
+ * @param timeoutMs - Maximum time in milliseconds before rejecting if `promise` has not settled.
11
+ * @param messageOrError - Optional override for the timeout rejection: custom {@link TimeoutError}
12
+ * message when the string is non-empty, or an existing `Error` to reject with verbatim.
13
+ * Omitted, `undefined`, or other falsy non-error values use the default timeout message (includes `timeoutMs`).
14
+ */
15
+ export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, messageOrError?: string | Error): Promise<T>;
16
+ //# sourceMappingURL=with-timeout.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-timeout.d.ts","sourceRoot":"","sources":["../../../lib/with-timeout.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAC9B,OAAO,CAAC,CAAC,CAAC,CAsBZ"}
@@ -0,0 +1,42 @@
1
+ import { TimeoutError } from './errors.js';
2
+ /**
3
+ * Resolves with `promise` or rejects if it does not settle before `timeoutMs`.
4
+ *
5
+ * If the deadline passes first: with no third argument (or a falsy non-error value), rejects
6
+ * with {@link TimeoutError} whose message includes `timeoutMs`; with a non-empty string,
7
+ * rejects with {@link TimeoutError} using that message; with an `Error` instance, rejects
8
+ * with that same instance.
9
+ *
10
+ * @param promise - Promise to race against the timeout.
11
+ * @param timeoutMs - Maximum time in milliseconds before rejecting if `promise` has not settled.
12
+ * @param messageOrError - Optional override for the timeout rejection: custom {@link TimeoutError}
13
+ * message when the string is non-empty, or an existing `Error` to reject with verbatim.
14
+ * Omitted, `undefined`, or other falsy non-error values use the default timeout message (includes `timeoutMs`).
15
+ */
16
+ export async function withTimeout(promise, timeoutMs, messageOrError) {
17
+ let timer = null;
18
+ try {
19
+ return await Promise.race([
20
+ promise,
21
+ new Promise((_resolve, reject) => {
22
+ timer = setTimeout(() => {
23
+ if (typeof messageOrError === 'string' && messageOrError) {
24
+ reject(new TimeoutError(messageOrError));
25
+ }
26
+ else if (!messageOrError) {
27
+ reject(new TimeoutError(`Operation timed out after ${timeoutMs}ms`));
28
+ }
29
+ else {
30
+ reject(messageOrError);
31
+ }
32
+ }, timeoutMs);
33
+ }),
34
+ ]);
35
+ }
36
+ finally {
37
+ if (timer) {
38
+ clearTimeout(timer);
39
+ }
40
+ }
41
+ }
42
+ //# sourceMappingURL=with-timeout.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-timeout.js","sourceRoot":"","sources":["../../../lib/with-timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAiB,EACjB,cAA+B;IAE/B,IAAI,KAAK,GAA0B,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAClC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,EAAE,CAAC;wBACzD,MAAM,CAAC,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;oBAC3C,CAAC;yBAAM,IAAI,CAAC,cAAc,EAAE,CAAC;wBAC3B,MAAM,CAAC,IAAI,YAAY,CAAC,6BAA6B,SAAS,IAAI,CAAC,CAAC,CAAC;oBACvE,CAAC;yBAAM,CAAC;wBACN,MAAM,CAAC,cAAc,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}
@@ -0,0 +1,38 @@
1
+ import {getLimitFunction} from './limit-function.js';
2
+ import type {MapFilterOptions} from './types.js';
3
+
4
+ /**
5
+ * Similar to `Array.prototype.filter`; runs in parallel, serial, or with custom concurrency pool
6
+ * @param coll - The collection to filter
7
+ * @param filter - The function to test each element
8
+ * @param options - Options for controlling parallelism (default: true - fully parallel)
9
+ */
10
+ export async function asyncfilter<T>(
11
+ coll: T[],
12
+ filter: (value: T) => boolean | Promise<boolean>,
13
+ options: MapFilterOptions = true,
14
+ ): Promise<T[]> {
15
+ if (options === null) {
16
+ throw new Error('Options cannot be null');
17
+ }
18
+ // limitFunction requires the filter to always return a promise
19
+ const filterAsync = async (value: T): Promise<boolean> => filter(value);
20
+ if (options === false) {
21
+ return coll.reduce<Promise<T[]>>(async (accP, item) => {
22
+ const acc = await accP;
23
+ if (await filterAsync(item)) {
24
+ acc.push(item);
25
+ }
26
+ return acc;
27
+ }, Promise.resolve([]));
28
+ }
29
+ const adjustedFilter =
30
+ options === true ? filterAsync : (await getLimitFunction())(filterAsync, {concurrency: options.concurrency});
31
+ const bools = await Promise.all(coll.map(adjustedFilter));
32
+ return coll.reduce<T[]>((acc, item, i) => {
33
+ if (bools[i]) {
34
+ acc.push(item);
35
+ }
36
+ return acc;
37
+ }, []);
38
+ }
@@ -0,0 +1,29 @@
1
+ import {getLimitFunction} from './limit-function.js';
2
+ import type {MapFilterOptions} from './types.js';
3
+
4
+ /**
5
+ * Similar to `Array.prototype.map`; runs in parallel, serial, or with custom concurrency pool
6
+ * @param coll - The collection to map over
7
+ * @param mapper - The function to apply to each element
8
+ * @param options - Options for controlling parallelism (default: true - fully parallel)
9
+ */
10
+ export async function asyncmap<T, R>(
11
+ coll: T[],
12
+ mapper: (value: T) => R | Promise<R>,
13
+ options: MapFilterOptions = true,
14
+ ): Promise<R[]> {
15
+ if (options === null) {
16
+ throw new Error('Options cannot be null');
17
+ }
18
+ // limitFunction requires the mapper to always return a promise
19
+ const mapperAsync = async (value: T): Promise<R> => mapper(value);
20
+ if (options === false) {
21
+ return coll.reduce<Promise<R[]>>(
22
+ async (acc, item) => [...(await acc), await mapperAsync(item)],
23
+ Promise.resolve([]),
24
+ );
25
+ }
26
+ const adjustedMapper =
27
+ options === true ? mapperAsync : (await getLimitFunction())(mapperAsync, {concurrency: options.concurrency});
28
+ return Promise.all(coll.map(adjustedMapper));
29
+ }
@@ -0,0 +1,15 @@
1
+ /** Error thrown by {@link withTimeout} when the deadline is exceeded. */
2
+ export class TimeoutError extends Error {
3
+ constructor(message?: string) {
4
+ super(message ?? 'Operation timed out');
5
+ this.name = 'TimeoutError';
6
+ }
7
+ }
8
+
9
+ /** Thrown when a promise is cancelled via `cancel`. */
10
+ export class PromiseCancellationError extends Error {
11
+ constructor(message: string = 'Promise cancelled') {
12
+ super(message);
13
+ this.name = 'PromiseCancellationError';
14
+ }
15
+ }
@@ -0,0 +1,21 @@
1
+ export {TimeoutError, PromiseCancellationError} from './errors.js';
2
+ export {sleep} from './sleep.js';
3
+ export {withTimeout} from './with-timeout.js';
4
+ export {longSleep} from './long-sleep.js';
5
+ export {retry, retryInterval} from './retry.js';
6
+ export {asyncmap} from './asyncmap.js';
7
+ export {asyncfilter} from './asyncfilter.js';
8
+ export {waitForCondition} from './wait-for-condition.js';
9
+ export {AsyncLock} from './lock.js';
10
+
11
+ export type {AsyncLockOptions, AcquireOptions} from './lock.js';
12
+ export type {
13
+ CancellablePromise,
14
+ Progress,
15
+ ProgressCallback,
16
+ LongSleepOptions,
17
+ MapFilterOptions,
18
+ SleepArg,
19
+ SleepOptions,
20
+ WaitForConditionOptions,
21
+ } from './types.js';
@@ -0,0 +1,18 @@
1
+ import type {limitFunction} from 'p-limit';
2
+
3
+ type PLimitModule = {limitFunction: typeof limitFunction};
4
+
5
+ // p-limit is ESM-only. tsc downlevels a plain `import()` in CommonJS output into a
6
+ // require()-in-a-microtask, which still hits Node's require(esm) interop and can race with a
7
+ // concurrent dynamic import() of the same module elsewhere in the process
8
+ // (ERR_REQUIRE_ESM_RACE_CONDITION). Route through `new Function` so tsc can't see or rewrite the
9
+ // import() call, keeping it a genuine native dynamic import in both the ESM and CJS builds.
10
+ const dynamicImport = new Function('specifier', 'return import(specifier)') as (
11
+ specifier: string,
12
+ ) => Promise<PLimitModule>;
13
+
14
+ let limitFunctionPromise: Promise<PLimitModule> | undefined;
15
+ export async function getLimitFunction() {
16
+ limitFunctionPromise ??= dynamicImport('p-limit');
17
+ return (await limitFunctionPromise).limitFunction;
18
+ }