@limrun/api 0.46.13 → 0.47.0

package/src/ios-client.ts

@@ -270,6 +270,18 @@ export type ContainerTargetOptions = {
   containerType?: string;
 };
 
+/** A file or directory inside the simulator staging folder or an app container. */
+export type IosFileEntry = {
+  /** Entry name within the listed directory. */
+  name: string;
+  /** Entry path relative to the selected storage root; usable with pullFile/pushFile/deleteFile. */
+  path: string;
+  /** Whether the entry is a directory. */
+  isDirectory: boolean;
+  /** File size in bytes. Omitted for directories. */
+  size?: number;
+};
+
 /**
  * Options for playing a video file as the simulated camera feed.
  */
@@ -949,6 +961,17 @@ export type InstanceClient = {
    */
   pullFile: (name: string, opts?: ContainerTargetOptions) => Promise<Buffer>;
 
+  /**
+   * List a directory in the simulator staging folder or an app container.
+   *
+   * Returned paths are relative to the selected storage root and can be passed
+   * directly to `pullFile`, `pushFile`, or `deleteFile` with the same options.
+   *
+   * @param path Relative directory to list. Empty or `.` lists the storage root.
+   * @param opts Optional app container targeting (see `pushFile`).
+   */
+  listFiles: (path?: string, opts?: ContainerTargetOptions) => Promise<IosFileEntry[]>;
+
   /**
    * Delete a file or folder (recursively) on the simulator.
    *
@@ -2023,6 +2046,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
             xcodebuild,
             pushFile,
             pullFile,
+            listFiles,
             deleteFile,
             setCameraVideo,
             clearCameraVideo,
@@ -2612,6 +2636,33 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       return Buffer.from(await response.arrayBuffer());
     };
 
+    const listFiles = async (path = '.', opts?: ContainerTargetOptions): Promise<IosFileEntry[]> => {
+      const params = new URLSearchParams();
+      if (path && path !== '.') {
+        params.set('path', path);
+      }
+      if (opts?.bundleId) {
+        params.set('bundleId', opts.bundleId);
+        if (opts.containerType) {
+          params.set('containerType', opts.containerType);
+        }
+      }
+      const query = params.toString();
+      const url = `${options.apiUrl}/files/list${query ? `?${query}` : ''}`;
+      const response = await nodeProxyTransport.fetch(url, {
+        method: 'GET',
+        headers: {
+          Authorization: `Bearer ${options.token}`,
+        },
+      });
+      if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`Listing of '${path}' failed: ${response.status} ${errorBody}`);
+      }
+      const result = (await response.json()) as { entries: IosFileEntry[] };
+      return result.entries;
+    };
+
     const deleteFile = async (name: string, opts?: ContainerTargetOptions): Promise<void> => {
       const response = await nodeProxyTransport.fetch(buildFilesUrl(name, opts), {
         method: 'DELETE',

package/src/resources/daemon-client-shared.ts

@@ -88,9 +88,19 @@ export type AssetUploadOptions = {
   deeplink?: string;
 };
 
+/**
+ * Default TTL for build-product uploads. Every build upload without an
+ * explicit ttl pushes the asset's expiry to 14 days from that upload, so
+ * abandoned build artifacts don't accumulate in Asset Storage forever.
+ * Assets uploaded through the general asset API keep no expiry by default.
+ */
+export const DEFAULT_BUILD_ASSET_TTL = '336h';
+
 /**
  * Mints presigned upload/download URLs for a named asset via assets.getOrCreate,
  * wrapping failures with the asset name (and the original error as cause).
+ * All build-product upload paths (xcodebuild, gradlebuild, RBE) go through
+ * here, which is what scopes DEFAULT_BUILD_ASSET_TTL to build uploads.
  */
 export function mintAssetUploadUrls(
   assets: {
@@ -100,7 +110,7 @@ export function mintAssetUploadUrls(
   ttl?: string,
   uploadOptions?: AssetUploadOptions,
 ): Promise<AssetUploadUrls> {
-  return assets.getOrCreate({ name, ...(ttl && { ttl }), ...uploadOptions }).catch((err) => {
+  return assets.getOrCreate({ name, ttl: ttl || DEFAULT_BUILD_ASSET_TTL, ...uploadOptions }).catch((err) => {
     const message = `Failed to create upload URL for asset '${name}': ${
       err instanceof Error ? err.message : err
     }`;

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

@@ -56,7 +56,19 @@ export type GradleBuildOptions = {
   /** Relative path to the Gradle root when auto-discovery is ambiguous. */
   projectPath?: string;
   /** Upload the built artifact as a named org asset, or to a presigned URL. */
-  upload?: { assetName: string; signedUploadUrl?: never } | { signedUploadUrl: string; assetName?: never };
+  upload?:
+    | {
+        assetName: string;
+        /**
+         * Asset TTL as a Go duration (e.g. "24h", "30m"; "1d" is invalid),
+         * forwarded to assets.getOrCreate. Defaults to 336h (14 days): each
+         * build upload without an explicit ttl pushes the asset's expiry to
+         * 14 days from that upload.
+         */
+        ttl?: string;
+        signedUploadUrl?: never;
+      }
+    | { signedUploadUrl: string; assetName?: never; ttl?: never };
   /** React Native / Expo tuning. */
   reactNative?: GradleReactNativeConfig;
   /** Release signing config; presence makes bundleRelease the default task. */
@@ -183,13 +195,15 @@ class GradleInstancesHelpers extends GradleInstances {
         };
 
         if (options?.upload && 'assetName' in options.upload) {
-          const requestPromise = mintAssetUploadUrls(client.assets, options.upload.assetName).then(
-            (asset) => {
-              request.signedUploadUrl = asset.signedUploadUrl;
-              request.additionalMetadata = { signedDownloadUrl: asset.signedDownloadUrl };
-              return request;
-            },
-          );
+          const requestPromise = mintAssetUploadUrls(
+            client.assets,
+            options.upload.assetName,
+            options.upload.ttl,
+          ).then((asset) => {
+            request.signedUploadUrl = asset.signedUploadUrl;
+            request.additionalMetadata = { signedDownloadUrl: asset.signedDownloadUrl };
+            return request;
+          });
           return exec(requestPromise, { apiUrl, token, log });
         }
 

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

@@ -90,8 +90,12 @@ export type SyncOptions = {
 export type XcodeRunOptions = {
   /** Working directory relative to the synced workspace root. Defaults to ".". */
   cwd?: string;
-  /** Environment variables to add to limbuild's curated sandbox environment. */
-  env?: Record<string, string>;
+  /**
+   * Ordered KEY=VALUE entries added to limbuild's curated sandbox
+   * environment. Server-managed variables (PATH, HOME, ...) cannot be
+   * overridden; when a key repeats, the last entry wins.
+   */
+  env?: string[];
   /** Server-side timeout in seconds. Defaults to 3600; maximum 21600. */
   timeoutSeconds?: number;
 };
@@ -105,6 +109,14 @@ export type XcodeProjectConfig = {
    * Debug for native Xcode builds and Release for React Native / Expo builds.
    */
   configuration?: 'Debug' | 'Release';
+  /**
+   * Full filename of the built app bundle, including the .app extension
+   * (e.g. "MyApp-dev.app"). When set, limbuild takes the artifact from
+   * this name in the built products directory verbatim, skipping artifact
+   * discovery. Use when the scheme name differs from the product name and
+   * discovery picks the wrong bundle.
+   */
+  artifactName?: string;
 };
 
 export type XcodeGenConfig = {
@@ -173,12 +185,28 @@ export type ReactNativeBuildConfig = {
    * server URL you want opened.
    */
   devServerURL?: string;
+  /**
+   * Run `expo prebuild` even when the synced workspace already contains the
+   * native ios/ tree, regenerating it in place. Use when the tree holds
+   * client-synced files the server treats as user-owned (for example
+   * committed Podfile customizations) while the Xcode project itself is
+   * generated and gitignored. Requires a detectable Expo project. Older
+   * limbuild servers silently ignore this option.
+   */
+  expoForcePrebuild?: boolean;
 };
 
 export type XcodeBuildOptions = {
   upload?:
     | {
         assetName: string;
+        /**
+         * Asset TTL as a Go duration (e.g. "24h", "30m"; "1d" is invalid),
+         * forwarded to assets.getOrCreate. Defaults to 336h (14 days): each
+         * build upload without an explicit ttl pushes the asset's expiry to
+         * 14 days from that upload.
+         */
+        ttl?: string;
         /**
          * App metadata to record on the asset up front. limbuild extracts
          * the same metadata from the built bundle after the build and
@@ -207,6 +235,16 @@ export type XcodeBuildOptions = {
    */
   xcodegen?: XcodeGenConfig;
   buildSettings?: Record<string, string>;
+  /**
+   * Ordered KEY=VALUE entries added to the environment of every build
+   * pipeline command (dependency installs, expo prebuild, pod install,
+   * xcodebuild and its script phases). Server-managed variables (PATH,
+   * HOME, ...) cannot be overridden; when a key repeats, the last entry
+   * wins. Dependency installs always include devDependencies, so
+   * NODE_ENV=production cannot break them. Older limbuild servers
+   * silently ignore this option.
+   */
+  env?: string[];
   /**
    * Run `git init` in the synced workspace before project generation,
    * dependency resolution, and xcodebuild.
@@ -323,7 +361,12 @@ export type RbeUploadOptions =
   | {
       /** Upload as a named asset: the SDK mints the presigned upload URL via assets.getOrCreate. */
       assetName: string;
-      /** Optional asset TTL as a Go duration (e.g. "24h", "30m"; "1d" is invalid), forwarded to assets.getOrCreate. */
+      /**
+       * Optional asset TTL as a Go duration (e.g. "24h", "30m"; "1d" is
+       * invalid), forwarded to assets.getOrCreate. Defaults to 336h (14
+       * days): each upload without an explicit ttl pushes the asset's
+       * expiry to 14 days from that upload.
+       */
       ttl?: string;
       signedUploadUrl?: never;
     }
@@ -813,6 +856,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
           // testflight until the exec API is revised separately.
           ...(options?.appstore && { testflight: options.appstore }),
           ...(options?.buildSettings && { buildSettings: options.buildSettings }),
+          ...(options?.env?.length && { env: options.env }),
           ...(options?.gitInit !== undefined && { gitInit: options.gitInit }),
           ...(options?.webhook && { webhook: options.webhook }),
         };
@@ -821,7 +865,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
           const requestPromise = mintAssetUploadUrls(
             client.assets,
             options.upload.assetName,
-            undefined,
+            options.upload.ttl,
             options.upload.uploadOptions,
           ).then((asset) => {
             request.signedUploadUrl = asset.signedUploadUrl;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.46.13'; // x-release-please-version
+export const VERSION = '0.47.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,YAAY,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,YAAY,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,SAAS,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}