@n1xyz/nord-ts 0.0.18-8121ed05.0 → 0.0.19

package/dist/websocket/NordWebSocketClient.js

@@ -1,338 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NordWebSocketClient = void 0;
-const ws_1 = __importDefault(require("ws"));
-const events_1 = require("events");
-const types_1 = require("../types");
-const VALID_STREAM_TYPES = ["trades", "delta", "account"];
-// Constants for WebSocket readyState
-const WS_OPEN = 1;
-/**
- * WebSocket client for Nord exchange
- *
- * This client connects to one of the specific Nord WebSocket endpoints:
- *
- * Each endpoint handles a specific type of data and subscriptions must match
- * the endpoint type (e.g., only 'trades@BTCUSDC' subscriptions are valid on
- * the /ws/trades endpoint).
- */
-class NordWebSocketClient extends events_1.EventEmitter {
-    /**
-     * Create a new NordWebSocketClient
-     * @param url WebSocket server URL
-     */
-    constructor(url) {
-        super();
-        this.ws = null;
-        this.subscriptions = new Set();
-        this.reconnectAttempts = 0;
-        this.maxReconnectAttempts = 5;
-        this.reconnectDelay = 1000;
-        this.pingInterval = null;
-        this.pingTimeout = null;
-        this.url = url;
-        // Check if we're in a browser environment
-        // The most reliable way is to check for Node.js process
-        this.isBrowser =
-            typeof process === "undefined" ||
-                !process.versions ||
-                !process.versions.node;
-    }
-    /**
-     * Validate stream format
-     * @param stream Stream identifier to validate
-     * @throws Error if stream format is invalid
-     */
-    validateStream(stream) {
-        const [type, params] = stream.split("@");
-        if (!type || !params) {
-            throw new Error(`Invalid stream format: ${stream}. Expected format: <type>@<params>`);
-        }
-        // Extract the endpoint from the URL
-        const urlPath = new URL(this.url).pathname;
-        const endpoint = urlPath.split("/").pop();
-        // Ensure the stream type matches the endpoint we're connected to
-        if (endpoint && type !== endpoint) {
-            throw new Error(`Stream type '${type}' doesn't match the connected endpoint '${endpoint}'`);
-        }
-        if (!VALID_STREAM_TYPES.includes(type)) {
-            throw new Error(`Invalid stream type: ${type}. Valid types are: ${VALID_STREAM_TYPES.join(", ")}`);
-        }
-        if (type === "account" && !/^\d+$/.test(params)) {
-            throw new Error(`Invalid account ID in stream: ${params}. Expected numeric ID`);
-        }
-    }
-    /**
-     * Setup WebSocket ping/pong heartbeat
-     */
-    setupHeartbeat() {
-        if (this.pingInterval) {
-            clearInterval(this.pingInterval);
-        }
-        if (this.pingTimeout) {
-            clearTimeout(this.pingTimeout);
-        }
-        // In browser, we rely on the browser's WebSocket implementation to handle ping/pong
-        if (this.isBrowser) {
-            return;
-        }
-        this.pingInterval = setInterval(() => {
-            if (this.ws && !this.isBrowser) {
-                // Only use ping() method in Node.js environment
-                this.ws.ping();
-                // Set timeout for pong response
-                this.pingTimeout = setTimeout(() => {
-                    this.emit("error", new Error("WebSocket ping timeout"));
-                    this.close();
-                    this.reconnect();
-                }, 5000); // 5 second timeout
-            }
-        }, 30000); // Send ping every 30 seconds
-    }
-    /**
-     * Get the appropriate WebSocket class based on environment
-     */
-    getWebSocketClass() {
-        if (this.isBrowser) {
-            // In browser environments
-            if (typeof globalThis !== "undefined" && globalThis.WebSocket) {
-                return globalThis.WebSocket;
-            }
-            throw new Error("WebSocket is not available in this environment");
-        }
-        else {
-            // In Node.js
-            return ws_1.default;
-        }
-    }
-    /**
-     * Connect to the Nord WebSocket server
-     */
-    connect() {
-        if (this.ws) {
-            return;
-        }
-        try {
-            const WebSocketClass = this.getWebSocketClass();
-            if (this.isBrowser) {
-                // Browser WebSocket setup
-                this.ws = new WebSocketClass(this.url);
-                this.ws.onopen = () => {
-                    this.emit("connected");
-                    this.reconnectAttempts = 0;
-                    this.reconnectDelay = 1000;
-                    // Resubscribe to previous subscriptions
-                    if (this.subscriptions.size > 0) {
-                        this.subscribe([...this.subscriptions]);
-                    }
-                };
-                this.ws.onmessage = (event) => {
-                    try {
-                        const message = JSON.parse(event.data);
-                        this.handleMessage(message);
-                    }
-                    catch (error) {
-                        this.emit("error", new Error(`Failed to parse message: ${error instanceof Error ? error.message : String(error)}`));
-                    }
-                };
-                this.ws.onclose = (event) => {
-                    const reason = event && event.reason ? ` Reason: ${event.reason}` : "";
-                    const code = event && event.code ? ` Code: ${event.code}` : "";
-                    this.emit("disconnected");
-                    console.log(`WebSocket closed.${code}${reason}`);
-                    this.reconnect();
-                };
-                this.ws.onerror = (event) => {
-                    const errorMsg = `WebSocket error: ${event && event.type ? event.type : "unknown"}`;
-                    console.error(errorMsg, event);
-                    this.emit("error", new Error(errorMsg));
-                };
-            }
-            else {
-                // Node.js WebSocket setup
-                const nodeWs = new WebSocketClass(this.url);
-                this.ws = nodeWs;
-                nodeWs.on("open", () => {
-                    this.emit("connected");
-                    this.reconnectAttempts = 0;
-                    this.reconnectDelay = 1000;
-                    this.setupHeartbeat();
-                    // Resubscribe to previous subscriptions
-                    if (this.subscriptions.size > 0) {
-                        this.subscribe([...this.subscriptions]);
-                    }
-                });
-                nodeWs.on("message", (data) => {
-                    try {
-                        const message = JSON.parse(data.toString());
-                        this.handleMessage(message);
-                    }
-                    catch (error) {
-                        this.emit("error", new Error(`Failed to parse message: ${error instanceof Error ? error.message : String(error)}`));
-                    }
-                });
-                nodeWs.on("close", (code, reason) => {
-                    this.emit("disconnected");
-                    console.log(`WebSocket closed. Code: ${code} Reason: ${reason}`);
-                    if (this.pingInterval) {
-                        clearInterval(this.pingInterval);
-                    }
-                    if (this.pingTimeout) {
-                        clearTimeout(this.pingTimeout);
-                    }
-                    this.reconnect();
-                });
-                nodeWs.on("error", (error) => {
-                    console.error("WebSocket error:", error);
-                    this.emit("error", error);
-                });
-                nodeWs.on("pong", () => {
-                    if (this.pingTimeout) {
-                        clearTimeout(this.pingTimeout);
-                    }
-                });
-            }
-        }
-        catch (error) {
-            const errorMsg = `Failed to initialize WebSocket: ${error instanceof Error ? error.message : String(error)}`;
-            console.error(errorMsg);
-            this.emit("error", new Error(errorMsg));
-        }
-    }
-    /**
-     * Subscribe to one or more streams
-     * @param streams Array of streams to subscribe to (e.g. ["trades@BTCUSDC", "deltas@BTCUSDC"])
-     */
-    subscribe(streams) {
-        // Validate all streams first
-        try {
-            streams.forEach((stream) => this.validateStream(stream));
-        }
-        catch (error) {
-            this.emit("error", error instanceof Error ? error : new Error(String(error)));
-            return;
-        }
-        if (!this.ws ||
-            (this.isBrowser
-                ? this.ws.readyState !== WS_OPEN
-                : this.ws.readyState !== ws_1.default.OPEN)) {
-            streams.forEach((stream) => this.subscriptions.add(stream));
-            return;
-        }
-        const message = {
-            e: types_1.WebSocketMessageType.Subscribe,
-            streams,
-        };
-        try {
-            const messageStr = JSON.stringify(message);
-            if (this.isBrowser) {
-                this.ws.send(messageStr);
-            }
-            else {
-                this.ws.send(messageStr);
-            }
-            streams.forEach((stream) => this.subscriptions.add(stream));
-        }
-        catch (error) {
-            this.emit("error", error instanceof Error ? error : new Error(String(error)));
-        }
-    }
-    /**
-     * Unsubscribe from one or more streams
-     * @param streams Array of streams to unsubscribe from
-     */
-    unsubscribe(streams) {
-        // Validate all streams first
-        try {
-            streams.forEach((stream) => this.validateStream(stream));
-        }
-        catch (error) {
-            this.emit("error", error instanceof Error ? error : new Error(String(error)));
-            return;
-        }
-        if (!this.ws ||
-            (this.isBrowser
-                ? this.ws.readyState !== WS_OPEN
-                : this.ws.readyState !== ws_1.default.OPEN)) {
-            streams.forEach((stream) => this.subscriptions.delete(stream));
-            return;
-        }
-        const message = {
-            e: types_1.WebSocketMessageType.Unsubscribe,
-            streams,
-        };
-        try {
-            const messageStr = JSON.stringify(message);
-            if (this.isBrowser) {
-                this.ws.send(messageStr);
-            }
-            else {
-                this.ws.send(messageStr);
-            }
-            streams.forEach((stream) => this.subscriptions.delete(stream));
-        }
-        catch (error) {
-            this.emit("error", error instanceof Error ? error : new Error(String(error)));
-        }
-    }
-    /**
-     * Close the WebSocket connection
-     */
-    close() {
-        if (this.ws) {
-            if (this.isBrowser) {
-                this.ws.close();
-            }
-            else {
-                this.ws.close();
-            }
-            this.ws = null;
-        }
-        if (this.pingInterval) {
-            clearInterval(this.pingInterval);
-            this.pingInterval = null;
-        }
-        if (this.pingTimeout) {
-            clearTimeout(this.pingTimeout);
-            this.pingTimeout = null;
-        }
-        this.subscriptions.clear();
-    }
-    /**
-     * Handle incoming WebSocket messages
-     * @param message WebSocket message
-     */
-    handleMessage(message) {
-        switch (message.e) {
-            case types_1.WebSocketMessageType.TradeUpdate:
-                this.emit("trades", message);
-                break;
-            case types_1.WebSocketMessageType.DeltaUpdate:
-                this.emit("delta", message);
-                break;
-            case types_1.WebSocketMessageType.AccountUpdate:
-                this.emit("account", message);
-                break;
-            default:
-                this.emit("error", new Error(`Unknown message type: ${message.e}`));
-        }
-    }
-    /**
-     * Attempt to reconnect to the WebSocket server
-     */
-    reconnect() {
-        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
-            this.emit("error", new Error("Max reconnection attempts reached"));
-            return;
-        }
-        setTimeout(() => {
-            this.reconnectAttempts++;
-            this.reconnectDelay *= 2; // Exponential backoff
-            this.connect();
-        }, this.reconnectDelay);
-    }
-}
-exports.NordWebSocketClient = NordWebSocketClient;

package/dist/websocket/events.d.ts

@@ -1,19 +0,0 @@
-import { WebSocketTradeUpdate, WebSocketDeltaUpdate, WebSocketAccountUpdate } from "../types";
-/**
- * Event type definitions for the NordWebSocketClient
- */
-export interface NordWebSocketEvents {
-    connected: () => void;
-    disconnected: () => void;
-    error: (error: Error) => void;
-    trade: (update: WebSocketTradeUpdate) => void;
-    delta: (update: WebSocketDeltaUpdate) => void;
-    account: (update: WebSocketAccountUpdate) => void;
-}
-/**
- * Type declaration for NordWebSocketClient event methods
- */
-export declare interface NordWebSocketClientEvents {
-    on<E extends keyof NordWebSocketEvents>(event: E, listener: NordWebSocketEvents[E]): this;
-    emit<E extends keyof NordWebSocketEvents>(event: E, ...args: Parameters<NordWebSocketEvents[E]>): boolean;
-}

package/dist/websocket/events.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/websocket/index.d.ts

@@ -1,2 +0,0 @@
-export { NordWebSocketClient } from "./NordWebSocketClient";
-export { NordWebSocketEvents, NordWebSocketClientEvents } from "./events";

package/dist/websocket/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NordWebSocketClient = void 0;
-var NordWebSocketClient_1 = require("./NordWebSocketClient");
-Object.defineProperty(exports, "NordWebSocketClient", { enumerable: true, get: function () { return NordWebSocketClient_1.NordWebSocketClient; } });

package/jest.config.ts

@@ -1,9 +0,0 @@
-import type {Config} from '@jest/types';
-// Sync object
-const config: Config.InitialOptions = {
-  verbose: true,
-  transform: {
-    "^.+\\.tsx?$": "ts-jest",
-  },
-};
-export default config;

package/nodemon.json

@@ -1,4 +0,0 @@
-{
-  "watch": ["src", "tests"],
-  "ext": "js, ts"
-}

package/protoc-generate.sh

@@ -1,23 +0,0 @@
-#!/bin/sh
-
-SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
-PROTO_PATH="${SCRIPT_DIR}/../engine/nord.proto"
-PROTO_INCLUE_PATH="${SCRIPT_DIR}/.."
-PLUGIN_PATH="${SCRIPT_DIR}/node_modules/.bin/protoc-gen-ts_proto"
-OUT_DIR="${SCRIPT_DIR}/src/gen"
-
-# Clean all existing generated files
-rm -rf "${OUT_DIR}"
-mkdir "${OUT_DIR}"
-
-# Generate all messages
-protoc \
-    --plugin="${PLUGIN_PATH}" \
-    --ts_proto_opt=forceLong=bigint \
-    --ts_proto_opt=esModuleInterop=true \
-    --ts_proto_opt=oneof=unions-value \
-    --ts_proto_opt=unrecognizedEnum=false \
-    --ts_proto_out="${OUT_DIR}" \
-    --proto_path="$(dirname "${PROTO_PATH}")" \
-    --proto_path="${PROTO_INCLUE_PATH}" \
-    "${PROTO_PATH}"