import type { Options } from '@wdio/types'
import { shared } from './wdio.shared.conf'

const deviceName = process.env.APPIUM_DEVICE_NAME ?? 'iPhone 16'
const udid = process.env.APPIUM_UDID
const derivedDataPath = process.env.APPIUM_DERIVED_DATA_PATH
const usePrebuiltWDA = process.env.APPIUM_USE_PREBUILT_WDA === 'true'

/**
 * Drives real Mobile Safari in the iOS Simulator via Appium's XCUITest driver.
 * Touch gestures are performed in the NATIVE context (see helpers/pinch.ts),
 * which is the only place multi-touch W3C actions work on iOS — they go through
 * the real Simulator touch system and therefore through Safari's own gesture
 * recognizer.
 */
export const config: Options.Testrunner = {
	...shared,
	capabilities: [
		{
			platformName: 'iOS',
			'appium:automationName': 'XCUITest',
			'appium:deviceName': deviceName,
			// Attach to the simulator CI already booted (see the Boot step), so
			// XCUITest doesn't create/boot one itself.
			...(udid ? { 'appium:udid': udid } : {}),
			// Pin platformVersion in CI to the runtime shipped by the macos-26 image
			// if you need determinism; left unset here to use the booted default.
			browserName: 'Safari',
			'appium:safariInitialUrl': `${shared.baseUrl}/end-to-end`,
			'appium:newCommandTimeout': 120,
			// Let Appium own the simulator lifecycle (create/boot the one it uses).
			// Don't pre-boot in CI — a second simulator just causes boot contention.
			'appium:noReset': true,
			// First run builds WebDriverAgent from source, which is slow on a cold
			// CI simulator. Give the build/launch generous headroom (no signing is
			// needed on the simulator, so this is just time, not config).
			'appium:wdaLaunchTimeout': 300_000,
			'appium:wdaConnectionTimeout': 300_000,
			'appium:wdaStartupRetries': 2,
			'appium:wdaStartupRetryInterval': 20_000,
			'appium:showXcodeLog': false,
			// Build WDA into a stable, cacheable DerivedData dir; on a CI cache hit
			// reuse the prebuilt WDA and skip the xcodebuild step entirely.
			...(derivedDataPath ? { 'appium:derivedDataPath': derivedDataPath } : {}),
			...(usePrebuiltWDA ? { 'appium:usePrebuiltWDA': true } : {}),
		},
	],
}