appium-mcp 1.8.15 → 1.8.16

package/src/resources/submodules/appium/packages/relaxed-caps-plugin/CHANGELOG.md

@@ -0,0 +1,154 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [2.0.1](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@2.0.0...@appium/relaxed-caps-plugin@2.0.1) (2025-10-08)
+
+
+### Bug Fixes
+
+* **base-driver,relaxed-caps-plugin,types:** add missing W3C caps ([#21642](https://github.com/appium/appium/issues/21642)) ([e6635b7](https://github.com/appium/appium/commit/e6635b737d0f42d8fd38c3d8bea70067d2e7c87a))
+
+
+
+## [2.0.0](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@2.0.0-rc.1...@appium/relaxed-caps-plugin@2.0.0) (2025-08-18)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+## [2.0.0-rc.1](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.6...@appium/relaxed-caps-plugin@2.0.0-rc.1) (2025-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* set minimum Node.js version to v20.19.0 (#21394)
+
+### Miscellaneous Chores
+
+* set minimum Node.js version to v20.19.0 ([#21394](https://github.com/appium/appium/issues/21394)) ([37e22c4](https://github.com/appium/appium/commit/37e22c4f9c9920cea3f340841ab1b7c60e3147e9))
+
+
+
+## [1.0.6](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.5...@appium/relaxed-caps-plugin@1.0.6) (2023-12-18)
+
+
+### Bug Fixes
+
+* **docutils:** remove `@appium/typedoc-plugin-appium` and all other uses of `typedoc` ([#19465](https://github.com/appium/appium/issues/19465)) ([7528fcf](https://github.com/appium/appium/commit/7528fcf890f79f4017f5e718bb1952bf907ee479))
+
+
+
+## [1.0.5](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.4...@appium/relaxed-caps-plugin@1.0.5) (2023-02-09)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+## [1.0.4](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.3...@appium/relaxed-caps-plugin@1.0.4) (2023-01-13)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+## [1.0.3](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.2...@appium/relaxed-caps-plugin@1.0.3) (2023-01-13)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+## [1.0.2](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.1...@appium/relaxed-caps-plugin@1.0.2) (2023-01-13)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+## [1.0.1](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.14...@appium/relaxed-caps-plugin@1.0.1) (2023-01-13)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+
+
+
+
+# [1.0.0-beta.14](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.13...@appium/relaxed-caps-plugin@1.0.0-beta.14) (2022-12-14)
+
+- chore!: set engines to minimum Node.js v14.17.0 ([a1dbe6c](https://github.com/appium/appium/commit/a1dbe6c43efe76604943a607d402f4c8b864d652))
+
+### Features
+
+- experimental support for typedoc generation ([4746080](https://github.com/appium/appium/commit/4746080e54ed8bb494cbc7c6ce83db503bf6bb52))
+
+### BREAKING CHANGES
+
+- Appium now supports version range `^14.17.0 || ^16.13.0 || >=18.0.0`
+
+# [1.0.0-beta.13](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.12...@appium/relaxed-caps-plugin@1.0.0-beta.13) (2022-10-13)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.12](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.11...@appium/relaxed-caps-plugin@1.0.0-beta.12) (2022-09-07)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.11](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.10...@appium/relaxed-caps-plugin@1.0.0-beta.11) (2022-08-03)
+
+### Bug Fixes
+
+- **appium,base-driver,base-plugin,doctor,docutils,eslint-config-appium,execute-driver-plugin,fake-driver,fake-plugin,gulp-plugins,images-plugin,opencv,relaxed-caps-plugin,schema,support,test-support,types,universal-xml-plugin:** update engines ([d8d2382](https://github.com/appium/appium/commit/d8d2382327ba7b7db8a4d1cad987c0e60184c92d))
+
+# [1.0.0-beta.10](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.9...@appium/relaxed-caps-plugin@1.0.0-beta.10) (2022-07-28)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.9](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.8...@appium/relaxed-caps-plugin@1.0.0-beta.9) (2022-06-01)
+
+### Bug Fixes
+
+- **execute-driver-plugin,fake-plugin,images-plugin,relaxed-caps-plugin,universal-xml-plugin:** ensure babel runtime is present ([df64612](https://github.com/appium/appium/commit/df64612d98c35fd64219816269f83f628e538fe2))
+
+# [1.0.0-beta.8](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.7...@appium/relaxed-caps-plugin@1.0.0-beta.8) (2022-05-31)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.7](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.6...@appium/relaxed-caps-plugin@1.0.0-beta.7) (2022-05-31)
+
+### Bug Fixes
+
+- **appium:** fix extension autoinstall postinstall script ([3e2c05d](https://github.com/appium/appium/commit/3e2c05d8a290072484afde34fe5fd968618f6359)), closes [#16924](https://github.com/appium/appium/issues/16924)
+- **relaxed-caps-plugin:** export RelaxedCapsPlugin class ([d09c915](https://github.com/appium/appium/commit/d09c915dadef0e30e9282ae8f1e0ee7fc01963c0)), closes [#16981](https://github.com/appium/appium/issues/16981)
+
+### Features
+
+- **relaxed-caps-plugin:** use peer deps ([a98e0e8](https://github.com/appium/appium/commit/a98e0e8201d5a1e4c4d21ee3e834646338117dde))
+
+### BREAKING CHANGES
+
+- **relaxed-caps-plugin:** `@appium/relaxed-caps-plugin` now expects to be installed alongside `appium`.
+
+# [1.0.0-beta.6](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.5...@appium/relaxed-caps-plugin@1.0.0-beta.6) (2022-05-02)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.5](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.4...@appium/relaxed-caps-plugin@1.0.0-beta.5) (2022-04-20)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# [1.0.0-beta.4](https://github.com/appium/appium/compare/@appium/relaxed-caps-plugin@1.0.0-beta.3...@appium/relaxed-caps-plugin@1.0.0-beta.4) (2022-04-20)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin
+
+# 1.0.0-beta.3 (2022-04-20)
+
+**Note:** Version bump only for package @appium/relaxed-caps-plugin

package/src/resources/submodules/appium/packages/relaxed-caps-plugin/README.md

@@ -0,0 +1,35 @@
+# @appium/relaxed-caps-plugin
+
+> Appium plugin for handling extension capabilities with no prefix
+
+[![NPM version](http://img.shields.io/npm/v/@appium/relaxed-caps-plugin.svg)](https://npmjs.org/package/@appium/relaxed-caps-plugin)
+[![Downloads](http://img.shields.io/npm/dm/@appium/relaxed-caps-plugin.svg)](https://npmjs.org/package/@appium/relaxed-caps-plugin)
+
+Appium conforms to the W3C WebDriver Protocol [requirements for capabilities](https://www.w3.org/TR/webdriver/#capabilities),
+which means that all non-standard (extension) capabilities used with Appium must have a prefix
+(usually this prefix is `appium:`). Any non-standard capabilities without a prefix are rejected.
+
+This plugin can be used to automatically add the `appium:` prefix to non-standard capabilities that
+do not have a prefix.
+
+## Motivation
+
+There are a lot of test scripts out there that don't conform to the W3C capability requirements,
+so this plugin is designed to make it easy to keep running these scripts even with the stricter
+capability requirements since Appium 2.
+
+## Installation
+
+```
+appium plugin install relaxed-caps
+```
+
+The plugin must be explicitly activated when launching the Appium server:
+
+```
+appium --use-plugins=relaxed-caps
+```
+
+## License
+
+Apache-2.0

package/src/resources/submodules/appium/packages/schema/CHANGELOG.md

@@ -0,0 +1,271 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.0.0](https://github.com/appium/appium/compare/@appium/schema@1.0.0-rc.1...@appium/schema@1.0.0) (2025-08-18)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [1.0.0-rc.1](https://github.com/appium/appium/compare/@appium/schema@0.8.1...@appium/schema@1.0.0-rc.1) (2025-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* set minimum Node.js version to v20.19.0 (#21394)
+
+### Miscellaneous Chores
+
+* set minimum Node.js version to v20.19.0 ([#21394](https://github.com/appium/appium/issues/21394)) ([37e22c4](https://github.com/appium/appium/commit/37e22c4f9c9920cea3f340841ab1b7c60e3147e9))
+
+
+
+## [0.8.1](https://github.com/appium/appium/compare/@appium/schema@0.8.0...@appium/schema@0.8.1) (2025-02-20)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [0.8.0](https://github.com/appium/appium/compare/@appium/schema@0.7.1...@appium/schema@0.8.0) (2025-02-19)
+
+
+### Features
+
+* **appium:** Add a command line parameter to configure HTTP server request timeout ([#21003](https://github.com/appium/appium/issues/21003)) ([eb1b156](https://github.com/appium/appium/commit/eb1b156146bc338da9c6ded5a2c5beab22ac0ed8))
+
+
+
+## [0.7.1](https://github.com/appium/appium/compare/@appium/schema@0.7.0...@appium/schema@0.7.1) (2025-01-02)
+
+
+### Bug Fixes
+
+* Reduce linter warnings ([#20860](https://github.com/appium/appium/issues/20860)) ([65658cc](https://github.com/appium/appium/commit/65658ccbdde9144c45cb5aad6a9089a5d6f3a0a3))
+
+
+
+## [0.7.0](https://github.com/appium/appium/compare/@appium/schema@0.6.1...@appium/schema@0.7.0) (2024-10-15)
+
+
+### Features
+
+* **appium:** Make server graceful shutdown timeout configurable via command line args ([#20641](https://github.com/appium/appium/issues/20641)) ([5661888](https://github.com/appium/appium/commit/56618886ed007df3c28ce98beb4ff91bc47da2a2))
+
+
+
+## [0.6.1](https://github.com/appium/appium/compare/@appium/schema@0.6.0...@appium/schema@0.6.1) (2024-06-11)
+
+
+### Bug Fixes
+
+* **schema:** edit a comment in order to trigger a publish ([45cc948](https://github.com/appium/appium/commit/45cc9486711b6100e78317c9dd7fb4f65a41d1eb))
+
+
+
+## [0.6.0](https://github.com/appium/appium/compare/@appium/schema@0.5.0...@appium/schema@0.6.0) (2024-06-10)
+
+
+### Features
+
+* **appium:** Add a possibility to print logs in json format ([#20224](https://github.com/appium/appium/issues/20224)) ([1e86537](https://github.com/appium/appium/commit/1e86537e944f6beb7dbe72b35c267ae1dd9ebd36))
+
+
+
+## [0.5.0](https://github.com/appium/appium/compare/@appium/schema@0.4.2...@appium/schema@0.5.0) (2023-12-18)
+
+
+### Features
+
+* **appium:** Load drivers and plugins asynchronously ([#19512](https://github.com/appium/appium/issues/19512)) ([06e7f34](https://github.com/appium/appium/commit/06e7f3489dff820fa16b16e47417acd0c10e0b05))
+
+
+### Bug Fixes
+
+* **appium:** Respect the value of no-perms-check server arg ([#19518](https://github.com/appium/appium/issues/19518)) ([22ca747](https://github.com/appium/appium/commit/22ca74710718ddeda0526acd9dd3dd1703001e22))
+* **docutils:** remove `@appium/typedoc-plugin-appium` and all other uses of `typedoc` ([#19465](https://github.com/appium/appium/issues/19465)) ([7528fcf](https://github.com/appium/appium/commit/7528fcf890f79f4017f5e718bb1952bf907ee479))
+
+
+
+## [0.4.2](https://github.com/appium/appium/compare/@appium/schema@0.4.1...@appium/schema@0.4.2) (2023-11-14)
+
+
+### Bug Fixes
+
+* **support:** update definitelytyped ([5ae8df3](https://github.com/appium/appium/commit/5ae8df3c36c7f03fbf3420087b532086f6742348))
+
+
+
+## [0.4.1](https://github.com/appium/appium/compare/@appium/schema@0.4.0...@appium/schema@0.4.1) (2023-10-19)
+
+
+### Bug Fixes
+
+* **support:** update definitelytyped ([a306ce7](https://github.com/appium/appium/commit/a306ce741a806d21bc44f3b979803b8af5da99aa))
+
+
+
+## [0.4.0](https://github.com/appium/appium/compare/@appium/schema@0.3.1...@appium/schema@0.4.0) (2023-10-18)
+
+
+### Features
+
+* **base-driver:** Add server support of TLS and SPDY protocols ([#19105](https://github.com/appium/appium/issues/19105)) ([5926919](https://github.com/appium/appium/commit/5926919177e3df675723c80d800f933fdbda5824))
+
+
+### Bug Fixes
+
+* **support:** update definitelytyped ([b6a76ce](https://github.com/appium/appium/commit/b6a76ce91e2765c22f84e389b93f780e0b4490c0))
+
+
+
+## [0.3.1](https://github.com/appium/appium/compare/@appium/schema@0.3.0...@appium/schema@0.3.1) (2023-07-03)
+
+
+### Bug Fixes
+
+* **appium:** restrict address to ipv6/hostname ([#18824](https://github.com/appium/appium/issues/18824)) ([f09fbb6](https://github.com/appium/appium/commit/f09fbb64dce0e179a007f3a0ae9800e61fbe90eb)), closes [#18716](https://github.com/appium/appium/issues/18716)
+
+
+
+## [0.3.0](https://github.com/appium/appium/compare/@appium/schema@0.2.6...@appium/schema@0.3.0) (2023-06-14)
+
+
+### Features
+
+* **appium:** Allow to provide ipv6 addresses and handle broadcast addresses in logs ([#18674](https://github.com/appium/appium/issues/18674)) ([8f63dab](https://github.com/appium/appium/commit/8f63dabb5dca882e522026f243e3445f5418874b))
+
+
+### Bug Fixes
+
+* **schema:** update definitelytyped ([e967240](https://github.com/appium/appium/commit/e96724077ef2b5b8aae203856195f3bb8de56116))
+* **types:** fix broken appium config schema types, temporarily ([fd2c72f](https://github.com/appium/appium/commit/fd2c72fd886ecaaf0f6588a328ff8a268a54fb55))
+
+
+
+## [0.2.6](https://github.com/appium/appium/compare/@appium/schema@0.2.5...@appium/schema@0.2.6) (2023-03-08)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [0.2.5](https://github.com/appium/appium/compare/@appium/schema@0.2.4...@appium/schema@0.2.5) (2023-02-24)
+
+
+### Bug Fixes
+
+* **schema:** move output files due to tsc's confusion ([943dce5](https://github.com/appium/appium/commit/943dce5eec4c047073ef9dfcb97da9ccd6be9459))
+
+
+
+
+
+## [0.2.4](https://github.com/appium/appium/compare/@appium/schema@0.2.3...@appium/schema@0.2.4) (2023-02-09)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [0.2.3](https://github.com/appium/appium/compare/@appium/schema@0.2.2...@appium/schema@0.2.3) (2023-01-13)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [0.2.2](https://github.com/appium/appium/compare/@appium/schema@0.2.1...@appium/schema@0.2.2) (2023-01-13)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+## [0.2.1](https://github.com/appium/appium/compare/@appium/schema@0.2.0...@appium/schema@0.2.1) (2023-01-13)
+
+**Note:** Version bump only for package @appium/schema
+
+
+
+
+
+# [0.2.0](https://github.com/appium/appium/compare/@appium/schema@0.1.0...@appium/schema@0.2.0) (2023-01-13)
+
+
+### Features
+
+* **typedoc-appium-plugin:** implement cross-referencing of methods ([8b33414](https://github.com/appium/appium/commit/8b334149018f7d49448da9e7982356c72bcd468e))
+
+
+
+
+
+# [0.1.0](https://github.com/appium/appium/compare/@appium/schema@0.0.9...@appium/schema@0.1.0) (2022-12-14)
+
+### Bug Fixes
+
+- **schema:** add definition for log filters ([09c5901](https://github.com/appium/appium/commit/09c59017193b0fd839e41e44400872ab592d177a))
+
+- chore!: set engines to minimum Node.js v14.17.0 ([a1dbe6c](https://github.com/appium/appium/commit/a1dbe6c43efe76604943a607d402f4c8b864d652))
+
+### Features
+
+- experimental support for typedoc generation ([4746080](https://github.com/appium/appium/commit/4746080e54ed8bb494cbc7c6ce83db503bf6bb52))
+- **schema:** allow root $schema prop ([726a7e1](https://github.com/appium/appium/commit/726a7e10deadcc8150a549fb853fbf5cca033248))
+
+### BREAKING CHANGES
+
+- Appium now supports version range `^14.17.0 || ^16.13.0 || >=18.0.0`
+
+## [0.0.9](https://github.com/appium/appium/compare/@appium/schema@0.0.8...@appium/schema@0.0.9) (2022-08-03)
+
+### Bug Fixes
+
+- **appium,base-driver,base-plugin,doctor,docutils,eslint-config-appium,execute-driver-plugin,fake-driver,fake-plugin,gulp-plugins,images-plugin,opencv,relaxed-caps-plugin,schema,support,test-support,types,universal-xml-plugin:** update engines ([d8d2382](https://github.com/appium/appium/commit/d8d2382327ba7b7db8a4d1cad987c0e60184c92d))
+
+## [0.0.8](https://github.com/appium/appium/compare/@appium/schema@0.0.7...@appium/schema@0.0.8) (2022-07-28)
+
+### Bug Fixes
+
+- **schema:** add json-schema as a production dep ([921fb1c](https://github.com/appium/appium/commit/921fb1c3829f48e192d7887dc521c13f0b461068))
+- **schema:** add missing @types/json-schema dep ([6fde920](https://github.com/appium/appium/commit/6fde92052b28f5bd25df922b6fdc3cc9aecb41a6))
+
+## [0.0.7](https://github.com/appium/appium/compare/@appium/schema@0.0.6...@appium/schema@0.0.7) (2022-05-31)
+
+**Note:** Version bump only for package @appium/schema
+
+## [0.0.6](https://github.com/appium/appium/compare/@appium/schema@0.0.5...@appium/schema@0.0.6) (2022-05-31)
+
+### Bug Fixes
+
+- **appium:** fix extension autoinstall postinstall script ([3e2c05d](https://github.com/appium/appium/commit/3e2c05d8a290072484afde34fe5fd968618f6359)), closes [#16924](https://github.com/appium/appium/issues/16924)
+
+## [0.0.5](https://github.com/appium/appium/compare/@appium/schema@0.0.4...@appium/schema@0.0.5) (2022-04-20)
+
+**Note:** Version bump only for package @appium/schema
+
+## [0.0.4](https://github.com/appium/appium/compare/@appium/schema@0.0.3...@appium/schema@0.0.4) (2022-04-20)
+
+**Note:** Version bump only for package @appium/schema
+
+## [0.0.3](https://github.com/appium/appium/compare/@appium/schema@0.0.2...@appium/schema@0.0.3) (2022-04-20)
+
+**Note:** Version bump only for package @appium/schema
+
+## [0.0.2](https://github.com/appium/appium/compare/@appium/schema@0.0.1...@appium/schema@0.0.2) (2022-04-12)
+
+**Note:** Version bump only for package @appium/schema
+
+## 0.0.1 (2022-04-07)
+
+**Note:** Version bump only for package @appium/schema

package/src/resources/submodules/appium/packages/schema/README.md

@@ -0,0 +1,50 @@
+# @appium/schema
+
+> JSON schema for [Appium](https://github.com/appium/appium) configuration files
+
+## Description
+
+This package is used internally by Appium, but can also be used to validate Appium configuration files in other contexts.
+
+## Install
+
+```bash
+npm i @appium/schema
+```
+
+## Usage
+
+The schema is exported as a JS object:
+
+```js
+const { AppiumConfigJsonSchema } = require('@appium/schema');
+```
+
+It is also provided as a JSON file (since this is a JSON schema, after all):
+
+```js
+const schema = require('@appium/schema/lib/appium-config.schema.json');
+```
+
+## See Also
+
+[@appium/types](https://npm.im/@appium/types) exports a TypeScript type `AppiumConfig` (generated from this package) for typesafe configuration objects; this may be useful if your Appium configuration is written in JS (e.g., `.appiumrc.js`). Example:
+
+```js
+// @ts-check
+/** @type {import('@appium/types').AppiumConfig} */
+module.exports = {
+  server: {
+    port: 1234,
+    host: '127.0.0.1'
+  }
+}
+```
+
+## Notes
+
+`lib/appium-config.schema.json` is generated by this package from `lib/appium-config-schema.js` (the single source of truth), but is under version control to avoid chicken-or-egg build problems.
+
+## License
+
+Apache-2.0

package/src/resources/submodules/appium/packages/storage-plugin/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.0.2](https://github.com/appium/appium/compare/@appium/storage-plugin@1.0.1...@appium/storage-plugin@1.0.2) (2025-10-08)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## [1.0.1](https://github.com/appium/appium/compare/@appium/storage-plugin@1.0.0...@appium/storage-plugin@1.0.1) (2025-09-09)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## [1.0.0](https://github.com/appium/appium/compare/@appium/storage-plugin@1.0.0-rc.1...@appium/storage-plugin@1.0.0) (2025-08-18)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## 1.0.0-rc.1 (2025-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* set minimum Node.js version to v20.19.0 (#21394)
+
+### Miscellaneous Chores
+
+* set minimum Node.js version to v20.19.0 ([#21394](https://github.com/appium/appium/issues/21394)) ([37e22c4](https://github.com/appium/appium/commit/37e22c4f9c9920cea3f340841ab1b7c60e3147e9))
+
+
+
+## [0.1.3](https://github.com/appium/appium/compare/@appium/storage-plugin@0.1.2...@appium/storage-plugin@0.1.3) (2025-06-01)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## [0.1.2](https://github.com/appium/appium/compare/@appium/storage-plugin@0.1.1...@appium/storage-plugin@0.1.2) (2025-04-25)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## [0.1.1](https://github.com/appium/appium/compare/@appium/storage-plugin@0.1.0...@appium/storage-plugin@0.1.1) (2025-03-17)
+
+**Note:** Version bump only for package @appium/storage-plugin
+
+
+
+
+
+## 0.1.0 (2025-03-11)
+
+
+### Features
+
+* Add storage plugin ([#21075](https://github.com/appium/appium/issues/21075)) ([ba4aa39](https://github.com/appium/appium/commit/ba4aa394d1b6676cc29644e7faa3b0590552f303))
+* **storage-plugin:** Tune the files keeping behaviour ([#21086](https://github.com/appium/appium/issues/21086)) ([15280b8](https://github.com/appium/appium/commit/15280b80d2af6b3bdf6bf2905472b05b7bca1c1d))

package/src/resources/submodules/appium/packages/storage-plugin/README.md

@@ -0,0 +1,83 @@
+# @appium/storage-plugin
+
+> Appium plugin for server-side file storage
+
+This plugin adds the ability to create a dedicated storage space on the server side,
+which can be managed from the client side. This can be useful for files like application packages.
+Only one storage may exist per server process, shared by all testing sessions.
+
+> [!WARNING]
+> This plugin is designed to be used with servers deployed in private networks.
+> Consider validating the setup with your security department
+> if you want to enable this plugin at a public Appium server deployment.
+
+## Installation
+
+```bash
+appium plugin install storage
+```
+
+## Usage
+
+Add the plugin name to the list of plugins to use upon server startup:
+
+```bash
+appium --use-plugins=storage
+```
+
+By default, the plugin creates a new temporary folder where it manages uploaded files.
+
+[Refer to the Appium documentation for the endpoints supported by this plugin.](https://appium.io/docs/en/latest/reference/api/storage-plugin/)
+
+### Storing a File
+
+The procedure for storing a local file on the Appium server is as follows:
+
+- Calculate the [SHA1](https://en.wikipedia.org/wiki/SHA-1) hash of the source file
+- Decide the name of the destination file in the server storage (it can be the same as the original file name)
+- Send a `POST` request to the `/storage/add` endpoint, which will return the `events` and `stream` websocket paths
+- Connect to both web sockets
+- Start listening for messages on the `events` web socket. Each message there is a JSON object wrapped
+  to a string. The message must be either `{"value": {"success": true, "name":"app.ipa","sha1":"ccc963411b2621335657963322890305ebe96186"}}` to notify about a successful
+  file upload, or `{"value": {"error": "<error signature>", "message": "<error message>", "traceback": "<server traceback>"}}`
+  to notify about any exceptions during the upload process.
+- Start reading the source file into small chunks. The recommended size of a single chunk is 64 KB.
+- After each chunk is retrieved, pass it to the `stream` web socket.
+- After the last chunk upload is completed, either close the `stream` web
+  socket to explicitly notify the server about the upload completion, or
+  wait until the success event is delivered from the `events` web socket
+  as soon as file hashes successfully match.
+  The server must always deliver either a success or a failure
+  event via the `events` web socket as described above.
+
+It is also possible to upload multiple files in parallel (up to 20 jobs are supported).
+Only flat files hierarchies are supported in the storage, no subfolders are allowed.
+If a file with the same name already exists in the storage, it will be overridden with the new one.
+If a folder with the same name already exists in the storage, an error will be thrown.
+
+### Environment Variables
+
+#### APPIUM_STORAGE_ROOT
+
+It is also possible to customize the repository root folder path by assigning a custom path to the
+`APPIUM_STORAGE_ROOT` environment variable upon server startup. The plugin automatically deletes the
+root folder recursively upon server process termination, unless the server is
+killed forcefully. If `APPIUM_STORAGE_ROOT` points to an existing folder,
+then all files there are going to be preserved by default unless a different behavior is
+requested by [APPIUM_STORAGE_KEEP_ALL](#appium_storage_keep_all) environment variable value.
+
+#### APPIUM_STORAGE_KEEP_ALL
+
+If this environment variable is set to `true`, `1` or `yes` then the plugin will always keep
+storage files after the server process is terminated. All other
+values of this variable enforce the plugin to always delete all files
+from the storage folder.
+
+## Examples
+
+Check [integration tests](./test/e2e/storage.e2e.spec.cjs) for a working
+[WebdriverIO](https://webdriver.io/) example.
+
+## License
+
+Apache-2.0