@supermachine/core 0.4.29 → 0.5.0

package/index.d.ts

@@ -27,6 +27,20 @@ export interface ExtraFileSpec {
   guestPath: string
 }
 
+/**
+ * One virtio-fs DAX mount: a host directory exposed to the guest
+ * at a given `guestTag` (max 35 UTF-8 bytes). The guest mounts it
+ * via `mount -t virtiofs <guestTag> <target>`. Reads go through
+ * DAX (zero-copy, host-page-cache-shared across VMs that mount the
+ * same path) — validated by spike 22.
+ */
+export interface MountSpec {
+  /** Host directory to expose. Must exist + be a directory. */
+  hostPath: string
+  /** virtiofs tag the guest mounts by. Max 35 bytes. */
+  guestTag: string
+}
+
 /**
  * Options for [`Image.build`]. Mirrors `OciImageBuilder` in the
  * Rust crate. All fields optional except `ref` (the OCI image
@@ -84,6 +98,37 @@ export interface BuildOptions {
    * `OciImageBuilder::with_extra_file`.
    */
   extraFiles?: Array<ExtraFileSpec>
+  /**
+   * virtio-fs DAX mounts. Each entry attaches a host directory
+   * to the guest, served zero-copy via FUSE-over-virtio with DAX.
+   * Folded into the bake's input hash so changing `hostPath`
+   * re-bakes.
+   */
+  mounts?: Array<MountSpec>
+  /**
+   * Override where to fetch the image bytes. Default behavior
+   * (when omitted) treats `ref` as a registry reference and pulls
+   * from Docker Hub / the registry encoded in `ref`. Set this
+   * when the image lives locally and a registry round-trip
+   * would be wasteful or impossible (offline CI, locally-built
+   * images via Apple `container`, etc.).
+   *
+   * Accepted values:
+   * * `"oci-archive"` — `sourcePath` is a tarball (the output of
+   *   `docker save` or `skopeo copy --format=oci-archive`).
+   * * `"oci-layout"` — `sourcePath` is a directory containing
+   *   `index.json` + `oci-layout` + `blobs/sha256/...`.
+   * * `"registry"` — default. `sourcePath` is ignored.
+   *
+   * When set, `ref` is preserved as the logical image identifier
+   * (used to derive the snapshot directory name); the actual
+   * image bytes come from `sourcePath`. The folded input hash
+   * includes the source path's stat so changes to the local
+   * image re-bake automatically.
+   */
+  source?: string
+  /** File or directory path for non-registry sources. See `source`. */
+  sourcePath?: string
   /**
    * Stable tag for the warmup callback (see the `warmup`
    * parameter on [`Image.build`]). Folded into the snapshot's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermachine/core",
-  "version": "0.4.29",
+  "version": "0.5.0",
   "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.4.29"
+    "@supermachine/core-darwin-arm64": "0.5.0"
   },
   "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",