@limrun/api 0.23.2 → 0.24.1

package/sandbox-client.mjs

@@ -1,154 +0,0 @@
-import os from 'os';
-import path from 'path';
-import { syncFolder as syncFolderImpl } from "./folder-sync.mjs";
-import { exec } from "./exec-client.mjs";
-import { createIgnoreFn } from "./folder-sync-ignore.mjs";
-import crypto from 'crypto';
-/**
- * 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 log = (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) {
-            // Use folder name and hash of absolute path to scope basisCacheDir uniquely for each sync root
-            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: options.apiUrl,
-                token: options.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;
-                        }
-                        // User-provided ignores
-                        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(opts) {
-            return exec({ command: 'xcodebuild', ...(opts && { xcodebuild: opts }) }, {
-                apiUrl: options.apiUrl,
-                token: options.token,
-                log,
-            });
-        },
-    };
-}
-//# sourceMappingURL=sandbox-client.mjs.map

package/sandbox-client.mjs.map

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

package/src/sandbox-client.ts

@@ -1,277 +0,0 @@
-import os from 'os';
-import path from 'path';
-import { syncFolder as syncFolderImpl, type FolderSyncOptions } from './folder-sync';
-import { exec, ExecChildProcess } from './exec-client';
-import { createIgnoreFn } from './folder-sync-ignore';
-import crypto from 'crypto';
-
-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 async function createXCodeSandboxClient(
-  options: CreateXCodeSandboxClientOptions,
-): Promise<XCodeSandboxClient> {
-  const logLevel = options.logLevel ?? 'info';
-  const logger = {
-    debug: (...args: unknown[]) => {
-      if (logLevel === 'debug') console.log('[XCodeSandbox]', ...args);
-    },
-    info: (...args: unknown[]) => {
-      if (logLevel === 'info' || logLevel === 'debug') console.log('[XCodeSandbox]', ...args);
-    },
-    warn: (...args: unknown[]) => {
-      if (logLevel === 'warn' || logLevel === 'info' || logLevel === 'debug')
-        console.warn('[XCodeSandbox]', ...args);
-    },
-    error: (...args: unknown[]) => {
-      if (logLevel !== 'none') console.error('[XCodeSandbox]', ...args);
-    },
-  };
-
-  const log = (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => {
-    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?: string;
-      simulatorToken?: string;
-    } = {
-      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: string, opts?: SyncOptions): Promise<SyncResult> {
-      // Use folder name and hash of absolute path to scope basisCacheDir uniquely for each sync root
-      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: options.apiUrl,
-        token: options.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;
-            }
-            // User-provided ignores
-            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(opts?: XcodeBuildConfig): ExecChildProcess {
-      return exec(
-        { command: 'xcodebuild', ...(opts && { xcodebuild: opts }) },
-        {
-          apiUrl: options.apiUrl,
-          token: options.token,
-          log,
-        },
-      );
-    },
-  };
-}