@limrun/api 0.19.3 → 0.20.1

package/sandbox-client.d.ts

@@ -0,0 +1,124 @@
+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 = {
+    /**
+     * Cache scoping key for delta basis caching. Defaults to 'xcode-sandbox'.
+     * This is not sent to the server.
+     */
+    cacheKey?: string;
+    basisCacheDir?: string;
+    maxPatchBytes?: number;
+    /**
+     * If true, watch the folder and re-sync on any changes.
+     */
+    watch?: boolean;
+    log?: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+    /**
+     * Optional filter function to include/exclude files and directories.
+     * Called with the relative path from the sync root (using forward slashes).
+     * For directories, the path ends with '/'.
+     * Return true to include, false to exclude.
+     *
+     * @example
+     * // Exclude build folder
+     * filter: (path) => !path.startsWith('build/')
+     *
+     * @example
+     * // Only include source files
+     * filter: (path) => path.startsWith('src/') || path.endsWith('.json')
+     */
+    filter?: (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

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-client.d.ts","sourceRoot":"","sources":["src/sandbox-client.ts"],"names":[],"mappings":"OACO,EAAQ,gBAAgB,EAAE;AAEjC,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;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE;;;;;;;;;;;;;OAaG;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,CAoI7B"}

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":"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"}

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

@@ -514,9 +514,14 @@ export class Limrun {
   getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(
     path: string,
     Page: new (...args: any[]) => PageClass,
-    opts?: RequestOptions,
+    opts?: PromiseOrValue<RequestOptions>,
   ): Pagination.PagePromise<PageClass, Item> {
-    return this.requestAPIList(Page, { method: 'get', path, ...opts });
+    return this.requestAPIList(
+      Page,
+      opts && 'then' in opts ?
+        opts.then((opts) => ({ method: 'get', path, ...opts }))
+      : { method: 'get', path, ...opts },
+    );
   }
 
   requestAPIList<
@@ -524,7 +529,7 @@ export class Limrun {
     PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>,
   >(
     Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass,
-    options: FinalRequestOptions,
+    options: PromiseOrValue<FinalRequestOptions>,
   ): Pagination.PagePromise<PageClass, Item> {
     const request = this.makeRequest(options, null, undefined);
     return new Pagination.PagePromise<PageClass, Item>(this as any as Limrun, request, Page);
@@ -537,9 +542,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) ||
@@ -706,6 +712,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;