@daytonaio/sdk 0.127.0 → 0.128.0-alpha.1

package/esm/Snapshot.d.ts

@@ -0,0 +1,138 @@
+import { ObjectStorageApi, SnapshotDto, SnapshotsApi, Configuration, PaginatedSnapshots as PaginatedSnapshotsDto } from '@daytonaio/api-client';
+import { Image } from './Image.js';
+import { Resources } from './Daytona.js';
+/**
+ * Represents a Daytona Snapshot which is a pre-configured sandbox.
+ *
+ * @property {string} id - Unique identifier for the Snapshot.
+ * @property {string} organizationId - Organization ID that owns the Snapshot.
+ * @property {boolean} general - Whether the Snapshot is general.
+ * @property {string} name - Name of the Snapshot.
+ * @property {string} imageName - Name of the Image of the Snapshot.
+ * @property {SnapshotState} state - Current state of the Snapshot.
+ * @property {number} size - Size of the Snapshot.
+ * @property {string[]} entrypoint - Entrypoint of the Snapshot.
+ * @property {number} cpu - CPU of the Snapshot.
+ * @property {number} gpu - GPU of the Snapshot.
+ * @property {number} mem - Memory of the Snapshot in GiB.
+ * @property {number} disk - Disk of the Snapshot in GiB.
+ * @property {string} errorReason - Error reason of the Snapshot.
+ * @property {Date} createdAt - Timestamp when the Snapshot was created.
+ * @property {Date} updatedAt - Timestamp when the Snapshot was last updated.
+ * @property {Date} lastUsedAt - Timestamp when the Snapshot was last used.
+ */
+export type Snapshot = SnapshotDto & {
+    __brand: 'Snapshot';
+};
+/**
+ * Represents a paginated list of Daytona Snapshots.
+ *
+ * @property {Snapshot[]} items - List of Snapshot instances in the current page.
+ * @property {number} total - Total number of Snapshots across all pages.
+ * @property {number} page - Current page number.
+ * @property {number} totalPages - Total number of pages available.
+ */
+export interface PaginatedSnapshots extends Omit<PaginatedSnapshotsDto, 'items'> {
+    items: Snapshot[];
+}
+/**
+ * Parameters for creating a new snapshot.
+ *
+ * @property {string} name - Name of the snapshot.
+ * @property {string | Image} image - Image of the snapshot. If a string is provided, it should be available on some registry.
+ * If an Image instance is provided, it will be used to create a new image in Daytona.
+ * @property {Resources} resources - Resources of the snapshot.
+ * @property {string[]} entrypoint - Entrypoint of the snapshot.
+ */
+export type CreateSnapshotParams = {
+    name: string;
+    image: string | Image;
+    resources?: Resources;
+    entrypoint?: string[];
+    skipValidation?: boolean;
+};
+/**
+ * Service for managing Daytona Snapshots. Can be used to list, get, create and delete Snapshots.
+ *
+ * @class
+ */
+export declare class SnapshotService {
+    private clientConfig;
+    private snapshotsApi;
+    private objectStorageApi;
+    constructor(clientConfig: Configuration, snapshotsApi: SnapshotsApi, objectStorageApi: ObjectStorageApi);
+    /**
+     * List paginated list of Snapshots.
+     *
+     * @param {number} [page] - Page number for pagination (starting from 1)
+     * @param {number} [limit] - Maximum number of items per page
+     * @returns {Promise<PaginatedSnapshots>} Paginated list of Snapshots
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const result = await daytona.snapshot.list(2, 10);
+     * console.log(`Found ${result.total} snapshots`);
+     * result.items.forEach(snapshot => console.log(`${snapshot.name} (${snapshot.imageName})`));
+     */
+    list(page?: number, limit?: number): Promise<PaginatedSnapshots>;
+    /**
+     * Gets a Snapshot by its name.
+     *
+     * @param {string} name - Name of the Snapshot to retrieve
+     * @returns {Promise<Snapshot>} The requested Snapshot
+     * @throws {Error} If the Snapshot does not exist or cannot be accessed
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const snapshot = await daytona.snapshot.get("snapshot-name");
+     * console.log(`Snapshot ${snapshot.name} is in state ${snapshot.state}`);
+     */
+    get(name: string): Promise<Snapshot>;
+    /**
+     * Deletes a Snapshot.
+     *
+     * @param {Snapshot} snapshot - Snapshot to delete
+     * @returns {Promise<void>}
+     * @throws {Error} If the Snapshot does not exist or cannot be deleted
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const snapshot = await daytona.snapshot.get("snapshot-name");
+     * await daytona.snapshot.delete(snapshot);
+     * console.log("Snapshot deleted successfully");
+     */
+    delete(snapshot: Snapshot): Promise<void>;
+    /**
+     * Creates and registers a new snapshot from the given Image definition.
+     *
+     * @param {CreateSnapshotParams} params - Parameters for snapshot creation.
+     * @param {object} options - Options for the create operation.
+     * @param {boolean} options.onLogs - This callback function handles snapshot creation logs.
+     * @param {number} options.timeout - Default is no timeout. Timeout in seconds (0 means no timeout).
+     * @returns {Promise<void>}
+     *
+     * @example
+     * const image = Image.debianSlim('3.12').pipInstall('numpy');
+     * await daytona.snapshot.create({ name: 'my-snapshot', image: image }, { onLogs: console.log });
+     */
+    create(params: CreateSnapshotParams, options?: {
+        onLogs?: (chunk: string) => void;
+        timeout?: number;
+    }): Promise<Snapshot>;
+    /**
+     * Activates a snapshot.
+     *
+     * @param {Snapshot} snapshot - Snapshot to activate
+     * @returns {Promise<Snapshot>} The activated Snapshot instance
+     */
+    activate(snapshot: Snapshot): Promise<Snapshot>;
+    /**
+     * Processes the image contexts by uploading them to object storage
+     *
+     * @private
+     * @param {Image} image - The Image instance.
+     * @returns {Promise<string[]>} The list of context hashes stored in object storage.
+     */
+    static processImageContext(objectStorageApi: ObjectStorageApi, image: Image): Promise<string[]>;
+}
+//# sourceMappingURL=Snapshot.d.ts.map

package/esm/Snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Snapshot.d.ts","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/Snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EAGZ,aAAa,EACb,kBAAkB,IAAI,qBAAqB,EAC5C,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAIrC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,CAAA;AAE5D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAC9E,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,KAAK,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,gBAAgB;gBAFhB,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,gBAAgB;IAG5C;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUtE;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK1C;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;;;;;;;;OAYG;IACU,MAAM,CACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACnE,OAAO,CAAC,QAAQ,CAAC;IAmGpB;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrD;;;;;;OAMG;WACU,mBAAmB,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA2BtG"}

package/esm/Snapshot.js

@@ -0,0 +1,207 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SnapshotState, } from '@daytonaio/api-client';
+import { DaytonaError } from './errors/DaytonaError.js';
+import { processStreamingResponse } from './utils/Stream.js';
+import { dynamicImport } from './utils/Import.js';
+/**
+ * Service for managing Daytona Snapshots. Can be used to list, get, create and delete Snapshots.
+ *
+ * @class
+ */
+export class SnapshotService {
+    clientConfig;
+    snapshotsApi;
+    objectStorageApi;
+    constructor(clientConfig, snapshotsApi, objectStorageApi) {
+        this.clientConfig = clientConfig;
+        this.snapshotsApi = snapshotsApi;
+        this.objectStorageApi = objectStorageApi;
+    }
+    /**
+     * List paginated list of Snapshots.
+     *
+     * @param {number} [page] - Page number for pagination (starting from 1)
+     * @param {number} [limit] - Maximum number of items per page
+     * @returns {Promise<PaginatedSnapshots>} Paginated list of Snapshots
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const result = await daytona.snapshot.list(2, 10);
+     * console.log(`Found ${result.total} snapshots`);
+     * result.items.forEach(snapshot => console.log(`${snapshot.name} (${snapshot.imageName})`));
+     */
+    async list(page, limit) {
+        const response = await this.snapshotsApi.getAllSnapshots(undefined, page, limit);
+        return {
+            items: response.data.items.map((snapshot) => snapshot),
+            total: response.data.total,
+            page: response.data.page,
+            totalPages: response.data.totalPages,
+        };
+    }
+    /**
+     * Gets a Snapshot by its name.
+     *
+     * @param {string} name - Name of the Snapshot to retrieve
+     * @returns {Promise<Snapshot>} The requested Snapshot
+     * @throws {Error} If the Snapshot does not exist or cannot be accessed
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const snapshot = await daytona.snapshot.get("snapshot-name");
+     * console.log(`Snapshot ${snapshot.name} is in state ${snapshot.state}`);
+     */
+    async get(name) {
+        const response = await this.snapshotsApi.getSnapshot(name);
+        return response.data;
+    }
+    /**
+     * Deletes a Snapshot.
+     *
+     * @param {Snapshot} snapshot - Snapshot to delete
+     * @returns {Promise<void>}
+     * @throws {Error} If the Snapshot does not exist or cannot be deleted
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const snapshot = await daytona.snapshot.get("snapshot-name");
+     * await daytona.snapshot.delete(snapshot);
+     * console.log("Snapshot deleted successfully");
+     */
+    async delete(snapshot) {
+        await this.snapshotsApi.removeSnapshot(snapshot.id);
+    }
+    /**
+     * Creates and registers a new snapshot from the given Image definition.
+     *
+     * @param {CreateSnapshotParams} params - Parameters for snapshot creation.
+     * @param {object} options - Options for the create operation.
+     * @param {boolean} options.onLogs - This callback function handles snapshot creation logs.
+     * @param {number} options.timeout - Default is no timeout. Timeout in seconds (0 means no timeout).
+     * @returns {Promise<void>}
+     *
+     * @example
+     * const image = Image.debianSlim('3.12').pipInstall('numpy');
+     * await daytona.snapshot.create({ name: 'my-snapshot', image: image }, { onLogs: console.log });
+     */
+    async create(params, options = {}) {
+        const createSnapshotReq = {
+            name: params.name,
+        };
+        if (typeof params.image === 'string') {
+            createSnapshotReq.imageName = params.image;
+            createSnapshotReq.entrypoint = params.entrypoint;
+        }
+        else {
+            const contextHashes = await SnapshotService.processImageContext(this.objectStorageApi, params.image);
+            createSnapshotReq.buildInfo = {
+                contextHashes,
+                dockerfileContent: params.entrypoint
+                    ? params.image.entrypoint(params.entrypoint).dockerfile
+                    : params.image.dockerfile,
+            };
+        }
+        if (params.resources) {
+            createSnapshotReq.cpu = params.resources.cpu;
+            createSnapshotReq.gpu = params.resources.gpu;
+            createSnapshotReq.memory = params.resources.memory;
+            createSnapshotReq.disk = params.resources.disk;
+        }
+        if (params.skipValidation !== undefined) {
+            createSnapshotReq.skipValidation = params.skipValidation;
+        }
+        let createdSnapshot = (await this.snapshotsApi.createSnapshot(createSnapshotReq, undefined, {
+            timeout: (options.timeout || 0) * 1000,
+        })).data;
+        if (!createdSnapshot) {
+            throw new DaytonaError("Failed to create snapshot. Didn't receive a snapshot from the server API.");
+        }
+        const terminalStates = [SnapshotState.ACTIVE, SnapshotState.ERROR, SnapshotState.BUILD_FAILED];
+        const logTerminalStates = [
+            ...terminalStates,
+            SnapshotState.PENDING_VALIDATION,
+            SnapshotState.VALIDATING,
+        ];
+        const snapshotRef = { createdSnapshot: createdSnapshot };
+        let streamPromise;
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
+        const startLogStreaming = async (onChunk = () => { }) => {
+            if (!streamPromise) {
+                const url = `${this.clientConfig.basePath}/snapshots/${createdSnapshot.id}/build-logs?follow=true`;
+                streamPromise = processStreamingResponse(() => fetch(url, { method: 'GET', headers: this.clientConfig.baseOptions.headers }), (chunk) => onChunk(chunk.trimEnd()), async () => logTerminalStates.includes(snapshotRef.createdSnapshot.state));
+            }
+        };
+        if (options.onLogs) {
+            options.onLogs(`Creating snapshot ${createdSnapshot.name} (${createdSnapshot.state})`);
+            if (createdSnapshot.state !== SnapshotState.PENDING) {
+                await startLogStreaming(options.onLogs);
+            }
+        }
+        let previousState = createdSnapshot.state;
+        while (!terminalStates.includes(createdSnapshot.state)) {
+            if (options.onLogs && previousState !== createdSnapshot.state) {
+                if (createdSnapshot.state !== SnapshotState.PENDING && !streamPromise) {
+                    await startLogStreaming(options.onLogs);
+                }
+                options.onLogs(`Creating snapshot ${createdSnapshot.name} (${createdSnapshot.state})`);
+                previousState = createdSnapshot.state;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            createdSnapshot = await this.get(createdSnapshot.name);
+            snapshotRef.createdSnapshot = createdSnapshot;
+        }
+        if (options.onLogs) {
+            if (streamPromise) {
+                await streamPromise;
+            }
+            if (createdSnapshot.state === SnapshotState.ACTIVE) {
+                options.onLogs(`Created snapshot ${createdSnapshot.name} (${createdSnapshot.state})`);
+            }
+        }
+        if (createdSnapshot.state === SnapshotState.ERROR || createdSnapshot.state === SnapshotState.BUILD_FAILED) {
+            const errMsg = `Failed to create snapshot. Name: ${createdSnapshot.name} Reason: ${createdSnapshot.errorReason}`;
+            throw new DaytonaError(errMsg);
+        }
+        return createdSnapshot;
+    }
+    /**
+     * Activates a snapshot.
+     *
+     * @param {Snapshot} snapshot - Snapshot to activate
+     * @returns {Promise<Snapshot>} The activated Snapshot instance
+     */
+    async activate(snapshot) {
+        return (await this.snapshotsApi.activateSnapshot(snapshot.id)).data;
+    }
+    /**
+     * Processes the image contexts by uploading them to object storage
+     *
+     * @private
+     * @param {Image} image - The Image instance.
+     * @returns {Promise<string[]>} The list of context hashes stored in object storage.
+     */
+    static async processImageContext(objectStorageApi, image) {
+        if (!image.contextList || !image.contextList.length) {
+            return [];
+        }
+        const ObjectStorageModule = await dynamicImport('ObjectStorage', '"processImageContext" is not supported: ');
+        const pushAccessCreds = (await objectStorageApi.getPushAccess()).data;
+        const objectStorage = new ObjectStorageModule.ObjectStorage({
+            endpointUrl: pushAccessCreds.storageUrl,
+            accessKeyId: pushAccessCreds.accessKey,
+            secretAccessKey: pushAccessCreds.secret,
+            sessionToken: pushAccessCreds.sessionToken,
+            bucketName: pushAccessCreds.bucket,
+        });
+        const contextHashes = [];
+        for (const context of image.contextList) {
+            const contextHash = await objectStorage.upload(context.sourcePath, pushAccessCreds.organizationId, context.archivePath);
+            contextHashes.push(contextHash);
+        }
+        return contextHashes;
+    }
+}
+//# sourceMappingURL=Snapshot.js.map

package/esm/Snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Snapshot.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/Snapshot.ts"],"names":[],"mappings":"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"}

package/esm/Volume.d.ts

@@ -0,0 +1,84 @@
+import { VolumeDto, VolumesApi } from '@daytonaio/api-client';
+/**
+ * Represents a Daytona Volume which is a shared storage volume for Sandboxes.
+ *
+ * @property {string} id - Unique identifier for the Volume
+ * @property {string} name - Name of the Volume
+ * @property {string} organizationId - Organization ID that owns the Volume
+ * @property {string} state - Current state of the Volume
+ * @property {string} createdAt - Date and time when the Volume was created
+ * @property {string} updatedAt - Date and time when the Volume was last updated
+ * @property {string} lastUsedAt - Date and time when the Volume was last used
+ */
+export type Volume = VolumeDto & {
+    __brand: 'Volume';
+};
+/**
+ * Service for managing Daytona Volumes.
+ *
+ * This service provides methods to list, get, create, and delete Volumes.
+ *
+ * Volumes can be mounted to Sandboxes with an optional subpath parameter to mount
+ * only a specific S3 prefix within the volume. When no subpath is specified,
+ * the entire volume is mounted.
+ *
+ * @class
+ */
+export declare class VolumeService {
+    private volumesApi;
+    constructor(volumesApi: VolumesApi);
+    /**
+     * Lists all available Volumes.
+     *
+     * @returns {Promise<Volume[]>} List of all Volumes accessible to the user
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volumes = await daytona.volume.list();
+     * console.log(`Found ${volumes.length} volumes`);
+     * volumes.forEach(vol => console.log(`${vol.name} (${vol.id})`));
+     */
+    list(): Promise<Volume[]>;
+    /**
+     * Gets a Volume by its name.
+     *
+     * @param {string} name - Name of the Volume to retrieve
+     * @param {boolean} create - Whether to create the Volume if it does not exist
+     * @returns {Promise<Volume>} The requested Volume
+     * @throws {Error} If the Volume does not exist or cannot be accessed
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.get("volume-name", true);
+     * console.log(`Volume ${volume.name} is in state ${volume.state}`);
+     */
+    get(name: string, create?: boolean): Promise<Volume>;
+    /**
+     * Creates a new Volume with the specified name.
+     *
+     * @param {string} name - Name for the new Volume
+     * @returns {Promise<Volume>} The newly created Volume
+     * @throws {Error} If the Volume cannot be created
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.create("my-data-volume");
+     * console.log(`Created volume ${volume.name} with ID ${volume.id}`);
+     */
+    create(name: string): Promise<Volume>;
+    /**
+     * Deletes a Volume.
+     *
+     * @param {Volume} volume - Volume to delete
+     * @returns {Promise<void>}
+     * @throws {Error} If the Volume does not exist or cannot be deleted
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.get("volume-name");
+     * await daytona.volume.delete(volume);
+     * console.log("Volume deleted successfully");
+     */
+    delete(volume: Volume): Promise<void>;
+}
+//# sourceMappingURL=Volume.d.ts.map

package/esm/Volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Volume.d.ts","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/Volume.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAG7D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAE1C;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/B;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAYxD;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}

package/esm/Volume.js

@@ -0,0 +1,95 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DaytonaNotFoundError } from './errors/DaytonaError.js';
+/**
+ * Service for managing Daytona Volumes.
+ *
+ * This service provides methods to list, get, create, and delete Volumes.
+ *
+ * Volumes can be mounted to Sandboxes with an optional subpath parameter to mount
+ * only a specific S3 prefix within the volume. When no subpath is specified,
+ * the entire volume is mounted.
+ *
+ * @class
+ */
+export class VolumeService {
+    volumesApi;
+    constructor(volumesApi) {
+        this.volumesApi = volumesApi;
+    }
+    /**
+     * Lists all available Volumes.
+     *
+     * @returns {Promise<Volume[]>} List of all Volumes accessible to the user
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volumes = await daytona.volume.list();
+     * console.log(`Found ${volumes.length} volumes`);
+     * volumes.forEach(vol => console.log(`${vol.name} (${vol.id})`));
+     */
+    async list() {
+        const response = await this.volumesApi.listVolumes();
+        return response.data;
+    }
+    /**
+     * Gets a Volume by its name.
+     *
+     * @param {string} name - Name of the Volume to retrieve
+     * @param {boolean} create - Whether to create the Volume if it does not exist
+     * @returns {Promise<Volume>} The requested Volume
+     * @throws {Error} If the Volume does not exist or cannot be accessed
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.get("volume-name", true);
+     * console.log(`Volume ${volume.name} is in state ${volume.state}`);
+     */
+    async get(name, create = false) {
+        try {
+            const response = await this.volumesApi.getVolumeByName(name);
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof DaytonaNotFoundError && create) {
+                return await this.create(name);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Creates a new Volume with the specified name.
+     *
+     * @param {string} name - Name for the new Volume
+     * @returns {Promise<Volume>} The newly created Volume
+     * @throws {Error} If the Volume cannot be created
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.create("my-data-volume");
+     * console.log(`Created volume ${volume.name} with ID ${volume.id}`);
+     */
+    async create(name) {
+        const response = await this.volumesApi.createVolume({ name });
+        return response.data;
+    }
+    /**
+     * Deletes a Volume.
+     *
+     * @param {Volume} volume - Volume to delete
+     * @returns {Promise<void>}
+     * @throws {Error} If the Volume does not exist or cannot be deleted
+     *
+     * @example
+     * const daytona = new Daytona();
+     * const volume = await daytona.volume.get("volume-name");
+     * await daytona.volume.delete(volume);
+     * console.log("Volume deleted successfully");
+     */
+    async delete(volume) {
+        await this.volumesApi.deleteVolume(volume.id);
+    }
+}
+//# sourceMappingURL=Volume.js.map

package/esm/Volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Volume.js","sourceRoot":"","sources":["../../../../../libs/sdk-typescript/src/Volume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAe5D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,UAAsB;QAAtB,eAAU,GAAV,UAAU,CAAY;IAAG,CAAC;IAE9C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAA;QACpD,OAAO,QAAQ,CAAC,IAAgB,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,MAAM,GAAG,KAAK;QACpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YAC5D,OAAO,QAAQ,CAAC,IAAc,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAoB,IAAI,MAAM,EAAE,CAAC;gBACpD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAChC,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,OAAO,QAAQ,CAAC,IAAc,CAAA;IAChC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC/C,CAAC;CACF"}

package/esm/code-toolbox/SandboxJsCodeToolbox.d.ts

@@ -0,0 +1,6 @@
+import { SandboxCodeToolbox } from '../Sandbox.js';
+import { CodeRunParams } from '../Process.js';
+export declare class SandboxJsCodeToolbox implements SandboxCodeToolbox {
+    getRunCommand(code: string, params?: CodeRunParams): string;
+}
+//# sourceMappingURL=SandboxJsCodeToolbox.d.ts.map

package/esm/code-toolbox/SandboxJsCodeToolbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxJsCodeToolbox.d.ts","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/code-toolbox/SandboxJsCodeToolbox.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,qBAAa,oBAAqB,YAAW,kBAAkB;IACtD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM;CAMnE"}

package/esm/code-toolbox/SandboxJsCodeToolbox.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Buffer } from 'buffer';
+export class SandboxJsCodeToolbox {
+    getRunCommand(code, params) {
+        const base64Code = Buffer.from(code).toString('base64');
+        const argv = params?.argv ? params.argv.join(' ') : '';
+        return `sh -c 'echo ${base64Code} | base64 --decode | node -e "$(cat)" ${argv} 2>&1 | grep -vE "npm notice"'`;
+    }
+}
+//# sourceMappingURL=SandboxJsCodeToolbox.js.map

package/esm/code-toolbox/SandboxJsCodeToolbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxJsCodeToolbox.js","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/code-toolbox/SandboxJsCodeToolbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,OAAO,oBAAoB;IACxB,aAAa,CAAC,IAAY,EAAE,MAAsB;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAEtD,OAAO,eAAe,UAAU,yCAAyC,IAAI,gCAAgC,CAAA;IAC/G,CAAC;CACF"}

package/esm/code-toolbox/SandboxPythonCodeToolbox.d.ts

@@ -0,0 +1,12 @@
+import { SandboxCodeToolbox } from '../Sandbox.js';
+import { CodeRunParams } from '../Process.js';
+export declare class SandboxPythonCodeToolbox implements SandboxCodeToolbox {
+    getRunCommand(code: string, params?: CodeRunParams): string;
+    /**
+     * Checks if matplotlib is imported in the given Python code string.
+     * @param codeString Python code as a string
+     * @returns True if matplotlib is imported, false otherwise
+     */
+    private static isMatplotlibImported;
+}
+//# sourceMappingURL=SandboxPythonCodeToolbox.d.ts.map

package/esm/code-toolbox/SandboxPythonCodeToolbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxPythonCodeToolbox.d.ts","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/code-toolbox/SandboxPythonCodeToolbox.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,qBAAa,wBAAyB,YAAW,kBAAkB;IAC1D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM;IAoBlE;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAyBpC"}