runcloud 0.2.191 → 0.2.192

package/dist/commands/run-cloud.js

@@ -1033,6 +1033,52 @@ async function openSimulatorSessionUrl(platform, sessionId, url) {
         throw error;
     }
 }
+function parseCoordinate(value, name) {
+    const limit = name === 'latitude' ? 90 : 180;
+    const parsed = Number(value);
+    if (value.trim() === '' || !Number.isFinite(parsed) || Math.abs(parsed) > limit) {
+        throw new Error(`--${name} must be a number between -${limit} and ${limit}`);
+    }
+    return parsed;
+}
+async function setSimulatorSessionLocation(platform, sessionId, point) {
+    const path = `/run-cloud/${platform}/${encodeURIComponent(sessionId)}/location`;
+    try {
+        const response = (point ? await client().post(path, point) : await client().delete(path));
+        const result = typeof response === 'object' && response !== null && !Array.isArray(response)
+            ? response
+            : {};
+        if (result.ok !== true || result.platform !== platform || result.sessionId !== sessionId || result.cleared !== (point === null)) {
+            throw new ApiError(0, 'Simulator location returned an invalid acknowledgement', path, {
+                code: 'location_invalid_response',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'location',
+            });
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ApiTransportError) {
+            throw new ApiError(0, 'Simulator location could not reach the run.cloud API', path, {
+                code: 'location_transport_error',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'location',
+            });
+        }
+        if (error instanceof ApiError) {
+            Object.assign(error, {
+                sessionId: error.sessionId ?? sessionId,
+                platform: error.platform ?? platform,
+                action: error.action ?? 'location',
+            });
+        }
+        throw error;
+    }
+}
 function registerSimulatorCommands(program, platform) {
     const label = platform === 'android' ? 'Android emulator' : 'iOS simulator';
     const article = platform === 'android' ? 'an' : 'an';
@@ -1133,6 +1179,33 @@ function registerSimulatorCommands(program, platform) {
         .action((url, opts) => action(async () => {
         print(await openSimulatorSessionUrl(platform, opts.id, url), opts);
     }, opts));
+    const location = simulator
+        .command('location')
+        .description(`Set or clear the simulated GPS location of ${article} ${label} session`);
+    location
+        .command('set')
+        .description('Set the simulated location (WGS84 degrees)')
+        .argument('<id>', 'session id')
+        .requiredOption('--latitude <degrees>', 'latitude from -90 to 90')
+        .requiredOption('--longitude <degrees>', 'longitude from -180 to 180')
+        .option('--json', 'output JSON', false)
+        .action((id, opts) => action(async () => {
+        const point = {
+            latitude: parseCoordinate(opts.latitude, 'latitude'),
+            longitude: parseCoordinate(opts.longitude, 'longitude'),
+        };
+        print(await setSimulatorSessionLocation(platform, id, point), opts);
+    }, opts));
+    location
+        .command('clear')
+        .description(platform === 'android'
+        ? 'Return to the emulator default location'
+        : 'Remove the simulated location')
+        .argument('<id>', 'session id')
+        .option('--json', 'output JSON', false)
+        .action((id, opts) => action(async () => {
+        print(await setSimulatorSessionLocation(platform, id, null), opts);
+    }, opts));
     addInteractionOptions(simulator
         .command('tap')
         .description(`Tap normalized display coordinates in ${article} ${label} session`)

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.191';
+export const CLI_VERSION = '0.2.192';

package/package.json

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

package/skills/run-cloud-ios-simulator/SKILL.md

@@ -40,7 +40,7 @@ runcloud ios get "$SESSION_ID" --json
 ```
 
 Replace `ios` with `android` for an Android artifact. The shared lifecycle is
-`create`, `list`, `get`, `open-url`, `logs`, and `delete`. Use `--json` whenever
+`create`, `list`, `get`, `open-url`, `location set|clear`, `logs`, and `delete`. Use `--json` whenever
 another program consumes output, and inspect `runcloud ios|android --help` for
 create and log options.