@qawolf/run-globals-ios 0.0.18

package/dist/typings.d.ts

@@ -0,0 +1,773 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { Browser } from 'webdriverio';
+import { z } from 'zod';
+
+declare const SpeakerRecordingSessionSchema: z.ZodObject<{
+	id: z.ZodString;
+	status: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Represents an active speaker recording session
+ */
+export type SpeakerRecordingSession = z.input<typeof SpeakerRecordingSessionSchema>;
+declare const SpeakerRecordingFileSchema: z.ZodObject<{
+	filename: z.ZodString;
+	fingerprint: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+	duration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Represents a recorded audio file with optional fingerprint data
+ */
+export type SpeakerRecordingFile = z.input<typeof SpeakerRecordingFileSchema>;
+declare const AudioFingerprintSchema: z.ZodObject<{
+	fingerprint: z.ZodArray<z.ZodNumber>;
+	duration: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Represents the audio fingerprint calculation result
+ */
+export type AudioFingerprint = z.input<typeof AudioFingerprintSchema>;
+/**
+ * Start audio recording on the iOS device.
+ * This creates a new recording session and returns a session identifier
+ * that must be used to stop the recording.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @returns Promise resolving to the audio session information
+ * @example
+ * ```typescript
+ * const session = await ios.startSpeakerRecording(driver);
+ * console.log(`Recording started with session ID: ${session.id}`);
+ * ```
+ */
+export declare function startSpeakerRecording(driver: Browser): Promise<SpeakerRecordingSession>;
+/**
+ * Stop audio recording and finalize the audio file.
+ * This also calculates the audio fingerprint automatically.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param sessionId - The session ID returned from startRecording
+ * @returns Promise resolving to the audio file information including fingerprint
+ * @example
+ * ```typescript
+ * const file = await ios.stopSpeakerRecording(driver, session.id);
+ * console.log(`Recording saved to: ${file.filename}`);
+ * if (file.fingerprint) {
+ *   console.log(`Fingerprint has ${file.fingerprint.length} values`);
+ * }
+ * ```
+ */
+export declare function stopSpeakerRecording(driver: Browser, sessionId: string): Promise<SpeakerRecordingFile>;
+/**
+ * Download a recorded audio file as a Buffer.
+ * The audio file is returned in WAV format.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param filename - The filename returned from stopRecording
+ * @returns Promise resolving to the audio file contents as a Buffer
+ * @example
+ * ```typescript
+ * const audioBuffer = await ios.downloadSpeakerRecording(driver, file.filename);
+ * fs.writeFileSync('/tmp/recording.wav', audioBuffer);
+ * ```
+ */
+export declare function downloadSpeakerRecording(driver: Browser, filename: string): Promise<Buffer>;
+/**
+ * Calculate audio fingerprint from audio data.
+ * Accepts either a Buffer or base64-encoded string of WAV audio data.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param audioData - Audio data as Buffer or base64 string (WAV format)
+ * @returns Promise resolving to the fingerprint calculation result
+ * @example
+ * ```typescript
+ * const audioBuffer = fs.readFileSync('/tmp/reference.wav');
+ * const fingerprint = await ios.calculateAudioFingerprint(driver, audioBuffer);
+ * console.log(`Duration: ${fingerprint.duration}s`);
+ * console.log(`Fingerprint: ${fingerprint.fingerprint.slice(0, 10).join(', ')}...`);
+ * ```
+ */
+export declare function calculateAudioFingerprint(driver: Browser, audioData: Buffer | string): Promise<AudioFingerprint>;
+declare const PhotoAssetSchema: z.ZodObject<{
+	localIdentifier: z.ZodString;
+	mediaType: z.ZodString;
+	mediaSubtype: z.ZodString;
+	creationDate: z.ZodString;
+	modificationDate: z.ZodString;
+	pixelWidth: z.ZodNumber;
+	pixelHeight: z.ZodNumber;
+	duration: z.ZodNumber;
+	isFavorite: z.ZodBoolean;
+	isHidden: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Represents a photo or video asset in the Photos library
+ */
+export type PhotoAsset = z.input<typeof PhotoAssetSchema>;
+declare const SavePhotoResultSchema: z.ZodObject<{
+	success: z.ZodBoolean;
+	message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Result of saving a photo to the Photos library
+ */
+export type SavePhotoResult = z.input<typeof SavePhotoResultSchema>;
+declare const ListPhotosResultSchema: z.ZodObject<{
+	success: z.ZodBoolean;
+	assets: z.ZodArray<z.ZodObject<{
+		localIdentifier: z.ZodString;
+		mediaType: z.ZodString;
+		mediaSubtype: z.ZodString;
+		creationDate: z.ZodString;
+		modificationDate: z.ZodString;
+		pixelWidth: z.ZodNumber;
+		pixelHeight: z.ZodNumber;
+		duration: z.ZodNumber;
+		isFavorite: z.ZodBoolean;
+		isHidden: z.ZodBoolean;
+	}, z.core.$strip>>;
+	totalCount: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Result of listing photos from the Photos library
+ */
+export type ListPhotosResult = z.input<typeof ListPhotosResultSchema>;
+declare const DeletePhotosResultSchema: z.ZodObject<{
+	success: z.ZodBoolean;
+	deletedCount: z.ZodNumber;
+	message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Result of deleting all photos from the Photos library
+ */
+export type DeletePhotosResult = z.input<typeof DeletePhotosResultSchema>;
+/**
+ * Save an image file from the filesystem to the device Photos library.
+ * This function handles the entire workflow:
+ * 1. Reads the file from the filesystem
+ * 2. Pushes it to the device's app container
+ * 3. Saves it to Photos library via the iOS agent
+ * 4. Cleans up the temporary file from the device
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param filePath - Absolute path to the file on the filesystem
+ * @returns Promise resolving to the save operation result
+ * @example
+ * ```typescript
+ * const result = await ios.savePhoto(driver, '/Users/me/photo.jpg');
+ * if (result.success) {
+ *   console.log('Photo saved to library');
+ * }
+ * ```
+ */
+export declare function savePhoto(driver: Browser, filePath: string): Promise<SavePhotoResult>;
+/**
+ * List all photos and videos from the Photos library.
+ * Returns full protocol response with success status, assets array, and total count.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @returns Promise resolving to list result with assets and count
+ * @example
+ * ```typescript
+ * const result = await ios.listPhotos(driver);
+ * console.log(`Found ${result.totalCount} photos in library`);
+ * result.assets.forEach(asset => {
+ *   console.log(`${asset.mediaType}: ${asset.localIdentifier}`);
+ * });
+ * ```
+ */
+export declare function listPhotos(driver: Browser): Promise<ListPhotosResult>;
+/**
+ * Delete all photos and videos from the Photos library.
+ * This is useful for cleaning up test data between test runs.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @returns Promise resolving to delete result with count and message
+ * @example
+ * ```typescript
+ * const result = await ios.deleteAllPhotos(driver);
+ * console.log(`Deleted ${result.deletedCount} photos`);
+ * ```
+ */
+export declare function deleteAllPhotos(driver: Browser): Promise<DeletePhotosResult>;
+declare const ConfigurationProfileOptionsSchema: z.ZodObject<{
+	profileString: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Options for installing a configuration profile
+ */
+export type ConfigurationProfileOptions = z.input<typeof ConfigurationProfileOptionsSchema>;
+/**
+ * Install a configuration profile on the iOS device.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param profileString - The configuration profile plist string
+ * @returns A function to uninstall the configuration profile
+ * @example
+ * ```typescript
+ * const uninstall = await ios.installConfigurationProfile(driver, profilePlistString);
+ * // ... run your test ...
+ * await uninstall(); // Clean up after the test
+ * ```
+ */
+export declare function installConfigurationProfile(driver: Browser, profileString: string): Promise<() => Promise<unknown>>;
+declare const RouteTypeSchema: z.ZodEnum<{
+	direct: "direct";
+	"http-proxy": "http-proxy";
+	wireguard: "wireguard";
+	openvpn: "openvpn";
+	relay: "relay";
+}>;
+export type RouteType = z.infer<typeof RouteTypeSchema>;
+declare const TunnelStatusSchema: z.ZodEnum<{
+	down: "down";
+	starting: "starting";
+	up: "up";
+	error: "error";
+}>;
+export type TunnelStatus = z.infer<typeof TunnelStatusSchema>;
+declare const TunnelStateSchema: z.ZodObject<{
+	status: z.ZodEnum<{
+		down: "down";
+		starting: "starting";
+		up: "up";
+		error: "error";
+	}>;
+	interface: z.ZodOptional<z.ZodString>;
+	error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TunnelState = z.infer<typeof TunnelStateSchema>;
+declare const TunnelStatusMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+	status: z.ZodEnum<{
+		down: "down";
+		starting: "starting";
+		up: "up";
+		error: "error";
+	}>;
+	interface: z.ZodOptional<z.ZodString>;
+	error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type TunnelStatusMap = z.infer<typeof TunnelStatusMapSchema>;
+declare const HttpProxyTunnelSchema: z.ZodObject<{
+	type: z.ZodLiteral<"http-proxy">;
+	host: z.ZodString;
+	port: z.ZodNumber;
+	username: z.ZodOptional<z.ZodString>;
+	password: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HttpProxyTunnel = z.infer<typeof HttpProxyTunnelSchema>;
+declare const WireGuardTunnelSchema: z.ZodObject<{
+	type: z.ZodLiteral<"wireguard">;
+	configPath: z.ZodString;
+}, z.core.$strip>;
+export type WireGuardTunnel = z.infer<typeof WireGuardTunnelSchema>;
+declare const OpenVPNTunnelSchema: z.ZodObject<{
+	type: z.ZodLiteral<"openvpn">;
+	configPath: z.ZodString;
+}, z.core.$strip>;
+export type OpenVPNTunnel = z.infer<typeof OpenVPNTunnelSchema>;
+declare const TunnelConfigSchema: z.ZodUnion<readonly [
+	z.ZodObject<{
+		type: z.ZodLiteral<"direct">;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"http-proxy">;
+		host: z.ZodString;
+		port: z.ZodNumber;
+		username: z.ZodOptional<z.ZodString>;
+		password: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"wireguard">;
+		configPath: z.ZodString;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"openvpn">;
+		configPath: z.ZodString;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"relay">;
+		host: z.ZodString;
+		port: z.ZodNumber;
+		username: z.ZodString;
+		password: z.ZodString;
+		dialer: z.ZodOptional<z.ZodEnum<{
+			tls: "tls";
+			tcp: "tcp";
+		}>>;
+		secure: z.ZodOptional<z.ZodBoolean>;
+	}, z.core.$strip>
+]>;
+export type TunnelConfig = z.infer<typeof TunnelConfigSchema>;
+declare const RouteTrafficConfigSchema: z.ZodObject<{
+	apps: z.ZodArray<z.ZodString>;
+	domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	tunnel: z.ZodUnion<readonly [
+		z.ZodObject<{
+			type: z.ZodLiteral<"direct">;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			type: z.ZodLiteral<"http-proxy">;
+			host: z.ZodString;
+			port: z.ZodNumber;
+			username: z.ZodOptional<z.ZodString>;
+			password: z.ZodOptional<z.ZodString>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			type: z.ZodLiteral<"wireguard">;
+			configPath: z.ZodString;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			type: z.ZodLiteral<"openvpn">;
+			configPath: z.ZodString;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			type: z.ZodLiteral<"relay">;
+			host: z.ZodString;
+			port: z.ZodNumber;
+			username: z.ZodString;
+			password: z.ZodString;
+			dialer: z.ZodOptional<z.ZodEnum<{
+				tls: "tls";
+				tcp: "tcp";
+			}>>;
+			secure: z.ZodOptional<z.ZodBoolean>;
+		}, z.core.$strip>
+	]>;
+	socksHost: z.ZodOptional<z.ZodString>;
+	socksPort: z.ZodOptional<z.ZodNumber>;
+	inspect: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RouteTrafficConfig = z.infer<typeof RouteTrafficConfigSchema>;
+declare const NetworkStatusSchema: z.ZodObject<{
+	route: z.ZodEnum<{
+		direct: "direct";
+		"http-proxy": "http-proxy";
+		wireguard: "wireguard";
+		openvpn: "openvpn";
+		relay: "relay";
+	}>;
+	tunnels: z.ZodRecord<z.ZodString, z.ZodObject<{
+		status: z.ZodEnum<{
+			down: "down";
+			starting: "starting";
+			up: "up";
+			error: "error";
+		}>;
+		interface: z.ZodOptional<z.ZodString>;
+		error: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>>;
+	routingTables: z.ZodOptional<z.ZodObject<{
+		activeTable: z.ZodString;
+		tables: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+	}, z.core.$strip>>;
+	traffic: z.ZodOptional<z.ZodObject<{
+		routes: z.ZodRecord<z.ZodString, z.ZodObject<{
+			packets: z.ZodNumber;
+			bytes: z.ZodNumber;
+		}, z.core.$strip>>;
+		interfaces: z.ZodRecord<z.ZodString, z.ZodObject<{
+			rxPackets: z.ZodNumber;
+			txPackets: z.ZodNumber;
+			rxBytes: z.ZodNumber;
+			txBytes: z.ZodNumber;
+		}, z.core.$strip>>;
+	}, z.core.$strip>>;
+	vpnApp: z.ZodObject<{
+		bundleId: z.ZodString;
+		installed: z.ZodBoolean;
+		pid: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$strip>;
+	routedApps: z.ZodArray<z.ZodString>;
+	routedDomains: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type NetworkStatus = z.infer<typeof NetworkStatusSchema>;
+export declare const NetworkConditionConfigSchema: z.ZodObject<{
+	bandwidthKbps: z.ZodOptional<z.ZodNumber>;
+	latencyMs: z.ZodOptional<z.ZodNumber>;
+	jitterMs: z.ZodOptional<z.ZodNumber>;
+	packetLossPercent: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type NetworkConditionConfig = z.infer<typeof NetworkConditionConfigSchema>;
+/** 2G EDGE: ~240 Kbps, 300ms latency, high jitter */
+export declare const NETWORK_2G_EDGE: {
+	readonly bandwidthKbps: 240;
+	readonly latencyMs: 300;
+	readonly jitterMs: 100;
+	readonly packetLossPercent: 1.5;
+};
+/** 3G: ~1.8 Mbps, 100ms latency */
+export declare const NETWORK_3G: {
+	readonly bandwidthKbps: 1800;
+	readonly latencyMs: 100;
+	readonly jitterMs: 30;
+	readonly packetLossPercent: 0.5;
+};
+/** 4G LTE: ~12 Mbps, 30ms latency */
+export declare const NETWORK_4G_LTE: {
+	readonly bandwidthKbps: 12000;
+	readonly latencyMs: 30;
+	readonly jitterMs: 10;
+	readonly packetLossPercent: 0.1;
+};
+/** 5G: ~100 Mbps, 10ms latency */
+export declare const NETWORK_5G: {
+	readonly bandwidthKbps: 100000;
+	readonly latencyMs: 10;
+	readonly jitterMs: 3;
+	readonly packetLossPercent: 0.01;
+};
+/** Satellite: ~5 Mbps, 600ms latency */
+export declare const NETWORK_SATELLITE: {
+	readonly bandwidthKbps: 5000;
+	readonly latencyMs: 600;
+	readonly jitterMs: 50;
+	readonly packetLossPercent: 1;
+};
+/** Congested WiFi: ~2 Mbps, 50ms latency, high jitter and packet loss */
+export declare const NETWORK_WIFI_CONGESTED: {
+	readonly bandwidthKbps: 2000;
+	readonly latencyMs: 50;
+	readonly jitterMs: 40;
+	readonly packetLossPercent: 3;
+};
+/** Very bad network: ~100 Kbps, 500ms latency, extreme jitter and packet loss */
+export declare const NETWORK_VERY_BAD: {
+	readonly bandwidthKbps: 100;
+	readonly latencyMs: 500;
+	readonly jitterMs: 200;
+	readonly packetLossPercent: 10;
+};
+/** Offline: 100% packet loss — drops all packets to simulate no connectivity */
+export declare const NETWORK_OFFLINE: {
+	readonly packetLossPercent: 100;
+};
+export declare const NetworkConditionStatusSchema: z.ZodObject<{
+	enabled: z.ZodBoolean;
+	config: z.ZodOptional<z.ZodObject<{
+		bandwidthKbps: z.ZodOptional<z.ZodNumber>;
+		latencyMs: z.ZodOptional<z.ZodNumber>;
+		jitterMs: z.ZodOptional<z.ZodNumber>;
+		packetLossPercent: z.ZodOptional<z.ZodNumber>;
+	}, z.core.$strip>>;
+	interface: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type NetworkConditionStatus = z.infer<typeof NetworkConditionStatusSchema>;
+/**
+ * Get the current network routing status via the Appium server's sessionless endpoint.
+ *
+ * Appium URL is resolved from APPIUM_HOST / APPIUM_PORT env vars (default 127.0.0.1:4723).
+ *
+ * @returns Combined network status
+ */
+export declare function getNetworkStatus(): Promise<NetworkStatus>;
+/** A recorded network entry from GOST MITM inspection */
+export interface RecordedEntry {
+	service: string;
+	network: string;
+	remote?: string;
+	local?: string;
+	host?: string;
+	proto?: string;
+	http?: {
+		host: string;
+		method: string;
+		proto: string;
+		scheme: string;
+		uri: string;
+		statusCode: number;
+		request?: {
+			contentLength: number;
+			header: Record<string, string[]>;
+			body: string | null;
+		};
+		response?: {
+			contentLength: number;
+			header: Record<string, string[]>;
+			body: string | null;
+		};
+	};
+	websocket?: {
+		from: string;
+		fin: boolean;
+		rsv1: boolean;
+		rsv2: boolean;
+		rsv3: boolean;
+		opcode: number;
+		masked: boolean;
+		maskKey: number;
+		length: number;
+		payload: string;
+	};
+	tls?: {
+		serverName: string;
+		cipherSuite: string;
+		version: string;
+		proto?: string;
+	};
+	dns?: {
+		id: number;
+		name: string;
+		class: string;
+		type: string;
+		question: string;
+		answer: string;
+		cached: boolean;
+	};
+	sid: string;
+	time: string;
+	duration: number;
+}
+type NetworkLogHandler = (entry: RecordedEntry) => void;
+export interface NetworkLogSubscription {
+	on(handler: NetworkLogHandler): void;
+	close(): void;
+}
+/**
+ * Subscribe to real-time network entries streamed via SSE from the
+ * Appium plugin. Requires `routeTraffic()` to have been called first
+ * with `inspect: true`.
+ *
+ * Each call opens its own SSE connection to the plugin; closing the
+ * subscription tears it down. No shared state.
+ *
+ * @example
+ * ```typescript
+ * const logs = ios.subscribeNetworkLogs();
+ * logs.on((entry) => {
+ *   if (entry.http) console.log(`${entry.http.method} ${entry.http.uri} → ${entry.http.statusCode}`);
+ *   if (entry.dns) console.log(`DNS ${entry.dns.name} → ${entry.dns.answer}`);
+ * });
+ *
+ * // ... run tests ...
+ *
+ * logs.close();
+ * ```
+ */
+export declare function subscribeNetworkLogs(): NetworkLogSubscription;
+export declare function routeTraffic(config: RouteTrafficConfig): Promise<() => Promise<void>>;
+/**
+ * Simulate a network condition (bandwidth limit, latency, jitter, packet loss)
+ * on traffic flowing through the gateway.
+ *
+ * Returns a cleanup function that clears the condition.
+ *
+ * @example
+ * ```typescript
+ * // Use a built-in preset
+ * const cleanup = await ios.simulateNetworkCondition(ios.NETWORK_3G);
+ * await cleanup();
+ *
+ * // Custom config
+ * const cleanup = await ios.simulateNetworkCondition({ bandwidthKbps: 500, latencyMs: 200 });
+ * await cleanup();
+ * ```
+ */
+export declare function simulateNetworkCondition(config: NetworkConditionConfig): Promise<() => Promise<void>>;
+/**
+ * Get the current network condition status.
+ */
+export declare function getNetworkCondition(): Promise<NetworkConditionStatus>;
+/**
+ * Configuration for a barcode or QR code to inject.
+ */
+export interface BarcodeConfig {
+	/** AVMetadataObjectType constant. Default: "org.iso.QRCode" */
+	type?: string;
+	/** The barcode/QR code value to inject */
+	value: string;
+	/** Normalized bounds (0.0-1.0) for the detected barcode position */
+	bounds?: {
+		x: number;
+		y: number;
+		width: number;
+		height: number;
+	};
+	/** Corner points (0.0-1.0) for the detected barcode shape */
+	corners?: {
+		x: number;
+		y: number;
+	}[];
+	/**
+	 * Raw binary payload exposed via `AVMetadataMachineReadableCodeObject.rawValue`
+	 * (iOS 13+). Accepts a Buffer or a base64-encoded string. When omitted, the
+	 * injector defaults to the UTF-8 encoding of `value`.
+	 */
+	rawValue?: Buffer | string;
+}
+/**
+ * Inject a barcode or QR code detection into the app's AVCaptureMetadataOutput.
+ *
+ * The injected barcode(s) will be delivered to the app's metadata output delegate
+ * as if they were scanned by the camera. The config file is auto-consumed by the
+ * injection system after delivery.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param bundleId - Bundle ID of the target app
+ * @param barcodes - Single barcode config or array of configs
+ * @returns Cleanup function that removes the injection config
+ *
+ * @example
+ * ```typescript
+ * // Inject a QR code
+ * const cleanup = await ios.injectBarcode(driver, "com.example.app", {
+ *   value: "https://example.com",
+ * });
+ *
+ * // Inject multiple barcodes
+ * const cleanup = await ios.injectBarcode(driver, "com.example.app", [
+ *   { type: "org.iso.QRCode", value: "https://example.com" },
+ *   { type: "org.gs1.EAN-13", value: "1234567890123" },
+ * ]);
+ *
+ * await cleanup();
+ * ```
+ */
+export declare function injectBarcode(driver: Browser, bundleId: string, barcodes: BarcodeConfig | BarcodeConfig[]): Promise<() => Promise<void>>;
+/**
+ * Source configuration for camera/video feed injection.
+ */
+export interface CameraSource {
+	/** File path, URL, or data URI for the media to inject */
+	data: string;
+	/** Media type. Default: inferred from file extension */
+	type?: "image" | "video";
+	/** Delay in seconds before injection starts */
+	delaySeconds?: number;
+}
+/**
+ * Source configuration for microphone/audio injection.
+ */
+export interface AudioSource {
+	/** File path, URL, or data URI for the audio to inject */
+	data: string;
+	/** Delay in seconds before injection starts */
+	delaySeconds?: number;
+}
+/**
+ * Inject a camera/video feed into the app's AVCaptureSession.
+ *
+ * Replaces the camera input with the provided image or video. Affects photo
+ * capture, video data output, video recording, and preview layers.
+ *
+ * When `data` is a local file path, the file is pushed to the device first.
+ * URLs and data URIs are downloaded/decoded by the injection dylib on device.
+ *
+ * Cannot be used simultaneously with `injectAudio` (they share the same config file).
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param bundleId - Bundle ID of the target app
+ * @param source - Media source configuration
+ * @returns Cleanup function that removes the injection config and media file
+ *
+ * @example
+ * ```typescript
+ * // Inject a local image as camera feed
+ * const cleanup = await ios.injectCamera(driver, "com.example.app", {
+ *   data: "/path/to/image.jpg",
+ *   type: "image",
+ * });
+ *
+ * // Inject a video from URL
+ * const cleanup = await ios.injectCamera(driver, "com.example.app", {
+ *   data: "https://example.com/video.mp4",
+ *   type: "video",
+ * });
+ *
+ * await cleanup();
+ * ```
+ */
+export declare function injectCamera(driver: Browser, bundleId: string, source: CameraSource): Promise<() => Promise<void>>;
+/**
+ * Inject audio into the app's microphone input.
+ *
+ * Replaces microphone input with the provided audio file. Affects
+ * AVAudioRecorder and AVCaptureAudioDataOutput.
+ *
+ * Cannot be used simultaneously with `injectCamera` (they share the same config file).
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param bundleId - Bundle ID of the target app
+ * @param source - Audio source configuration
+ * @returns Cleanup function that removes the injection config and audio file
+ *
+ * @example
+ * ```typescript
+ * const cleanup = await ios.injectAudio(driver, "com.example.app", {
+ *   data: "/path/to/audio.mp3",
+ * });
+ *
+ * await cleanup();
+ * ```
+ */
+export declare function injectAudio(driver: Browser, bundleId: string, source: AudioSource): Promise<() => Promise<void>>;
+/**
+ * Configuration for iBeacon injection.
+ */
+export interface BeaconConfig {
+	/** Beacon region UUID */
+	uuid: string;
+	/**
+	 * Beacons to simulate in this region. When omitted or empty, only the
+	 * `.region` file is pushed — the app receives a region-entry callback but
+	 * no ranging callbacks.
+	 */
+	beacons?: {
+		major: number | string;
+		minor: number | string;
+	}[];
+}
+/**
+ * Inject iBeacon detections into the app's CLLocationManager.
+ *
+ * Always pushes the `{uuid}.region` file, which triggers
+ * `locationManager(_:didEnterRegion:)`. When `beacons` is provided, also
+ * pushes `{uuid}.beacon` so the app receives
+ * `locationManager(_:didRangeBeacons:inRegion:)` callbacks.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param bundleId - Bundle ID of the target app
+ * @param config - Beacon configuration with UUID and (optional) beacon list
+ * @returns Cleanup function that removes the injection config files
+ *
+ * @example
+ * ```typescript
+ * // Region entry + ranging
+ * const cleanup = await ios.injectBeacon(driver, "com.example.app", {
+ *   uuid: "8613BEAD-5465-4515-8F9C-AEEA717484C9",
+ *   beacons: [{ major: 1, minor: 7 }],
+ * });
+ *
+ * // Region entry only (no ranging)
+ * const cleanup = await ios.injectBeacon(driver, "com.example.app", {
+ *   uuid: "e62c96fd-014a-454f-9b41-32245d802bb3",
+ * });
+ *
+ * await cleanup();
+ * ```
+ */
+export declare function injectBeacon(driver: Browser, bundleId: string, config: BeaconConfig): Promise<() => Promise<void>>;
+/**
+ * Toggle WebView debugging (Safari Web Inspector) for all WKWebViews in the app.
+ *
+ * When enabled, WKWebViews become inspectable via Safari DevTools.
+ * The default behavior (when no config file exists) is enabled.
+ *
+ * @param driver - The WebDriverIO browser instance
+ * @param bundleId - Bundle ID of the target app
+ * @param enabled - Whether to enable or disable WebView debugging
+ * @returns Cleanup function that removes the config (reverts to default: enabled)
+ *
+ * @example
+ * ```typescript
+ * // Disable WebView debugging
+ * const cleanup = await ios.setWebViewDebugging(driver, "com.example.app", false);
+ *
+ * // Re-enable (cleanup removes config, which defaults to enabled)
+ * await cleanup();
+ * ```
+ */
+export declare function setWebViewDebugging(driver: Browser, bundleId: string, enabled: boolean): Promise<() => Promise<void>>;
+
+export {};