@declaw/sdk 1.1.3 → 1.1.5

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.5]
+
+### Changed
+
+- Set Node dispatcher pool size to 64 (overridable via
+  `DECLAW_SDK_CONNECTIONS`).
+
+## [1.1.4]
+
+### Changed
+
+- Enable HTTP/2 multiplexing on the Node dispatcher (`allowH2: true`).
+
 ## [1.1.3]
 
 ### Changed

package/dist/index.cjs

@@ -244,12 +244,20 @@ function getDispatcher() {
       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");
+      const connOverride = parseInt(process.env.DECLAW_SDK_CONNECTIONS || "", 10);
+      const connections = Number.isFinite(connOverride) && connOverride > 0 ? connOverride : 64;
       return new undici.Agent({
-        connections: 128,
+        connections,
         keepAliveTimeout: 3e4,
         keepAliveMaxTimeout: 6e4,
         pipelining: 1,
+        allowH2: true,
         connect: { keepAlive: true, keepAliveInitialDelay: 5e3 }
       });
     } catch {
@@ -2264,6 +2272,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.
@@ -2448,11 +2477,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);
@@ -2480,11 +2528,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;