@hfunlabs/hyperliquid 0.29.1-hfunlabs.1 → 0.30.0-hfunlabs.1

package/script/src/transport/websocket/_subscriptionManager.js

@@ -14,12 +14,12 @@ class WebSocketSubscriptionManager {
     /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
     resubscribe;
     _socket;
-    _wsRequester;
+    _postRequest;
     _hlEvents;
     _subscriptions = new Map();
-    constructor(socket, wsRequester, hlEvents, resubscribe) {
+    constructor(socket, postRequest, hlEvents, resubscribe) {
         this._socket = socket;
-        this._wsRequester = wsRequester;
+        this._postRequest = postRequest;
         this._hlEvents = hlEvents;
         this.resubscribe = resubscribe;
         // Subscribe to socket events
@@ -38,26 +38,26 @@ class WebSocketSubscriptionManager {
      * @param payload - A payload to send with the subscription request.
      * @param listener - A function to call when the event is dispatched.
      *
-     * @returns A promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+     * @returns A promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
     async subscribe(channel, payload, listener) {
         // Create a unique identifier for the subscription
-        const id = _postRequest_js_1.WebSocketAsyncRequest.requestToId(payload);
+        const id = _postRequest_js_1.WebSocketPostRequest.requestToId(payload);
         // Initialize new subscription, if it doesn't exist
         let subscription = this._subscriptions.get(id);
         if (!subscription) {
             // Check unique subscription limits
             if (this._subscriptions.size >= MAX_SUBSCRIPTIONS) {
-                throw new _postRequest_js_1.WebSocketRequestError("Cannot subscribe to more than 1000 channels.");
+                throw new _postRequest_js_1.WebSocketRequestError("Cannot subscribe to more than 1000 channels");
             }
             // Check unique user subscription limits
             if (this._hasUserParam(payload) && this._countUniqueUserSubscriptions() >= MAX_UNIQUE_USER_SUBSCRIPTIONS) {
-                throw new _postRequest_js_1.WebSocketRequestError("Cannot track more than 10 unique users.");
+                throw new _postRequest_js_1.WebSocketRequestError("Cannot track more than 10 unique users");
             }
             // Send subscription request
-            const promise = this._wsRequester.request("subscribe", payload)
+            const promise = this._postRequest.request("subscribe", payload)
                 .finally(() => subscription.promiseFinished = true);
             // Cache subscription info
             subscription = {
@@ -83,7 +83,7 @@ class WebSocketSubscriptionManager {
                     this._subscriptions.delete(id);
                     // If the socket is open, send unsubscription request
                     if (this._socket.readyState === 1) { // OPEN
-                        await this._wsRequester.request("unsubscribe", payload);
+                        await this._postRequest.request("unsubscribe", payload);
                     }
                 }
             };
@@ -108,7 +108,7 @@ class WebSocketSubscriptionManager {
             for (const [id, subscription] of this._subscriptions.entries()) {
                 // reconnect only previously connected subscriptions to avoid double subscriptions due to message buffering
                 if (subscription.promiseFinished) {
-                    subscription.promise = this._wsRequester.request("subscribe", JSON.parse(id))
+                    subscription.promise = this._postRequest.request("subscribe", JSON.parse(id))
                         .catch((error) => subscription.failureController.abort(error))
                         .finally(() => subscription.promiseFinished = true);
                     subscription.promiseFinished = false;

package/script/src/transport/websocket/_subscriptionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"_subscriptionManager.js","sourceRoot":"","sources":["../../../../src/src/transport/websocket/_subscriptionManager.ts"],"names":[],"mappings":";;;AAEA,uDAAiF;AAEjF,8DAA8D;AAC9D,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,0EAA0E;AAC1E,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAuBzC;;;GAGG;AACH,MAAa,4BAA4B;IACvC,uFAAuF;IACvF,WAAW,CAAU;IAEX,OAAO,CAAwB;IAC/B,YAAY,CAAwB;IACpC,SAAS,CAAyB;IAClC,cAAc,GAAmC,IAAI,GAAG,EAAE,CAAC;IAErE,YACE,MAA6B,EAC7B,WAAkC,EAClC,QAAgC,EAChC,WAAoB;QAEpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,6BAA6B;QAC7B,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,+DAA+D;IAC/D,iBAAiB;IACjB,+DAA+D;IAE/D;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,CACb,OAAe,EACf,OAAgB,EAChB,QAAwC;QAExC,kDAAkD;QAClD,MAAM,EAAE,GAAG,uCAAqB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEtD,mDAAmD;QACnD,IAAI,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,mCAAmC;YACnC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;gBAClD,MAAM,IAAI,uCAAqB,CAAC,8CAA8C,CAAC,CAAC;YAClF,CAAC;YACD,wCAAwC;YACxC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,6BAA6B,EAAE,IAAI,6BAA6B,EAAE,CAAC;gBACzG,MAAM,IAAI,uCAAqB,CAAC,yCAAyC,CAAC,CAAC;YAC7E,CAAC;YAED,4BAA4B;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC;iBAC5D,OAAO,CAAC,GAAG,EAAE,CAAC,YAAa,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;YAEvD,0BAA0B;YAC1B,YAAY,GAAG;gBACb,SAAS,EAAE,IAAI,GAAG,EAAE;gBACpB,OAAO;gBACP,eAAe,EAAE,KAAK;gBACtB,iBAAiB,EAAE,IAAI,eAAe,EAAE;aACzC,CAAC;YACF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,+CAA+C;QAC/C,IAAI,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,kCAAkC;YAClC,WAAW,GAAG,KAAK,IAAI,EAAE;gBACvB,8BAA8B;gBAC9B,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACtD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjD,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAEzC,uDAAuD;gBACvD,IAAI,YAAY,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACvC,uBAAuB;oBACvB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAE/B,qDAAqD;oBACrD,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO;wBAC1C,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;oBAC1D,CAAC;gBACH,CAAC;YACH,CAAC,CAAC;YAEF,8CAA8C;YAC9C,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnD,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpD,CAAC;QAED,wDAAwD;QACxD,MAAM,YAAY,CAAC,OAAO,CAAC;QAE3B,qCAAqC;QACrC,OAAO;YACL,WAAW;YACX,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAC,MAAM;SACrD,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,wBAAwB;IACxB,+DAA+D;IAE/D,gFAAgF;IACtE,WAAW;QACnB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/D,2GAA2G;gBAC3G,IAAI,YAAY,CAAC,eAAe,EAAE,CAAC;oBACjC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;yBAC1E,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;yBAC7D,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;oBACtD,YAAY,CAAC,eAAe,GAAG,KAAK,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gFAAgF;IACtE,YAAY;QACpB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;YAChE,KAAK,MAAM,gBAAgB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5D,KAAK,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,gBAAgB,CAAC,SAAS,EAAE,CAAC;oBAC1D,WAAW,EAAE,CAAC,CAAC,gEAAgE;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,4BAA4B;IAC5B,+DAA+D;IAE/D,qDAAqD;IAC3C,aAAa,CAAC,OAAgB;QACtC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,CAAC;IAC9E,CAAC;IAED,yEAAyE;IAC/D,6BAA6B;QACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC/B,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;CACF;AAvKD,oEAuKC"}
+{"version":3,"file":"_subscriptionManager.js","sourceRoot":"","sources":["../../../../src/src/transport/websocket/_subscriptionManager.ts"],"names":[],"mappings":"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"}

package/script/src/transport/websocket/mod.d.ts

@@ -1,9 +1,30 @@
+/**
+ * WebSocket transport for {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions | subscriptions} and {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests | POST requests}.
+ *
+ * Use {@link WebSocketTransport} for real-time subscriptions and for lower-latency API requests.
+ *
+ * @example Subscriptions
+ * ```ts
+ * import { SubscriptionClient, WebSocketTransport } from "@nktkas/hyperliquid";
+ *
+ * const transport = new WebSocketTransport();
+ * const client = new SubscriptionClient({ transport });
+ *
+ * const subscription = await client.allMids((data) => {
+ *   console.log(data.mids);
+ * });
+ *
+ * await subscription.unsubscribe();
+ * ```
+ *
+ * @module
+ */
+import type { IRequestTransport, ISubscription, ISubscriptionTransport } from "../_base.js";
 import { ReconnectingWebSocket, type ReconnectingWebSocketOptions } from "@nktkas/rews";
 import { HyperliquidEventTarget } from "./_hyperliquidEventTarget.js";
-import { WebSocketAsyncRequest, WebSocketRequestError } from "./_postRequest.js";
-import { type WebSocketSubscription, WebSocketSubscriptionManager } from "./_subscriptionManager.js";
+import { WebSocketPostRequest, WebSocketRequestError } from "./_postRequest.js";
+import { WebSocketSubscriptionManager } from "./_subscriptionManager.js";
 export { WebSocketRequestError };
-export type { WebSocketSubscription };
 /** Configuration options for the WebSocket transport layer. */
 export interface WebSocketTransportOptions {
     /**
@@ -23,8 +44,7 @@ export interface WebSocketTransportOptions {
      */
     url?: string | URL;
     /**
-     * Timeout for requests in ms.
-     * Set to `null` to disable.
+     * Timeout for requests in ms. Set to `null` to disable.
      * @default 10_000
      */
     timeout?: number | null;
@@ -51,14 +71,18 @@ export declare const TESTNET_RPC_WS_URL = "wss://rpc.hyperliquid-testnet.xyz/ws"
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests
  */
-export declare class WebSocketTransport implements WebSocketTransportOptions {
+export declare class WebSocketTransport implements IRequestTransport, ISubscriptionTransport {
+    /** Indicates this transport uses testnet endpoint. */
     readonly isTestnet: boolean;
-    timeout: number | null;
     /** The WebSocket that is used for communication. */
     readonly socket: ReconnectingWebSocket;
+    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
     get resubscribe(): boolean;
     set resubscribe(value: boolean);
-    protected _wsRequester: WebSocketAsyncRequest;
+    /** Timeout for requests in ms. Set to `null` to disable. */
+    get timeout(): number | null;
+    set timeout(value: number | null);
+    protected _postRequest: WebSocketPostRequest;
     protected _hlEvents: HyperliquidEventTarget;
     protected _subscriptionManager: WebSocketSubscriptionManager;
     protected _keepAliveInterval: ReturnType<typeof setInterval> | undefined;
@@ -68,13 +92,12 @@ export declare class WebSocketTransport implements WebSocketTransportOptions {
      * @param options - Configuration options for the WebSocket transport layer.
      */
     constructor(options?: WebSocketTransportOptions);
-    protected _initKeepAlive(): void;
     /**
      * Sends a request to the Hyperliquid API via WebSocket.
      *
      * @param endpoint - The API endpoint to send the request to.
      * @param payload - The payload to send with the request.
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the request.
      *
      * @returns A promise that resolves with parsed JSON response body.
      *
@@ -89,15 +112,15 @@ export declare class WebSocketTransport implements WebSocketTransportOptions {
      * @param payload - A payload to send with the subscription request.
      * @param listener - A function to call when the event is dispatched.
      *
-     * @returns A promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+     * @returns A promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
-    subscribe<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void): Promise<WebSocketSubscription>;
+    subscribe<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void): Promise<ISubscription>;
     /**
      * Waits until the WebSocket connection is ready.
      *
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
      *
      * @returns A promise that resolves when the connection is ready.
      *
@@ -107,12 +130,13 @@ export declare class WebSocketTransport implements WebSocketTransportOptions {
     /**
      * Closes the WebSocket connection and waits until it is fully closed.
      *
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
      *
      * @returns A promise that resolves when the connection is fully closed.
      *
      * @throws {WebSocketRequestError} When the connection cannot be closed.
      */
     close(signal?: AbortSignal): Promise<void>;
+    protected _initKeepAlive(): void;
 }
 //# sourceMappingURL=mod.d.ts.map

package/script/src/transport/websocket/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/transport/websocket/mod.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,KAAK,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAErG,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,gEAAgE;IAChE,SAAS,CAAC,EAAE,4BAA4B,CAAC;IAEzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,yBAAyB;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAE7B;IAED,SAAS,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC9C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC5C,SAAS,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;IAC7D,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,SAAS,CAAC;IAEzE;;;;OAIG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IAqB/C,SAAS,CAAC,cAAc,IAAI,IAAI;IAiBhC;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBnG;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,CAAC,EACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1C;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA2B3C"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/transport/websocket/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE5F,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,SAAS,CAAC,EAAE,4BAA4B,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB,EAAE,sBAAsB;IAClF,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,uFAAuF;IACvF,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAE7B;IACD,4DAA4D;IAC5D,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE/B;IAED,SAAS,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC7C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC5C,SAAS,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;IAC7D,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,SAAS,CAAC;IAEzE;;;;OAIG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IA4B/C;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnG;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,CAAC,EACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1C;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC1C,SAAS,CAAC,cAAc,IAAI,IAAI;CAgBjC"}

package/script/src/transport/websocket/mod.js

@@ -1,7 +1,27 @@
 "use strict";
+/**
+ * WebSocket transport for {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions | subscriptions} and {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests | POST requests}.
+ *
+ * Use {@link WebSocketTransport} for real-time subscriptions and for lower-latency API requests.
+ *
+ * @example Subscriptions
+ * ```ts
+ * import { SubscriptionClient, WebSocketTransport } from "@nktkas/hyperliquid";
+ *
+ * const transport = new WebSocketTransport();
+ * const client = new SubscriptionClient({ transport });
+ *
+ * const subscription = await client.allMids((data) => {
+ *   console.log(data.mids);
+ * });
+ *
+ * await subscription.unsubscribe();
+ * ```
+ *
+ * @module
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSocketTransport = exports.TESTNET_RPC_WS_URL = exports.MAINNET_RPC_WS_URL = exports.TESTNET_API_WS_URL = exports.MAINNET_API_WS_URL = exports.WebSocketRequestError = void 0;
-const _errors_js_1 = require("../../_errors.js");
 const _polyfills_js_1 = require("../_polyfills.js");
 const rews_1 = require("@nktkas/rews");
 const _hyperliquidEventTarget_js_1 = require("./_hyperliquidEventTarget.js");
@@ -24,17 +44,25 @@ exports.TESTNET_RPC_WS_URL = "wss://rpc.hyperliquid-testnet.xyz/ws";
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests
  */
 class WebSocketTransport {
+    /** Indicates this transport uses testnet endpoint. */
     isTestnet;
-    timeout;
     /** The WebSocket that is used for communication. */
     socket;
+    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
     get resubscribe() {
         return this._subscriptionManager.resubscribe;
     }
     set resubscribe(value) {
         this._subscriptionManager.resubscribe = value;
     }
-    _wsRequester;
+    /** Timeout for requests in ms. Set to `null` to disable. */
+    get timeout() {
+        return this._postRequest.timeout;
+    }
+    set timeout(value) {
+        this._postRequest.timeout = value;
+    }
+    _postRequest;
     _hlEvents;
     _subscriptionManager;
     _keepAliveInterval;
@@ -45,52 +73,29 @@ class WebSocketTransport {
      */
     constructor(options) {
         this.isTestnet = options?.isTestnet ?? false;
-        this.timeout = options?.timeout === undefined ? 10_000 : options.timeout;
         this.socket = new rews_1.ReconnectingWebSocket(options?.url ?? (this.isTestnet ? exports.TESTNET_API_WS_URL : exports.MAINNET_API_WS_URL), options?.reconnect);
         this._hlEvents = new _hyperliquidEventTarget_js_1.HyperliquidEventTarget(this.socket);
-        this._wsRequester = new _postRequest_js_1.WebSocketAsyncRequest(this.socket, this._hlEvents);
-        this._subscriptionManager = new _subscriptionManager_js_1.WebSocketSubscriptionManager(this.socket, this._wsRequester, this._hlEvents, options?.resubscribe ?? true);
+        this._postRequest = new _postRequest_js_1.WebSocketPostRequest(this.socket, this._hlEvents, options?.timeout === undefined ? 10_000 : options.timeout);
+        this._subscriptionManager = new _subscriptionManager_js_1.WebSocketSubscriptionManager(this.socket, this._postRequest, this._hlEvents, options?.resubscribe ?? true);
         this._initKeepAlive();
     }
-    _initKeepAlive() {
-        const start = () => {
-            if (this._keepAliveInterval)
-                return;
-            this._keepAliveInterval = setInterval(() => {
-                this.socket.send('{"method":"ping"}');
-            }, 30_000);
-        };
-        const stop = () => {
-            clearInterval(this._keepAliveInterval);
-            this._keepAliveInterval = undefined;
-        };
-        this.socket.addEventListener("open", start);
-        this.socket.addEventListener("close", stop);
-        this.socket.addEventListener("error", stop);
-    }
+    // ============================================================
+    // Public methods
+    // ============================================================
     /**
      * Sends a request to the Hyperliquid API via WebSocket.
      *
      * @param endpoint - The API endpoint to send the request to.
      * @param payload - The payload to send with the request.
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the request.
      *
      * @returns A promise that resolves with parsed JSON response body.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
     async request(endpoint, payload, signal) {
-        const timeoutSignal = this.timeout ? _polyfills_js_1.AbortSignal_.timeout(this.timeout) : undefined;
-        const combinedSignal = signal && timeoutSignal
-            ? _polyfills_js_1.AbortSignal_.any([signal, timeoutSignal])
-            : signal ?? timeoutSignal;
         const payload_ = { type: endpoint === "exchange" ? "action" : endpoint, payload };
-        return await this._wsRequester.request("post", payload_, combinedSignal)
-            .catch((error) => {
-            if (error instanceof _errors_js_1.TransportError)
-                throw error; // Re-throw known errors
-            throw new _postRequest_js_1.WebSocketRequestError(`Unknown error while making a WebSocket request: ${error}`, { cause: error });
-        });
+        return await this._postRequest.request("post", payload_, signal);
     }
     /**
      * Subscribes to a Hyperliquid event channel.
@@ -100,7 +105,7 @@ class WebSocketTransport {
      * @param payload - A payload to send with the subscription request.
      * @param listener - A function to call when the event is dispatched.
      *
-     * @returns A promise that resolves with a {@link WebSocketSubscription} object to manage the subscription lifecycle.
+     * @returns A promise that resolves with a {@link ISubscription} object to manage the subscription lifecycle.
      *
      * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
      */
@@ -110,7 +115,7 @@ class WebSocketTransport {
     /**
      * Waits until the WebSocket connection is ready.
      *
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
      *
      * @returns A promise that resolves when the connection is ready.
      *
@@ -118,14 +123,18 @@ class WebSocketTransport {
      */
     ready(signal) {
         return new Promise((resolve, reject) => {
+            // Combine the provided signal with the socket's termination signal
             const combinedSignal = signal
                 ? _polyfills_js_1.AbortSignal_.any([this.socket.terminationSignal, signal])
                 : this.socket.terminationSignal;
+            // Check if already aborted
             if (combinedSignal.aborted) {
                 return reject(new _postRequest_js_1.WebSocketRequestError("Failed to establish WebSocket connection", { cause: combinedSignal.reason }));
             }
+            // Check if already open
             if (this.socket.readyState === rews_1.ReconnectingWebSocket.OPEN)
                 return resolve();
+            // Set up event listeners
             const handleOpen = () => {
                 combinedSignal.removeEventListener("abort", handleAbort);
                 resolve();
@@ -141,7 +150,7 @@ class WebSocketTransport {
     /**
      * Closes the WebSocket connection and waits until it is fully closed.
      *
-     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the promise.
+     * @param signal - {@link https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal | AbortSignal} to cancel the promise.
      *
      * @returns A promise that resolves when the connection is fully closed.
      *
@@ -149,11 +158,14 @@ class WebSocketTransport {
      */
     close(signal) {
         return new Promise((resolve, reject) => {
+            // Check if already aborted
             if (signal?.aborted) {
                 return reject(new _postRequest_js_1.WebSocketRequestError("Failed to close WebSocket connection", { cause: signal.reason }));
             }
+            // Check if already closed
             if (this.socket.readyState === rews_1.ReconnectingWebSocket.CLOSED)
                 return resolve();
+            // Set up event listeners
             const handleClose = () => {
                 signal?.removeEventListener("abort", handleAbort);
                 resolve();
@@ -164,9 +176,29 @@ class WebSocketTransport {
             this.socket.addEventListener("close", handleClose, { once: true, signal });
             this.socket.addEventListener("error", handleClose, { once: true, signal });
             signal?.addEventListener("abort", handleAbort, { once: true });
+            // Initiate close
             this.socket.close();
         });
     }
+    // ============================================================
+    // Keep-Alive Logic
+    // ============================================================
+    _initKeepAlive() {
+        const start = () => {
+            if (this._keepAliveInterval)
+                return;
+            this._keepAliveInterval = setInterval(() => {
+                this.socket.send('{"method":"ping"}');
+            }, 30_000);
+        };
+        const stop = () => {
+            clearInterval(this._keepAliveInterval);
+            this._keepAliveInterval = undefined;
+        };
+        this.socket.addEventListener("open", start);
+        this.socket.addEventListener("close", stop);
+        this.socket.addEventListener("error", stop);
+    }
 }
 exports.WebSocketTransport = WebSocketTransport;
 //# sourceMappingURL=mod.js.map

package/script/src/transport/websocket/mod.js.map

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

package/{esm/src/utils/format.d.ts → script/src/utils/_format.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Format price according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * Format price according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
  * - Maximum 5 significant figures
  * - Maximum 6 (for perp) or 8 (for spot) - `szDecimals` decimal places
  * - Integer prices are always allowed regardless of significant figures
@@ -18,7 +18,7 @@
  */
 export declare function formatPrice(price: string | number, szDecimals: number, type?: "perp" | "spot"): string;
 /**
- * Format size according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
  * - Truncate decimal places to `szDecimals`
  *
  * @param size - The size to format (as string or number).
@@ -34,4 +34,4 @@ export declare function formatPrice(price: string | number, szDecimals: number,
  * ```
  */
 export declare function formatSize(size: string | number, szDecimals: number): string;
-//# sourceMappingURL=format.d.ts.map
+//# sourceMappingURL=_format.d.ts.map

package/script/src/utils/_format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_format.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CAmB9G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAY5E"}

package/script/src/utils/{format.js → _format.js}

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatPrice = formatPrice;
 exports.formatSize = formatSize;
 /**
- * Format price according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * Format price according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
  * - Maximum 5 significant figures
  * - Maximum 6 (for perp) or 8 (for spot) - `szDecimals` decimal places
  * - Integer prices are always allowed regardless of significant figures
@@ -37,7 +37,7 @@ function formatPrice(price, szDecimals, type = "perp") {
     return price;
 }
 /**
- * Format size according to Hyperliquid [rules](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size):
+ * Format size according to Hyperliquid {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size | rules}:
  * - Truncate decimal places to `szDecimals`
  *
  * @param size - The size to format (as string or number).
@@ -175,4 +175,4 @@ function assertNumberString(value) {
         throw new TypeError("Invalid number format");
     }
 }
-//# sourceMappingURL=format.js.map
+//# sourceMappingURL=_format.js.map

package/script/src/utils/_format.js.map

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

package/{esm/src/utils/symbolConverter.d.ts → script/src/utils/_symbolConverter.d.ts}

@@ -1,9 +1,8 @@
-import type { HttpTransport } from "../transport/http/mod.js";
-import type { WebSocketTransport } from "../transport/websocket/mod.js";
+import type { IRequestTransport } from "../transport/mod.js";
 /** Options for creating a {@link SymbolConverter} instance. */
 export interface SymbolConverterOptions {
     /** Transport instance to use for API requests. */
-    transport: HttpTransport | WebSocketTransport;
+    transport: IRequestTransport;
     /** Optional dex support: array of dex names, true for all dexs, or false/undefined to skip. */
     dexs?: string[] | boolean;
 }
@@ -36,12 +35,14 @@ export interface SymbolConverterOptions {
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
  */
 export declare class SymbolConverter {
-    private readonly transport;
-    private readonly dexOption;
-    private readonly nameToAssetId;
-    private readonly nameToSzDecimals;
-    private readonly nameToSpotPairId;
-    private constructor();
+    #private;
+    /**
+     * Creates a new SymbolConverter instance, but does not initialize it.
+     * Run {@link reload} to load asset data or use {@link create} to create and initialize in one step.
+     *
+     * @param options - Configuration options including transport and optional dex support.
+     */
+    constructor(options: SymbolConverterOptions);
     /**
      * Create and initialize a SymbolConverter instance.
      *
@@ -61,13 +62,10 @@ export declare class SymbolConverter {
     static create(options: SymbolConverterOptions): Promise<SymbolConverter>;
     /**
      * Reload asset mappings from the API.
+     *
      * Useful for refreshing data when new assets are added.
      */
     reload(): Promise<void>;
-    private processDefaultPerps;
-    private processBuilderDexs;
-    private processBuilderDexResult;
-    private processSpotAssets;
     /**
      * Get asset ID for a coin.
      * - For Perpetuals, use the coin name (e.g., "BTC").
@@ -95,4 +93,4 @@ export declare class SymbolConverter {
      */
     getSpotPairId(name: string): string | undefined;
 }
-//# sourceMappingURL=symbolConverter.d.ts.map
+//# sourceMappingURL=_symbolConverter.d.ts.map

package/script/src/utils/_symbolConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAU7D,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAe;;IAO1B;;;;;OAKG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;;;;;;;;;;OAeG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiG7B;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}