@molecule/api-code-sandbox-flyio 1.3.9 → 1.4.0

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAaV,eAAe,EAGhB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,YAAY,EAKb,MAAM,UAAU,CAAA;AA8BjB,OAAO,KAAK,EAEV,wBAAwB,EAEzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAEhG,OAAO,KAAK,EAIV,WAAW,EAUZ,MAAM,YAAY,CAAA;AAyBnB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E;AAgyID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GACzB,eAAe,GAAG,wBAAwB,CAE5C"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAaV,eAAe,EAGhB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EACL,YAAY,EAKb,MAAM,UAAU,CAAA;AA8BjB,OAAO,KAAK,EAEV,wBAAwB,EAEzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAEhG,OAAO,KAAK,EAIV,WAAW,EAUZ,MAAM,YAAY,CAAA;AAyBnB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E;AA4zID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GACzB,eAAe,GAAG,wBAAwB,CAE5C"}

package/dist/provider.js

@@ -3336,6 +3336,19 @@ class FlyioSandboxProvider {
                 `${totalSeconds}s (last observed state: ${lastState ?? 'unknown'}).`,
         }), { cause: lastError });
     }
+    /**
+     * Activate an already populated Machine with one full-config update: startup command and idle
+     * policy change together. The former command keeps the workload stopped, so the update's reboot
+     * is the workload's first boot. Fly preserves parked Machines with skip_launch; startMachine
+     * explicitly wakes those and waits, and is idempotent after a running Machine's update.
+     */
+    async activate(id, options) {
+        if (!options.command.length)
+            throw new Error('A sandbox activation needs a startup command');
+        const { app, machineId } = parseSandboxId(id);
+        await this.applyIdleAction(app, machineId, options.idleAction, options.command);
+        await this.startMachine(app, machineId);
+    }
     /**
      * Applies an idle policy to a running Machine's public service, in place.
      *
@@ -3356,10 +3369,11 @@ class FlyioSandboxProvider {
      * @param app - The Fly app name.
      * @param machineId - The Fly Machine id.
      * @param action - The idle action to apply to every service.
+     * @param command - An activation command installed in the SAME update as the policy.
      * @throws {Error} When the Machine or its config cannot be read, the update is
      *   rejected, or a rebooted Machine does not come back to `started`.
      */
-    async applyIdleAction(app, machineId, action) {
+    async applyIdleAction(app, machineId, action, command) {
         const machine = await this.client.request(`/apps/${app}/machines/${machineId}`, {
             nullOn: [404],
         });
@@ -3370,14 +3384,21 @@ class FlyioSandboxProvider {
             }));
         }
         const services = machine.config.services;
-        if (!services?.length)
-            return;
-        if (services.every((service) => (service.autostop ?? 'off') === action))
-            return;
+        const samePolicy = !services?.length || services.every((service) => (service.autostop ?? 'off') === action);
+        const sameCommand = !command || JSON.stringify(machine.config.init?.exec) === JSON.stringify(command);
+        if (samePolicy && sameCommand)
+            return mapMachineState(machine.state ?? 'created');
         const config = {
             ...machine.config,
-            services: services.map((service) => ({ ...service, autostop: action })),
+            ...(services
+                ? { services: services.map((service) => ({ ...service, autostop: action })) }
+                : {}),
         };
+        if (command) {
+            config.init = { ...machine.config.init, exec: [...command] };
+            delete config.init.entrypoint;
+            delete config.init.cmd;
+        }
         // A running Machine reboots to apply the config, so wait for it; a parked
         // one is updated without being started (there is nothing to wait for).
         const wasRunning = machine.state === 'started' || machine.state === 'starting';
@@ -3394,6 +3415,7 @@ class FlyioSandboxProvider {
         });
         if (wasRunning)
             await this.waitForStarted(app, machineId);
+        return wasRunning ? 'running' : mapMachineState(machine.state ?? 'created');
     }
     /**
      * Builds the `Sandbox` facade for one Machine.
@@ -3442,11 +3464,10 @@ class FlyioSandboxProvider {
             /**
              * Applies an idle policy to this Machine's public service (see
              * {@link FlyioSandboxProvider.applyIdleAction} for the endpoint and the
-             * reboot it costs). Resolves with the Machine running again.
+             * reboot it costs). A parked Machine stays parked; a rebooted Machine is running again.
              */
             async setIdleAction(action) {
-                await provider.applyIdleAction(app, machineId, action);
-                this.status = 'running';
+                this.status = await provider.applyIdleAction(app, machineId, action);
             },
             async exec(command, opts) {
                 return await execCommand(exec, command, opts, WORKSPACE_PATH);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-code-sandbox-flyio",
-  "version": "1.3.9",
+  "version": "1.4.0",
   "description": "Fly.io Machines (Firecracker microVM) code sandbox provider",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@molecule/api-bond": "1.0.4",
-    "@molecule/api-code-sandbox": "1.6.1",
+    "@molecule/api-code-sandbox": "1.7.0",
     "@types/node": "26.6.5",
     "typescript": "6.0.3",
     "vitest": "4.1.12"