@limrun/api 0.24.0 → 0.24.1

package/src/ios-client.ts

@@ -20,17 +20,10 @@ export type ConnectionState = 'connecting' | 'connected' | 'disconnected' | 'rec
  */
 export type ConnectionStateCallback = (state: ConnectionState) => void;
 
-function generateRecordingFilename(): string {
-  const rand = Math.random().toString(36).slice(2, 5).padEnd(3, '0');
-  const now = new Date();
-  const formattedDate = now.toISOString().replace(/[-:]/g, '_').replace('T', '_').replace(/\..+/, '');
+const ACTIVE_RECORDING_FILENAME = 'recording.mp4';
 
-  // Example: 20240602_17_45_30 for June 2, 2024 17:45:30 UTC
-  return `ios_video_${formattedDate}_${rand}.mp4`;
-}
-
-function buildDownloadUrl(apiUrl: string, filename: string): string {
-  return `${apiUrl}/files?name=${encodeURIComponent(filename)}`;
+function buildDownloadUrl(apiUrl: string): string {
+  return `${apiUrl}/files?name=${encodeURIComponent(ACTIVE_RECORDING_FILENAME)}`;
 }
 
 /**
@@ -316,8 +309,10 @@ export type InstanceClient = {
 
   /**
    * Start recording simulator video. Use stopRecording() to stop the recording.
+   * When provided, `quality` must be one of `5`, `6`, `7`, `8`, `9`, or `10`.
+   * The server default is `5`.
    */
-  startRecording: () => Promise<void>;
+  startRecording: (options?: { quality?: RecordingQuality }) => Promise<void>;
 
   /**
    * Stop the active recording for this client instance.
@@ -485,6 +480,15 @@ export type InstanceClient = {
  */
 export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
 
+export enum RecordingQuality {
+  Q5 = 5,
+  Q6 = 6,
+  Q7 = 7,
+  Q8 = 8,
+  Q9 = 9,
+  Q10 = 10,
+}
+
 /**
  * Configuration options for creating an iOS client
  */
@@ -894,7 +898,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
   let reconnectTimeout: NodeJS.Timeout | undefined;
   let intentionalDisconnect = false;
   let lastError: string | undefined;
-  let activeRecordingFilename: string | undefined;
+  let hasActiveRecording = false;
 
   // Centralized pending requests map - handles all request/response patterns
   const pendingRequests: Map<string, PendingRequest<any>> = new Map();
@@ -1074,9 +1078,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
         bundleId: msg.bundleId || '',
       }),
       startVideoRecordingResult: () => undefined,
-      stopVideoRecordingResult: (msg) => ({
-        filename: msg.filename || '',
-      }),
+      stopVideoRecordingResult: () => undefined,
       setOrientationResult: () => undefined,
       scrollResult: () => undefined,
       xcrunResult: (msg): CommandResult => ({
@@ -1393,41 +1395,42 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       });
     };
 
-    const startRecording = async (): Promise<void> => {
-      if (activeRecordingFilename) {
-        throw new Error(`A recording is already active for this client: ${activeRecordingFilename}`);
+    const startRecording = async (opts?: { quality?: RecordingQuality }): Promise<void> => {
+      if (hasActiveRecording) {
+        throw new Error('A recording is already active for this client');
       }
-      const finalFilename = generateRecordingFilename();
-      activeRecordingFilename = finalFilename;
+      hasActiveRecording = true;
       try {
-        await sendRequest<void>('startVideoRecording', { filename: finalFilename });
-      } catch (error) {
-        if (activeRecordingFilename === finalFilename) {
-          activeRecordingFilename = undefined;
+        const request: { quality?: RecordingQuality } = {};
+        if (opts?.quality !== undefined) {
+          if (!Number.isInteger(opts.quality) || opts.quality < 5 || opts.quality > 10) {
+            throw new Error('quality must be one of: 5, 6, 7, 8, 9, 10');
+          }
+          request.quality = opts.quality;
         }
+        await sendRequest<void>('startVideoRecording', request);
+      } catch (error) {
+        hasActiveRecording = false;
         throw error;
       }
     };
 
     const stopRecording = async (saveTo: { presignedUrl?: string; localPath?: string }): Promise<string> => {
-      const filename = activeRecordingFilename;
-      if (!filename) {
+      if (!hasActiveRecording) {
         throw new Error('No active recording for this client. Call startRecording() first.');
       }
-      const result = await sendRequest<{ filename: string }>('stopVideoRecording', {
-        filename,
+      await sendRequest<void>('stopVideoRecording', {
         upload: saveTo.presignedUrl ? { presignedUrl: saveTo.presignedUrl } : undefined,
       });
-      const finalFilename = result.filename || filename;
-      const downloadUrl = buildDownloadUrl(options.apiUrl, finalFilename);
+      const downloadUrl = buildDownloadUrl(options.apiUrl);
       if (saveTo.localPath) {
         try {
           await downloadFileToLocalPath(downloadUrl, options.token, saveTo.localPath);
         } finally {
-          activeRecordingFilename = undefined;
+          hasActiveRecording = false;
         }
       } else {
-        activeRecordingFilename = undefined;
+        hasActiveRecording = false;
       }
       return downloadUrl;
     };

package/src/resources/index.ts

@@ -23,7 +23,6 @@ export {
   type IosInstancesItems,
 } from './ios-instances';
 export {
-  XcodeInstances,
   type XcodeInstance,
   type XcodeInstanceCreateParams,
   type XcodeInstanceListParams,
@@ -31,3 +30,10 @@ export {
 } from './xcode-instances';
 
 export { Assets, AssetGetOrUploadParams, AssetGetOrUploadResponse } from './assets-helpers';
+export {
+  XcodeInstances,
+  type XcodeCreateClientParams,
+  type XcodeClient,
+  type XcodeProjectConfig,
+  type XcodeBuildOptions,
+} from './xcode-instances-helpers';

package/src/resources/xcode-instances-helpers.ts

@@ -0,0 +1,228 @@
+import os from 'os';
+import path from 'path';
+import crypto from 'crypto';
+
+import { XcodeInstances as GeneratedXcodeInstances, type XcodeInstance } from './xcode-instances';
+import { type IosInstance } from './ios-instances';
+import { exec, type ExecChildProcess, type ExecRequest } from '../exec-client';
+import { syncFolder as syncFolderImpl, type FolderSyncOptions } from '../folder-sync';
+import { createIgnoreFn } from '../folder-sync-ignore';
+import { nodeProxyTransport } from '../internal/proxy-transport';
+
+export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
+
+export type SyncOptions = {
+  /**
+   * If true, watch the folder and re-sync on any changes. Defaults to true.
+   */
+  watch?: boolean;
+  /**
+   * Directory for the client-side folder-sync cache.
+   * Defaults to a temporary directory under the OS temp directory.
+   */
+  basisCacheDir?: string;
+  /** Max patch size (bytes) to send as delta before falling back to full upload. */
+  maxPatchBytes?: number;
+  /** If true, install the app after syncing. Defaults to true. */
+  install?: boolean;
+  /**
+   * Optional predicate for ignoring files and directories during sync.
+   * Called with the relative path from the sync root (using forward slashes).
+   * For directories, the path ends with '/'.
+   * Return true to ignore, false to keep.
+   */
+  ignore?: (relativePath: string) => boolean;
+};
+
+export type SyncResult = {
+  /** Present only when watch=true; call to stop watching */
+  stopWatching?: () => void;
+};
+
+export type XcodeProjectConfig = {
+  workspace?: string;
+  project?: string;
+  scheme?: string;
+};
+
+export type XcodeBuildOptions = {
+  upload?: { assetName: string };
+};
+
+export type XcodeClient = {
+  /**
+   * Sync source code to the xcode instance. In watch mode, keeps syncing on changes.
+   */
+  sync: (localCodePath: string, opts?: SyncOptions) => Promise<SyncResult>;
+
+  /**
+   * Trigger xcodebuild on the synced source code.
+   * Returns a ChildProcess-like object for streaming output.
+   *
+   * @example
+   * const build = xcode.xcodebuild({ scheme: 'MyApp' });
+   * build.stdout.on('data', (line) => console.log(line));
+   * const { exitCode } = await build;
+   */
+  xcodebuild: (settings?: XcodeProjectConfig, options?: XcodeBuildOptions) => ExecChildProcess;
+
+  /**
+   * Attach a simulator to this xcode instance.
+   * After attaching, builds will auto-install on the simulator.
+   */
+  attachSimulator: (simulator: IosInstance | { apiUrl: string; token: string }) => Promise<void>;
+};
+
+export type XcodeCreateClientParams =
+  | { instance: XcodeInstance; logLevel?: LogLevel }
+  | { apiUrl: string; token: string; logLevel?: LogLevel };
+
+function createLogger(logLevel: LogLevel) {
+  const shouldLog = (level: LogLevel) => {
+    const levels: LogLevel[] = ['none', 'error', 'warn', 'info', 'debug'];
+    return levels.indexOf(logLevel) >= levels.indexOf(level);
+  };
+  return (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => {
+    if (!shouldLog(level)) return;
+    const prefix = '[XcodeInstance]';
+    if (level === 'error' || level === 'warn') {
+      console[level](prefix, msg);
+    } else {
+      console.log(prefix, msg);
+    }
+  };
+}
+
+export class XcodeInstances extends GeneratedXcodeInstances {
+  async createClient(params: XcodeCreateClientParams): Promise<XcodeClient> {
+    let apiUrl: string;
+    let token: string;
+    if ('instance' in params) {
+      if (!params.instance.status.apiUrl) {
+        throw new Error('Instance not ready: apiUrl is not available');
+      }
+      apiUrl = params.instance.status.apiUrl;
+      token = params.instance.status.token;
+    } else {
+      apiUrl = params.apiUrl;
+      token = params.token;
+    }
+
+    const log = createLogger(params.logLevel ?? 'info');
+    const client = this._client;
+
+    return {
+      async sync(localCodePath: string, opts?: SyncOptions): Promise<SyncResult> {
+        const resolvedPath = path.resolve(localCodePath);
+        const folderName = path.basename(resolvedPath);
+        const hash = crypto.createHash('sha1').update(resolvedPath).digest('hex').slice(0, 8);
+        const cacheKey = `limsync-cache-${folderName}-${hash}`;
+        const basisCacheDir = opts?.basisCacheDir ?? path.join(os.tmpdir(), cacheKey);
+        const codeSyncOpts: FolderSyncOptions = {
+          apiUrl,
+          token,
+          udid: cacheKey,
+          install: opts?.install ?? true,
+          ignoreFn: await createIgnoreFn(localCodePath, {
+            basisCacheDir,
+            additional: (relativePath: string) => {
+              if (
+                relativePath.startsWith('build/') ||
+                relativePath.startsWith('.build/') ||
+                relativePath.startsWith('DerivedData/') ||
+                relativePath.startsWith('Index.noindex/') ||
+                relativePath.startsWith('ModuleCache.noindex/') ||
+                relativePath.startsWith('.index-build/')
+              ) {
+                return true;
+              }
+              if (
+                relativePath.startsWith('.swiftpm/') ||
+                relativePath.startsWith('Pods/') ||
+                relativePath.startsWith('Carthage/Build/')
+              ) {
+                return true;
+              }
+              if (relativePath.includes('/xcuserdata/')) {
+                return true;
+              }
+              if (relativePath.includes('.dSYM/')) {
+                return true;
+              }
+              if (opts?.ignore?.(relativePath)) {
+                return true;
+              }
+              return false;
+            },
+          }),
+          basisCacheDir,
+          watch: opts?.watch ?? true,
+          maxPatchBytes: opts?.maxPatchBytes ?? 4 * 1024 * 1024,
+          launchMode: 'ForegroundIfRunning',
+          log,
+        };
+
+        const result = await syncFolderImpl(localCodePath, codeSyncOpts);
+        if (result.stopWatching) {
+          return { stopWatching: result.stopWatching };
+        }
+        return {};
+      },
+
+      xcodebuild(settings?: XcodeProjectConfig, options?: XcodeBuildOptions): ExecChildProcess {
+        const request: ExecRequest = {
+          command: 'xcodebuild',
+          ...(settings && { xcodebuild: settings }),
+        };
+
+        if (options?.upload) {
+          const uploadName = options.upload.assetName;
+          const requestPromise = client.assets
+            .getOrCreate({ name: uploadName })
+            .then((asset) => {
+              request.signedUploadUrl = asset.signedUploadUrl;
+              return request;
+            })
+            .catch((err) => {
+              throw new Error(
+                `Failed to create upload URL for artifact '${uploadName}': ${
+                  err instanceof Error ? err.message : err
+                }`,
+              );
+            });
+          return exec(requestPromise, { apiUrl, token, log });
+        }
+
+        return exec(request, { apiUrl, token, log });
+      },
+
+      async attachSimulator(simulator: IosInstance | { apiUrl: string; token: string }): Promise<void> {
+        let simApiUrl: string;
+        let simToken: string;
+        if ('status' in simulator) {
+          if (!simulator.status.apiUrl) {
+            throw new Error('Simulator instance not ready: apiUrl is not available');
+          }
+          simApiUrl = simulator.status.apiUrl;
+          simToken = simulator.status.token;
+        } else {
+          simApiUrl = simulator.apiUrl;
+          simToken = simulator.token;
+        }
+
+        const res = await nodeProxyTransport.fetch(`${apiUrl}/simulator`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+          },
+          body: JSON.stringify({ apiUrl: simApiUrl, token: simToken }),
+        });
+        if (!res.ok) {
+          const text = await res.text();
+          throw new Error(`POST /simulator failed: ${res.status} ${text}`);
+        }
+      },
+    };
+  }
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.24.0'; // x-release-please-version
+export const VERSION = '0.24.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.24.0";
+export declare const VERSION = "0.24.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.24.0";
+export declare const VERSION = "0.24.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.24.0'; // x-release-please-version
+exports.VERSION = '0.24.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.24.0'; // x-release-please-version
+export const VERSION = '0.24.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/sandbox-client.d.mts

@@ -1,129 +0,0 @@
-import { ExecChildProcess } from "./exec-client.mjs";
-export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
-/**
- * Build configuration for xcodebuild command.
- */
-export type XcodeBuildConfig = {
-    workspace?: string;
-    project?: string;
-    scheme?: string;
-};
-/**
- * Simulator connection details for configuring the sandbox.
- */
-export type SimulatorConfig = {
-    /** The API URL of the simulator (limulator) */
-    apiUrl: string;
-    /** Auth token for the simulator. If not provided, uses the sandbox token. */
-    token?: string;
-};
-/**
- * Options for syncing source code to the sandbox.
- */
-export type SyncOptions = {
-    /**
-     * If true, watch the folder and re-sync on any changes. Defaults to true.
-     */
-    watch?: boolean;
-    /**
-     * Directory for the client-side folder-sync cache.
-     * Used to store the last-synced “basis” copies of files (and related sync metadata) so we can compute xdelta patches
-     * on subsequent syncs without re-downloading server state.
-     *
-     * Defaults to a temporary directory under the OS temp directory.
-     */
-    basisCacheDir?: string;
-    /** Max patch size (bytes) to send as delta before falling back to full upload. */
-    maxPatchBytes?: number;
-    /** If true, install the app after syncing. Defaults to true. */
-    install?: boolean;
-    /**
-     * Optional predicate for ignoring files and directories during sync.
-     * Applied in addition to built-in sync and Xcode-specific ignore rules.
-     * Called with the relative path from the sync root (using forward slashes).
-     * For directories, the path ends with '/'.
-     * Return true to ignore, false to keep.
-     *
-     * @example
-     * // Ignore build folder
-     * ignore: (path) => path.startsWith('build/')
-     *
-     * @example
-     * // Ignore anything outside src/ and JSON files
-     * ignore: (path) => !(path.startsWith('src/') || path.endsWith('.json'))
-     */
-    ignore?: (relativePath: string) => boolean;
-};
-/**
- * Result of a sync operation.
- */
-export type SyncResult = {
-    /** Present only when watch=true; call to stop watching */
-    stopWatching?: () => void;
-};
-/**
- * Client for interacting with a sandboxed Xcode build service.
- */
-export type XCodeSandboxClient = {
-    /**
-     * Sync source code to the sandbox. In watch mode, keeps syncing on changes.
-     * Does NOT trigger builds - call xcodebuild() when ready.
-     */
-    sync: (localCodePath: string, opts?: SyncOptions) => Promise<SyncResult>;
-    /**
-     * Trigger xcodebuild on the synced source code.
-     * Returns a ChildProcess-like object for streaming output.
-     *
-     * @example
-     * // Stream build output
-     * const build = client.xcodebuild();
-     * build.stdout.on('data', (line) => console.log(line));
-     * const { exitCode } = await build;
-     */
-    xcodebuild: (opts?: XcodeBuildConfig) => ExecChildProcess;
-};
-export type CreateXCodeSandboxClientOptions = {
-    /** The API URL of the Xcode sandbox server */
-    apiUrl: string;
-    /** Auth token for the sandbox */
-    token: string;
-    /**
-     * Simulator (limulator) connection details. Only needed if the sandbox is not
-     * already configured (e.g., when created outside of an iOS instance).
-     * When provided, the client will call POST /simulator to set up the connection.
-     */
-    simulator?: SimulatorConfig;
-    /**
-     * Controls logging verbosity
-     * @default 'info'
-     */
-    logLevel?: LogLevel;
-};
-/**
- * Creates a client for interacting with a sandboxed Xcode build service.
- *
- * @example
- * // When using an iOS instance (simulator already configured):
- * const client = await createXCodeSandboxClient({
- *   apiUrl: instance.status.sandbox.xcode.url,
- *   token: apiKey,
- * });
- *
- * // When using a standalone sandbox (need to configure simulator):
- * const client = await createXCodeSandboxClient({
- *   apiUrl: 'https://sandbox.example.com',
- *   token: 'xxx',
- *   simulator: {
- *     apiUrl: 'https://limulator.example.com',
- *     token: 'yyy', // optional, defaults to sandbox token
- *   },
- * });
- *
- * // Sync code and build
- * await client.sync('./my-ios-app', { watch: true });
- * const build = client.xcodebuild();
- * build.stdout.on('data', (line) => console.log('[build]', line));
- * const { exitCode } = await build;
- */
-export declare function createXCodeSandboxClient(options: CreateXCodeSandboxClientOptions): Promise<XCodeSandboxClient>;
-//# sourceMappingURL=sandbox-client.d.mts.map

package/sandbox-client.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox-client.d.mts","sourceRoot":"","sources":["src/sandbox-client.ts"],"names":[],"mappings":"OAGO,EAAQ,gBAAgB,EAAE;AAKjC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzE;;;;;;;;;OASG;IACH,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAqI7B"}

package/sandbox-client.d.ts

@@ -1,129 +0,0 @@
-import { ExecChildProcess } from "./exec-client.js";
-export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
-/**
- * Build configuration for xcodebuild command.
- */
-export type XcodeBuildConfig = {
-    workspace?: string;
-    project?: string;
-    scheme?: string;
-};
-/**
- * Simulator connection details for configuring the sandbox.
- */
-export type SimulatorConfig = {
-    /** The API URL of the simulator (limulator) */
-    apiUrl: string;
-    /** Auth token for the simulator. If not provided, uses the sandbox token. */
-    token?: string;
-};
-/**
- * Options for syncing source code to the sandbox.
- */
-export type SyncOptions = {
-    /**
-     * If true, watch the folder and re-sync on any changes. Defaults to true.
-     */
-    watch?: boolean;
-    /**
-     * Directory for the client-side folder-sync cache.
-     * Used to store the last-synced “basis” copies of files (and related sync metadata) so we can compute xdelta patches
-     * on subsequent syncs without re-downloading server state.
-     *
-     * Defaults to a temporary directory under the OS temp directory.
-     */
-    basisCacheDir?: string;
-    /** Max patch size (bytes) to send as delta before falling back to full upload. */
-    maxPatchBytes?: number;
-    /** If true, install the app after syncing. Defaults to true. */
-    install?: boolean;
-    /**
-     * Optional predicate for ignoring files and directories during sync.
-     * Applied in addition to built-in sync and Xcode-specific ignore rules.
-     * Called with the relative path from the sync root (using forward slashes).
-     * For directories, the path ends with '/'.
-     * Return true to ignore, false to keep.
-     *
-     * @example
-     * // Ignore build folder
-     * ignore: (path) => path.startsWith('build/')
-     *
-     * @example
-     * // Ignore anything outside src/ and JSON files
-     * ignore: (path) => !(path.startsWith('src/') || path.endsWith('.json'))
-     */
-    ignore?: (relativePath: string) => boolean;
-};
-/**
- * Result of a sync operation.
- */
-export type SyncResult = {
-    /** Present only when watch=true; call to stop watching */
-    stopWatching?: () => void;
-};
-/**
- * Client for interacting with a sandboxed Xcode build service.
- */
-export type XCodeSandboxClient = {
-    /**
-     * Sync source code to the sandbox. In watch mode, keeps syncing on changes.
-     * Does NOT trigger builds - call xcodebuild() when ready.
-     */
-    sync: (localCodePath: string, opts?: SyncOptions) => Promise<SyncResult>;
-    /**
-     * Trigger xcodebuild on the synced source code.
-     * Returns a ChildProcess-like object for streaming output.
-     *
-     * @example
-     * // Stream build output
-     * const build = client.xcodebuild();
-     * build.stdout.on('data', (line) => console.log(line));
-     * const { exitCode } = await build;
-     */
-    xcodebuild: (opts?: XcodeBuildConfig) => ExecChildProcess;
-};
-export type CreateXCodeSandboxClientOptions = {
-    /** The API URL of the Xcode sandbox server */
-    apiUrl: string;
-    /** Auth token for the sandbox */
-    token: string;
-    /**
-     * Simulator (limulator) connection details. Only needed if the sandbox is not
-     * already configured (e.g., when created outside of an iOS instance).
-     * When provided, the client will call POST /simulator to set up the connection.
-     */
-    simulator?: SimulatorConfig;
-    /**
-     * Controls logging verbosity
-     * @default 'info'
-     */
-    logLevel?: LogLevel;
-};
-/**
- * Creates a client for interacting with a sandboxed Xcode build service.
- *
- * @example
- * // When using an iOS instance (simulator already configured):
- * const client = await createXCodeSandboxClient({
- *   apiUrl: instance.status.sandbox.xcode.url,
- *   token: apiKey,
- * });
- *
- * // When using a standalone sandbox (need to configure simulator):
- * const client = await createXCodeSandboxClient({
- *   apiUrl: 'https://sandbox.example.com',
- *   token: 'xxx',
- *   simulator: {
- *     apiUrl: 'https://limulator.example.com',
- *     token: 'yyy', // optional, defaults to sandbox token
- *   },
- * });
- *
- * // Sync code and build
- * await client.sync('./my-ios-app', { watch: true });
- * const build = client.xcodebuild();
- * build.stdout.on('data', (line) => console.log('[build]', line));
- * const { exitCode } = await build;
- */
-export declare function createXCodeSandboxClient(options: CreateXCodeSandboxClientOptions): Promise<XCodeSandboxClient>;
-//# sourceMappingURL=sandbox-client.d.ts.map

package/sandbox-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox-client.d.ts","sourceRoot":"","sources":["src/sandbox-client.ts"],"names":[],"mappings":"OAGO,EAAQ,gBAAgB,EAAE;AAKjC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzE;;;;;;;;;OASG;IACH,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAqI7B"}