@declaw/sdk 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to the Declaw TypeScript / JavaScript SDK are documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.4]
+
+### Changed
+
+- Enable HTTP/2 multiplexing on the Node dispatcher (`allowH2: true`).
+
+## [1.1.3]
+
+### Changed
+
+- **Higher-concurrency HTTP dispatcher on Node.** The SDK now installs a
+  module-level `undici.Agent` (128 connections per origin, keep-alive
+  tuned) on first use under Node, so callers fanning out many concurrent
+  requests are no longer capped by undici's default 10 connections per
+  origin. On runtimes that don't ship `undici` (browsers, Cloudflare
+  Workers, Deno) the dynamic import silently no-ops and the platform's
+  native `fetch` is used unchanged. Opt out with
+  `DECLAW_SDK_DISABLE_DISPATCHER=1` if you bring your own dispatcher.
+  `undici` is declared as an `optionalDependency`.
+
 ## [1.1.2]
 
 ### Fixed

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -223,6 +233,37 @@ var CommandExitError = class extends SandboxError {
 };
 
 // src/api/client.ts
+var _dispatcherPromise;
+function getDispatcher() {
+  if (_dispatcherPromise) return _dispatcherPromise;
+  _dispatcherPromise = (async () => {
+    try {
+      if (typeof process === "undefined" || !process.versions?.node) {
+        return void 0;
+      }
+      if (process.env.DECLAW_SDK_DISABLE_DISPATCHER) {
+        return void 0;
+      }
+      const origEmit = process.emitWarning;
+      process.emitWarning = ((warning, ...rest) => {
+        if (rest[0] === "UNDICI-H2") return;
+        return origEmit.call(process, warning, ...rest);
+      });
+      const undici = await import("undici");
+      return new undici.Agent({
+        connections: 10,
+        keepAliveTimeout: 3e4,
+        keepAliveMaxTimeout: 6e4,
+        pipelining: 1,
+        allowH2: true,
+        connect: { keepAlive: true, keepAliveInitialDelay: 5e3 }
+      });
+    } catch {
+      return void 0;
+    }
+  })();
+  return _dispatcherPromise;
+}
 var STATUS_ERROR_MAP = {
   401: AuthenticationError,
   403: AuthenticationError,
@@ -333,12 +374,15 @@ var ApiClient = class {
           signals.push(AbortSignal.timeout(timeoutMs));
         }
         const signal = signals.length === 1 ? signals[0] : AbortSignal.any(signals);
-        const response = await fetch(url, {
+        const dispatcher = await getDispatcher();
+        const fetchOpts = {
           method,
           headers,
           body: fetchBody,
           signal
-        });
+        };
+        if (dispatcher) fetchOpts.dispatcher = dispatcher;
+        const response = await fetch(url, fetchOpts);
         if (response.status >= 500 && attempt < this.maxRetries - 1) {
           await this.delay(attempt);
           continue;
@@ -2226,6 +2270,27 @@ var Sandbox = class _Sandbox {
     const raw = data.snapshots ?? [];
     return raw.map((s) => parseSnapshot(s));
   }
+  /**
+   * Delete a single snapshot of this sandbox by ID.
+   *
+   * The snapshot's PG row and S3 blobs (mem / vmstate / overlay) are
+   * removed. Idempotent: deleting an already-deleted snapshot resolves to
+   * true without throwing.
+   *
+   * The pause snapshot of a currently-paused sandbox is protected — the
+   * server returns 409 because deletion would break Resume. Resume or
+   * kill the sandbox first.
+   *
+   * @param snapshotId - The snapshot to delete.
+   * @param requestTimeout - Optional per-request timeout in milliseconds.
+   * @returns True on success.
+   */
+  async deleteSnapshot(snapshotId, requestTimeout) {
+    await this._client.delete(`/sandboxes/${this._sandboxId}/snapshots/${snapshotId}`, {
+      timeout: requestTimeout
+    });
+    return true;
+  }
   /**
    * Restore a sandbox from a snapshot. The restored instance may run on a
    * different worker node than the original sandbox.
@@ -2410,11 +2475,30 @@ var TemplateBase = class {
   _envs = {};
   _aptPackages = [];
   _startCmd;
+  /**
+   * When set, the server uses this Dockerfile verbatim and ignores the
+   * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+   */
+  _dockerfile;
   /** Set the base image for the template. */
   fromBaseImage(image) {
     this._baseImage = image ?? "ubuntu:22.04";
     return this;
   }
+  /**
+   * Use a raw Dockerfile string instead of the structured helpers.
+   *
+   * When set, all other ``aptInstall`` / ``runCmd`` / ``setEnvs`` /
+   * ``copy`` / ``setStartCmd`` / ``fromBaseImage`` calls on this spec
+   * are ignored — the Dockerfile is sent to the build worker verbatim.
+   *
+   * @param content Full Dockerfile contents. Must contain a ``FROM``
+   *   instruction. Capped server-side at 64 KiB.
+   */
+  fromDockerfile(content) {
+    this._dockerfile = content;
+    return this;
+  }
   /** Add a run command (as array of command + args). */
   runCmd(cmds) {
     this._runCmds.push(cmds);
@@ -2442,11 +2526,14 @@ var TemplateBase = class {
   }
   /** Serialize the template to a JSON-friendly object. */
   toJSON() {
+    if (this._dockerfile !== void 0) {
+      return { dockerfile: this._dockerfile };
+    }
     const result = {
       base_image: this._baseImage
     };
     if (this._runCmds.length > 0) {
-      result.run_cmds = this._runCmds;
+      result.run_cmds = this._runCmds.map((c) => c.join(" "));
     }
     if (this._copies.length > 0) {
       result.copies = this._copies;