@structbuild/sdk 0.3.0 → 0.3.1

package/dist/ws-alerts.d.ts

@@ -0,0 +1,39 @@
+import type { ConnectionState, StructWebSocketConfig, AlertsWebSocketEventMap, WsAlertSubscribedResponse } from "./types/ws.js";
+import type { WsAlertSubscribeMap, WsAlertEventName } from "./types/ws-helpers.js";
+type Listener<T> = (payload: T) => void;
+export declare class StructAlertsWebSocket {
+    private readonly transport;
+    private readonly listeners;
+    private readonly subscriptions;
+    private readonly pendingSubscribes;
+    private readonly subscribeTimeout;
+    private pingTimer;
+    private pongTimer;
+    private isEmittingListenerError;
+    constructor(config: StructWebSocketConfig);
+    get state(): ConnectionState;
+    connect(): Promise<void>;
+    disconnect(): void;
+    on<K extends keyof AlertsWebSocketEventMap>(event: K, listener: Listener<AlertsWebSocketEventMap[K]>): () => void;
+    off<K extends keyof AlertsWebSocketEventMap>(event: K, listener: Listener<AlertsWebSocketEventMap[K]>): void;
+    once<K extends keyof AlertsWebSocketEventMap>(event: K, listener: Listener<AlertsWebSocketEventMap[K]>): () => void;
+    removeAllListeners(event?: keyof AlertsWebSocketEventMap): void;
+    subscribe<E extends WsAlertEventName>(event: E, filters: Omit<WsAlertSubscribeMap[E], "op" | "event">): Promise<WsAlertSubscribedResponse>;
+    unsubscribe(event: WsAlertEventName): void;
+    private rebuildReplay;
+    private handleOpen;
+    private handleClose;
+    private handleMessage;
+    private emit;
+    private startPing;
+    private stopPing;
+    private sendSubscription;
+    private restartPendingSubscribes;
+    private pausePendingSubscribes;
+    private armSubscribeTimer;
+    private clearSubscribeTimer;
+    private armPongTimer;
+    private clearPongTimer;
+    private handleListenerError;
+}
+export {};

package/dist/ws-transport.d.ts

@@ -1,11 +1,20 @@
-import type { ConnectionState, WebSocketMessage } from "./types/ws.js";
+import { WebSocketClosedError } from "./errors.js";
+import type { ConnectionState } from "./types/ws.js";
 import type { RetryConfig } from "./types/http.js";
+export declare function buildWebSocketUrl(path: string, config: {
+    apiKey: string;
+    jwt?: string;
+    baseUrl?: string;
+}, defaultBaseUrl: string): string;
 export interface WebSocketTransportCallbacks {
     onOpen: () => void;
     onClose: (code: number, reason: string) => void;
     onError: (error: Error) => void;
     onMessage: (data: unknown) => void;
     onReconnecting: (attempt: number) => void;
+    onReconnectFailed: (error: Error) => void;
+    onAuthFailed: (error: WebSocketClosedError) => void;
+    onWarning: (warning: Error) => void;
 }
 export declare class WebSocketTransport {
     private ws;
@@ -13,23 +22,33 @@ export declare class WebSocketTransport {
     private reconnectTimer;
     private reconnectAttempt;
     private intentionalClose;
+    private readonly connectWaiters;
     private readonly pendingMessages;
     private readonly replayMessages;
-    private readonly url;
+    private readonly getUrl;
     private readonly retry;
     private readonly callbacks;
-    constructor(url: string, retry: RetryConfig, callbacks: WebSocketTransportCallbacks);
+    constructor(url: string | (() => string), retry: RetryConfig, callbacks: WebSocketTransportCallbacks);
     get state(): ConnectionState;
-    connect(): void;
+    connect(): Promise<void>;
     disconnect(): void;
-    send(message: WebSocketMessage): void;
-    addReplayMessage(message: WebSocketMessage): void;
-    removeReplayMessages(predicate: (msg: WebSocketMessage) => boolean): void;
+    send(message: Record<string, unknown>): boolean;
+    sendNow(message: Record<string, unknown>): boolean;
+    addReplayMessage(message: Record<string, unknown>): void;
+    addReplayMessages(messages: Record<string, unknown>[]): void;
     clearReplayMessages(): void;
+    close(code: number, reason: string): void;
+    private createConnectPromise;
+    private resolveConnect;
+    private rejectConnect;
     private createSocket;
     private replaySubscriptions;
     private flushPendingMessages;
     private scheduleReconnect;
     private clearReconnectTimer;
+    private sendMessage;
+    private enqueueMessage;
+    private enqueueReplayMessages;
+    private isAuthFailure;
     private setState;
 }

package/dist/ws.d.ts

@@ -1,46 +1,40 @@
-import type { ConnectionState, StructWebSocketConfig, WebSocketEventMap } from "./types/ws.js";
-import type { Address } from "./types/common.js";
+import type { ConnectionState, StructWebSocketConfig, WebSocketEventMap, WsRoomId, WsFiltersOptionalRoom, WsFiltersRequiredRoom, WsSubscriptionMap, WsSubscribeResponseMap } from "./types/ws.js";
 type Listener<T> = (payload: T) => void;
 export declare class StructWebSocket {
     private readonly transport;
     private readonly listeners;
-    private readonly activeMarkets;
-    private readonly activeMarketPositions;
-    private readonly activeWallets;
-    private readonly activeConditions;
-    private readonly activeSpecialRooms;
+    private readonly subscriptions;
+    private readonly pendingSubscribes;
+    private readonly subscribeTimeout;
+    private pingTimer;
+    private pongTimer;
+    private isEmittingListenerError;
     constructor(config: StructWebSocketConfig);
     get state(): ConnectionState;
-    connect(): void;
+    connect(): Promise<void>;
     disconnect(): void;
-    on<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): this;
-    off<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): this;
-    once<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): this;
-    subscribeMarket(conditionId: string): void;
-    unsubscribeMarket(conditionId: string): void;
-    subscribeMarketByPosition(positionId: string): void;
-    unsubscribeMarketByPosition(positionId: string): void;
-    trackWallets(addresses: Address[]): void;
-    untrackWallets(addresses: Address[]): void;
-    subscribeWhaleTrades(): void;
-    unsubscribeWhaleTrades(): void;
-    subscribeSmartMoneyTrades(): void;
-    unsubscribeSmartMoneyTrades(): void;
-    subscribeInsiderTrades(): void;
-    unsubscribeInsiderTrades(): void;
-    trackConditions(conditionIds: string[]): void;
-    untrackConditions(conditionIds: string[]): void;
+    on<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): () => void;
+    off<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): void;
+    once<K extends keyof WebSocketEventMap>(event: K, listener: Listener<WebSocketEventMap[K]>): () => void;
+    removeAllListeners(event?: keyof WebSocketEventMap): void;
+    subscribe<R extends WsFiltersOptionalRoom>(room: R, filters?: WsSubscriptionMap[R]): Promise<WsSubscribeResponseMap[R]>;
+    subscribe<R extends WsFiltersRequiredRoom>(room: R, filters: WsSubscriptionMap[R]): Promise<WsSubscribeResponseMap[R]>;
+    unsubscribe(room: WsRoomId): void;
+    private rebuildReplay;
     private handleOpen;
     private handleClose;
     private handleMessage;
     private emit;
-    private marketSubscribeMessage;
-    private marketPositionSubscribeMessage;
-    private walletTrackMessage;
-    private conditionsTrackMessage;
-    private subscribeSpecialRoom;
-    private unsubscribeSpecialRoom;
-    private rebuildWalletReplay;
-    private rebuildConditionsReplay;
+    private startPing;
+    private stopPing;
+    private sendSubscription;
+    private restartPendingSubscribes;
+    private pausePendingSubscribes;
+    private armSubscribeTimer;
+    private clearSubscribeTimer;
+    private armPongTimer;
+    private clearPongTimer;
+    private getSubscribeError;
+    private handleListenerError;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structbuild/sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -24,14 +24,17 @@
     "build": "rm -rf dist && bun build ./src/index.ts --target browser --format esm --sourcemap --outdir ./dist && bun build ./src/index.ts --target browser --format cjs --sourcemap --outdir ./dist-cjs && mv ./dist-cjs/index.js ./dist/index.cjs && mv ./dist-cjs/index.js.map ./dist/index.cjs.map && rm -rf dist-cjs && tsc --emitDeclarationOnly",
     "check-routes": "bun run scripts/check-routes.ts",
     "fix-spec": "bun run scripts/fix-spec.ts",
-    "prep": "bun run fetch-spec:polymarket && bun run fix-spec && bun run generate:polymarket && bun run fetch-spec:webhooks && bun run generate:webhooks && bun run check-routes && bun run build",
+    "fetch-specs": "bun run scripts/fetch-specs.ts",
+    "prep": "bun run fetch-specs && bun run fix-spec && bun run generate:polymarket && bun run generate:webhooks && bun run generate:ws && bun run check-routes && bun run build",
+    "prep:staging": "STRUCT_ENV=staging bun run prep",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "typecheck": "bun run tsc -p tsconfig.check.json",
-    "fetch-spec:polymarket": "curl -s -o openapi/polymarket.json https://api.struct.to/api-docs/openapi.json",
     "generate:polymarket": "openapi-typescript openapi/polymarket.json -o src/generated/polymarket.ts",
-    "fetch-spec:webhooks": "curl -s -o openapi/webhooks.json https://api.struct.to/webhookopenapi.json",
-    "generate:webhooks": "openapi-typescript openapi/webhooks.json -o src/generated/webhooks.ts"
+    "generate:webhooks": "openapi-typescript openapi/webhooks.json -o src/generated/webhooks.ts",
+    "generate:ws": "bun run scripts/generate-ws-types.ts",
+    "link": "bun link",
+    "pack": "bun run build && bun pm pack"
   },
   "devDependencies": {
     "@types/bun": "latest",