@qawolf/run-globals-ios 0.0.18

package/README.md

@@ -0,0 +1,232 @@
+# @qawolf/run-globals-ios
+
+iOS testing utilities for QA Wolf - audio recording and photos management.
+
+This package provides standalone functions for interacting with iOS devices through WebDriverIO, following the same flat API pattern as `run-globals-android`.
+
+## Installation
+
+```bash
+npm install @qawolf/run-globals-ios
+```
+
+### Peer Dependencies
+
+This package requires WebDriverIO as a peer dependency:
+
+```bash
+npm install webdriverio webdriver
+```
+
+## Usage
+
+```typescript
+import * as ios from '@qawolf/run-globals-ios';
+
+// Speaker audio recording (captures device audio output)
+const session = await ios.startSpeakerRecording(driver);
+console.log(`Recording started with session ID: ${session.id}`);
+
+// Wait for some audio to be recorded
+await new Promise(resolve => setTimeout(resolve, 5000));
+
+// Stop recording - this also calculates the fingerprint automatically
+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`);
+}
+
+// Download the audio file
+const audioBuffer = await ios.downloadSpeakerRecording(driver, file.filename);
+fs.writeFileSync('/tmp/recording.wav', audioBuffer);
+
+// Calculate fingerprint for a reference audio file
+const referenceAudio = fs.readFileSync('/tmp/reference.wav');
+const fingerprint = await ios.calculateAudioFingerprint(driver, referenceAudio);
+console.log(`Reference duration: ${fingerprint.duration}s`);
+
+// Save a photo from local filesystem to device Photos library
+const result = await ios.savePhoto(driver, '/Users/me/test-photo.jpg');
+if (result.success) {
+  console.log('Photo saved to library');
+}
+
+// List all photos in the library
+const photoList = await ios.listPhotos(driver);
+console.log(`Found ${photoList.totalCount} photos`);
+
+// Clean up - delete all photos (useful for test cleanup)
+await ios.deleteAllPhotos(driver);
+console.log('All photos deleted');
+```
+
+## API Reference
+
+### Speaker Audio Recording Functions
+
+#### `startSpeakerRecording(driver)`
+
+Start recording speaker/system audio output on the iOS device.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+- **Returns:** `Promise<SpeakerRecordingSession>` - Session information with ID
+- **Throws:** Error if recording fails to start
+
+#### `stopSpeakerRecording(driver, sessionId)`
+
+Stop speaker audio recording and finalize the file. Automatically calculates audio fingerprint.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+  - `sessionId: string` - Session ID from `startSpeakerRecording()`
+- **Returns:** `Promise<SpeakerRecordingFile>` - File information including optional fingerprint
+- **Throws:** Error if session ID is invalid or stop fails
+
+#### `downloadSpeakerRecording(driver, filename)`
+
+Download a recorded speaker audio file as a Buffer (WAV format).
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+  - `filename: string` - Filename from `stopSpeakerRecording()`
+- **Returns:** `Promise<Buffer>` - Audio file contents
+- **Throws:** Error if file doesn't exist
+
+#### `calculateAudioFingerprint(driver, audioData)`
+
+Calculate audio fingerprint from audio data.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+  - `audioData: Buffer | string` - WAV audio data as Buffer or base64 string
+- **Returns:** `Promise<AudioFingerprint>` - Fingerprint and duration
+- **Throws:** Error if audio data is invalid
+
+### Photo Functions
+
+#### `savePhoto(driver, filePath)`
+
+Save a file from the filesystem to the device Photos library. Handles the complete workflow including file transfer and cleanup.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+  - `filePath: string` - Absolute path to file on the filesystem
+- **Returns:** `Promise<SavePhotoResult>` - Success status and optional message
+- **Throws:** Error if file doesn't exist or save fails
+
+#### `listPhotos(driver)`
+
+List all photos and videos from the Photos library.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+- **Returns:** `Promise<ListPhotosResult>` - Result with assets array and count
+- **Throws:** Error if listing fails
+
+#### `deleteAllPhotos(driver)`
+
+Delete all photos and videos from the Photos library. Useful for test cleanup.
+
+- **Parameters:**
+  - `driver: Browser` - WebDriverIO browser instance
+- **Returns:** `Promise<DeletePhotosResult>` - Result with deleted count
+- **Throws:** Error if deletion fails
+
+## Types
+
+### `SpeakerRecordingSession`
+
+```typescript
+interface SpeakerRecordingSession {
+  id: string;        // Unique session identifier
+  status: string;    // Recording status
+}
+```
+
+### `SpeakerRecordingFile`
+
+```typescript
+interface SpeakerRecordingFile {
+  filename: string;        // Name of the audio file
+  fingerprint?: number[];  // Optional audio fingerprint (array of integers)
+  duration?: number;       // Optional duration in seconds
+}
+```
+
+### `AudioFingerprint`
+
+```typescript
+interface AudioFingerprint {
+  fingerprint: number[];  // Audio fingerprint (array of integers)
+  duration: number;       // Duration in seconds
+}
+```
+
+### `PhotoAsset`
+
+```typescript
+interface PhotoAsset {
+  localIdentifier: string;
+  mediaType: string;
+  mediaSubtype: string;
+  creationDate: string;
+  modificationDate: string;
+  pixelWidth: number;
+  pixelHeight: number;
+  duration: number;
+  isFavorite: boolean;
+  isHidden: boolean;
+}
+```
+
+### `SavePhotoResult`
+
+```typescript
+interface SavePhotoResult {
+  success: boolean;   // Whether save was successful
+  message?: string;   // Optional additional information
+}
+```
+
+### `ListPhotosResult`
+
+```typescript
+interface ListPhotosResult {
+  success: boolean;
+  assets: PhotoAsset[];
+  totalCount: number;
+}
+```
+
+### `DeletePhotosResult`
+
+```typescript
+interface DeletePhotosResult {
+  success: boolean;
+  deletedCount: number;
+  message?: string;
+}
+```
+
+## Architecture
+
+This package provides a clean, fetch-based HTTP API for iOS testing:
+
+- **Flat API**: All functions are exported directly for easy autocomplete
+- **Direct HTTP communication**: Uses native `fetch` API to communicate with Appium/WebDriver server
+- **No driver mutation**: Functions make direct HTTP calls without registering custom commands
+- **Full TypeScript support**: Complete type definitions with comprehensive JSDoc documentation
+- **Explicit dependencies**: Driver is passed explicitly to extract connection information
+
+## Requirements
+
+- Node.js ^20
+- WebDriverIO ^8.0.0 or ^9.0.0
+- iOS device or simulator with QA Wolf iOS Agent installed
+- Appium server with ios-agent running
+
+## License
+
+MIT

package/dist/audio.d.ts

@@ -0,0 +1,98 @@
+import type { Browser } from "webdriverio";
+import { z } from "zod";
+/**
+ * Schema for an active speaker recording session
+ */
+export 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>;
+/**
+ * Schema for a recorded audio file with optional fingerprint data
+ */
+export 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>;
+/**
+ * Schema for the audio fingerprint calculation result
+ */
+export 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>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;iBAKxC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;iBAOrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBAKjC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAU7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAiB3B"}

package/dist/audio.js

@@ -0,0 +1,145 @@
+import { z } from "zod";
+/**
+ * Schema for an active speaker recording session
+ */
+export const SpeakerRecordingSessionSchema = z.object({
+    /** Unique identifier for the recording session */
+    id: z.string(),
+    /** Current status of the recording session */
+    status: z.string(),
+});
+/**
+ * Schema for a recorded audio file with optional fingerprint data
+ */
+export const SpeakerRecordingFileSchema = z.object({
+    /** Name of the recorded audio file */
+    filename: z.string(),
+    /** Optional audio fingerprint as an array of integers */
+    fingerprint: z.array(z.number()).optional(),
+    /** Optional duration of the recording in seconds */
+    duration: z.number().optional(),
+});
+/**
+ * Schema for the audio fingerprint calculation result
+ */
+export const AudioFingerprintSchema = z.object({
+    /** Audio fingerprint as an array of integers */
+    fingerprint: z.array(z.number()),
+    /** Duration of the audio in seconds */
+    duration: z.number(),
+});
+/**
+ * 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 async function startSpeakerRecording(driver) {
+    const result = (await driver.execute("qawolf: startAudioRecording", []));
+    return {
+        id: result.audioSessionId,
+        status: result.status,
+    };
+}
+/**
+ * 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 async function stopSpeakerRecording(driver, sessionId) {
+    const result = (await driver.execute("qawolf: stopAudioRecording", [sessionId]));
+    // Decode the base64 fingerprint to integer array
+    const fingerprint = result.fingerprint && typeof result.fingerprint === "string"
+        ? decodeBase64Fingerprint(result.fingerprint)
+        : undefined;
+    return {
+        filename: result.filename,
+        fingerprint,
+        duration: result.duration,
+    };
+}
+/**
+ * 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 async function downloadSpeakerRecording(driver, filename) {
+    const base64 = (await driver.execute("qawolf: downloadAudioFile", [
+        filename,
+    ]));
+    return Buffer.from(base64, "base64");
+}
+/**
+ * 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 async function calculateAudioFingerprint(driver, audioData) {
+    const base64Data = Buffer.isBuffer(audioData) ? audioData.toString("base64") : audioData;
+    const result = (await driver.execute("qawolf: calculateAudioFingerprint", [
+        { data: base64Data },
+    ]));
+    // Decode the base64 fingerprint to integer array
+    const fingerprint = decodeBase64Fingerprint(result.fingerprint);
+    return {
+        fingerprint,
+        duration: result.duration,
+    };
+}
+/**
+ * Decode a base64-encoded fingerprint to raw integers.
+ * ChromaSwift (the audio fingerprinting library used by the iOS agent)
+ * encodes the raw UInt32 array as base64 using little-endian byte order.
+ *
+ * @param base64Fingerprint - The base64-encoded fingerprint string
+ * @returns Array of signed 32-bit integers representing the fingerprint
+ */
+function decodeBase64Fingerprint(base64Fingerprint) {
+    const buffer = Buffer.from(base64Fingerprint, "base64");
+    const fingerprint = [];
+    // Read as little-endian 32-bit integers
+    for (let i = 0; i < buffer.length; i += 4) {
+        if (i + 4 <= buffer.length) {
+            const value = buffer.readUInt32LE(i);
+            fingerprint.push(value | 0); // Convert to signed 32-bit
+        }
+    }
+    return fingerprint;
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,kDAAkD;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,8CAA8C;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,sCAAsC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,yDAAyD;IACzD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,oDAAoD;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,gDAAgD;IAChD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,uCAAuC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAOH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAe;IACzD,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAGtE,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,cAAc;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAe,EACf,SAAiB;IAEjB,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,SAAS,CAAC,CAAC,CAI9E,CAAC;IAEF,iDAAiD;IACjD,MAAM,WAAW,GACf,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAC1D,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW;QACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAAe,EAAE,QAAgB;IAC9E,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE;QAChE,QAAQ;KACT,CAAC,CAAsB,CAAC;IAEzB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAe,EACf,SAA0B;IAE1B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzF,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,mCAAmC,EAAE;QACxE,EAAE,IAAI,EAAE,UAAU,EAAE;KACrB,CAAC,CAGD,CAAC;IAEF,iDAAiD;IACjD,MAAM,WAAW,GAAG,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEhE,OAAO;QACL,WAAW;QACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAAC,iBAAyB;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,wCAAwC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,2BAA2B;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/barcode.d.ts

@@ -0,0 +1,58 @@
+import type { Browser } from "webdriverio";
+/**
+ * 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>>;
+//# sourceMappingURL=barcode.d.ts.map

package/dist/barcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode.d.ts","sourceRoot":"","sources":["../src/barcode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,6DAA6D;IAC7D,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,GAAG,aAAa,EAAE,GACxC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAe9B"}

package/dist/barcode.js

@@ -0,0 +1,45 @@
+import { pushJsonConfig } from "./injectionHelpers.js";
+/**
+ * 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 async function injectBarcode(driver, bundleId, barcodes) {
+    const items = Array.isArray(barcodes) ? barcodes : [barcodes];
+    const metadataObjects = items.map((b) => ({
+        type: b.type ?? "org.iso.QRCode",
+        value: b.value,
+        ...(b.bounds && { bounds: b.bounds }),
+        ...(b.corners && { corners: b.corners }),
+        ...(b.rawValue !== undefined && {
+            rawValue: Buffer.isBuffer(b.rawValue) ? b.rawValue.toString("base64") : b.rawValue,
+        }),
+    }));
+    return pushJsonConfig(driver, bundleId, "metadataobject.json", {
+        metadataObjects,
+    });
+}
+//# sourceMappingURL=barcode.js.map

package/dist/barcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode.js","sourceRoot":"","sources":["../src/barcode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAsBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAe,EACf,QAAgB,EAChB,QAAyC;IAEzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,gBAAgB;QAChC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QACrC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACxC,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI;YAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;SACnF,CAAC;KACH,CAAC,CAAC,CAAC;IAEJ,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE;QAC7D,eAAe;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/beacon.d.ts

@@ -0,0 +1,48 @@
+import type { Browser } from "webdriverio";
+/**
+ * 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>>;
+//# sourceMappingURL=beacon.d.ts.map

package/dist/beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../src/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAwB9B"}