runcloud 0.1.115 → 0.1.116

package/README.md

@@ -82,6 +82,23 @@ runcloud android press-key <id> enter
 runcloud android screenshot <id> --output android.png --json
 ```
 
+`open-url` accepts HTTPS URLs and application deep links on both platforms. Keep
+the complete target quoted so its URI delimiters stay in one argument:
+
+```bash
+runcloud ios open-url \
+  'runcloudproof://open/items%2F42?message=hello%20world&return=https%3A%2F%2Fexample.com%2Fdone%3Fx%3D1%26y%3Dtwo#proof' \
+  --id <id> \
+  --json
+```
+
+Success returns `ok`, `platform`, `sessionId`, `device`, `leaseId`, and the
+exact input `url`. Replace `ios` with `android` for an emulator. See
+[Open URLs and Deep Links](https://docs.run.cloud/platform/open-urls) for SDK
+and REST examples, platform behavior, validation, and troubleshooting.
+On iOS, a first custom-scheme handoff can still require confirming the system's
+**Open in “App”?** prompt after the success acknowledgement.
+
 Useful `create` flags: `--region`, `--display-name`, `--inactivity-timeout 3m`,
 `--hard-timeout 1h`, `--install-asset <name-or-id>`, `--rm` (release when the
 command exits), `--json`.

package/dist/api.js

@@ -10,6 +10,7 @@ export class ApiError extends Error {
     sessionId;
     platform;
     action;
+    suggestedAction;
     interactionStatus;
     acceptedAt;
     completedAt;
@@ -65,6 +66,7 @@ function parsedError(body) {
             ...(typeof parsed.sessionId === 'string' ? { sessionId: parsed.sessionId } : {}),
             ...(platform ? { platform } : {}),
             ...(typeof parsed.action === 'string' ? { action: parsed.action } : {}),
+            ...(typeof nested?.action === 'string' ? { suggestedAction: nested.action } : {}),
             ...(interactionStatus ? { interactionStatus } : {}),
             ...(typeof parsed.acceptedAt === 'string' ? { acceptedAt: parsed.acceptedAt } : {}),
             ...(typeof parsed.completedAt === 'string' ? { completedAt: parsed.completedAt } : {}),

package/dist/commands/run-cloud.js

@@ -733,6 +733,58 @@ async function createSimulatorSession(platform, opts) {
         ...(opts.devHost ? { devHost: opts.devHost } : {}),
     });
 }
+async function openSimulatorSessionUrl(platform, sessionId, url) {
+    const path = `/run-cloud/${platform}/${encodeURIComponent(sessionId)}/open-url`;
+    try {
+        const response = await client().post(path, { url });
+        const result = typeof response === 'object' && response !== null && !Array.isArray(response)
+            ? response
+            : {};
+        if (result.ok !== true
+            || result.platform !== platform
+            || result.sessionId !== sessionId
+            || typeof result.device !== 'string'
+            || result.device.length === 0
+            || typeof result.leaseId !== 'string'
+            || result.leaseId.length === 0
+            || result.url !== url) {
+            throw new ApiError(0, 'Simulator open URL returned an invalid acknowledgement', path, {
+                code: 'open_url_invalid_response',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'open-url',
+            });
+        }
+        return {
+            ok: true,
+            platform,
+            sessionId,
+            device: result.device,
+            leaseId: result.leaseId,
+            url,
+        };
+    }
+    catch (error) {
+        if (error instanceof ApiTransportError) {
+            throw new ApiError(0, 'Simulator open URL could not reach the run.cloud API', path, {
+                code: 'open_url_transport_error',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'open-url',
+            });
+        }
+        if (error instanceof ApiError) {
+            Object.assign(error, {
+                sessionId: error.sessionId ?? sessionId,
+                platform: error.platform ?? platform,
+                action: error.action ?? 'open-url',
+            });
+        }
+        throw error;
+    }
+}
 function registerSimulatorCommands(program, platform) {
     const label = platform === 'android' ? 'Android emulator' : 'iOS simulator';
     const article = platform === 'android' ? 'an' : 'an';
@@ -792,7 +844,7 @@ function registerSimulatorCommands(program, platform) {
         .requiredOption('--id <id>', 'session id')
         .option('--json', 'output JSON', false)
         .action((url, opts) => action(async () => {
-        print(await client().post(`/run-cloud/${platform}/${encodeURIComponent(opts.id)}/open-url`, { url }), opts);
+        print(await openSimulatorSessionUrl(platform, opts.id, url), opts);
     }, opts));
     addInteractionOptions(simulator
         .command('tap')
@@ -1036,6 +1088,7 @@ function jsonErrorEnvelope(error) {
                 retryable: error.retryable ?? (error.status === 408 || error.status === 429 || error.status >= 500),
                 httpStatus: error.status,
                 ...(error.details === undefined ? {} : { details: error.details }),
+                ...(error.suggestedAction ? { action: error.suggestedAction } : {}),
             },
         };
     }

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.1.115';
+export const CLI_VERSION = '0.1.116';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.1.115",
+  "version": "0.1.116",
   "description": "Create and control run.cloud remote mobile simulators and cloud sandboxes",
   "license": "Apache-2.0",
   "keywords": [