@palgroup/simstream 0.11.0 → 0.12.0

package/README.md

@@ -53,6 +53,10 @@ Completing an upload publishes the build and moves its app's `latest` channel to
 `runBuild({ channel: 'com.example.app:latest' })` always opens the newest one. `setChannel(id, 'beta')`
 names others.
 
+A session that is already open takes another build without being restarted:
+`installBuild(session.session, { build: other.id })` puts it on that one simulator only — unlike `pushBuild`, which
+goes to every session the key holds.
+
 ## When there is nothing free
 
 `startSession()` throws a `SimStreamError`. The `code` says what to do about it:

package/dist/index.d.ts

@@ -383,6 +383,17 @@ export declare class SimStream {
      * link follows, so a demo and a tester see the same build without anybody reissuing anything.
      */
     runBuild(ref: BuildRef, opts?: StartOptions): Promise<Session>;
+    /**
+     * Put a registry build on ONE session that is already open — by id to pin it, or by channel to follow it.
+     *
+     * ‼️ THIS IS NOT pushBuild. A push goes to every session the key holds, which is right for "a new build landed, show
+     * it to whoever is looking" and wrong for a key that serves several people: one of them choosing yesterday's build
+     * would replace the app under all the others. The install runs after the answer; watch it land with appStatus.
+     */
+    installBuild(session: string, ref: BuildRef, opts?: {
+        launch?: boolean;
+        mode?: SimMode;
+    }): Promise<void>;
     /**
      * A fresh link to a session that is already running.
      *

package/dist/index.js

@@ -218,6 +218,18 @@ class SimStream {
     async runBuild(ref, opts = {}) {
         return this.startSession({ ...opts, ...ref });
     }
+    /**
+     * Put a registry build on ONE session that is already open — by id to pin it, or by channel to follow it.
+     *
+     * ‼️ THIS IS NOT pushBuild. A push goes to every session the key holds, which is right for "a new build landed, show
+     * it to whoever is looking" and wrong for a key that serves several people: one of them choosing yesterday's build
+     * would replace the app under all the others. The install runs after the answer; watch it land with appStatus.
+     */
+    async installBuild(session, ref, opts = {}) {
+        const res = await this.request('POST', '/api/session/build', { session, ...ref, mode: opts.mode, launch: opts.launch });
+        if (res.status !== 200)
+            throw await this.errorFor(res);
+    }
     /**
      * A fresh link to a session that is already running.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palgroup/simstream",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Start and drive remote iOS simulator sessions.",
   "license": "Apache-2.0",
   "main": "dist/index.js",