@run-cloud/sdk 0.27.0 → 0.29.0

package/dist/index.js

@@ -665,9 +665,11 @@ async function parseApiError(response) {
             ? normalizedScreenshotErrorCode(rawCode)
             : action === "accessibility"
                 ? normalizedAccessibilityErrorCode(rawCode)
-                : action !== "open-url" && (action !== undefined || interactionStatus !== undefined)
-                    ? normalizedInteractionErrorCode(rawCode)
-                    : optionalString(rawCode);
+                : action === "camera-video" || action === "microphone-audio"
+                    ? optionalString(rawCode)
+                    : action !== "open-url" && (action !== undefined || interactionStatus !== undefined)
+                        ? normalizedInteractionErrorCode(rawCode)
+                        : optionalString(rawCode);
         return {
             detail,
             code,
@@ -885,6 +887,25 @@ function validateXcodeBuildOptions(options) {
         throw new Error("Xcode build accepts either workspace or project, not both");
     if (options.xcodegen && options.reactNative)
         throw new Error("XcodeGen options cannot be combined with Expo or React Native options");
+    if (options.reuse) {
+        if (!/^xcb_[A-Za-z0-9]+$/.test(options.reuse.basisBuildId)) {
+            throw new Error("reuse.basisBuildId must be a run.cloud Xcode build ID");
+        }
+        if (!options.reactNative)
+            throw new Error("reuse requires reactNative options");
+        if (options.workspace || options.project || options.scheme || options.xcodegen) {
+            throw new Error("reuse cannot select a workspace, project, scheme, or XcodeGen spec");
+        }
+        if (options.sdk && options.sdk !== "iphonesimulator") {
+            throw new Error("reuse requires sdk iphonesimulator");
+        }
+        if (options.configuration && options.configuration !== "Release") {
+            throw new Error("reuse requires configuration Release");
+        }
+        if (options.signing || options.cloudSigning || options.appStore || options.appstore) {
+            throw new Error("reuse cannot be combined with signing or App Store upload");
+        }
+    }
     const devServerUrl = options.reactNative?.devServerUrl ?? options.reactNative?.devServerURL;
     if (devServerUrl && options.configuration === "Release")
         throw new Error("reactNative.devServerUrl is only supported for Debug builds");
@@ -919,6 +940,8 @@ export class Client {
     images;
     remotion;
     xcode;
+    capabilities;
+    mobile;
     apiKey;
     apiUrl;
     fetchImpl;
@@ -946,6 +969,8 @@ export class Client {
         this.images = new ImageClient(this);
         this.remotion = new RemotionClient(this.sandboxes, this.snapshots);
         this.xcode = new XcodeBuildsClient(this);
+        this.capabilities = new CapabilitiesClient(this);
+        this.mobile = new MobileClient(this);
     }
     async usage(options = {}) {
         const query = options.orgId ? `?orgId=${encodeURIComponent(options.orgId)}` : "";
@@ -1283,6 +1308,16 @@ export class XcodeBuildsClient {
         const idempotencyKey = options.idempotencyKey ?? `xcode_${randomUUID()}`;
         return await retryXcodeOperation(async () => await this.client.uploadForm("/run-cloud/xcode/builds", form, { "Idempotency-Key": idempotencyKey }));
     }
+    /** Reuse a compatible simulator native shell and replace only its embedded JavaScript bundle. */
+    async rebundle(sourcePath, basisBuildId, options = {}) {
+        return await this.build(sourcePath, {
+            ...options,
+            sdk: "iphonesimulator",
+            configuration: "Release",
+            reactNative: options.reactNative ?? {},
+            reuse: { basisBuildId },
+        });
+    }
     async get(id) {
         return await retryXcodeOperation(async () => await this.client.request("GET", `/run-cloud/xcode/builds/${encodeURIComponent(id)}`));
     }
@@ -1295,8 +1330,21 @@ export class XcodeBuildsClient {
         const result = await retryXcodeOperation(async () => await this.client.request("GET", `/run-cloud/xcode/builds${query.size ? `?${query}` : ""}`));
         return result.items;
     }
-    async logs(id, offset = 0) {
-        return await retryXcodeOperation(async () => await this.client.request("GET", `/run-cloud/xcode/builds/${encodeURIComponent(id)}/logs?offset=${offset}`));
+    /** Read an ordered, replayable event page. Persist nextCursor after processing the page. */
+    async events(options = {}) {
+        const query = new URLSearchParams();
+        if (options.orgId)
+            query.set("orgId", options.orgId);
+        if (options.after !== undefined)
+            query.set("after", String(options.after));
+        if (options.buildId)
+            query.set("buildId", options.buildId);
+        if (options.limit !== undefined)
+            query.set("limit", String(options.limit));
+        return await retryXcodeOperation(async () => await this.client.request("GET", `/run-cloud/xcode/events${query.size ? `?${query}` : ""}`));
+    }
+    async logs(id, offset = 0, source) {
+        return await retryXcodeOperation(async () => await this.client.request("GET", `/run-cloud/xcode/builds/${encodeURIComponent(id)}/logs?offset=${offset}${source ? `&source=${source}` : ""}`));
     }
     /** Poll state and emit sanitized log chunks until the build is terminal. */
     async wait(id, options = {}) {
@@ -1304,15 +1352,17 @@ export class XcodeBuildsClient {
         const deadline = Date.now() + timeoutSeconds * 1_000;
         const interval = options.pollIntervalMs ?? 1_000;
         let offset = 0;
+        let source;
         for (;;) {
             if (options.signal?.aborted)
                 throw new DOMException("The operation was aborted", "AbortError");
             let build = await this.get(id);
             if (build.logs.available || build.status === "running" || build.status === "queued") {
-                const chunk = await this.logs(id, offset);
+                const chunk = await this.logs(id, offset, source);
                 if (chunk.text)
                     options.onLog?.(chunk.text);
                 offset = chunk.nextOffset;
+                source = chunk.source ?? source;
                 if (["succeeded", "failed", "cancelled"].includes(build.status) && chunk.complete)
                     return build;
             }
@@ -1362,8 +1412,12 @@ export class SimulatorClient {
         return await this.client.request("PATCH", `/run-cloud/${this.platform}/${encodeURIComponent(id)}/tags`, { tags });
     }
     async list(options = {}) {
-        const query = options.all ? "?all=1" : "";
-        return await this.client.request("GET", `/run-cloud/${this.platform}${query}`);
+        const query = new URLSearchParams();
+        if (options.all)
+            query.set("all", "1");
+        if (options.orgId)
+            query.set("orgId", options.orgId);
+        return await this.client.request("GET", `/run-cloud/${this.platform}${query.size ? `?${query}` : ""}`);
     }
     async get(id) {
         return await this.client.request("GET", `/run-cloud/${this.platform}/${encodeURIComponent(id)}`);
@@ -1405,6 +1459,141 @@ export class SimulatorClient {
         });
         return await this.installAsset(id, asset.id);
     }
+    /** Upload a deterministic video and present it to the app as live camera input. */
+    async uploadCameraVideo(id, video, options = {}) {
+        const contentType = video.type.toLowerCase();
+        if (contentType !== "video/mp4" && contentType !== "video/quicktime") {
+            throw new Error("camera video must have content type video/mp4 or video/quicktime");
+        }
+        const bundleId = options.bundleId?.trim();
+        if (bundleId && bundleId.length > 256) {
+            throw new Error("bundleId must be at most 256 characters");
+        }
+        const inferredName = video.name;
+        const filename = options.filename
+            ?? (typeof inferredName === "string" && inferredName ? inferredName : undefined)
+            ?? (contentType === "video/quicktime" ? "camera.mov" : "camera.mp4");
+        const asset = await this.client.assets.upload(video, {
+            filename,
+            name: options.name,
+        });
+        try {
+            const result = await this.client.request("POST", `/run-cloud/${this.platform}/${encodeURIComponent(id)}/camera-video`, {
+                assetId: asset.id,
+                ...(bundleId ? { bundleId } : {}),
+            }, undefined, {
+                errorContext: { sessionId: id, platform: this.platform, action: "camera-video" },
+                transportErrorCode: "camera_video_transport_error",
+                transportErrorMessage: "camera video injection could not reach the run.cloud API",
+            });
+            const response = result && typeof result === "object" && !Array.isArray(result)
+                ? result
+                : null;
+            if (!response
+                || response.ok !== true
+                || response.platform !== this.platform
+                || response.sessionId !== id
+                || (response.bundleId !== null && typeof response.bundleId !== "string")
+                || response.filename !== filename
+                || response.contentType !== contentType
+                || response.byteSize !== video.size
+                || response.source !== "video"
+                || (response.pid !== null && typeof response.pid !== "number")
+                || !isAsset(response.asset)
+                || response.asset.id !== asset.id) {
+                throw new RunCloudError(0, "camera video injection returned an invalid acknowledgement", {
+                    code: "camera_video_invalid_response",
+                    retryable: true,
+                    sessionId: id,
+                    platform: this.platform,
+                    action: "camera-video",
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            await this.client.assets.delete(asset.id).catch(() => undefined);
+            throw error;
+        }
+    }
+    /** Upload audio and deliver its decoded samples to the app microphone. */
+    async uploadMicrophoneAudio(id, audio, options = {}) {
+        const contentType = audio.type.toLowerCase();
+        const supported = new Set([
+            "audio/aac",
+            "audio/m4a",
+            "audio/mp4",
+            "audio/mpeg",
+            "audio/wav",
+            "audio/x-m4a",
+            "audio/x-wav",
+        ]);
+        if (!supported.has(contentType)) {
+            throw new Error("audio must be AAC, M4A, MP3, MP4 audio, or WAV");
+        }
+        const bundleId = options.bundleId?.trim();
+        if (bundleId && bundleId.length > 256) {
+            throw new Error("bundleId must be at most 256 characters");
+        }
+        const inferredName = audio.name;
+        const extension = contentType.includes("wav")
+            ? "wav"
+            : contentType === "audio/mpeg"
+                ? "mp3"
+                : contentType === "audio/aac"
+                    ? "aac"
+                    : "m4a";
+        const filename = options.filename
+            ?? (typeof inferredName === "string" && inferredName ? inferredName : undefined)
+            ?? `microphone.${extension}`;
+        const asset = await this.client.assets.upload(audio, {
+            filename,
+            name: options.name,
+        });
+        try {
+            const result = await this.client.request("POST", `/run-cloud/${this.platform}/${encodeURIComponent(id)}/microphone-audio`, {
+                assetId: asset.id,
+                ...(bundleId ? { bundleId } : {}),
+            }, undefined, {
+                errorContext: { sessionId: id, platform: this.platform, action: "microphone-audio" },
+                transportErrorCode: "microphone_audio_transport_error",
+                transportErrorMessage: "microphone audio injection could not reach the run.cloud API",
+            });
+            const response = result && typeof result === "object" && !Array.isArray(result)
+                ? result
+                : null;
+            const optionalFinite = (value) => value === undefined
+                || (typeof value === "number" && Number.isFinite(value) && value >= 0);
+            if (!response
+                || response.ok !== true
+                || response.platform !== this.platform
+                || response.sessionId !== id
+                || typeof response.bundleId !== "string"
+                || response.filename !== filename
+                || response.contentType !== contentType
+                || response.byteSize !== audio.size
+                || (response.pid !== null && typeof response.pid !== "number")
+                || !optionalFinite(response.sampleRate)
+                || !optionalFinite(response.channels)
+                || !optionalFinite(response.sampleCount)
+                || !optionalFinite(response.durationMs)
+                || !isAsset(response.asset)
+                || response.asset.id !== asset.id) {
+                throw new RunCloudError(0, "microphone audio injection returned an invalid acknowledgement", {
+                    code: "microphone_audio_invalid_response",
+                    retryable: true,
+                    sessionId: id,
+                    platform: this.platform,
+                    action: "microphone-audio",
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            await this.client.assets.delete(asset.id).catch(() => undefined);
+            throw error;
+        }
+    }
     async keepAlive(id) {
         const result = await this.client.request("POST", `/run-cloud/${this.platform}/${encodeURIComponent(id)}/activity`, {});
         if (result.ok !== true
@@ -1725,40 +1914,6 @@ export class IosSimulatorClient extends SimulatorClient {
         });
         return await this.client.request("POST", `/run-cloud/ios/${encodeURIComponent(id)}/videos`, { assetId: asset.id });
     }
-    async uploadMicrophoneAudio(id, audio, options = {}) {
-        const contentType = audio.type.toLowerCase();
-        const supported = new Set([
-            "audio/aac",
-            "audio/m4a",
-            "audio/mp4",
-            "audio/mpeg",
-            "audio/wav",
-            "audio/x-m4a",
-            "audio/x-wav",
-        ]);
-        if (!supported.has(contentType)) {
-            throw new Error("audio must be AAC, M4A, MP3, MP4 audio, or WAV");
-        }
-        const inferredName = audio.name;
-        const extension = contentType.includes("wav")
-            ? "wav"
-            : contentType === "audio/mpeg"
-                ? "mp3"
-                : contentType === "audio/aac"
-                    ? "aac"
-                    : "m4a";
-        const filename = options.filename
-            ?? (typeof inferredName === "string" && inferredName ? inferredName : undefined)
-            ?? `microphone.${extension}`;
-        const asset = await this.client.assets.upload(audio, {
-            filename,
-            name: options.name,
-        });
-        return await this.client.request("POST", `/run-cloud/ios/${encodeURIComponent(id)}/microphone-audio`, {
-            assetId: asset.id,
-            ...(options.bundleId ? { bundleId: options.bundleId } : {}),
-        });
-    }
 }
 export class SimulatorsClient {
     client;
@@ -1770,11 +1925,15 @@ export class SimulatorsClient {
         return await new SimulatorClient(this.client, platform).create(rest);
     }
     async list(options = {}) {
-        const { platform, all } = options;
+        const { platform, all, orgId } = options;
         if (platform)
-            return await new SimulatorClient(this.client, platform).list({ all });
-        const query = all ? "?all=1" : "";
-        return await this.client.request("GET", `/run-cloud/simulators${query}`);
+            return await new SimulatorClient(this.client, platform).list({ all, orgId });
+        const query = new URLSearchParams();
+        if (all)
+            query.set("all", "1");
+        if (orgId)
+            query.set("orgId", orgId);
+        return await this.client.request("GET", `/run-cloud/simulators${query.size ? `?${query}` : ""}`);
     }
     async get(id, options = {}) {
         return await new SimulatorClient(this.client, options.platform ?? "ios").get(id);
@@ -1792,6 +1951,14 @@ export class SimulatorsClient {
         const { platform = "ios", ...installOptions } = options;
         return await new SimulatorClient(this.client, platform).install(id, application, installOptions);
     }
+    async uploadCameraVideo(id, video, options = {}) {
+        const { platform = "ios", ...mediaOptions } = options;
+        return await new SimulatorClient(this.client, platform).uploadCameraVideo(id, video, mediaOptions);
+    }
+    async uploadMicrophoneAudio(id, audio, options = {}) {
+        const { platform = "ios", ...mediaOptions } = options;
+        return await new SimulatorClient(this.client, platform).uploadMicrophoneAudio(id, audio, mediaOptions);
+    }
     async keepAlive(id, options = {}) {
         return await new SimulatorClient(this.client, options.platform ?? "ios").keepAlive(id);
     }
@@ -2417,8 +2584,9 @@ export class AssetsClient {
     constructor(client) {
         this.client = client;
     }
-    async list() {
-        return await this.client.request("GET", "/run-cloud/assets");
+    async list(options = {}) {
+        const query = options.orgId ? `?orgId=${encodeURIComponent(options.orgId)}` : "";
+        return await this.client.request("GET", `/run-cloud/assets${query}`);
     }
     /** Upload through the buffered multipart endpoint instead of signed storage URLs. */
     async uploadDirect(file, options = {}) {
@@ -2440,6 +2608,7 @@ export class AssetsClient {
             const uploadRunId = options.uploadRunId ?? this.defaultUploadRunId;
             const prepared = await this.client.request("POST", "/run-cloud/assets/uploads", {
                 filename,
+                ...(options.orgId ? { orgId: options.orgId } : {}),
                 ...(options.name ? { name: options.name } : {}),
                 contentType: file.type || "application/octet-stream",
                 byteSize: file.size,
@@ -2525,4 +2694,50 @@ export class AssetsClient {
         return await this.client.request("DELETE", `/run-cloud/assets/${encodeURIComponent(id)}`);
     }
 }
+export class CapabilitiesClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Mint a short-lived bearer token. The token is returned only by this call. */
+    async create(options) {
+        return await this.client.request("POST", "/run-cloud/capabilities", options);
+    }
+    async list(options = {}) {
+        const query = new URLSearchParams();
+        if (options.orgId)
+            query.set("orgId", options.orgId);
+        if (options.active === false)
+            query.set("active", "0");
+        const result = await this.client.request("GET", `/run-cloud/capabilities${query.size ? `?${query}` : ""}`);
+        return result.items;
+    }
+    async revoke(id) {
+        return await this.client.request("DELETE", `/run-cloud/capabilities/${encodeURIComponent(id)}`);
+    }
+}
+export class MobileClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Idempotently create a mobile session and install one existing Asset or Xcode build output. */
+    async launch(source, options) {
+        if (!options.idempotencyKey?.trim()) {
+            throw new Error("mobile.launch requires a stable idempotencyKey");
+        }
+        if (Boolean(source.assetId) === Boolean(source.buildId)) {
+            throw new Error("mobile.launch requires exactly one assetId or buildId");
+        }
+        return await this.client.request("POST", "/run-cloud/mobile/launch", {
+            ...(source.assetId ? { assetId: source.assetId } : { buildId: source.buildId }),
+            ...(options.orgId ? { orgId: options.orgId } : {}),
+            ...(options.platform ? { platform: options.platform } : {}),
+            ...(options.session ? { session: options.session } : {}),
+        }, { "Idempotency-Key": options.idempotencyKey });
+    }
+    async getLaunch(id) {
+        return await this.client.request("GET", `/run-cloud/mobile/launches/${encodeURIComponent(id)}`);
+    }
+}
 //# sourceMappingURL=index.js.map