@qawolf/run-globals-ios 0.0.18

package/dist/gateway.js

@@ -0,0 +1,433 @@
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+// ============================================================================
+// Schemas
+// ============================================================================
+export const RouteTypeSchema = z.enum([
+    "direct",
+    "http-proxy",
+    "wireguard",
+    "openvpn",
+    "relay",
+]);
+export const TunnelStatusSchema = z.enum(["down", "starting", "up", "error"]);
+export const TunnelStateSchema = z.object({
+    status: TunnelStatusSchema,
+    interface: z.string().optional(),
+    error: z.string().optional(),
+});
+export const TunnelStatusMapSchema = z.record(z.string(), TunnelStateSchema);
+// Validation helpers
+const HostSchema = z
+    .string()
+    .min(1, "Host must not be empty")
+    .refine((h) => !h.includes(":"), {
+    message: "Host must be a hostname or IP without scheme or port (e.g. 'proxy.example.com', not 'http://proxy.example.com:8080')",
+});
+const PortSchema = z.number().int().min(1).max(65535);
+// Tunnel configuration schemas
+export const HttpProxyTunnelSchema = z.object({
+    type: z.literal("http-proxy"),
+    host: HostSchema,
+    port: PortSchema,
+    username: z.string().optional(),
+    password: z.string().optional(),
+});
+export const WireGuardTunnelSchema = z.object({
+    type: z.literal("wireguard"),
+    /** Path to WireGuard configuration file (.conf) */
+    configPath: z.string(),
+});
+export const OpenVPNTunnelSchema = z.object({
+    type: z.literal("openvpn"),
+    /** Path to OpenVPN configuration file (.ovpn) */
+    configPath: z.string(),
+});
+export const RelayTunnelSchema = z.object({
+    type: z.literal("relay"),
+    host: HostSchema,
+    port: PortSchema,
+    username: z.string(),
+    password: z.string(),
+    /** Transport type (default: tls) */
+    dialer: z.enum(["tls", "tcp"]).optional(),
+    /** TLS certificate verification (default: true, only applies to tls dialer) */
+    secure: z.boolean().optional(),
+});
+export const DirectTunnelSchema = z.object({
+    type: z.literal("direct"),
+});
+export const TunnelConfigSchema = z.union([
+    DirectTunnelSchema,
+    HttpProxyTunnelSchema,
+    WireGuardTunnelSchema,
+    OpenVPNTunnelSchema,
+    RelayTunnelSchema,
+]);
+export const RouteTrafficConfigSchema = z.object({
+    /** Bundle IDs of apps whose traffic to route */
+    apps: z.array(z.string()),
+    /** Safari domains to route (supports wildcards like *.example.com) */
+    domains: z.array(z.string()).optional(),
+    /** Tunnel configuration */
+    tunnel: TunnelConfigSchema,
+    /**
+     * SOCKS5 proxy host for the VPN to connect to. Default: 172.20.10.1 (CDC NCM)
+     * This must be an IP address reachable from the iOS device.
+     * - Production/staging (K8s with CDC NCM): 172.20.10.1 (default)
+     * - Local development (Mac USB): Must pass 192.168.2.1 explicitly
+     * - Alternative: The Mac's WiFi IP if both devices are on the same network
+     */
+    socksHost: HostSchema.optional(),
+    /**
+     * SOCKS5 proxy port. Default: 1080
+     */
+    socksPort: PortSchema.optional(),
+    /**
+     * Enable MITM network inspection. When true, HTTPS traffic is decrypted
+     * and recorded for later retrieval via getNetworkLogs().
+     */
+    inspect: z.boolean().optional(),
+});
+// Routing tables schema
+export const RoutingTablesSchema = z.object({
+    /** Which routing table the ip rule currently points GOST traffic to */
+    activeTable: z.string(),
+    /** Entries in each routing table (direct, wireguard, openvpn) */
+    tables: z.record(z.string(), z.array(z.string())),
+});
+// Traffic stats schemas
+export const RouteStatsSchema = z.object({
+    packets: z.number(),
+    bytes: z.number(),
+});
+export const InterfaceStatsSchema = z.object({
+    rxPackets: z.number(),
+    txPackets: z.number(),
+    rxBytes: z.number(),
+    txBytes: z.number(),
+});
+export const TrafficStatsSchema = z.object({
+    /** Per-route packet/byte counters (direct, http-proxy, wireguard, openvpn) */
+    routes: z.record(z.string(), RouteStatsSchema),
+    /** Per-interface packet/byte counters (eth0, tun0, wg0, etc.) */
+    interfaces: z.record(z.string(), InterfaceStatsSchema),
+});
+// Combined network status schema
+export const NetworkStatusSchema = z.object({
+    /** Current active route */
+    route: RouteTypeSchema,
+    /** Status of all tunnels */
+    tunnels: TunnelStatusMapSchema,
+    /** Routing tables and which is active */
+    routingTables: RoutingTablesSchema.optional(),
+    /** Traffic counters per route and interface */
+    traffic: TrafficStatsSchema.optional(),
+    /** Per-app VPN app status */
+    vpnApp: z.object({
+        bundleId: z.string(),
+        installed: z.boolean(),
+        pid: z.number().optional(),
+    }),
+    /** Apps and domains being routed */
+    routedApps: z.array(z.string()),
+    routedDomains: z.array(z.string()),
+});
+// Network condition schemas
+export const NetworkConditionConfigSchema = z
+    .object({
+    bandwidthKbps: z.number().positive().optional(),
+    latencyMs: z.number().nonnegative().optional(),
+    jitterMs: z.number().nonnegative().optional(),
+    packetLossPercent: z.number().min(0).max(100).optional(),
+})
+    .refine((c) => !c.jitterMs || (c.latencyMs && c.latencyMs > 0), {
+    message: "latencyMs must be > 0 when jitterMs is specified",
+    path: ["latencyMs"],
+});
+/** 2G EDGE: ~240 Kbps, 300ms latency, high jitter */
+export const NETWORK_2G_EDGE = {
+    bandwidthKbps: 240,
+    latencyMs: 300,
+    jitterMs: 100,
+    packetLossPercent: 1.5,
+};
+/** 3G: ~1.8 Mbps, 100ms latency */
+export const NETWORK_3G = {
+    bandwidthKbps: 1800,
+    latencyMs: 100,
+    jitterMs: 30,
+    packetLossPercent: 0.5,
+};
+/** 4G LTE: ~12 Mbps, 30ms latency */
+export const NETWORK_4G_LTE = {
+    bandwidthKbps: 12000,
+    latencyMs: 30,
+    jitterMs: 10,
+    packetLossPercent: 0.1,
+};
+/** 5G: ~100 Mbps, 10ms latency */
+export const NETWORK_5G = {
+    bandwidthKbps: 100000,
+    latencyMs: 10,
+    jitterMs: 3,
+    packetLossPercent: 0.01,
+};
+/** Satellite: ~5 Mbps, 600ms latency */
+export const NETWORK_SATELLITE = {
+    bandwidthKbps: 5000,
+    latencyMs: 600,
+    jitterMs: 50,
+    packetLossPercent: 1.0,
+};
+/** Congested WiFi: ~2 Mbps, 50ms latency, high jitter and packet loss */
+export const NETWORK_WIFI_CONGESTED = {
+    bandwidthKbps: 2000,
+    latencyMs: 50,
+    jitterMs: 40,
+    packetLossPercent: 3.0,
+};
+/** Very bad network: ~100 Kbps, 500ms latency, extreme jitter and packet loss */
+export const NETWORK_VERY_BAD = {
+    bandwidthKbps: 100,
+    latencyMs: 500,
+    jitterMs: 200,
+    packetLossPercent: 10.0,
+};
+/** Offline: 100% packet loss — drops all packets to simulate no connectivity */
+export const NETWORK_OFFLINE = {
+    packetLossPercent: 100,
+};
+export const NetworkConditionStatusSchema = z.object({
+    enabled: z.boolean(),
+    config: NetworkConditionConfigSchema.optional(),
+    interface: z.string().optional(),
+});
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Resolve tunnel config by reading file contents for VPN configs.
+ * The plugin runs in a container and needs the file content, not the path.
+ */
+async function resolveTunnelConfig(tunnel) {
+    switch (tunnel.type) {
+        case "direct":
+            return { type: "direct" };
+        case "http-proxy":
+            return {
+                type: "http-proxy",
+                host: tunnel.host,
+                port: tunnel.port,
+                username: tunnel.username,
+                password: tunnel.password,
+            };
+        case "wireguard": {
+            const configContent = await readFile(tunnel.configPath, "utf-8");
+            return { type: "wireguard", configContent };
+        }
+        case "openvpn": {
+            const configContent = await readFile(tunnel.configPath, "utf-8");
+            return { type: "openvpn", configContent };
+        }
+        case "relay":
+            return {
+                type: "relay",
+                host: tunnel.host,
+                port: tunnel.port,
+                username: tunnel.username,
+                password: tunnel.password,
+                dialer: tunnel.dialer,
+                secure: tunnel.secure,
+            };
+    }
+}
+function getAppiumBaseUrl() {
+    // Platform runner uses APPIUM_URL; local/E2E tests use APPIUM_HOST/APPIUM_PORT
+    if (process.env.APPIUM_URL) {
+        return process.env.APPIUM_URL;
+    }
+    const host = process.env.APPIUM_HOST || "127.0.0.1";
+    const port = process.env.APPIUM_PORT || "4723";
+    return `http://${host}:${port}`;
+}
+/**
+ * Make a request to the Appium server's sessionless endpoint.
+ * Unwraps the W3C WebDriver `{ value: <result> }` envelope.
+ */
+async function appiumFetch(method, path, body) {
+    const url = `${getAppiumBaseUrl()}${path}`;
+    const headers = { "Content-Type": "application/json" };
+    if (process.env.DEVICE_JWT) {
+        headers["Authorization"] = `Bearer ${process.env.DEVICE_JWT}`;
+    }
+    const init = {
+        method,
+        headers,
+    };
+    if (body !== undefined) {
+        init.body = JSON.stringify(body);
+    }
+    const response = await fetch(url, init);
+    const json = (await response.json());
+    if (!response.ok) {
+        const errorDetail = json.value &&
+            typeof json.value === "object" &&
+            "error" in json.value
+            ? json.value.error
+            : JSON.stringify(json.value);
+        throw new Error(`Appium ${method} ${path} failed (${response.status}): ${errorDetail}`);
+    }
+    return json.value;
+}
+// ============================================================================
+// Status Function
+// ============================================================================
+/**
+ * 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 async function getNetworkStatus() {
+    const result = await appiumFetch("GET", "/qawolf/network/status");
+    return NetworkStatusSchema.parse(result);
+}
+/**
+ * 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 function subscribeNetworkLogs() {
+    const handlers = new Set();
+    const abortController = new AbortController();
+    const sseUrl = `${getAppiumBaseUrl()}/qawolf/network/logs/stream`;
+    // Start reading the SSE stream in the background
+    void (async () => {
+        try {
+            const headers = { Accept: "text/event-stream" };
+            if (process.env.DEVICE_JWT) {
+                headers["Authorization"] = `Bearer ${process.env.DEVICE_JWT}`;
+            }
+            const response = await fetch(sseUrl, {
+                headers,
+                signal: abortController.signal,
+            });
+            if (!response.ok || !response.body)
+                return;
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.startsWith("data: "))
+                        continue;
+                    try {
+                        const entry = JSON.parse(line.slice(6));
+                        for (const handler of handlers) {
+                            handler(entry);
+                        }
+                    }
+                    catch {
+                        // not valid JSON — skip
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === "AbortError")
+                return;
+            // SSE connection error — silently stop
+        }
+    })();
+    return {
+        on(handler) {
+            handlers.add(handler);
+        },
+        close() {
+            handlers.clear();
+            abortController.abort();
+        },
+    };
+}
+// ============================================================================
+export async function routeTraffic(config) {
+    RouteTrafficConfigSchema.parse(config);
+    const tunnel = await resolveTunnelConfig(config.tunnel);
+    await appiumFetch("POST", "/qawolf/network/route", {
+        apps: config.apps,
+        domains: config.domains,
+        tunnel,
+        socksHost: config.socksHost,
+        socksPort: config.socksPort,
+        inspect: config.inspect,
+    });
+    return async () => {
+        await appiumFetch("DELETE", "/qawolf/network/route");
+    };
+}
+// ============================================================================
+// Network Condition Simulation
+// ============================================================================
+/**
+ * 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 async function simulateNetworkCondition(config) {
+    NetworkConditionConfigSchema.parse(config);
+    // Network simulation requires routeTraffic() to be called first so that
+    // app traffic flows through the gateway where shaping is applied.
+    const status = await getNetworkStatus();
+    if (!status.vpnApp.installed) {
+        throw new Error("simulateNetworkCondition requires routeTraffic() to be called first. " +
+            "Network shaping is applied at the gateway, so app traffic must be routed through it.");
+    }
+    await appiumFetch("POST", "/qawolf/network/condition", { config });
+    return async () => {
+        await appiumFetch("DELETE", "/qawolf/network/condition");
+    };
+}
+/**
+ * Get the current network condition status.
+ */
+export async function getNetworkCondition() {
+    const result = await appiumFetch("GET", "/qawolf/network/condition");
+    return NetworkConditionStatusSchema.parse(result);
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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 a flat API similar to Android run-globals.
+ *
+ * @example
+ * ```typescript
+ *
+ * // Speaker audio recording (captures device audio output)
+ * const session = await ios.startSpeakerRecording(driver);
+ * await new Promise(resolve => setTimeout(resolve, 5000));
+ * const file = await ios.stopSpeakerRecording(driver, session.id);
+ * const audioBuffer = await ios.downloadSpeakerRecording(driver, file.filename);
+ *
+ * // Photo management
+ * await ios.savePhoto(driver, '/path/to/photo.jpg');
+ * const photos = await ios.listPhotos(driver);
+ * await ios.deleteAllPhotos(driver);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { startSpeakerRecording, stopSpeakerRecording, downloadSpeakerRecording, calculateAudioFingerprint, } from "./audio.js";
+export type { SpeakerRecordingSession, SpeakerRecordingFile, AudioFingerprint } from "./audio.js";
+export { savePhoto, listPhotos, deleteAllPhotos } from "./photo.js";
+export type { PhotoAsset, SavePhotoResult, ListPhotosResult, DeletePhotosResult } from "./photo.js";
+export { installConfigurationProfile } from "./configuration-profile.js";
+export type { ConfigurationProfileOptions } from "./configuration-profile.js";
+export { routeTraffic, getNetworkStatus, subscribeNetworkLogs, simulateNetworkCondition, getNetworkCondition, NETWORK_2G_EDGE, NETWORK_3G, NETWORK_4G_LTE, NETWORK_5G, NETWORK_SATELLITE, NETWORK_WIFI_CONGESTED, NETWORK_VERY_BAD, NETWORK_OFFLINE, NetworkConditionConfigSchema, NetworkConditionStatusSchema, } from "./gateway.js";
+export type { RouteType, TunnelStatus, TunnelState, TunnelStatusMap, NetworkStatus, NetworkLogSubscription, HttpProxyTunnel, WireGuardTunnel, OpenVPNTunnel, TunnelConfig, RouteTrafficConfig, NetworkConditionConfig, NetworkConditionStatus, RecordedEntry, } from "./gateway.js";
+export { injectBarcode } from "./barcode.js";
+export type { BarcodeConfig } from "./barcode.js";
+export { injectCamera, injectAudio } from "./media.js";
+export type { CameraSource, AudioSource } from "./media.js";
+export { injectBeacon } from "./beacon.js";
+export type { BeaconConfig } from "./beacon.js";
+export { setWebViewDebugging } from "./webview.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlG,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpG,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAGzE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAG9E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * @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 a flat API similar to Android run-globals.
+ *
+ * @example
+ * ```typescript
+ *
+ * // Speaker audio recording (captures device audio output)
+ * const session = await ios.startSpeakerRecording(driver);
+ * await new Promise(resolve => setTimeout(resolve, 5000));
+ * const file = await ios.stopSpeakerRecording(driver, session.id);
+ * const audioBuffer = await ios.downloadSpeakerRecording(driver, file.filename);
+ *
+ * // Photo management
+ * await ios.savePhoto(driver, '/path/to/photo.jpg');
+ * const photos = await ios.listPhotos(driver);
+ * await ios.deleteAllPhotos(driver);
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Speaker audio recording functions (records device audio output)
+export { startSpeakerRecording, stopSpeakerRecording, downloadSpeakerRecording, calculateAudioFingerprint, } from "./audio.js";
+// Photo functions
+export { savePhoto, listPhotos, deleteAllPhotos } from "./photo.js";
+// Configuration profile functions
+export { installConfigurationProfile } from "./configuration-profile.js";
+// Gateway routing functions
+export { routeTraffic, getNetworkStatus, subscribeNetworkLogs, simulateNetworkCondition, getNetworkCondition, NETWORK_2G_EDGE, NETWORK_3G, NETWORK_4G_LTE, NETWORK_5G, NETWORK_SATELLITE, NETWORK_WIFI_CONGESTED, NETWORK_VERY_BAD, NETWORK_OFFLINE, NetworkConditionConfigSchema, NetworkConditionStatusSchema, } from "./gateway.js";
+// Code injection functions
+export { injectBarcode } from "./barcode.js";
+export { injectCamera, injectAudio } from "./media.js";
+export { injectBeacon } from "./beacon.js";
+export { setWebViewDebugging } from "./webview.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,kEAAkE;AAClE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAKpB,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKpE,kCAAkC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAKzE,4BAA4B;AAC5B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AAoBtB,2BAA2B;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/injectionHelpers.d.ts

@@ -0,0 +1,18 @@
+import type { Browser } from "webdriverio";
+export declare function isRemoteSource(data: string): boolean;
+export declare function inferMediaType(filePath: string): "image" | "video";
+export declare function qawolfPath(bundleId: string, filename: string): string;
+export declare function pushJsonConfig(driver: Browser, bundleId: string, filename: string, config: unknown): Promise<() => Promise<void>>;
+export declare function pushRawContent(driver: Browser, bundleId: string, filename: string, content: string): Promise<() => Promise<void>>;
+/**
+ * Resolve a media `data` field to a reference the injection dylib can load.
+ *
+ * Remote sources (http/https/data URIs) are returned as-is. Local file paths
+ * are read, pushed to the device under `Documents/.qawolf/`, and referenced
+ * by filename. The returned cleanup removes any pushed file.
+ */
+export declare function pushLocalOrRemoteMedia(driver: Browser, bundleId: string, data: string): Promise<{
+    dataRef: string;
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=injectionHelpers.d.ts.map

package/dist/injectionHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectionHelpers.d.ts","sourceRoot":"","sources":["../src/injectionHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAGlE;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAY9B;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAW9B;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAoB5D"}

package/dist/injectionHelpers.js

@@ -0,0 +1,68 @@
+import fs from "fs";
+import path from "path";
+const VIDEO_EXTENSIONS = new Set([".mp4", ".mov", ".m4v", ".avi"]);
+export function isRemoteSource(data) {
+    return (data.startsWith("http://") ||
+        data.startsWith("https://") ||
+        data.startsWith("data:"));
+}
+export function inferMediaType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return VIDEO_EXTENSIONS.has(ext) ? "video" : "image";
+}
+export function qawolfPath(bundleId, filename) {
+    return `@${bundleId}:Documents/.qawolf/${filename}`;
+}
+export async function pushJsonConfig(driver, bundleId, filename, config) {
+    const content = Buffer.from(JSON.stringify(config)).toString("base64");
+    const devicePath = qawolfPath(bundleId, filename);
+    await driver.pushFile(devicePath, content);
+    return async () => {
+        try {
+            await driver.execute("mobile: deleteFile", { remotePath: devicePath });
+        }
+        catch {
+            // File may already be consumed by the injection system
+        }
+    };
+}
+export async function pushRawContent(driver, bundleId, filename, content) {
+    const devicePath = qawolfPath(bundleId, filename);
+    await driver.pushFile(devicePath, Buffer.from(content).toString("base64"));
+    return async () => {
+        try {
+            await driver.execute("mobile: deleteFile", { remotePath: devicePath });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    };
+}
+/**
+ * Resolve a media `data` field to a reference the injection dylib can load.
+ *
+ * Remote sources (http/https/data URIs) are returned as-is. Local file paths
+ * are read, pushed to the device under `Documents/.qawolf/`, and referenced
+ * by filename. The returned cleanup removes any pushed file.
+ */
+export async function pushLocalOrRemoteMedia(driver, bundleId, data) {
+    if (isRemoteSource(data)) {
+        return { dataRef: data, cleanup: async () => { } };
+    }
+    const fileBuffer = fs.readFileSync(data);
+    const fileName = path.basename(data);
+    const devicePath = qawolfPath(bundleId, fileName);
+    await driver.pushFile(devicePath, fileBuffer.toString("base64"));
+    return {
+        dataRef: fileName,
+        cleanup: async () => {
+            try {
+                await driver.execute("mobile: deleteFile", { remotePath: devicePath });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        },
+    };
+}
+//# sourceMappingURL=injectionHelpers.js.map

package/dist/injectionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectionHelpers.js","sourceRoot":"","sources":["../src/injectionHelpers.ts"],"names":[],"mappings":"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"}