@lightconexyz/lightcone-sdk 0.1.0 → 0.2.0

package/dist/shared/types.d.ts

@@ -1,19 +1,69 @@
-/**
- * Price history candle resolution.
- * Used by both REST API and WebSocket for price history queries.
- */
+export type Branded<T, Brand extends string> = T & {
+    readonly __brand: Brand;
+};
+export type OrderBookId = Branded<string, "OrderBookId">;
+export type PubkeyStr = Branded<string, "PubkeyStr">;
+export declare function asOrderBookId(value: string): OrderBookId;
+export declare function asPubkeyStr(value: string): PubkeyStr;
+export declare enum Side {
+    Bid = "bid",
+    Ask = "ask"
+}
+export declare function sideLabel(side: Side): "Buy" | "Sell";
+export declare enum TimeInForce {
+    Gtc = "GTC",
+    Ioc = "IOC",
+    Fok = "FOK",
+    Alo = "ALO"
+}
+export declare enum TriggerType {
+    TakeProfit = "TP",
+    StopLoss = "SL"
+}
+export declare enum TriggerStatus {
+    Triggered = "triggered",
+    Failed = "failed",
+    Expired = "expired"
+}
+export declare enum OrderUpdateType {
+    Placement = "PLACEMENT",
+    Update = "UPDATE",
+    Cancellation = "CANCELLATION"
+}
+export declare enum TriggerUpdateType {
+    Triggered = "TRIGGERED",
+    Failed = "FAILED",
+    Expired = "EXPIRED"
+}
+export declare enum TriggerResultStatus {
+    Filled = "filled",
+    Accepted = "accepted",
+    Rejected = "rejected"
+}
 export declare enum Resolution {
-    /** 1 minute candles */
-    OneMinute = "1m",
-    /** 5 minute candles */
-    FiveMinutes = "5m",
-    /** 15 minute candles */
-    FifteenMinutes = "15m",
-    /** 1 hour candles */
-    OneHour = "1h",
-    /** 4 hour candles */
-    FourHours = "4h",
-    /** 1 day candles */
-    OneDay = "1d"
+    Minute1 = "1m",
+    Minute5 = "5m",
+    Minute15 = "15m",
+    Hour1 = "1h",
+    Hour4 = "4h",
+    Day1 = "1d"
+}
+export declare function resolutionSeconds(resolution: Resolution): number;
+export declare function deriveOrderbookId(baseToken: string, quoteToken: string): OrderBookId;
+export interface SubmitOrderRequest {
+    maker: string;
+    nonce: number;
+    market_pubkey: string;
+    base_token: string;
+    quote_token: string;
+    side: number;
+    amount_in: string;
+    amount_out: string;
+    expiration?: number;
+    signature: string;
+    orderbook_id: string;
+    tif?: TimeInForce;
+    trigger_price?: number;
+    trigger_type?: TriggerType;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,UAAU;IACpB,uBAAuB;IACvB,SAAS,OAAO;IAChB,uBAAuB;IACvB,WAAW,OAAO;IAClB,wBAAwB;IACxB,cAAc,QAAQ;IACtB,qBAAqB;IACrB,OAAO,OAAO;IACd,qBAAqB;IACrB,SAAS,OAAO;IAChB,oBAAoB;IACpB,MAAM,OAAO;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,KAAK,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAErD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAExD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED,oBAAY,IAAI;IACd,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAEpD;AAED,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED,oBAAY,WAAW;IACrB,UAAU,OAAO;IACjB,QAAQ,OAAO;CAChB;AAED,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,YAAY,iBAAiB;CAC9B;AAED,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED,oBAAY,UAAU;IACpB,OAAO,OAAO;IACd,OAAO,OAAO;IACd,QAAQ,QAAQ;IAChB,KAAK,OAAO;IACZ,KAAK,OAAO;IACZ,IAAI,OAAO;CACZ;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAehE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAEpF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B"}

package/dist/shared/types.js

@@ -1,23 +1,87 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Resolution = void 0;
-/**
- * Price history candle resolution.
- * Used by both REST API and WebSocket for price history queries.
- */
+exports.Resolution = exports.TriggerResultStatus = exports.TriggerUpdateType = exports.OrderUpdateType = exports.TriggerStatus = exports.TriggerType = exports.TimeInForce = exports.Side = void 0;
+exports.asOrderBookId = asOrderBookId;
+exports.asPubkeyStr = asPubkeyStr;
+exports.sideLabel = sideLabel;
+exports.resolutionSeconds = resolutionSeconds;
+exports.deriveOrderbookId = deriveOrderbookId;
+function asOrderBookId(value) {
+    return value;
+}
+function asPubkeyStr(value) {
+    return value;
+}
+var Side;
+(function (Side) {
+    Side["Bid"] = "bid";
+    Side["Ask"] = "ask";
+})(Side || (exports.Side = Side = {}));
+function sideLabel(side) {
+    return side === Side.Bid ? "Buy" : "Sell";
+}
+var TimeInForce;
+(function (TimeInForce) {
+    TimeInForce["Gtc"] = "GTC";
+    TimeInForce["Ioc"] = "IOC";
+    TimeInForce["Fok"] = "FOK";
+    TimeInForce["Alo"] = "ALO";
+})(TimeInForce || (exports.TimeInForce = TimeInForce = {}));
+var TriggerType;
+(function (TriggerType) {
+    TriggerType["TakeProfit"] = "TP";
+    TriggerType["StopLoss"] = "SL";
+})(TriggerType || (exports.TriggerType = TriggerType = {}));
+var TriggerStatus;
+(function (TriggerStatus) {
+    TriggerStatus["Triggered"] = "triggered";
+    TriggerStatus["Failed"] = "failed";
+    TriggerStatus["Expired"] = "expired";
+})(TriggerStatus || (exports.TriggerStatus = TriggerStatus = {}));
+var OrderUpdateType;
+(function (OrderUpdateType) {
+    OrderUpdateType["Placement"] = "PLACEMENT";
+    OrderUpdateType["Update"] = "UPDATE";
+    OrderUpdateType["Cancellation"] = "CANCELLATION";
+})(OrderUpdateType || (exports.OrderUpdateType = OrderUpdateType = {}));
+var TriggerUpdateType;
+(function (TriggerUpdateType) {
+    TriggerUpdateType["Triggered"] = "TRIGGERED";
+    TriggerUpdateType["Failed"] = "FAILED";
+    TriggerUpdateType["Expired"] = "EXPIRED";
+})(TriggerUpdateType || (exports.TriggerUpdateType = TriggerUpdateType = {}));
+var TriggerResultStatus;
+(function (TriggerResultStatus) {
+    TriggerResultStatus["Filled"] = "filled";
+    TriggerResultStatus["Accepted"] = "accepted";
+    TriggerResultStatus["Rejected"] = "rejected";
+})(TriggerResultStatus || (exports.TriggerResultStatus = TriggerResultStatus = {}));
 var Resolution;
 (function (Resolution) {
-    /** 1 minute candles */
-    Resolution["OneMinute"] = "1m";
-    /** 5 minute candles */
-    Resolution["FiveMinutes"] = "5m";
-    /** 15 minute candles */
-    Resolution["FifteenMinutes"] = "15m";
-    /** 1 hour candles */
-    Resolution["OneHour"] = "1h";
-    /** 4 hour candles */
-    Resolution["FourHours"] = "4h";
-    /** 1 day candles */
-    Resolution["OneDay"] = "1d";
+    Resolution["Minute1"] = "1m";
+    Resolution["Minute5"] = "5m";
+    Resolution["Minute15"] = "15m";
+    Resolution["Hour1"] = "1h";
+    Resolution["Hour4"] = "4h";
+    Resolution["Day1"] = "1d";
 })(Resolution || (exports.Resolution = Resolution = {}));
+function resolutionSeconds(resolution) {
+    switch (resolution) {
+        case Resolution.Minute1:
+            return 60;
+        case Resolution.Minute5:
+            return 300;
+        case Resolution.Minute15:
+            return 900;
+        case Resolution.Hour1:
+            return 3600;
+        case Resolution.Hour4:
+            return 21600;
+        case Resolution.Day1:
+            return 86400;
+    }
+}
+function deriveOrderbookId(baseToken, quoteToken) {
+    return `${baseToken.slice(0, 8)}_${quoteToken.slice(0, 8)}`;
+}
 //# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,uBAAuB;IACvB,8BAAgB,CAAA;IAChB,uBAAuB;IACvB,gCAAkB,CAAA;IAClB,wBAAwB;IACxB,oCAAsB,CAAA;IACtB,qBAAqB;IACrB,4BAAc,CAAA;IACd,qBAAqB;IACrB,8BAAgB,CAAA;IAChB,oBAAoB;IACpB,2BAAa,CAAA;AACf,CAAC,EAbW,UAAU,0BAAV,UAAU,QAarB","sourcesContent":["/**\n * Price history candle resolution.\n * Used by both REST API and WebSocket for price history queries.\n */\nexport enum Resolution {\n  /** 1 minute candles */\n  OneMinute = \"1m\",\n  /** 5 minute candles */\n  FiveMinutes = \"5m\",\n  /** 15 minute candles */\n  FifteenMinutes = \"15m\",\n  /** 1 hour candles */\n  OneHour = \"1h\",\n  /** 4 hour candles */\n  FourHours = \"4h\",\n  /** 1 day candles */\n  OneDay = \"1d\",\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":";;;AAKA,sCAEC;AAED,kCAEC;AAOD,8BAEC;AA+CD,8CAeC;AAED,8CAEC;AAjFD,SAAgB,aAAa,CAAC,KAAa;IACzC,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,KAAkB,CAAC;AAC5B,CAAC;AAED,IAAY,IAGX;AAHD,WAAY,IAAI;IACd,mBAAW,CAAA;IACX,mBAAW,CAAA;AACb,CAAC,EAHW,IAAI,oBAAJ,IAAI,QAGf;AAED,SAAgB,SAAS,CAAC,IAAU;IAClC,OAAO,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,0BAAW,CAAA;IACX,0BAAW,CAAA;IACX,0BAAW,CAAA;AACb,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAED,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;AACrB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,0CAAuB,CAAA;IACvB,oCAAiB,CAAA;IACjB,gDAA6B,CAAA;AAC/B,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,4CAAuB,CAAA;IACvB,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;AACrB,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B;AAED,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,4CAAqB,CAAA;AACvB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAED,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,4BAAc,CAAA;IACd,4BAAc,CAAA;IACd,8BAAgB,CAAA;IAChB,0BAAY,CAAA;IACZ,0BAAY,CAAA;IACZ,yBAAW,CAAA;AACb,CAAC,EAPW,UAAU,0BAAV,UAAU,QAOrB;AAED,SAAgB,iBAAiB,CAAC,UAAsB;IACtD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,OAAO;YACrB,OAAO,EAAE,CAAC;QACZ,KAAK,UAAU,CAAC,OAAO;YACrB,OAAO,GAAG,CAAC;QACb,KAAK,UAAU,CAAC,QAAQ;YACtB,OAAO,GAAG,CAAC;QACb,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,IAAI,CAAC;QACd,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,KAAK,CAAC;QACf,KAAK,UAAU,CAAC,IAAI;YAClB,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,SAAiB,EAAE,UAAkB;IACrE,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAiB,CAAC;AAC7E,CAAC","sourcesContent":["export type Branded<T, Brand extends string> = T & { readonly __brand: Brand };\n\nexport type OrderBookId = Branded<string, \"OrderBookId\">;\nexport type PubkeyStr = Branded<string, \"PubkeyStr\">;\n\nexport function asOrderBookId(value: string): OrderBookId {\n  return value as OrderBookId;\n}\n\nexport function asPubkeyStr(value: string): PubkeyStr {\n  return value as PubkeyStr;\n}\n\nexport enum Side {\n  Bid = \"bid\",\n  Ask = \"ask\",\n}\n\nexport function sideLabel(side: Side): \"Buy\" | \"Sell\" {\n  return side === Side.Bid ? \"Buy\" : \"Sell\";\n}\n\nexport enum TimeInForce {\n  Gtc = \"GTC\",\n  Ioc = \"IOC\",\n  Fok = \"FOK\",\n  Alo = \"ALO\",\n}\n\nexport enum TriggerType {\n  TakeProfit = \"TP\",\n  StopLoss = \"SL\",\n}\n\nexport enum TriggerStatus {\n  Triggered = \"triggered\",\n  Failed = \"failed\",\n  Expired = \"expired\",\n}\n\nexport enum OrderUpdateType {\n  Placement = \"PLACEMENT\",\n  Update = \"UPDATE\",\n  Cancellation = \"CANCELLATION\",\n}\n\nexport enum TriggerUpdateType {\n  Triggered = \"TRIGGERED\",\n  Failed = \"FAILED\",\n  Expired = \"EXPIRED\",\n}\n\nexport enum TriggerResultStatus {\n  Filled = \"filled\",\n  Accepted = \"accepted\",\n  Rejected = \"rejected\",\n}\n\nexport enum Resolution {\n  Minute1 = \"1m\",\n  Minute5 = \"5m\",\n  Minute15 = \"15m\",\n  Hour1 = \"1h\",\n  Hour4 = \"4h\",\n  Day1 = \"1d\",\n}\n\nexport function resolutionSeconds(resolution: Resolution): number {\n  switch (resolution) {\n    case Resolution.Minute1:\n      return 60;\n    case Resolution.Minute5:\n      return 300;\n    case Resolution.Minute15:\n      return 900;\n    case Resolution.Hour1:\n      return 3600;\n    case Resolution.Hour4:\n      return 21600;\n    case Resolution.Day1:\n      return 86400;\n  }\n}\n\nexport function deriveOrderbookId(baseToken: string, quoteToken: string): OrderBookId {\n  return `${baseToken.slice(0, 8)}_${quoteToken.slice(0, 8)}` as OrderBookId;\n}\n\nexport interface SubmitOrderRequest {\n  maker: string;\n  nonce: number;\n  market_pubkey: string;\n  base_token: string;\n  quote_token: string;\n  side: number;\n  amount_in: string;\n  amount_out: string;\n  expiration?: number;\n  signature: string;\n  orderbook_id: string;\n  tif?: TimeInForce;\n  trigger_price?: number;\n  trigger_type?: TriggerType;\n}\n"]}

package/dist/ws/client.d.ts

@@ -0,0 +1,35 @@
+import { ReadyState, type MessageOut, type WsConfig, type WsEvent } from "./index";
+import { type SubscribeParams, type UnsubscribeParams } from "./subscriptions";
+export declare class WsClient {
+    private readonly config;
+    private readonly authTokenRef?;
+    private socket?;
+    private reconnectAttempts;
+    private userInitiatedClose;
+    private pingTimer?;
+    private pongTimer?;
+    private callbacks;
+    private readonly activeSubscriptions;
+    private readonly pendingMessages;
+    constructor(config?: Partial<WsConfig>, authTokenRef?: () => Promise<string | undefined>);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(message: MessageOut): void;
+    subscribe(params: SubscribeParams): void;
+    unsubscribe(params: UnsubscribeParams): void;
+    isConnected(): boolean;
+    readyState(): ReadyState;
+    on(callback: (event: WsEvent) => void): () => void;
+    private emit;
+    private connectInternal;
+    private handleIncoming;
+    private handleClose;
+    private backoffDelayMs;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private resetPongTimeout;
+    private trackMessage;
+    private flushPendingMessages;
+    private resubscribeAll;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/ws/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,UAAU,EAEV,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,OAAO,EAEb,MAAM,SAAS,CAAC;AACjB,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoC;IAClE,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;gBAExC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKlF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAW/B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI5C,WAAW,IAAI,OAAO;IAItB,UAAU,IAAI,UAAU;IAOxB,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlD,OAAO,CAAC,IAAI;YAUE,eAAe;IAwC7B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,cAAc;CAMvB"}

package/dist/ws/client.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WsClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const index_1 = require("./index");
+const subscriptions_1 = require("./subscriptions");
+class WsClient {
+    config;
+    authTokenRef;
+    socket;
+    reconnectAttempts = 0;
+    userInitiatedClose = false;
+    pingTimer;
+    pongTimer;
+    callbacks = [];
+    activeSubscriptions = [];
+    pendingMessages = [];
+    constructor(config, authTokenRef) {
+        this.config = { ...index_1.WS_DEFAULT_CONFIG, ...config };
+        this.authTokenRef = authTokenRef;
+    }
+    async connect() {
+        if (this.socket && this.readyState() === index_1.ReadyState.Open) {
+            return;
+        }
+        await this.connectInternal();
+    }
+    async disconnect() {
+        if (!this.socket) {
+            return;
+        }
+        this.stopHeartbeat();
+        const socket = this.socket;
+        this.socket = undefined;
+        this.userInitiatedClose = true;
+        await new Promise((resolve) => {
+            socket.once("close", () => {
+                resolve();
+            });
+            socket.close(1000, "Client disconnect");
+        });
+    }
+    send(message) {
+        this.trackMessage(message);
+        if (!this.socket || this.readyState() !== index_1.ReadyState.Open) {
+            this.pendingMessages.push(message);
+            return;
+        }
+        this.socket.send(JSON.stringify(message));
+    }
+    subscribe(params) {
+        this.send({ method: "subscribe", params });
+    }
+    unsubscribe(params) {
+        this.send({ method: "unsubscribe", params });
+    }
+    isConnected() {
+        return this.readyState() === index_1.ReadyState.Open;
+    }
+    readyState() {
+        if (!this.socket) {
+            return index_1.ReadyState.Closed;
+        }
+        return (0, index_1.readyStateFrom)(this.socket.readyState);
+    }
+    on(callback) {
+        this.callbacks.push(callback);
+        return () => {
+            this.callbacks = this.callbacks.filter((cb) => cb !== callback);
+        };
+    }
+    emit(event) {
+        for (const callback of this.callbacks) {
+            try {
+                callback(event);
+            }
+            catch {
+                // Consumer callback errors should not break WS loop.
+            }
+        }
+    }
+    async connectInternal() {
+        const headers = {};
+        const token = this.authTokenRef ? await this.authTokenRef() : undefined;
+        if (token) {
+            headers.Cookie = `auth_token=${token}`;
+        }
+        const socket = new ws_1.default(this.config.url, { headers });
+        this.socket = socket;
+        await new Promise((resolve, reject) => {
+            socket.once("open", () => {
+                this.reconnectAttempts = 0;
+                this.startHeartbeat();
+                this.flushPendingMessages();
+                this.resubscribeAll();
+                this.emit({ type: "Connected" });
+                resolve();
+            });
+            socket.once("error", (error) => {
+                reject(error);
+            });
+            socket.on("message", (raw) => {
+                this.handleIncoming(raw.toString());
+            });
+            socket.on("close", (code, reason) => {
+                const manualClose = this.userInitiatedClose;
+                this.userInitiatedClose = false;
+                this.stopHeartbeat();
+                this.emit({ type: "Disconnected", code, reason: reason.toString() });
+                if (!manualClose) {
+                    this.handleClose(code);
+                }
+            });
+        });
+    }
+    handleIncoming(raw) {
+        let message;
+        try {
+            message = (0, index_1.parseMessageIn)(raw);
+        }
+        catch (error) {
+            this.emit({
+                type: "Error",
+                error: `Deserialization error: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            return;
+        }
+        if (message.type === "pong") {
+            this.resetPongTimeout();
+        }
+        this.emit({ type: "Message", message });
+    }
+    handleClose(code) {
+        if (!this.config.reconnect) {
+            return;
+        }
+        if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
+            this.emit({ type: "MaxReconnectReached" });
+            return;
+        }
+        this.reconnectAttempts += 1;
+        const isRateLimited = code === 1008;
+        const backoffMs = this.backoffDelayMs(this.reconnectAttempts, isRateLimited);
+        setTimeout(() => {
+            void this.connectInternal().catch((error) => {
+                this.emit({
+                    type: "Error",
+                    error: `Connection failed: ${error instanceof Error ? error.message : String(error)}`,
+                });
+                this.handleClose(1011);
+            });
+        }, backoffMs);
+    }
+    backoffDelayMs(attempt, isRateLimited) {
+        const exponent = Math.max(0, attempt - 1);
+        const raw = this.config.baseReconnectDelayMs * 2 ** exponent;
+        const jitter = Math.random() * raw;
+        const rateLimitPenalty = isRateLimited ? this.config.baseReconnectDelayMs : 0;
+        return Math.floor(Math.min(raw + jitter + rateLimitPenalty, 60_000));
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.pingTimer = setInterval(() => {
+            this.send((0, index_1.ping)());
+            this.resetPongTimeout();
+        }, this.config.pingIntervalMs);
+    }
+    stopHeartbeat() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = undefined;
+        }
+        if (this.pongTimer) {
+            clearTimeout(this.pongTimer);
+            this.pongTimer = undefined;
+        }
+    }
+    resetPongTimeout() {
+        if (this.pongTimer) {
+            clearTimeout(this.pongTimer);
+        }
+        this.pongTimer = setTimeout(() => {
+            if (this.socket && this.readyState() === index_1.ReadyState.Open) {
+                this.socket.close(4000, "Pong timeout");
+            }
+        }, this.config.pongTimeoutMs);
+    }
+    trackMessage(message) {
+        if (message.method === "subscribe") {
+            const key = (0, subscriptions_1.subscriptionKey)(message.params);
+            const existing = this.activeSubscriptions.find((params) => (0, subscriptions_1.subscriptionKey)(params) === key);
+            if (!existing) {
+                this.activeSubscriptions.push(message.params);
+            }
+            return;
+        }
+        if (message.method === "unsubscribe") {
+            const next = this.activeSubscriptions.filter((params) => !(0, subscriptions_1.unsubscribeMatches)(params, message.params));
+            this.activeSubscriptions.length = 0;
+            this.activeSubscriptions.push(...next);
+        }
+    }
+    flushPendingMessages() {
+        if (!this.socket || this.readyState() !== index_1.ReadyState.Open) {
+            return;
+        }
+        while (this.pendingMessages.length > 0) {
+            const message = this.pendingMessages.shift();
+            if (!message) {
+                continue;
+            }
+            this.socket.send(JSON.stringify(message));
+        }
+    }
+    resubscribeAll() {
+        for (const params of this.activeSubscriptions) {
+            this.pendingMessages.push({ method: "subscribe", params });
+        }
+        this.flushPendingMessages();
+    }
+}
+exports.WsClient = WsClient;
+//# sourceMappingURL=client.js.map

package/dist/ws/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"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","sourcesContent":["import WebSocket from \"ws\";\nimport {\n  parseMessageIn,\n  ping,\n  readyStateFrom,\n  ReadyState,\n  type MessageIn,\n  type MessageOut,\n  type WsConfig,\n  type WsEvent,\n  WS_DEFAULT_CONFIG,\n} from \"./index\";\nimport {\n  subscriptionKey,\n  unsubscribeMatches,\n  type SubscribeParams,\n  type UnsubscribeParams,\n} from \"./subscriptions\";\n\nexport class WsClient {\n  private readonly config: WsConfig;\n  private readonly authTokenRef?: () => Promise<string | undefined>;\n  private socket?: WebSocket;\n  private reconnectAttempts = 0;\n  private userInitiatedClose = false;\n  private pingTimer?: NodeJS.Timeout;\n  private pongTimer?: NodeJS.Timeout;\n  private callbacks: Array<(event: WsEvent) => void> = [];\n  private readonly activeSubscriptions: SubscribeParams[] = [];\n  private readonly pendingMessages: MessageOut[] = [];\n\n  constructor(config?: Partial<WsConfig>, authTokenRef?: () => Promise<string | undefined>) {\n    this.config = { ...WS_DEFAULT_CONFIG, ...config };\n    this.authTokenRef = authTokenRef;\n  }\n\n  async connect(): Promise<void> {\n    if (this.socket && this.readyState() === ReadyState.Open) {\n      return;\n    }\n\n    await this.connectInternal();\n  }\n\n  async disconnect(): Promise<void> {\n    if (!this.socket) {\n      return;\n    }\n\n    this.stopHeartbeat();\n\n    const socket = this.socket;\n    this.socket = undefined;\n    this.userInitiatedClose = true;\n\n    await new Promise<void>((resolve) => {\n      socket.once(\"close\", () => {\n        resolve();\n      });\n      socket.close(1000, \"Client disconnect\");\n    });\n  }\n\n  send(message: MessageOut): void {\n    this.trackMessage(message);\n\n    if (!this.socket || this.readyState() !== ReadyState.Open) {\n      this.pendingMessages.push(message);\n      return;\n    }\n\n    this.socket.send(JSON.stringify(message));\n  }\n\n  subscribe(params: SubscribeParams): void {\n    this.send({ method: \"subscribe\", params });\n  }\n\n  unsubscribe(params: UnsubscribeParams): void {\n    this.send({ method: \"unsubscribe\", params });\n  }\n\n  isConnected(): boolean {\n    return this.readyState() === ReadyState.Open;\n  }\n\n  readyState(): ReadyState {\n    if (!this.socket) {\n      return ReadyState.Closed;\n    }\n    return readyStateFrom(this.socket.readyState);\n  }\n\n  on(callback: (event: WsEvent) => void): () => void {\n    this.callbacks.push(callback);\n    return () => {\n      this.callbacks = this.callbacks.filter((cb) => cb !== callback);\n    };\n  }\n\n  private emit(event: WsEvent): void {\n    for (const callback of this.callbacks) {\n      try {\n        callback(event);\n      } catch {\n        // Consumer callback errors should not break WS loop.\n      }\n    }\n  }\n\n  private async connectInternal(): Promise<void> {\n    const headers: Record<string, string> = {};\n    const token = this.authTokenRef ? await this.authTokenRef() : undefined;\n    if (token) {\n      headers.Cookie = `auth_token=${token}`;\n    }\n\n    const socket = new WebSocket(this.config.url, { headers });\n    this.socket = socket;\n\n    await new Promise<void>((resolve, reject) => {\n      socket.once(\"open\", () => {\n        this.reconnectAttempts = 0;\n        this.startHeartbeat();\n        this.flushPendingMessages();\n        this.resubscribeAll();\n        this.emit({ type: \"Connected\" });\n        resolve();\n      });\n\n      socket.once(\"error\", (error) => {\n        reject(error);\n      });\n\n      socket.on(\"message\", (raw) => {\n        this.handleIncoming(raw.toString());\n      });\n\n      socket.on(\"close\", (code, reason) => {\n        const manualClose = this.userInitiatedClose;\n        this.userInitiatedClose = false;\n        this.stopHeartbeat();\n        this.emit({ type: \"Disconnected\", code, reason: reason.toString() });\n        if (!manualClose) {\n          this.handleClose(code);\n        }\n      });\n    });\n  }\n\n  private handleIncoming(raw: string): void {\n    let message: MessageIn;\n\n    try {\n      message = parseMessageIn(raw);\n    } catch (error) {\n      this.emit({\n        type: \"Error\",\n        error: `Deserialization error: ${error instanceof Error ? error.message : String(error)}`,\n      });\n      return;\n    }\n\n    if (message.type === \"pong\") {\n      this.resetPongTimeout();\n    }\n\n    this.emit({ type: \"Message\", message });\n  }\n\n  private handleClose(code: number): void {\n    if (!this.config.reconnect) {\n      return;\n    }\n\n    if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {\n      this.emit({ type: \"MaxReconnectReached\" });\n      return;\n    }\n\n    this.reconnectAttempts += 1;\n    const isRateLimited = code === 1008;\n    const backoffMs = this.backoffDelayMs(this.reconnectAttempts, isRateLimited);\n\n    setTimeout(() => {\n      void this.connectInternal().catch((error) => {\n        this.emit({\n          type: \"Error\",\n          error: `Connection failed: ${error instanceof Error ? error.message : String(error)}`,\n        });\n        this.handleClose(1011);\n      });\n    }, backoffMs);\n  }\n\n  private backoffDelayMs(attempt: number, isRateLimited: boolean): number {\n    const exponent = Math.max(0, attempt - 1);\n    const raw = this.config.baseReconnectDelayMs * 2 ** exponent;\n    const jitter = Math.random() * raw;\n    const rateLimitPenalty = isRateLimited ? this.config.baseReconnectDelayMs : 0;\n    return Math.floor(Math.min(raw + jitter + rateLimitPenalty, 60_000));\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n\n    this.pingTimer = setInterval(() => {\n      this.send(ping());\n      this.resetPongTimeout();\n    }, this.config.pingIntervalMs);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.pingTimer) {\n      clearInterval(this.pingTimer);\n      this.pingTimer = undefined;\n    }\n    if (this.pongTimer) {\n      clearTimeout(this.pongTimer);\n      this.pongTimer = undefined;\n    }\n  }\n\n  private resetPongTimeout(): void {\n    if (this.pongTimer) {\n      clearTimeout(this.pongTimer);\n    }\n\n    this.pongTimer = setTimeout(() => {\n      if (this.socket && this.readyState() === ReadyState.Open) {\n        this.socket.close(4000, \"Pong timeout\");\n      }\n    }, this.config.pongTimeoutMs);\n  }\n\n  private trackMessage(message: MessageOut): void {\n    if (message.method === \"subscribe\") {\n      const key = subscriptionKey(message.params);\n      const existing = this.activeSubscriptions.find((params) => subscriptionKey(params) === key);\n      if (!existing) {\n        this.activeSubscriptions.push(message.params);\n      }\n      return;\n    }\n\n    if (message.method === \"unsubscribe\") {\n      const next = this.activeSubscriptions.filter(\n        (params) => !unsubscribeMatches(params, message.params)\n      );\n      this.activeSubscriptions.length = 0;\n      this.activeSubscriptions.push(...next);\n    }\n  }\n\n  private flushPendingMessages(): void {\n    if (!this.socket || this.readyState() !== ReadyState.Open) {\n      return;\n    }\n\n    while (this.pendingMessages.length > 0) {\n      const message = this.pendingMessages.shift();\n      if (!message) {\n        continue;\n      }\n      this.socket.send(JSON.stringify(message));\n    }\n  }\n\n  private resubscribeAll(): void {\n    for (const params of this.activeSubscriptions) {\n      this.pendingMessages.push({ method: \"subscribe\", params });\n    }\n    this.flushPendingMessages();\n  }\n}\n"]}

package/dist/ws/index.d.ts

@@ -0,0 +1,109 @@
+import type { MarketEvent } from "../domain/market";
+import type { AuthUpdate, UserUpdate } from "../domain/order";
+import type { OrderBook, WsTickerData } from "../domain/orderbook";
+import type { PriceHistory } from "../domain/price_history";
+import type { WsTrade } from "../domain/trade";
+import type { OrderBookId, PubkeyStr, Resolution } from "../shared";
+export * from "./client";
+export * from "./subscriptions";
+export type MessageOut = {
+    method: "subscribe";
+    params: import("./subscriptions").SubscribeParams;
+} | {
+    method: "unsubscribe";
+    params: import("./subscriptions").UnsubscribeParams;
+} | {
+    method: "ping";
+};
+export type MessageIn = {
+    type: "book_update";
+    version: number;
+    data: OrderBook;
+} | {
+    type: "pong";
+    version: number;
+    data: Record<string, never>;
+} | {
+    type: "user";
+    version: number;
+    data: UserUpdate;
+} | {
+    type: "error";
+    version: number;
+    data: WsError;
+} | {
+    type: "price_history";
+    version: number;
+    data: PriceHistory;
+} | {
+    type: "trades";
+    version: number;
+    data: WsTrade;
+} | {
+    type: "auth";
+    version: number;
+    data: AuthUpdate;
+} | {
+    type: "ticker";
+    version: number;
+    data: WsTickerData;
+} | {
+    type: "market";
+    version: number;
+    data: MarketEvent;
+};
+export type Kind = MessageIn;
+export interface WsError {
+    error: string;
+    code?: string;
+    orderbook_id?: string;
+    wallet_address?: string;
+    hint?: string;
+    details?: string;
+}
+export type WsEvent = {
+    type: "Message";
+    message: MessageIn;
+} | {
+    type: "Connected";
+} | {
+    type: "Disconnected";
+    code?: number;
+    reason: string;
+} | {
+    type: "Error";
+    error: string;
+} | {
+    type: "MaxReconnectReached";
+};
+export interface WsConfig {
+    url: string;
+    reconnect: boolean;
+    maxReconnectAttempts: number;
+    baseReconnectDelayMs: number;
+    pingIntervalMs: number;
+    pongTimeoutMs: number;
+}
+export declare const WS_DEFAULT_CONFIG: WsConfig;
+export declare enum ReadyState {
+    Connecting = 0,
+    Open = 1,
+    Closing = 2,
+    Closed = 3
+}
+export declare function readyStateFrom(value: number): ReadyState;
+export declare function ping(): MessageOut;
+export declare function subscribeBooks(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeBooks(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeTrades(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeTrades(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeUser(walletAddress: PubkeyStr): MessageOut;
+export declare function unsubscribeUser(walletAddress: PubkeyStr): MessageOut;
+export declare function subscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut;
+export declare function unsubscribePriceHistory(orderbookId: OrderBookId, resolution: Resolution): MessageOut;
+export declare function subscribeTicker(orderbookIds: OrderBookId[]): MessageOut;
+export declare function unsubscribeTicker(orderbookIds: OrderBookId[]): MessageOut;
+export declare function subscribeMarket(marketPubkey: PubkeyStr): MessageOut;
+export declare function unsubscribeMarket(marketPubkey: PubkeyStr): MessageOut;
+export declare function parseMessageIn(input: string): MessageIn;
+//# sourceMappingURL=index.d.ts.map

package/dist/ws/index.d.ts.map

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