dolphindb 0.0.1

package/index.d.ts

@@ -0,0 +1,252 @@
+import { inspect } from 'xshell/utils.js';
+export declare enum DdbForm {
+    scalar = 0,
+    vector = 1,
+    pair = 2,
+    matrix = 3,
+    set = 4,
+    dict = 5,
+    table = 6,
+    chart = 7,
+    chunk = 8
+}
+export declare enum DdbType {
+    void = 0,
+    bool = 1,
+    char = 2,
+    short = 3,
+    int = 4,
+    long = 5,
+    date = 6,
+    month = 7,
+    time = 8,
+    minute = 9,
+    second = 10,
+    datetime = 11,
+    timestamp = 12,
+    nanotime = 13,
+    nanotimestamp = 14,
+    float = 15,
+    double = 16,
+    symbol = 17,
+    string = 18,
+    uuid = 19,
+    functiondef = 20,
+    handle = 21,
+    code = 22,
+    datasource = 23,
+    resource = 24,
+    any = 25,
+    compress = 26,
+    dict = 27,
+    datehour = 28,
+    ipaddr = 30,
+    int128 = 31,
+    blob = 32,
+    complex = 34,
+    point = 35,
+    duration = 36,
+    symbol_extended = 145
+}
+export declare const ddb_sizes: readonly [0, 1, 1, 2, 4, 8, 4, 4, 4, 4, 4, 4, 8, 8, 8, 4, 8, 0, 0, 16, 0, 0, 0, 0, 0, 0, 1, 0, 0, 16, 16, 0, 0, 0, 0];
+export declare enum DdbFunctionType {
+    SystemFunc = 0,
+    SystemProc = 1,
+    OperatorFunc = 2,
+    UserDefinedFunc = 3,
+    PartialFunc = 4,
+    DynamicFunc = 5,
+    PiecewiseFunc = 6,
+    JitFunc = 7,
+    JitPartialFunc = 8
+}
+export interface DdbFunctionDefValue {
+    type: DdbFunctionType;
+    name: string;
+}
+export interface DdbSymbolExtendedValue {
+    base_id: number;
+    base: string[];
+    value: Uint32Array;
+}
+export declare type DdbValue = null | boolean | number | [number, number] | bigint | string | string[] | Uint8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbFunctionDefValue | DdbSymbolExtendedValue;
+export declare type DdbVectorValue = string | string[] | Uint8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | Uint8Array[] | DdbObj[] | DdbSymbolExtendedValue;
+export declare const nulls: {
+    readonly char: "€";
+    readonly int16: -32768;
+    readonly int32: -2147483648;
+    readonly int64: -9223372036854775808n;
+};
+export declare class DdbObj<T extends DdbValue = DdbValue> {
+    static dec: TextDecoder;
+    static enc: TextEncoder;
+    /** 维护已解析的 symbol base，比如流数据中后续的 symbol 向量可能只发送一个 base.id, base.size == 0, 依赖之前发送的 symbol base */
+    static symbol_bases: Record<number, string[]>;
+    /** little endian (client) */
+    static le_client: boolean;
+    /** 是否为小端 (little endian) */
+    le: boolean;
+    /** 数据形式 https://www.dolphindb.cn/cn/help/DataTypesandStructures/DataForms/index.html */
+    form: DdbForm;
+    /** 数据类型 https://www.dolphindb.cn/cn/help/DataTypesandStructures/DataTypes/index.html */
+    type: DdbType;
+    /** 占用 parse 时传入的 buf 的长度 */
+    length: number;
+    /** table name / column name */
+    name?: string;
+    /**
+        最低维、第 1 维
+        - vector: rows = n, cols = 1
+        - pair:   rows = 2, cols = 1
+        - matrix: rows = n, cols = m
+        - set:    同 vector
+        - dict:   包含 keys, values 向量
+        - table:  同 matrix
+    */
+    rows?: number;
+    /** 第 2 维 */
+    cols?: number;
+    /** matrix 中值的类型，仅 matrix 才有 */
+    datatype?: DdbType;
+    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据 */
+    value: T;
+    constructor(data: Partial<DdbObj> & {
+        form: DdbForm;
+        type: DdbType;
+        length: number;
+    });
+    static parse(buf: Uint8Array, le: boolean): DdbObj<DdbValue>;
+    static parse_scalar(buf: Uint8Array, le: boolean, type: DdbType): [number, DdbValue];
+    /** parse: rows, cols, items
+        返回的 ddbobj.length 不包括 vector 的 type 和 form
+    */
+    static parse_vector(buf: Uint8Array, le: boolean, type: DdbType): DdbObj;
+    /** 有可能没有字节对齐，不能直接使用原有 message 的 arraybuffer, 统一复制出来，让原有 arraybuffer 被回收掉比较好 */
+    static parse_vector_items(buf: Uint8Array, le: boolean, type: DdbType, length: number): [
+        number,
+        DdbVectorValue
+    ];
+    pack(): Uint8Array;
+    static pack_vector_body(value: DdbVectorValue, type: DdbType, length: number): ArrayBufferView[];
+    [inspect.custom](): string;
+}
+export declare class DdbVoid extends DdbObj<undefined> {
+    constructor();
+}
+export declare class DdbBool extends DdbObj<boolean> {
+    constructor(value: boolean);
+}
+export declare class DdbInt extends DdbObj<number> {
+    constructor(value: number);
+}
+export declare class DdbString extends DdbObj<string> {
+    constructor(value: string);
+}
+export declare class DdbLong extends DdbObj<bigint> {
+    constructor(value: bigint);
+}
+export declare class DdbDouble extends DdbObj<number> {
+    constructor(value: number);
+}
+export declare class DdbVectorInt extends DdbObj<Int32Array> {
+    constructor(value: number[]);
+}
+export declare class DdbVectorString extends DdbObj<string[]> {
+    constructor(value: string[]);
+}
+export declare class DdbVectorDouble extends DdbObj<Float64Array> {
+    constructor(value: number[]);
+}
+export declare class DdbVectorAny extends DdbObj {
+    constructor(value: DdbObj<DdbValue>[]);
+}
+export declare class DdbPair extends DdbObj<Int32Array> {
+    constructor(l: number, r?: number);
+}
+export declare class DdbFunction extends DdbObj<DdbFunctionDefValue> {
+    constructor(name: string, type: DdbFunctionType);
+}
+export declare class DDB {
+    port: number;
+    /** 当前的 session id (http 或 tcp) */
+    sid: string;
+    /** utf-8 text decoder */
+    dec: TextDecoder;
+    enc: TextEncoder;
+    print_buffer: boolean;
+    ws_url: string;
+    ws: WebSocket;
+    /** little endian (server) */
+    le: boolean;
+    /** little endian (client) */
+    static le_client: boolean;
+    /** resolver, rejector, promise of last rpc */
+    presolver(buf: Uint8Array): void;
+    prejector(error: Error): void;
+    presult: Promise<Uint8Array>;
+    constructor(ws_url: string);
+    /** 连接到 DolphinDB Server */
+    connect({ ws_url, login, username, password, }?: {
+        /** 默认使用实例初始化时传入的 WebSocket 链接地址 */
+        ws_url?: string;
+        /** 是否在建立连接后自动登录，默认 true */
+        login?: boolean;
+        /** DolphinDB 登录用户名 */
+        username?: string;
+        /** DolphinDB 登录密码 */
+        password?: string;
+    }): Promise<void>;
+    disconnect(): void;
+    /** rpc through websocket (function command)
+        - type: API 类型: 'script' | 'function' | 'variable'
+        - options:
+            - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
+            - vars?: type === 'variable' 时必传，variable 指令中待上传的变量名
+    */
+    rpc<T extends DdbObj = DdbObj>(type: 'script' | 'function' | 'variable', { script, func, args, vars, urgent, }: {
+        script?: string;
+        func?: string;
+        args?: (DdbObj | string | boolean)[];
+        vars?: string[];
+        urgent?: boolean;
+    }): Promise<T>;
+    /** eval script through websocket (script command) */
+    eval<T extends DdbObj>(
+    /** 执行的脚本 */
+    script: string, 
+    /** 执行选项 */
+    { urgent }?: {
+        /** 紧急 flag，使用 urgent worker 处理，防止被其它作业阻塞 */
+        urgent?: boolean;
+    }): Promise<T>;
+    /** call function through websocket (function command)
+        - func: 函数名
+        - args?: `[ ]` 调用参数 (传入的原生 string 和 boolean 会被自动转换为 DdbObj<string> 和 DdbObj<boolean>)
+        - options?: 调用选项
+            - urgent?: 紧急 flag，使用 urgent worker 处理，防止被其它作业阻塞
+            - node?: 设置结点 alias 时发送到集群中对应的结点执行 (使用 DolphinDB 中的 rpc 方法)
+            - nodes?: 设置多个结点 alias 时发送到集群中对应的多个结点执行 (使用 DolphinDB 中的 pnodeRun 方法)
+            - func_type?: 设置 node 参数时必传，需指定函数类型，其它情况下不传
+            - add_node_alias?: 设置 nodes 参数时选传，其它情况不传
+    */
+    call<T extends DdbObj>(func: string, args?: (DdbObj | string | boolean)[], { urgent, node, nodes, func_type, add_node_alias }?: {
+        urgent?: boolean;
+        node?: string;
+        nodes?: string[];
+        func_type?: DdbFunctionType;
+        add_node_alias?: boolean;
+    }): Promise<T>;
+    /** upload variable through websocket (variable command) */
+    upload(
+    /** 上传的变量名 */
+    vars: string[], 
+    /** 上传的变量值 */
+    args: (DdbObj | string | boolean)[]): Promise<DdbObj<DdbValue>>;
+    /** 解析服务端响应报文，返回去掉 header 的 data buf */
+    parse_message(buf: Uint8Array): Uint8Array;
+    /** 自动转换 js string, boolean 为 DdbObj */
+    to_ddbobj(value: DdbObj | string | boolean): DdbObj;
+    /** 转换 js 数组为 DdbObj[] (in place, 会修改原数组) */
+    to_ddbobjs(values: any[]): DdbObj<DdbValue>[];
+}
+export default DDB;