@qawolf/run-globals-ios 0.0.18

package/dist/beacon.js

@@ -0,0 +1,49 @@
+import { pushJsonConfig, pushRawContent } from "./injectionHelpers.js";
+/**
+ * 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 async function injectBeacon(driver, bundleId, config) {
+    const cleanups = [];
+    if (config.beacons && config.beacons.length > 0) {
+        const beaconData = config.beacons.map((b) => ({
+            uuid: config.uuid,
+            major: String(b.major),
+            minor: String(b.minor),
+        }));
+        cleanups.push(await pushJsonConfig(driver, bundleId, `${config.uuid}.beacon`, beaconData));
+    }
+    // Push empty region file: {uuid}.region (triggers region entry)
+    cleanups.push(await pushRawContent(driver, bundleId, `${config.uuid}.region`, ""));
+    return async () => {
+        for (const cleanup of cleanups) {
+            await cleanup();
+        }
+    };
+}
+//# sourceMappingURL=beacon.js.map

package/dist/beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.js","sourceRoot":"","sources":["../src/beacon.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAgBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAe,EACf,QAAgB,EAChB,MAAoB;IAEpB,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;SACvB,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,IAAI,CACX,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,SAAS,EAAE,UAAU,CAAC,CAC5E,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CACX,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,SAAS,EAAE,EAAE,CAAC,CACpE,CAAC;IAEF,OAAO,KAAK,IAAI,EAAE;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/configuration-profile.d.ts

@@ -0,0 +1,27 @@
+import { Browser } from "webdriverio";
+import { z } from "zod";
+/**
+ * Schema for configuration profile options
+ */
+export 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>>;
+//# sourceMappingURL=configuration-profile.d.ts.map

package/dist/configuration-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-profile.d.ts","sourceRoot":"","sources":["../src/configuration-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,iCAAiC;;iBAG5C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAoBjC"}

package/dist/configuration-profile.js

@@ -0,0 +1,40 @@
+import plist from "plist";
+import { z } from "zod";
+/**
+ * Schema for configuration profile options
+ */
+export const ConfigurationProfileOptionsSchema = z.object({
+    /** The configuration profile plist string */
+    profileString: z.string(),
+});
+/**
+ * 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 async function installConfigurationProfile(driver, profileString) {
+    const parsedOptions = ConfigurationProfileOptionsSchema.parse({ profileString });
+    try {
+        plist.parse(parsedOptions.profileString);
+    }
+    catch {
+        throw new Error("Failed to parse configuration profile. Please make sure it is a valid plist file.");
+    }
+    await driver.execute("qawolf: installConfigurationProfile", {
+        profileString: parsedOptions.profileString,
+    });
+    return () => {
+        return driver.execute("qawolf: uninstallConfigurationProfile", {
+            profileString: parsedOptions.profileString,
+        });
+    };
+}
+//# sourceMappingURL=configuration-profile.js.map

package/dist/configuration-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-profile.js","sourceRoot":"","sources":["../src/configuration-profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,6CAA6C;IAC7C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAOH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAe,EACf,aAAqB;IAErB,MAAM,aAAa,GAAG,iCAAiC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IAEjF,IAAI,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,CAAC,OAAO,CAAC,qCAAqC,EAAE;QAC1D,aAAa,EAAE,aAAa,CAAC,aAAa;KAC3C,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,OAAO,MAAM,CAAC,OAAO,CAAC,uCAAuC,EAAE;YAC7D,aAAa,EAAE,aAAa,CAAC,aAAa;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/gateway.d.ts

@@ -0,0 +1,443 @@
+import { z } from "zod";
+export declare const RouteTypeSchema: z.ZodEnum<{
+    direct: "direct";
+    "http-proxy": "http-proxy";
+    wireguard: "wireguard";
+    openvpn: "openvpn";
+    relay: "relay";
+}>;
+export type RouteType = z.infer<typeof RouteTypeSchema>;
+export declare const TunnelStatusSchema: z.ZodEnum<{
+    down: "down";
+    starting: "starting";
+    up: "up";
+    error: "error";
+}>;
+export type TunnelStatus = z.infer<typeof TunnelStatusSchema>;
+export 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>;
+export 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>;
+export 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>;
+export declare const WireGuardTunnelSchema: z.ZodObject<{
+    type: z.ZodLiteral<"wireguard">;
+    configPath: z.ZodString;
+}, z.core.$strip>;
+export type WireGuardTunnel = z.infer<typeof WireGuardTunnelSchema>;
+export declare const OpenVPNTunnelSchema: z.ZodObject<{
+    type: z.ZodLiteral<"openvpn">;
+    configPath: z.ZodString;
+}, z.core.$strip>;
+export type OpenVPNTunnel = z.infer<typeof OpenVPNTunnelSchema>;
+export declare const RelayTunnelSchema: 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 RelayTunnel = z.infer<typeof RelayTunnelSchema>;
+export declare const DirectTunnelSchema: z.ZodObject<{
+    type: z.ZodLiteral<"direct">;
+}, z.core.$strip>;
+export type DirectTunnel = z.infer<typeof DirectTunnelSchema>;
+export 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>;
+export 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>;
+export declare const RoutingTablesSchema: z.ZodObject<{
+    activeTable: z.ZodString;
+    tables: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type RoutingTables = z.infer<typeof RoutingTablesSchema>;
+export declare const RouteStatsSchema: z.ZodObject<{
+    packets: z.ZodNumber;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;
+export type RouteStats = z.infer<typeof RouteStatsSchema>;
+export declare const InterfaceStatsSchema: z.ZodObject<{
+    rxPackets: z.ZodNumber;
+    txPackets: z.ZodNumber;
+    rxBytes: z.ZodNumber;
+    txBytes: z.ZodNumber;
+}, z.core.$strip>;
+export type InterfaceStats = z.infer<typeof InterfaceStatsSchema>;
+export declare const TrafficStatsSchema: 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>;
+export type TrafficStats = z.infer<typeof TrafficStatsSchema>;
+export 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;
+}
+/**
+ * Route traffic from specific apps through the gateway.
+ *
+ * This is the main entry point for traffic routing. It handles:
+ * 1. Setting up the per-app VPN to intercept traffic from specified apps
+ * 2. Optionally starting a tunnel (HTTP proxy, WireGuard, or OpenVPN)
+ * 3. Activating the route (tunnel type, or "direct" when no tunnel)
+ *
+ * When tunnel type is "direct", traffic flows through the gateway in direct mode
+ * (GOST SOCKS5 → internet). This is useful for network condition simulation
+ * without needing a proxy or VPN.
+ *
+ * Uses the Appium server's sessionless REST endpoint so no active WebDriver
+ * session is required. This allows routing to be set up *before* creating a
+ * browser session, giving the VPN time to become active.
+ *
+ * Appium URL is resolved from APPIUM_HOST / APPIUM_PORT env vars (default 127.0.0.1:4723).
+ *
+ * Returns a cleanup function that tears down everything in the correct order.
+ *
+ * @param config - Traffic routing configuration
+ * @returns Cleanup function to stop routing and tear down tunnel
+ *
+ * @example
+ * ```typescript
+ * // Direct mode — route through gateway without a tunnel
+ * const cleanup = await ios.routeTraffic({
+ *   apps: ["com.apple.mobilesafari"],
+ *   tunnel: { type: "direct" },
+ *   socksHost: "192.168.2.1",
+ * });
+ *
+ * // With a tunnel
+ * const cleanup = await ios.routeTraffic({
+ *   apps: ["com.apple.mobilesafari"],
+ *   domains: ["*.example.com"],
+ *   tunnel: {
+ *     type: "http-proxy",
+ *     host: "proxy.example.com",
+ *     port: 8080,
+ *   },
+ * });
+ *
+ * // ... run tests ...
+ *
+ * await cleanup();
+ * ```
+ */
+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>;
+export {};
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

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