@daytona/sdk 0.198.0-alpha.1 → 0.199.0-alpha.1

package/cjs/utils/EventDispatcher.js

@@ -1,398 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-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

@@ -1,98 +0,0 @@
-"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

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

package/esm/utils/EventDispatcher.d.ts

@@ -1,85 +0,0 @@
-/** Handler receives (eventName, rawData). */
-export type EventHandler = (eventName: string, data: any) => void;
-/**
- * Manages a Socket.IO connection to the Daytona notification gateway
- * and dispatches resource events to per-resource handlers.
- */
-export declare class EventDispatcher {
-    private readonly apiUrl;
-    private readonly token;
-    private readonly organizationId?;
-    private readonly source?;
-    private readonly sdkVersion?;
-    private socket;
-    private _connected;
-    private _closed;
-    private _failed;
-    private _failError;
-    private listeners;
-    private registeredEvents;
-    private connectPromise;
-    private ensureConnectPromise;
-    private reconnectAttempts;
-    private readonly maxReconnectAttempts;
-    private _connectTimer;
-    private disconnectTimer;
-    private disconnectGeneration;
-    private static readonly DISCONNECT_DELAY_MS;
-    private supportsBackgroundUnref;
-    constructor(apiUrl: string, token: string, organizationId?: string, source?: string, sdkVersion?: string);
-    /**
-     * 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(): void;
-    /**
-     * Establishes the Socket.IO connection. Resolves when connected.
-     * Throws if the connection fails within the timeout.
-     */
-    connect(timeoutMs?: number): Promise<void>;
-    private doConnect;
-    /**
-     * Registers Socket.IO event handlers (idempotent -- each event is registered once).
-     */
-    private registerEvents;
-    /**
-     * 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: string, handler: EventHandler, events: string[]): () => void;
-    /** Whether the WebSocket is currently connected */
-    get isConnected(): boolean;
-    /** Whether the WebSocket has permanently failed (exhausted reconnection attempts) */
-    get isFailed(): boolean;
-    /** The error message if the connection has failed */
-    get failError(): string | null;
-    /** Disconnects and cleans up all resources */
-    disconnect(): void;
-    private disconnectSocket;
-    /**
-     * 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).
-     */
-    private applyUnrefCapability;
-    private dispatch;
-    private cancelDelayedDisconnect;
-    private clearConnectTimer;
-    private scheduleDelayedDisconnect;
-}
-//# sourceMappingURL=EventDispatcher.d.ts.map