@limrun/api 0.28.2 → 0.28.4

package/src/folder-sync.ts

@@ -47,6 +47,11 @@ export type FolderSyncOptions = {
    * ignoreFn: (path) => !(path.startsWith('src/') || path.endsWith('.json'))
    */
   ignoreFn: IgnoreFn;
+  /**
+   * Extra files to sync into limbuild. These are included
+   * in every sync pass but are not watched directly.
+   */
+  additionalFiles?: AdditionalFileSyncEntry[];
 };
 
 export type SyncFolderResult = {
@@ -56,7 +61,15 @@ export type SyncFolderResult = {
   stopWatching?: () => void;
 };
 
-type FileEntry = { path: string; size: number; sha256: string; absPath: string; mode: number };
+export type AdditionalFileSyncEntry = { localPath: string; remotePath: string };
+
+type FileEntry = {
+  path: string;
+  size: number;
+  sha256: string;
+  absPath: string;
+  mode: number;
+};
 
 type FolderSyncHttpPayload = {
   kind: 'delta' | 'full';
@@ -284,6 +297,33 @@ async function walkFiles(root: string, ignoreFn: IgnoreFn): Promise<FileEntry[]>
   return out;
 }
 
+async function collectAdditionalFiles(
+  additionalFiles: AdditionalFileSyncEntry[] | undefined,
+): Promise<FileEntry[]> {
+  if (!additionalFiles || additionalFiles.length === 0) {
+    return [];
+  }
+  const out: FileEntry[] = [];
+  for (const additionalFile of additionalFiles) {
+    const remotePath = additionalFile.remotePath;
+    const absPath = path.resolve(additionalFile.localPath);
+    const st = await fs.promises.stat(absPath);
+    if (!st.isFile()) {
+      throw new Error(`additional file localPath must be a file: ${additionalFile.localPath}`);
+    }
+    const sha256 = await sha256FileHex(absPath);
+    out.push({
+      path: remotePath,
+      size: st.size,
+      sha256,
+      absPath,
+      mode: st.mode & 0o7777,
+    });
+  }
+  out.sort((a, b) => a.path.localeCompare(b.path));
+  return out;
+}
+
 // xdelta3 encoder backed by a WASM build of the upstream xdelta3 library.
 // Produces VCDIFF-compatible patches identical to `xdelta3 -e -s basis target`,
 // so the server-side decoder continues to apply them without changes.
@@ -421,7 +461,9 @@ async function syncFolderOnce(
   const maxPatchBytes = opts.maxPatchBytes ?? 4 * 1024 * 1024;
 
   const files = await walkFiles(localFolderPath, opts.ignoreFn);
-  const fileMap = new Map(files.map((f) => [f.path, f]));
+  const additionalFiles = await collectAdditionalFiles(opts.additionalFiles);
+  const allFiles = [...files, ...additionalFiles].sort((a, b) => a.path.localeCompare(b.path));
+  const fileMap = new Map(allFiles.map((f) => [f.path, f]));
 
   const syncId = genId('sync');
   const rootName = path.basename(path.resolve(localFolderPath));
@@ -439,7 +481,7 @@ async function syncFolderOnce(
   // Build payload list by comparing against local basis cache (single-flight/watch assumes server matches cache).
   const encodeLimit = concurrencyLimit();
   const changed: FileEntry[] = [];
-  for (const f of files) {
+  for (const f of allFiles) {
     const basisPath = cacheGet(opts.basisCacheDir, f.path);
     if (!fs.existsSync(basisPath)) {
       changed.push(f);
@@ -489,7 +531,12 @@ async function syncFolderOnce(
     slog('debug', `full(file): ${f.path} size=${f.size}`);
     bytesSentFull += f.size;
     return {
-      payload: { kind: 'full', path: f.path, targetSha256: f.sha256.toLowerCase(), length: f.size },
+      payload: {
+        kind: 'full',
+        path: f.path,
+        targetSha256: f.sha256.toLowerCase(),
+        length: f.size,
+      },
       filePath: f.absPath,
     };
   });
@@ -499,14 +546,19 @@ async function syncFolderOnce(
     rootName,
     install: opts.install,
     ...(opts.launchMode ? { launchMode: opts.launchMode } : {}),
-    files: files.map((f) => ({ path: f.path, size: f.size, sha256: f.sha256.toLowerCase(), mode: f.mode })),
+    files: allFiles.map((f) => ({
+      path: f.path,
+      size: f.size,
+      sha256: f.sha256.toLowerCase(),
+      mode: f.mode,
+    })),
     payloads: encodedPayloads.map((p) => p.payload),
   };
   const hasDelta = encodedPayloads.some((p) => p.payload.kind === 'delta');
   const compression: 'zstd' | 'gzip' | 'identity' = hasDelta ? 'identity' : preferredCompression;
   slog(
     'debug',
-    `sync started files=${files.length}${reason ? ` reason=${reason}` : ''} compression=${compression}`,
+    `sync started files=${allFiles.length}${reason ? ` reason=${reason}` : ''} compression=${compression}`,
   );
 
   const sendStart = nowMs();
@@ -583,7 +635,7 @@ async function syncFolderOnce(
   const totalBytes = bytesSentFull + bytesSentDelta;
   slog(
     'debug',
-    `sync finished files=${files.length} sent=${fmtBytes(totalBytes)} syncWork=${fmtMs(
+    `sync finished files=${allFiles.length} sent=${fmtBytes(totalBytes)} syncWork=${fmtMs(
       syncWorkMs,
     )} total=${fmtMs(tookMs)}`,
   );
@@ -595,7 +647,7 @@ async function syncFolderOnce(
     out.installedBundleId = resp.bundleId;
   }
   // Update local cache optimistically: after a successful sync, cache reflects current local tree.
-  for (const f of files) {
+  for (const f of allFiles) {
     await cachePut(opts.basisCacheDir, f.path, f.absPath);
   }
   return out;

package/src/internal/types.ts

@@ -40,7 +40,6 @@ type OverloadedParameters<T> =
   : T extends (...args: infer A) => unknown ? A
   : never;
 
-/* eslint-disable */
 /**
  * These imports attempt to get types from a parent package's dependencies.
  * Unresolved bare specifiers can trigger [automatic type acquisition][1] in some projects, which
@@ -63,19 +62,18 @@ type OverloadedParameters<T> =
  *
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
  */
-/** @ts-ignore For users with \@types/node */
+/** @ts-ignore For users with \@types/node */ /* prettier-ignore */
 type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
-/** @ts-ignore For users with undici */
+/** @ts-ignore For users with undici */ /* prettier-ignore */
 type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
-/** @ts-ignore For users with \@types/bun */
+/** @ts-ignore For users with \@types/bun */ /* prettier-ignore */
 type BunRequestInit = globalThis.FetchRequestInit;
-/** @ts-ignore For users with node-fetch@2 */
+/** @ts-ignore For users with node-fetch@2 */ /* prettier-ignore */
 type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
-/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
+/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */ /* prettier-ignore */
 type NodeFetch3RequestInit =  NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
-/** @ts-ignore For users who use Deno */
+/** @ts-ignore For users who use Deno */ /* prettier-ignore */
 type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
-/* eslint-enable */
 
 type RequestInits =
   | NotAny<UndiciTypesRequestInit>

package/src/internal/utils/log.ts

@@ -107,6 +107,8 @@ export const formatRequestDetails = (details: {
           name,
           (
             name.toLowerCase() === 'authorization' ||
+            name.toLowerCase() === 'api-key' ||
+            name.toLowerCase() === 'x-api-key' ||
             name.toLowerCase() === 'cookie' ||
             name.toLowerCase() === 'set-cookie'
           ) ?

package/src/ios-client.ts

@@ -259,6 +259,8 @@ export type CommandResult = {
 export type AppInstallationOptions = {
   /** MD5 hash for caching - if provided and matches cached version, skips download */
   md5?: string;
+  /** Client-side timeout for app installation. Defaults to 120 seconds. */
+  timeoutMs?: number;
   /**
    * Launch mode after installation:
    * - 'ForegroundIfRunning': Bring to foreground if already running, otherwise launch
@@ -1670,11 +1672,16 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
     };
 
     const installApp = (url: string, options?: AppInstallationOptions): Promise<AppInstallationResult> => {
-      return sendRequest<AppInstallationResult>('appInstallation', {
-        url,
-        md5: options?.md5,
-        launchMode: options?.launchMode,
-      });
+      return sendRequest<AppInstallationResult>(
+        'appInstallation',
+        {
+          url,
+          md5: options?.md5,
+          launchMode: options?.launchMode,
+        },
+        undefined,
+        options?.timeoutMs ?? 120_000,
+      );
     };
 
     const setOrientation = (orientation: 'Portrait' | 'Landscape'): Promise<void> => {

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

@@ -5,7 +5,11 @@ import crypto from 'crypto';
 import { XcodeInstances as GeneratedXcodeInstances, type XcodeInstance } from './xcode-instances';
 import { type IosInstance } from './ios-instances';
 import { exec, type ExecChildProcess, type ExecRequest } from '../exec-client';
-import { syncFolder as syncFolderImpl, type FolderSyncOptions } from '../folder-sync';
+import {
+  syncFolder as syncFolderImpl,
+  type AdditionalFileSyncEntry,
+  type FolderSyncOptions,
+} from '../folder-sync';
 import { createIgnoreFn } from '../folder-sync-ignore';
 import { nodeProxyTransport } from '../internal/proxy-transport';
 
@@ -32,6 +36,10 @@ export type SyncOptions = {
    * Return true to ignore, false to keep.
    */
   ignore?: (relativePath: string) => boolean;
+  /**
+   * Extra files to sync on every sync pass.
+   */
+  additionalFiles?: AdditionalFileSyncEntry[];
 };
 
 export type SyncResult = {
@@ -43,11 +51,18 @@ export type XcodeProjectConfig = {
   workspace?: string;
   project?: string;
   scheme?: string;
-  sdk?: 'iphonesimulator' | 'iphoneos';
+  sdk?: 'iphonesimulator' | 'iphoneos' | 'watchsimulator' | 'watchos';
+};
+
+export type XcodeSigningConfig = {
+  certificateP12Base64?: string;
+  certificatePassword?: string;
+  provisioningProfileBase64?: string;
 };
 
 export type XcodeBuildOptions = {
-  upload?: { assetName: string } | { signedUploadUrl: string; signedDownloadUrl: string };
+  upload?: { assetName: string } | { signedUploadUrl: string };
+  signing?: XcodeSigningConfig;
 };
 
 export type XcodeClient = {
@@ -94,6 +109,42 @@ function createLogger(logLevel: LogLevel) {
   };
 }
 
+function normalizeWorkspaceRelativePath(remotePath: string): string {
+  if (
+    remotePath === '' ||
+    remotePath.startsWith('/') ||
+    remotePath.includes('\\') ||
+    remotePath.includes('\0')
+  ) {
+    throw new Error(`invalid sandbox home path from server: ${remotePath}`);
+  }
+  const parts = remotePath.split('/');
+  if (parts.some((part) => part === '' || part === '.' || part === '..')) {
+    throw new Error(`invalid sandbox home path from server: ${remotePath}`);
+  }
+  return parts.join('/');
+}
+
+async function fetchSandboxInfo(apiUrl: string, token: string): Promise<{ homeDir: string }> {
+  const res = await nodeProxyTransport.fetch(`${apiUrl}/info`, {
+    method: 'GET',
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(`GET /info failed: ${res.status} ${text}`);
+  }
+  const body = JSON.parse(text) as { homeDir?: string };
+  if (!body.homeDir) {
+    throw new Error('GET /info response is missing homeDir');
+  }
+  return {
+    homeDir: normalizeWorkspaceRelativePath(body.homeDir),
+  };
+}
+
 export class XcodeInstances extends GeneratedXcodeInstances {
   async createClient(params: XcodeCreateClientParams): Promise<XcodeClient> {
     let apiUrl: string;
@@ -111,6 +162,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
 
     const log = createLogger(params.logLevel ?? 'info');
     const client = this._client;
+    const sandboxInfo = await fetchSandboxInfo(apiUrl, token);
 
     return {
       async sync(localCodePath: string, opts?: SyncOptions): Promise<SyncResult> {
@@ -119,6 +171,13 @@ export class XcodeInstances extends GeneratedXcodeInstances {
         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 additionalFiles = opts?.additionalFiles?.map((file) => ({
+          localPath: file.localPath,
+          remotePath:
+            file.remotePath.startsWith('~/') ?
+              `${sandboxInfo.homeDir}/${file.remotePath.slice(2)}`
+            : file.remotePath,
+        }));
         const codeSyncOpts: FolderSyncOptions = {
           apiUrl,
           token,
@@ -162,6 +221,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
           maxPatchBytes: opts?.maxPatchBytes ?? 4 * 1024 * 1024,
           launchMode: 'ForegroundIfRunning',
           log,
+          ...(additionalFiles ? { additionalFiles } : {}),
         };
 
         const result = await syncFolderImpl(localCodePath, codeSyncOpts);
@@ -175,6 +235,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
         const request: ExecRequest = {
           command: 'xcodebuild',
           ...(settings && { xcodebuild: settings }),
+          ...(options?.signing && { signing: options.signing }),
         };
 
         if (options?.upload && 'assetName' in options.upload) {
@@ -196,9 +257,8 @@ export class XcodeInstances extends GeneratedXcodeInstances {
           return exec(requestPromise, { apiUrl, token, log });
         }
 
-        if (options?.upload && 'signedUploadUrl' in options.upload && 'signedDownloadUrl' in options.upload) {
+        if (options?.upload && 'signedUploadUrl' in options.upload) {
           request.signedUploadUrl = options.upload.signedUploadUrl;
-          request.additionalMetadata = { signedDownloadUrl: options.upload.signedDownloadUrl };
         }
 
         return exec(request, { apiUrl, token, log });

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.28.2'; // x-release-please-version
+export const VERSION = '0.28.4'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.28.2";
+export declare const VERSION = "0.28.4";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.28.2";
+export declare const VERSION = "0.28.4";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.28.2'; // x-release-please-version
+exports.VERSION = '0.28.4'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.28.2'; // x-release-please-version
+export const VERSION = '0.28.4'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map