@nktkas/hyperliquid 0.25.9 → 0.26.0

package/dist/src/transport/websocket/_hyperliquid_event_target.d.ts

@@ -0,0 +1,91 @@
+import * as v from "valibot";
+/** Response to subscribe to or unsubscribe from an event. */
+interface SubscribeUnsubscribeResponse {
+    /** Type of response */
+    method: "subscribe" | "unsubscribe";
+    /** Original request. */
+    subscription: unknown;
+}
+/** Response to post request. */
+interface PostResponse {
+    /** Unique request identifier. */
+    id: number;
+    /** Server response. */
+    response: 
+    /** Response containing requested information. */
+    {
+        /** Indicates that this is an informational response. */
+        type: "info";
+        /** Contains the information data. */
+        payload: {
+            /** Type of information being returned. */
+            type: string;
+            /** Information specific data. */
+            data: unknown;
+        };
+    }
+    /** Response containing action result. */
+     | {
+        /** Indicates that this is an action response. */
+        type: "action";
+        /** Action result. */
+        payload: {
+            /** Response status indicating success or failure of the action. */
+            status: "ok" | "err";
+            /** Success data or error message. */
+            response: {
+                /** Type of operation. */
+                type: string;
+                /** Specific data for the action. */
+                data?: unknown;
+            } | string;
+        };
+    }
+    /** Response containing error message. */
+     | {
+        /** Indicates that this is an action response. */
+        type: "error";
+        /** Contains the error message, e.g. 429 Too Many Requests */
+        payload: string;
+    };
+}
+/** Base system events and dynamic channel events for Hyperliquid WebSocket API. */
+interface HyperliquidEventMap {
+    subscriptionResponse: CustomEvent<SubscribeUnsubscribeResponse>;
+    post: CustomEvent<PostResponse>;
+    error: CustomEvent<string>;
+    pong: CustomEvent<undefined>;
+    _explorerBlock: CustomEvent<BlockDetails[]>;
+    _explorerTxs: CustomEvent<TxDetails[]>;
+    [key: string]: CustomEvent<any>;
+}
+declare const BlockDetails: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly blockTime: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.LengthAction<string, 66, undefined>]>;
+    readonly height: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly numTxs: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly proposer: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.LengthAction<string, 42, undefined>]>;
+}, undefined>]>;
+type BlockDetails = v.InferOutput<typeof BlockDetails>;
+declare const TxDetails: v.ObjectSchema<{
+    readonly action: v.LooseObjectSchema<{
+        readonly type: v.StringSchema<undefined>;
+    }, undefined>;
+    readonly block: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly error: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly hash: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.LengthAction<string, 66, undefined>]>;
+    readonly time: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly user: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.LengthAction<string, 42, undefined>]>;
+}, undefined>;
+type TxDetails = v.InferOutput<typeof TxDetails>;
+/** Listens for WebSocket messages and sends them as Hyperliquid typed events. */
+export declare class HyperliquidEventTarget extends EventTarget {
+    constructor(socket: WebSocket);
+}
+export interface HyperliquidEventTarget {
+    addEventListener<K extends keyof HyperliquidEventMap>(type: K, listener: ((event: HyperliquidEventMap[K]) => void) | EventListenerObject | null, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HyperliquidEventMap>(type: K, listener: ((event: HyperliquidEventMap[K]) => void) | EventListenerObject | null, options?: boolean | EventListenerOptions): void;
+    dispatchEvent(event: HyperliquidEventMap[keyof HyperliquidEventMap]): boolean;
+}
+export {};
+//# sourceMappingURL=_hyperliquid_event_target.d.ts.map

package/dist/src/transport/websocket/_hyperliquid_event_target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_hyperliquid_event_target.d.ts","sourceRoot":"","sources":["../../../../src/transport/websocket/_hyperliquid_event_target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAG7B,6DAA6D;AAC7D,UAAU,4BAA4B;IACpC,uBAAuB;IACvB,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,wBAAwB;IACxB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,gCAAgC;AAChC,UAAU,YAAY;IACpB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,QAAQ;IACN,iDAAiD;IAC/C;QACA,wDAAwD;QACxD,IAAI,EAAE,MAAM,CAAC;QACb,qCAAqC;QACrC,OAAO,EAAE;YACP,0CAA0C;YAC1C,IAAI,EAAE,MAAM,CAAC;YACb,iCAAiC;YACjC,IAAI,EAAE,OAAO,CAAC;SACf,CAAC;KACH;IACD,yCAAyC;OACvC;QACA,iDAAiD;QACjD,IAAI,EAAE,QAAQ,CAAC;QACf,qBAAqB;QACrB,OAAO,EAAE;YACP,mEAAmE;YACnE,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC;YACrB,qCAAqC;YACrC,QAAQ,EACJ;gBACA,yBAAyB;gBACzB,IAAI,EAAE,MAAM,CAAC;gBACb,oCAAoC;gBACpC,IAAI,CAAC,EAAE,OAAO,CAAC;aAChB,GACC,MAAM,CAAC;SACZ,CAAC;KACH;IACD,yCAAyC;OACvC;QACA,iDAAiD;QACjD,IAAI,EAAE,OAAO,CAAC;QACd,6DAA6D;QAC7D,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACL;AAED,mFAAmF;AACnF,UAAU,mBAAmB;IAC3B,oBAAoB,EAAE,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAChE,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7B,cAAc,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;IAC5C,YAAY,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvC,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,QAAA,MAAM,YAAY;;;;;;eAUd,CAAC;AACL,KAAK,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,QAAA,MAAM,SAAS;;;;;;;;;aASX,CAAC;AACL,KAAK,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC;AAYjD,iFAAiF;AACjF,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,MAAM,EAAE,SAAS;CAiB9B;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAClD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,EAChF,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;IACR,mBAAmB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACrD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,IAAI,EAChF,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI,CAAC;IACR,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,MAAM,mBAAmB,CAAC,GAAG,OAAO,CAAC;CAC/E"}

package/dist/src/transport/websocket/_hyperliquid_event_target.js

@@ -0,0 +1,54 @@
+import * as v from "valibot";
+import { CustomEvent_ } from "../_polyfills.js";
+const BlockDetails = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        blockTime: v.pipe(v.number(), v.integer(), v.minValue(0)),
+        hash: v.pipe(v.string(), v.regex(/^0[xX][0-9a-fA-F]+$/), v.length(66)),
+        height: v.pipe(v.number(), v.integer(), v.minValue(0)),
+        numTxs: v.pipe(v.number(), v.integer(), v.minValue(0)),
+        proposer: v.pipe(v.string(), v.regex(/^0[xX][0-9a-fA-F]+$/), v.length(42)),
+    }));
+})();
+const TxDetails = /* @__PURE__ */ (() => {
+    return v.object({
+        action: v.looseObject({ type: v.string() }),
+        block: v.pipe(v.number(), v.integer(), v.minValue(0)),
+        error: v.nullable(v.string()),
+        hash: v.pipe(v.string(), v.regex(/^0[xX][0-9a-fA-F]+$/), v.length(66)),
+        time: v.pipe(v.number(), v.integer(), v.minValue(0)),
+        user: v.pipe(v.string(), v.regex(/^0[xX][0-9a-fA-F]+$/), v.length(42)),
+    });
+})();
+const HyperliquidEventSchema = /* @__PURE__ */ (() => {
+    return v.object({ channel: v.string(), data: v.unknown() });
+})();
+const ExplorerBlockEventSchema = /* @__PURE__ */ (() => {
+    return v.pipe(v.array(BlockDetails), v.minLength(1));
+})();
+const ExplorerTxsEventSchema = /* @__PURE__ */ (() => {
+    return v.pipe(v.array(TxDetails), v.minLength(1));
+})();
+/** Listens for WebSocket messages and sends them as Hyperliquid typed events. */
+export class HyperliquidEventTarget extends EventTarget {
+    constructor(socket) {
+        super();
+        socket.addEventListener("message", (event) => {
+            try {
+                const msg = JSON.parse(event.data);
+                if (v.is(HyperliquidEventSchema, msg)) {
+                    this.dispatchEvent(new CustomEvent_(msg.channel, { detail: msg.data }));
+                }
+                else if (v.is(ExplorerBlockEventSchema, msg)) {
+                    this.dispatchEvent(new CustomEvent_("_explorerBlock", { detail: msg }));
+                }
+                else if (v.is(ExplorerTxsEventSchema, msg)) {
+                    this.dispatchEvent(new CustomEvent_("_explorerTxs", { detail: msg }));
+                }
+            }
+            catch {
+                // Ignore JSON parsing errors
+            }
+        });
+    }
+}
+//# sourceMappingURL=_hyperliquid_event_target.js.map

package/dist/src/transport/websocket/_hyperliquid_event_target.js.map

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

package/dist/src/transport/websocket/_websocket_async_request.d.ts

@@ -0,0 +1,37 @@
+import { TransportError } from "../base.ts";
+import type { ReconnectingWebSocket } from "@nktkas/rews";
+import type { HyperliquidEventTarget } from "./_hyperliquid_event_target.ts";
+/** Error thrown when a WebSocket request fails. */
+export declare class WebSocketRequestError extends TransportError {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/**
+ * Manages WebSocket requests to the Hyperliquid API.
+ * Handles request creation, sending, and mapping responses to their corresponding requests.
+ */
+export declare class WebSocketAsyncRequest {
+    protected socket: ReconnectingWebSocket;
+    protected lastId: number;
+    protected queue: {
+        id: number | string;
+        resolve: (value?: any) => void;
+        reject: (reason?: any) => void;
+    }[];
+    /** Timestamp of the last request sent. */
+    lastRequestTime: number;
+    /**
+     * Creates a new WebSocket async request handler.
+     * @param socket - WebSocket connection instance for sending requests to the Hyperliquid WebSocket API
+     * @param hlEvents - Used to recognize Hyperliquid responses and match them with sent requests
+     */
+    constructor(socket: ReconnectingWebSocket, hlEvents: HyperliquidEventTarget);
+    /**
+     * Sends a request to the Hyperliquid API.
+     * @returns A promise that resolves with the parsed JSON response body.
+     */
+    request(method: "ping", signal?: AbortSignal): Promise<void>;
+    request<T>(method: "post" | "subscribe" | "unsubscribe", payload: unknown, signal?: AbortSignal): Promise<T>;
+    /** Normalizes an object and then converts it to a string. */
+    static requestToId(value: unknown): string;
+}
+//# sourceMappingURL=_websocket_async_request.d.ts.map

package/dist/src/transport/websocket/_websocket_async_request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_websocket_async_request.d.ts","sourceRoot":"","sources":["../../../../src/transport/websocket/_websocket_async_request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAe7E,mDAAmD;AACnD,qBAAa,qBAAsB,SAAQ,cAAc;gBAC3C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIrD;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACxC,SAAS,CAAC,MAAM,SAAK;IACrB,SAAS,CAAC,KAAK,EAAE;QACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAEpB,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAE/B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;KAChC,EAAE,CAAM;IACT,0CAA0C;IAC1C,eAAe,SAAK;IAEpB;;;;OAIG;gBACS,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,sBAAsB;IA8F3E;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAiDlH,6DAA6D;IAC7D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAiB3C"}

package/dist/src/transport/websocket/_websocket_async_request.js

@@ -0,0 +1,192 @@
+import { TransportError } from "../base.js";
+import { Promise_ } from "../_polyfills.js";
+/** Error thrown when a WebSocket request fails. */
+export class WebSocketRequestError extends TransportError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "WebSocketRequestError";
+    }
+}
+/**
+ * Manages WebSocket requests to the Hyperliquid API.
+ * Handles request creation, sending, and mapping responses to their corresponding requests.
+ */
+export class WebSocketAsyncRequest {
+    socket;
+    lastId = 0;
+    queue = [];
+    /** Timestamp of the last request sent. */
+    lastRequestTime = 0;
+    /**
+     * Creates a new WebSocket async request handler.
+     * @param socket - WebSocket connection instance for sending requests to the Hyperliquid WebSocket API
+     * @param hlEvents - Used to recognize Hyperliquid responses and match them with sent requests
+     */
+    constructor(socket, hlEvents) {
+        this.socket = socket;
+        // Monitor responses and match the pending request
+        hlEvents.addEventListener("subscriptionResponse", (event) => {
+            const id = WebSocketAsyncRequest.requestToId(event.detail);
+            this.queue.find((x) => x.id === id)?.resolve(event.detail);
+        });
+        hlEvents.addEventListener("post", (event) => {
+            if (event.detail.response.type === "error") {
+                this.queue
+                    .find((x) => x.id === event.detail.id)
+                    ?.reject(new WebSocketRequestError(event.detail.response.payload));
+                return;
+            }
+            const data = event.detail.response.type === "info"
+                ? event.detail.response.payload.data
+                : event.detail.response.payload;
+            this.queue.find((x) => x.id === event.detail.id)?.resolve(data);
+        });
+        hlEvents.addEventListener("pong", () => {
+            this.queue.find((x) => x.id === "ping")?.resolve();
+        });
+        hlEvents.addEventListener("error", (event) => {
+            try {
+                // Error event doesn't have an id, use original request to match
+                const request = event.detail.match(/{.*}/)?.[0];
+                if (!request)
+                    return;
+                const parsedRequest = JSON.parse(request);
+                // For `post` requests
+                if ("id" in parsedRequest && typeof parsedRequest.id === "number") {
+                    this.queue.find((x) => x.id === parsedRequest.id)
+                        ?.reject(new WebSocketRequestError(event.detail));
+                    return;
+                }
+                // For `subscribe` and `unsubscribe` requests
+                if ("subscription" in parsedRequest &&
+                    typeof parsedRequest.subscription === "object" && parsedRequest.subscription !== null) {
+                    const id = WebSocketAsyncRequest.requestToId(parsedRequest);
+                    this.queue.find((x) => x.id === id)
+                        ?.reject(new WebSocketRequestError(event.detail));
+                    return;
+                }
+                // For `Already subscribed` and `Invalid subscription` requests
+                if (event.detail.startsWith("Already subscribed") ||
+                    event.detail.startsWith("Invalid subscription")) {
+                    const id = WebSocketAsyncRequest.requestToId({
+                        method: "subscribe",
+                        subscription: parsedRequest,
+                    });
+                    this.queue.find((x) => x.id === id)
+                        ?.reject(new WebSocketRequestError(event.detail));
+                    return;
+                }
+                // For `Already unsubscribed` requests
+                if (event.detail.startsWith("Already unsubscribed")) {
+                    const id = WebSocketAsyncRequest.requestToId({
+                        method: "unsubscribe",
+                        subscription: parsedRequest,
+                    });
+                    this.queue.find((x) => x.id === id)
+                        ?.reject(new WebSocketRequestError(event.detail));
+                    return;
+                }
+                // For unknown requests
+                const id = WebSocketAsyncRequest.requestToId(parsedRequest);
+                this.queue.find((x) => x.id === id)
+                    ?.reject(new WebSocketRequestError(event.detail));
+            }
+            catch {
+                // Ignore JSON parsing errors
+            }
+        });
+        // Throws all pending requests if the connection is dropped
+        const handleClose = () => {
+            this.queue.forEach(({ reject }) => {
+                reject(new WebSocketRequestError("WebSocket connection closed."));
+            });
+            this.queue = [];
+        };
+        socket.addEventListener("close", handleClose);
+        socket.addEventListener("error", handleClose);
+    }
+    async request(method, payloadOrSignal, maybeSignal) {
+        const payload = payloadOrSignal instanceof AbortSignal ? undefined : payloadOrSignal;
+        const signal = payloadOrSignal instanceof AbortSignal ? payloadOrSignal : maybeSignal;
+        // Reject the request if the signal is aborted
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        // or if the WebSocket connection is permanently closed
+        if (this.socket.terminationSignal.aborted) {
+            return Promise.reject(this.socket.terminationSignal.reason);
+        }
+        // Create a request
+        let id;
+        let request;
+        if (method === "post") {
+            id = ++this.lastId;
+            request = { method, id, request: payload };
+        }
+        else if (method === "ping") {
+            id = "ping";
+            request = { method };
+        }
+        else {
+            request = { method, subscription: payload };
+            id = WebSocketAsyncRequest.requestToId(request);
+        }
+        // Send the request
+        this.socket.send(JSON.stringify(request));
+        this.lastRequestTime = Date.now();
+        // Wait for a response
+        const { promise, resolve, reject } = Promise_.withResolvers();
+        this.queue.push({ id, resolve, reject });
+        const onAbort = () => reject(signal?.reason);
+        signal?.addEventListener("abort", onAbort, { once: true });
+        return await promise.finally(() => {
+            const index = this.queue.findIndex((item) => item.id === id);
+            if (index !== -1)
+                this.queue.splice(index, 1);
+            signal?.removeEventListener("abort", onAbort);
+        });
+    }
+    /** Normalizes an object and then converts it to a string. */
+    static requestToId(value) {
+        const transformed = deepTransform(value, [
+            // sort object keys
+            (v) => {
+                if (typeof v !== "object" || v === null || Array.isArray(v))
+                    return v;
+                const out = {};
+                for (const key of Object.keys(v).sort()) {
+                    out[key] = v[key];
+                }
+                return out;
+            },
+            // hex to lowercase
+            (v) => typeof v === "string" && /^0[xX][0-9a-fA-F]+$/.test(v) ? v.toLowerCase() : v,
+        ]);
+        return JSON.stringify(transformed); // also removes undefined values
+    }
+}
+/**
+ * Recursively transforms object/array values using a sequence of transformers.
+ *
+ * Issues:
+ * - does not support circular references
+ * - Symbol-keys are not preserved
+ */
+function deepTransform(obj, transformers) {
+    const transform = (val, key) => {
+        // Apply all transformers in sequence
+        const transformed = transformers.reduce((acc, fn) => acc === undefined ? undefined : fn(acc, key), val);
+        // Recurse into arrays and objects
+        if (typeof transformed !== "object" || transformed === null)
+            return transformed; // skip primitives
+        if (Array.isArray(transformed))
+            return transformed.map((v) => transform(v));
+        const out = {};
+        for (const [k, v] of Object.entries(transformed)) {
+            const transformedValue = transform(v, k);
+            out[k] = transformedValue;
+        }
+        return out;
+    };
+    return transform(obj);
+}
+//# sourceMappingURL=_websocket_async_request.js.map

package/dist/src/transport/websocket/_websocket_async_request.js.map

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

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

@@ -0,0 +1,123 @@
+import { type IRequestTransport, type ISubscriptionTransport, type Subscription } from "../base.ts";
+import { ReconnectingWebSocket, ReconnectingWebSocketError, type ReconnectingWebSocketOptions } from "@nktkas/rews";
+import { HyperliquidEventTarget } from "./_hyperliquid_event_target.ts";
+import { WebSocketAsyncRequest, WebSocketRequestError } from "./_websocket_async_request.ts";
+export { ReconnectingWebSocketError, WebSocketRequestError };
+type MaybePromise<T> = T | Promise<T>;
+/** Configuration options for the WebSocket transport layer. */
+export interface WebSocketTransportOptions {
+    /**
+     * Indicates this transport uses testnet endpoint.
+     * @default false
+     */
+    isTestnet?: boolean;
+    /**
+     * Custom WebSocket endpoint for API and Subscription requests.
+     * - Mainnet:
+     *   - API: `wss://api.hyperliquid.xyz/ws`
+     *   - Explorer: `wss://rpc.hyperliquid.xyz/ws`
+     * - Testnet:
+     *   - API: `wss://api.hyperliquid-testnet.xyz/ws`
+     *   - Explorer: `wss://rpc.hyperliquid-testnet.xyz/ws`
+     * @default `wss://api.hyperliquid.xyz/ws` for mainnet, `wss://api.hyperliquid-testnet.xyz/ws` for testnet
+     */
+    url?: string | URL;
+    /**
+     * Timeout for requests in ms.
+     * Set to `null` to disable.
+     * @default 10_000
+     */
+    timeout?: number | null;
+    /**
+     * Interval between sending ping messages in ms.
+     * Set to `null` to disable.
+     * @default 30_000
+     */
+    keepAliveInterval?: number | null;
+    /** Reconnection policy configuration for closed connections. */
+    reconnect?: ReconnectingWebSocketOptions;
+    /**
+     * Enable automatic re-subscription to Hyperliquid subscription after reconnection.
+     * @default true
+     */
+    resubscribe?: boolean;
+    onRequest?: (type: string, payload: unknown) => MaybePromise<unknown | void | null | undefined>;
+    onResponse?: (response: unknown) => MaybePromise<unknown | void | null | undefined>;
+    onError?: (error: unknown) => MaybePromise<Error | void | null | undefined>;
+}
+/** WebSocket implementation of the REST and Subscription transport interfaces. */
+export declare class WebSocketTransport implements IRequestTransport, ISubscriptionTransport {
+    protected _wsRequester: WebSocketAsyncRequest;
+    protected _hlEvents: HyperliquidEventTarget;
+    protected _keepAliveTimeout: ReturnType<typeof setTimeout> | undefined;
+    protected _subscriptions: Map<string, // Unique identifier based on the payload
+    {
+        listeners: Map<(data: CustomEvent) => void, // Event listener function
+        () => Promise<void>>;
+        promise: Promise<unknown>;
+        promiseFinished: boolean;
+        resubscribeAbortController: AbortController;
+    }>;
+    /** Indicates this transport uses testnet endpoint. */
+    readonly isTestnet: boolean;
+    /**
+     * Timeout for requests in ms.
+     * Set to `null` to disable.
+     */
+    timeout: number | null;
+    /**
+     * Interval between sending ping messages in ms.
+     * Set to `null` to disable.
+     */
+    keepAliveInterval: number | null;
+    /** Enable automatic re-subscription to Hyperliquid subscription after reconnection. */
+    resubscribe: boolean;
+    /** The WebSocket that is used for communication. */
+    readonly socket: ReconnectingWebSocket;
+    /**
+     * Creates a new WebSocket transport instance.
+     * @param options - Configuration options for the WebSocket transport layer.
+     */
+    constructor(options?: WebSocketTransportOptions);
+    /**
+     * Keep the connection alive.
+     * Sends ping only when no other requests were sent within the keep-alive interval.
+     */
+    protected _keepAliveRun(): void;
+    protected _keepAliveStop(): void;
+    /** Resubscribe to all existing subscriptions if auto-resubscribe is enabled. */
+    protected _resubscribeRun(): void;
+    protected _resubscribeStop(): 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 - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     * @returns A promise that resolves with parsed JSON response body.
+     * @throws {WebSocketRequestError} - An error that occurs when a WebSocket request fails.
+     */
+    request<T>(type: "info" | "exchange", payload: unknown, signal?: AbortSignal): Promise<T>;
+    /**
+     * Subscribes to a Hyperliquid event channel.
+     * Sends a subscription request to the server and listens for events.
+     * @param channel - The event channel to listen to.
+     * @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 Subscription} 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<Subscription>;
+    /**
+     * Waits until the WebSocket connection is ready.
+     * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the promise by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     * @returns A promise that resolves when the connection is ready.
+     */
+    ready(signal?: AbortSignal): Promise<void>;
+    /**
+     * Closes the WebSocket connection and waits until it is fully closed.
+     * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the promise by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+     * @returns A promise that resolves when the connection is fully closed.
+     */
+    close(signal?: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=mod.d.ts.map

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

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