[Detox Patch] Add support for autoGrantPermissions capability (AAP-20840)

[vvHacker007]

What

Adds autoGrantPermissions to the cloud session capabilities, mirroring the local-testing caps addition (ff319fa / original PR #7):

• detox/src/configuration/index.js — forward the cap in the websocket ?caps= query
• detox/src/configuration/composeSessionConfig.js — add to cloudSupportedCaps (no "not honoured" warning) + boolean validation
• detox/detox.d.ts — type for session.autoGrantPermissions

Usage:

session: {
  server: 'wss://detox.browserstack.com/init',
  autoGrantPermissions: true,
}

Why

JIRA: AAP-20840 — Detox has no Appium driver to honour autoGrantPermissions, and Android Detox exposes no permissions API of its own, so runtime-permission dialogs currently block Detox tests on BrowserStack. The platform side now pre-grants the app's requested permissions at session start when this capability is set:

• SeleniumHub: https://github.com/browserstack/SeleniumHub/pull/14389 (forwards cap to fire_cmd)
• mobile: https://github.com/browserstack/mobile/pull/13923 (grants via the existing Flutter pm grant engine)

Without this client change the capability is silently dropped on the customer's machine (the caps query is built from a fixed whitelist), so this PR is the customer-facing enabler.

Testing

Verified end-to-end on devdas staging with exactly this patch applied to the installed 20.51.3 client (same device/host/app across runs, OnePlus 11R / Android 13):

• cap set + platform fix: CAMERA / RECORD_AUDIO / LOCATION granted at session start (~0.33s), no permission dialogs — session d255d75a90064296f27ce9de8ac421f317b3af1f
• cap set, old platform: ignored (baseline) — session 41b7394a0fc8ceaf7229b9f3ff775f05e3b58f51
• cap not set: nothing granted (gate verified)

Note

Needs an npm republish of the patched package after merge for customers to pick it up.

🤖 Generated with Claude Code