@limrun/api 0.24.0 → 0.24.2

package/resources/xcode-instances-helpers.d.mts

@@ -0,0 +1,76 @@
+import { XcodeInstances as GeneratedXcodeInstances, type XcodeInstance } from "./xcode-instances.mjs";
+import { type IosInstance } from "./ios-instances.mjs";
+import { type ExecChildProcess } from "../exec-client.mjs";
+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;
+};
+export declare class XcodeInstances extends GeneratedXcodeInstances {
+    createClient(params: XcodeCreateClientParams): Promise<XcodeClient>;
+}
+//# sourceMappingURL=xcode-instances-helpers.d.mts.map

package/resources/xcode-instances-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xcode-instances-helpers.d.mts","sourceRoot":"","sources":["../src/resources/xcode-instances-helpers.ts"],"names":[],"mappings":"OAIO,EAAE,cAAc,IAAI,uBAAuB,EAAE,KAAK,aAAa,EAAE;OACjE,EAAE,KAAK,WAAW,EAAE;OACpB,EAAQ,KAAK,gBAAgB,EAAoB;AAKxD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzE;;;;;;;;OAQG;IACH,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;IAE7F;;;OAGG;IACH,eAAe,EAAE,CAAC,SAAS,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAkB3D,qBAAa,cAAe,SAAQ,uBAAuB;IACnD,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;CAmI1E"}

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

@@ -0,0 +1,76 @@
+import { XcodeInstances as GeneratedXcodeInstances, type XcodeInstance } from "./xcode-instances.js";
+import { type IosInstance } from "./ios-instances.js";
+import { type ExecChildProcess } from "../exec-client.js";
+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;
+};
+export declare class XcodeInstances extends GeneratedXcodeInstances {
+    createClient(params: XcodeCreateClientParams): Promise<XcodeClient>;
+}
+//# sourceMappingURL=xcode-instances-helpers.d.ts.map

package/resources/xcode-instances-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xcode-instances-helpers.d.ts","sourceRoot":"","sources":["../src/resources/xcode-instances-helpers.ts"],"names":[],"mappings":"OAIO,EAAE,cAAc,IAAI,uBAAuB,EAAE,KAAK,aAAa,EAAE;OACjE,EAAE,KAAK,WAAW,EAAE;OACpB,EAAQ,KAAK,gBAAgB,EAAoB;AAKxD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,IAAI,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzE;;;;;;;;OAQG;IACH,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;IAE7F;;;OAGG;IACH,eAAe,EAAE,CAAC,SAAS,EAAE,WAAW,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,CAAC;AAkB3D,qBAAa,cAAe,SAAQ,uBAAuB;IACnD,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;CAmI1E"}

package/resources/xcode-instances-helpers.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XcodeInstances = void 0;
+const tslib_1 = require("../internal/tslib.js");
+const os_1 = tslib_1.__importDefault(require("os"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const crypto_1 = tslib_1.__importDefault(require("crypto"));
+const xcode_instances_1 = require("./xcode-instances.js");
+const exec_client_1 = require("../exec-client.js");
+const folder_sync_1 = require("../folder-sync.js");
+const folder_sync_ignore_1 = require("../folder-sync-ignore.js");
+const proxy_transport_1 = require("../internal/proxy-transport.js");
+function createLogger(logLevel) {
+    const shouldLog = (level) => {
+        const levels = ['none', 'error', 'warn', 'info', 'debug'];
+        return levels.indexOf(logLevel) >= levels.indexOf(level);
+    };
+    return (level, msg) => {
+        if (!shouldLog(level))
+            return;
+        const prefix = '[XcodeInstance]';
+        if (level === 'error' || level === 'warn') {
+            console[level](prefix, msg);
+        }
+        else {
+            console.log(prefix, msg);
+        }
+    };
+}
+class XcodeInstances extends xcode_instances_1.XcodeInstances {
+    async createClient(params) {
+        let apiUrl;
+        let token;
+        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, opts) {
+                const resolvedPath = path_1.default.resolve(localCodePath);
+                const folderName = path_1.default.basename(resolvedPath);
+                const hash = crypto_1.default.createHash('sha1').update(resolvedPath).digest('hex').slice(0, 8);
+                const cacheKey = `limsync-cache-${folderName}-${hash}`;
+                const basisCacheDir = opts?.basisCacheDir ?? path_1.default.join(os_1.default.tmpdir(), cacheKey);
+                const codeSyncOpts = {
+                    apiUrl,
+                    token,
+                    udid: cacheKey,
+                    install: opts?.install ?? true,
+                    ignoreFn: await (0, folder_sync_ignore_1.createIgnoreFn)(localCodePath, {
+                        basisCacheDir,
+                        additional: (relativePath) => {
+                            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 (0, folder_sync_1.syncFolder)(localCodePath, codeSyncOpts);
+                if (result.stopWatching) {
+                    return { stopWatching: result.stopWatching };
+                }
+                return {};
+            },
+            xcodebuild(settings, options) {
+                const request = {
+                    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 (0, exec_client_1.exec)(requestPromise, { apiUrl, token, log });
+                }
+                return (0, exec_client_1.exec)(request, { apiUrl, token, log });
+            },
+            async attachSimulator(simulator) {
+                let simApiUrl;
+                let simToken;
+                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 proxy_transport_1.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}`);
+                }
+            },
+        };
+    }
+}
+exports.XcodeInstances = XcodeInstances;
+//# sourceMappingURL=xcode-instances-helpers.js.map

package/resources/xcode-instances-helpers.js.map

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

package/resources/xcode-instances-helpers.mjs

@@ -0,0 +1,145 @@
+import os from 'os';
+import path from 'path';
+import crypto from 'crypto';
+import { XcodeInstances as GeneratedXcodeInstances } from "./xcode-instances.mjs";
+import { exec } from "../exec-client.mjs";
+import { syncFolder as syncFolderImpl } from "../folder-sync.mjs";
+import { createIgnoreFn } from "../folder-sync-ignore.mjs";
+import { nodeProxyTransport } from "../internal/proxy-transport.mjs";
+function createLogger(logLevel) {
+    const shouldLog = (level) => {
+        const levels = ['none', 'error', 'warn', 'info', 'debug'];
+        return levels.indexOf(logLevel) >= levels.indexOf(level);
+    };
+    return (level, msg) => {
+        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) {
+        let apiUrl;
+        let token;
+        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, opts) {
+                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 = {
+                    apiUrl,
+                    token,
+                    udid: cacheKey,
+                    install: opts?.install ?? true,
+                    ignoreFn: await createIgnoreFn(localCodePath, {
+                        basisCacheDir,
+                        additional: (relativePath) => {
+                            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, options) {
+                const request = {
+                    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) {
+                let simApiUrl;
+                let simToken;
+                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}`);
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=xcode-instances-helpers.mjs.map

package/resources/xcode-instances-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"xcode-instances-helpers.mjs","sourceRoot":"","sources":["../src/resources/xcode-instances-helpers.ts"],"names":[],"mappings":"OAAO,EAAE,MAAM,IAAI;OACZ,IAAI,MAAM,MAAM;OAChB,MAAM,MAAM,QAAQ;OAEpB,EAAE,cAAc,IAAI,uBAAuB,EAAsB;OAEjE,EAAE,IAAI,EAA2C;OACjD,EAAE,UAAU,IAAI,cAAc,EAA0B;OACxD,EAAE,cAAc,EAAE;OAClB,EAAE,kBAAkB,EAAE;AAsE7B,SAAS,YAAY,CAAC,QAAkB;IACtC,MAAM,SAAS,GAAG,CAAC,KAAe,EAAE,EAAE;QACpC,MAAM,MAAM,GAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,OAAO,CAAC,KAA0C,EAAE,GAAW,EAAE,EAAE;QACjE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC;QACjC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,uBAAuB;IACzD,KAAK,CAAC,YAAY,CAAC,MAA+B;QAChD,IAAI,MAAc,CAAC;QACnB,IAAI,KAAa,CAAC;QAClB,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACvB,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC;QAED,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,OAAO;YACL,KAAK,CAAC,IAAI,CAAC,aAAqB,EAAE,IAAkB;gBAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACjD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtF,MAAM,QAAQ,GAAG,iBAAiB,UAAU,IAAI,IAAI,EAAE,CAAC;gBACvD,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;gBAC9E,MAAM,YAAY,GAAsB;oBACtC,MAAM;oBACN,KAAK;oBACL,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;oBAC9B,QAAQ,EAAE,MAAM,cAAc,CAAC,aAAa,EAAE;wBAC5C,aAAa;wBACb,UAAU,EAAE,CAAC,YAAoB,EAAE,EAAE;4BACnC,IACE,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;gCACjC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC;gCAClC,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC;gCACvC,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC;gCACzC,YAAY,CAAC,UAAU,CAAC,sBAAsB,CAAC;gCAC/C,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EACxC,CAAC;gCACD,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,IACE,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC;gCACpC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;gCAChC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAC1C,CAAC;gCACD,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gCAC1C,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gCACpC,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;gCACjC,OAAO,IAAI,CAAC;4BACd,CAAC;4BACD,OAAO,KAAK,CAAC;wBACf,CAAC;qBACF,CAAC;oBACF,aAAa;oBACb,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI;oBAC1B,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;oBACrD,UAAU,EAAE,qBAAqB;oBACjC,GAAG;iBACJ,CAAC;gBAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;gBACjE,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;oBACxB,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC/C,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,UAAU,CAAC,QAA6B,EAAE,OAA2B;gBACnE,MAAM,OAAO,GAAgB;oBAC3B,OAAO,EAAE,YAAY;oBACrB,GAAG,CAAC,QAAQ,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;iBAC1C,CAAC;gBAEF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;oBACpB,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;oBAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM;yBACjC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;yBACjC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;wBACd,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;wBAChD,OAAO,OAAO,CAAC;oBACjB,CAAC,CAAC;yBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;wBACb,MAAM,IAAI,KAAK,CACb,6CAA6C,UAAU,MACrD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GACvC,EAAE,CACH,CAAC;oBACJ,CAAC,CAAC,CAAC;oBACL,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACtD,CAAC;gBAED,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,KAAK,CAAC,eAAe,CAAC,SAA0D;gBAC9E,IAAI,SAAiB,CAAC;gBACtB,IAAI,QAAgB,CAAC;gBACrB,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;wBAC7B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;oBAC3E,CAAC;oBACD,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;oBACpC,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;oBAC7B,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC;gBAC7B,CAAC;gBAED,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,MAAM,YAAY,EAAE;oBAChE,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;qBACjC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;iBAC7D,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/src/client.ts

@@ -45,9 +45,15 @@ import {
   XcodeInstance,
   XcodeInstanceCreateParams,
   XcodeInstanceListParams,
-  XcodeInstances,
   XcodeInstancesItems,
 } from './resources/xcode-instances';
+import {
+  XcodeInstances,
+  XcodeCreateClientParams,
+  XcodeClient,
+  XcodeProjectConfig,
+  XcodeBuildOptions,
+} from './resources/xcode-instances-helpers';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -828,5 +834,9 @@ export declare namespace Limrun {
     type XcodeInstancesItems as XcodeInstancesItems,
     type XcodeInstanceCreateParams as XcodeInstanceCreateParams,
     type XcodeInstanceListParams as XcodeInstanceListParams,
+    type XcodeCreateClientParams as XcodeCreateClientParams,
+    type XcodeClient as XcodeClient,
+    type XcodeProjectConfig as XcodeProjectConfig,
+    type XcodeBuildOptions as XcodeBuildOptions,
   };
 }

package/src/exec-client.ts

@@ -19,6 +19,7 @@ export type ExecRequest = {
     project?: string;
     scheme?: string;
   };
+  signedUploadUrl?: string;
 };
 
 export type ExecOptions = {
@@ -107,10 +108,14 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
   private readonly options: ExecOptions;
   private readonly log: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
 
-  constructor(request: ExecRequest, options: ExecOptions) {
+  constructor(request: ExecRequest | Promise<ExecRequest>, options: ExecOptions) {
     this.options = options;
     this.log = options.log ?? (() => {});
-    this.resultPromise = this.run(request);
+    if (request instanceof Promise) {
+      this.resultPromise = request.then((r) => this.run(r));
+    } else {
+      this.resultPromise = this.run(request);
+    }
   }
 
   /** Implement PromiseLike so this object can be awaited */
@@ -331,6 +336,6 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
  * // Wait for completion
  * const { exitCode, status } = await proc;
  */
-export function exec(request: ExecRequest, options: ExecOptions): ExecChildProcess {
+export function exec(request: ExecRequest | Promise<ExecRequest>, options: ExecOptions): ExecChildProcess {
   return new ExecChildProcess(request, options);
 }

package/src/index.ts

@@ -8,15 +8,6 @@ export { Limrun, type ClientOptions } from './client';
 export { PagePromise } from './core/pagination';
 export * from './instance-client';
 export * as Ios from './ios-client';
-export {
-  createXCodeSandboxClient,
-  type XCodeSandboxClient,
-  type CreateXCodeSandboxClientOptions,
-  type SimulatorConfig,
-  type SyncOptions,
-  type SyncResult,
-  type XcodeBuildConfig,
-} from './sandbox-client';
 export {
   exec,
   type ExecRequest,
@@ -24,6 +15,12 @@ export {
   type ExecResult,
   type ExecChildProcess,
 } from './exec-client';
+export {
+  type XcodeCreateClientParams,
+  type XcodeClient,
+  type XcodeProjectConfig,
+  type XcodeBuildOptions,
+} from './resources/xcode-instances-helpers';
 export {
   LimrunError,
   APIError,

package/src/instance-client.ts

@@ -84,8 +84,10 @@ export type InstanceClient = {
   openUrl: (url: string) => Promise<OpenUrlResult>;
   /**
    * Start recording device video. Use stopRecording() to finish 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 server-side recording.
    * If `saveTo.presignedUrl` is provided, the server uploads the completed file there before resolving.
@@ -128,6 +130,14 @@ export type InstanceClient = {
 export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
 
 export type ScrollDirection = 'up' | 'down' | 'left' | 'right';
+export enum RecordingQuality {
+  Q5 = 5,
+  Q6 = 6,
+  Q7 = 7,
+  Q8 = 8,
+  Q9 = 9,
+  Q10 = 10,
+}
 
 export type AndroidSelector = {
   resourceId?: string;
@@ -397,7 +407,7 @@ type CommandRequestMap = {
   scrollScreen: { direction: ScrollDirection; amount?: number };
   scrollElement: AndroidElementTarget & { direction: ScrollDirection; amount?: number };
   openUrl: { url: string };
-  startRecording: Record<string, never>;
+  startRecording: { quality?: RecordingQuality };
   stopRecording: { upload?: { presignedUrl: string } };
 };
 
@@ -904,8 +914,19 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       };
     };
 
-    const startRecording = async (): Promise<void> => {
-      await sendRequest('startRecording', {});
+    const startRecording = async (recordingOptions?: { quality?: RecordingQuality }): Promise<void> => {
+      const request: CommandRequestMap['startRecording'] = {};
+      if (recordingOptions?.quality !== undefined) {
+        if (
+          !Number.isInteger(recordingOptions.quality) ||
+          recordingOptions.quality < 5 ||
+          recordingOptions.quality > 10
+        ) {
+          throw new Error('quality must be one of: 5, 6, 7, 8, 9, 10');
+        }
+        request.quality = recordingOptions.quality;
+      }
+      await sendRequest('startRecording', request);
     };
 
     const stopRecording = async (saveTo: { presignedUrl?: string; localPath?: string }): Promise<string> => {