appium-espresso-driver 9.3.7 → 9.3.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/build/lib/commands/context.d.ts +1 -1
- package/build/lib/commands/context.js +1 -1
- package/build/lib/commands/element.d.ts +10 -10
- package/build/lib/commands/element.js +10 -10
- package/build/lib/commands/idling-resources.d.ts +1 -1
- package/build/lib/commands/idling-resources.js +1 -1
- package/build/lib/commands/misc.d.ts +5 -4
- package/build/lib/commands/misc.d.ts.map +1 -1
- package/build/lib/commands/misc.js +3 -3
- package/build/lib/commands/misc.js.map +1 -1
- package/build/lib/commands/server/runner.d.ts.map +1 -1
- package/build/lib/commands/server/runner.js +3 -1
- package/build/lib/commands/server/runner.js.map +1 -1
- package/build/lib/commands/services.d.ts +2 -2
- package/build/lib/commands/services.js +2 -2
- package/build/lib/driver.js +1 -1
- package/build/lib/driver.js.map +1 -1
- package/espresso-server/app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk +0 -0
- package/espresso-server/buildSrc/.gradle/9.7.1/executionHistory/executionHistory.bin +0 -0
- package/espresso-server/buildSrc/.gradle/9.7.1/executionHistory/executionHistory.lock +0 -0
- package/espresso-server/buildSrc/.gradle/buildOutputCleanup/buildOutputCleanup.lock +0 -0
- package/espresso-server/buildSrc/.gradle/buildOutputCleanup/cache.properties +1 -1
- package/espresso-server/buildSrc/build/kotlin/compileKotlin/cacheable/last-build.bin +0 -0
- package/espresso-server/library/src/main/java/io/appium/espressoserver/lib/helpers/Version.kt +1 -1
- package/lib/commands/context.ts +1 -1
- package/lib/commands/element.ts +10 -10
- package/lib/commands/idling-resources.ts +1 -1
- package/lib/commands/misc.ts +5 -4
- package/lib/commands/server/runner.ts +3 -1
- package/lib/commands/services.ts +2 -2
- package/lib/driver.ts +1 -1
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.d.ts +12 -0
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.d.ts.map +1 -0
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.js +33 -0
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.js.map +1 -0
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi.d.ts.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi.js +49 -12
- package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi.js.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/basedriver/driver.d.ts.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/basedriver/driver.js +2 -0
- package/node_modules/@appium/base-driver/build/lib/basedriver/driver.js.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/express/middleware.d.ts +17 -6
- package/node_modules/@appium/base-driver/build/lib/express/middleware.d.ts.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/express/middleware.js +11 -7
- package/node_modules/@appium/base-driver/build/lib/express/middleware.js.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/express/server.d.ts +1 -0
- package/node_modules/@appium/base-driver/build/lib/express/server.d.ts.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/express/server.js +4 -3
- package/node_modules/@appium/base-driver/build/lib/express/server.js.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/protocol/bidi-commands.d.ts +1 -2
- package/node_modules/@appium/base-driver/build/lib/protocol/bidi-commands.d.ts.map +1 -1
- package/node_modules/@appium/base-driver/build/lib/protocol/bidi-commands.js +8 -3
- package/node_modules/@appium/base-driver/build/lib/protocol/bidi-commands.js.map +1 -1
- package/node_modules/@appium/base-driver/lib/basedriver/commands/bidi-subscriptions.ts +36 -0
- package/node_modules/@appium/base-driver/lib/basedriver/commands/bidi.ts +56 -12
- package/node_modules/@appium/base-driver/lib/basedriver/driver.ts +2 -0
- package/node_modules/@appium/base-driver/lib/express/middleware.ts +32 -12
- package/node_modules/@appium/base-driver/lib/express/server.ts +7 -2
- package/node_modules/@appium/base-driver/lib/protocol/bidi-commands.ts +9 -3
- package/node_modules/@appium/base-driver/node_modules/axios/CHANGELOG.md +1934 -0
- package/node_modules/@appium/base-driver/node_modules/axios/LICENSE +7 -0
- package/node_modules/@appium/base-driver/node_modules/axios/MIGRATION_GUIDE.md +877 -0
- package/node_modules/@appium/base-driver/node_modules/axios/README.md +2851 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.js +5807 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.min.js +5 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/axios.min.js.map +1 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/browser/axios.cjs +5829 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.js +5850 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.min.js +3 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/esm/axios.min.js.map +1 -0
- package/node_modules/@appium/base-driver/node_modules/axios/dist/node/axios.cjs +6808 -0
- package/node_modules/@appium/base-driver/node_modules/axios/index.d.cts +766 -0
- package/node_modules/@appium/base-driver/node_modules/axios/index.d.ts +787 -0
- package/node_modules/@appium/base-driver/node_modules/axios/index.js +45 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/README.md +36 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/adapters.js +132 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/fetch.js +696 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/http.js +1490 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/adapters/xhr.js +277 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/axios.js +89 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/CancelToken.js +135 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/CanceledError.js +22 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/cancel/isCancel.js +5 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/Axios.js +306 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/AxiosError.js +219 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/AxiosHeaders.js +474 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/InterceptorManager.js +171 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/README.md +8 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/buildFullPath.js +76 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/dispatchRequest.js +95 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/mergeConfig.js +174 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/methodList.js +17 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/setFormDataHeaders.js +27 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/settle.js +27 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/core/transformData.js +28 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/defaults/index.js +178 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/defaults/transitional.js +10 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/env/README.md +3 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/env/classes/FormData.js +2 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/env/data.js +1 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/AxiosTransformStream.js +156 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +59 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/Http2Sessions.js +121 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/HttpStatusCode.js +88 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/README.md +7 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +29 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/bind.js +14 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/buildURL.js +69 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/callbackify.js +18 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/combineURLs.js +23 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/composeSignals.js +68 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/cookies.js +64 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/deprecatedMethod.js +31 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/estimateDataURLDecodedBytes.js +166 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/formDataToJSON.js +125 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/formDataToStream.js +119 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/fromDataURI.js +69 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isAbsoluteURL.js +19 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isAxiosError.js +14 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/isURLSameOrigin.js +16 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/normalizeURLForProtocolCheck.js +24 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/null.js +2 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/parseHeaders.js +71 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/parseProtocol.js +6 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/progressEventReducer.js +54 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/readBlob.js +15 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/resolveConfig.js +107 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/sanitizeHeaderValue.js +60 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/shouldBypassProxy.js +505 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/speedometer.js +55 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/spread.js +28 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/throttle.js +45 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/toFormData.js +279 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/toURLEncodedForm.js +19 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/trackStream.js +89 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/helpers/validator.js +112 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/Blob.js +3 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/FormData.js +3 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +4 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/browser/index.js +13 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/common/utils.js +52 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/index.js +7 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/Buffer.js +11 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/FormData.js +3 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +4 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/platform/node/index.js +37 -0
- package/node_modules/@appium/base-driver/node_modules/axios/lib/utils.js +1150 -0
- package/node_modules/@appium/base-driver/node_modules/axios/package.json +203 -0
- package/node_modules/@appium/base-driver/package.json +6 -6
- package/node_modules/@appium/support/build/lib/npm.d.ts.map +1 -1
- package/node_modules/@appium/support/build/lib/npm.js +2 -1
- package/node_modules/@appium/support/build/lib/npm.js.map +1 -1
- package/node_modules/@appium/support/build/lib/util.d.ts.map +1 -1
- package/node_modules/@appium/support/build/lib/util.js +13 -1
- package/node_modules/@appium/support/build/lib/util.js.map +1 -1
- package/node_modules/@appium/support/build/lib/zip.d.ts +2 -1
- package/node_modules/@appium/support/build/lib/zip.d.ts.map +1 -1
- package/node_modules/@appium/support/build/lib/zip.js +193 -64
- package/node_modules/@appium/support/build/lib/zip.js.map +1 -1
- package/node_modules/@appium/support/lib/npm.ts +2 -1
- package/node_modules/@appium/support/lib/util.ts +13 -1
- package/node_modules/@appium/support/lib/zip.ts +231 -71
- package/node_modules/@appium/support/node_modules/axios/CHANGELOG.md +1934 -0
- package/node_modules/@appium/support/node_modules/axios/LICENSE +7 -0
- package/node_modules/@appium/support/node_modules/axios/MIGRATION_GUIDE.md +877 -0
- package/node_modules/@appium/support/node_modules/axios/README.md +2851 -0
- package/node_modules/@appium/support/node_modules/axios/dist/axios.js +5807 -0
- package/node_modules/@appium/support/node_modules/axios/dist/axios.min.js +5 -0
- package/node_modules/@appium/support/node_modules/axios/dist/axios.min.js.map +1 -0
- package/node_modules/@appium/support/node_modules/axios/dist/browser/axios.cjs +5829 -0
- package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.js +5850 -0
- package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.min.js +3 -0
- package/node_modules/@appium/support/node_modules/axios/dist/esm/axios.min.js.map +1 -0
- package/node_modules/@appium/support/node_modules/axios/dist/node/axios.cjs +6808 -0
- package/node_modules/@appium/support/node_modules/axios/index.d.cts +766 -0
- package/node_modules/@appium/support/node_modules/axios/index.d.ts +787 -0
- package/node_modules/@appium/support/node_modules/axios/index.js +45 -0
- package/node_modules/@appium/support/node_modules/axios/lib/adapters/README.md +36 -0
- package/node_modules/@appium/support/node_modules/axios/lib/adapters/adapters.js +132 -0
- package/node_modules/@appium/support/node_modules/axios/lib/adapters/fetch.js +696 -0
- package/node_modules/@appium/support/node_modules/axios/lib/adapters/http.js +1490 -0
- package/node_modules/@appium/support/node_modules/axios/lib/adapters/xhr.js +277 -0
- package/node_modules/@appium/support/node_modules/axios/lib/axios.js +89 -0
- package/node_modules/@appium/support/node_modules/axios/lib/cancel/CancelToken.js +135 -0
- package/node_modules/@appium/support/node_modules/axios/lib/cancel/CanceledError.js +22 -0
- package/node_modules/@appium/support/node_modules/axios/lib/cancel/isCancel.js +5 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/Axios.js +306 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/AxiosError.js +219 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/AxiosHeaders.js +474 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/InterceptorManager.js +171 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/README.md +8 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/buildFullPath.js +76 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/dispatchRequest.js +95 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/mergeConfig.js +174 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/methodList.js +17 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/setFormDataHeaders.js +27 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/settle.js +27 -0
- package/node_modules/@appium/support/node_modules/axios/lib/core/transformData.js +28 -0
- package/node_modules/@appium/support/node_modules/axios/lib/defaults/index.js +178 -0
- package/node_modules/@appium/support/node_modules/axios/lib/defaults/transitional.js +10 -0
- package/node_modules/@appium/support/node_modules/axios/lib/env/README.md +3 -0
- package/node_modules/@appium/support/node_modules/axios/lib/env/classes/FormData.js +2 -0
- package/node_modules/@appium/support/node_modules/axios/lib/env/data.js +1 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/AxiosTransformStream.js +156 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +59 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/Http2Sessions.js +121 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/HttpStatusCode.js +88 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/README.md +7 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +29 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/bind.js +14 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/buildURL.js +69 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/callbackify.js +18 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/combineURLs.js +23 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/composeSignals.js +68 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/cookies.js +64 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/deprecatedMethod.js +31 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/estimateDataURLDecodedBytes.js +166 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/formDataToJSON.js +125 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/formDataToStream.js +119 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/fromDataURI.js +69 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/isAbsoluteURL.js +19 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/isAxiosError.js +14 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/isURLSameOrigin.js +16 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/normalizeURLForProtocolCheck.js +24 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/null.js +2 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/parseHeaders.js +71 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/parseProtocol.js +6 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/progressEventReducer.js +54 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/readBlob.js +15 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/resolveConfig.js +107 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/sanitizeHeaderValue.js +60 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/shouldBypassProxy.js +505 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/speedometer.js +55 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/spread.js +28 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/throttle.js +45 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/toFormData.js +279 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/toURLEncodedForm.js +19 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/trackStream.js +89 -0
- package/node_modules/@appium/support/node_modules/axios/lib/helpers/validator.js +112 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/Blob.js +3 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/FormData.js +3 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +4 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/browser/index.js +13 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/common/utils.js +52 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/index.js +7 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/Buffer.js +11 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/FormData.js +3 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +4 -0
- package/node_modules/@appium/support/node_modules/axios/lib/platform/node/index.js +37 -0
- package/node_modules/@appium/support/node_modules/axios/lib/utils.js +1150 -0
- package/node_modules/@appium/support/node_modules/axios/package.json +203 -0
- package/node_modules/@appium/support/package.json +6 -6
- package/node_modules/@appium/types/build/lib/commands/basedriver.d.ts +6 -4
- package/node_modules/@appium/types/build/lib/commands/basedriver.d.ts.map +1 -1
- package/node_modules/@appium/types/lib/commands/basedriver.ts +4 -4
- package/node_modules/@appium/types/package.json +2 -2
- package/node_modules/appium-android-driver/CHANGELOG.md +6 -0
- package/node_modules/appium-android-driver/build/lib/commands/context/exports.d.ts.map +1 -1
- package/node_modules/appium-android-driver/build/lib/commands/context/exports.js +9 -5
- package/node_modules/appium-android-driver/build/lib/commands/context/exports.js.map +1 -1
- package/node_modules/appium-android-driver/lib/commands/context/exports.ts +9 -5
- package/node_modules/appium-android-driver/package.json +1 -1
- package/node_modules/appium-chromedriver/CHANGELOG.md +14 -0
- package/node_modules/appium-chromedriver/build/lib/commands/version.d.ts.map +1 -1
- package/node_modules/appium-chromedriver/build/lib/commands/version.js +9 -0
- package/node_modules/appium-chromedriver/build/lib/commands/version.js.map +1 -1
- package/node_modules/appium-chromedriver/config/mapping.json +1 -0
- package/node_modules/appium-chromedriver/lib/commands/version.ts +10 -0
- package/node_modules/appium-chromedriver/package.json +2 -2
- package/node_modules/asyncbox/README.md +43 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts +9 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncfilter.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js +35 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncfilter.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts +9 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncmap.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncmap.js +23 -0
- package/node_modules/asyncbox/build/cjs/lib/asyncmap.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/errors.d.ts +9 -0
- package/node_modules/asyncbox/build/cjs/lib/errors.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/errors.js +20 -0
- package/node_modules/asyncbox/build/cjs/lib/errors.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/index.d.ts +12 -0
- package/node_modules/asyncbox/build/cjs/lib/index.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/index.js +24 -0
- package/node_modules/asyncbox/build/cjs/lib/index.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts +3 -0
- package/node_modules/asyncbox/build/cjs/lib/limit-function.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/limit-function.js +15 -0
- package/node_modules/asyncbox/build/cjs/lib/limit-function.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/lock.d.ts +74 -0
- package/node_modules/asyncbox/build/cjs/lib/lock.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/lock.js +295 -0
- package/node_modules/asyncbox/build/cjs/lib/lock.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts +15 -0
- package/node_modules/asyncbox/build/cjs/lib/long-sleep.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/long-sleep.js +36 -0
- package/node_modules/asyncbox/build/cjs/lib/long-sleep.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/retry.d.ts +17 -0
- package/node_modules/asyncbox/build/cjs/lib/retry.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/retry.js +57 -0
- package/node_modules/asyncbox/build/cjs/lib/retry.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts +20 -0
- package/node_modules/asyncbox/build/cjs/lib/sleep.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/sleep.js +61 -0
- package/node_modules/asyncbox/build/cjs/lib/sleep.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts +18 -0
- package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js +51 -0
- package/node_modules/asyncbox/build/cjs/lib/wait-for-condition.js.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts +16 -0
- package/node_modules/asyncbox/build/cjs/lib/with-timeout.d.ts.map +1 -0
- package/node_modules/asyncbox/build/cjs/lib/with-timeout.js +45 -0
- package/node_modules/asyncbox/build/cjs/lib/with-timeout.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts +9 -0
- package/node_modules/asyncbox/build/esm/lib/asyncfilter.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/asyncfilter.js +32 -0
- package/node_modules/asyncbox/build/esm/lib/asyncfilter.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts +9 -0
- package/node_modules/asyncbox/build/esm/lib/asyncmap.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/asyncmap.js +20 -0
- package/node_modules/asyncbox/build/esm/lib/asyncmap.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/errors.d.ts +9 -0
- package/node_modules/asyncbox/build/esm/lib/errors.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/errors.js +15 -0
- package/node_modules/asyncbox/build/esm/lib/errors.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/index.d.ts +12 -0
- package/node_modules/asyncbox/build/esm/lib/index.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/index.js +10 -0
- package/node_modules/asyncbox/build/esm/lib/index.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts +3 -0
- package/node_modules/asyncbox/build/esm/lib/limit-function.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/limit-function.js +12 -0
- package/node_modules/asyncbox/build/esm/lib/limit-function.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/lock.d.ts +74 -0
- package/node_modules/asyncbox/build/esm/lib/lock.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/lock.js +291 -0
- package/node_modules/asyncbox/build/esm/lib/lock.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts +15 -0
- package/node_modules/asyncbox/build/esm/lib/long-sleep.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/long-sleep.js +33 -0
- package/node_modules/asyncbox/build/esm/lib/long-sleep.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/retry.d.ts +17 -0
- package/node_modules/asyncbox/build/esm/lib/retry.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/retry.js +53 -0
- package/node_modules/asyncbox/build/esm/lib/retry.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/sleep.d.ts +20 -0
- package/node_modules/asyncbox/build/esm/lib/sleep.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/sleep.js +58 -0
- package/node_modules/asyncbox/build/esm/lib/sleep.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts +18 -0
- package/node_modules/asyncbox/build/esm/lib/wait-for-condition.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js +48 -0
- package/node_modules/asyncbox/build/esm/lib/wait-for-condition.js.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts +16 -0
- package/node_modules/asyncbox/build/esm/lib/with-timeout.d.ts.map +1 -0
- package/node_modules/asyncbox/build/esm/lib/with-timeout.js +42 -0
- package/node_modules/asyncbox/build/esm/lib/with-timeout.js.map +1 -0
- package/node_modules/asyncbox/lib/asyncfilter.ts +38 -0
- package/node_modules/asyncbox/lib/asyncmap.ts +29 -0
- package/node_modules/asyncbox/lib/errors.ts +15 -0
- package/node_modules/asyncbox/lib/index.ts +21 -0
- package/node_modules/asyncbox/lib/limit-function.ts +18 -0
- package/node_modules/asyncbox/lib/lock.ts +360 -0
- package/node_modules/asyncbox/lib/long-sleep.ts +38 -0
- package/node_modules/asyncbox/lib/retry.ts +61 -0
- package/node_modules/asyncbox/lib/sleep.ts +79 -0
- package/node_modules/asyncbox/lib/wait-for-condition.ts +52 -0
- package/node_modules/asyncbox/lib/with-timeout.ts +43 -0
- package/node_modules/asyncbox/package.json +8 -8
- package/node_modules/axios/README.md +41 -106
- package/node_modules/axios/dist/axios.js +931 -278
- package/node_modules/axios/dist/axios.min.js +2 -2
- package/node_modules/axios/dist/axios.min.js.map +1 -1
- package/node_modules/axios/dist/browser/axios.cjs +948 -268
- package/node_modules/axios/dist/esm/axios.js +948 -268
- package/node_modules/axios/dist/esm/axios.min.js +2 -2
- package/node_modules/axios/dist/esm/axios.min.js.map +1 -1
- package/node_modules/axios/dist/node/axios.cjs +925 -242
- package/node_modules/axios/index.d.cts +20 -1
- package/node_modules/axios/index.d.ts +18 -1
- package/node_modules/axios/lib/adapters/fetch.js +73 -20
- package/node_modules/axios/lib/adapters/http.js +145 -26
- package/node_modules/axios/lib/adapters/xhr.js +120 -13
- package/node_modules/axios/lib/core/Axios.js +67 -12
- package/node_modules/axios/lib/core/AxiosError.js +59 -0
- package/node_modules/axios/lib/core/AxiosHeaders.js +17 -4
- package/node_modules/axios/lib/core/InterceptorManager.js +13 -2
- package/node_modules/axios/lib/core/assertParamsAcyclic.js +49 -0
- package/node_modules/axios/lib/core/createMultipartBody.js +37 -0
- package/node_modules/axios/lib/core/dispatchRequest.js +20 -0
- package/node_modules/axios/lib/core/mergeConfig.js +183 -120
- package/node_modules/axios/lib/defaults/transitional.js +1 -0
- package/node_modules/axios/lib/env/data.js +1 -1
- package/node_modules/axios/lib/helpers/AxiosTransformStream.js +11 -2
- package/node_modules/axios/lib/helpers/Http2Sessions.js +2 -1
- package/node_modules/axios/lib/helpers/composeSignals.js +6 -3
- package/node_modules/axios/lib/helpers/cookies.js +30 -6
- package/node_modules/axios/lib/helpers/estimateDataURLDecodedBytes.js +34 -7
- package/node_modules/axios/lib/helpers/formDataToBlob.js +113 -0
- package/node_modules/axios/lib/helpers/formDataToJSON.js +25 -1
- package/node_modules/axios/lib/helpers/fromDataURI.js +8 -2
- package/node_modules/axios/lib/helpers/isURLSameOrigin.js +4 -9
- package/node_modules/axios/lib/helpers/parseHeaders.js +2 -1
- package/node_modules/axios/lib/helpers/parseProtocol.js +1 -1
- package/node_modules/axios/lib/helpers/resolveConfig.js +16 -3
- package/node_modules/axios/lib/helpers/shouldBypassProxy.js +16 -1
- package/node_modules/axios/lib/utils.js +61 -10
- package/node_modules/axios/package.json +1 -2
- package/node_modules/body-parser/README.md +17 -13
- package/node_modules/body-parser/lib/read.js +74 -57
- package/node_modules/body-parser/lib/types/json.js +11 -11
- package/node_modules/body-parser/lib/types/urlencoded.js +5 -5
- package/node_modules/body-parser/lib/utils.js +0 -15
- package/node_modules/body-parser/package.json +7 -12
- package/node_modules/follow-redirects/README.md +27 -1
- package/node_modules/follow-redirects/index.js +1 -5
- package/node_modules/follow-redirects/package.json +1 -1
- package/node_modules/io.appium.settings/CHANGELOG.md +7 -0
- package/node_modules/io.appium.settings/apks/settings_apk-debug.apk +0 -0
- package/node_modules/io.appium.settings/package.json +2 -2
- package/node_modules/on-finished/index.js +14 -2
- package/node_modules/on-finished/package.json +11 -7
- package/node_modules/qs/.editorconfig +1 -1
- package/node_modules/qs/CHANGELOG.md +45 -22
- package/node_modules/qs/README.md +26 -1
- package/node_modules/qs/dist/qs.js +27 -27
- package/node_modules/qs/eslint.config.mjs +61 -50
- package/node_modules/qs/lib/formats.js +7 -2
- package/node_modules/qs/lib/parse.js +13 -6
- package/node_modules/qs/lib/stringify.js +5 -3
- package/node_modules/qs/lib/utils.js +15 -7
- package/node_modules/qs/package.json +6 -6
- package/node_modules/qs/test/parse.js +266 -2
- package/node_modules/qs/test/stringify.js +222 -0
- package/node_modules/qs/test/utils.js +61 -3
- package/node_modules/shell-quote/README.md +37 -4
- package/node_modules/shell-quote/package.json +10 -6
- package/node_modules/shell-quote/parse.d.ts +1 -1
- package/node_modules/shell-quote/parse.js +63 -11
- package/node_modules/shell-quote/quote.d.ts +2 -1
- package/node_modules/shell-quote/quote.js +23 -3
- package/node_modules/uuid/package.json +17 -17
- package/node_modules/ws/lib/websocket.js +17 -3
- package/node_modules/ws/package.json +1 -1
- package/package.json +5 -5
- package/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts +0 -103
- package/node_modules/asyncbox/build/cjs/lib/asyncbox.d.ts.map +0 -1
- package/node_modules/asyncbox/build/cjs/lib/asyncbox.js +0 -311
- package/node_modules/asyncbox/build/cjs/lib/asyncbox.js.map +0 -1
- package/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts +0 -103
- package/node_modules/asyncbox/build/esm/lib/asyncbox.d.ts.map +0 -1
- package/node_modules/asyncbox/build/esm/lib/asyncbox.js +0 -298
- package/node_modules/asyncbox/build/esm/lib/asyncbox.js.map +0 -1
- package/node_modules/asyncbox/lib/asyncbox.ts +0 -382
- package/node_modules/on-finished/HISTORY.md +0 -98
- package/node_modules/shell-quote/.nycrc +0 -14
- package/node_modules/shell-quote/eslint.config.mjs +0 -29
- package/node_modules/shell-quote/security.md +0 -11
- package/node_modules/shell-quote/test/comment.js +0 -16
- package/node_modules/shell-quote/test/env.js +0 -52
- package/node_modules/shell-quote/test/env_fn.js +0 -21
- package/node_modules/shell-quote/test/op.js +0 -102
- package/node_modules/shell-quote/test/parse.js +0 -149
- package/node_modules/shell-quote/test/quote.js +0 -145
- package/node_modules/shell-quote/test/set.js +0 -31
|
@@ -208,6 +208,49 @@ try {
|
|
|
208
208
|
}
|
|
209
209
|
```
|
|
210
210
|
|
|
211
|
+
### AsyncLock
|
|
212
|
+
|
|
213
|
+
A promise-based mutex keyed by string, derived from the unmaintained
|
|
214
|
+
[async-lock](https://github.com/rogierschouten/async-lock) (MIT). Tasks with the
|
|
215
|
+
same key run one at a time in FIFO order; different keys run concurrently.
|
|
216
|
+
|
|
217
|
+
Differences from `async-lock`: promises only (no callbacks, custom `Promise`
|
|
218
|
+
or domain support), and each task runs in the `AsyncLocalStorage` context of
|
|
219
|
+
its own `acquire` caller instead of the previous lock holder's one, so no
|
|
220
|
+
`AsyncResource.bind` is needed. A task that outlives `maxExecutionTime` can no
|
|
221
|
+
longer release the lock a second time, and queued tasks that time out are
|
|
222
|
+
removed from the queue.
|
|
223
|
+
|
|
224
|
+
```js
|
|
225
|
+
import {AsyncLock} from 'asyncbox';
|
|
226
|
+
|
|
227
|
+
const lock = new AsyncLock({maxPending: 10});
|
|
228
|
+
|
|
229
|
+
const result = await lock.acquire('key', async () => {
|
|
230
|
+
// runs exclusively for 'key'
|
|
231
|
+
return 42;
|
|
232
|
+
});
|
|
233
|
+
|
|
234
|
+
// several keys are held together; they are acquired in sorted order, so overlapping calls cannot deadlock
|
|
235
|
+
await lock.acquire(['key1', 'key2'], () => {});
|
|
236
|
+
|
|
237
|
+
// per-call options: timeout, maxOccupationTime, maxExecutionTime, maxPending, skipQueue
|
|
238
|
+
await lock.acquire('key', () => {}, {timeout: 5000, skipQueue: true});
|
|
239
|
+
|
|
240
|
+
lock.getQueueLength('key'); // tasks waiting for the key (the running one is not counted)
|
|
241
|
+
lock.isBusy('key'); // running or pending tasks for the key
|
|
242
|
+
lock.isBusy(); // any key
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
Options can be passed to the constructor and overridden per `acquire` call.
|
|
246
|
+
Times are in ms, up to 2147483647, and `0` means no limit.
|
|
247
|
+
|
|
248
|
+
- `timeout` (default `0`) - max wait in the queue (for all the keys of a multi-key call together) before the task is rejected and dropped
|
|
249
|
+
- `maxOccupationTime` (default `0`) - max time from `acquire` to completion, queue wait included; one budget is shared by all keys of a multi-key call
|
|
250
|
+
- `maxExecutionTime` (default `0`) - max time the task may run while holding the lock; the lock is released when exceeded (for a multi-key call, it counts from when all keys are held and releases all of them)
|
|
251
|
+
- `maxPending` (default `1000`) - max tasks waiting per key; further ones are rejected right away, so `0` rejects every task that would have to wait
|
|
252
|
+
- `skipQueue` (default `false`, per call only) - put the task at the front of the queue
|
|
253
|
+
|
|
211
254
|
### Run the tests
|
|
212
255
|
|
|
213
256
|
```
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { MapFilterOptions } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Similar to `Array.prototype.filter`; runs in parallel, serial, or with custom concurrency pool
|
|
4
|
+
* @param coll - The collection to filter
|
|
5
|
+
* @param filter - The function to test each element
|
|
6
|
+
* @param options - Options for controlling parallelism (default: true - fully parallel)
|
|
7
|
+
*/
|
|
8
|
+
export declare function asyncfilter<T>(coll: T[], filter: (value: T) => boolean | Promise<boolean>, options?: MapFilterOptions): Promise<T[]>;
|
|
9
|
+
//# sourceMappingURL=asyncfilter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asyncfilter.d.ts","sourceRoot":"","sources":["../../../lib/asyncfilter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAChD,OAAO,GAAE,gBAAuB,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC,CAwBd"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.asyncfilter = asyncfilter;
|
|
4
|
+
const limit_function_js_1 = require("./limit-function.js");
|
|
5
|
+
/**
|
|
6
|
+
* Similar to `Array.prototype.filter`; runs in parallel, serial, or with custom concurrency pool
|
|
7
|
+
* @param coll - The collection to filter
|
|
8
|
+
* @param filter - The function to test each element
|
|
9
|
+
* @param options - Options for controlling parallelism (default: true - fully parallel)
|
|
10
|
+
*/
|
|
11
|
+
async function asyncfilter(coll, filter, options = true) {
|
|
12
|
+
if (options === null) {
|
|
13
|
+
throw new Error('Options cannot be null');
|
|
14
|
+
}
|
|
15
|
+
// limitFunction requires the filter to always return a promise
|
|
16
|
+
const filterAsync = async (value) => filter(value);
|
|
17
|
+
if (options === false) {
|
|
18
|
+
return coll.reduce(async (accP, item) => {
|
|
19
|
+
const acc = await accP;
|
|
20
|
+
if (await filterAsync(item)) {
|
|
21
|
+
acc.push(item);
|
|
22
|
+
}
|
|
23
|
+
return acc;
|
|
24
|
+
}, Promise.resolve([]));
|
|
25
|
+
}
|
|
26
|
+
const adjustedFilter = options === true ? filterAsync : (await (0, limit_function_js_1.getLimitFunction)())(filterAsync, { concurrency: options.concurrency });
|
|
27
|
+
const bools = await Promise.all(coll.map(adjustedFilter));
|
|
28
|
+
return coll.reduce((acc, item, i) => {
|
|
29
|
+
if (bools[i]) {
|
|
30
|
+
acc.push(item);
|
|
31
|
+
}
|
|
32
|
+
return acc;
|
|
33
|
+
}, []);
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=asyncfilter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asyncfilter.js","sourceRoot":"","sources":["../../../lib/asyncfilter.ts"],"names":[],"mappings":";;AASA,kCA4BC;AArCD,2DAAqD;AAGrD;;;;;GAKG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAS,EACT,MAAgD,EAChD,UAA4B,IAAI;IAEhC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,+DAA+D;IAC/D,MAAM,WAAW,GAAG,KAAK,EAAE,KAAQ,EAAoB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAAe,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YACpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;YACvB,IAAI,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,cAAc,GAClB,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,oCAAgB,GAAE,CAAC,CAAC,WAAW,EAAE,EAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAC,CAAC,CAAC;IAC/G,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,MAAM,CAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACvC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { MapFilterOptions } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Similar to `Array.prototype.map`; runs in parallel, serial, or with custom concurrency pool
|
|
4
|
+
* @param coll - The collection to map over
|
|
5
|
+
* @param mapper - The function to apply to each element
|
|
6
|
+
* @param options - Options for controlling parallelism (default: true - fully parallel)
|
|
7
|
+
*/
|
|
8
|
+
export declare function asyncmap<T, R>(coll: T[], mapper: (value: T) => R | Promise<R>, options?: MapFilterOptions): Promise<R[]>;
|
|
9
|
+
//# sourceMappingURL=asyncmap.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asyncmap.d.ts","sourceRoot":"","sources":["../../../lib/asyncmap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,CAAC,EACjC,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACpC,OAAO,GAAE,gBAAuB,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC,CAed"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.asyncmap = asyncmap;
|
|
4
|
+
const limit_function_js_1 = require("./limit-function.js");
|
|
5
|
+
/**
|
|
6
|
+
* Similar to `Array.prototype.map`; runs in parallel, serial, or with custom concurrency pool
|
|
7
|
+
* @param coll - The collection to map over
|
|
8
|
+
* @param mapper - The function to apply to each element
|
|
9
|
+
* @param options - Options for controlling parallelism (default: true - fully parallel)
|
|
10
|
+
*/
|
|
11
|
+
async function asyncmap(coll, mapper, options = true) {
|
|
12
|
+
if (options === null) {
|
|
13
|
+
throw new Error('Options cannot be null');
|
|
14
|
+
}
|
|
15
|
+
// limitFunction requires the mapper to always return a promise
|
|
16
|
+
const mapperAsync = async (value) => mapper(value);
|
|
17
|
+
if (options === false) {
|
|
18
|
+
return coll.reduce(async (acc, item) => [...(await acc), await mapperAsync(item)], Promise.resolve([]));
|
|
19
|
+
}
|
|
20
|
+
const adjustedMapper = options === true ? mapperAsync : (await (0, limit_function_js_1.getLimitFunction)())(mapperAsync, { concurrency: options.concurrency });
|
|
21
|
+
return Promise.all(coll.map(adjustedMapper));
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=asyncmap.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asyncmap.js","sourceRoot":"","sources":["../../../lib/asyncmap.ts"],"names":[],"mappings":";;AASA,4BAmBC;AA5BD,2DAAqD;AAGrD;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAC5B,IAAS,EACT,MAAoC,EACpC,UAA4B,IAAI;IAEhC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,+DAA+D;IAC/D,MAAM,WAAW,GAAG,KAAK,EAAE,KAAQ,EAAc,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAChB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,EAC9D,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CACpB,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAClB,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,IAAA,oCAAgB,GAAE,CAAC,CAAC,WAAW,EAAE,EAAC,WAAW,EAAE,OAAO,CAAC,WAAW,EAAC,CAAC,CAAC;IAC/G,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AAC/C,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/** Error thrown by {@link withTimeout} when the deadline is exceeded. */
|
|
2
|
+
export declare class TimeoutError extends Error {
|
|
3
|
+
constructor(message?: string);
|
|
4
|
+
}
|
|
5
|
+
/** Thrown when a promise is cancelled via `cancel`. */
|
|
6
|
+
export declare class PromiseCancellationError extends Error {
|
|
7
|
+
constructor(message?: string);
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../lib/errors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM;CAI7B;AAED,uDAAuD;AACvD,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,GAAE,MAA4B;CAIlD"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PromiseCancellationError = exports.TimeoutError = void 0;
|
|
4
|
+
/** Error thrown by {@link withTimeout} when the deadline is exceeded. */
|
|
5
|
+
class TimeoutError extends Error {
|
|
6
|
+
constructor(message) {
|
|
7
|
+
super(message ?? 'Operation timed out');
|
|
8
|
+
this.name = 'TimeoutError';
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
exports.TimeoutError = TimeoutError;
|
|
12
|
+
/** Thrown when a promise is cancelled via `cancel`. */
|
|
13
|
+
class PromiseCancellationError extends Error {
|
|
14
|
+
constructor(message = 'Promise cancelled') {
|
|
15
|
+
super(message);
|
|
16
|
+
this.name = 'PromiseCancellationError';
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
exports.PromiseCancellationError = PromiseCancellationError;
|
|
20
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../lib/errors.ts"],"names":[],"mappings":";;;AAAA,yEAAyE;AACzE,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,uDAAuD;AACvD,MAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,UAAkB,mBAAmB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AALD,4DAKC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
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
|
+
export type { AsyncLockOptions, AcquireOptions } from './lock.js';
|
|
11
|
+
export type { CancellablePromise, Progress, ProgressCallback, LongSleepOptions, MapFilterOptions, SleepArg, SleepOptions, WaitForConditionOptions, } from './types.js';
|
|
12
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAC,MAAM,aAAa,CAAC;AACnE,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AACjC,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAC,KAAK,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAChD,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC,YAAY,EAAC,gBAAgB,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.AsyncLock = exports.waitForCondition = exports.asyncfilter = exports.asyncmap = exports.retryInterval = exports.retry = exports.longSleep = exports.withTimeout = exports.sleep = exports.PromiseCancellationError = exports.TimeoutError = void 0;
|
|
4
|
+
var errors_js_1 = require("./errors.js");
|
|
5
|
+
Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_js_1.TimeoutError; } });
|
|
6
|
+
Object.defineProperty(exports, "PromiseCancellationError", { enumerable: true, get: function () { return errors_js_1.PromiseCancellationError; } });
|
|
7
|
+
var sleep_js_1 = require("./sleep.js");
|
|
8
|
+
Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return sleep_js_1.sleep; } });
|
|
9
|
+
var with_timeout_js_1 = require("./with-timeout.js");
|
|
10
|
+
Object.defineProperty(exports, "withTimeout", { enumerable: true, get: function () { return with_timeout_js_1.withTimeout; } });
|
|
11
|
+
var long_sleep_js_1 = require("./long-sleep.js");
|
|
12
|
+
Object.defineProperty(exports, "longSleep", { enumerable: true, get: function () { return long_sleep_js_1.longSleep; } });
|
|
13
|
+
var retry_js_1 = require("./retry.js");
|
|
14
|
+
Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_js_1.retry; } });
|
|
15
|
+
Object.defineProperty(exports, "retryInterval", { enumerable: true, get: function () { return retry_js_1.retryInterval; } });
|
|
16
|
+
var asyncmap_js_1 = require("./asyncmap.js");
|
|
17
|
+
Object.defineProperty(exports, "asyncmap", { enumerable: true, get: function () { return asyncmap_js_1.asyncmap; } });
|
|
18
|
+
var asyncfilter_js_1 = require("./asyncfilter.js");
|
|
19
|
+
Object.defineProperty(exports, "asyncfilter", { enumerable: true, get: function () { return asyncfilter_js_1.asyncfilter; } });
|
|
20
|
+
var wait_for_condition_js_1 = require("./wait-for-condition.js");
|
|
21
|
+
Object.defineProperty(exports, "waitForCondition", { enumerable: true, get: function () { return wait_for_condition_js_1.waitForCondition; } });
|
|
22
|
+
var lock_js_1 = require("./lock.js");
|
|
23
|
+
Object.defineProperty(exports, "AsyncLock", { enumerable: true, get: function () { return lock_js_1.AsyncLock; } });
|
|
24
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":";;;AAAA,yCAAmE;AAA3D,yGAAA,YAAY,OAAA;AAAE,qHAAA,wBAAwB,OAAA;AAC9C,uCAAiC;AAAzB,iGAAA,KAAK,OAAA;AACb,qDAA8C;AAAtC,8GAAA,WAAW,OAAA;AACnB,iDAA0C;AAAlC,0GAAA,SAAS,OAAA;AACjB,uCAAgD;AAAxC,iGAAA,KAAK,OAAA;AAAE,yGAAA,aAAa,OAAA;AAC5B,6CAAuC;AAA/B,uGAAA,QAAQ,OAAA;AAChB,mDAA6C;AAArC,6GAAA,WAAW,OAAA;AACnB,iEAAyD;AAAjD,yHAAA,gBAAgB,OAAA;AACxB,qCAAoC;AAA5B,oGAAA,SAAS,OAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"limit-function.d.ts","sourceRoot":"","sources":["../../../lib/limit-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAc3C,wBAAsB,gBAAgB,kCAGrC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.getLimitFunction = getLimitFunction;
|
|
4
|
+
// p-limit is ESM-only. tsc downlevels a plain `import()` in CommonJS output into a
|
|
5
|
+
// require()-in-a-microtask, which still hits Node's require(esm) interop and can race with a
|
|
6
|
+
// concurrent dynamic import() of the same module elsewhere in the process
|
|
7
|
+
// (ERR_REQUIRE_ESM_RACE_CONDITION). Route through `new Function` so tsc can't see or rewrite the
|
|
8
|
+
// import() call, keeping it a genuine native dynamic import in both the ESM and CJS builds.
|
|
9
|
+
const dynamicImport = new Function('specifier', 'return import(specifier)');
|
|
10
|
+
let limitFunctionPromise;
|
|
11
|
+
async function getLimitFunction() {
|
|
12
|
+
limitFunctionPromise ??= dynamicImport('p-limit');
|
|
13
|
+
return (await limitFunctionPromise).limitFunction;
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=limit-function.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"limit-function.js","sourceRoot":"","sources":["../../../lib/limit-function.ts"],"names":[],"mappings":";;AAcA,4CAGC;AAbD,mFAAmF;AACnF,6FAA6F;AAC7F,0EAA0E;AAC1E,iGAAiG;AACjG,4FAA4F;AAC5F,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAEhD,CAAC;AAE3B,IAAI,oBAAuD,CAAC;AACrD,KAAK,UAAU,gBAAgB;IACpC,oBAAoB,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,CAAC,MAAM,oBAAoB,CAAC,CAAC,aAAa,CAAC;AACpD,CAAC"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/** Options shared by the {@link AsyncLock} constructor and {@link AsyncLock.acquire}. */
|
|
2
|
+
export interface AsyncLockOptions {
|
|
3
|
+
/**
|
|
4
|
+
* Max ms a task may wait in the queue before failing. `0` means never.
|
|
5
|
+
* @default 0
|
|
6
|
+
*/
|
|
7
|
+
timeout?: number;
|
|
8
|
+
/**
|
|
9
|
+
* Max ms between calling `acquire` and the task finishing (queue wait included). `0` means never.
|
|
10
|
+
* @default 0
|
|
11
|
+
*/
|
|
12
|
+
maxOccupationTime?: number;
|
|
13
|
+
/**
|
|
14
|
+
* Max ms the task may run once it holds the lock; the lock is then released. `0` means never.
|
|
15
|
+
* @default 0
|
|
16
|
+
*/
|
|
17
|
+
maxExecutionTime?: number;
|
|
18
|
+
/**
|
|
19
|
+
* Max number of tasks waiting per key; further ones are rejected right away. `0` rejects every
|
|
20
|
+
* task that would have to wait.
|
|
21
|
+
* @default 1000
|
|
22
|
+
*/
|
|
23
|
+
maxPending?: number;
|
|
24
|
+
}
|
|
25
|
+
/** Per-call options of {@link AsyncLock.acquire}; override the constructor ones. */
|
|
26
|
+
export interface AcquireOptions extends AsyncLockOptions {
|
|
27
|
+
/**
|
|
28
|
+
* Put the task at the front of the queue instead of the back.
|
|
29
|
+
* @default false
|
|
30
|
+
*/
|
|
31
|
+
skipQueue?: boolean;
|
|
32
|
+
}
|
|
33
|
+
type Task<T> = () => T | PromiseLike<T>;
|
|
34
|
+
/**
|
|
35
|
+
* Promise-based mutex keyed by string. Tasks with the same key run one at a time, in FIFO order.
|
|
36
|
+
*
|
|
37
|
+
* Each task runs in the async context (`AsyncLocalStorage`) of the code that called
|
|
38
|
+
* {@link AsyncLock.acquire}, not in the context of the task that held the lock before it.
|
|
39
|
+
*/
|
|
40
|
+
export declare class AsyncLock {
|
|
41
|
+
private readonly queues;
|
|
42
|
+
private readonly defaults;
|
|
43
|
+
constructor(opts?: AsyncLockOptions);
|
|
44
|
+
/**
|
|
45
|
+
* Run `fn` once the lock for `key` is free and release the lock when it settles.
|
|
46
|
+
*
|
|
47
|
+
* Multiple keys are held together. They are acquired one by one in sorted order, whatever order
|
|
48
|
+
* they are given in, so that overlapping calls cannot deadlock; duplicates are ignored. Keys that
|
|
49
|
+
* are already held stay held while a later one is awaited. `timeout` and `maxOccupationTime` are
|
|
50
|
+
* budgets for the whole call, while `maxExecutionTime` counts from the moment all the keys are
|
|
51
|
+
* held and releases all of them.
|
|
52
|
+
*
|
|
53
|
+
* @param key - Resource key, or a non-empty array of keys
|
|
54
|
+
* @param fn - Task to run while holding the lock; may be sync or async
|
|
55
|
+
* @param opts - Per-call options
|
|
56
|
+
* @returns The result of `fn`
|
|
57
|
+
* @throws {TypeError} Synchronously, if an argument is invalid
|
|
58
|
+
*/
|
|
59
|
+
acquire<T>(key: string | readonly string[], fn: Task<T>, opts?: AcquireOptions): Promise<T>;
|
|
60
|
+
/**
|
|
61
|
+
* Number of tasks waiting for `key`, not counting the running one.
|
|
62
|
+
*
|
|
63
|
+
* @param key - Resource key
|
|
64
|
+
*/
|
|
65
|
+
getQueueLength(key: string): number;
|
|
66
|
+
/**
|
|
67
|
+
* Whether `key` has a running or pending task. Without a key, whether any key does.
|
|
68
|
+
*
|
|
69
|
+
* @param key - Resource key
|
|
70
|
+
*/
|
|
71
|
+
isBusy(key?: string): boolean;
|
|
72
|
+
}
|
|
73
|
+
export {};
|
|
74
|
+
//# sourceMappingURL=lock.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../lib/lock.ts"],"names":[],"mappings":"AAMA,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,KAAK,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAMxC;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,IAAI,GAAE,gBAAqB;IAWvC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAkB/F;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;CAG9B"}
|
|
@@ -0,0 +1,295 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.AsyncLock = void 0;
|
|
4
|
+
const node_async_hooks_1 = require("node:async_hooks");
|
|
5
|
+
const DEFAULT_MAX_PENDING = 1000;
|
|
6
|
+
// setTimeout fires after 1 ms for anything above this
|
|
7
|
+
const MAX_TIMER_MS = 2 ** 31 - 1;
|
|
8
|
+
/**
|
|
9
|
+
* Promise-based mutex keyed by string. Tasks with the same key run one at a time, in FIFO order.
|
|
10
|
+
*
|
|
11
|
+
* Each task runs in the async context (`AsyncLocalStorage`) of the code that called
|
|
12
|
+
* {@link AsyncLock.acquire}, not in the context of the task that held the lock before it.
|
|
13
|
+
*/
|
|
14
|
+
class AsyncLock {
|
|
15
|
+
queues = new Map();
|
|
16
|
+
defaults;
|
|
17
|
+
constructor(opts = {}) {
|
|
18
|
+
validateOptions(opts);
|
|
19
|
+
this.defaults = {
|
|
20
|
+
timeout: 0,
|
|
21
|
+
maxOccupationTime: 0,
|
|
22
|
+
maxExecutionTime: 0,
|
|
23
|
+
maxPending: DEFAULT_MAX_PENDING,
|
|
24
|
+
...stripUndefined(opts),
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Run `fn` once the lock for `key` is free and release the lock when it settles.
|
|
29
|
+
*
|
|
30
|
+
* Multiple keys are held together. They are acquired one by one in sorted order, whatever order
|
|
31
|
+
* they are given in, so that overlapping calls cannot deadlock; duplicates are ignored. Keys that
|
|
32
|
+
* are already held stay held while a later one is awaited. `timeout` and `maxOccupationTime` are
|
|
33
|
+
* budgets for the whole call, while `maxExecutionTime` counts from the moment all the keys are
|
|
34
|
+
* held and releases all of them.
|
|
35
|
+
*
|
|
36
|
+
* @param key - Resource key, or a non-empty array of keys
|
|
37
|
+
* @param fn - Task to run while holding the lock; may be sync or async
|
|
38
|
+
* @param opts - Per-call options
|
|
39
|
+
* @returns The result of `fn`
|
|
40
|
+
* @throws {TypeError} Synchronously, if an argument is invalid
|
|
41
|
+
*/
|
|
42
|
+
acquire(key, fn, opts = {}) {
|
|
43
|
+
if (typeof fn !== 'function') {
|
|
44
|
+
throw new TypeError('You must pass a function to execute');
|
|
45
|
+
}
|
|
46
|
+
if (typeof key !== 'string' &&
|
|
47
|
+
!(Array.isArray(key) && key.length > 0 && [...key].every((k) => typeof k === 'string'))) {
|
|
48
|
+
throw new TypeError('The key must be a string or a non-empty array of strings');
|
|
49
|
+
}
|
|
50
|
+
validateOptions(opts);
|
|
51
|
+
// A canonical order keeps overlapping multi-key calls, e.g. ['a', 'b'] and ['b', 'a'], from deadlocking
|
|
52
|
+
const keys = typeof key === 'string' ? [key] : [...new Set(key)].sort();
|
|
53
|
+
const acquisition = new Acquisition(this.queues, keys, fn, { ...this.defaults, ...stripUndefined(opts) });
|
|
54
|
+
acquisition.enqueue();
|
|
55
|
+
return acquisition.promise;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Number of tasks waiting for `key`, not counting the running one.
|
|
59
|
+
*
|
|
60
|
+
* @param key - Resource key
|
|
61
|
+
*/
|
|
62
|
+
getQueueLength(key) {
|
|
63
|
+
return this.queues.get(key)?.length ?? 0;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Whether `key` has a running or pending task. Without a key, whether any key does.
|
|
67
|
+
*
|
|
68
|
+
* @param key - Resource key
|
|
69
|
+
*/
|
|
70
|
+
isBusy(key) {
|
|
71
|
+
return key === undefined ? this.queues.size > 0 : this.queues.has(key);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
exports.AsyncLock = AsyncLock;
|
|
75
|
+
/** The place of one acquisition in the queue of one key; once granted, it holds the key. */
|
|
76
|
+
class KeyClaim {
|
|
77
|
+
queues;
|
|
78
|
+
key;
|
|
79
|
+
opts;
|
|
80
|
+
onGranted;
|
|
81
|
+
onDenied;
|
|
82
|
+
holding = false;
|
|
83
|
+
dropped = false;
|
|
84
|
+
queueTimer;
|
|
85
|
+
constructor(queues, key, opts, onGranted, onDenied) {
|
|
86
|
+
this.queues = queues;
|
|
87
|
+
this.key = key;
|
|
88
|
+
this.opts = opts;
|
|
89
|
+
this.onGranted = onGranted;
|
|
90
|
+
this.onDenied = onDenied;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Take the key right away if it is free, otherwise wait in its queue.
|
|
94
|
+
*
|
|
95
|
+
* @returns Whether the key is held. If not, `onGranted` is called once it is, unless the claim
|
|
96
|
+
* is denied.
|
|
97
|
+
*/
|
|
98
|
+
join() {
|
|
99
|
+
const { timeout, maxPending, skipQueue } = this.opts;
|
|
100
|
+
const queue = this.queues.get(this.key);
|
|
101
|
+
if (!queue) {
|
|
102
|
+
this.queues.set(this.key, []);
|
|
103
|
+
this.holding = true;
|
|
104
|
+
return true;
|
|
105
|
+
}
|
|
106
|
+
if (queue.length >= maxPending) {
|
|
107
|
+
this.onDenied(new Error(`Too many pending tasks in queue ${this.key}`));
|
|
108
|
+
}
|
|
109
|
+
else {
|
|
110
|
+
if (skipQueue) {
|
|
111
|
+
queue.unshift(this.grant);
|
|
112
|
+
}
|
|
113
|
+
else {
|
|
114
|
+
queue.push(this.grant);
|
|
115
|
+
}
|
|
116
|
+
if (timeout) {
|
|
117
|
+
this.queueTimer = setTimeout(() => this.onDenied(new Error(`async-lock timed out in queue ${this.key}`)), timeout);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return false;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Leave the queue, or release the key if it is held. Idempotent.
|
|
124
|
+
*
|
|
125
|
+
* @returns The handover of the key to its next waiter. The caller must run it only after it
|
|
126
|
+
* has released all of its keys, so that no waiter starts while a batch is partially released.
|
|
127
|
+
*/
|
|
128
|
+
drop() {
|
|
129
|
+
if (this.dropped) {
|
|
130
|
+
return undefined;
|
|
131
|
+
}
|
|
132
|
+
this.dropped = true;
|
|
133
|
+
clearTimeout(this.queueTimer);
|
|
134
|
+
if (this.holding) {
|
|
135
|
+
return this.releaseKey();
|
|
136
|
+
}
|
|
137
|
+
const queue = this.queues.get(this.key);
|
|
138
|
+
const idx = queue?.indexOf(this.grant) ?? -1;
|
|
139
|
+
if (idx >= 0) {
|
|
140
|
+
queue?.splice(idx, 1);
|
|
141
|
+
}
|
|
142
|
+
return undefined;
|
|
143
|
+
}
|
|
144
|
+
releaseKey() {
|
|
145
|
+
const next = this.queues.get(this.key)?.shift();
|
|
146
|
+
if (!next) {
|
|
147
|
+
this.queues.delete(this.key);
|
|
148
|
+
}
|
|
149
|
+
return next;
|
|
150
|
+
}
|
|
151
|
+
// An arrow function, because this exact reference sits in the queue and is removed by drop()
|
|
152
|
+
grant = () => {
|
|
153
|
+
clearTimeout(this.queueTimer);
|
|
154
|
+
this.holding = true;
|
|
155
|
+
if (this.dropped) {
|
|
156
|
+
// Dropped while the key was being handed over to it: pass the key on instead of using it
|
|
157
|
+
this.releaseKey()?.();
|
|
158
|
+
return;
|
|
159
|
+
}
|
|
160
|
+
this.onGranted();
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* One `acquire` call: its promise, its timers and its claims on all of its keys. The keys are
|
|
165
|
+
* claimed one by one, the task runs once all of them are held and they are released together.
|
|
166
|
+
*/
|
|
167
|
+
class Acquisition {
|
|
168
|
+
queues;
|
|
169
|
+
keys;
|
|
170
|
+
opts;
|
|
171
|
+
promise;
|
|
172
|
+
resolve;
|
|
173
|
+
reject;
|
|
174
|
+
task;
|
|
175
|
+
claims = [];
|
|
176
|
+
running = false;
|
|
177
|
+
settled = false;
|
|
178
|
+
queueDeadline = 0;
|
|
179
|
+
occupationTimer;
|
|
180
|
+
executionTimer;
|
|
181
|
+
constructor(queues, keys, task, opts) {
|
|
182
|
+
this.queues = queues;
|
|
183
|
+
this.keys = keys;
|
|
184
|
+
this.opts = opts;
|
|
185
|
+
// Queued tasks are started from the previous task's promise chain; bind to keep our context
|
|
186
|
+
this.task = node_async_hooks_1.AsyncResource.bind(task);
|
|
187
|
+
this.promise = new Promise((resolve, reject) => {
|
|
188
|
+
this.resolve = resolve;
|
|
189
|
+
this.reject = reject;
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
/** Start the task right away if all the keys are free, otherwise wait for them. */
|
|
193
|
+
enqueue() {
|
|
194
|
+
const { timeout, maxOccupationTime } = this.opts;
|
|
195
|
+
if (timeout) {
|
|
196
|
+
this.queueDeadline = performance.now() + timeout;
|
|
197
|
+
}
|
|
198
|
+
if (maxOccupationTime) {
|
|
199
|
+
this.occupationTimer = setTimeout(() => this.expire(), maxOccupationTime);
|
|
200
|
+
}
|
|
201
|
+
this.claimKeys(0);
|
|
202
|
+
}
|
|
203
|
+
// Free keys are claimed in a loop, not recursively, so that a large batch cannot overflow the stack
|
|
204
|
+
claimKeys(from) {
|
|
205
|
+
const { maxPending, skipQueue } = this.opts;
|
|
206
|
+
try {
|
|
207
|
+
for (let index = from; index < this.keys.length; index++) {
|
|
208
|
+
// The queue timeout is a budget for waiting for all the keys, not for each one
|
|
209
|
+
const timeout = this.queueDeadline ? Math.max(this.queueDeadline - performance.now(), 1) : 0;
|
|
210
|
+
const claim = new KeyClaim(this.queues, this.keys[index], { timeout, maxPending, skipQueue }, () => this.claimKeys(index + 1), (error) => this.abort(error));
|
|
211
|
+
this.claims.push(claim);
|
|
212
|
+
if (!claim.join()) {
|
|
213
|
+
return;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
this.execute();
|
|
217
|
+
}
|
|
218
|
+
catch (error) {
|
|
219
|
+
this.abort(error);
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
execute() {
|
|
223
|
+
const { maxExecutionTime } = this.opts;
|
|
224
|
+
this.running = true;
|
|
225
|
+
if (maxExecutionTime) {
|
|
226
|
+
this.executionTimer = setTimeout(() => this.abort(new Error(`Maximum execution time is exceeded ${this.keys.join(', ')}`)), maxExecutionTime);
|
|
227
|
+
}
|
|
228
|
+
new Promise((resolve) => resolve(this.task())).then((value) => this.finish({ value }), (error) => this.finish({ error }));
|
|
229
|
+
}
|
|
230
|
+
finish(outcome) {
|
|
231
|
+
this.settle(outcome);
|
|
232
|
+
this.release();
|
|
233
|
+
}
|
|
234
|
+
// Reject and release all the keys; a running task is left to finish on its own
|
|
235
|
+
abort(error) {
|
|
236
|
+
this.settle({ error });
|
|
237
|
+
this.release();
|
|
238
|
+
}
|
|
239
|
+
// A running task keeps its keys until it finishes, an unstarted one gives them up
|
|
240
|
+
expire() {
|
|
241
|
+
const keys = this.keys.join(', ');
|
|
242
|
+
if (this.running) {
|
|
243
|
+
this.settle({ error: new Error(`Maximum occupation time is exceeded while executing ${keys}`) });
|
|
244
|
+
}
|
|
245
|
+
else {
|
|
246
|
+
this.abort(new Error(`Maximum occupation time is exceeded in queue ${keys}`));
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
settle(outcome) {
|
|
250
|
+
if (this.settled) {
|
|
251
|
+
return;
|
|
252
|
+
}
|
|
253
|
+
this.settled = true;
|
|
254
|
+
clearTimeout(this.occupationTimer);
|
|
255
|
+
if ('error' in outcome) {
|
|
256
|
+
this.reject(outcome.error);
|
|
257
|
+
}
|
|
258
|
+
else {
|
|
259
|
+
this.resolve(outcome.value);
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
// Idempotent, so a task that outlives its execution timeout cannot release the keys twice
|
|
263
|
+
release() {
|
|
264
|
+
clearTimeout(this.executionTimer);
|
|
265
|
+
const handovers = this.claims
|
|
266
|
+
.splice(0)
|
|
267
|
+
.reverse()
|
|
268
|
+
.map((claim) => claim.drop());
|
|
269
|
+
for (const handover of handovers) {
|
|
270
|
+
handover?.();
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
function validateOptions(opts) {
|
|
275
|
+
if (opts === null || typeof opts !== 'object') {
|
|
276
|
+
throw new TypeError('The options must be an object');
|
|
277
|
+
}
|
|
278
|
+
for (const name of ['timeout', 'maxOccupationTime', 'maxExecutionTime']) {
|
|
279
|
+
const value = opts[name];
|
|
280
|
+
if (value !== undefined && !(Number.isFinite(value) && value >= 0 && value <= MAX_TIMER_MS)) {
|
|
281
|
+
throw new TypeError(`${name} must be a number of milliseconds between 0 and ${MAX_TIMER_MS}`);
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
if (opts.skipQueue !== undefined && typeof opts.skipQueue !== 'boolean') {
|
|
285
|
+
throw new TypeError('skipQueue must be a boolean');
|
|
286
|
+
}
|
|
287
|
+
const { maxPending } = opts;
|
|
288
|
+
if (maxPending !== undefined && maxPending !== Infinity && !(Number.isInteger(maxPending) && maxPending >= 0)) {
|
|
289
|
+
throw new TypeError('maxPending must be a non-negative integer or Infinity');
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
function stripUndefined(obj) {
|
|
293
|
+
return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
|
|
294
|
+
}
|
|
295
|
+
//# sourceMappingURL=lock.js.map
|