@limrun/api 0.28.6 → 0.28.7

package/ios-shim.mjs

@@ -0,0 +1,346 @@
+import fs from 'fs';
+import http from 'http';
+import os from 'os';
+import path from 'path';
+const FORWARDED_SIMCTL_COMMANDS = new Set([
+    'openurl',
+    'launch',
+    'terminate',
+    'uninstall',
+    'privacy',
+    'location',
+    'status_bar',
+    'spawn',
+]);
+export async function startXcrunShim(client) {
+    const server = await startXcrunShimServer({ client, udid: client.deviceInfo.udid });
+    try {
+        const dir = await createXcrunShim({ shimUrl: server.url, udid: client.deviceInfo.udid });
+        return {
+            dir,
+            close: async () => {
+                await server.close();
+                fs.rmSync(dir, { recursive: true, force: true });
+            },
+        };
+    }
+    catch (error) {
+        await server.close().catch(() => { });
+        throw error;
+    }
+}
+export async function startXcrunShimServer({ client, udid, }) {
+    const server = http.createServer(async (req, res) => {
+        if (req.method !== 'POST' || req.url !== '/xcrun') {
+            sendJson(res, 404, { code: 127, stdout: '', stderr: 'not found' });
+            return;
+        }
+        try {
+            const body = (await readJson(req));
+            const args = body.args ?? [];
+            const result = await handleShimmedXcrun(client, udid, args);
+            sendJson(res, 200, result);
+        }
+        catch {
+            sendJson(res, 200, {
+                code: 1,
+                stdout: '',
+                stderr: 'limrun xcrun shim failed to execute the requested command.',
+            });
+        }
+    });
+    await listen(server, 0);
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        throw new Error('Failed to start Limrun xcrun shim server.');
+    }
+    return {
+        url: `http://127.0.0.1:${address.port}/xcrun`,
+        close: () => closeServer(server),
+    };
+}
+export async function createXcrunShim(options) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'limrun-xcrun-shim-'));
+    const shimPath = path.join(dir, 'xcrun');
+    fs.writeFileSync(shimPath, xcrunShimSource(options), 'utf8');
+    fs.chmodSync(shimPath, 0o755);
+    return dir;
+}
+async function handleShimmedXcrun(client, udid, args) {
+    if (args[0] !== 'simctl') {
+        return { code: 127, stdout: '', stderr: `unsupported xcrun command: ${args.join(' ')}` };
+    }
+    const simctlArgs = args.slice(1);
+    const command = simctlArgs[0];
+    const target = simctlTarget(command, simctlArgs);
+    if (command === 'list') {
+        // Maestro's device picker expects the full CoreSimulator JSON shape. Limrun
+        // only has one remote simulator in this context, so we synthesize that entry.
+        return simctlList(client.deviceInfo.udid, simctlArgs);
+    }
+    if (!isLimrunTarget(target, udid)) {
+        return { code: 64, stdout: '', stderr: `unsupported non-Limrun simctl target '${target ?? ''}'.` };
+    }
+    if (command === 'listapps') {
+        const apps = await client.listApps();
+        return {
+            code: 0,
+            stdout: `${JSON.stringify(toSimctlListApps(apps))}\n`,
+            stderr: '',
+        };
+    }
+    if (command === 'install') {
+        const appPath = simctlArgs[2];
+        if (!appPath) {
+            return { code: 64, stdout: '', stderr: 'simctl install requires a local .app path.' };
+        }
+        await client.syncApp(appPath, { install: true, watch: false });
+        return { code: 0, stdout: '', stderr: '' };
+    }
+    const unsupported = unsupportedPathBearingCommand(command);
+    if (unsupported) {
+        return unsupported;
+    }
+    if (!command || !FORWARDED_SIMCTL_COMMANDS.has(command)) {
+        return { code: 64, stdout: '', stderr: `limrun xcrun shim does not support simctl ${command ?? ''}.` };
+    }
+    return await client.simctl(simctlArgs).wait();
+}
+function simctlList(udid, simctlArgs) {
+    if (!simctlArgs.includes('-j')) {
+        return { code: 64, stdout: '', stderr: 'limrun xcrun shim only supports `xcrun simctl list -j`.' };
+    }
+    return {
+        code: 0,
+        stdout: `${JSON.stringify(toSimctlList(udid))}\n`,
+        stderr: '',
+    };
+}
+function unsupportedPathBearingCommand(command) {
+    // These commands either return local simulator filesystem paths or consume
+    // host-side media files. They need explicit staging/translation before they
+    // are safe to claim as supported.
+    if (command === 'get_app_container') {
+        return {
+            code: 64,
+            stdout: '',
+            stderr: 'limrun xcrun shim does not support get_app_container because upstream tools expect a local filesystem path.',
+        };
+    }
+    if (command === 'keychain') {
+        return { code: 64, stdout: '', stderr: 'limrun xcrun shim does not support simctl keychain in v1.' };
+    }
+    if (command === 'io') {
+        return {
+            code: 64,
+            stdout: '',
+            stderr: 'limrun xcrun shim does not support simctl io recordVideo in v1.',
+        };
+    }
+    if (command === 'push' || command === 'addmedia') {
+        return {
+            code: 64,
+            stdout: '',
+            stderr: `limrun xcrun shim does not support path-bearing simctl ${command} in v1.`,
+        };
+    }
+    return undefined;
+}
+function isLimrunTarget(value, udid) {
+    return value === udid || value === 'booted';
+}
+function simctlTarget(command, simctlArgs) {
+    if (command === 'launch') {
+        return simctlArgs.slice(1).find((arg) => !arg.startsWith('-'));
+    }
+    return simctlArgs[1];
+}
+function toSimctlList(udid) {
+    const runtimeIdentifier = 'com.apple.CoreSimulator.SimRuntime.iOS-18-0';
+    const deviceTypeIdentifier = 'com.apple.CoreSimulator.SimDeviceType.iPhone-16-Pro';
+    return {
+        devices: {
+            [runtimeIdentifier]: [
+                {
+                    availability: '(available)',
+                    dataPath: `/tmp/limrun-sim/${udid}/data`,
+                    logPath: `/tmp/limrun-sim/${udid}/logs`,
+                    isAvailable: true,
+                    name: process.env['LIMRUN_IOS_DEVICE_NAME'] || 'Limrun iPhone',
+                    state: 'Booted',
+                    udid,
+                    deviceTypeIdentifier,
+                    availabilityError: null,
+                },
+            ],
+        },
+        devicetypes: [
+            {
+                bundlePath: '',
+                identifier: deviceTypeIdentifier,
+                maxRuntimeVersion: 999999,
+                maxRuntimeVersionString: null,
+                minRuntimeVersion: 0,
+                minRuntimeVersionString: null,
+                modelIdentifier: 'iPhone17,1',
+                name: 'iPhone 16 Pro',
+                productFamily: 'iPhone',
+            },
+        ],
+        pairs: {},
+        runtimes: [
+            {
+                availability: '(available)',
+                bundlePath: '',
+                buildversion: '22A000',
+                identifier: runtimeIdentifier,
+                isInternal: false,
+                isAvailable: true,
+                name: process.env['LIMRUN_IOS_RUNTIME_NAME'] || 'iOS 18.0',
+                platform: 'iOS',
+                runtimeRoot: '',
+                supportedDeviceTypes: [],
+                version: '18.0',
+            },
+        ],
+    };
+}
+function toSimctlListApps(apps) {
+    return Object.fromEntries(apps.map((app) => [
+        app.bundleId,
+        {
+            CFBundleIdentifier: app.bundleId,
+            ...(app.name ? { CFBundleName: app.name } : {}),
+        },
+    ]));
+}
+function xcrunShimSource(options) {
+    // Keep the executable tiny: it decides whether this is a Limrun-targeted
+    // simctl call, then asks the local shim server to perform the real work.
+    // Non-Limrun calls still delegate to the host xcrun.
+    const embeddedShimUrl = options ? JSON.stringify(options.shimUrl) : 'process.env.LIMRUN_XCRUN_SHIM_URL';
+    const embeddedUdid = options ? JSON.stringify(options.udid) : 'process.env.LIMRUN_IOS_UDID';
+    return `#!/usr/bin/env node
+const http = require('node:http');
+const { spawnSync } = require('node:child_process');
+
+const args = process.argv.slice(2);
+const realXcrun = process.env.LIMRUN_REAL_XCRUN || '/usr/bin/xcrun';
+
+function delegate() {
+  const result = spawnSync(realXcrun, args, { stdio: 'inherit' });
+  if (result.error) {
+    process.stderr.write(String(result.error.message || result.error) + '\\n');
+    process.exit(127);
+  }
+  process.exit(result.status ?? 1);
+}
+
+function fail(message) {
+  process.stderr.write('limrun xcrun shim: ' + message + '\\n');
+  process.exit(64);
+}
+
+if (args[0] !== 'simctl') {
+  delegate();
+}
+
+const shimUrl = ${embeddedShimUrl};
+const udid = ${embeddedUdid};
+if (!shimUrl || !udid) {
+  fail('LIMRUN_XCRUN_SHIM_URL and LIMRUN_IOS_UDID are required.');
+}
+
+const simctlArgs = args.slice(1);
+const command = simctlArgs[0];
+function simctlTarget(command, simctlArgs) {
+  if (command === 'launch') {
+    return simctlArgs.slice(1).find((arg) => !arg.startsWith('-'));
+  }
+  return simctlArgs[1];
+}
+const target = simctlTarget(command, simctlArgs);
+function isLimrunTarget(value) {
+  return value === udid || value === 'booted';
+}
+
+if (command !== 'list' && !isLimrunTarget(target)) {
+  delegate();
+}
+
+const parsed = new URL(shimUrl);
+const body = JSON.stringify({ args });
+const req = http.request(parsed, {
+  method: 'POST',
+  headers: {
+    'content-type': 'application/json',
+    'content-length': Buffer.byteLength(body),
+  },
+}, (res) => {
+  const chunks = [];
+  res.on('data', (chunk) => chunks.push(chunk));
+  res.on('end', () => {
+    let payload;
+    try {
+      payload = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    } catch (error) {
+      process.stderr.write('limrun xcrun shim: invalid shim response\\n');
+      process.exit(1);
+    }
+    if (payload.stdout) process.stdout.write(payload.stdout);
+    if (payload.stderr) process.stderr.write(payload.stderr);
+    process.exit(typeof payload.code === 'number' ? payload.code : 1);
+  });
+});
+req.on('error', (error) => {
+  process.stderr.write('limrun xcrun shim: ' + error.message + '\\n');
+  process.exit(1);
+});
+req.end(body);
+`;
+}
+function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '127.0.0.1', () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+function readJson(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        req.on('end', () => {
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}'));
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function sendJson(res, statusCode, payload) {
+    const body = JSON.stringify(payload);
+    res.writeHead(statusCode, {
+        'content-type': 'application/json',
+        'content-length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+//# sourceMappingURL=ios-shim.mjs.map

package/ios-shim.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limrun/api",
-  "version": "0.28.6",
+  "version": "0.28.7",
   "description": "The official TypeScript library for the Limrun API",
   "author": "Limrun <contact@limrun.com>",
   "types": "./index.d.ts",
@@ -133,6 +133,16 @@
     "./folder-sync.mjs": {
       "default": "./folder-sync.mjs"
     },
+    "./http-proxy": {
+      "import": "./http-proxy.mjs",
+      "require": "./http-proxy.js"
+    },
+    "./http-proxy.js": {
+      "default": "./http-proxy.js"
+    },
+    "./http-proxy.mjs": {
+      "default": "./http-proxy.mjs"
+    },
     "./index": {
       "import": "./index.mjs",
       "require": "./index.js"
@@ -163,6 +173,16 @@
     "./ios-client.mjs": {
       "default": "./ios-client.mjs"
     },
+    "./ios-shim": {
+      "import": "./ios-shim.mjs",
+      "require": "./ios-shim.js"
+    },
+    "./ios-shim.js": {
+      "default": "./ios-shim.js"
+    },
+    "./ios-shim.mjs": {
+      "default": "./ios-shim.mjs"
+    },
     "./pagination": {
       "import": "./pagination.mjs",
       "require": "./pagination.js"

package/src/http-proxy.ts

@@ -0,0 +1,85 @@
+import http from 'http';
+import https from 'https';
+
+export type HttpProxy = {
+  port: number;
+  close: () => Promise<void>;
+};
+
+export type StartHttpProxyOptions = {
+  localPort?: number;
+  remoteBaseUrl: string;
+  headers?: Record<string, string>;
+};
+
+export async function startHttpProxy({
+  localPort = 0,
+  remoteBaseUrl,
+  headers = {},
+}: StartHttpProxyOptions): Promise<HttpProxy> {
+  const base = trimTrailingSlashes(remoteBaseUrl);
+  const server = http.createServer((req, res) => {
+    const pathAndQuery = req.url || '/';
+    const upstreamUrl = new URL(`${base}${pathAndQuery.startsWith('/') ? pathAndQuery : `/${pathAndQuery}`}`);
+    const transport = upstreamUrl.protocol === 'https:' ? https : http;
+    const upstream = transport.request(
+      upstreamUrl,
+      {
+        method: req.method,
+        headers: {
+          ...req.headers,
+          host: upstreamUrl.host,
+          ...headers,
+        },
+      },
+      (upstreamResponse) => {
+        res.writeHead(upstreamResponse.statusCode ?? 502, upstreamResponse.headers);
+        upstreamResponse.pipe(res);
+      },
+    );
+
+    upstream.on('error', (error) => {
+      if (!res.headersSent) {
+        res.writeHead(502, { 'content-type': 'text/plain' });
+      }
+      res.end(error.message);
+    });
+    req.pipe(upstream);
+  });
+
+  await listen(server, localPort);
+  const address = server.address();
+  if (!address || typeof address === 'string') {
+    throw new Error('Failed to start HTTP proxy.');
+  }
+  return {
+    port: address.port,
+    close: () => closeServer(server),
+  };
+}
+
+function trimTrailingSlashes(value: string): string {
+  return value.replace(/\/+$/, '');
+}
+
+function listen(server: http.Server, port: number): Promise<void> {
+  return new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen(port, '127.0.0.1', () => {
+      server.off('error', reject);
+      resolve();
+    });
+  });
+}
+
+function closeServer(server: http.Server): Promise<void> {
+  return new Promise((resolve, reject) => {
+    server.close((error) => {
+      if (error) {
+        reject(error);
+      } else {
+        resolve();
+      }
+    });
+  });
+}

package/src/index.ts

@@ -8,6 +8,7 @@ export { Limrun, type ClientOptions } from './client';
 export { PagePromise } from './core/pagination';
 export * from './instance-client';
 export * as Ios from './ios-client';
+export { startHttpProxy, type HttpProxy, type StartHttpProxyOptions } from './http-proxy';
 export {
   exec,
   type ExecRequest,

package/src/ios-client.ts

@@ -9,6 +9,8 @@ import { type SyncFolderResult, type FolderSyncOptions, syncFolder } from './fol
 import { createIgnoreFn } from './folder-sync-ignore';
 import { downloadFileToLocalPath } from './internal/download-file';
 import { nodeProxyTransport } from './internal/proxy-transport';
+import { startHttpProxy as startLocalHttpProxy } from './http-proxy';
+import { startXcrunShim as startClientXcrunShim } from './ios-shim';
 
 /**
  * Connection state of the instance client
@@ -198,6 +200,11 @@ export type AppInstallationResult = {
   bundleId: string;
 };
 
+export type HttpProxyOptions = {
+  remoteBaseUrl: string;
+  localPort: number;
+};
+
 /**
  * Result of auto-discovering a StoreKit configuration from the
  * simulator's cached sandbox response.
@@ -695,6 +702,14 @@ export type InstanceClient = {
    */
   startReverseTunnel: (options: ReverseTunnelOptions) => Promise<ReverseTunnel>;
 
+  /**
+   * Start a local HTTP proxy to a port exposed by the iOS instance.
+   *
+   * Returns the local port the proxy is listening on. The proxy is closed when
+   * the client disconnects.
+   */
+  startHttpProxy: (options: HttpProxyOptions) => Promise<number>;
+
   /**
    * Disconnect from the Limrun instance
    */
@@ -791,6 +806,14 @@ export type InstanceClient = {
    */
   xcrun: (args: string[]) => Promise<CommandResult>;
 
+  /**
+   * Start a local `xcrun` shim for this iOS instance.
+   *
+   * The returned directory contains an `xcrun` executable that can be prepended
+   * to PATH for tools that shell out to `xcrun simctl`.
+   */
+  startXcrunShim: () => Promise<string>;
+
   /**
    * Run `xcodebuild` command with the given arguments.
    * Returns the complete output once the command finishes (non-streaming).
@@ -1257,6 +1280,9 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
   // Simctl uses streaming, so it needs separate handling
   const simctlExecutions: Map<string, SimctlExecution> = new Map();
 
+  const xcrunShimCleanups: Array<() => Promise<void>> = [];
+  const httpProxyCleanups: Array<() => Promise<void>> = [];
+
   const stateChangeCallbacks: Set<ConnectionStateCallback> = new Set();
 
   // Logger functions
@@ -1300,7 +1326,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
     simctlExecutions.clear();
   };
 
-  const cleanup = (): void => {
+  const cleanupConnection = (): void => {
     if (reconnectTimeout) {
       clearTimeout(reconnectTimeout);
       reconnectTimeout = undefined;
@@ -1318,6 +1344,22 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
     }
   };
 
+  const cleanupClientResources = (): void => {
+    const shimCleanups = xcrunShimCleanups.splice(0);
+    for (const closeShim of shimCleanups) {
+      closeShim().catch((error) => logger.warn('Failed to close xcrun shim:', error));
+    }
+    const proxyCleanups = httpProxyCleanups.splice(0);
+    for (const closeProxy of proxyCleanups) {
+      closeProxy().catch((error) => logger.warn('Failed to close HTTP proxy:', error));
+    }
+  };
+
+  const cleanup = (): void => {
+    cleanupConnection();
+    cleanupClientResources();
+  };
+
   let pingInterval: NodeJS.Timeout | undefined;
   const keepAliveSessionId =
     Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
@@ -1469,7 +1511,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
     };
 
     const setupWebSocket = (): void => {
-      cleanup();
+      cleanupConnection();
       updateConnectionState('connecting');
 
       const proxyAgent = nodeProxyTransport.getWebSocketAgent(endpointWebSocketUrl);
@@ -1638,11 +1680,13 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
             discoverStoreKitConfig,
             softReset,
             startReverseTunnel,
+            startHttpProxy,
             disconnect,
             getConnectionState,
             onConnectionStateChange,
             simctl,
             xcrun,
+            startXcrunShim,
             xcodebuild,
             cp,
             lsof,
@@ -1911,6 +1955,17 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       return sendRequest<CommandResult>('xcrun', { args });
     };
 
+    const startXcrunShim = async (): Promise<string> => {
+      const shim = await startClientXcrunShim({
+        deviceInfo: cachedDeviceInfo,
+        listApps,
+        simctl,
+        syncApp,
+      });
+      xcrunShimCleanups.push(shim.close);
+      return shim.dir;
+    };
+
     const xcodebuild = (args: string[]): Promise<CommandResult> => {
       return sendRequest<CommandResult>('xcodebuild', { args });
     };
@@ -2135,6 +2190,20 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       });
     };
 
+    const startHttpProxy = async (proxyOptions: HttpProxyOptions): Promise<number> => {
+      assertPort(proxyOptions.localPort, 'localPort', 1, 65535);
+
+      const proxy = await startLocalHttpProxy({
+        localPort: proxyOptions.localPort,
+        remoteBaseUrl: proxyOptions.remoteBaseUrl,
+        headers: {
+          authorization: `Bearer ${options.token}`,
+        },
+      });
+      httpProxyCleanups.push(proxy.close);
+      return proxy.port;
+    };
+
     const disconnect = (): void => {
       intentionalDisconnect = true;
       cleanup();