@upbit-official/upbit-sdk 0.9.0 → 1.1.0

package/lib/jsonParseFloat.mjs

@@ -5,6 +5,7 @@
  */
 const NUMBER_FIELDS = new Set([
     'timestamp',
+    'tms',
     'trade_timestamp',
     'sequential_id',
     'trades_count',
@@ -14,57 +15,75 @@ const NUMBER_FIELDS = new Set([
     'block_elapsed_minutes',
     'fee_level',
     'security_level',
+    'unit',
 ]);
 /**
  * Parses a JSON string with type-aware coercion.
  *
- * 1st pass (JSON.parse reviver): float tokens (containing `.`, `e`, `E`) are
- * preserved as their original string representation to avoid precision loss.
- * Uses the reviver's third argument `context.source` (TypeScript 5.2+ / modern runtimes).
+ * 1st pass (JSON.parse reviver): numeric tokens retain their original source
+ * alongside the parsed number. Uses the runtime's reviver `context.source`.
  * Falls back to standard number parsing when `context.source` is unavailable.
  *
  * 2nd pass (constructType): coerces values to match SDK declared types.
  * - `string`-declared fields: `number` → `string`  (e.g. balance `0` → `"0"`)
  * - `number`-declared fields: `string` → `number`  (e.g. timestamp `"123.45"` → `123.45`)
  *
- * Mirrors the behavior of Python SDK's `json.loads(parse_float=str)` + `construct_type()`.
+ * Integer scalars and integer array elements keep their existing number contract;
+ * decimal/exponent scalars and array elements keep their existing source strings.
  */
-export function jsonParseFloat(text) {
+export function jsonParseFloat(text, numberField) {
     const parsed = JSON.parse(text, (key, value, context) => {
         if (typeof value !== 'number')
             return value;
         const src = context?.source;
         if (!src)
             return value;
-        return /[.eE]/.test(src) ? src : value;
+        return new NumericToken(src, value);
     });
-    return constructType(parsed);
+    return constructType(parsed, numberField);
 }
-function constructType(data) {
+/** Internal only: distinguish numeric wire tokens from JSON string values. */
+class NumericToken {
+    constructor(source, value) {
+        this.source = source;
+        this.value = value;
+    }
+}
+function constructType(data, numberField, path = [], root) {
+    if (data instanceof NumericToken) {
+        return /[.eE]/.test(data.source) ? data.source : data.value;
+    }
     if (Array.isArray(data)) {
-        return data.map(constructType);
+        return data.map((item) => constructType(item, numberField, path, root));
     }
     if (data !== null && typeof data === 'object') {
         const obj = data;
+        root ?? (root = obj);
         const result = {};
         for (const key of Object.keys(obj)) {
             const value = obj[key];
-            if (NUMBER_FIELDS.has(key)) {
+            if (NUMBER_FIELDS.has(key) || numberField?.(key, path, root)) {
                 // number-declared field: coerce string → number
-                if (typeof value === 'string') {
+                if (value instanceof NumericToken) {
+                    result[key] = value.value;
+                }
+                else if (typeof value === 'string') {
                     result[key] = Number(value);
                 }
                 else {
                     result[key] = value;
                 }
             }
+            else if (value instanceof NumericToken) {
+                result[key] = value.source;
+            }
             else if (typeof value === 'number') {
                 // string-declared field: coerce number → string
                 result[key] = String(value);
             }
             else {
                 // recurse into nested objects and arrays
-                result[key] = constructType(value);
+                result[key] = constructType(value, numberField, [...path, key], root);
             }
         }
         return result;

package/lib/jsonParseFloat.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"jsonParseFloat.mjs","sourceRoot":"","sources":["../src/lib/jsonParseFloat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,aAAa,GAAgB,IAAI,GAAG,CAAC;IACzC,WAAW;IACX,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,OAAO;IACP,mBAAmB;IACnB,+BAA+B;IAC/B,uBAAuB;IACvB,WAAW;IACX,gBAAgB;CACjB,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAW,EAAE,KAAc,EAAE,OAA6B,EAAE,EAAE;QAC7F,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,CAAC;QAC5B,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,IAAa;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAEvB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,gDAAgD;gBAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,gDAAgD;gBAChD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"jsonParseFloat.mjs","sourceRoot":"","sources":["../src/lib/jsonParseFloat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,aAAa,GAAgB,IAAI,GAAG,CAAC;IACzC,WAAW;IACX,KAAK;IACL,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,OAAO;IACP,mBAAmB;IACnB,+BAA+B;IAC/B,uBAAuB;IACvB,WAAW;IACX,gBAAgB;IAChB,MAAM;CACP,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,WAAqF;IAErF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAW,EAAE,KAAc,EAAE,OAA6B,EAAE,EAAE;QAC7F,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,CAAC;QAC5B,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,MAAM,YAAY;IAChB,YACW,MAAc,EACd,KAAa;QADb,WAAM,GAAN,MAAM,CAAQ;QACd,UAAK,GAAL,KAAK,CAAQ;IACrB,CAAC;CACL;AAED,SAAS,aAAa,CACpB,IAAa,EACb,WAAqF,EACrF,OAAiB,EAAE,EACnB,IAA8B;IAE9B,IAAI,IAAI,YAAY,YAAY,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,IAAI,KAAJ,IAAI,GAAK,GAAG,EAAC;QACb,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAEvB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC7D,gDAAgD;gBAChD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;oBAClC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;gBAC5B,CAAC;qBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACrC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBACzC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;YAC7B,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,gDAAgD;gBAChD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/ws.d.mts

@@ -1,7 +1,15 @@
 import type { ConnectPublicServerEvent } from "../resources/ws-public/ws-public.mjs";
-import type { ConnectPrivateServerEvent } from "../resources/ws-private/ws-private.mjs";
+import type { ListSubscriptionsResponse, ListSubscriptionsServerResponse, SimpleListSubscriptionsResponse } from "../resources/ws-public/ws-public.mjs";
+import type { AnnouncementCategory, ConnectPrivateServerEvent } from "../resources/ws-private/ws-private.mjs";
+import type { ConnectInfoServerEvent } from "../resources/ws-info/ws-info.mjs";
+import type { ConnectInfoClientEvent } from "../resources/ws-info/ws-info.mjs";
+import { type InfoWebSocketUnknownMessage, type WebSocketMessage } from "../internal/ws-parser.mjs";
+import type { SimpleWebSocketEvent } from "../internal/ws-simple-types.mjs";
+import type { SimpleWebSocketEvent as ExtensibleSimpleEvent } from "../internal/ws-parser.mjs";
 import type { Upbit } from "../client.mjs";
 export interface WsStreamOptions {
+    /** Response format (default: DEFAULT). Preserved for queries and reconnects. */
+    format?: WsStreamFormat;
     /** Maximum number of reconnection attempts (default: 5) */
     maxRetries?: number;
     /** Reconnection delay in ms (default: 1000) */
@@ -11,6 +19,35 @@ export interface WsStreamOptions {
     /** Callback invoked on successful reconnection */
     onReconnect?: () => void;
 }
+export type WsStreamFormat = 'DEFAULT' | 'SIMPLE' | 'JSON_LIST' | 'SIMPLE_LIST';
+export declare enum WsEndpoint {
+    Public = "public",
+    Private = "private",
+    Info = "info"
+}
+export type WsDefaultListSubscriptionsResponse = ListSubscriptionsResponse;
+export type WsSimpleListSubscriptionsResponse = SimpleListSubscriptionsResponse;
+export type WsListSubscriptionsResponse = ListSubscriptionsServerResponse;
+export interface WsAnnouncementOptions extends WsStreamOptions {
+    /** Response format (default: DEFAULT). */
+    format?: WsStreamFormat;
+    /** Announcement categories to receive. Omit to receive all categories. */
+    categories?: AnnouncementCategory[];
+    /** Whether to include the announcement body in stream messages. */
+    includeBody?: boolean;
+}
+export type WsIndicatorSubscription = Omit<Extract<InfoSubscription, {
+    type: 'indicator';
+}>, 'type'>;
+export interface WsIndicatorOptions extends Omit<WsIndicatorSubscription, 'codes'>, WsStreamOptions {
+    format?: WsStreamFormat;
+}
+export type WsIndicatorSignalSubscription = Omit<Extract<InfoSubscription, {
+    type: 'indicator_signal';
+}>, 'type'>;
+export interface WsIndicatorSignalOptions extends Omit<WsIndicatorSignalSubscription, 'codes'>, WsStreamOptions {
+    format?: WsStreamFormat;
+}
 type PublicSubscriptionType = {
     type: 'ticker';
     codes: string[];
@@ -24,33 +61,71 @@ type PublicSubscriptionType = {
     type: string;
     codes: string[];
 };
-type PrivateSubscriptionType = {
+type AnnouncementSubscriptionType = {
+    type: 'announcement';
+    categories?: AnnouncementCategory[];
+    include_body?: boolean;
+};
+type PrivateSubscriptionType = AnnouncementSubscriptionType | {
     type: 'myOrder';
     codes?: string[];
 } | {
     type: 'myAsset';
 };
-type AnySubscriptionType = PublicSubscriptionType | PrivateSubscriptionType;
+export type InfoSubscription = Extract<ConnectInfoClientEvent[number], {
+    type: 'indicator' | 'indicator_signal';
+}>;
+type AnySubscriptionType = PublicSubscriptionType | PrivateSubscriptionType | InfoSubscription;
+type WsServerEvent = ConnectPublicServerEvent | ConnectPrivateServerEvent | ConnectInfoServerEvent | InfoWebSocketUnknownMessage;
+export type WsSimpleEvent = SimpleWebSocketEvent;
+export type WsStreamEvent = WebSocketMessage<WsServerEvent | WsSimpleEvent | ExtensibleSimpleEvent> | WsListSubscriptionsResponse | Array<WebSocketMessage<WsServerEvent | WsSimpleEvent | ExtensibleSimpleEvent> | WsListSubscriptionsResponse>;
+type PublicEvent<Type extends ConnectPublicServerEvent['type']> = Extract<ConnectPublicServerEvent, {
+    type: Type;
+}>;
+type CandleEvent = Exclude<ConnectPublicServerEvent, PublicEvent<'ticker' | 'trade' | 'orderbook'>>;
+type PrivateEvent<Type extends ConnectPrivateServerEvent['type']> = Extract<ConnectPrivateServerEvent, {
+    type: Type;
+}>;
+type InfoEvent<Type extends ConnectInfoServerEvent['type']> = Extract<ConnectInfoServerEvent, {
+    type: Type;
+}>;
+export declare function buildSubscriptionMessage(types: AnySubscriptionType[], format?: WsStreamFormat): string;
+export declare function buildListSubscriptionsMessage(format?: WsStreamFormat): string;
+export declare function parseWsMessage(data: string): unknown;
 /**
  * Manages a WebSocket stream as an AsyncIterable.
  *
  * Use with `for await (const event of manager) { ... }`.
  */
-export declare class WsStreamManager implements AsyncIterable<ConnectPublicServerEvent | ConnectPrivateServerEvent> {
+export declare class WsStreamManager<Event = ConnectPublicServerEvent | ConnectPrivateServerEvent> implements AsyncIterable<Event> {
     private readonly client;
     private readonly types;
-    private readonly isPrivate;
+    private readonly endpoint;
+    private readonly format;
     private readonly maxRetries;
     private readonly retryDelayMs;
     private readonly onDisconnect;
     private readonly onReconnect;
     private _currentWs;
-    constructor(client: Upbit, types: AnySubscriptionType[], isPrivate: boolean, opts?: WsStreamOptions);
+    private _pendingListSubscriptions;
+    constructor(client: Upbit, types: AnySubscriptionType[], privateConnection: boolean, opts?: WsStreamOptions & {
+        format?: WsStreamFormat;
+    });
+    constructor(client: Upbit, types: AnySubscriptionType[], endpoint: WsEndpoint, opts?: WsStreamOptions & {
+        format?: WsStreamFormat;
+    });
+    /**
+     * Returns subscriptions for this stream's currently open connection.
+     * Start consuming the iterator before calling; calls before connection reject.
+     * The response format is unchanged. Responses are matched by request ticket.
+     */
+    listSubscriptions(timeoutMs?: number): Promise<WsListSubscriptionsResponse>;
     /** Closes the current WebSocket connection. */
     close(): void;
-    [Symbol.asyncIterator](): AsyncGenerator<ConnectPublicServerEvent | ConnectPrivateServerEvent>;
+    [Symbol.asyncIterator](): AsyncGenerator<Event>;
     private _iterate;
     private _connect;
+    private _settlePendingListSubscriptions;
 }
 /**
  * Convenience API for WebSocket streams.
@@ -62,19 +137,25 @@ export declare class WsStream {
     private readonly client;
     constructor(client: Upbit);
     /** Subscribe to the ticker (current price) stream. */
-    ticker(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    ticker(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'ticker'>>;
     /** Subscribe to the trade (executed order) stream. */
-    trade(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    trade(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'trade'>>;
     /** Subscribe to the orderbook stream. */
-    orderbook(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    orderbook(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'orderbook'>>;
     /** Subscribe to the candle stream. */
     candle(codes: string[], opts?: {
         interval?: string;
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<CandleEvent>;
     /** Subscribe to the myOrder (my orders) stream. Requires authentication. */
-    myOrder(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    myOrder(codes: string[], opts?: WsStreamOptions): WsStreamManager<PrivateEvent<'myOrder'>>;
     /** Subscribe to the myAsset (my assets) stream. Requires authentication. */
-    myAsset(opts?: WsStreamOptions): WsStreamManager;
+    myAsset(opts?: WsStreamOptions): WsStreamManager<PrivateEvent<'myAsset'>>;
+    /** Subscribe to the announcement stream. Requires authentication. */
+    announcement(opts?: WsAnnouncementOptions): WsStreamManager<PrivateEvent<'announcement'>>;
+    /** Subscribe to calculated indicator values. Requires authentication. */
+    indicator(codes: string[], opts: WsIndicatorOptions): WsStreamManager<InfoEvent<'indicator'>>;
+    /** Subscribe to technical indicator condition transitions. Requires authentication. */
+    indicatorSignal(codes: string[], opts: WsIndicatorSignalOptions): WsStreamManager<InfoEvent<'indicator_signal'>>;
     /** Subscribe to multiple public streams at once. */
     subscribe(opts: {
         ticker?: string[];
@@ -84,12 +165,18 @@ export declare class WsStream {
             codes: string[];
             interval?: string;
         };
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<ConnectPublicServerEvent>;
     /** Subscribe to multiple private streams at once. Requires authentication. */
     subscribePrivate(opts: {
+        announcement?: boolean | Pick<WsAnnouncementOptions, 'categories' | 'includeBody'>;
         myOrder?: string[];
         myAsset?: boolean;
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<ConnectPrivateServerEvent>;
+    /** Subscribe to multiple info streams at once. Requires authentication. */
+    subscribeInfo(opts: {
+        indicator?: WsIndicatorSubscription | WsIndicatorSubscription[];
+        indicatorSignal?: WsIndicatorSignalSubscription | WsIndicatorSignalSubscription[];
+    } & WsStreamOptions): WsStreamManager<ConnectInfoServerEvent>;
 }
 export {};
 //# sourceMappingURL=ws.d.mts.map

package/lib/ws.d.mts.map

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

package/lib/ws.d.ts

@@ -1,7 +1,15 @@
 import type { ConnectPublicServerEvent } from "../resources/ws-public/ws-public.js";
-import type { ConnectPrivateServerEvent } from "../resources/ws-private/ws-private.js";
+import type { ListSubscriptionsResponse, ListSubscriptionsServerResponse, SimpleListSubscriptionsResponse } from "../resources/ws-public/ws-public.js";
+import type { AnnouncementCategory, ConnectPrivateServerEvent } from "../resources/ws-private/ws-private.js";
+import type { ConnectInfoServerEvent } from "../resources/ws-info/ws-info.js";
+import type { ConnectInfoClientEvent } from "../resources/ws-info/ws-info.js";
+import { type InfoWebSocketUnknownMessage, type WebSocketMessage } from "../internal/ws-parser.js";
+import type { SimpleWebSocketEvent } from "../internal/ws-simple-types.js";
+import type { SimpleWebSocketEvent as ExtensibleSimpleEvent } from "../internal/ws-parser.js";
 import type { Upbit } from "../client.js";
 export interface WsStreamOptions {
+    /** Response format (default: DEFAULT). Preserved for queries and reconnects. */
+    format?: WsStreamFormat;
     /** Maximum number of reconnection attempts (default: 5) */
     maxRetries?: number;
     /** Reconnection delay in ms (default: 1000) */
@@ -11,6 +19,35 @@ export interface WsStreamOptions {
     /** Callback invoked on successful reconnection */
     onReconnect?: () => void;
 }
+export type WsStreamFormat = 'DEFAULT' | 'SIMPLE' | 'JSON_LIST' | 'SIMPLE_LIST';
+export declare enum WsEndpoint {
+    Public = "public",
+    Private = "private",
+    Info = "info"
+}
+export type WsDefaultListSubscriptionsResponse = ListSubscriptionsResponse;
+export type WsSimpleListSubscriptionsResponse = SimpleListSubscriptionsResponse;
+export type WsListSubscriptionsResponse = ListSubscriptionsServerResponse;
+export interface WsAnnouncementOptions extends WsStreamOptions {
+    /** Response format (default: DEFAULT). */
+    format?: WsStreamFormat;
+    /** Announcement categories to receive. Omit to receive all categories. */
+    categories?: AnnouncementCategory[];
+    /** Whether to include the announcement body in stream messages. */
+    includeBody?: boolean;
+}
+export type WsIndicatorSubscription = Omit<Extract<InfoSubscription, {
+    type: 'indicator';
+}>, 'type'>;
+export interface WsIndicatorOptions extends Omit<WsIndicatorSubscription, 'codes'>, WsStreamOptions {
+    format?: WsStreamFormat;
+}
+export type WsIndicatorSignalSubscription = Omit<Extract<InfoSubscription, {
+    type: 'indicator_signal';
+}>, 'type'>;
+export interface WsIndicatorSignalOptions extends Omit<WsIndicatorSignalSubscription, 'codes'>, WsStreamOptions {
+    format?: WsStreamFormat;
+}
 type PublicSubscriptionType = {
     type: 'ticker';
     codes: string[];
@@ -24,33 +61,71 @@ type PublicSubscriptionType = {
     type: string;
     codes: string[];
 };
-type PrivateSubscriptionType = {
+type AnnouncementSubscriptionType = {
+    type: 'announcement';
+    categories?: AnnouncementCategory[];
+    include_body?: boolean;
+};
+type PrivateSubscriptionType = AnnouncementSubscriptionType | {
     type: 'myOrder';
     codes?: string[];
 } | {
     type: 'myAsset';
 };
-type AnySubscriptionType = PublicSubscriptionType | PrivateSubscriptionType;
+export type InfoSubscription = Extract<ConnectInfoClientEvent[number], {
+    type: 'indicator' | 'indicator_signal';
+}>;
+type AnySubscriptionType = PublicSubscriptionType | PrivateSubscriptionType | InfoSubscription;
+type WsServerEvent = ConnectPublicServerEvent | ConnectPrivateServerEvent | ConnectInfoServerEvent | InfoWebSocketUnknownMessage;
+export type WsSimpleEvent = SimpleWebSocketEvent;
+export type WsStreamEvent = WebSocketMessage<WsServerEvent | WsSimpleEvent | ExtensibleSimpleEvent> | WsListSubscriptionsResponse | Array<WebSocketMessage<WsServerEvent | WsSimpleEvent | ExtensibleSimpleEvent> | WsListSubscriptionsResponse>;
+type PublicEvent<Type extends ConnectPublicServerEvent['type']> = Extract<ConnectPublicServerEvent, {
+    type: Type;
+}>;
+type CandleEvent = Exclude<ConnectPublicServerEvent, PublicEvent<'ticker' | 'trade' | 'orderbook'>>;
+type PrivateEvent<Type extends ConnectPrivateServerEvent['type']> = Extract<ConnectPrivateServerEvent, {
+    type: Type;
+}>;
+type InfoEvent<Type extends ConnectInfoServerEvent['type']> = Extract<ConnectInfoServerEvent, {
+    type: Type;
+}>;
+export declare function buildSubscriptionMessage(types: AnySubscriptionType[], format?: WsStreamFormat): string;
+export declare function buildListSubscriptionsMessage(format?: WsStreamFormat): string;
+export declare function parseWsMessage(data: string): unknown;
 /**
  * Manages a WebSocket stream as an AsyncIterable.
  *
  * Use with `for await (const event of manager) { ... }`.
  */
-export declare class WsStreamManager implements AsyncIterable<ConnectPublicServerEvent | ConnectPrivateServerEvent> {
+export declare class WsStreamManager<Event = ConnectPublicServerEvent | ConnectPrivateServerEvent> implements AsyncIterable<Event> {
     private readonly client;
     private readonly types;
-    private readonly isPrivate;
+    private readonly endpoint;
+    private readonly format;
     private readonly maxRetries;
     private readonly retryDelayMs;
     private readonly onDisconnect;
     private readonly onReconnect;
     private _currentWs;
-    constructor(client: Upbit, types: AnySubscriptionType[], isPrivate: boolean, opts?: WsStreamOptions);
+    private _pendingListSubscriptions;
+    constructor(client: Upbit, types: AnySubscriptionType[], privateConnection: boolean, opts?: WsStreamOptions & {
+        format?: WsStreamFormat;
+    });
+    constructor(client: Upbit, types: AnySubscriptionType[], endpoint: WsEndpoint, opts?: WsStreamOptions & {
+        format?: WsStreamFormat;
+    });
+    /**
+     * Returns subscriptions for this stream's currently open connection.
+     * Start consuming the iterator before calling; calls before connection reject.
+     * The response format is unchanged. Responses are matched by request ticket.
+     */
+    listSubscriptions(timeoutMs?: number): Promise<WsListSubscriptionsResponse>;
     /** Closes the current WebSocket connection. */
     close(): void;
-    [Symbol.asyncIterator](): AsyncGenerator<ConnectPublicServerEvent | ConnectPrivateServerEvent>;
+    [Symbol.asyncIterator](): AsyncGenerator<Event>;
     private _iterate;
     private _connect;
+    private _settlePendingListSubscriptions;
 }
 /**
  * Convenience API for WebSocket streams.
@@ -62,19 +137,25 @@ export declare class WsStream {
     private readonly client;
     constructor(client: Upbit);
     /** Subscribe to the ticker (current price) stream. */
-    ticker(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    ticker(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'ticker'>>;
     /** Subscribe to the trade (executed order) stream. */
-    trade(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    trade(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'trade'>>;
     /** Subscribe to the orderbook stream. */
-    orderbook(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    orderbook(codes: string[], opts?: WsStreamOptions): WsStreamManager<PublicEvent<'orderbook'>>;
     /** Subscribe to the candle stream. */
     candle(codes: string[], opts?: {
         interval?: string;
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<CandleEvent>;
     /** Subscribe to the myOrder (my orders) stream. Requires authentication. */
-    myOrder(codes: string[], opts?: WsStreamOptions): WsStreamManager;
+    myOrder(codes: string[], opts?: WsStreamOptions): WsStreamManager<PrivateEvent<'myOrder'>>;
     /** Subscribe to the myAsset (my assets) stream. Requires authentication. */
-    myAsset(opts?: WsStreamOptions): WsStreamManager;
+    myAsset(opts?: WsStreamOptions): WsStreamManager<PrivateEvent<'myAsset'>>;
+    /** Subscribe to the announcement stream. Requires authentication. */
+    announcement(opts?: WsAnnouncementOptions): WsStreamManager<PrivateEvent<'announcement'>>;
+    /** Subscribe to calculated indicator values. Requires authentication. */
+    indicator(codes: string[], opts: WsIndicatorOptions): WsStreamManager<InfoEvent<'indicator'>>;
+    /** Subscribe to technical indicator condition transitions. Requires authentication. */
+    indicatorSignal(codes: string[], opts: WsIndicatorSignalOptions): WsStreamManager<InfoEvent<'indicator_signal'>>;
     /** Subscribe to multiple public streams at once. */
     subscribe(opts: {
         ticker?: string[];
@@ -84,12 +165,18 @@ export declare class WsStream {
             codes: string[];
             interval?: string;
         };
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<ConnectPublicServerEvent>;
     /** Subscribe to multiple private streams at once. Requires authentication. */
     subscribePrivate(opts: {
+        announcement?: boolean | Pick<WsAnnouncementOptions, 'categories' | 'includeBody'>;
         myOrder?: string[];
         myAsset?: boolean;
-    } & WsStreamOptions): WsStreamManager;
+    } & WsStreamOptions): WsStreamManager<ConnectPrivateServerEvent>;
+    /** Subscribe to multiple info streams at once. Requires authentication. */
+    subscribeInfo(opts: {
+        indicator?: WsIndicatorSubscription | WsIndicatorSubscription[];
+        indicatorSignal?: WsIndicatorSignalSubscription | WsIndicatorSignalSubscription[];
+    } & WsStreamOptions): WsStreamManager<ConnectInfoServerEvent>;
 }
 export {};
 //# sourceMappingURL=ws.d.ts.map

package/lib/ws.d.ts.map

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