@blaxel/core 0.3.34-preview.340 → 0.3.35-preview.342

package/dist/esm-browser/common/settings.js

@@ -24,8 +24,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.34-preview.340";
-const BUILD_COMMIT = "e1289af07e1a5c5efeb0af7b397d2c2fd138d89f";
+const BUILD_VERSION = "0.3.35-preview.342";
+const BUILD_COMMIT = "a85b1b2bd40aafb7ab4d2a9cedb22713f44fc94c";
 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/esm-browser/sandbox/filesystem/copy-no-overwrite.js

@@ -0,0 +1,16 @@
+/**
+ * Thrown by `cp(..., { noOverwrite: true })` when the sandbox API reports that the
+ * final target already exists (HTTP 409, code `FILE_ALREADY_EXISTS`). The target is
+ * left unchanged. Paths are the original request strings, not the resolved child path.
+ */
+export class SandboxFileExistsError extends Error {
+    source;
+    destination;
+    code = "FILE_ALREADY_EXISTS";
+    constructor(source, destination, options) {
+        super(`Could not copy ${source} to ${destination}: destination already exists`, options);
+        this.source = source;
+        this.destination = destination;
+        this.name = "SandboxFileExistsError";
+    }
+}

package/dist/esm-browser/sandbox/filesystem/filesystem.js

@@ -5,6 +5,7 @@ import { isTransientResetError, retryOnTransientReset } from "../../common/trans
 import { shellQuote } from "../../common/shell.js";
 import { SandboxAction } from "../action.js";
 import { deleteFilesystemByPath, deleteFilesystemMultipartByUploadIdAbort, getFilesystemByPath, getFilesystemContentSearchByPath, getFilesystemFindByPath, getFilesystemSearchByPath, getFilesystemTreeByPath, getWatchFilesystemByPath, postFilesystemMultipartByUploadIdComplete, postFilesystemMultipartInitiateByPath, putFilesystemByPath, putFilesystemMultipartByUploadIdPart } from "../client/index.js";
+import { SandboxFileExistsError } from "./copy-no-overwrite.js";
 // Multipart upload constants
 const MULTIPART_THRESHOLD = 5 * 1024 * 1024; // 5MB
 const CHUNK_SIZE = 5 * 1024 * 1024; // 5MB per part
@@ -376,7 +377,10 @@ export class SandboxFileSystem extends SandboxAction {
             return result.data;
         });
     }
-    async cp(source, destination, { maxWait = 180000 } = {}) {
+    async cp(source, destination, { maxWait = 180000, noOverwrite = false } = {}) {
+        if (noOverwrite) {
+            return this.copyNoOverwrite(source, destination, maxWait);
+        }
         // Quote both paths so the shell that runs this command treats them as
         // single literal arguments instead of interpreting metacharacters in them.
         let process = await this.process.exec({
@@ -392,6 +396,50 @@ export class SandboxFileSystem extends SandboxAction {
             destination,
         };
     }
+    // One request: the sandbox API copies with exclusive creates and answers 409
+    // FILE_ALREADY_EXISTS when the final target exists. Not retried: a POST copy
+    // may have created entries before a connection reset.
+    // maxWait bounds the request like the default path's wait; -1 waits indefinitely.
+    async copyNoOverwrite(source, destination, maxWait) {
+        if (!source || !destination) {
+            throw new RangeError("source and destination must be nonempty paths");
+        }
+        if (!Number.isFinite(maxWait) || (maxWait < 0 && maxWait !== -1)) {
+            throw new RangeError("maxWait must be -1 or finite and non-negative");
+        }
+        const controller = new AbortController();
+        const timeoutError = new Error(`Could not copy ${source} to ${destination} within ${maxWait} ms; the sandbox may still be copying`);
+        const timeout = maxWait === -1 ? undefined : setTimeout(() => controller.abort(timeoutError), maxWait);
+        let result;
+        try {
+            result = await this.client.post({
+                url: "/filesystem-copy",
+                body: { source, destination, noOverwrite: true },
+                headers: { "Content-Type": "application/json" },
+                baseUrl: this.url,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            // Fetch implementations differ in what they reject with on abort.
+            if (controller.signal.aborted)
+                throw timeoutError;
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const { response, data, error } = result;
+        if (response.status === 409 && error?.code === "FILE_ALREADY_EXISTS") {
+            throw new SandboxFileExistsError(source, destination, { cause: error });
+        }
+        if (response.status === 404 && !error?.code && !error?.error) {
+            // An older sandbox API has no copy endpoint. Never fall back to an overwriting copy.
+            throw new Error("cp with noOverwrite needs a newer sandbox API: this sandbox has no /filesystem-copy endpoint; update its image");
+        }
+        this.handleResponseError(response, data, error);
+        return { message: "Files copied", source, destination };
+    }
     watch(path, callback, options) {
         path = this.formatPath(path);
         let closed = false;

package/dist/esm-browser/sandbox/filesystem/index.js

@@ -1,2 +1,3 @@
 export * from "./filesystem.js";
+export { SandboxFileExistsError } from "./copy-no-overwrite.js";
 export * from "./types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blaxel/core",
-	"version": "0.3.34-preview.340",
+	"version": "0.3.35-preview.342",
 	"description": "Blaxel Core SDK for TypeScript",
 	"license": "MIT",
 	"author": "Blaxel, INC (https://blaxel.ai)",