@blaxel/core 0.3.27 → 0.3.28

package/dist/cjs/common/settings.js

@@ -30,8 +30,8 @@ function missingCredentialsMessage() {
     return "No Blaxel credentials found. Set the BL_API_KEY and BL_WORKSPACE environment variables, or run `bl login`.";
 }
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.3.27";
-const BUILD_COMMIT = "b818d0f5560b92040baeb620b8d89bf148cba56d";
+const BUILD_VERSION = "0.3.28";
+const BUILD_COMMIT = "643251a25f011082e6849e55e91f3b06e3a1efb3";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-09-22";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2

package/dist/cjs/image/image.js

@@ -29,14 +29,19 @@ const BUILD_UPLOAD_LABELS = [
     "x-blaxel-build-cache",
 ];
 const MAX_BUILD_UPLOAD_LABEL_VALUE = 64;
-function buildSizeLabel(option, value, min, max) {
-    if (value === undefined) {
+// Reads an option that also has a deprecated `...Mb` spelling.
+function buildSizeLabel(option, value, deprecatedValue, min, max) {
+    if (value !== undefined && deprecatedValue !== undefined) {
+        throw new Error(`Set ${option} or ${option}Mb, not both`);
+    }
+    const size = value ?? deprecatedValue;
+    if (size === undefined) {
         return undefined;
     }
-    if (!Number.isInteger(value) || value < min || value > max) {
-        throw new Error(`${option} must be an integer between ${min} and ${max} MiB`);
+    if (!Number.isInteger(size) || size < min || size > max) {
+        throw new Error(`${value !== undefined ? option : `${option}Mb`} must be an integer between ${min} and ${max} MB`);
     }
-    return String(value);
+    return String(size);
 }
 function buildUploadMetadata(labels) {
     const metadata = {};
@@ -812,12 +817,12 @@ class ImageInstance {
     async build(options) {
         const { name, memory = 4096, timeout = 900000, onStatusChange, sandboxVersion = "latest" } = options;
         const buildLabels = {};
-        const buildMemory = buildSizeLabel("buildMemoryMb", options.buildMemoryMb, 1, 32768);
+        const buildMemory = buildSizeLabel("buildMemory", options.buildMemory, options.buildMemoryMb, 1, 32768);
         if (buildMemory !== undefined) {
             buildLabels["x-blaxel-build-memory"] = buildMemory;
         }
         // Keep an explicit 0: it asks for memory-backed scratch instead of the default.
-        const buildVolume = buildSizeLabel("buildVolumeMb", options.buildVolumeMb, 0, 131072);
+        const buildVolume = buildSizeLabel("buildVolume", options.buildVolume, options.buildVolumeMb, 0, 131072);
         if (buildVolume !== undefined) {
             buildLabels["x-blaxel-build-volume"] = buildVolume;
         }

package/dist/cjs/image/image.test.js

@@ -594,7 +594,7 @@ let tempSourceDir;
         vitest_1.vi.unstubAllGlobals();
     });
     (0, vitest_1.it)("sends build memory and volume as labels and signed upload headers", async () => {
-        const { create, upload } = await buildWith({ buildMemoryMb: 16384, buildVolumeMb: 32768 });
+        const { create, upload } = await buildWith({ buildMemory: 16384, buildVolume: 32768 });
         const labels = create.body.metadata?.labels;
         (0, vitest_1.expect)(labels?.["x-blaxel-build-memory"]).toBe("16384");
         (0, vitest_1.expect)(labels?.["x-blaxel-build-volume"]).toBe("32768");
@@ -604,20 +604,25 @@ let tempSourceDir;
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-auto-generated"]).toBeUndefined();
     });
     (0, vitest_1.it)("asks again when creating a sandbox does not sign the settings", async () => {
-        const { upload } = await buildWith({ buildMemoryMb: 2048 }, undefined, "update");
+        const { upload } = await buildWith({ buildMemory: 2048 }, undefined, "update");
         (0, vitest_1.expect)(calls.filter((call) => call.url.includes("upload=true")).map((call) => call.method)).toEqual(["PUT", "POST", "PUT"]);
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-memory"]).toBe("2048");
     });
     (0, vitest_1.it)("fails clearly when the settings are never signed", async () => {
-        await (0, vitest_1.expect)(buildWith({ buildVolumeMb: 32768 }, undefined, "none")).rejects.toThrow("x-blaxel-build-volume");
+        await (0, vitest_1.expect)(buildWith({ buildVolume: 32768 }, undefined, "none")).rejects.toThrow("x-blaxel-build-volume");
         (0, vitest_1.expect)(calls.some((call) => call.url.startsWith("https://upload.test"))).toBe(false);
     });
     (0, vitest_1.it)("drops stored labels the upload URL was not signed for", async () => {
         const { upload } = await buildWith({}, { "x-blaxel-auto-generated": "true", "x-blaxel-build-memory": "8192" }, "none");
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-memory"]).toBeUndefined();
     });
+    (0, vitest_1.it)("still accepts the deprecated Mb spellings", async () => {
+        const { create, upload } = await buildWith({ buildMemoryMb: 8192, buildVolumeMb: 0 });
+        (0, vitest_1.expect)(create.body.metadata?.labels?.["x-blaxel-build-memory"]).toBe("8192");
+        (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-volume"]).toBe("0");
+    });
     (0, vitest_1.it)("keeps an explicit zero volume", async () => {
-        const { upload } = await buildWith({ buildVolumeMb: 0 });
+        const { upload } = await buildWith({ buildVolume: 0 });
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-volume"]).toBe("0");
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-memory"]).toBeUndefined();
     });
@@ -630,11 +635,15 @@ let tempSourceDir;
         (0, vitest_1.expect)(upload.headers["x-amz-meta-x-blaxel-build-memory"]).toBe("8192");
     });
     vitest_1.it.each([
-        [{ buildMemoryMb: 0 }, "buildMemoryMb"],
-        [{ buildMemoryMb: 32769 }, "buildMemoryMb"],
-        [{ buildMemoryMb: 1.5 }, "buildMemoryMb"],
-        [{ buildVolumeMb: -1 }, "buildVolumeMb"],
-        [{ buildVolumeMb: 131073 }, "buildVolumeMb"],
+        [{ buildMemory: 0 }, "buildMemory must"],
+        [{ buildMemory: 32769 }, "buildMemory must"],
+        [{ buildMemory: 1.5 }, "buildMemory must"],
+        [{ buildVolume: -1 }, "buildVolume must"],
+        [{ buildVolume: 131073 }, "buildVolume must"],
+        [{ buildMemoryMb: 0 }, "buildMemoryMb must"],
+        [{ buildVolumeMb: -1 }, "buildVolumeMb must"],
+        [{ buildMemory: 2048, buildMemoryMb: 2048 }, "not both"],
+        [{ buildVolume: 0, buildVolumeMb: 0 }, "not both"],
     ])("rejects out-of-range %o before any request", async (options, option) => {
         const fetchSpy = vitest_1.vi.fn();
         vitest_1.vi.stubGlobal("fetch", fetchSpy);

package/dist/cjs/types/image/image.browser.d.ts

@@ -27,7 +27,11 @@ export interface ImageBuildOptions {
     timeout?: number;
     onStatusChange?: (status: string) => void;
     sandboxVersion?: string;
+    buildMemory?: number;
+    buildVolume?: number;
+    /** @deprecated Use `buildMemory`. */
     buildMemoryMb?: number;
+    /** @deprecated Use `buildVolume`. */
     buildVolumeMb?: number;
 }
 /**

package/dist/cjs/types/image/image.d.ts

@@ -29,14 +29,18 @@ export interface ImageBuildOptions {
     onStatusChange?: (status: string) => void;
     sandboxVersion?: string;
     /**
-     * Memory for the temporary build worker in MiB (1-32768). Same as
-     * `bl push --memory`. Does not change the deployed sandbox's memory.
+     * Memory of the environment the image is built in, in MB (1-32768). Same as
+     * `bl push --memory`. Does not change the deployed sandbox's `memory`.
      */
-    buildMemoryMb?: number;
+    buildMemory?: number;
     /**
-     * Scratch disk for the temporary build worker in MiB (0-131072). Same as
-     * `bl push --volume`; 0 uses memory-backed scratch.
+     * Disk attached to the build for its intermediate layers, in MB (0-131072).
+     * Same as `bl push --volume`; 0 builds in memory.
      */
+    buildVolume?: number;
+    /** @deprecated Use `buildMemory`. */
+    buildMemoryMb?: number;
+    /** @deprecated Use `buildVolume`. */
     buildVolumeMb?: number;
 }
 export interface PipInstallOptions {