rocketride 1.0.0

package/dist/types/client.d.ts.map

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

package/dist/types/constants.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Default RocketRide service endpoint URL.
+ * Used when no custom URI is provided in the client configuration.
+ */
+export declare const CONST_DEFAULT_SERVICE = "https://cloud.rocketride.ai";
+/**
+ * WebSocket connection timeout in seconds.
+ * If no communication occurs within this period, the connection may be considered stale.
+ */
+export declare const CONST_SOCKET_TIMEOUT = 180;
+/**
+ * WebSocket ping interval in seconds.
+ * Ping frames are sent at this interval to detect dead connections.
+ */
+export declare const CONST_WS_PING_INTERVAL = 15;
+/**
+ * WebSocket ping timeout in seconds.
+ * If no pong response is received within this period after a ping,
+ * the connection is considered dead and will be closed.
+ */
+export declare const CONST_WS_PING_TIMEOUT = 60;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/client/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/types/core/DAPBase.d.ts

@@ -0,0 +1,152 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { DAPMessage, RocketRideClientConfig } from '../types';
+import { TransportBase } from './TransportBase';
+/**
+ * Base class for DAP (Debug Adapter Protocol) components.
+ *
+ * Provides standardized logging, error handling, message building, and debugging
+ * capabilities for all DAP-based components. This class handles the low-level
+ * details of the protocol including message sequencing, request/response correlation,
+ * and transport binding.
+ *
+ * Key responsibilities:
+ * - Message sequence number generation
+ * - Transport layer binding and lifecycle management
+ * - Debug logging and protocol tracing
+ * - Error handling and exception building
+ * - Request/Response message construction
+ *
+ * @abstract This class is meant to be extended by specific DAP implementations
+ */
+export declare class DAPBase {
+    protected _msgType: string;
+    protected _seqCounter: number;
+    protected _transport?: TransportBase;
+    protected _callDebugMessage?: (message: string) => void;
+    protected _callDebugProtocol?: (message: string) => void;
+    protected _logger?: unknown;
+    /**
+     * Creates a new DAPBase instance.
+     *
+     * Transport may be omitted when it will be created later in the connect path
+     * (e.g. RocketRideClient defers transport creation until connect()).
+     *
+     * @param module - Name of the module for message type identification
+     * @param transport - Transport layer for communication (optional; set later via bindTransport)
+     * @param config - Client configuration including debug callbacks
+     */
+    constructor(module: string, transport: TransportBase | undefined, config: RocketRideClientConfig);
+    /**
+     * Set the transport and bind its callbacks to this instance.
+     * Use when creating the transport lazily (e.g. in _internalConnect).
+     */
+    protected _bindTransport(transport: TransportBase): void;
+    /**
+     * Attempt to call a specific method, falling back to a default method.
+     *
+     * This is a utility method for dynamic method dispatch based on message commands.
+     * It first tries to call a specific handler method, then falls back to a default
+     * handler if the specific one doesn't exist.
+     *
+     * @param message - The DAP message to be handled
+     * @param methodName - Name of the specific handler method to try
+     * @param defaultName - Name of the default fallback method
+     * @returns Tuple of [handled: boolean, result: any]
+     * @protected
+     */
+    protected _callMethod(message: DAPMessage, methodName?: string, defaultName?: string): Promise<[boolean, unknown]>;
+    /**
+     * Generate the next sequence number for DAP message correlation.
+     */
+    protected _nextSeq(): number;
+    /**
+     * Log an error message and throw the provided exception.
+     */
+    raiseException(exception: Error): never;
+    /**
+     * Output a general operational message with the instance's message type prefix.
+     */
+    debugMessage(msg: string): void;
+    /**
+     * Output a protocol-level debug message for detailed DAP communication tracing.
+     */
+    debugProtocol(packet: string): void;
+    /**
+     * Handle incoming DAP events from the transport layer.
+     */
+    onEvent(_event: DAPMessage): Promise<void>;
+    /**
+     * Handle transport connection establishment.
+     */
+    onConnected(_connectionInfo?: string): Promise<void>;
+    /**
+     * Handle transport disconnection and cleanup.
+     */
+    onDisconnected(_reason?: string, _hasError?: boolean): Promise<void>;
+    /**
+     * Handle connection attempt failure.
+     */
+    onConnectError(_error: Error): Promise<void>;
+    /**
+     * Handle received messages from the transport layer.
+     */
+    onReceive(_message: DAPMessage): Promise<void>;
+    /**
+     * Check if a DAP request indicates failure based on its response fields.
+     */
+    didFail(request: DAPMessage): boolean;
+    /**
+     * Extract the web error details from a DAP request message.
+     */
+    getWebResponse(message: DAPMessage): Record<string, unknown>;
+    /**
+     * Build a DAP request message following the protocol specification.
+     */
+    buildRequest(command: string, options?: {
+        token?: string;
+        arguments?: Record<string, unknown>;
+        data?: Uint8Array | string;
+    }): DAPMessage;
+    /**
+     * Build a successful DAP response message for a given request.
+     */
+    buildResponse(request: DAPMessage, body?: Record<string, unknown>): DAPMessage;
+    /**
+     * Build a DAP event message to notify clients of state changes.
+     */
+    buildEvent(event: string, options?: {
+        id?: string;
+        body?: Record<string, unknown>;
+    }): DAPMessage;
+    /**
+     * Build a DAP error response.
+     */
+    buildError(request: DAPMessage, message: string): DAPMessage;
+    /**
+     * Build a DAP exception response with debugging information.
+     */
+    buildException(request: DAPMessage, error: Error): DAPMessage;
+}
+//# sourceMappingURL=DAPBase.d.ts.map

package/dist/types/core/DAPBase.d.ts.map

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

package/dist/types/core/DAPClient.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { DAPBase } from './DAPBase';
+import { DAPMessage, RocketRideClientConfig } from '../types';
+import { TransportBase } from './TransportBase';
+/**
+ * DAP (Debug Adapter Protocol) client for communicating with RocketRide servers.
+ *
+ * This class implements the client side of the DAP communication protocol,
+ * managing request/response correlation, pending request tracking, and message
+ * sequencing. It extends DAPBase to inherit common protocol functionality.
+ *
+ * Key responsibilities:
+ * - Request/response correlation via sequence numbers
+ * - Pending request management with promises
+ * - Connection lifecycle management
+ * - Message routing and handling
+ *
+ * @extends DAPBase
+ */
+export declare class DAPClient extends DAPBase {
+    private _pendingRequests;
+    private _sequenceNumber;
+    protected _requestTimeout?: number;
+    constructor(module: string, transport: TransportBase | undefined, config?: RocketRideClientConfig);
+    /**
+     * Generate the next sequence number for outgoing requests.
+     */
+    private getNextSeq;
+    /**
+     * Send a message to the DAP server through the transport layer.
+     */
+    protected _send(message: DAPMessage): Promise<void>;
+    /**
+     * Handle connection established event.
+     */
+    onConnected(connectionInfo?: string): Promise<void>;
+    /**
+     * Handle connection attempt failure.
+     */
+    onConnectError(error: Error): Promise<void>;
+    /**
+     * Handle disconnection event and clean up pending requests.
+     */
+    onDisconnected(reason?: string, hasError?: boolean): Promise<void>;
+    /**
+     * Handle received messages from the transport layer.
+     */
+    onReceive(message: DAPMessage): Promise<void>;
+    /**
+     * Send a request and wait for the corresponding response.
+     * @param message - The DAP message to send
+     * @param timeout - Optional per-request timeout in ms. Overrides the default requestTimeout.
+     */
+    request(message: DAPMessage, timeout?: number): Promise<DAPMessage>;
+    /**
+     * Establish connection to the DAP server.
+     * When the transport exposes getAuth (e.g. task service), sends auth as the first DAP command
+     * and fails connect if authentication fails.
+     * @param timeout - Optional overall timeout in ms covering both the WebSocket handshake and auth request.
+     */
+    connect(timeout?: number): Promise<void>;
+    /**
+     * Close connection to the DAP server and clean up resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected to server.
+     */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=DAPClient.d.ts.map

package/dist/types/core/DAPClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DAPClient.d.ts","sourceRoot":"","sources":["../../../src/client/core/DAPClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAU,SAAQ,OAAO;IACrC,OAAO,CAAC,gBAAgB,CAInB;IACL,OAAO,CAAC,eAAe,CAAK;IAC5B,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;gBAEvB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,SAAS,EAAE,MAAM,GAAE,sBAA2B;IAKrG;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;cACa,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD;;OAEG;IACG,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtE;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnD;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqDzE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,WAAW,IAAI,OAAO;CAGtB"}

package/dist/types/core/TransportBase.d.ts

@@ -0,0 +1,113 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { DAPMessage, TransportCallbacks } from '../types';
+/**
+ * Abstract base class for DAP transport implementations.
+ *
+ * This class defines the standard interface that all transport implementations
+ * must follow for DAP communication. It provides common functionality for
+ * callback management, connection state tracking, and debug message routing.
+ *
+ * Concrete implementations must provide:
+ * - connect(): Establish the transport connection
+ * - disconnect(): Close the transport connection
+ * - send(): Transmit a DAP message
+ *
+ * @abstract This class must be extended by concrete transport implementations
+ */
+export declare abstract class TransportBase {
+    protected _connected: boolean;
+    protected _onCallerDebugMessage?: (message: string) => void;
+    protected _onCallerDebugProtocol?: (message: string) => void;
+    protected _onCallerReceive?: (message: DAPMessage) => Promise<void>;
+    protected _onCallerConnected?: (connectionInfo?: string) => Promise<void>;
+    protected _onCallerDisconnected?: (reason?: string, hasError?: boolean) => Promise<void>;
+    /**
+     * Send debug message to callback if available.
+     */
+    protected _debugMessage(message: string): void;
+    /**
+     * Send protocol debug message to callback if available.
+     */
+    protected _debugProtocol(message: string): void;
+    /**
+     * Forward received message to callback if available.
+     */
+    protected _transportReceive(message: DAPMessage): Promise<void>;
+    /**
+     * Connection info for the "connected" callback (e.g. URI). Default none.
+     */
+    getConnectionInfo(): string | undefined;
+    /**
+     * Notify about connection establishment.
+     */
+    protected _transportConnected(connectionInfo?: string): Promise<void>;
+    /**
+     * Notify about connection closure.
+     */
+    protected _transportDisconnected(reason?: string, hasError?: boolean): Promise<void>;
+    /**
+     * Bind callback functions to the transport.
+     *
+     * This must be called before using the transport for communication.
+     * The callbacks handle debugging, connection events, and message processing.
+     */
+    bind(callbacks: TransportCallbacks): void;
+    /**
+     * Auth credential for connect flow (e.g. first DAP auth command). Default none.
+     */
+    getAuth(): string | undefined;
+    /**
+     * Update auth credential. Takes effect on the next connect().
+     */
+    setAuth(_auth: string): void;
+    /**
+     * Update connection URI. Takes effect on the next connect().
+     */
+    setUri(_uri: string): void;
+    /**
+     * Check if the transport is currently connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Establish connection to remote endpoint (client-side).
+     * @param timeout - Optional connection timeout in milliseconds. Falls back to default when not provided.
+     */
+    connect(_timeout?: number): Promise<void>;
+    /**
+     * Accept incoming connection (server-side).
+     */
+    accept(_connectionInfo: unknown): Promise<void>;
+    /**
+     * Close connection and cleanup resources.
+     * @param reason - Optional reason for disconnection (reported to onDisconnected; e.g. auth failure message).
+     * @param hasError - Optional; when true, report this as an error to onDisconnected.
+     */
+    abstract disconnect(reason?: string, hasError?: boolean): Promise<void>;
+    /**
+     * Send a message over the transport.
+     */
+    abstract send(message: DAPMessage): Promise<void>;
+}
+//# sourceMappingURL=TransportBase.d.ts.map

package/dist/types/core/TransportBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportBase.d.ts","sourceRoot":"","sources":["../../../src/client/core/TransportBase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,8BAAsB,aAAa;IAClC,SAAS,CAAC,UAAU,UAAS;IAC7B,SAAS,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,SAAS,CAAC,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,SAAS,CAAC,kBAAkB,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,SAAS,CAAC,qBAAqB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM/C;;OAEG;cACa,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrE;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC;;OAEG;cACa,mBAAmB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E;;OAEG;cACa,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAkBzC;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAE5B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE1B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,MAAM,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CACjD"}

package/dist/types/core/TransportWebSocket.d.ts

@@ -0,0 +1,100 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { TransportBase } from './TransportBase';
+import { DAPMessage } from '../types';
+/**
+ * WebSocket transport implementation for DAP protocol communication.
+ *
+ * Provides WebSocket-based communication between RocketRide clients and servers
+ * with support for both text (JSON) and binary (CBOR) message formats. Handles
+ * connection lifecycle management, message serialization/deserialization, automatic
+ * heartbeat/ping messages, and connection timeout detection.
+ *
+ * Features:
+ * - Cross-platform: Works in both browser (native WebSocket) and Node.js (ws library)
+ * - Automatic message encoding/decoding (JSON and CBOR)
+ * - Connection timeout handling
+ * - Authentication via headers
+ * - Message queuing during connection
+ *
+ * @extends TransportBase
+ */
+export declare class TransportWebSocket extends TransportBase {
+    private _websocket?;
+    private _uri;
+    private _auth?;
+    private _messageTasks;
+    private _connectionTimeout?;
+    private _pingInterval?;
+    private _lastPong;
+    constructor(uri?: string, auth?: string);
+    /** Auth credential for use by connect flow (e.g. first DAP auth command). */
+    getAuth(): string | undefined;
+    /** Connection info for the "connected" callback (URI). */
+    getConnectionInfo(): string | undefined;
+    /** Update auth credential. Takes effect on the next connect(). */
+    setAuth(auth: string): void;
+    /** Update connection URI. Takes effect on the next connect(). */
+    setUri(uri: string): void;
+    /**
+     * Start ping interval for Node.js WebSocket connections.
+     * Sends ping frames at regular intervals and monitors for pong responses.
+     * If no pong is received within the timeout period, the connection is terminated.
+     */
+    private _startPingInterval;
+    /**
+     * Stop the ping interval timer.
+     */
+    private _stopPingInterval;
+    /**
+     * Process raw WebSocket data into structured messages.
+     *
+     * Handles both JSON text messages and DAP binary format messages.
+     * Binary messages use format: JSON header + newline + binary payload.
+     */
+    private _receiveData;
+    /**
+     * Connect to WebSocket server and start receiving messages.
+     * Works in both browser and Node.js environments.
+     */
+    connect(timeout?: number): Promise<void>;
+    /**
+     * Disconnect and close the WebSocket connection gracefully.
+     * Works in both browser and Node.js environments.
+     * @param reason - Optional reason for disconnection (reported to onDisconnected).
+     * @param hasError - Optional; when true, report as error to onDisconnected.
+     */
+    disconnect(reason?: string, hasError?: boolean): Promise<void>;
+    /**
+     * Send a DAP message with automatic format selection.
+     *
+     * Handles both standard JSON messages and DAP binary messages with
+     * data payloads. Automatically chooses appropriate WebSocket message
+     * format based on message content.
+     *
+     * Works in both browser and Node.js environments.
+     */
+    send(message: DAPMessage): Promise<void>;
+}
+//# sourceMappingURL=TransportWebSocket.d.ts.map

package/dist/types/core/TransportWebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportWebSocket.d.ts","sourceRoot":"","sources":["../../../src/client/core/TransportWebSocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA2CtC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACpD,OAAO,CAAC,UAAU,CAAC,CAA4B;IAC/C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,SAAS,CAAsB;gBAE3B,GAAG,SAAwB,EAAE,IAAI,CAAC,EAAE,MAAM;IAMtD,6EAA6E;IAC7E,OAAO,IAAI,MAAM,GAAG,SAAS;IAI7B,0DAA0D;IAC1D,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAE3B,iEAAiE;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAEzB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;;;OAKG;YACW,YAAY;IA6C1B;;;OAGG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwP9C;;;;;OAKG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgIpE;;;;;;;;OAQG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAoE9C"}

package/dist/types/exceptions/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2026 RocketRide, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Base exception class for Debug Adapter Protocol (DAP) errors.
+ *
+ * This exception wraps DAP error responses to provide structured access to
+ * error information including file locations, line numbers, and other
+ * contextual data returned by RocketRide servers.
+ */
+export declare class DAPException extends Error {
+    readonly dapResult: Record<string, unknown>;
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Base exception for all RocketRide operations.
+ *
+ * This is the root exception class for all RocketRide-specific errors.
+ * Catch this exception type to handle any error that originates from
+ * RocketRide operations while still having access to detailed error context.
+ */
+export declare class RocketRideException extends DAPException {
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Exception raised for connection-related issues.
+ *
+ * Raised when there are problems connecting to RocketRide servers,
+ * maintaining connections, or when connections are lost unexpectedly.
+ */
+export declare class ConnectionException extends RocketRideException {
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Exception raised when authentication fails (bad API key or credentials).
+ */
+export declare class AuthenticationException extends ConnectionException {
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Exception raised for data pipe operations.
+ *
+ * Raised when there are problems with data pipes used for sending
+ * data to pipelines, uploading files, or streaming operations.
+ */
+export declare class PipeException extends RocketRideException {
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Exception raised for pipeline execution issues.
+ *
+ * Raised when there are problems starting, running, or managing
+ * RocketRide pipelines and processing tasks.
+ */
+export declare class ExecutionException extends RocketRideException {
+    constructor(dapResult: Record<string, unknown>);
+}
+/**
+ * Exception raised for input validation failures.
+ *
+ * Raised when input data, configurations, or parameters don't meet
+ * the requirements for RocketRide operations.
+ */
+export declare class ValidationException extends RocketRideException {
+    constructor(dapResult: Record<string, unknown>);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/exceptions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACtC,SAAgB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM9C;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB;gBAC/C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;gBACnD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,mBAAmB;gBACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,mBAAmB;gBAC9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB;gBAC/C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9C"}