@daytonaio/sdk 0.128.0-alpha.1 → 0.128.0

package/esm/Sandbox.d.ts

@@ -1,359 +0,0 @@
-import { SandboxState, SandboxApi, Sandbox as SandboxDto, PaginatedSandboxes as PaginatedSandboxesDto, PortPreviewUrl, SandboxVolume, BuildInfo, SandboxBackupStateEnum, Configuration, SshAccessDto, SshAccessValidationDto } from '@daytonaio/api-client';
-import { FileSystem } from './FileSystem.js';
-import { Git } from './Git.js';
-import { CodeRunParams, Process } from './Process.js';
-import { LspLanguageId, LspServer } from './LspServer.js';
-import { ComputerUse } from './ComputerUse.js';
-import { AxiosInstance } from 'axios';
-import { CodeInterpreter } from './CodeInterpreter.js';
-/**
- * Interface defining methods that a code toolbox must implement
- * @interface
- */
-export interface SandboxCodeToolbox {
-    /** Generates a command to run the provided code */
-    getRunCommand(code: string, params?: CodeRunParams): string;
-}
-/**
- * Represents a Daytona Sandbox.
- *
- * @property {FileSystem} fs - File system operations interface
- * @property {Git} git - Git operations interface
- * @property {Process} process - Process execution interface
- * @property {CodeInterpreter} codeInterpreter - Stateful interpreter interface for executing code.
- *   Currently supports only Python. For other languages, use the `process.codeRun` method.
- * @property {ComputerUse} computerUse - Computer use operations interface for desktop automation
- * @property {string} id - Unique identifier for the Sandbox
- * @property {string} organizationId - Organization ID of the Sandbox
- * @property {string} [snapshot] - Daytona snapshot used to create the Sandbox
- * @property {string} user - OS user running in the Sandbox
- * @property {Record<string, string>} env - Environment variables set in the Sandbox
- * @property {Record<string, string>} labels - Custom labels attached to the Sandbox
- * @property {boolean} public - Whether the Sandbox is publicly accessible
- * @property {string} target - Target location of the runner where the Sandbox runs
- * @property {number} cpu - Number of CPUs allocated to the Sandbox
- * @property {number} gpu - Number of GPUs allocated to the Sandbox
- * @property {number} memory - Amount of memory allocated to the Sandbox in GiB
- * @property {number} disk - Amount of disk space allocated to the Sandbox in GiB
- * @property {SandboxState} state - Current state of the Sandbox (e.g., "started", "stopped")
- * @property {string} [errorReason] - Error message if Sandbox is in error state
- * @property {SandboxBackupStateEnum} [backupState] - Current state of Sandbox backup
- * @property {string} [backupCreatedAt] - When the backup was created
- * @property {number} [autoStopInterval] - Auto-stop interval in minutes
- * @property {number} [autoArchiveInterval] - Auto-archive interval in minutes
- * @property {number} [autoDeleteInterval] - Auto-delete interval in minutes
- * @property {Array<SandboxVolume>} [volumes] - Volumes attached to the Sandbox
- * @property {BuildInfo} [buildInfo] - Build information for the Sandbox if it was created from dynamic build
- * @property {string} [createdAt] - When the Sandbox was created
- * @property {string} [updatedAt] - When the Sandbox was last updated
- * @property {boolean} networkBlockAll - Whether to block all network access for the Sandbox
- * @property {string} [networkAllowList] - Comma-separated list of allowed CIDR network addresses for the Sandbox
- *
- * @class
- */
-export declare class Sandbox implements SandboxDto {
-    private readonly clientConfig;
-    private readonly axiosInstance;
-    private readonly sandboxApi;
-    private readonly codeToolbox;
-    private readonly getToolboxBaseUrl;
-    readonly fs: FileSystem;
-    readonly git: Git;
-    readonly process: Process;
-    readonly computerUse: ComputerUse;
-    readonly codeInterpreter: CodeInterpreter;
-    id: string;
-    name: string;
-    organizationId: string;
-    snapshot?: string;
-    user: string;
-    env: Record<string, string>;
-    labels: Record<string, string>;
-    public: boolean;
-    target: string;
-    cpu: number;
-    gpu: number;
-    memory: number;
-    disk: number;
-    state?: SandboxState;
-    errorReason?: string;
-    backupState?: SandboxBackupStateEnum;
-    backupCreatedAt?: string;
-    autoStopInterval?: number;
-    autoArchiveInterval?: number;
-    autoDeleteInterval?: number;
-    volumes?: Array<SandboxVolume>;
-    buildInfo?: BuildInfo;
-    createdAt?: string;
-    updatedAt?: string;
-    networkBlockAll: boolean;
-    networkAllowList?: string;
-    private infoApi;
-    /**
-     * Creates a new Sandbox instance
-     *
-     * @param {SandboxDto} sandboxDto - The API Sandbox instance
-     * @param {SandboxApi} sandboxApi - API client for Sandbox operations
-     * @param {InfoApi} infoApi - API client for info operations
-     * @param {SandboxCodeToolbox} codeToolbox - Language-specific toolbox implementation
-     */
-    constructor(sandboxDto: SandboxDto, clientConfig: Configuration, axiosInstance: AxiosInstance, sandboxApi: SandboxApi, codeToolbox: SandboxCodeToolbox, getToolboxBaseUrl: () => Promise<string>);
-    /**
-     * Gets the user's home directory path for the logged in user inside the Sandbox.
-     *
-     * @returns {Promise<string | undefined>} The absolute path to the Sandbox user's home directory for the logged in user
-     *
-     * @example
-     * const userHomeDir = await sandbox.getUserHomeDir();
-     * console.log(`Sandbox user home: ${userHomeDir}`);
-     */
-    getUserHomeDir(): Promise<string | undefined>;
-    /**
-     * @deprecated Use `getUserHomeDir` instead. This method will be removed in a future version.
-     */
-    getUserRootDir(): Promise<string | undefined>;
-    /**
-     * Gets the working directory path inside the Sandbox.
-     *
-     * @returns {Promise<string | undefined>} The absolute path to the Sandbox working directory. Uses the WORKDIR specified
-     * in the Dockerfile if present, or falling back to the user's home directory if not.
-     *
-     * @example
-     * const workDir = await sandbox.getWorkDir();
-     * console.log(`Sandbox working directory: ${workDir}`);
-     */
-    getWorkDir(): Promise<string | undefined>;
-    /**
-     * Creates a new Language Server Protocol (LSP) server instance.
-     *
-     * The LSP server provides language-specific features like code completion,
-     * diagnostics, and more.
-     *
-     * @param {LspLanguageId} languageId - The language server type (e.g., "typescript")
-     * @param {string} pathToProject - Path to the project root directory. Relative paths are resolved based on the sandbox working directory.
-     * @returns {LspServer} A new LSP server instance configured for the specified language
-     *
-     * @example
-     * const lsp = await sandbox.createLspServer('typescript', 'workspace/project');
-     */
-    createLspServer(languageId: LspLanguageId | string, pathToProject: string): Promise<LspServer>;
-    /**
-     * Sets labels for the Sandbox.
-     *
-     * Labels are key-value pairs that can be used to organize and identify Sandboxes.
-     *
-     * @param {Record<string, string>} labels - Dictionary of key-value pairs representing Sandbox labels
-     * @returns {Promise<void>}
-     *
-     * @example
-     * // Set sandbox labels
-     * await sandbox.setLabels({
-     *   project: 'my-project',
-     *   environment: 'development',
-     *   team: 'backend'
-     * });
-     */
-    setLabels(labels: Record<string, string>): Promise<Record<string, string>>;
-    /**
-     * Start the Sandbox.
-     *
-     * This method starts the Sandbox and waits for it to be ready.
-     *
-     * @param {number} [timeout] - Maximum time to wait in seconds. 0 means no timeout.
-     *                            Defaults to 60-second timeout.
-     * @returns {Promise<void>}
-     * @throws {DaytonaError} - `DaytonaError` - If Sandbox fails to start or times out
-     *
-     * @example
-     * const sandbox = await daytona.getCurrentSandbox('my-sandbox');
-     * await sandbox.start(40);  // Wait up to 40 seconds
-     * console.log('Sandbox started successfully');
-     */
-    start(timeout?: number): Promise<void>;
-    /**
-     * Stops the Sandbox.
-     *
-     * This method stops the Sandbox and waits for it to be fully stopped.
-     *
-     * @param {number} [timeout] - Maximum time to wait in seconds. 0 means no timeout.
-     *                            Defaults to 60-second timeout.
-     * @returns {Promise<void>}
-     *
-     * @example
-     * const sandbox = await daytona.getCurrentSandbox('my-sandbox');
-     * await sandbox.stop();
-     * console.log('Sandbox stopped successfully');
-     */
-    stop(timeout?: number): Promise<void>;
-    /**
-     * Deletes the Sandbox.
-     * @returns {Promise<void>}
-     */
-    delete(timeout?: number): Promise<void>;
-    /**
-     * Waits for the Sandbox to reach the 'started' state.
-     *
-     * This method polls the Sandbox status until it reaches the 'started' state
-     * or encounters an error.
-     *
-     * @param {number} [timeout] - Maximum time to wait in seconds. 0 means no timeout.
-     *                               Defaults to 60 seconds.
-     * @returns {Promise<void>}
-     * @throws {DaytonaError} - `DaytonaError` - If the sandbox ends up in an error state or fails to start within the timeout period.
-     */
-    waitUntilStarted(timeout?: number): Promise<void>;
-    /**
-     * Wait for Sandbox to reach 'stopped' state.
-     *
-     * This method polls the Sandbox status until it reaches the 'stopped' state
-     * or encounters an error.
-     *
-     * @param {number} [timeout] - Maximum time to wait in seconds. 0 means no timeout.
-     *                               Defaults to 60 seconds.
-     * @returns {Promise<void>}
-     * @throws {DaytonaError} - `DaytonaError` - If the sandbox fails to stop within the timeout period.
-     */
-    waitUntilStopped(timeout?: number): Promise<void>;
-    /**
-     * Refreshes the Sandbox data from the API.
-     *
-     * @returns {Promise<void>}
-     *
-     * @example
-     * await sandbox.refreshData();
-     * console.log(`Sandbox ${sandbox.id}:`);
-     * console.log(`State: ${sandbox.state}`);
-     * console.log(`Resources: ${sandbox.cpu} CPU, ${sandbox.memory} GiB RAM`);
-     */
-    refreshData(): Promise<void>;
-    /**
-     * Refreshes the sandbox activity to reset the timer for automated lifecycle management actions.
-     *
-     * This method updates the sandbox's last activity timestamp without changing its state.
-     * It is useful for keeping long-running sessions alive while there is still user activity.
-     *
-     * @returns {Promise<void>}
-     *
-     * @example
-     * // Keep sandbox activity alive
-     * await sandbox.refreshActivity();
-     */
-    refreshActivity(): Promise<void>;
-    /**
-     * Set the auto-stop interval for the Sandbox.
-     *
-     * The Sandbox will automatically stop after being idle (no new events) for the specified interval.
-     * Events include any state changes or interactions with the Sandbox through the sdk.
-     * Interactions using Sandbox Previews are not included.
-     *
-     * @param {number} interval - Number of minutes of inactivity before auto-stopping.
-     *                           Set to 0 to disable auto-stop. Default is 15 minutes.
-     * @returns {Promise<void>}
-     * @throws {DaytonaError} - `DaytonaError` - If interval is not a non-negative integer
-     *
-     * @example
-     * // Auto-stop after 1 hour
-     * await sandbox.setAutostopInterval(60);
-     * // Or disable auto-stop
-     * await sandbox.setAutostopInterval(0);
-     */
-    setAutostopInterval(interval: number): Promise<void>;
-    /**
-     * Set the auto-archive interval for the Sandbox.
-     *
-     * The Sandbox will automatically archive after being continuously stopped for the specified interval.
-     *
-     * @param {number} interval - Number of minutes after which a continuously stopped Sandbox will be auto-archived.
-     *                           Set to 0 for the maximum interval. Default is 7 days.
-     * @returns {Promise<void>}
-     * @throws {DaytonaError} - `DaytonaError` - If interval is not a non-negative integer
-     *
-     * @example
-     * // Auto-archive after 1 hour
-     * await sandbox.setAutoArchiveInterval(60);
-     * // Or use the maximum interval
-     * await sandbox.setAutoArchiveInterval(0);
-     */
-    setAutoArchiveInterval(interval: number): Promise<void>;
-    /**
-     * Set the auto-delete interval for the Sandbox.
-     *
-     * The Sandbox will automatically delete after being continuously stopped for the specified interval.
-     *
-     * @param {number} interval - Number of minutes after which a continuously stopped Sandbox will be auto-deleted.
-     *                           Set to negative value to disable auto-delete. Set to 0 to delete immediately upon stopping.
-     *                           By default, auto-delete is disabled.
-     * @returns {Promise<void>}
-     *
-     * @example
-     * // Auto-delete after 1 hour
-     * await sandbox.setAutoDeleteInterval(60);
-     * // Or delete immediately upon stopping
-     * await sandbox.setAutoDeleteInterval(0);
-     * // Or disable auto-delete
-     * await sandbox.setAutoDeleteInterval(-1);
-     */
-    setAutoDeleteInterval(interval: number): Promise<void>;
-    /**
-     * Retrieves the preview link for the sandbox at the specified port. If the port is closed,
-     * it will be opened automatically. For private sandboxes, a token is included to grant access
-     * to the URL.
-     *
-     * @param {number} port - The port to open the preview link on.
-     * @returns {PortPreviewUrl} The response object for the preview link, which includes the `url`
-     * and the `token` (to access private sandboxes).
-     *
-     * @example
-     * const previewLink = await sandbox.getPreviewLink(3000);
-     * console.log(`Preview URL: ${previewLink.url}`);
-     * console.log(`Token: ${previewLink.token}`);
-     */
-    getPreviewLink(port: number): Promise<PortPreviewUrl>;
-    /**
-     * Archives the sandbox, making it inactive and preserving its state. When sandboxes are archived, the entire filesystem
-     * state is moved to cost-effective object storage, making it possible to keep sandboxes available for an extended period.
-     * The tradeoff between archived and stopped states is that starting an archived sandbox takes more time, depending on its size.
-     * Sandbox must be stopped before archiving.
-     */
-    archive(): Promise<void>;
-    /**
-     * Creates an SSH access token for the sandbox.
-     *
-     * @param {number} expiresInMinutes - The number of minutes the SSH access token will be valid for.
-     * @returns {Promise<SshAccessDto>} The SSH access token.
-     */
-    createSshAccess(expiresInMinutes?: number): Promise<SshAccessDto>;
-    /**
-     * Revokes an SSH access token for the sandbox.
-     *
-     * @param {string} token - The token to revoke.
-     * @returns {Promise<void>}
-     */
-    revokeSshAccess(token: string): Promise<void>;
-    /**
-     * Validates an SSH access token for the sandbox.
-     *
-     * @param {string} token - The token to validate.
-     * @returns {Promise<SshAccessValidationDto>} The SSH access validation result.
-     */
-    validateSshAccess(token: string): Promise<SshAccessValidationDto>;
-    /**
-     * Assigns the API sandbox data to the Sandbox object.
-     *
-     * @param {SandboxDto} sandboxDto - The API sandbox instance to assign data from
-     * @returns {void}
-     */
-    private processSandboxDto;
-    /**
-     * Refreshes the Sandbox data from the API, but does not throw an error if the sandbox has been deleted.
-     * Instead, it sets the state to destroyed.
-     *
-     * @returns {Promise<void>}
-     */
-    private refreshDataSafe;
-    private ensureToolboxUrl;
-}
-export interface PaginatedSandboxes extends Omit<PaginatedSandboxesDto, 'items'> {
-    items: Sandbox[];
-}
-//# sourceMappingURL=Sandbox.d.ts.map

package/esm/Sandbox.d.ts.map

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