@limrun/api 0.19.2 → 0.20.0

package/sandbox-client.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createXCodeSandboxClient = createXCodeSandboxClient;
+const folder_sync_1 = require("./folder-sync.js");
+const exec_client_1 = require("./exec-client.js");
+/**
+ * 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;
+ */
+async function createXCodeSandboxClient(options) {
+    const logLevel = options.logLevel ?? 'info';
+    const logger = {
+        debug: (...args) => {
+            if (logLevel === 'debug')
+                console.log('[XCodeSandbox]', ...args);
+        },
+        info: (...args) => {
+            if (logLevel === 'info' || logLevel === 'debug')
+                console.log('[XCodeSandbox]', ...args);
+        },
+        warn: (...args) => {
+            if (logLevel === 'warn' || logLevel === 'info' || logLevel === 'debug')
+                console.warn('[XCodeSandbox]', ...args);
+        },
+        error: (...args) => {
+            if (logLevel !== 'none')
+                console.error('[XCodeSandbox]', ...args);
+        },
+    };
+    const logFn = (level, msg) => {
+        switch (level) {
+            case 'debug':
+                logger.debug(msg);
+                break;
+            case 'info':
+                logger.info(msg);
+                break;
+            case 'warn':
+                logger.warn(msg);
+                break;
+            case 'error':
+                logger.error(msg);
+                break;
+            default:
+                logger.info(msg);
+                break;
+        }
+    };
+    // Configure the simulator connection if provided
+    if (options.simulator) {
+        const cfg = {
+            simulatorApiUrl: options.simulator.apiUrl,
+            simulatorToken: options.simulator.token ?? options.token,
+        };
+        const res = await fetch(`${options.apiUrl}/simulator`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${options.token}`,
+            },
+            body: JSON.stringify(cfg),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`POST /simulator failed: ${res.status} ${text}`);
+        }
+    }
+    return {
+        async sync(localCodePath, opts) {
+            const codeSyncOpts = {
+                apiUrl: options.apiUrl,
+                token: options.token,
+                udid: opts?.cacheKey ?? 'xcode-sandbox',
+                install: false,
+                filter: (relativePath) => {
+                    if (relativePath.startsWith('build/') ||
+                        relativePath.startsWith('.build/') ||
+                        relativePath.startsWith('DerivedData/') ||
+                        relativePath.startsWith('Index.noindex/') ||
+                        relativePath.startsWith('ModuleCache.noindex/') ||
+                        relativePath.startsWith('.index-build/')) {
+                        return false;
+                    }
+                    if (relativePath.startsWith('.swiftpm/') ||
+                        relativePath.startsWith('Pods/') ||
+                        relativePath.startsWith('Carthage/Build/')) {
+                        return false;
+                    }
+                    if (relativePath.startsWith('.git/') ||
+                        relativePath.startsWith('.limsync-cache/') ||
+                        relativePath === '.DS_Store' ||
+                        relativePath.endsWith('/.DS_Store')) {
+                        return false;
+                    }
+                    if (relativePath.includes('/xcuserdata/')) {
+                        return false;
+                    }
+                    if (relativePath.includes('.dSYM/')) {
+                        return false;
+                    }
+                    // User-provided filter
+                    if (opts?.filter && !opts.filter(relativePath)) {
+                        return false;
+                    }
+                    return true;
+                },
+                ...(opts?.basisCacheDir ? { basisCacheDir: opts.basisCacheDir } : {}),
+                ...(opts?.maxPatchBytes !== undefined ? { maxPatchBytes: opts.maxPatchBytes } : {}),
+                ...(opts?.watch !== undefined ? { watch: opts.watch } : {}),
+                log: opts?.log ?? logFn,
+            };
+            const result = await (0, folder_sync_1.syncApp)(localCodePath, codeSyncOpts);
+            if (result.stopWatching) {
+                return { stopWatching: result.stopWatching };
+            }
+            return {};
+        },
+        xcodebuild(opts) {
+            return (0, exec_client_1.exec)({ command: 'xcodebuild', ...(opts && { xcodebuild: opts }) }, {
+                apiUrl: options.apiUrl,
+                token: options.token,
+                log: logFn,
+            });
+        },
+    };
+}
+//# sourceMappingURL=sandbox-client.js.map

package/sandbox-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-client.js","sourceRoot":"","sources":["src/sandbox-client.ts"],"names":[],"mappings":";;AAoIA,4DAsIC;AA1QD,kDAAkF;AAClF,kDAAuD;AAyGvD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,wBAAwB,CAC5C,OAAwC;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5B,IAAI,QAAQ,KAAK,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC3B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC3B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO;gBACpE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5B,IAAI,QAAQ,KAAK,MAAM;gBAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,KAA0C,EAAE,GAAW,EAAE,EAAE;QACxE,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR;gBACE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM;QACV,CAAC;IACH,CAAC,CAAC;IAEF,iDAAiD;IACjD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,GAAG,GAGL;YACF,eAAe,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACzC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK;SACzD,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,YAAY,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE;aACzC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC1B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,aAAqB,EAAE,IAAkB;YAClD,MAAM,YAAY,GAAsB;gBACtC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,IAAI,EAAE,QAAQ,IAAI,eAAe;gBACvC,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,CAAC,YAAoB,EAAE,EAAE;oBAC/B,IACE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;wBACjC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC;wBAClC,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC;wBACvC,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC;wBACzC,YAAY,CAAC,UAAU,CAAC,sBAAsB,CAAC;wBAC/C,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EACxC,CAAC;wBACD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,IACE,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC;wBACpC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;wBAChC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAC1C,CAAC;wBACD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,IACE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;wBAChC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC;wBAC1C,YAAY,KAAK,WAAW;wBAC5B,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,EACnC,CAAC;wBACD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;wBAC1C,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpC,OAAO,KAAK,CAAC;oBACf,CAAC;oBAED,uBAAuB;oBACvB,IAAI,IAAI,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC/C,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrE,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,KAAK;aACxB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAc,EAAC,aAAa,EAAE,YAAY,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,UAAU,CAAC,IAAuB;YAChC,OAAO,IAAA,kBAAI,EACT,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,EAC5D;gBACE,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,GAAG,EAAE,KAAK;aACX,CACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/sandbox-client.mjs

@@ -0,0 +1,146 @@
+import { syncApp as syncFolderImpl } from "./folder-sync.mjs";
+import { exec } from "./exec-client.mjs";
+/**
+ * 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 async function createXCodeSandboxClient(options) {
+    const logLevel = options.logLevel ?? 'info';
+    const logger = {
+        debug: (...args) => {
+            if (logLevel === 'debug')
+                console.log('[XCodeSandbox]', ...args);
+        },
+        info: (...args) => {
+            if (logLevel === 'info' || logLevel === 'debug')
+                console.log('[XCodeSandbox]', ...args);
+        },
+        warn: (...args) => {
+            if (logLevel === 'warn' || logLevel === 'info' || logLevel === 'debug')
+                console.warn('[XCodeSandbox]', ...args);
+        },
+        error: (...args) => {
+            if (logLevel !== 'none')
+                console.error('[XCodeSandbox]', ...args);
+        },
+    };
+    const logFn = (level, msg) => {
+        switch (level) {
+            case 'debug':
+                logger.debug(msg);
+                break;
+            case 'info':
+                logger.info(msg);
+                break;
+            case 'warn':
+                logger.warn(msg);
+                break;
+            case 'error':
+                logger.error(msg);
+                break;
+            default:
+                logger.info(msg);
+                break;
+        }
+    };
+    // Configure the simulator connection if provided
+    if (options.simulator) {
+        const cfg = {
+            simulatorApiUrl: options.simulator.apiUrl,
+            simulatorToken: options.simulator.token ?? options.token,
+        };
+        const res = await fetch(`${options.apiUrl}/simulator`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${options.token}`,
+            },
+            body: JSON.stringify(cfg),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`POST /simulator failed: ${res.status} ${text}`);
+        }
+    }
+    return {
+        async sync(localCodePath, opts) {
+            const codeSyncOpts = {
+                apiUrl: options.apiUrl,
+                token: options.token,
+                udid: opts?.cacheKey ?? 'xcode-sandbox',
+                install: false,
+                filter: (relativePath) => {
+                    if (relativePath.startsWith('build/') ||
+                        relativePath.startsWith('.build/') ||
+                        relativePath.startsWith('DerivedData/') ||
+                        relativePath.startsWith('Index.noindex/') ||
+                        relativePath.startsWith('ModuleCache.noindex/') ||
+                        relativePath.startsWith('.index-build/')) {
+                        return false;
+                    }
+                    if (relativePath.startsWith('.swiftpm/') ||
+                        relativePath.startsWith('Pods/') ||
+                        relativePath.startsWith('Carthage/Build/')) {
+                        return false;
+                    }
+                    if (relativePath.startsWith('.git/') ||
+                        relativePath.startsWith('.limsync-cache/') ||
+                        relativePath === '.DS_Store' ||
+                        relativePath.endsWith('/.DS_Store')) {
+                        return false;
+                    }
+                    if (relativePath.includes('/xcuserdata/')) {
+                        return false;
+                    }
+                    if (relativePath.includes('.dSYM/')) {
+                        return false;
+                    }
+                    // User-provided filter
+                    if (opts?.filter && !opts.filter(relativePath)) {
+                        return false;
+                    }
+                    return true;
+                },
+                ...(opts?.basisCacheDir ? { basisCacheDir: opts.basisCacheDir } : {}),
+                ...(opts?.maxPatchBytes !== undefined ? { maxPatchBytes: opts.maxPatchBytes } : {}),
+                ...(opts?.watch !== undefined ? { watch: opts.watch } : {}),
+                log: opts?.log ?? logFn,
+            };
+            const result = await syncFolderImpl(localCodePath, codeSyncOpts);
+            if (result.stopWatching) {
+                return { stopWatching: result.stopWatching };
+            }
+            return {};
+        },
+        xcodebuild(opts) {
+            return exec({ command: 'xcodebuild', ...(opts && { xcodebuild: opts }) }, {
+                apiUrl: options.apiUrl,
+                token: options.token,
+                log: logFn,
+            });
+        },
+    };
+}
+//# sourceMappingURL=sandbox-client.mjs.map

package/sandbox-client.mjs.map

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

package/src/client.ts

@@ -537,9 +537,10 @@ export class Limrun {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = this._makeAbort(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -562,6 +563,7 @@ export class Limrun {
       return await this.fetch.call(undefined, url, fetchOptions);
     } finally {
       clearTimeout(timeout);
+      if (signal) signal.removeEventListener('abort', abort);
     }
   }
 
@@ -706,6 +708,12 @@ export class Limrun {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;

package/src/exec-client.ts

@@ -0,0 +1,333 @@
+/**
+ * Client for executing commands on limbuild server with streaming output.
+ *
+ * The interface is designed to be similar to Node.js's child_process.spawn()
+ * for familiarity and ease of extension.
+ */
+
+import { createEventSource, type EventSourceClient, type EventSourceMessage } from 'eventsource-client';
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export type ExecRequest = {
+  command: 'xcodebuild';
+  xcodebuild?: {
+    workspace?: string;
+    project?: string;
+    scheme?: string;
+  };
+};
+
+export type ExecOptions = {
+  apiUrl: string;
+  token: string;
+  log?: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+};
+
+export type ExecResult = {
+  exitCode: number;
+  execId: string;
+  status: 'SUCCEEDED' | 'FAILED' | 'CANCELLED';
+};
+
+type DataListener = (chunk: string) => void;
+type CloseListener = () => void;
+type ExitListener = (code: number) => void;
+
+/**
+ * A Readable-like stream interface, similar to Node.js stream.Readable.
+ * Emits 'data' for each chunk and 'close' when the stream ends.
+ */
+export class ReadableStream {
+  private dataListeners: DataListener[] = [];
+  private closeListeners: CloseListener[] = [];
+  private closed = false;
+
+  on(event: 'data', listener: DataListener): this;
+  on(event: 'close', listener: CloseListener): this;
+  on(event: 'data' | 'close', listener: DataListener | CloseListener): this {
+    if (event === 'data') {
+      this.dataListeners.push(listener as DataListener);
+    } else if (event === 'close') {
+      this.closeListeners.push(listener as CloseListener);
+    }
+    return this;
+  }
+
+  /** @internal */
+  emit(event: 'data', chunk: string): void;
+  emit(event: 'close'): void;
+  emit(event: 'data' | 'close', arg?: string): void {
+    if (event === 'data' && typeof arg === 'string') {
+      for (const l of this.dataListeners) l(arg);
+    } else if (event === 'close' && !this.closed) {
+      this.closed = true;
+      for (const l of this.closeListeners) l();
+    }
+  }
+}
+
+/**
+ * A ChildProcess-like object similar to Node.js's ChildProcess.
+ *
+ * Implements PromiseLike so it can be awaited directly.
+ *
+ * @example
+ * // Stream-based (like Node.js spawn)
+ * const proc = exec({ command: 'xcodebuild' }, options);
+ * proc.stdout.on('data', (chunk) => process.stdout.write(chunk));
+ * proc.stderr.on('data', (chunk) => process.stderr.write(chunk));
+ * proc.on('exit', (code) => console.log(`Exited with code ${code}`));
+ *
+ * // Promise-based (can be awaited)
+ * const { exitCode, status } = await proc;
+ */
+export class ExecChildProcess implements PromiseLike<ExecResult> {
+  /** Stdout stream - emits 'data' and 'close' events */
+  readonly stdout = new ReadableStream();
+
+  /** Stderr stream - emits 'data' and 'close' events */
+  readonly stderr = new ReadableStream();
+
+  /** The remote process/build identifier (similar to pid in Node.js) */
+  execId: string | undefined;
+
+  private readonly resultPromise: Promise<ExecResult>;
+  private readonly exitListeners: ExitListener[] = [];
+  private abortController: AbortController | null = null;
+  private sseConnection: EventSourceClient | null = null;
+  private killed = false;
+  private readonly options: ExecOptions;
+  private readonly log: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+
+  constructor(request: ExecRequest, options: ExecOptions) {
+    this.options = options;
+    this.log = options.log ?? (() => {});
+    this.resultPromise = this.run(request);
+  }
+
+  /** Implement PromiseLike so this object can be awaited */
+  then<TResult1 = ExecResult, TResult2 = never>(
+    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,
+    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,
+  ): Promise<TResult1 | TResult2> {
+    return this.resultPromise.then(onfulfilled, onrejected);
+  }
+
+  /** Catch errors */
+  catch<TResult = never>(
+    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,
+  ): Promise<ExecResult | TResult> {
+    return this.resultPromise.catch(onrejected);
+  }
+
+  /** Finally handler */
+  finally(onfinally?: (() => void) | null): Promise<ExecResult> {
+    return this.resultPromise.finally(onfinally);
+  }
+
+  /** Listen for process events */
+  on(event: 'exit', listener: ExitListener): this {
+    if (event === 'exit') {
+      this.exitListeners.push(listener);
+    }
+    return this;
+  }
+
+  /** Send a signal to terminate the process */
+  async kill(): Promise<void> {
+    this.killed = true;
+    if (this.abortController) {
+      this.abortController.abort();
+    }
+    if (this.sseConnection) {
+      this.sseConnection.close();
+      this.sseConnection = null;
+    }
+    if (!this.execId) {
+      this.log('warn', 'Failed to cancel build: execId is not set');
+      return;
+    }
+    try {
+      await fetch(`${this.options.apiUrl}/exec/${this.execId}/cancel`, {
+        method: 'POST',
+        headers: {
+          Authorization: `Bearer ${this.options.token}`,
+        },
+      });
+      this.log('info', 'Build cancelled');
+    } catch (err) {
+      this.log('warn', `Failed to cancel build: ${err}`);
+    }
+  }
+
+  private async run(request: ExecRequest): Promise<ExecResult> {
+    const { log } = this;
+    const { apiUrl, token } = this.options;
+
+    // 1. Trigger the build via POST /exec
+    log('debug', `POST ${apiUrl}/exec`);
+    const execRes = await fetch(`${apiUrl}/exec`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify(request),
+    });
+
+    if (!execRes.ok) {
+      const text = await execRes.text();
+      throw new Error(`exec failed: ${execRes.status} ${text}`);
+    }
+
+    const execData = (await execRes.json()) as { execId: string };
+    this.execId = execData.execId;
+    log('info', `Build started: ${this.execId}`);
+
+    // 2. Connect to SSE for log streaming and completion detection
+    this.abortController = new AbortController();
+    const eventsUrl = `${apiUrl}/exec/${this.execId}/events`;
+    log('debug', `GET ${eventsUrl} (SSE)`);
+
+    // Promise that resolves when build completes (via exitCode event)
+    let sseCompletionResolve: ((exitCode: number) => void) | null = null;
+    const sseCompletionPromise = new Promise<number>((resolve) => {
+      sseCompletionResolve = resolve;
+    });
+
+    const ssePromise = this.connectSSE(eventsUrl, sseCompletionResolve);
+
+    // Wait for SSE to signal completion (with timeout fallback)
+    const timeoutMs = 3600 * 1000; // 1 hour max
+    let exitCode: number;
+    try {
+      exitCode = await Promise.race([
+        sseCompletionPromise,
+        new Promise<number>((_, reject) => setTimeout(() => reject(new Error('SSE timeout')), timeoutMs)),
+      ]);
+    } catch {
+      log('warn', 'SSE completion timeout');
+      exitCode = 1;
+    }
+
+    // Cleanup SSE connection
+    if (this.abortController) {
+      this.abortController.abort();
+    }
+    await ssePromise.catch(() => {});
+
+    // Emit close events on streams
+    this.stdout.emit('close');
+    this.stderr.emit('close');
+
+    // Emit exit event
+    for (const listener of this.exitListeners) {
+      listener(exitCode);
+    }
+
+    // Determine status from exit code
+    const status: 'SUCCEEDED' | 'FAILED' | 'CANCELLED' =
+      exitCode === 0 ? 'SUCCEEDED'
+      : exitCode === -1 ? 'CANCELLED'
+      : 'FAILED';
+
+    const result: ExecResult = {
+      exitCode,
+      execId: this.execId!,
+      status,
+    };
+
+    this.log('info', `Build finished: ${result.status} (exit ${result.exitCode})`);
+    return result;
+  }
+
+  private async connectSSE(
+    eventsUrl: string,
+    onComplete: ((exitCode: number) => void) | null,
+  ): Promise<void> {
+    return new Promise((resolve) => {
+      const authHeader = `Bearer ${this.options.token}`;
+
+      let resolved = false;
+      const resolveOnce = () => {
+        if (resolved) return;
+        resolved = true;
+        this.sseConnection?.close();
+        this.sseConnection = null;
+        resolve();
+      };
+
+      try {
+        const eventSource = createEventSource({
+          url: eventsUrl,
+          headers: { Authorization: authHeader },
+          onMessage: (message: EventSourceMessage) => {
+            const data = typeof message.data === 'string' ? message.data : String(message.data ?? '');
+            const eventType = message.event;
+            if (eventType === 'stdout') {
+              this.stdout.emit('data', data);
+              return;
+            }
+            if (eventType === 'stderr') {
+              this.stderr.emit('data', data);
+              return;
+            }
+            if (eventType === 'exitCode') {
+              const exitCode = parseInt(data, 10);
+              if (Number.isNaN(exitCode)) {
+                this.log('warn', `SSE exitCode event has invalid data: ${data}`);
+                return;
+              }
+              this.log('debug', `Build completed via SSE: exitCode=${exitCode}`);
+              onComplete?.(exitCode);
+              resolveOnce();
+            }
+          },
+          onDisconnect: () => {
+            if (!this.killed) {
+              this.log('warn', 'SSE disconnected');
+            }
+          },
+        });
+        this.sseConnection = eventSource;
+
+        const abortSignal = this.abortController?.signal;
+        if (abortSignal) {
+          abortSignal.addEventListener(
+            'abort',
+            () => {
+              resolveOnce();
+            },
+            { once: true },
+          );
+        }
+      } catch (err) {
+        if (!this.killed) {
+          this.log('warn', `SSE setup failed: ${err}`);
+        }
+        resolveOnce();
+      }
+    });
+  }
+}
+
+/**
+ * Execute a command on the limbuild server.
+ * Returns a ChildProcess-like object with stdout/stderr streams.
+ *
+ * @example
+ * const proc = exec({ command: 'xcodebuild' }, { apiUrl: '...', token: '...' });
+ *
+ * // Stream output
+ * proc.stdout.on('data', (chunk) => console.log('[stdout]', chunk));
+ * proc.stderr.on('data', (chunk) => console.error('[stderr]', chunk));
+ *
+ * // Wait for completion
+ * const { exitCode, status } = await proc;
+ */
+export function exec(request: ExecRequest, options: ExecOptions): ExecChildProcess {
+  return new ExecChildProcess(request, options);
+}