@n1xyz/nord-ts 0.1.6 → 0.1.8

package/dist/websocket/NordWebSocketClient.js

@@ -1,11 +1,5 @@
-"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 events_1 = require("events");
-const ws_1 = __importDefault(require("ws"));
+import { EventEmitter } from "events";
+import WebSocket from "ws";
 const VALID_STREAM_TYPES = ["trades", "delta", "account"];
 /**
  * WebSocket client for Nord exchange
@@ -16,19 +10,21 @@ const VALID_STREAM_TYPES = ["trades", "delta", "account"];
  * the endpoint type (e.g., only 'trades@BTCUSDC' subscriptions are valid on
  * the /ws/trades endpoint).
  */
-class NordWebSocketClient extends events_1.EventEmitter {
+export class NordWebSocketClient extends EventEmitter {
+    ws = null;
+    url;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    reconnectDelay = 1000;
+    pingInterval = null;
+    pingTimeout = null;
+    isBrowser;
     /**
      * Create a new NordWebSocketClient
      * @param url WebSocket server URL
      */
     constructor(url) {
         super();
-        this.ws = null;
-        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
@@ -101,7 +97,7 @@ class NordWebSocketClient extends events_1.EventEmitter {
         }
         else {
             // In Node.js
-            return ws_1.default;
+            return WebSocket;
         }
     }
     /**
@@ -244,4 +240,3 @@ class NordWebSocketClient extends events_1.EventEmitter {
         }, this.reconnectDelay);
     }
 }
-exports.NordWebSocketClient = NordWebSocketClient;

package/dist/{nord/models → websocket}/Subscriber.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "events";
-import { Account, DeltaEvent, OrderbookResponse, SubscriberConfig, StreamTrade, Trades } from "../../types";
+import { Account, DeltaEvent, OrderbookResponse, SubscriberConfig, StreamTrade, Trades } from "../types";
 /**
  * Subscriber class for handling WebSocket subscriptions
  */

package/dist/{nord/models → websocket}/Subscriber.js

@@ -1,11 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Subscriber = void 0;
-const utils_1 = require("../../utils");
+import { MAX_BUFFER_LEN } from "../utils";
 /**
  * Subscriber class for handling WebSocket subscriptions
  */
-class Subscriber {
+export class Subscriber {
+    streamURL;
+    buffer;
+    maxBufferLen;
     /**
      * Create a new Subscriber instance
      * @param config Subscriber configuration
@@ -13,7 +13,7 @@ class Subscriber {
     constructor(config) {
         this.streamURL = config.streamURL;
         this.buffer = [];
-        this.maxBufferLen = config.maxBufferLen ?? utils_1.MAX_BUFFER_LEN;
+        this.maxBufferLen = config.maxBufferLen ?? MAX_BUFFER_LEN;
     }
     /**
      * Subscribe to WebSocket events
@@ -22,4 +22,3 @@ class Subscriber {
         // TODO: Implement subscription logic
     }
 }
-exports.Subscriber = Subscriber;

package/dist/websocket/events.js

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

package/dist/websocket/index.d.ts

@@ -1,2 +1,19 @@
-export { NordWebSocketClient } from "./NordWebSocketClient";
-export type { NordWebSocketEvents, NordWebSocketClientEvents } from "./events";
+import { NordWebSocketClient } from "./NordWebSocketClient";
+import type { SubscriptionPattern } from "../types";
+import type { NordWebSocketEvents, NordWebSocketClientEvents } from "./events";
+import { Subscriber } from "./Subscriber";
+export { NordWebSocketClient, NordWebSocketEvents, NordWebSocketClientEvents, Subscriber, };
+/**
+ * Initialize a WebSocket client for Nord
+ *
+ * Connects to the Nord WebSocket endpoint with support for multiple subscription types:
+ * - trades@SYMBOL - For trade updates
+ * - deltas@SYMBOL - For orderbook delta updates
+ * - account@ACCOUNT_ID - For user-specific updates
+ *
+ * @param webServerUrl - Base URL for the Nord web server
+ * @param subscriptions - Array of subscriptions (e.g., ["trades@BTCUSDC", "deltas@BTCUSDC", "account@42"])
+ * @returns WebSocket client
+ * @throws {NordError} If initialization fails or invalid subscription is provided
+ */
+export declare function initWebSocketClient(webServerUrl: string, subscriptions?: SubscriptionPattern[] | "trades" | "delta" | "account"): NordWebSocketClient;

package/dist/websocket/index.js

@@ -1,5 +1,80 @@
-"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; } });
+import { NordWebSocketClient } from "./NordWebSocketClient";
+import { NordError } from "../error";
+import { Subscriber } from "./Subscriber";
+export { NordWebSocketClient, Subscriber, };
+/**
+ * Initialize a WebSocket client for Nord
+ *
+ * Connects to the Nord WebSocket endpoint with support for multiple subscription types:
+ * - trades@SYMBOL - For trade updates
+ * - deltas@SYMBOL - For orderbook delta updates
+ * - account@ACCOUNT_ID - For user-specific updates
+ *
+ * @param webServerUrl - Base URL for the Nord web server
+ * @param subscriptions - Array of subscriptions (e.g., ["trades@BTCUSDC", "deltas@BTCUSDC", "account@42"])
+ * @returns WebSocket client
+ * @throws {NordError} If initialization fails or invalid subscription is provided
+ */
+export function initWebSocketClient(webServerUrl, subscriptions) {
+    try {
+        // Determine URL and subscriptions based on parameters
+        let wsUrl = webServerUrl.replace(/^http/, "ws") + `/ws`;
+        // Validate subscriptions parameter
+        if (typeof subscriptions === "string") {
+            // Legacy mode - handle endpoint string
+            if (subscriptions === "trades" ||
+                subscriptions === "delta" ||
+                subscriptions === "account") {
+                wsUrl += `/${subscriptions}`;
+            }
+            else {
+                throw new NordError(`Invalid endpoint: ${subscriptions}. Must be "trades", "deltas", or "account".`);
+            }
+        }
+        else if (Array.isArray(subscriptions) && subscriptions.length > 0) {
+            // New mode - validate and combine subscriptions in URL
+            subscriptions.forEach(validateSubscription);
+            wsUrl += `/${subscriptions.join("&")}`;
+        }
+        else {
+            // Default to trades endpoint if no subscriptions specified
+            wsUrl += `/trades`;
+        }
+        console.log(`Initializing WebSocket client with URL: ${wsUrl}`);
+        // Create and connect the WebSocket client
+        const ws = new NordWebSocketClient(wsUrl);
+        // Add error handler
+        ws.on("error", (error) => {
+            console.error("Nord WebSocket error:", error);
+        });
+        // Add connected handler for debugging
+        ws.on("connected", () => {
+            console.log("Nord WebSocket connected successfully");
+        });
+        // Connect the WebSocket
+        ws.connect();
+        return ws;
+    }
+    catch (error) {
+        console.error("Failed to initialize WebSocket client:", error);
+        throw new NordError("Failed to initialize WebSocket client", {
+            cause: error,
+        });
+    }
+}
+/**
+ * Validates a subscription string follows the correct format
+ *
+ * @param subscription - The subscription to validate
+ * @throws {NordError} If the subscription format is invalid
+ */
+function validateSubscription(subscription) {
+    const [type, param] = subscription.split("@");
+    if (!type || !param || !["trades", "deltas", "account"].includes(type)) {
+        throw new NordError(`Invalid subscription format: ${subscription}. Expected format: "trades@SYMBOL", "deltas@SYMBOL", or "account@ID"`);
+    }
+    // Additional validation for account subscriptions
+    if (type === "account" && isNaN(Number(param))) {
+        throw new NordError(`Invalid account ID in subscription: ${subscription}. Account ID must be a number.`);
+    }
+}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@n1xyz/nord-ts",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Typescript for Nord",
   "keywords": [],
   "author": "",
   "license": "ISC",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist/",
-    "src/",
     "package.json",
     "README.md"
   ],
@@ -30,7 +30,6 @@
     "@bufbuild/protoplugin": "^2.6.3",
     "@types/bun": "latest",
     "@types/google-protobuf": "^3.15.12",
-    "@types/node": "^22.17.1",
     "@types/node-fetch": "^2.6.13",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.39.1",

package/dist/api/client.d.ts

@@ -1,14 +0,0 @@
-import type { paths } from "../gen/openapi";
-export interface ClientConfig {
-    baseUrl: string;
-}
-export declare function createApiClient(config: ClientConfig): import("openapi-fetch").Client<paths, `${string}/${string}`>;
-export declare function handleApiResponse<T>(response: Promise<{
-    data: T;
-    error?: unknown;
-    response: Response;
-} | {
-    data?: never;
-    error?: unknown;
-    response: Response;
-}>): Promise<T>;

package/dist/api/client.js

@@ -1,45 +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.createApiClient = createApiClient;
-exports.handleApiResponse = handleApiResponse;
-const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
-const NordError_1 = require("../nord/utils/NordError");
-function createApiClient(config) {
-    const client = (0, openapi_fetch_1.default)({
-        baseUrl: config.baseUrl,
-    });
-    client.use({
-        onResponse({ response }) {
-            if (!response.ok) {
-                throw new NordError_1.NordError(`HTTP ${response.status}: ${response.statusText}`, {
-                    statusCode: response.status,
-                    details: { url: response.url }
-                });
-            }
-            return response;
-        },
-    });
-    return client;
-}
-async function handleApiResponse(response) {
-    const result = await response;
-    if (result.error || !result.response.ok) {
-        const errorMessage = result.error
-            ? `HTTP ${result.response.status}: ${result.response.statusText}`
-            : `Request failed: ${result.response.statusText}`;
-        throw new NordError_1.NordError(errorMessage, {
-            statusCode: result.response.status,
-            details: { url: result.response.url }
-        });
-    }
-    if (!('data' in result)) {
-        throw new NordError_1.NordError("No data in response", {
-            statusCode: 500,
-            details: { url: result.response.url }
-        });
-    }
-    return result.data;
-}

package/dist/bridge/client.d.ts

@@ -1,151 +0,0 @@
-import * as anchor from "@coral-xyz/anchor";
-import { AnchorProvider } from "@coral-xyz/anchor";
-import { Connection, Keypair, PublicKey } from "@solana/web3.js";
-import { BlockFacts, DepositSplParams, PdaSeedType, SolanaBridgeConfig, WithdrawalParams } from "./types";
-/**
- * Solana Bridge Client for interacting with the bridge program
- */
-export declare class SolanaBridgeClient {
-    /** Anchor program instance */
-    program: any;
-    /** Solana connection */
-    connection: Connection;
-    /** Program ID */
-    programId: PublicKey;
-    /** Configuration */
-    config: SolanaBridgeConfig;
-    /** Anchor provider */
-    provider: AnchorProvider;
-    bridge: PublicKey;
-    /**
-     * Create a new Solana Bridge Client
-     *
-     * @param config Bridge configuration
-     * @param wallet Anchor wallet for signing transactions
-     */
-    constructor(config: SolanaBridgeConfig, wallet: anchor.Wallet);
-    /**
-     * Derive a PDA (Program Derived Address) for the given seeds
-     *
-     * Seeds can be of type:
-     * - Buffer: raw bytes
-     * - PublicKey: Solana public key
-     * - string: string encoded as UTF-8 bytes
-     * - number: u64 encoded as little-endian 8 bytes
-     *
-     * @param type PDA seed type
-     * @param seeds Additional seeds
-     * @returns [PDA, bump]
-     */
-    findPda(type: PdaSeedType, ...seeds: any[]): Promise<[PublicKey, number]>;
-    /**
-     * Find the asset config PDA for a token mint
-     *
-     * @param mint Token mint address
-     * @returns [PDA, bump]
-     */
-    findAssetConfigPda(mint: PublicKey): Promise<[PublicKey, number]>;
-    /**
-     * Find the deposit storage PDA for a deposit index
-     *
-     * @param depositIndex Deposit index
-     * @returns [PDA, bump]
-     */
-    findDepositStoragePda(depositIndex: number): Promise<[PublicKey, number]>;
-    /**
-     * Find the block storage PDA for a block ID
-     *
-     * @param blockId Block ID
-     * @returns [PDA, bump]
-     */
-    findBlockStoragePda(blockId: number): Promise<[PublicKey, number]>;
-    /**
-     * Find the withdrawal nullifier PDA
-     *
-     * @param blockId Block ID
-     * @param leafIndex Leaf index
-     * @returns [PDA, bump]
-     */
-    findWithdrawalNullifierPda(blockId: number, leafIndex: number): Promise<[PublicKey, number]>;
-    /**
-     * Find the authority PDA
-     *
-     * @returns [PDA, bump]
-     */
-    findAuthorityPda(): Promise<[PublicKey, number]>;
-    /**
-     * Helper method to sign and send a transaction
-     *
-     * @param transaction Transaction to sign and send
-     * @param signers Additional signers (beyond the provider's wallet)
-     * @returns Transaction signature
-     */
-    private signAndSendTransaction;
-    /**
-     * Deposit SPL tokens to the bridge
-     *
-     * @param params Deposit parameters
-     * @param signer Signer keypair
-     * @returns Transaction signature
-     */
-    depositSpl(params: DepositSplParams): Promise<string>;
-    /**
-     * Withdraw tokens from the bridge
-     *
-     * @param params Withdrawal parameters
-     * @param signer Signer keypair
-     * @returns Transaction signature
-     */
-    withdraw(params: WithdrawalParams, signer: Keypair): Promise<string>;
-    /**
-     * Whitelist an asset (token) for use with the bridge
-     *
-     * @param mint Token mint address
-     * @param signer Operator keypair
-     * @returns Transaction signature
-     */
-    whitelistAsset(mint: PublicKey, signer: Keypair): Promise<string>;
-    /**
-     * Propose a new block
-     *
-     * @param facts Block facts
-     * @param signer Operator keypair
-     * @returns Transaction signature
-     */
-    proposeBlock(facts: BlockFacts, signer: Keypair): Promise<string>;
-    /**
-     * Finalize a block
-     *
-     * @param blockId Block ID
-     * @param stateUpdateId State update ID
-     * @param signer Payer keypair
-     * @returns Transaction signature
-     */
-    finalizeBlock(blockId: number, stateUpdateId: number, signer: Keypair): Promise<string>;
-    /**
-     * Finalize a DA fact
-     *
-     * @param fact DA fact (32-byte array)
-     * @param signer Payer keypair
-     * @returns Transaction signature
-     */
-    finalizeDaFact(fact: Buffer, signer: Keypair): Promise<string>;
-    /**
-     * Initialize the bridge contract
-     *
-     * @param operator Operator public key
-     * @param initialAppStateCommitment Initial app state commitment (32-byte array)
-     * @param signer Payer keypair
-     * @returns Transaction signature
-     */
-    initialize(operator: PublicKey, initialAppStateCommitment: Buffer, signer: Keypair): Promise<string>;
-    /**
-     * Create an associated token account if it doesn't exist
-     *
-     * @param mint Token mint
-     * @param owner Account owner
-     * @param payer Transaction payer
-     * @returns Associated token account address
-     */
-    createTokenAccountIfNeeded(mint: PublicKey, owner: PublicKey, payer: Keypair): Promise<PublicKey>;
-}