@limrun/api 0.39.0 → 0.39.2

package/src/exec-client.ts

@@ -30,6 +30,7 @@ export type ExecRequest = {
     certificatePassword?: string;
     provisioningProfileBase64?: string;
   };
+  testflight?: TestflightUploadConfig;
   buildSettings?: Record<string, string>;
   signedUploadUrl?: string;
   additionalMetadata?: {
@@ -48,6 +49,40 @@ export type ExecResult = {
   execId: string;
   status: 'SUCCEEDED' | 'FAILED' | 'CANCELLED';
   signedDownloadUrl?: string;
+  /**
+   * Last TestFlight state streamed by the server. Absent when the build ran
+   * without a testflight request, or when the server predates the feature.
+   */
+  testflight?: TestflightEvent;
+  /**
+   * True when the client gave up waiting for the build's event stream. The
+   * exit code is fabricated in that case; the remote build may still be
+   * running and may yet succeed.
+   */
+  timedOut?: boolean;
+};
+
+export type TestflightEvent = {
+  /** 'unknown' means a testflight event arrived but its payload was unreadable. */
+  state: 'uploading' | 'processing' | 'accepted' | 'failed' | 'unknown';
+  uploadId?: string;
+  buildId?: string;
+};
+
+export type TestflightUploadConfig = {
+  /** App Store Connect API key ID, e.g. 2X9R4HXF34. */
+  apiKeyId: string;
+  /** Issuer ID for team API keys. Omit for individual API keys. */
+  apiIssuerId?: string;
+  /** Base64-encoded content of the .p8 private key file. */
+  apiPrivateKeyBase64: string;
+  /**
+   * How long the server watches for App Store Connect's processing verdict
+   * after the upload. A FAILED verdict within the window fails the build;
+   * expiry without a verdict succeeds with the build still processing on
+   * Apple's side. 0 skips the watch. Defaults to 120.
+   */
+  waitTimeoutSeconds?: number;
 };
 
 type DataListener = (chunk: string) => void;
@@ -121,6 +156,7 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
   private abortController = new AbortController();
   private sseConnection: EventSourceClient | null = null;
   private killed = false;
+  private testflightEvent: TestflightEvent | null = null;
   private readonly options: ExecOptions;
   private readonly log: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
 
@@ -228,8 +264,15 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
     // 2. Stream logs via SSE and wait for exit code
     const eventsUrl = `${apiUrl}/exec/${this.execId}/events`;
 
-    const timeoutMs = 3600 * 1000; // 1 hour max
+    // 1 hour max for the build itself; a TestFlight request extends the
+    // budget by its server-side verdict watch plus upload headroom so a long
+    // build is not force-failed client-side while the server still succeeds.
+    let timeoutMs = 3600 * 1000;
+    if (request.testflight) {
+      timeoutMs += (Math.max(0, request.testflight.waitTimeoutSeconds ?? 120) + 900) * 1000;
+    }
     let exitCode: number;
+    let timedOut = false;
     let timeoutId: ReturnType<typeof setTimeout> | undefined;
     try {
       exitCode = await Promise.race([
@@ -243,8 +286,11 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
         log('debug', 'Build killed');
         exitCode = -1;
       } else {
+        // The client stopped waiting; the remote build may still be running.
+        // The fabricated exit code must not read as a build failure.
         log('warn', 'SSE completion timeout');
         exitCode = 1;
+        timedOut = true;
       }
     } finally {
       clearTimeout(timeoutId);
@@ -275,6 +321,8 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
       execId: this.execId!,
       status,
       ...(request.additionalMetadata ?? {}),
+      ...(this.testflightEvent ? { testflight: this.testflightEvent } : {}),
+      ...(timedOut ? { timedOut } : {}),
     };
 
     this.log('debug', `Build finished: ${result.status} (exit ${result.exitCode})`);
@@ -307,6 +355,15 @@ export class ExecChildProcess implements PromiseLike<ExecResult> {
               this.stdout.emit('data', data);
             } else if (eventType === 'stderr') {
               this.stderr.emit('data', data);
+            } else if (eventType === 'testflight') {
+              try {
+                this.testflightEvent = JSON.parse(data) as TestflightEvent;
+              } catch {
+                // The event itself proves the server ran the TestFlight step,
+                // so never let a payload glitch look like a missing feature.
+                this.testflightEvent = { state: 'unknown' };
+                this.log('warn', `SSE testflight event has invalid data: ${data}`);
+              }
             } else if (eventType === 'exitCode') {
               const exitCode = parseInt(data, 10);
               if (Number.isNaN(exitCode)) {

package/src/folder-sync.ts

@@ -59,6 +59,12 @@ export type FolderSyncOptions = {
 export type SyncFolderResult = {
   installedAppPath?: string;
   installedBundleId?: string;
+  /**
+   * Number of bytes transmitted to the server for this sync (full uploads plus
+   * delta patches, before transport compression). In watch mode, this reflects
+   * the initial sync only.
+   */
+  bytesSent?: number;
   /** Present only when watch=true; call to stop watching. */
   stopWatching?: () => Promise<void>;
 };
@@ -703,6 +709,7 @@ async function syncFolderOnce(
         },
         filePath: entry.absPath,
       });
+      bytesSentFull += entry.size;
     }
     if (retryPayloads.length > 0) {
       slog('debug', `server requested full for ${retryPayloads.length} files; retrying once`);
@@ -747,7 +754,7 @@ async function syncFolderOnce(
       syncWorkMs,
     )} total=${fmtMs(tookMs)}`,
   );
-  const out: SyncFolderResult = {};
+  const out: SyncFolderResult = { bytesSent: totalBytes };
   if (resp.installedAppPath) {
     out.installedAppPath = resp.installedAppPath;
   }

package/src/index.ts

@@ -16,6 +16,8 @@ export {
   type ExecOptions,
   type ExecResult,
   type ExecChildProcess,
+  type TestflightEvent,
+  type TestflightUploadConfig,
 } from './exec-client';
 export {
   type XcodeCreateClientParams,

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

@@ -4,7 +4,9 @@ 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 { exec, type ExecChildProcess, type ExecRequest, type TestflightUploadConfig } from '../exec-client';
+
+export type { TestflightUploadConfig } from '../exec-client';
 import {
   syncFolder as syncFolderImpl,
   type AdditionalFileSyncEntry,
@@ -50,6 +52,12 @@ export type SyncOptions = {
 };
 
 export type SyncResult = {
+  /**
+   * Number of bytes transmitted to the server for this sync (full uploads plus
+   * delta patches, before transport compression). In watch mode, this reflects
+   * the initial sync only.
+   */
+  bytesSent?: number;
   /** Present only when watch=true; call to stop watching */
   stopWatching?: () => Promise<void>;
 };
@@ -93,6 +101,13 @@ export type ReactNativeBuildConfig = {
 export type XcodeBuildOptions = {
   upload?: { assetName: string } | { signedUploadUrl: string };
   signing?: XcodeSigningConfig;
+  /**
+   * Upload the signed device IPA to TestFlight after the build. Requires
+   * signing and sdk=iphoneos. Check ExecResult.testflight on completion: it is
+   * absent when the instance's limbuild predates the feature (old servers
+   * silently ignore this option).
+   */
+  testflight?: TestflightUploadConfig;
   reactNative?: ReactNativeBuildConfig;
   buildSettings?: Record<string, string>;
 };
@@ -619,10 +634,14 @@ export class XcodeInstances extends GeneratedXcodeInstances {
         };
 
         const result = await syncFolderImpl(localCodePath, codeSyncOpts);
+        const out: SyncResult = {};
+        if (result.bytesSent !== undefined) {
+          out.bytesSent = result.bytesSent;
+        }
         if (result.stopWatching) {
-          return { stopWatching: result.stopWatching };
+          out.stopWatching = result.stopWatching;
         }
-        return {};
+        return out;
       },
 
       xcodebuild(settings?: XcodeProjectConfig, options?: XcodeBuildOptions): ExecChildProcess {
@@ -637,6 +656,7 @@ export class XcodeInstances extends GeneratedXcodeInstances {
           ...(settings && { xcodebuild: settings }),
           ...(options?.reactNative && { reactNative: options.reactNative }),
           ...(options?.signing && { signing: options.signing }),
+          ...(options?.testflight && { testflight: options.testflight }),
           ...(options?.buildSettings && { buildSettings: options.buildSettings }),
         };
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.39.0'; // x-release-please-version
+export const VERSION = '0.39.2'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.39.0";
+export declare const VERSION = "0.39.2";
 //# 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.39.0'; // x-release-please-version
+exports.VERSION = '0.39.2'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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