@limrun/api 0.20.2 → 0.21.0

package/src/internal/utils/query.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { LimrunError } from '../../core/error';
+
+/**
+ * Basic re-implementation of `qs.stringify` for primitive types.
+ */
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return Object.entries(query)
+    .filter(([_, value]) => typeof value !== 'undefined')
+    .map(([key, value]) => {
+      if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+      }
+      if (value === null) {
+        return `${encodeURIComponent(key)}=`;
+      }
+      throw new LimrunError(
+        `Cannot stringify type ${typeof value}; Expected string, number, boolean, or null. If you need to pass nested query parameters, you can manually encode them, e.g. { query: { 'foo[key1]': value1, 'foo[key2]': value2 } }, and please open a GitHub issue requesting better support for your use case.`,
+      );
+    })
+    .join('&');
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/ios-client.ts

@@ -129,10 +129,9 @@ export type AppInstallationOptions = {
    * Launch mode after installation:
    * - 'ForegroundIfRunning': Bring to foreground if already running, otherwise launch
    * - 'RelaunchIfRunning': Kill and relaunch if already running
-   * - 'FailIfRunning': Fail if the app is already running
    * - undefined: Don't launch after installation
    */
-  launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning' | 'FailIfRunning';
+  launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning';
 };
 
 /**
@@ -222,8 +221,18 @@ export type InstanceClient = {
   /**
    * Launch an installed app by bundle identifier
    * @param bundleId Bundle identifier of the app to launch
+   * @param mode Optional launch mode:
+   *   - 'ForegroundIfRunning' (default): bring to foreground if already running
+   *   - 'RelaunchIfRunning': terminate and relaunch if already running
    */
-  launchApp: (bundleId: string) => Promise<void>;
+  launchApp: (bundleId: string, mode?: 'ForegroundIfRunning' | 'RelaunchIfRunning') => Promise<void>;
+
+  /**
+   * Terminate a running app by bundle identifier.
+   * Succeeds silently if the app is not currently running.
+   * @param bundleId Bundle identifier of the app to terminate
+   */
+  terminateApp: (bundleId: string) => Promise<void>;
 
   /**
    * Fetch the last N lines of app logs (combined stdout/stderr)
@@ -294,7 +303,7 @@ export type InstanceClient = {
     opts?: {
       install?: boolean;
       maxPatchBytes?: number;
-      launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning' | 'FailIfRunning';
+      launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning';
       watch?: boolean;
     },
   ) => Promise<SyncFolderResult>;
@@ -1004,6 +1013,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       pressKeyResult: () => undefined,
       toggleKeyboardResult: () => undefined,
       launchAppResult: () => undefined,
+      terminateAppResult: () => undefined,
       appLogTailResult: (msg) => msg.logs ?? '',
       listAppsResult: (msg) => JSON.parse(msg.apps || '[]') as InstalledApp[],
       listOpenFilesResult: (msg) => msg.files || [],
@@ -1181,6 +1191,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
             pressKey,
             toggleKeyboard,
             launchApp,
+            terminateApp,
             appLogTail,
             streamAppLog,
             streamSyslog,
@@ -1270,8 +1281,15 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       return sendRequest<void>('toggleKeyboard');
     };
 
-    const launchApp = (bundleId: string): Promise<void> => {
-      return sendRequest<void>('launchApp', { bundleId });
+    const launchApp = (
+      bundleId: string,
+      mode?: 'ForegroundIfRunning' | 'RelaunchIfRunning',
+    ): Promise<void> => {
+      return sendRequest<void>('launchApp', { bundleId, mode });
+    };
+
+    const terminateApp = (bundleId: string): Promise<void> => {
+      return sendRequest<void>('terminateApp', { bundleId });
     };
 
     const appLogTail = (bundleId: string, lines: number): Promise<string> => {
@@ -1328,7 +1346,7 @@ export async function createInstanceClient(options: InstanceClientOptions): Prom
       opts?: {
         install?: boolean;
         maxPatchBytes?: number;
-        launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning' | 'FailIfRunning';
+        launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning';
         watch?: boolean;
       },
     ): Promise<SyncFolderResult> => {

package/src/resources/android-instances.ts

@@ -101,6 +101,8 @@ export namespace AndroidInstance {
 
     errorMessage?: string;
 
+    mcpUrl?: string;
+
     sandbox?: Status.Sandbox;
 
     targetHttpPortUrlPrefix?: string;

package/src/resources/ios-instances.ts

@@ -198,7 +198,7 @@ export namespace IosInstanceCreateParams {
        * Launch mode specifies how to launch the app after installation. If not given,
        * the app won't be launched.
        */
-      launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning' | 'FailIfRunning';
+      launchMode?: 'ForegroundIfRunning' | 'RelaunchIfRunning';
 
       url?: string;
     }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.20.2'; // x-release-please-version
+export const VERSION = '0.21.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.20.2";
+export declare const VERSION = "0.21.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.20.2";
+export declare const VERSION = "0.21.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.20.2'; // x-release-please-version
+exports.VERSION = '0.21.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.20.2'; // x-release-please-version
+export const VERSION = '0.21.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map