@stryke-xyz/premarket-sdk 1.2.1 → 1.2.2

package/dist/types/sync/clients/activity-client.d.ts

@@ -24,63 +24,70 @@ export interface OrderFillEvent {
     /** Blockchain timestamp (seconds since epoch, null for user channel) */
     timestamp: string | null;
 }
+export interface OrderUpdateEvent {
+    type: "fill" | "order_update";
+    orderHash: string;
+    marketId?: string;
+    tokenId?: string;
+    status?: string;
+    remainingAmount?: string;
+    [extra: string]: unknown;
+}
 export interface ActivityClientConfig {
     wsUrl: string;
-    /** Subscribe to fills for this market (orders_matched:marketId) */
-    marketId?: string;
-    /** Subscribe to fills for this user address (user_info:address) */
-    userAddress?: string;
     heartbeatIntervalMs?: number;
     heartbeatTimeoutMs?: number;
-    maxReconnectAttempts?: number;
-    initialReconnectDelayMs?: number;
     maxReconnectDelayMs?: number;
+    initialReconnectDelayMs?: number;
 }
+type FillCallback = (event: OrderFillEvent) => void;
+type OrderUpdateCallback = (event: OrderUpdateEvent) => void;
 /**
- * Client for activity streams: order fills per market (orders_matched) and per user (user_info).
- * Connects to the same worker as MarketDepthSyncClient; use WORKER_MODES that include "activity".
+ * Multi-market, multi-user activity sync client.
  *
- * No ordering or gap handling — we accept every order_fill message as it arrives.
+ * One WebSocket handles all subscriptions. Use:
+ *   - subscribeMarket(marketId) / unsubscribeMarket(marketId) for fill streams
+ *   - subscribeUser(address)   / unsubscribeUser(address)    for user order updates
+ *
+ * All subscriptions are re-sent automatically on reconnect.
  */
 export declare class ActivitySyncClient {
     private ws;
     private config;
     private status;
-    private fillListeners;
-    private userFillListeners;
-    private marketFillListeners;
-    private statusListeners;
     private shouldBeConnected;
     private reconnectAttempts;
     private reconnectTimeoutId;
     private heartbeatIntervalId;
     private heartbeatTimeoutId;
-    private lastPongTime;
-    private visibilityChangeHandler;
+    /** Active market subscriptions: marketId → Set of callbacks */
+    private marketListeners;
+    /** Active user subscriptions: address → Set of callbacks */
+    private userListeners;
+    /** Generic fill listeners (all markets) */
+    private fillListeners;
+    /** Status listeners */
+    private statusListeners;
     constructor(config: ActivityClientConfig);
-    /** Connects to the activity websocket and subscribes to market and/or user channels. */
     connect(): Promise<void>;
+    disconnect(): void;
+    getStatus(): SyncStatus;
+    isSynced(): boolean;
+    subscribeMarket(marketId: string, callback: FillCallback): () => void;
+    subscribeUser(address: string, callback: OrderUpdateCallback): () => void;
+    /** Fires for every fill event regardless of market or user channel. */
+    onFill(callback: FillCallback): () => void;
+    onStatus(callback: (s: SyncStatus) => void): () => void;
+    private send;
+    private resubscribeAll;
+    private handleMessage;
+    private normalizeFill;
     private startHeartbeat;
     private stopHeartbeat;
     private clearHeartbeatTimeout;
     private clearReconnectTimeout;
-    private setupVisibilityChangeHandler;
-    private removeVisibilityChangeHandler;
-    private checkConnectionHealth;
     private handleConnectionLost;
     private scheduleReconnect;
     private setStatus;
-    getStatus(): SyncStatus;
-    /** Returns true once the websocket has an active subscription. */
-    isSynced(): boolean;
-    /** Registers a listener for connection lifecycle updates. */
-    onStatus(callback: (status: SyncStatus) => void): () => void;
-    /** Subscribes to all normalized fill events regardless of source channel. */
-    onOrderFill(callback: (event: OrderFillEvent) => void): () => void;
-    /** Subscribe to fills from user_info channel only (user's orders being filled) */
-    onUserFill(callback: (event: OrderFillEvent) => void): () => void;
-    /** Subscribe to fills from orders_matched channel only (market activity) */
-    onMarketFill(callback: (event: OrderFillEvent) => void): () => void;
-    /** Closes the websocket, unsubscribes active channels, and stops reconnects. */
-    disconnect(): Promise<void>;
 }
+export {};

package/dist/types/sync/clients/order-client.d.ts

@@ -3,6 +3,11 @@ export interface DepthLevel {
     price: string;
     depth: string;
 }
+/** A market + its token IDs to subscribe to. */
+export interface MarketSpec {
+    marketId: string;
+    tokenIds: string[];
+}
 /** Current depth state for a token within a market subscription. */
 export interface TokenDepthSnapshot {
     tokenId: string;
@@ -32,11 +37,17 @@ export interface DepthUpdate {
     startSeq: number;
     endSeq: number;
 }
-/** Configuration for the market depth websocket client. */
+/**
+ * Configuration for the market depth websocket client.
+ *
+ * Supports multiple markets over a single WebSocket connection.
+ * Markets can be added/removed dynamically via subscribeMarket / unsubscribeMarket
+ * without closing the connection.
+ */
 export interface MarketDepthClientConfig {
     wsUrl: string;
-    marketId: string;
-    tokenIds: string[];
+    /** Initial market subscriptions. More can be added later via subscribeMarket(). */
+    markets?: MarketSpec[];
     /** Heartbeat interval in ms (default: 30000) */
     heartbeatIntervalMs?: number;
     /** Heartbeat timeout - if no pong received within this time, reconnect (default: 10000) */
@@ -48,25 +59,42 @@ export interface MarketDepthClientConfig {
     /** Max reconnect delay in ms (default: 30000) */
     maxReconnectDelayMs?: number;
 }
-interface TokenDepthState {
-    bids: Map<string, string>;
-    asks: Map<string, string>;
-    bestBid: string | null;
-    bestAsk: string | null;
-    lastPrice: string | null;
-    seq: number;
+/** @deprecated Use MarketDepthClientConfig with markets[] instead of marketId+tokenIds. */
+export interface LegacyMarketDepthClientConfig extends MarketDepthClientConfig {
+    marketId?: string;
+    tokenIds?: string[];
 }
 /**
- * Client for syncing orderbook depth data for multiple tokens in a market.
- * Seq is per market+token (gapless, monotonic). Each token tracks its own seq for dedup and gap detection.
+ * Client for syncing orderbook depth data for one or more markets over a
+ * single persistent WebSocket connection.
+ *
+ * Usage:
+ *   const client = new MarketDepthSyncClient({ wsUrl: "wss://..." });
+ *   await client.connect();
+ *
+ *   // Subscribe to markets dynamically (e.g. when they scroll into view)
+ *   client.subscribeMarket("5", ["0xabc..."]);
+ *
+ *   // Unsubscribe without closing the connection (e.g. scrolled out of view)
+ *   client.unsubscribeMarket("5");
+ *
+ *   // Listen for updates
+ *   const offDelta = client.onDelta((marketId, update) => { ... });
+ *   const offSnap  = client.onSnapshot((marketId, snapshots) => { ... });
+ *
+ *   // Full disconnect (app teardown)
+ *   await client.disconnect();
  */
 export declare class MarketDepthSyncClient {
     private ws;
     private config;
     private status;
     private tokenStates;
-    private frameQueue;
-    private isProcessing;
+    private activeSubscriptions;
+    private tokenToMarket;
+    private syncedMarkets;
+    private frameQueues;
+    private processingMarkets;
     private statusListeners;
     private snapshotListeners;
     private deltaListeners;
@@ -77,9 +105,44 @@ export declare class MarketDepthSyncClient {
     private heartbeatTimeoutId;
     private lastPongTime;
     private visibilityChangeHandler;
-    constructor(config: MarketDepthClientConfig);
-    /** Connects to the market depth websocket and hydrates token snapshots. */
+    constructor(config: LegacyMarketDepthClientConfig);
+    /** Open the WebSocket connection and subscribe to all configured markets. */
     connect(): Promise<void>;
+    /**
+     * Subscribe to a market's depth. If the WebSocket is already open, sends the
+     * `subscribe_market` message immediately. Otherwise, the subscription is queued
+     * and sent when the connection opens. Calling this for an already-subscribed
+     * market re-requests a fresh snapshot.
+     */
+    subscribeMarket(marketId: string, tokenIds: string[]): void;
+    /**
+     * Unsubscribe from a market. Sends `unsubscribe_market` to the server and
+     * clears local state for that market's tokens. The WebSocket connection is
+     * kept open for other subscriptions.
+     */
+    unsubscribeMarket(marketId: string): void;
+    /** Fully disconnect and stop reconnecting. */
+    disconnect(): Promise<void>;
+    getStatus(): SyncStatus;
+    isSynced(): boolean;
+    isMarketSynced(marketId: string): boolean;
+    getBids(tokenId: string): DepthLevel[];
+    getAsks(tokenId: string): DepthLevel[];
+    getBestBid(tokenId: string): string | null;
+    getBestAsk(tokenId: string): string | null;
+    getLastPrice(tokenId: string): string | null;
+    onSnapshot(listener: (marketId: string, snapshots: TokenDepthSnapshot[]) => void): () => void;
+    onDelta(listener: (marketId: string, update: DepthUpdate) => void): () => void;
+    onStatus(listener: (status: SyncStatus) => void): () => void;
+    private _sendSubscribeMarket;
+    private handleSubscribedMarket;
+    private handleDepthUpdate;
+    private handleMarketStateUpdate;
+    private handleLastPriceUpdate;
+    private emitOutOfBandUpdate;
+    private processFrameQueue;
+    private applyLevel;
+    private setStatus;
     private setupVisibilityChangeHandler;
     private removeVisibilityChangeHandler;
     private checkConnectionHealth;
@@ -90,46 +153,4 @@ export declare class MarketDepthSyncClient {
     private scheduleReconnect;
     private clearReconnectTimeout;
     private performReconnect;
-    private handleSubscribedMarket;
-    private handleDepthUpdate;
-    private handleMarketStateUpdate;
-    private handleLastPriceUpdate;
-    /** Emit a delta with empty levels for events that mutate side-state but no levels (market_state, last_price). */
-    private emitOutOfBandUpdate;
-    private processFrameQueue;
-    private applyLevel;
-    private setStatus;
-    /** Returns the current connection lifecycle state. */
-    getStatus(): SyncStatus;
-    /** Returns true once initial depth snapshots have been received. */
-    isSynced(): boolean;
-    /** Returns all token ids currently tracked by the client. */
-    getTokenIds(): string[];
-    /** Returns raw internal token state for advanced integrations. */
-    getTokenState(tokenId: string): TokenDepthState | undefined;
-    /** Returns the current bid ladder for a token, sorted from highest to lowest price. */
-    getBids(tokenId: string): DepthLevel[];
-    /** Returns the current ask ladder for a token, sorted from lowest to highest price. */
-    getAsks(tokenId: string): DepthLevel[];
-    /** Returns the best bid price for a token, if known. */
-    getBestBid(tokenId: string): string | null;
-    /** Returns the best ask price for a token, if known. */
-    getBestAsk(tokenId: string): string | null;
-    /** Returns the latest trade price tracked for a token, if any. */
-    getLastPrice(tokenId: string): string | null;
-    /** Returns the latest applied sequence id for a token. */
-    getSeq(tokenId: string): number;
-    /** Returns the current bid-ask spread for a token when both sides are available. */
-    getSpread(tokenId: string): number | null;
-    /** Returns the depth resting at one exact price level on a given side. */
-    getDepthAtPrice(tokenId: string, side: "bid" | "ask", price: string): string | null;
-    /** Registers a listener for connection lifecycle updates. */
-    onStatus(callback: (status: SyncStatus) => void): () => void;
-    /** Registers a listener that receives full snapshots for all subscribed tokens. */
-    onSnapshot(callback: (snapshots: TokenDepthSnapshot[]) => void): () => void;
-    /** Registers a listener for normalized incremental depth updates. */
-    onDelta(callback: (marketId: string, update: DepthUpdate) => void): () => void;
-    /** Closes the websocket and stops automatic reconnection attempts. */
-    disconnect(): Promise<void>;
 }
-export {};

package/dist/types/sync/index.d.ts

@@ -1,5 +1,5 @@
 export { MarketDepthSyncClient } from "./clients/order-client.js";
 export { ActivitySyncClient } from "./clients/activity-client.js";
-export type { DepthLevel, TokenDepthSnapshot, DepthLevelUpdate, DepthUpdate, MarketDepthClientConfig, } from "./clients/order-client.js";
-export type { OrderFillEvent, ActivityClientConfig, } from "./clients/activity-client.js";
+export type { DepthLevel, MarketSpec, TokenDepthSnapshot, DepthLevelUpdate, DepthUpdate, MarketDepthClientConfig, } from "./clients/order-client.js";
+export type { OrderFillEvent, OrderUpdateEvent, ActivityClientConfig, } from "./clients/activity-client.js";
 export type { SyncStatus } from "./types.js";

package/package.json

@@ -1,60 +1,60 @@
 {
-  "name": "@stryke-xyz/premarket-sdk",
-  "version": "1.2.1",
-  "type": "module",
-  "module": "dist/esm/index.js",
-  "main": "dist/cjs/index.js",
-  "types": "dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "node": "./dist/cjs/index.js",
-      "default": "./dist/esm/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
-    "build:esm": "swc --config-file esm.swcrc ./src -d dist/esm --strip-leading-paths --copy-files && find dist/esm -name '*.spec.*' -delete && node -e 'const pkg = require(\"./package.json\"); require(\"fs\").writeFileSync(\"dist/esm/package.json\", JSON.stringify({name: pkg.name, version: pkg.version, type: \"module\"}))'",
-    "build:cjs": "swc --config-file cjs.swcrc ./src -d dist/cjs --strip-leading-paths --copy-files && find dist/cjs -name '*.spec.*' -delete && node -e 'const pkg = require(\"./package.json\"); require(\"fs\").writeFileSync(\"dist/cjs/package.json\", JSON.stringify({name: pkg.name, version: pkg.version, type: \"commonjs\"}))'",
-    "build:types": "tsc --project tsconfig.types.json && find dist -name '*.tsbuildinfo' -delete",
-    "test": "bun test src",
-    "typecheck": "tsc --noEmit --project tsconfig.json",
-    "test:e2e": "bun test test/e2e/index.test.ts",
-    "fill-orderbook": "bun run scripts/fill-orderbook.ts"
-  },
-  "dependencies": {
-    "viem": "^2.7.0"
-  },
-  "devDependencies": {
-    "@swc/cli": "0.7.7",
-    "@swc/core": "^1.13.3",
-    "@swc/jest": "^0.2.39",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^22.17.0",
-    "@typescript-eslint/eslint-plugin": "~8.20.0",
-    "@typescript-eslint/parser": "~8.20.0",
-    "axios": "^1.12.0",
-    "eslint": "^9.32.0",
-    "eslint-config-prettier": "~10.1.8",
-    "eslint-config-standard": "^17.1.0",
-    "eslint-import-resolver-typescript": "3.7.0",
-    "eslint-plugin-import": "~2.31.0",
-    "eslint-plugin-n": "^17.21.3",
-    "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-promise": "^7.2.1",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "generate-changelog": "1.8.0",
-    "jest": "^30.0.5",
-    "prettier": "^3.6.2",
-    "testcontainers": "^11.5.1",
-    "tsdoc-markdown": "^1.4.1",
-    "tslib": "2.8.1",
-    "typescript": "5.8.3",
-    "bun-types": "^1.0.0"
-  }
+	"name": "@stryke-xyz/premarket-sdk",
+	"version": "1.2.2",
+	"type": "module",
+	"module": "dist/esm/index.js",
+	"main": "dist/cjs/index.js",
+	"types": "dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/esm/index.js",
+			"require": "./dist/cjs/index.js",
+			"node": "./dist/cjs/index.js",
+			"default": "./dist/esm/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "npm run build:esm && npm run build:cjs && npm run build:types",
+		"build:esm": "swc --config-file esm.swcrc ./src -d dist/esm --strip-leading-paths --copy-files && find dist/esm -name '*.spec.*' -delete && node -e 'const pkg = require(\"./package.json\"); require(\"fs\").writeFileSync(\"dist/esm/package.json\", JSON.stringify({name: pkg.name, version: pkg.version, type: \"module\"}))'",
+		"build:cjs": "swc --config-file cjs.swcrc ./src -d dist/cjs --strip-leading-paths --copy-files && find dist/cjs -name '*.spec.*' -delete && node -e 'const pkg = require(\"./package.json\"); require(\"fs\").writeFileSync(\"dist/cjs/package.json\", JSON.stringify({name: pkg.name, version: pkg.version, type: \"commonjs\"}))'",
+		"build:types": "tsc --project tsconfig.types.json && find dist -name '*.tsbuildinfo' -delete",
+		"test": "bun test src",
+		"typecheck": "tsc --noEmit --project tsconfig.json",
+		"test:e2e": "bun test test/e2e/index.test.ts",
+		"fill-orderbook": "bun run scripts/fill-orderbook.ts"
+	},
+	"dependencies": {
+		"viem": "^2.7.0"
+	},
+	"devDependencies": {
+		"@swc/cli": "0.7.7",
+		"@swc/core": "^1.13.3",
+		"@swc/jest": "^0.2.39",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^22.17.0",
+		"@typescript-eslint/eslint-plugin": "~8.20.0",
+		"@typescript-eslint/parser": "~8.20.0",
+		"axios": "^1.12.0",
+		"eslint": "^9.32.0",
+		"eslint-config-prettier": "~10.1.8",
+		"eslint-config-standard": "^17.1.0",
+		"eslint-import-resolver-typescript": "3.7.0",
+		"eslint-plugin-import": "~2.31.0",
+		"eslint-plugin-n": "^17.21.3",
+		"eslint-plugin-prettier": "^5.5.4",
+		"eslint-plugin-promise": "^7.2.1",
+		"eslint-plugin-unused-imports": "^4.1.4",
+		"generate-changelog": "1.8.0",
+		"jest": "^30.0.5",
+		"prettier": "^3.6.2",
+		"testcontainers": "^11.5.1",
+		"tsdoc-markdown": "^1.4.1",
+		"tslib": "2.8.1",
+		"typescript": "5.8.3",
+		"bun-types": "^1.0.0"
+	}
 }