@declaw/sdk 1.1.2 → 1.1.4

package/dist/index.d.cts

@@ -993,7 +993,7 @@ interface SandboxOpts {
     volumes?: VolumeAttachment[];
     /** API key override. */
     apiKey?: string;
-    /** Domain override (supports "host:port" format, e.g. "104.198.24.180:8080"). */
+    /** Domain override (supports "host:port" format, e.g. "myhost.example.com:8080"). */
     domain?: string;
     /** Full API URL override. If set, domain/port/scheme are ignored. */
     apiUrl?: string;
@@ -1186,6 +1186,22 @@ declare class Sandbox {
      * @returns Array of Snapshot metadata objects.
      */
     listSnapshots(requestTimeout?: number): Promise<Snapshot[]>;
+    /**
+     * 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.
+     */
+    deleteSnapshot(snapshotId: string, requestTimeout?: number): Promise<boolean>;
     /**
      * Restore a sandbox from a snapshot. The restored instance may run on a
      * different worker node than the original sandbox.
@@ -1372,8 +1388,24 @@ declare class TemplateBase {
     private _envs;
     private _aptPackages;
     private _startCmd?;
+    /**
+     * When set, the server uses this Dockerfile verbatim and ignores the
+     * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+     */
+    private _dockerfile?;
     /** Set the base image for the template. */
     fromBaseImage(image?: string): 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: string): this;
     /** Add a run command (as array of command + args). */
     runCmd(cmds: string[]): this;
     /** Add a file copy operation. */

package/dist/index.d.ts

@@ -993,7 +993,7 @@ interface SandboxOpts {
     volumes?: VolumeAttachment[];
     /** API key override. */
     apiKey?: string;
-    /** Domain override (supports "host:port" format, e.g. "104.198.24.180:8080"). */
+    /** Domain override (supports "host:port" format, e.g. "myhost.example.com:8080"). */
     domain?: string;
     /** Full API URL override. If set, domain/port/scheme are ignored. */
     apiUrl?: string;
@@ -1186,6 +1186,22 @@ declare class Sandbox {
      * @returns Array of Snapshot metadata objects.
      */
     listSnapshots(requestTimeout?: number): Promise<Snapshot[]>;
+    /**
+     * 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.
+     */
+    deleteSnapshot(snapshotId: string, requestTimeout?: number): Promise<boolean>;
     /**
      * Restore a sandbox from a snapshot. The restored instance may run on a
      * different worker node than the original sandbox.
@@ -1372,8 +1388,24 @@ declare class TemplateBase {
     private _envs;
     private _aptPackages;
     private _startCmd?;
+    /**
+     * When set, the server uses this Dockerfile verbatim and ignores the
+     * structured fields. Use for multi-stage builds, ARG, ONBUILD, etc.
+     */
+    private _dockerfile?;
     /** Set the base image for the template. */
     fromBaseImage(image?: string): 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: string): this;
     /** Add a run command (as array of command + args). */
     runCmd(cmds: string[]): this;
     /** Add a file copy operation. */

package/dist/index.js

@@ -116,6 +116,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,
@@ -226,12 +257,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;
@@ -2119,6 +2153,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.
@@ -2303,11 +2358,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);
@@ -2335,11 +2409,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;