smolmachines 1.25.2 → 1.26.1

package/dist/transport.d.ts

@@ -122,6 +122,13 @@ interface CloudConn {
     fetch?: typeof fetch;
     readResponseBytes?: (response: Response) => Promise<Uint8Array>;
 }
+/** The largest file the cloud's file routes accept. */
+export declare const CLOUD_MAX_FILE_BYTES: number;
+/** How long moving `bytes` may take (ms): the request timeout plus the time
+ *  `bytes` needs at the floor rate. */
+export declare function transferTimeoutMs(bytes: number): number;
+/** Refuse a file the cloud would refuse, before sending any of it. */
+export declare function checkCloudFileSize(path: string, bytes: number): void;
 /** The sentence a person should read from a failed response's body. The
  *  control plane answers errors as RFC 9457 problem+json, whose `detail` is the
  *  sentence; older builds sent `{"error": …}` or plain text. A JSON object

package/dist/transport.js

@@ -8,6 +8,7 @@
  *  Cloud-only/local-only capability gaps surface as `NotSupportedError`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLOUD_MAX_FILE_BYTES = void 0;
 exports.cliConfigApiKey = cliConfigApiKey;
 exports.resolveNetwork = resolveNetwork;
 exports.networkMode = networkMode;
@@ -15,6 +16,8 @@ exports.cloudNetwork = cloudNetwork;
 exports.egressPolicy = egressPolicy;
 exports.resolveBranchable = resolveBranchable;
 exports.toNativeConfig = toNativeConfig;
+exports.transferTimeoutMs = transferTimeoutMs;
+exports.checkCloudFileSize = checkCloudFileSize;
 exports.errorSentence = errorSentence;
 exports.encodePath = encodePath;
 exports.selectsCloud = selectsCloud;
@@ -699,6 +702,23 @@ function cloudConnOf(conn, baseUrl, apiKey) {
 const DEFAULT_CLOUD_URL = "https://api.smolmachines.com";
 /** Default per-request timeout for cloud calls (ms). Override via opts.timeoutMs. */
 const CLOUD_TIMEOUT_MS = 30_000;
+// A file transfer is given time for the slowest link it should survive: a
+// large file over a slow uplink must not fail at CLOUD_TIMEOUT_MS while it is
+// still moving. Same floor as the Rust and Python SDKs.
+const CLOUD_TRANSFER_FLOOR_BYTES_PER_S = 256 * 1024;
+/** The largest file the cloud's file routes accept. */
+exports.CLOUD_MAX_FILE_BYTES = 100 * 1024 * 1024;
+/** How long moving `bytes` may take (ms): the request timeout plus the time
+ *  `bytes` needs at the floor rate. */
+function transferTimeoutMs(bytes) {
+    return CLOUD_TIMEOUT_MS + Math.ceil(bytes / CLOUD_TRANSFER_FLOOR_BYTES_PER_S) * 1_000;
+}
+/** Refuse a file the cloud would refuse, before sending any of it. */
+function checkCloudFileSize(path, bytes) {
+    if (bytes > exports.CLOUD_MAX_FILE_BYTES) {
+        throw new errors_1.SmolError("SMOLVM_ERROR", `${path} is ${(bytes / (1024 * 1024)).toFixed(1)} MiB; cloud machines accept files up to ${exports.CLOUD_MAX_FILE_BYTES / (1024 * 1024)} MiB`);
+    }
+}
 // Starting can include a cold image pull. Keep ordinary API calls short, but
 // give this explicitly long-running operation the same bounded window already
 // used by checkpoint restore.
@@ -1132,11 +1152,14 @@ class CloudTransport {
     async readFile(path) {
         return cloudFetch(this.conn, "GET", `/v1/machines/${this.id}/files/${encodePath(path)}`, {
             accept: "bytes",
+            timeoutMs: transferTimeoutMs(exports.CLOUD_MAX_FILE_BYTES),
         });
     }
     async writeFile(path, data, mode) {
+        checkCloudFileSize(path, data.length);
         await cloudFetch(this.conn, "PUT", `/v1/machines/${this.id}/files/${encodePath(path)}`, {
             body: data,
+            timeoutMs: transferTimeoutMs(data.length),
         });
         // The cloud /files PUT carries no file mode, so apply it with chmod when
         // requested — e.g. writing an executable script the caller then runs.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smolmachines",
-  "version": "1.25.2",
+  "version": "1.26.1",
   "description": "Embed isolated microVM sandboxes directly in your code — no server to run.",
   "license": "Apache-2.0",
   "author": "smol-machines",
@@ -63,8 +63,8 @@
     "typescript": "^5.6.0"
   },
   "optionalDependencies": {
-    "smolmachines-darwin-arm64": "1.25.2",
-    "smolmachines-linux-x64-gnu": "1.25.2",
-    "smolmachines-linux-arm64-gnu": "1.25.2"
+    "smolmachines-darwin-arm64": "1.26.1",
+    "smolmachines-linux-x64-gnu": "1.26.1",
+    "smolmachines-linux-arm64-gnu": "1.26.1"
   }
 }