@daytona/sdk 0.199.0-alpha.1 → 0.200.0

package/cjs/utils/EventDispatcher.js

@@ -0,0 +1,398 @@
+"use strict";
+/*
+ * Copyright Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventDispatcher = void 0;
+const socket_io_client_1 = require("socket.io-client");
+/**
+ * Extracts the resource ID from an event payload.
+ *
+ * Handles two payload shapes:
+ *   - Wrapper: {sandbox: {id: ...}, ...} -> nested resource ID
+ *   - Direct: {id: ...} -> top-level ID
+ */
+function extractIdFromEvent(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    for (const key of ['sandbox', 'volume', 'snapshot', 'runner']) {
+        const nested = data[key];
+        if (nested && typeof nested === 'object' && typeof nested.id === 'string') {
+            return nested.id;
+        }
+    }
+    if (typeof data.id === 'string') {
+        return data.id;
+    }
+    return undefined;
+}
+/**
+ * Manages a Socket.IO connection to the Daytona notification gateway
+ * and dispatches resource events to per-resource handlers.
+ */
+class EventDispatcher {
+    apiUrl;
+    token;
+    organizationId;
+    source;
+    sdkVersion;
+    socket;
+    _connected = false;
+    _closed = false;
+    _failed = false;
+    _failError = null;
+    listeners = new Map();
+    registeredEvents = new Set();
+    connectPromise = null;
+    ensureConnectPromise = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 10;
+    // Cleared on connect/error/disconnect to prevent late state mutation.
+    _connectTimer = null;
+    disconnectTimer = null;
+    disconnectGeneration = 0;
+    static DISCONNECT_DELAY_MS = 30_000;
+    // Set once on the first Manager 'open' by capability probe, not runtime name.
+    // `undefined` (pre-connect) is treated as `false` → ephemeral disconnect.
+    supportsBackgroundUnref = undefined;
+    constructor(apiUrl, token, organizationId, source, sdkVersion) {
+        this.apiUrl = apiUrl;
+        this.token = token;
+        this.organizationId = organizationId;
+        this.source = source;
+        this.sdkVersion = sdkVersion;
+    }
+    /**
+     * Idempotent: ensure a connection attempt is in progress or already established.
+     *
+     * Non-blocking. Fires-and-forgets a connect() call via a stored promise if not
+     * already connected and no attempt is currently running.
+     */
+    ensureConnected() {
+        // No-op after disconnect — prevents socket resurrection.
+        if (this._closed)
+            return;
+        if (this._connected)
+            return;
+        if (this.connectPromise)
+            return;
+        if (this.ensureConnectPromise)
+            return;
+        this.ensureConnectPromise = this.connect()
+            .catch(() => {
+            // Callers check isConnected when they need it
+        })
+            .finally(() => {
+            this.ensureConnectPromise = null;
+        });
+    }
+    /**
+     * Establishes the Socket.IO connection. Resolves when connected.
+     * Throws if the connection fails within the timeout.
+     */
+    async connect(timeoutMs = 5000) {
+        if (this._closed) {
+            return;
+        }
+        if (this._connected && this.socket) {
+            return;
+        }
+        if (this.connectPromise) {
+            return this.connectPromise;
+        }
+        this.connectPromise = this.doConnect(timeoutMs);
+        try {
+            await this.connectPromise;
+            if (this.listeners.size === 0) {
+                this.scheduleDelayedDisconnect();
+            }
+        }
+        catch (error) {
+            if (this.listeners.size === 0) {
+                // Stop retries if nobody is listening.
+                this.socket?.disconnect();
+            }
+            throw error;
+        }
+        finally {
+            this.connectPromise = null;
+        }
+    }
+    doConnect(timeoutMs) {
+        return new Promise((resolve, reject) => {
+            if (this.socket) {
+                this.socket.removeAllListeners();
+                this.socket.disconnect();
+                this.socket = undefined;
+            }
+            // Derive path from the API URL so reverse-proxy prefixes are preserved (not hardcoded /api).
+            const url = new URL(this.apiUrl);
+            const origin = url.origin;
+            const socketPath = `${url.pathname.replace(/\/$/, '')}/socket.io/`;
+            const query = {};
+            if (this.organizationId) {
+                query.organizationId = this.organizationId;
+            }
+            if (this.source) {
+                query.source = this.source;
+            }
+            if (this.sdkVersion) {
+                query.sdkVersion = this.sdkVersion;
+            }
+            this.socket = (0, socket_io_client_1.io)(origin, {
+                path: socketPath,
+                autoConnect: false,
+                transports: ['websocket'],
+                query,
+                reconnection: true,
+                reconnectionAttempts: this.maxReconnectAttempts,
+                reconnectionDelay: 1000,
+                reconnectionDelayMax: 30000,
+            });
+            this.socket.auth = { token: this.token };
+            this.clearConnectTimer();
+            this._connectTimer = setTimeout(() => {
+                if (!this._connected) {
+                    this.socket?.disconnect();
+                    this.clearConnectTimer();
+                    this._failed = true;
+                    this._failError = 'WebSocket connection timed out';
+                    reject(new Error(this._failError));
+                }
+            }, timeoutMs);
+            if (typeof this._connectTimer.unref === 'function') {
+                this._connectTimer.unref();
+            }
+            this.socket.on('connect', () => {
+                this.clearConnectTimer();
+                this._connected = true;
+                this._failed = false;
+                this._failError = null;
+                this.reconnectAttempts = 0;
+                resolve();
+            });
+            this.socket.on('connect_error', (err) => {
+                if (!this._connected) {
+                    this.clearConnectTimer();
+                    this._failed = true;
+                    this._failError = `WebSocket connection failed: ${err.message}`;
+                    reject(new Error(this._failError));
+                }
+            });
+            this.socket.on('disconnect', (reason) => {
+                this._connected = false;
+                if (reason === 'io server disconnect') {
+                    // Server initiated disconnect - try to reconnect
+                    this.socket?.connect();
+                }
+            });
+            this.socket.io.on('reconnect', () => {
+                this._connected = true;
+                this._failed = false;
+                this._failError = null;
+                this.reconnectAttempts = 0;
+            });
+            this.socket.io.on('reconnect_attempt', () => {
+                this.reconnectAttempts++;
+            });
+            this.socket.io.on('reconnect_failed', () => {
+                this._connected = false;
+                this._failed = true;
+                this._failError = `WebSocket reconnection failed after ${this.maxReconnectAttempts} attempts`;
+            });
+            // Fires before engine.io's first _resetPingTimeout(), so enabling autoUnref here
+            // also covers the initial + recurring ping timers and reconnect timers.
+            this.socket.io.on('open', () => {
+                this.applyUnrefCapability();
+            });
+            // Re-register any events that were added before the socket was created
+            const pendingEvents = [...this.registeredEvents];
+            this.registeredEvents.clear();
+            this.registerEvents(pendingEvents);
+            this.socket.connect();
+        });
+    }
+    /**
+     * Registers Socket.IO event handlers (idempotent -- each event is registered once).
+     */
+    registerEvents(events) {
+        for (const eventName of events) {
+            if (this.registeredEvents.has(eventName)) {
+                continue;
+            }
+            this.registeredEvents.add(eventName);
+            // If socket isn't created yet, the event will be registered when connect() runs
+            if (!this.socket)
+                continue;
+            const handler = (data) => {
+                const resourceId = extractIdFromEvent(data);
+                if (resourceId) {
+                    this.dispatch(resourceId, eventName, data);
+                }
+            };
+            this.socket.on(eventName, handler);
+        }
+    }
+    /**
+     * Registers a handler for events targeting a specific resource.
+     * Returns an unsubscribe function.
+     *
+     * @param resourceId - The ID of the resource (e.g. sandbox ID).
+     * @param handler - Callback receiving (eventName, rawData).
+     * @param events - List of Socket.IO event names to listen for.
+     */
+    subscribe(resourceId, handler, events) {
+        // No-op after disconnect — prevents socket resurrection.
+        if (this._closed) {
+            return () => {
+                return;
+            };
+        }
+        this.cancelDelayedDisconnect();
+        this.disconnectGeneration++;
+        this.ensureConnected();
+        if (!this.listeners.has(resourceId)) {
+            this.listeners.set(resourceId, new Set());
+        }
+        this.listeners.get(resourceId).add(handler);
+        // Register any new events with the Socket.IO client
+        this.registerEvents(events);
+        return () => {
+            const handlers = this.listeners.get(resourceId);
+            if (handlers) {
+                handlers.delete(handler);
+                if (handlers.size === 0) {
+                    this.listeners.delete(resourceId);
+                }
+            }
+            // Schedule delayed disconnect when no resources are listening anymore
+            if (this.listeners.size === 0) {
+                this.scheduleDelayedDisconnect();
+            }
+        };
+    }
+    /** Whether the WebSocket is currently connected */
+    get isConnected() {
+        return this._connected;
+    }
+    /** Whether the WebSocket has permanently failed (exhausted reconnection attempts) */
+    get isFailed() {
+        return this._failed;
+    }
+    /** The error message if the connection has failed */
+    get failError() {
+        return this._failError;
+    }
+    /** Disconnects and cleans up all resources */
+    disconnect() {
+        this._closed = true;
+        this.cancelDelayedDisconnect();
+        this.clearConnectTimer();
+        this.connectPromise = null;
+        this.ensureConnectPromise = null;
+        this.disconnectSocket();
+    }
+    disconnectSocket() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.disconnect();
+            this.socket = undefined;
+        }
+        this._connected = false;
+        this.listeners.clear();
+        this.registeredEvents.clear();
+    }
+    /**
+     * Decides, by capability rather than runtime name, whether this runtime can keep a
+     * background socket open without blocking process exit.
+     *
+     * A runtime qualifies only if it can unref BOTH the transport's raw socket AND timers:
+     * Node/Deno (ws package exposes `_socket`, timers are objects) qualify; Bun (native
+     * WebSocket has no `_socket`) and browsers (timers are numbers, no `_socket`) do not.
+     *
+     * When it qualifies, this unrefs the current connection's socket (engine.io skipped it —
+     * autoUnref was off during the transport's onopen) and enables engine.io's own autoUnref
+     * so it keeps every later ping-timeout and reconnect timer unref'd. When it does not,
+     * autoUnref stays off (avoiding the `ws._socket.unref()` and number-timer crashes) and
+     * the socket is dropped the instant it goes idle (see scheduleDelayedDisconnect).
+     */
+    applyUnrefCapability() {
+        const manager = this.socket?.io;
+        // Known-unsupported runtime: nothing to unref; ephemeral disconnect handles exit.
+        if (this.supportsBackgroundUnref === false)
+            return;
+        // Re-apply per Manager: an idle disconnect replaces the socket with a fresh manager
+        // whose autoUnref is off, so skip only when this manager already has it applied.
+        if (this.supportsBackgroundUnref === true && manager?.opts?.autoUnref === true)
+            return;
+        try {
+            const engine = manager?.engine;
+            const rawSocket = engine?.transport?.ws?._socket;
+            const socketUnrefable = !!rawSocket && typeof rawSocket.unref === 'function';
+            const probe = setTimeout(() => undefined, 0);
+            const timerUnrefable = typeof probe?.unref === 'function';
+            clearTimeout(probe);
+            if (socketUnrefable && timerUnrefable) {
+                rawSocket.unref();
+                engine.opts.autoUnref = true;
+                manager.opts.autoUnref = true;
+                this.supportsBackgroundUnref = true;
+            }
+            else if (this.supportsBackgroundUnref === undefined) {
+                this.supportsBackgroundUnref = false;
+            }
+        }
+        catch {
+            if (this.supportsBackgroundUnref === undefined)
+                this.supportsBackgroundUnref = false;
+        }
+    }
+    dispatch(resourceId, eventName, data) {
+        if (!resourceId)
+            return;
+        const handlers = this.listeners.get(resourceId);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(eventName, data);
+                }
+                catch {
+                    // Don't let a handler error break other handlers
+                }
+            }
+        }
+    }
+    cancelDelayedDisconnect() {
+        if (this.disconnectTimer) {
+            clearTimeout(this.disconnectTimer);
+            this.disconnectTimer = null;
+        }
+    }
+    clearConnectTimer() {
+        if (this._connectTimer) {
+            clearTimeout(this._connectTimer);
+            this._connectTimer = null;
+        }
+    }
+    scheduleDelayedDisconnect() {
+        this.cancelDelayedDisconnect();
+        const generation = this.disconnectGeneration;
+        // Where the socket can't be unref'd (Bun/browser), an open idle socket keeps the
+        // event loop alive, so drop it immediately; elsewhere keep it warm for reuse.
+        const delay = this.supportsBackgroundUnref === true ? EventDispatcher.DISCONNECT_DELAY_MS : 0;
+        this.disconnectTimer = setTimeout(() => {
+            if (generation !== this.disconnectGeneration) {
+                return;
+            }
+            if (this.listeners.size === 0) {
+                this.disconnectSocket();
+            }
+        }, delay);
+        if (typeof this.disconnectTimer.unref === 'function') {
+            this.disconnectTimer.unref();
+        }
+    }
+}
+exports.EventDispatcher = EventDispatcher;
+//# sourceMappingURL=EventDispatcher.js.map

package/cjs/utils/EventDispatcher.js.map

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

package/cjs/utils/EventSubscriptionManager.d.ts

@@ -0,0 +1,14 @@
+import { EventDispatcher, type EventHandler } from './EventDispatcher';
+export declare class EventSubscriptionManager {
+    private readonly dispatcher;
+    private static readonly SUBSCRIPTION_TTL;
+    private readonly subscriptions;
+    private _closed;
+    constructor(dispatcher: EventDispatcher | null);
+    subscribe(resourceId: string, handler: EventHandler, events: string[]): string;
+    refresh(subId: string): boolean;
+    unsubscribe(subId: string): void;
+    shutdown(): void;
+    private createTimer;
+}
+//# sourceMappingURL=EventSubscriptionManager.d.ts.map

package/cjs/utils/EventSubscriptionManager.js

@@ -0,0 +1,98 @@
+"use strict";
+/*
+ * Copyright Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventSubscriptionManager = void 0;
+function createSubscriptionId() {
+    // Browser-safe UUID generation.
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    const randomHex = () => Math.floor(Math.random() * 0xffffffff)
+        .toString(16)
+        .padStart(8, '0');
+    return `${randomHex()}${randomHex()}${randomHex()}${randomHex()}`;
+}
+class EventSubscriptionManager {
+    dispatcher;
+    static SUBSCRIPTION_TTL = 300;
+    subscriptions = new Map();
+    _closed = false;
+    constructor(dispatcher) {
+        this.dispatcher = dispatcher;
+    }
+    subscribe(resourceId, handler, events) {
+        // No-op when shut down or when streaming is disabled (no dispatcher) — callers poll.
+        if (this._closed || !this.dispatcher) {
+            return '';
+        }
+        const subId = createSubscriptionId();
+        const unsubscribe = this.dispatcher.subscribe(resourceId, handler, events);
+        try {
+            if (this._closed) {
+                throw new Error('EventSubscriptionManager is closed');
+            }
+            this.subscriptions.set(subId, {
+                unsubscribe,
+                timer: this.createTimer(subId),
+            });
+            return subId;
+        }
+        catch (error) {
+            // Rollback dispatcher subscription on failure.
+            unsubscribe();
+            if (this._closed) {
+                return '';
+            }
+            throw error;
+        }
+    }
+    refresh(subId) {
+        // Reject operations after shutdown to prevent use-after-close.
+        if (this._closed) {
+            return false;
+        }
+        const subscription = this.subscriptions.get(subId);
+        if (!subscription) {
+            return false;
+        }
+        clearTimeout(subscription.timer);
+        subscription.timer = this.createTimer(subId);
+        return true;
+    }
+    unsubscribe(subId) {
+        const subscription = this.subscriptions.get(subId);
+        if (!subscription) {
+            return;
+        }
+        clearTimeout(subscription.timer);
+        this.subscriptions.delete(subId);
+        subscription.unsubscribe();
+    }
+    shutdown() {
+        this._closed = true;
+        for (const [subId, subscription] of this.subscriptions) {
+            clearTimeout(subscription.timer);
+            this.subscriptions.delete(subId);
+            subscription.unsubscribe();
+        }
+    }
+    createTimer(subId) {
+        const timer = setTimeout(() => {
+            const subscription = this.subscriptions.get(subId);
+            if (!subscription || subscription.timer !== timer) {
+                return;
+            }
+            this.subscriptions.delete(subId);
+            subscription.unsubscribe();
+        }, EventSubscriptionManager.SUBSCRIPTION_TTL * 1000);
+        if (typeof timer.unref === 'function') {
+            timer.unref();
+        }
+        return timer;
+    }
+}
+exports.EventSubscriptionManager = EventSubscriptionManager;
+//# sourceMappingURL=EventSubscriptionManager.js.map

package/cjs/utils/EventSubscriptionManager.js.map

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

package/esm/Daytona.d.ts

@@ -59,6 +59,16 @@ export interface DaytonaConfig {
     target?: string;
     /** Enable OpenTelemetry tracing for SDK operations. */
     otelEnabled?: boolean;
+    /**
+     * Observe sandbox state by legacy polling instead of WebSocket event streaming.
+     * Defaults to `false`, where state changes are streamed over WebSocket. Can also
+     * be enabled via the `DAYTONA_USE_DEPRECATED_POLLING` environment variable.
+     *
+     * @deprecated Polling-only mode will be removed in a future release. Event
+     * streaming is the default and falls back to polling automatically when
+     * WebSockets are unavailable.
+     */
+    useDeprecatedPolling?: boolean;
     /** Configuration for experimental features */
     _experimental?: Record<string, any>;
 }
@@ -109,9 +119,11 @@ export interface Resources {
  * @property {Record<string, string>} [envVars] - Optional environment variables to set in the Sandbox
  * @property {Record<string, string>} [labels] - Sandbox labels
  * @property {boolean} [public] - Is the Sandbox port preview public
- * @property {number} [autoStopInterval] - Auto-stop interval in minutes (0 means disabled). Default is 15 minutes.
+ * @property {number} [autoStopInterval] - Auto-stop interval in minutes (0 means disabled). Default is 15 minutes (for sandbox classes that support pausing, auto-pause defaults to 60 minutes instead and auto-stop is disabled).
+ * @property {number} [autoPauseInterval] - Auto-pause interval in minutes (0 means disabled). Only supported for sandbox classes that support pausing. Not allowed for ephemeral sandboxes. At most one of autoStopInterval and autoPauseInterval may be non-zero. For non-ephemeral sandbox classes that support pausing, defaults to 60 minutes (with auto-stop disabled) when neither interval is provided.
  * @property {number} [autoArchiveInterval] - Auto-archive interval in minutes (0 means the maximum interval will be used). Default is 7 days.
  * @property {number} [autoDeleteInterval] - Auto-delete interval in minutes (negative value means disabled, 0 means delete immediately upon stopping). By default, auto-delete is disabled.
+ * @property {number} [ttlMinutes] - Maximum time to live in minutes, counted as wall-clock time since creation regardless of sandbox state (0 means disabled). When it elapses the Sandbox is destroyed, even if it is stopped, paused, or archived.
  * @property {VolumeMount[]} [volumes] - Optional array of volumes to mount to the Sandbox
  * @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
@@ -128,8 +140,10 @@ export type CreateSandboxBaseParams = {
     labels?: Record<string, string>;
     public?: boolean;
     autoStopInterval?: number;
+    autoPauseInterval?: number;
     autoArchiveInterval?: number;
     autoDeleteInterval?: number;
+    ttlMinutes?: number;
     volumes?: VolumeMount[];
     networkBlockAll?: boolean;
     networkAllowList?: string;
@@ -196,12 +210,21 @@ export declare class Daytona implements AsyncDisposable {
     private readonly sandboxApi;
     private readonly objectStorageApi;
     private readonly configApi;
+    private analyticsApiUrlPromise?;
+    /**
+     * Resolves the deployment's Analytics API URL via `/config`, cached for the client's
+     * lifetime. The in-flight promise is shared by concurrent callers; a rejected lookup
+     * is evicted so the next call retries.
+     */
+    private readonly getAnalyticsApiUrl;
     private readonly target?;
     private readonly apiKey?;
     private readonly jwtToken?;
     private readonly organizationId?;
     private readonly apiUrl;
     private otelSdk?;
+    private eventDispatcher?;
+    private eventSubscriptionManager;
     readonly volume: VolumeService;
     readonly snapshot: SnapshotService;
     readonly secret: SecretService;
@@ -305,6 +328,7 @@ export declare class Daytona implements AsyncDisposable {
      * }
      */
     list(query?: ListSandboxesQuery): AsyncIterableIterator<Sandbox>;
+    private ensureToolboxProxyUrl;
     /**
      * Starts a Sandbox and waits for it to be ready.
      *
@@ -351,13 +375,14 @@ export declare class Daytona implements AsyncDisposable {
      *
      * @param {Sandbox} sandbox - The Sandbox to delete
      * @param {number} timeout - Timeout in seconds (0 means no timeout, default is 60)
+     * @param {boolean} wait - If true, wait until the Sandbox is destroyed (default is false)
      * @returns {Promise<void>}
      *
      * @example
      * const sandbox = await daytona.get('my-sandbox-id');
      * await daytona.delete(sandbox);
      */
-    delete(sandbox: Sandbox, timeout?: number): Promise<void>;
+    delete(sandbox: Sandbox, timeout?: number, wait?: boolean): Promise<void>;
     /**
      * @hidden
      */