dolphindb 2.0.503 → 2.0.506

package/index.d.ts

@@ -78,11 +78,10 @@ export interface DdbArrayVectorBlock {
     lengths: Uint8Array | Uint16Array | Uint32Array;
     data: DdbVectorValue;
 }
-export declare type DdbValue = null | boolean | number | [number, number] | bigint | string | string[] | Uint8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbFunctionDefValue | DdbSymbolExtendedValue | DdbArrayVectorBlock[];
-export declare type DdbVectorValue = string | string[] | Uint8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbSymbolExtendedValue | DdbArrayVectorBlock[];
+export declare type DdbValue = null | boolean | number | [number, number] | bigint | string | string[] | Uint8Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbFunctionDefValue | DdbSymbolExtendedValue | DdbArrayVectorBlock[];
+export declare type DdbVectorValue = string | string[] | Uint8Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbSymbolExtendedValue | DdbArrayVectorBlock[];
 export declare const nulls: {
-    readonly bool: 128;
-    readonly char: "€";
+    readonly int8: -128;
     readonly int16: -32768;
     readonly int32: -2147483648;
     readonly int64: -9223372036854775808n;
@@ -128,6 +127,8 @@ export declare class DdbObj<T extends DdbValue = DdbValue> {
     datatype?: DdbType;
     /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据 */
     value: T;
+    /** 原始二进制数据 */
+    buffer?: Uint8Array;
     constructor(data: Partial<DdbObj> & {
         form: DdbForm;
         type: DdbType;
@@ -157,7 +158,7 @@ export declare class DdbBool extends DdbObj<boolean> {
     constructor(value: boolean | null);
 }
 export declare class DdbChar extends DdbObj<string> {
-    constructor(value: string | null);
+    constructor(value: string | number | null);
 }
 export declare class DdbInt extends DdbObj<number> {
     constructor(value: number | null);
@@ -189,18 +190,27 @@ export declare class DdbFunction extends DdbObj<DdbFunctionDefValue> {
 export declare class DdbVectorInt extends DdbObj<Int32Array> {
     constructor(ints: (number | null)[] | Int32Array, name?: string);
 }
-export declare class DdbVectorString extends DdbObj<string[]> {
-    constructor(strings: string[], name?: string);
-}
 export declare class DdbVectorDouble extends DdbObj<Float64Array> {
     constructor(doubles: (number | null)[] | Float64Array, name?: string);
 }
+export declare class DdbVectorString extends DdbObj<string[]> {
+    constructor(strings: string[], name?: string);
+}
 export declare class DdbVectorAny extends DdbObj {
     constructor(objs: DdbObj<DdbValue>[], name?: string);
 }
 export declare class DdbVectorSymbol extends DdbObj<DdbSymbolExtendedValue> {
     constructor(strings: string[], name?: string);
 }
+export declare class DdbSetInt extends DdbObj<Int32Array> {
+    constructor(ints: (number | null)[] | Set<number> | Int32Array);
+}
+export declare class DdbSetDouble extends DdbObj<Float64Array> {
+    constructor(doubles: (number | null)[] | Set<number> | Float64Array);
+}
+export declare class DdbSetString extends DdbObj<string[]> {
+    constructor(strings: string[] | Set<string>);
+}
 export declare class DdbTable extends DdbObj<DdbObj[]> {
     constructor(columns: DdbObj[], name?: string);
 }
@@ -242,7 +252,6 @@ export declare class DDB {
     /** utf-8 text decoder */
     dec: TextDecoder;
     enc: TextEncoder;
-    print_buffer: boolean;
     /** DolphinDB WebSocket URL
         e.g. `ws://127.0.0.1:8848/`, `wss://dolphindb.com`
     */
@@ -260,13 +269,16 @@ export declare class DDB {
     password: string;
     /** python session flag (2048) */
     python: boolean;
-    message_hook: (message: Uint8Array) => any;
-    /** print message handler */
-    printer(message: string): void;
+    print_message_buffer: boolean;
+    print_object_buffer: boolean;
+    print_message: boolean;
+    parse_object: boolean;
+    /** message handlers */
+    handlers: DdbMessageHandler[];
     /** resolver, rejector, promise of last rpc */
-    presolver(buf: Uint8Array): void;
+    presolver(ddbobj: DdbObj): void;
     prejector(error: Error): void;
-    presult: Promise<Uint8Array>;
+    presult: Promise<DdbObj<DdbValue>>;
     get connected(): boolean;
     /**
         Initialize an instance of DolphinDB Client using the WebSocket URL
@@ -280,6 +292,8 @@ export declare class DDB {
         
         @example
         let ddb = new DDB('ws://127.0.0.1:8848')
+        
+        // 使用 HTTPS 加密
         let ddbsecure = new DDB('wss://dolphindb.com', {
             autologin: true,
             username: 'admin',
@@ -337,22 +351,31 @@ export declare class DDB {
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
             - vars?: type === 'variable' 时必传，variable 指令中待上传的变量名
+            - handler?: 处理本次 rpc 期间的消息
+            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
+                不做解析，以便后续转发、序列化
     */
-    rpc<T extends DdbObj = DdbObj>(type: 'script' | 'function' | 'variable' | 'connect', { script, func, args, vars, urgent, }: {
+    rpc<T extends DdbObj = DdbObj>(type: 'script' | 'function' | 'variable' | 'connect', { script, func, args, vars, urgent, handler, parse_object, }: {
         script?: string;
         func?: string;
         args?: (DdbObj | string | boolean)[];
         vars?: string[];
         urgent?: boolean;
+        handler?: DdbMessageHandler;
+        parse_object?: boolean;
     }): Promise<T>;
-    /** eval script through websocket (script command) */
-    eval<T extends DdbObj>(
-    /** 执行的脚本 */
-    script: string, 
-    /** 执行选项 */
-    { urgent }?: {
-        /** 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞 */
+    /** eval script through websocket (script command)
+        - script?: 执行的脚本
+        - options?: 执行选项
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
+            - handler?: 处理本次 rpc 期间的消息
+            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
+                不做解析，以便后续转发、序列化
+    */
+    eval<T extends DdbObj>(script: string, { urgent, handler, parse_object, }?: {
         urgent?: boolean;
+        handler?: DdbMessageHandler;
+        parse_object?: boolean;
     }): Promise<T>;
     /** call function through websocket (function command)
         - func: 函数名
@@ -363,31 +386,49 @@ export declare class DDB {
             - nodes?: 设置多个结点 alias 时发送到集群中对应的多个结点执行 (使用 DolphinDB 中的 pnodeRun 方法)
             - func_type?: 设置 node 参数时必传，需指定函数类型，其它情况下不传
             - add_node_alias?: 设置 nodes 参数时选传，其它情况不传
+            - handler?: 处理本次 rpc 期间的消息
+            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
+                不做解析，以便后续转发、序列化
     */
-    call<T extends DdbObj>(func: string, args?: (DdbObj | string | boolean)[], { urgent, node, nodes, func_type, add_node_alias }?: {
+    call<T extends DdbObj>(func: string, args?: (DdbObj | string | boolean)[], { urgent, node, nodes, func_type, add_node_alias, handler, parse_object, }?: {
         urgent?: boolean;
         node?: string;
         nodes?: string[];
         func_type?: DdbFunctionType;
         add_node_alias?: boolean;
+        handler?: DdbMessageHandler;
+        parse_object?: boolean;
     }): Promise<T>;
     /** upload variable through websocket (variable command) */
     upload(
     /** Uploaded variables' name */
     vars: string[], 
     /** Uploaded variables' value */
-    args: (DdbObj | string | boolean)[]): Promise<DdbObj<DdbValue>>;
+    args: (DdbObj | string | boolean)[], { handler, parse_object, }?: {
+        handler?: DdbMessageHandler;
+        parse_object?: boolean;
+    }): Promise<DdbObj<DdbValue>>;
     /** 解析服务端响应报文，返回去掉 header 的 data buf */
-    parse_message(buf: Uint8Array): {
-        type: "message";
-        data: string;
-    } | {
-        type: "object";
-        data: Uint8Array;
-    };
+    parse_message(buf: Uint8Array, parse_object?: boolean): DdbMessage;
     /** 自动转换 js string, boolean 为 DdbObj */
     to_ddbobj(value: DdbObj | string | boolean): DdbObj;
     /** 转换 js 数组为 DdbObj[] */
     to_ddbobjs(values: any[]): DdbObj<DdbValue>[];
 }
+export interface DdbMessageHandler {
+    (message: DdbMessage, _this: DDB): any;
+}
+export interface DdbPrintMessage {
+    type: 'print';
+    data: string;
+}
+export interface DdbObjectMessage {
+    type: 'object';
+    data: DdbObj;
+}
+export interface DdbErrorMessage {
+    type: 'error';
+    data: Error;
+}
+export declare type DdbMessage = DdbPrintMessage | DdbObjectMessage | DdbErrorMessage;
 export default DDB;