runcloud 0.1.114 → 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/boxAccess.js

@@ -1,7 +1,7 @@
 import { spawn, spawnSync } from 'node:child_process';
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
 import { homedir, hostname as localHostname } from 'node:os';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import WebSocket, { createWebSocketStream } from 'ws';
 import { ApiClient, friendlyApiError } from '../api.js';
 import { requireCredentials } from '../config.js';
@@ -85,6 +85,22 @@ function sshHome() {
 function keyPath() {
     return join(sshHome(), 'id_ed25519');
 }
+function sshConfigPath() {
+    return join(homedir(), '.ssh', 'config');
+}
+export function sshCommandArgs(configPath, alias, command = []) {
+    return ['-F', configPath, alias, ...command];
+}
+export function scpCommandArgs(configPath, recursive, source, destination) {
+    return [
+        '-F',
+        configPath,
+        ...(recursive ? ['-r'] : []),
+        '--',
+        source,
+        destination,
+    ];
+}
 function exec(command, args) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, { stdio: 'inherit' });
@@ -119,8 +135,8 @@ function sshAlias(box) {
     return `runcloud-${box.name}`;
 }
 function writeSshConfig(box, privateKey) {
-    const sshDir = join(homedir(), '.ssh');
-    const configPath = join(sshDir, 'config');
+    const configPath = sshConfigPath();
+    const sshDir = dirname(configPath);
     mkdirSync(sshDir, { recursive: true, mode: 0o700 });
     const current = existsSync(configPath) ? readFileSync(configPath, 'utf8') : '';
     const start = `# BEGIN RUN CLOUD ${box.id}`;
@@ -147,7 +163,7 @@ async function setupSsh(reference) {
     const client = api();
     const box = await resolveBox(client, reference);
     const privateKey = await ensureSshKey(client, box);
-    return { box, alias: writeSshConfig(box, privateKey) };
+    return { box, alias: writeSshConfig(box, privateKey), configPath: sshConfigPath() };
 }
 function output(value, opts) {
     if (opts.json)
@@ -221,7 +237,7 @@ export function registerAccessCommands(parent, opts = {}) {
         note('ssh');
         return action(async () => {
             const configured = await setupSsh(reference);
-            const code = await exec('ssh', [configured.alias, ...command]);
+            const code = await exec('ssh', sshCommandArgs(configured.configPath, configured.alias, command));
             if (code !== 0)
                 process.exitCode = code;
         });
@@ -252,12 +268,7 @@ export function registerAccessCommands(parent, opts = {}) {
             }
             const configured = await setupSsh(reference);
             const remote = (path) => path.startsWith(':') ? `${configured.alias}:${path.slice(1)}` : path;
-            const args = [
-                ...(cmdOpts.recursive ? ['-r'] : []),
-                '--',
-                remote(source),
-                remote(destination),
-            ];
+            const args = scpCommandArgs(configured.configPath, cmdOpts.recursive === true, remote(source), remote(destination));
             const code = await exec('scp', args);
             if (code !== 0)
                 process.exitCode = code;

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.114';
+export const CLI_VERSION = '0.1.116';

package/package.json

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