@supermachine/core 0.7.11 → 0.7.14

package/index.d.ts

@@ -191,6 +191,17 @@ export interface BuildOptions {
   source?: string
   /** File or directory path for non-registry sources. See `source`. */
   sourcePath?: string
+  /**
+   * Target platform, in Docker `--platform` form. Supported:
+   *   * `"linux/arm64"` (default) — native arm64 path.
+   *   * `"linux/amd64"` — pull the amd64 variant of multi-arch
+   *     images, auto-mount Apple's Rosetta runtime share at
+   *     `/run/rosetta`, register binfmt for amd64 ELFs. Requires
+   *     `softwareupdate --install-rosetta` on the host.
+   * See `docs/design/chrome-amd64-gap-2026-05-17.md` for the
+   * Chrome / Playwright headful demo this enables.
+   */
+  platform?: string
   /**
    * Stable tag for the warmup callback (see the `warmup`
    * parameter on [`Image.build`]). Folded into the snapshot's
@@ -443,7 +454,18 @@ export declare class Pool {
    * / ~22 ms spawn-from-disk.
    */
    acquire(): Promise<Vm>
-  /** Best-effort pool shutdown. Pool also shuts down on GC. */
+  /**
+   * Explicit pool shutdown. Wakes any caller blocked on
+   * `acquire()` (they receive a "pool is shutting down" error
+   * instead of hanging), drains idle + dirty workers, and
+   * stops housekeeping threads. Idempotent.
+   *
+   * The pool ALSO shuts down on GC, but JS GC is unpredictable
+   * and an integrator wiring this into a process-shutdown hook
+   * wants a synchronous "pool is gone now" guarantee. Call
+   * this in your shutdown path; the await resolves when the
+   * idle workers have been QUITed (or SIGKILLed on timeout).
+   */
    shutdown(): Promise<void>
   /**
    * Snapshot of the pool's current state. Cheap (~1 µs, just a
@@ -697,12 +719,14 @@ export declare class Vm {
    * Pass `hostPort = 0` to let the OS pick a free port; read
    * the actual bound port back via `forwarder.localAddr`.
    *
-   * Note: `guestPort` is currently advisory. The Rust crate's
-   * `expose_tcp` ignores it and routes all forwarded
-   * connections into whatever the in-guest TSI mux accepts;
-   * per-guest-port routing is on the roadmap. Pass the port
-   * you semantically want — it's plumbed through so the
-   * signature stays stable when the routing fix lands.
+   * `guestPort` pins the host-port → guest-port mapping. The
+   * forwarder writes a small per-connection routing header
+   * (`SMUX-PORT-V1\0\0\0\0` + u32 BE port) over the unix mux,
+   * and the worker routes to the matching AF_INET TSI listener
+   * instead of falling back to "first listener" — important
+   * when the guest binds multiple AF_INET ports (e.g. Chrome
+   * DevTools + helper sockets). Pass `guestPort = 0` to opt out
+   * of the header and keep the legacy first-listener behavior.
    */
    exposeTcp(hostPort: number, guestPort: number): Promise<TcpForwarder>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermachine/core",
-  "version": "0.7.11",
+  "version": "0.7.14",
   "description": "Run any OCI/Docker image as a hardware-isolated microVM. Node/Bun/Deno binding for the supermachine Rust crate.",
   "license": "Apache-2.0",
   "main": "index.js",
@@ -22,7 +22,7 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@supermachine/core-darwin-arm64": "0.7.11"
+    "@supermachine/core-darwin-arm64": "0.7.14"
   },
   "scripts": {
     "build:rust": "TYPE_DEF_TMP_PATH=$(pwd)/scripts/.napi_type_defs.tmp cargo build --release -p supermachine-napi && cargo build --release --bin supermachine-worker -p supermachine",