rocketride 1.0.0

package/dist/cjs/core/DAPClient.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAPClient = void 0;
+const DAPBase_1 = require("./DAPBase");
+const exceptions_1 = require("../exceptions");
+/**
+ * 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
+ */
+class DAPClient extends DAPBase_1.DAPBase {
+    constructor(module, transport, config = {}) {
+        super(module, transport, config);
+        this._pendingRequests = new Map();
+        this._sequenceNumber = 0;
+        this._requestTimeout = config.requestTimeout;
+    }
+    /**
+     * Generate the next sequence number for outgoing requests.
+     */
+    getNextSeq() {
+        return ++this._sequenceNumber;
+    }
+    /**
+     * Send a message to the DAP server through the transport layer.
+     */
+    async _send(message) {
+        if (!this._transport) {
+            throw new Error('Transport not available');
+        }
+        return this._transport.send(message);
+    }
+    /**
+     * Handle connection established event.
+     */
+    async onConnected(connectionInfo) {
+        await super.onConnected(connectionInfo);
+    }
+    /**
+     * Handle connection attempt failure.
+     */
+    async onConnectError(error) {
+        await super.onConnectError(error);
+    }
+    /**
+     * Handle disconnection event and clean up pending requests.
+     */
+    async onDisconnected(reason, hasError = false) {
+        // Fail all pending requests since connection is lost
+        const connectionError = new Error(reason || 'Connection lost');
+        for (const [, request] of this._pendingRequests) {
+            if (request.timer)
+                clearTimeout(request.timer);
+            request.reject(connectionError);
+        }
+        // Clear pending requests
+        this._pendingRequests.clear();
+        // Notify parent classes
+        await super.onDisconnected(reason, hasError);
+    }
+    /**
+     * Handle received messages from the transport layer.
+     */
+    async onReceive(message) {
+        const messageType = message.type;
+        if (messageType === 'response') {
+            // Handle response correlation
+            const requestSeq = message.request_seq;
+            if (requestSeq !== undefined && this._pendingRequests.has(requestSeq)) {
+                const pendingRequest = this._pendingRequests.get(requestSeq);
+                this._pendingRequests.delete(requestSeq);
+                if (pendingRequest.timer)
+                    clearTimeout(pendingRequest.timer);
+                pendingRequest.resolve(message);
+            }
+            else {
+                this.debugMessage(`Response received for unknown request: ${JSON.stringify(message)}`);
+            }
+        }
+        else if (messageType === 'event') {
+            // Forward events to event handler
+            await this.onEvent(message);
+        }
+        else {
+            // Unknown message type
+            this.debugMessage(`Unhandled message type: ${JSON.stringify(message)}`);
+        }
+    }
+    /**
+     * 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.
+     */
+    async request(message, timeout) {
+        // Validate required fields
+        if (!message.command) {
+            this.raiseException(new Error("Request message must include a 'command' field"));
+        }
+        if (!message.type) {
+            this.raiseException(new Error("Request message must include a 'type' field"));
+        }
+        // Verify connection
+        if (!this._transport?.isConnected()) {
+            this.raiseException(new Error('Server is not connected'));
+        }
+        // Generate sequence number for this request
+        const seq = this.getNextSeq();
+        message.seq = seq;
+        // Create promise for response correlation
+        return new Promise((resolve, reject) => {
+            const entry = { resolve, reject };
+            // Set up request timeout if configured
+            const effectiveTimeout = timeout ?? this._requestTimeout;
+            if (effectiveTimeout) {
+                entry.timer = setTimeout(() => {
+                    if (this._pendingRequests.has(seq)) {
+                        this._pendingRequests.delete(seq);
+                        reject(new Error(`Request timed out after ${effectiveTimeout}ms`));
+                    }
+                }, effectiveTimeout);
+            }
+            // Store the resolve/reject functions for later use
+            this._pendingRequests.set(seq, entry);
+            // Send request through transport
+            this._send(message)
+                .catch(_error => {
+                this.debugMessage(`Clearing request due to error: ${seq}`);
+                // Clean up on send failure
+                if (this._pendingRequests.has(seq)) {
+                    const pending = this._pendingRequests.get(seq);
+                    if (pending.timer)
+                        clearTimeout(pending.timer);
+                    this._pendingRequests.delete(seq);
+                }
+                reject(new Error('Could not send request'));
+            });
+        });
+    }
+    /**
+     * 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.
+     */
+    async connect(timeout) {
+        if (!this._transport) {
+            throw new Error('Transport not configured');
+        }
+        // Track elapsed time so remaining budget can be passed to the auth request
+        const start = timeout !== undefined ? Date.now() : 0;
+        // Establish transport connection (socket open; no auth on the wire)
+        await this._transport.connect(timeout);
+        // Calculate remaining timeout for auth request
+        let authTimeout;
+        if (timeout !== undefined) {
+            const elapsed = Date.now() - start;
+            authTimeout = Math.max(timeout - elapsed, 0);
+        }
+        // First DAP message must be auth
+        const auth = this._transport.getAuth() ?? '';
+        const resp = await this.request({
+            type: 'request',
+            command: 'auth',
+            seq: 0, // request() overwrites with next seq
+            arguments: { auth },
+        }, authTimeout);
+        const success = resp.success;
+        if (!success) {
+            await this._transport.disconnect(resp.message ?? 'Authentication failed', true);
+            throw new exceptions_1.AuthenticationException(resp);
+        }
+        // Only now notify connected (transport resolved on socket open; callback runs after auth)
+        const connectionInfo = this._transport.getConnectionInfo();
+        await this.onConnected(connectionInfo);
+    }
+    /**
+     * Close connection to the DAP server and clean up resources.
+     */
+    async disconnect() {
+        // Close transport connection
+        if (this._transport) {
+            await this._transport.disconnect();
+        }
+    }
+    /**
+     * Check if connected to server.
+     */
+    isConnected() {
+        return this._transport?.isConnected() || false;
+    }
+}
+exports.DAPClient = DAPClient;
+//# sourceMappingURL=DAPClient.js.map

package/dist/cjs/core/DAPClient.js.map

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

package/dist/cjs/core/TransportBase.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportBase = void 0;
+/**
+ * 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
+ */
+class TransportBase {
+    constructor() {
+        this._connected = false;
+    }
+    /**
+     * Send debug message to callback if available.
+     */
+    _debugMessage(message) {
+        if (this._onCallerDebugMessage) {
+            this._onCallerDebugMessage(message);
+        }
+    }
+    /**
+     * Send protocol debug message to callback if available.
+     */
+    _debugProtocol(message) {
+        if (this._onCallerDebugProtocol) {
+            this._onCallerDebugProtocol(message);
+        }
+    }
+    /**
+     * Forward received message to callback if available.
+     */
+    async _transportReceive(message) {
+        this._debugProtocol(`RECV: ${JSON.stringify(message)}`);
+        if (this._onCallerReceive) {
+            await this._onCallerReceive(message);
+        }
+    }
+    /**
+     * Connection info for the "connected" callback (e.g. URI). Default none.
+     */
+    getConnectionInfo() {
+        return undefined;
+    }
+    /**
+     * Notify about connection establishment.
+     */
+    async _transportConnected(connectionInfo) {
+        this._debugMessage(`Connected, info=${connectionInfo}`);
+        if (this._onCallerConnected) {
+            await this._onCallerConnected(connectionInfo);
+        }
+    }
+    /**
+     * Notify about connection closure.
+     */
+    async _transportDisconnected(reason, hasError = false) {
+        this._debugMessage(`Disconnected, reason=${reason}, error=${hasError}`);
+        if (this._onCallerDisconnected) {
+            await this._onCallerDisconnected(reason, hasError);
+        }
+    }
+    /**
+     * 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) {
+        if (callbacks.onDebugMessage) {
+            this._onCallerDebugMessage = callbacks.onDebugMessage;
+        }
+        if (callbacks.onDebugProtocol) {
+            this._onCallerDebugProtocol = callbacks.onDebugProtocol;
+        }
+        if (callbacks.onReceive) {
+            this._onCallerReceive = callbacks.onReceive;
+        }
+        if (callbacks.onConnected) {
+            this._onCallerConnected = callbacks.onConnected;
+        }
+        if (callbacks.onDisconnected) {
+            this._onCallerDisconnected = callbacks.onDisconnected;
+        }
+    }
+    /**
+     * Auth credential for connect flow (e.g. first DAP auth command). Default none.
+     */
+    getAuth() {
+        return undefined;
+    }
+    /**
+     * Update auth credential. Takes effect on the next connect().
+     */
+    setAuth(_auth) { }
+    /**
+     * Update connection URI. Takes effect on the next connect().
+     */
+    setUri(_uri) { }
+    /**
+     * Check if the transport is currently connected.
+     */
+    isConnected() {
+        return this._connected;
+    }
+    /**
+     * Establish connection to remote endpoint (client-side).
+     * @param timeout - Optional connection timeout in milliseconds. Falls back to default when not provided.
+     */
+    async connect(_timeout) {
+        // Default implementation - override in concrete classes
+    }
+    /**
+     * Accept incoming connection (server-side).
+     */
+    async accept(_connectionInfo) {
+        // Default implementation - override in concrete classes
+    }
+}
+exports.TransportBase = TransportBase;
+//# sourceMappingURL=TransportBase.js.map

package/dist/cjs/core/TransportBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportBase.js","sourceRoot":"","sources":["../../../src/client/core/TransportBase.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAsB,aAAa;IAAnC;QACW,eAAU,GAAG,KAAK,CAAC;IAwI9B,CAAC;IAjIA;;OAEG;IACO,aAAa,CAAC,OAAe;QACtC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,OAAe;QACvC,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACjC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,iBAAiB,CAAC,OAAmB;QACpD,IAAI,CAAC,cAAc,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;IAED;;OAEG;IACH,iBAAiB;QAChB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,mBAAmB,CAAC,cAAuB;QAC1D,IAAI,CAAC,aAAa,CAAC,mBAAmB,cAAc,EAAE,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,sBAAsB,CAAC,MAAe,EAAE,QAAQ,GAAG,KAAK;QACvE,IAAI,CAAC,aAAa,CAAC,wBAAwB,MAAM,WAAW,QAAQ,EAAE,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAA6B;QACjC,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC,cAAc,CAAC;QACvD,CAAC;QACD,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;YAC/B,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC,eAAe,CAAC;QACzD,CAAC;QACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,SAAS,CAAC;QAC7C,CAAC;QACD,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAC3B,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC,WAAW,CAAC;QACjD,CAAC;QACD,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC,cAAc,CAAC;QACvD,CAAC;IACF,CAAC;IAED;;OAEG;IACH,OAAO;QACN,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa,IAAU,CAAC;IAEhC;;OAEG;IACH,MAAM,CAAC,IAAY,IAAU,CAAC;IAE9B;;OAEG;IACH,WAAW;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,QAAiB;QAC9B,wDAAwD;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,eAAwB;QACpC,wDAAwD;IACzD,CAAC;CAaD;AAzID,sCAyIC"}