@vercel/sandbox 1.0.4 → 1.1.1

package/dist/api-client/validators.d.ts

@@ -7,7 +7,7 @@ export declare const Sandbox: z.ZodObject<{
     region: z.ZodString;
     runtime: z.ZodString;
     timeout: z.ZodNumber;
-    status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed"]>;
+    status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
     requestedAt: z.ZodNumber;
     startedAt: z.ZodOptional<z.ZodNumber>;
     requestedStopAt: z.ZodOptional<z.ZodNumber>;
@@ -19,7 +19,7 @@ export declare const Sandbox: z.ZodObject<{
     interactivePort: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     region: string;
-    status: "pending" | "running" | "stopping" | "stopped" | "failed";
+    status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
     timeout: number;
     cwd: string;
     id: string;
@@ -36,7 +36,7 @@ export declare const Sandbox: z.ZodObject<{
     interactivePort?: number | undefined;
 }, {
     region: string;
-    status: "pending" | "running" | "stopping" | "stopped" | "failed";
+    status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
     timeout: number;
     cwd: string;
     id: string;
@@ -66,6 +66,35 @@ export declare const SandboxRoute: z.ZodObject<{
     port: number;
     subdomain: string;
 }>;
+export type SnapshotMetadata = z.infer<typeof Snapshot>;
+export declare const Snapshot: z.ZodObject<{
+    id: z.ZodString;
+    sourceSandboxId: z.ZodString;
+    region: z.ZodString;
+    status: z.ZodEnum<["created", "deleted", "failed"]>;
+    sizeBytes: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    region: string;
+    status: "failed" | "created" | "deleted";
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    sourceSandboxId: string;
+    sizeBytes: number;
+    expiresAt: number;
+}, {
+    region: string;
+    status: "failed" | "created" | "deleted";
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    sourceSandboxId: string;
+    sizeBytes: number;
+    expiresAt: number;
+}>;
 export declare const Pagination: z.ZodObject<{
     /**
      * Amount of items in the current page.
@@ -125,7 +154,7 @@ export declare const SandboxResponse: z.ZodObject<{
         region: z.ZodString;
         runtime: z.ZodString;
         timeout: z.ZodNumber;
-        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed"]>;
+        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
         requestedAt: z.ZodNumber;
         startedAt: z.ZodOptional<z.ZodNumber>;
         requestedStopAt: z.ZodOptional<z.ZodNumber>;
@@ -137,7 +166,7 @@ export declare const SandboxResponse: z.ZodObject<{
         interactivePort: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -154,7 +183,7 @@ export declare const SandboxResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     }, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -173,7 +202,7 @@ export declare const SandboxResponse: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -192,7 +221,7 @@ export declare const SandboxResponse: z.ZodObject<{
 }, {
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -217,7 +246,7 @@ export declare const SandboxAndRoutesResponse: z.ZodObject<{
         region: z.ZodString;
         runtime: z.ZodString;
         timeout: z.ZodNumber;
-        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed"]>;
+        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
         requestedAt: z.ZodNumber;
         startedAt: z.ZodOptional<z.ZodNumber>;
         requestedStopAt: z.ZodOptional<z.ZodNumber>;
@@ -229,7 +258,7 @@ export declare const SandboxAndRoutesResponse: z.ZodObject<{
         interactivePort: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -246,7 +275,7 @@ export declare const SandboxAndRoutesResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     }, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -279,7 +308,7 @@ export declare const SandboxAndRoutesResponse: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -303,7 +332,7 @@ export declare const SandboxAndRoutesResponse: z.ZodObject<{
 }, {
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -439,7 +468,7 @@ export declare const SandboxesResponse: z.ZodObject<{
         region: z.ZodString;
         runtime: z.ZodString;
         timeout: z.ZodNumber;
-        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed"]>;
+        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
         requestedAt: z.ZodNumber;
         startedAt: z.ZodOptional<z.ZodNumber>;
         requestedStopAt: z.ZodOptional<z.ZodNumber>;
@@ -451,7 +480,7 @@ export declare const SandboxesResponse: z.ZodObject<{
         interactivePort: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -468,7 +497,7 @@ export declare const SandboxesResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     }, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -512,7 +541,7 @@ export declare const SandboxesResponse: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     sandboxes: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -536,7 +565,7 @@ export declare const SandboxesResponse: z.ZodObject<{
 }, {
     sandboxes: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -566,7 +595,127 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         region: z.ZodString;
         runtime: z.ZodString;
         timeout: z.ZodNumber;
-        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed"]>;
+        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
+        requestedAt: z.ZodNumber;
+        startedAt: z.ZodOptional<z.ZodNumber>;
+        requestedStopAt: z.ZodOptional<z.ZodNumber>;
+        stoppedAt: z.ZodOptional<z.ZodNumber>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodNumber;
+        cwd: z.ZodString;
+        updatedAt: z.ZodNumber;
+        interactivePort: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        region: string;
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+        timeout: number;
+        cwd: string;
+        id: string;
+        memory: number;
+        vcpus: number;
+        runtime: string;
+        requestedAt: number;
+        createdAt: number;
+        updatedAt: number;
+        duration?: number | undefined;
+        startedAt?: number | undefined;
+        requestedStopAt?: number | undefined;
+        stoppedAt?: number | undefined;
+        interactivePort?: number | undefined;
+    }, {
+        region: string;
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+        timeout: number;
+        cwd: string;
+        id: string;
+        memory: number;
+        vcpus: number;
+        runtime: string;
+        requestedAt: number;
+        createdAt: number;
+        updatedAt: number;
+        duration?: number | undefined;
+        startedAt?: number | undefined;
+        requestedStopAt?: number | undefined;
+        stoppedAt?: number | undefined;
+        interactivePort?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    sandbox: {
+        region: string;
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+        timeout: number;
+        cwd: string;
+        id: string;
+        memory: number;
+        vcpus: number;
+        runtime: string;
+        requestedAt: number;
+        createdAt: number;
+        updatedAt: number;
+        duration?: number | undefined;
+        startedAt?: number | undefined;
+        requestedStopAt?: number | undefined;
+        stoppedAt?: number | undefined;
+        interactivePort?: number | undefined;
+    };
+}, {
+    sandbox: {
+        region: string;
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
+        timeout: number;
+        cwd: string;
+        id: string;
+        memory: number;
+        vcpus: number;
+        runtime: string;
+        requestedAt: number;
+        createdAt: number;
+        updatedAt: number;
+        duration?: number | undefined;
+        startedAt?: number | undefined;
+        requestedStopAt?: number | undefined;
+        stoppedAt?: number | undefined;
+        interactivePort?: number | undefined;
+    };
+}>;
+export declare const CreateSnapshotResponse: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        id: z.ZodString;
+        sourceSandboxId: z.ZodString;
+        region: z.ZodString;
+        status: z.ZodEnum<["created", "deleted", "failed"]>;
+        sizeBytes: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    }, {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    }>;
+    sandbox: z.ZodObject<{
+        id: z.ZodString;
+        memory: z.ZodNumber;
+        vcpus: z.ZodNumber;
+        region: z.ZodString;
+        runtime: z.ZodString;
+        timeout: z.ZodNumber;
+        status: z.ZodEnum<["pending", "running", "stopping", "stopped", "failed", "snapshotting"]>;
         requestedAt: z.ZodNumber;
         startedAt: z.ZodOptional<z.ZodNumber>;
         requestedStopAt: z.ZodOptional<z.ZodNumber>;
@@ -578,7 +727,7 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         interactivePort: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -595,7 +744,7 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     }, {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -612,9 +761,19 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
+    snapshot: {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    };
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -631,9 +790,19 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     };
 }, {
+    snapshot: {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    };
     sandbox: {
         region: string;
-        status: "pending" | "running" | "stopping" | "stopped" | "failed";
+        status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
         timeout: number;
         cwd: string;
         id: string;
@@ -650,3 +819,55 @@ export declare const ExtendTimeoutResponse: z.ZodObject<{
         interactivePort?: number | undefined;
     };
 }>;
+export declare const SnapshotResponse: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        id: z.ZodString;
+        sourceSandboxId: z.ZodString;
+        region: z.ZodString;
+        status: z.ZodEnum<["created", "deleted", "failed"]>;
+        sizeBytes: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    }, {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    snapshot: {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    };
+}, {
+    snapshot: {
+        region: string;
+        status: "failed" | "created" | "deleted";
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        sourceSandboxId: string;
+        sizeBytes: number;
+        expiresAt: number;
+    };
+}>;

package/dist/api-client/validators.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExtendTimeoutResponse = exports.SandboxesResponse = exports.LogLine = exports.EmptyResponse = exports.CommandFinishedResponse = exports.CommandResponse = exports.SandboxAndRoutesResponse = exports.SandboxResponse = exports.Command = exports.Pagination = exports.SandboxRoute = exports.Sandbox = void 0;
+exports.SnapshotResponse = exports.CreateSnapshotResponse = exports.ExtendTimeoutResponse = exports.SandboxesResponse = exports.LogLine = exports.EmptyResponse = exports.CommandFinishedResponse = exports.CommandResponse = exports.SandboxAndRoutesResponse = exports.SandboxResponse = exports.Command = exports.Pagination = exports.Snapshot = exports.SandboxRoute = exports.Sandbox = void 0;
 const zod_1 = require("zod");
 exports.Sandbox = zod_1.z.object({
     id: zod_1.z.string(),
@@ -9,7 +9,14 @@ exports.Sandbox = zod_1.z.object({
     region: zod_1.z.string(),
     runtime: zod_1.z.string(),
     timeout: zod_1.z.number(),
-    status: zod_1.z.enum(["pending", "running", "stopping", "stopped", "failed"]),
+    status: zod_1.z.enum([
+        "pending",
+        "running",
+        "stopping",
+        "stopped",
+        "failed",
+        "snapshotting",
+    ]),
     requestedAt: zod_1.z.number(),
     startedAt: zod_1.z.number().optional(),
     requestedStopAt: zod_1.z.number().optional(),
@@ -25,6 +32,16 @@ exports.SandboxRoute = zod_1.z.object({
     subdomain: zod_1.z.string(),
     port: zod_1.z.number(),
 });
+exports.Snapshot = zod_1.z.object({
+    id: zod_1.z.string(),
+    sourceSandboxId: zod_1.z.string(),
+    region: zod_1.z.string(),
+    status: zod_1.z.enum(["created", "deleted", "failed"]),
+    sizeBytes: zod_1.z.number(),
+    expiresAt: zod_1.z.number(),
+    createdAt: zod_1.z.number(),
+    updatedAt: zod_1.z.number(),
+});
 exports.Pagination = zod_1.z.object({
     /**
      * Amount of items in the current page.
@@ -78,4 +95,11 @@ exports.SandboxesResponse = zod_1.z.object({
 exports.ExtendTimeoutResponse = zod_1.z.object({
     sandbox: exports.Sandbox,
 });
+exports.CreateSnapshotResponse = zod_1.z.object({
+    snapshot: exports.Snapshot,
+    sandbox: exports.Sandbox,
+});
+exports.SnapshotResponse = zod_1.z.object({
+    snapshot: exports.Snapshot,
+});
 //# sourceMappingURL=validators.js.map

package/dist/api-client/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/api-client/validators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/api-client/validators.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export type RUNTIMES = "node24" | "node22" | "python3.13";

package/dist/constants.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":""}

package/dist/sandbox.d.ts

@@ -4,8 +4,11 @@ import { APIClient } from "./api-client";
 import { Command, type CommandFinished } from "./command";
 import { type Credentials } from "./utils/get-credentials";
 import { WithPrivate } from "./utils/types";
+import { WithFetchOptions } from "./api-client/api-client";
+import { RUNTIMES } from "./constants";
+import { Snapshot } from "./snapshot";
 /** @inline */
-export interface CreateSandboxParams {
+export interface BaseCreateSandboxParams {
     /**
      * The source of the sandbox.
      *
@@ -50,15 +53,21 @@ export interface CreateSandboxParams {
         vcpus: number;
     };
     /**
-     * The runtime of the sandbox, currently only `node22` and `python3.13` are supported.
+     * The runtime of the sandbox, currently only `node24`, `node22` and `python3.13` are supported.
      * If not specified, the default runtime `node22` will be used.
      */
-    runtime?: "node22" | "python3.13" | (string & {});
+    runtime?: RUNTIMES | (string & {});
     /**
      * An AbortSignal to cancel sandbox creation.
      */
     signal?: AbortSignal;
 }
+export type CreateSandboxParams = BaseCreateSandboxParams | (Omit<BaseCreateSandboxParams, "runtime" | "source"> & {
+    source: {
+        type: "snapshot";
+        snapshotId: string;
+    };
+});
 /** @inline */
 interface GetSandboxParams {
     /**
@@ -144,10 +153,10 @@ export declare class Sandbox {
      * It returns both the sandboxes and the pagination metadata to allow getting
      * the next page of results.
      */
-    static list(params: Parameters<APIClient["listSandboxes"]>[0] & Partial<Credentials>): Promise<import("./api-client/base-client").Parsed<{
+    static list(params: Parameters<APIClient["listSandboxes"]>[0] & Partial<Credentials> & WithFetchOptions): Promise<import("./api-client/base-client").Parsed<{
         sandboxes: {
             region: string;
-            status: "pending" | "running" | "stopping" | "stopped" | "failed";
+            status: "pending" | "running" | "stopping" | "stopped" | "failed" | "snapshotting";
             timeout: number;
             cwd: string;
             id: string;
@@ -175,14 +184,14 @@ export declare class Sandbox {
      * @param params - Creation parameters and optional credentials.
      * @returns A promise resolving to the created {@link Sandbox}.
      */
-    static create(params?: WithPrivate<CreateSandboxParams | (CreateSandboxParams & Credentials)>): Promise<Sandbox>;
+    static create(params?: WithPrivate<CreateSandboxParams | (CreateSandboxParams & Credentials)> & WithFetchOptions): Promise<Sandbox>;
     /**
      * Retrieve an existing sandbox.
      *
      * @param params - Get parameters and optional credentials.
      * @returns A promise resolving to the {@link Sandbox}.
      */
-    static get(params: WithPrivate<GetSandboxParams | (GetSandboxParams & Credentials)>): Promise<Sandbox>;
+    static get(params: WithPrivate<GetSandboxParams | (GetSandboxParams & Credentials)> & WithFetchOptions): Promise<Sandbox>;
     /**
      * Create a new Sandbox instance.
      *
@@ -319,5 +328,18 @@ export declare class Sandbox {
     extendTimeout(duration: number, opts?: {
         signal?: AbortSignal;
     }): Promise<void>;
+    /**
+     * Create a snapshot from this currently running sandbox. New sandboxes can
+     * then be created from this snapshot using {@link Sandbox.createFromSnapshot}.
+     *
+     * Note: this sandbox will be stopped as part of the snapshot creation process.
+     *
+     * @param opts - Optional parameters.
+     * @param opts.signal - An AbortSignal to cancel the operation.
+     * @returns A promise that resolves to the Snapshot instance
+     */
+    snapshot(opts?: {
+        signal?: AbortSignal;
+    }): Promise<Snapshot>;
 }
 export {};

package/dist/sandbox.js

@@ -5,6 +5,7 @@ const api_client_1 = require("./api-client");
 const command_1 = require("./command");
 const get_credentials_1 = require("./utils/get-credentials");
 const types_1 = require("./utils/types");
+const snapshot_1 = require("./snapshot");
 /**
  * A Sandbox is an isolated Linux MicroVM to run commands in.
  *
@@ -43,6 +44,7 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params.fetch,
         });
         return client.listSandboxes({
             ...params,
@@ -60,6 +62,7 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params?.fetch,
         });
         const privateParams = (0, types_1.getPrivateParams)(params);
         const sandbox = await client.createSandbox({
@@ -68,7 +71,7 @@ class Sandbox {
             ports: params?.ports ?? [],
             timeout: params?.timeout,
             resources: params?.resources,
-            runtime: params?.runtime,
+            runtime: params && "runtime" in params ? params?.runtime : undefined,
             signal: params?.signal,
             ...privateParams,
         });
@@ -89,6 +92,7 @@ class Sandbox {
         const client = new api_client_1.APIClient({
             teamId: credentials.teamId,
             token: credentials.token,
+            fetch: params.fetch,
         });
         const privateParams = (0, types_1.getPrivateParams)(params);
         const sandbox = await client.getSandbox({
@@ -286,6 +290,27 @@ class Sandbox {
         // Update the internal sandbox metadata with the new timeout value
         this.sandbox = response.json.sandbox;
     }
+    /**
+     * Create a snapshot from this currently running sandbox. New sandboxes can
+     * then be created from this snapshot using {@link Sandbox.createFromSnapshot}.
+     *
+     * Note: this sandbox will be stopped as part of the snapshot creation process.
+     *
+     * @param opts - Optional parameters.
+     * @param opts.signal - An AbortSignal to cancel the operation.
+     * @returns A promise that resolves to the Snapshot instance
+     */
+    async snapshot(opts) {
+        const response = await this.client.createSnapshot({
+            sandboxId: this.sandbox.id,
+            signal: opts?.signal,
+        });
+        this.sandbox = response.json.sandbox;
+        return new snapshot_1.Snapshot({
+            client: this.client,
+            snapshot: response.json.snapshot,
+        });
+    }
 }
 exports.Sandbox = Sandbox;
 //# sourceMappingURL=sandbox.js.map