runcloud 0.2.197 → 0.2.198

package/dist/commands/run-cloud.js

@@ -1,4 +1,5 @@
 import { InvalidArgumentError, Option } from 'commander';
+import { DEFAULT_SIMULATOR_INTERACTION_TIMEOUT_MS as DEFAULT_INTERACTION_TIMEOUT_MS, SIMULATOR_BUTTONS, SIMULATOR_INTERACTION_LIMITS as LIMITS, SIMULATOR_KEY_MODIFIERS, SIMULATOR_KEYS, SIMULATOR_ORIENTATIONS, SIMULATOR_RENDER_DEBUG_OPTIONS, } from '@run-cloud/sdk';
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { basename, dirname, extname, join, resolve } from 'node:path';
 import { homedir } from 'node:os';
@@ -23,31 +24,6 @@ export function runCloudIosOptions(opts) {
         },
     };
 }
-export const SIMULATOR_KEYS = [
-    'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
-    'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
-    '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
-    'enter', 'escape', 'backspace', 'tab', 'space', 'minus', 'equal',
-    'bracketLeft', 'bracketRight', 'backslash', 'semicolon', 'quote', 'backquote',
-    'comma', 'period', 'slash', 'capsLock',
-    'f1', 'f2', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9', 'f10', 'f11', 'f12',
-    'printScreen', 'scrollLock', 'pause', 'insert', 'home', 'pageUp', 'delete', 'end',
-    'pageDown', 'arrowRight', 'arrowLeft', 'arrowDown', 'arrowUp', 'numLock',
-    'numpadDivide', 'numpadMultiply', 'numpadSubtract', 'numpadAdd', 'numpadEnter',
-    'numpad0', 'numpad1', 'numpad2', 'numpad3', 'numpad4', 'numpad5', 'numpad6',
-    'numpad7', 'numpad8', 'numpad9', 'numpadDecimal',
-];
-export const SIMULATOR_BUTTONS = [
-    'home', 'back', 'appSwitcher', 'recents', 'power', 'volumeUp', 'volumeDown',
-    'menu', 'sideButton', 'actionButton', 'digitalCrown',
-];
-export const SIMULATOR_RENDER_DEBUG_OPTIONS = [
-    'colorBlendedLayers',
-    'colorCopiedImages',
-    'colorMisalignedImages',
-    'colorOffscreenRendered',
-    'slowAnimations',
-];
 export const SIMULATOR_INTERACTION_ERROR_CODES = [
     'invalid_interaction',
     'active_session_not_found',
@@ -118,7 +94,6 @@ function normalizedAccessibilityErrorCode(value) {
         ? value
         : 'accessibility_unavailable';
 }
-const DEFAULT_INTERACTION_TIMEOUT_MS = 15_000;
 const DEFAULT_ACCESSIBILITY_TIMEOUT_MS = 20_000;
 const INTERACTION_RESPONSE_MARGIN_MS = 250;
 const REQUEST_ID_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/;
@@ -243,8 +218,8 @@ function finiteInRange(raw, name, min, max) {
 }
 function normalizedPoint(x, y, name) {
     return {
-        x: finiteInRange(x, `${name} x`, 0, 1),
-        y: finiteInRange(y, `${name} y`, 0, 1),
+        x: finiteInRange(x, `${name} x`, LIMITS.coordinate.min, LIMITS.coordinate.max),
+        y: finiteInRange(y, `${name} y`, LIMITS.coordinate.min, LIMITS.coordinate.max),
     };
 }
 function simulatorKey(raw) {
@@ -258,10 +233,9 @@ function simulatorButton(raw) {
     throw new Error(`Unknown simulator button: ${raw}. Choose one of: ${SIMULATOR_BUTTONS.join(', ')}.`);
 }
 function simulatorOrientation(raw) {
-    if (raw === 'portrait' || raw === 'portrait_upside_down' || raw === 'landscape_left' || raw === 'landscape_right') {
+    if (SIMULATOR_ORIENTATIONS.includes(raw))
         return raw;
-    }
-    throw new Error(`Unknown orientation: ${raw}. Choose portrait, portrait_upside_down, landscape_left, or landscape_right.`);
+    throw new Error(`Unknown orientation: ${raw}. Choose one of: ${SIMULATOR_ORIENTATIONS.join(', ')}.`);
 }
 function renderDebugOption(raw) {
     if (SIMULATOR_RENDER_DEBUG_OPTIONS.includes(raw)) {
@@ -290,12 +264,12 @@ function assertInteraction(interaction, timeoutMs) {
             return;
         case 'swipe':
             if (interaction.durationMs !== undefined) {
-                integerInRange(String(interaction.durationMs), '--duration', 50, 30_000);
+                integerInRange(String(interaction.durationMs), '--duration', LIMITS.swipeDurationMs.min, LIMITS.swipeDurationMs.max);
             }
             return;
         case 'gesture': {
-            if (interaction.steps.length < 2 || interaction.steps.length > 1_000) {
-                throw new Error('--steps must contain from 2 to 1000 gesture steps');
+            if (interaction.steps.length < LIMITS.gestureSteps.min || interaction.steps.length > LIMITS.gestureSteps.max) {
+                throw new Error(`--steps must contain from ${LIMITS.gestureSteps.min} to ${LIMITS.gestureSteps.max} gesture steps`);
             }
             let pointCount;
             let totalDelayMs = 0;
@@ -306,7 +280,7 @@ function assertInteraction(interaction, timeoutMs) {
                 if ((index === interaction.steps.length - 1) !== (step.phase === 'end')) {
                     throw new Error('Gesture steps must end with end and contain no earlier end phase');
                 }
-                if (step.points.length !== 1 && step.points.length !== 2) {
+                if (step.points.length < LIMITS.gesturePoints.min || step.points.length > LIMITS.gesturePoints.max) {
                     throw new Error('Each gesture step must contain one or two points');
                 }
                 if (pointCount === undefined)
@@ -315,14 +289,14 @@ function assertInteraction(interaction, timeoutMs) {
                     throw new Error('Every gesture step must use the same number of points');
                 }
                 for (const point of step.points) {
-                    finiteInRange(String(point.x), 'gesture x', 0, 1);
-                    finiteInRange(String(point.y), 'gesture y', 0, 1);
+                    finiteInRange(String(point.x), 'gesture x', LIMITS.coordinate.min, LIMITS.coordinate.max);
+                    finiteInRange(String(point.y), 'gesture y', LIMITS.coordinate.min, LIMITS.coordinate.max);
                 }
                 if (step.delayMs !== undefined) {
                     if (index === interaction.steps.length - 1 && step.delayMs !== 0) {
                         throw new Error('Final gesture end step delayMs must be 0 because there is no next step');
                     }
-                    totalDelayMs += integerInRange(String(step.delayMs), 'gesture delayMs', 0, 5_000);
+                    totalDelayMs += integerInRange(String(step.delayMs), 'gesture delayMs', LIMITS.gestureDelayMs.min, LIMITS.gestureDelayMs.max);
                 }
             }
             if (totalDelayMs > timeoutMs)
@@ -332,12 +306,12 @@ function assertInteraction(interaction, timeoutMs) {
         case 'getClipboard':
             return;
         case 'setClipboard':
-            if (interaction.text.length > 100_000)
-                throw new Error('clipboard text must contain at most 100000 UTF-16 code units');
+            if (interaction.text.length > LIMITS.clipboardTextLength.max)
+                throw new Error(`clipboard text must contain at most ${LIMITS.clipboardTextLength.max} UTF-16 code units`);
             return;
         case 'typeText':
-            if (interaction.text.length < 1 || interaction.text.length > 10_000) {
-                throw new Error('text must contain from 1 to 10000 characters');
+            if (interaction.text.length < LIMITS.typeTextLength.min || interaction.text.length > LIMITS.typeTextLength.max) {
+                throw new Error(`text must contain from ${LIMITS.typeTextLength.min} to ${LIMITS.typeTextLength.max} characters`);
             }
             if (!isUsAsciiText(interaction.text)) {
                 throw new Error('text must contain only US ASCII characters, tabs, and line feeds');
@@ -346,7 +320,7 @@ function assertInteraction(interaction, timeoutMs) {
         case 'pressKey':
         case 'pressButton':
             if (interaction.durationMs !== undefined) {
-                integerInRange(String(interaction.durationMs), '--duration', 20, 30_000);
+                integerInRange(String(interaction.durationMs), '--duration', LIMITS.pressDurationMs.min, LIMITS.pressDurationMs.max);
             }
             return;
         case 'scroll':
@@ -395,7 +369,7 @@ export function parseSimulatorGestureSteps(raw, timeoutMs = DEFAULT_INTERACTION_
             : [points[0], points[1]];
         const delayMs = record.delayMs === undefined
             ? undefined
-            : integerInRange(String(record.delayMs), `gesture step ${index} delayMs`, 0, 5_000);
+            : integerInRange(String(record.delayMs), `gesture step ${index} delayMs`, LIMITS.gestureDelayMs.min, LIMITS.gestureDelayMs.max);
         return {
             phase: record.phase,
             points: tuple,
@@ -406,7 +380,7 @@ export function parseSimulatorGestureSteps(raw, timeoutMs = DEFAULT_INTERACTION_
     return steps;
 }
 function interactionTimeout(opts) {
-    return integerInRange(opts.timeout, '--timeout', 100, 60_000, DEFAULT_INTERACTION_TIMEOUT_MS);
+    return integerInRange(opts.timeout, '--timeout', LIMITS.timeoutMs.min, LIMITS.timeoutMs.max, DEFAULT_INTERACTION_TIMEOUT_MS);
 }
 function interactionRequestId(opts) {
     const requestId = opts.requestId?.trim() || `cli_${randomUUID()}`;
@@ -463,7 +437,7 @@ async function withInteractionCancellation(timeoutMs, requestId, actionName, ses
 }
 function addInteractionOptions(command) {
     return command
-        .option('--timeout <milliseconds>', 'acknowledgement timeout in milliseconds (100-60000)', String(DEFAULT_INTERACTION_TIMEOUT_MS))
+        .option('--timeout <milliseconds>', `acknowledgement timeout in milliseconds (${LIMITS.timeoutMs.min}-${LIMITS.timeoutMs.max})`, String(DEFAULT_INTERACTION_TIMEOUT_MS))
         .option('--request-id <id>', 'caller-supplied correlation id')
         .option('--json', 'output a stable JSON result or error envelope', false);
 }
@@ -1220,13 +1194,13 @@ function registerSimulatorCommands(program, platform) {
         .argument('<from-y>', 'start y from 0 to 1')
         .argument('<to-x>', 'end x from 0 to 1')
         .argument('<to-y>', 'end y from 0 to 1')
-        .option('--duration <milliseconds>', 'swipe duration in milliseconds (50-30000)')).action((id, fromX, fromY, toX, toY, opts) => action(() => runSimulatorInteraction(platform, id, {
+        .option('--duration <milliseconds>', `swipe duration in milliseconds (${LIMITS.swipeDurationMs.min}-${LIMITS.swipeDurationMs.max})`)).action((id, fromX, fromY, toX, toY, opts) => action(() => runSimulatorInteraction(platform, id, {
         action: 'swipe',
         from: normalizedPoint(fromX, fromY, 'swipe start'),
         to: normalizedPoint(toX, toY, 'swipe end'),
         ...(opts.duration === undefined
             ? {}
-            : { durationMs: integerInRange(opts.duration, '--duration', 50, 30_000) }),
+            : { durationMs: integerInRange(opts.duration, '--duration', LIMITS.swipeDurationMs.min, LIMITS.swipeDurationMs.max) }),
     }, opts), opts));
     addInteractionOptions(simulator
         .command('gesture')
@@ -1247,27 +1221,26 @@ function registerSimulatorCommands(program, platform) {
         .command('type-text')
         .description(`Type US ASCII text into ${article} ${label} session`)
         .argument('<id>', 'session id')
-        .argument('<text>', '1-10000 US ASCII characters; quote text containing spaces')).action((id, text, opts) => action(() => runSimulatorInteraction(platform, id, { action: 'typeText', text }, opts), opts));
+        .argument('<text>', `${LIMITS.typeTextLength.min}-${LIMITS.typeTextLength.max} US ASCII characters; quote text containing spaces`)).action((id, text, opts) => action(() => runSimulatorInteraction(platform, id, { action: 'typeText', text }, opts), opts));
     addInteractionOptions(simulator
         .command('press-key')
         .description(`Press a semantic keyboard key in ${article} ${label} session`)
         .argument('<id>', 'session id')
         .argument('<key>', 'semantic key, for example a, enter, arrowUp, or f1')
-        .option('--duration <milliseconds>', 'key hold duration in milliseconds (20-30000)')
+        .option('--duration <milliseconds>', `key hold duration in milliseconds (${LIMITS.pressDurationMs.min}-${LIMITS.pressDurationMs.max})`)
         .option('--shift', 'hold the left Shift modifier', false)
         .option('--control', 'hold the left Control modifier', false)
         .option('--alt', 'hold the left Alt modifier', false)
         .option('--meta', 'hold the left Meta/Command modifier', false)
         .addHelpText('after', `\nSupported keys:\n  ${SIMULATOR_KEYS.join(', ')}\n`)).action((id, rawKey, opts) => action(() => {
-        const modifiers = ['shift', 'control', 'alt', 'meta']
-            .filter((modifier) => opts[modifier]);
+        const modifiers = SIMULATOR_KEY_MODIFIERS.filter((modifier) => opts[modifier]);
         return runSimulatorInteraction(platform, id, {
             action: 'pressKey',
             key: simulatorKey(rawKey),
             ...(modifiers.length ? { modifiers } : {}),
             ...(opts.duration === undefined
                 ? {}
-                : { durationMs: integerInRange(opts.duration, '--duration', 20, 30_000) }),
+                : { durationMs: integerInRange(opts.duration, '--duration', LIMITS.pressDurationMs.min, LIMITS.pressDurationMs.max) }),
         }, opts);
     }, opts));
     addInteractionOptions(simulator
@@ -1275,12 +1248,12 @@ function registerSimulatorCommands(program, platform) {
         .description(`Press a simulator hardware or system button in ${article} ${label} session`)
         .argument('<id>', 'session id')
         .argument('<button>', `one of: ${SIMULATOR_BUTTONS.join(', ')}`)
-        .option('--duration <milliseconds>', 'button hold duration in milliseconds (20-30000)')).action((id, rawButton, opts) => action(() => runSimulatorInteraction(platform, id, {
+        .option('--duration <milliseconds>', `button hold duration in milliseconds (${LIMITS.pressDurationMs.min}-${LIMITS.pressDurationMs.max})`)).action((id, rawButton, opts) => action(() => runSimulatorInteraction(platform, id, {
         action: 'pressButton',
         button: simulatorButton(rawButton),
         ...(opts.duration === undefined
             ? {}
-            : { durationMs: integerInRange(opts.duration, '--duration', 20, 30_000) }),
+            : { durationMs: integerInRange(opts.duration, '--duration', LIMITS.pressDurationMs.min, LIMITS.pressDurationMs.max) }),
     }, opts), opts));
     addInteractionOptions(simulator
         .command('rotate')
@@ -1298,8 +1271,8 @@ function registerSimulatorCommands(program, platform) {
         .command('scroll')
         .description(`Send normalized scroll deltas to ${article} ${label} session`)
         .argument('<id>', 'session id')
-        .argument('<delta-x>', 'horizontal delta from -1 to 1')
-        .argument('<delta-y>', 'vertical delta from -1 to 1')
+        .argument('<delta-x>', `horizontal delta from ${LIMITS.scrollDelta.min} to ${LIMITS.scrollDelta.max}`)
+        .argument('<delta-y>', `vertical delta from ${LIMITS.scrollDelta.min} to ${LIMITS.scrollDelta.max}`)
         .option('--x <coordinate>', 'normalized anchor x; requires --y')
         .option('--y <coordinate>', 'normalized anchor y; requires --x')).action((id, deltaX, deltaY, opts) => action(() => {
         if ((opts.x === undefined) !== (opts.y === undefined))
@@ -1309,8 +1282,8 @@ function registerSimulatorCommands(program, platform) {
             : undefined;
         return runSimulatorInteraction(platform, id, {
             action: 'scroll',
-            deltaX: finiteInRange(deltaX, 'delta-x', -1, 1),
-            deltaY: finiteInRange(deltaY, 'delta-y', -1, 1),
+            deltaX: finiteInRange(deltaX, 'delta-x', LIMITS.scrollDelta.min, LIMITS.scrollDelta.max),
+            deltaY: finiteInRange(deltaY, 'delta-y', LIMITS.scrollDelta.min, LIMITS.scrollDelta.max),
             ...(anchor ?? {}),
         }, opts);
     }, opts));
@@ -1326,9 +1299,9 @@ function registerSimulatorCommands(program, platform) {
         .command('rotate-digital-crown')
         .description(`Request Digital Crown input for ${article} ${label} session (unsupported on current mobile sessions)`)
         .argument('<id>', 'session id')
-        .argument('<delta>', 'nonzero crown delta from -10000 to 10000')).action((id, delta, opts) => action(() => runSimulatorInteraction(platform, id, {
+        .argument('<delta>', `nonzero crown delta from ${LIMITS.digitalCrownDelta.min} to ${LIMITS.digitalCrownDelta.max}`)).action((id, delta, opts) => action(() => runSimulatorInteraction(platform, id, {
         action: 'rotateDigitalCrown',
-        delta: finiteInRange(delta, 'delta', -10_000, 10_000),
+        delta: finiteInRange(delta, 'delta', LIMITS.digitalCrownDelta.min, LIMITS.digitalCrownDelta.max),
     }, opts), opts));
     addInteractionOptions(simulator
         .command('set-render-debug')

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.197';
+export const CLI_VERSION = '0.2.198';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.2.197",
+  "version": "0.2.198",
   "description": "Create and control run.cloud remote mobile simulators and cloud sandboxes",
   "license": "Apache-2.0",
   "keywords": [
@@ -44,6 +44,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@run-cloud/sdk": "0.48.0",
     "commander": "^12.1.0",
     "ignore": "^7.0.5",
     "tar": "^7.4.3",