@limrun/api 0.22.2 → 0.23.1

package/sandbox-client.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createXCodeSandboxClient = createXCodeSandboxClient;
+const tslib_1 = require("./internal/tslib.js");
+const os_1 = tslib_1.__importDefault(require("os"));
+const path_1 = tslib_1.__importDefault(require("path"));
 const folder_sync_1 = require("./folder-sync.js");
 const exec_client_1 = require("./exec-client.js");
+const folder_sync_ignore_1 = require("./folder-sync-ignore.js");
+const crypto_1 = tslib_1.__importDefault(require("crypto"));
 /**
  * Creates a client for interacting with a sandboxed Xcode build service.
  *
@@ -49,7 +54,7 @@ async function createXCodeSandboxClient(options) {
                 console.error('[XCodeSandbox]', ...args);
         },
     };
-    const logFn = (level, msg) => {
+    const log = (level, msg) => {
         switch (level) {
             case 'debug':
                 logger.debug(msg);
@@ -89,49 +94,53 @@ async function createXCodeSandboxClient(options) {
     }
     return {
         async sync(localCodePath, opts) {
+            // Use folder name and hash of absolute path to scope basisCacheDir uniquely for each sync root
+            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: 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/')) {
+                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;
+                        }
+                        // User-provided ignores
+                        if (opts?.ignore?.(relativePath)) {
+                            return true;
+                        }
                         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,
+                    },
+                }),
+                basisCacheDir,
+                watch: opts?.watch ?? true,
+                maxPatchBytes: opts?.maxPatchBytes ?? 4 * 1024 * 1024,
+                launchMode: 'ForegroundIfRunning',
+                log,
             };
-            const result = await (0, folder_sync_1.syncApp)(localCodePath, codeSyncOpts);
+            const result = await (0, folder_sync_1.syncFolder)(localCodePath, codeSyncOpts);
             if (result.stopWatching) {
                 return { stopWatching: result.stopWatching };
             }
@@ -141,7 +150,7 @@ async function createXCodeSandboxClient(options) {
             return (0, exec_client_1.exec)({ command: 'xcodebuild', ...(opts && { xcodebuild: opts }) }, {
                 apiUrl: options.apiUrl,
                 token: options.token,
-                log: logFn,
+                log,
             });
         },
     };

package/sandbox-client.js.map

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

package/sandbox-client.mjs

@@ -1,5 +1,9 @@
-import { syncApp as syncFolderImpl } from "./folder-sync.mjs";
+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.
  *
@@ -46,7 +50,7 @@ export async function createXCodeSandboxClient(options) {
                 console.error('[XCodeSandbox]', ...args);
         },
     };
-    const logFn = (level, msg) => {
+    const log = (level, msg) => {
         switch (level) {
             case 'debug':
                 logger.debug(msg);
@@ -86,47 +90,51 @@ export async function createXCodeSandboxClient(options) {
     }
     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: 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/')) {
+                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;
-                    }
-                    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,
+                    },
+                }),
+                basisCacheDir,
+                watch: opts?.watch ?? true,
+                maxPatchBytes: opts?.maxPatchBytes ?? 4 * 1024 * 1024,
+                launchMode: 'ForegroundIfRunning',
+                log,
             };
             const result = await syncFolderImpl(localCodePath, codeSyncOpts);
             if (result.stopWatching) {
@@ -138,7 +146,7 @@ export async function createXCodeSandboxClient(options) {
             return exec({ command: 'xcodebuild', ...(opts && { xcodebuild: opts }) }, {
                 apiUrl: options.apiUrl,
                 token: options.token,
-                log: logFn,
+                log,
             });
         },
     };

package/sandbox-client.mjs.map

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

package/src/exec-client.ts

@@ -77,6 +77,7 @@ export class ReadableStream {
  * @example
  * // Stream-based (like Node.js spawn)
  * const proc = exec({ command: 'xcodebuild' }, options);
+ * proc.command.on('data', (chunk) => console.log('[command]', chunk));
  * 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}`));
@@ -85,6 +86,9 @@ export class ReadableStream {
  * const { exitCode, status } = await proc;
  */
 export class ExecChildProcess implements PromiseLike<ExecResult> {
+  /** Command stream - emits the executed command and then closes */
+  readonly command = new ReadableStream();
+
   /** Stdout stream - emits 'data' and 'close' events */
   readonly stdout = new ReadableStream();
 
@@ -166,7 +170,6 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
     const { apiUrl, token } = this.options;
 
     // 1. Trigger the build via POST /exec
-    log('debug', `POST ${apiUrl}/exec`);
     let execRes: Response;
     try {
       execRes = await fetch(`${apiUrl}/exec`, {
@@ -180,6 +183,7 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
       });
     } catch (err) {
       if (this.killed) {
+        this.command.emit('close');
         this.stdout.emit('close');
         this.stderr.emit('close');
         for (const listener of this.exitListeners) {
@@ -197,11 +201,10 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
 
     const execData = (await execRes.json()) as { execId: string };
     this.execId = execData.execId;
-    log('info', `Build started: ${this.execId}`);
+    log('debug', `Build started: ${this.execId}`);
 
     // 2. Stream logs via SSE and wait for exit code
     const eventsUrl = `${apiUrl}/exec/${this.execId}/events`;
-    log('debug', `GET ${eventsUrl} (SSE)`);
 
     const timeoutMs = 3600 * 1000; // 1 hour max
     let exitCode: number;
@@ -215,7 +218,7 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
       ]);
     } catch {
       if (this.killed) {
-        log('info', 'Build killed');
+        log('debug', 'Build killed');
         exitCode = -1;
       } else {
         log('warn', 'SSE completion timeout');
@@ -230,6 +233,7 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
     }
 
     // Emit close events on streams
+    this.command.emit('close');
     this.stdout.emit('close');
     this.stderr.emit('close');
 
@@ -250,12 +254,12 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
       status,
     };
 
-    this.log('info', `Build finished: ${result.status} (exit ${result.exitCode})`);
+    this.log('debug', `Build finished: ${result.status} (exit ${result.exitCode})`);
     return result;
   }
 
   /**
-   * Opens an SSE connection and routes events to stdout/stderr streams.
+   * Opens an SSE connection and routes streamed events to the exposed command/stdout/stderr streams.
    * Resolves with the exit code when an 'exitCode' event arrives.
    * Rejects when the abort signal fires (kill or cleanup).
    */
@@ -273,7 +277,9 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
           onMessage: (message: EventSourceMessage) => {
             const data = typeof message.data === 'string' ? message.data : String(message.data ?? '');
             const eventType = message.event;
-            if (eventType === 'stdout') {
+            if (eventType === 'command') {
+              this.command.emit('data', data);
+            } else if (eventType === 'stdout') {
               this.stdout.emit('data', data);
             } else if (eventType === 'stderr') {
               this.stderr.emit('data', data);
@@ -316,6 +322,7 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
  * const proc = exec({ command: 'xcodebuild' }, { apiUrl: '...', token: '...' });
  *
  * // Stream output
+ * proc.command.on('data', (chunk) => console.log('[command]', chunk));
  * proc.stdout.on('data', (chunk) => console.log('[stdout]', chunk));
  * proc.stderr.on('data', (chunk) => console.error('[stderr]', chunk));
  *

package/src/folder-sync-ignore.ts

@@ -0,0 +1,65 @@
+import fs from 'fs';
+import path from 'path';
+import ignorePkg from 'ignore';
+
+export type IgnoreFn = (relativePath: string) => boolean;
+
+export type IgnoreFnOptions = {
+  additional?: IgnoreFn;
+  basisCacheDir: string;
+};
+
+function normalizeRelativePath(relativePath: string): string {
+  return relativePath
+    .split(path.sep)
+    .join('/')
+    .replace(/^\.\/+/, '')
+    .replace(/\/+/g, '/');
+}
+
+export async function createIgnoreFn(rootDir: string, options: IgnoreFnOptions): Promise<IgnoreFn> {
+  const rootResolved = path.resolve(rootDir);
+  const ig = ignorePkg();
+  const gitignorePath = path.join(rootResolved, '.gitignore');
+  try {
+    const content = await fs.promises.readFile(gitignorePath, 'utf-8');
+    ig.add(content);
+  } catch {
+    // No .gitignore file, return empty ignore instance
+  }
+  const basisCacheRelative = normalizeRelativePath(
+    path.relative(rootResolved, options.basisCacheDir),
+  ).replace(/\/+$/, '');
+  const shouldIgnoreBasisCache =
+    basisCacheRelative &&
+    basisCacheRelative !== '.' &&
+    basisCacheRelative !== '..' &&
+    !basisCacheRelative.startsWith('../');
+
+  return (relativePath: string) => {
+    const normalized = normalizeRelativePath(relativePath);
+    if (!normalized) return false;
+    const withoutTrailingSlash = normalized.replace(/\/+$/, '');
+
+    if (
+      withoutTrailingSlash === '.git' ||
+      withoutTrailingSlash.startsWith('.git/') ||
+      withoutTrailingSlash.endsWith('/.git') ||
+      withoutTrailingSlash.includes('/.git/') ||
+      withoutTrailingSlash === '.DS_Store' ||
+      withoutTrailingSlash.endsWith('/.DS_Store')
+    ) {
+      return true;
+    }
+    if (
+      shouldIgnoreBasisCache &&
+      (withoutTrailingSlash === basisCacheRelative ||
+        withoutTrailingSlash.startsWith(`${basisCacheRelative}/`))
+    ) {
+      return true;
+    }
+    if (ig.ignores(normalized)) return true;
+    if (options.additional?.(normalized)) return true;
+    return false;
+  };
+}

package/src/folder-sync-watcher.ts

@@ -1,9 +1,11 @@
 import fs from 'fs';
 import path from 'path';
+import { IgnoreFn } from './folder-sync-ignore';
 
 export type FolderSyncWatcherOptions = {
   rootPath: string;
   log?: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+  ignoreFn: IgnoreFn;
   onChange: (reason: string) => void;
 };
 
@@ -11,27 +13,6 @@ type WatcherHandle = { close: () => void };
 
 const noopLogger = (_level: 'debug' | 'info' | 'warn' | 'error', _msg: string) => {};
 
-async function listDirsRecursive(root: string): Promise<string[]> {
-  const dirs: string[] = [root];
-  const queue: string[] = [root];
-  while (queue.length) {
-    const dir = queue.pop()!;
-    let entries: fs.Dirent[];
-    try {
-      entries = await fs.promises.readdir(dir, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const ent of entries) {
-      if (!ent.isDirectory()) continue;
-      const full = path.join(dir, ent.name);
-      dirs.push(full);
-      queue.push(full);
-    }
-  }
-  return dirs;
-}
-
 /**
  * Watch a folder tree for changes. Uses recursive watch when supported (macOS),
  * otherwise falls back to watching each directory. Debounced.
@@ -42,58 +23,22 @@ export async function watchFolderTree(opts: FolderSyncWatcherOptions): Promise<W
   const log = opts.log ?? noopLogger;
   const debounceMs = 500;
   const rootPath = opts.rootPath;
-
   if (!fs.existsSync(rootPath)) {
     throw new Error(`watchFolderTree root does not exist: ${rootPath}`);
   }
-
   let timer: NodeJS.Timeout | undefined;
   const schedule = (reason: string) => {
     if (timer) clearTimeout(timer);
     timer = setTimeout(() => opts.onChange(reason), debounceMs);
   };
-
-  // Preferred: recursive watch
-  try {
-    const watcher = fs.watch(rootPath, { recursive: true }, (_eventType, filename) => {
-      schedule(filename ? `change:${filename.toString()}` : 'change');
-    });
-    log('info', `watchFolderTree(recursive): ${rootPath}`);
-    return { close: () => watcher.close() };
-  } catch (err) {
-    log(
-      'warn',
-      `watchFolderTree: recursive unsupported, using per-directory watches: ${(err as Error).message}`,
-    );
-  }
-
-  // Fallback: watch every directory. Also re-scan on any event to pick up newly-created dirs.
-  const watchers = new Map<string, fs.FSWatcher>();
-
-  const ensureWatched = async () => {
-    const dirs = await listDirsRecursive(rootPath);
-    for (const d of dirs) {
-      if (watchers.has(d)) continue;
-      try {
-        const w = fs.watch(d, (_eventType, filename) => {
-          schedule(filename ? `change:${filename.toString()}` : 'change');
-          void ensureWatched();
-        });
-        watchers.set(d, w);
-      } catch {
-        // ignore dirs we can't watch
-      }
+  const watcher = fs.watch(rootPath, { recursive: true }, (_eventType, filename) => {
+    if (!filename) return;
+    const relativePath = filename.split(path.sep).join('/');
+    if (opts.ignoreFn(relativePath)) {
+      return;
     }
-  };
-
-  await ensureWatched();
-  log('info', `watchFolderTree(per-dir): ${rootPath} dirs=${watchers.size}`);
-
-  return {
-    close: () => {
-      if (timer) clearTimeout(timer);
-      for (const w of watchers.values()) w.close();
-      watchers.clear();
-    },
-  };
+    schedule(relativePath ? `change:${relativePath}` : 'change');
+  });
+  log('debug', `watchFolderTree(recursive): ${rootPath}`);
+  return { close: () => watcher.close() };
 }