feat: Migrate the module to typescript

[mykola-mokhnach]

BREAKING CHANGE: Removed the deprecated xcodeVersion argument from WebDriverAgent constructor
BREAKING CHANGE: Removed the deprecated xcodeVersion argument from XcodeBuild constructor
BREAKING CHANGE: Removed the deprecated idb property from WebDriverAgent class
BREAKING CHANGE: Removed the noop checkForDependencies export from index

• All .js modules were migrated to TypeScript
• Module scripts were migrated to ESM/.mjs
• All private WebDriverAgent and XcodeBuild methods and properties were marked as such

[Copilot]

Pull request overview

This PR migrates the appium-webdriveragent module from JavaScript to TypeScript, introducing several breaking changes by removing deprecated functionality. The migration includes updating all source files to TypeScript, converting utility scripts to ESM modules (.mjs format), and marking private methods and properties appropriately for better encapsulation.

Key changes:

• Complete TypeScript migration with proper type annotations and interfaces
• Removed deprecated parameters: xcodeVersion from WebDriverAgent and XcodeBuild constructors, idb property from WebDriverAgent
• Removed deprecated checkForDependencies export from the public API
• Scripts converted to ESM format (.mjs) with proper import.meta.url usage

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
test/unit/webdriveragent-specs.ts	Updated test constructor calls to remove xcodeVersion parameter; added type casts for private method access
test/functional/webdriveragent-e2e-specs.ts	Removed xcodeVersion imports and usage; updated constructors and private method access
test/functional/helpers/simulator.ts	Removed CLOUD environment variable checks
package.json	Updated script references from .js to .mjs for build and utility scripts
lib/xcodebuild.ts	Migrated to TypeScript with proper types; removed xcodeVersion parameter; marked private methods; reorganized method order
lib/webdriveragent.ts	Migrated to TypeScript; removed deprecated idb property and xcodeVersion parameter; converted many methods to private; added xcodebuild getter with error handling
lib/utils.ts	Converted to TypeScript with typed exports; refactored for ESM compatibility with __filename/__dirname handling
lib/no-session-proxy.ts	Migrated to TypeScript with proper ProxyOptions typing and override keyword
lib/logger.ts	New TypeScript file replacing logger.js with named export
lib/constants.ts	New TypeScript file with const exports replacing .js version
lib/check-dependencies.ts	Migrated to TypeScript; removed deprecated checkForDependencies function
index.ts	Updated to remove checkForDependencies export per breaking change
Scripts/update-wda-version.mjs	Converted to ESM with proper import statements
Scripts/fetch-prebuilt-wda.mjs	Converted to ESM with import.meta.url for module detection
Scripts/build-webdriveragent.mjs	Converted to ESM with proper import statements and module detection

Comments suppressed due to low confidence (3)

lib/webdriveragent.ts:292

• The logic in this method is inverted. The documentation states it returns true if the source is fresh (all required files exist), but the implementation returns true when at least one file does NOT exist (using some((v) => v === false)). This should use every((v) => v === true) instead to correctly return true when all files exist, or the documentation should be corrected to match the actual behavior.
  lib/webdriveragent.ts:597
• Spelling error: "hovewer" should be "however".
  lib/webdriveragent.ts:621
• Spelling error: "clenup" should be "cleanup".

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

🎉 This PR is included in version 11.0.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀