dolphindb 2.0.963 → 2.0.964

package/.vscode/launch.template.json

@@ -0,0 +1,16 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Current TS File",
+            "type": "node",
+            "request": "launch",
+            "runtimeExecutable": "node",
+            "runtimeArgs": ["./node_modules/ts-node/dist/bin-esm.js"],
+            "args": ["${file}"],
+            "cwd": "${workspaceRoot}",
+            "internalConsoleOptions": "openOnSessionStart",
+            "skipFiles": ["<node_internals>/**", "node_modules/**"]
+        }
+    ]
+}

package/browser.d.ts

@@ -1,92 +1,11 @@
 import 'xshell/prototype.browser.js';
 import { Lock } from 'xshell/utils.browser.js';
 import { type WebSocketConnectionError } from 'xshell/net.browser.js';
-export declare enum DdbForm {
-    scalar = 0,
-    vector = 1,
-    pair = 2,
-    matrix = 3,
-    set = 4,
-    dict = 5,
-    table = 6,
-    chart = 7,
-    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型
-        Node internal communication may be used, calling function execution script generally does not return this type */
-    chunk = 8,
-    /** sysobj */
-    object = 9
-}
-/** DolphinDB DataType
-    对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
-    对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
-*/
-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,
-    decimal32 = 37,
-    decimal64 = 38,
-    decimal128 = 39,
-    object = 40,
-    pynone = 41,
-    symbol_extended = 145
-}
-export declare enum DdbFunctionType {
-    SystemFunc = 0,
-    SystemProc = 1,
-    OperatorFunc = 2,
-    UserDefinedFunc = 3,
-    PartialFunc = 4,
-    DynamicFunc = 5,
-    PiecewiseFunc = 6,
-    JitFunc = 7,
-    JitPartialFunc = 8
-}
-export declare enum DdbDurationUnit {
-    ns = 0,
-    us = 1,
-    ms = 2,
-    s = 3,
-    m = 4,
-    H = 5,
-    d = 6,
-    w = 7,
-    M = 8,
-    y = 9,
-    B = 10
-}
+import { type DdbDecimal128Value, type DdbDecimal128VectorValue } from './data-types/decimal-128.js';
+import { BigInt128Array } from './shared/bigint-128-array.js';
+import { DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType } from './shared/constants.js';
+export * from './shared/constants.js';
+export type { DdbDecimal128Value, DdbDecimal128VectorValue } from './data-types/decimal-128.js';
 export interface DdbFunctionDefValue {
     type: DdbFunctionType;
     name: string;
@@ -108,7 +27,6 @@ export interface DdbDecimal64Value {
     /** int64, 空值为 null  empty value is null */
     data: bigint | null;
 }
-export type DdbDurationVectorValue = DdbDurationValue[];
 export interface DdbDecimal32VectorValue {
     scale: number;
     data: Int32Array;
@@ -117,6 +35,7 @@ export interface DdbDecimal64VectorValue {
     scale: number;
     data: BigInt64Array;
 }
+export type DdbDurationVectorValue = DdbDurationValue[];
 export interface DdbSymbolExtendedValue {
     base_id: number;
     base: string[];
@@ -126,9 +45,9 @@ export interface DdbArrayVectorBlock {
     unit: 1 | 2 | 4;
     rows: number;
     lengths: Uint8Array | Uint16Array | Uint32Array;
-    data: Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array;
+    data: Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | BigInt128Array;
 }
-export type DdbArrayVectorValue = DdbArrayVectorBlock[] & /* decimal32, decimal64 会有这个属性 */ {
+export type DdbArrayVectorValue = DdbArrayVectorBlock[] & /* decimal 数据会有这个属性 */ {
     scale?: number;
 };
 export interface DdbMatrixValue {
@@ -137,17 +56,6 @@ export interface DdbMatrixValue {
     data: DdbVectorValue;
 }
 export type DdbDictValue = [DdbVectorObj, DdbVectorObj];
-export declare enum DdbChartType {
-    area = 0,
-    bar = 1,
-    column = 2,
-    histogram = 3,
-    line = 4,
-    pie = 5,
-    scatter = 6,
-    trend = 7,
-    kline = 8
-}
 export interface DdbChartValue {
     /** 原属性 chartType  original: chartType */
     type: DdbChartType;
@@ -176,11 +84,11 @@ export type DdbScalarValue = null | boolean | number | bigint | string | Uint8Ar
     number,
     number
 ] | // complex, point
-DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value;
-export type DdbVectorValue = null | Uint8Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | string[] | // string[]
+DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal128Value;
+export type DdbVectorValue = null | Uint8Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array | BigInt64Array | BigInt128Array | string[] | // string[]
 Uint8Array[] | // blob
 DdbObj[] | // any
-DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDurationVectorValue;
+DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue;
 export type DdbValue = DdbScalarValue | DdbVectorValue | DdbMatrixValue | DdbDictValue | DdbChartValue;
 export type DdbStringObj = DdbObj<string>;
 export type DdbVectorObj<TValue extends DdbVectorValue = DdbVectorValue> = DdbObj<TValue>;
@@ -190,16 +98,6 @@ export type DdbTableObj<TColumns extends DdbVectorObj[] = DdbVectorObj[]> = DdbO
 export type DdbDictObj<TKeys extends DdbVectorObj = DdbVectorObj, TValues extends DdbVectorObj = DdbVectorObj> = DdbObj<[TKeys, TValues]>;
 export type DdbMatrixObj<TValue extends DdbMatrixValue = DdbMatrixValue> = DdbObj<TValue>;
 export type DdbChartObj = DdbObj<DdbChartValue>;
-export declare const nulls: {
-    readonly int8: -128;
-    readonly int16: -32768;
-    readonly int32: -2147483648;
-    readonly int64: -9223372036854775808n;
-    readonly float32: -3.4028234663852886e+38;
-    /** -Number.MAX_VALUE */
-    readonly double: number;
-    readonly bytes16: Uint8Array;
-};
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     static dec: TextDecoder;
@@ -704,4 +602,3 @@ export interface DdbErrorMessage {
     data: DdbDatabaseError;
 }
 export type DdbMessage = DdbPrintMessage | DdbObjectMessage | DdbErrorMessage;
-export {};

package/browser.js

@@ -8,118 +8,10 @@ import { blue, cyan, green, grey, magenta } from 'xshell/chalk.browser.js';
 import { concat, assert, Lock } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
 import { t } from './i18n/index.js';
-export var DdbForm;
-(function (DdbForm) {
-    DdbForm[DdbForm["scalar"] = 0] = "scalar";
-    DdbForm[DdbForm["vector"] = 1] = "vector";
-    DdbForm[DdbForm["pair"] = 2] = "pair";
-    DdbForm[DdbForm["matrix"] = 3] = "matrix";
-    DdbForm[DdbForm["set"] = 4] = "set";
-    DdbForm[DdbForm["dict"] = 5] = "dict";
-    DdbForm[DdbForm["table"] = 6] = "table";
-    DdbForm[DdbForm["chart"] = 7] = "chart";
-    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型
-        Node internal communication may be used, calling function execution script generally does not return this type */
-    DdbForm[DdbForm["chunk"] = 8] = "chunk";
-    /** sysobj */
-    DdbForm[DdbForm["object"] = 9] = "object";
-})(DdbForm = DdbForm || (DdbForm = {}));
-/** DolphinDB DataType
-    对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
-    对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
-*/
-export var DdbType;
-(function (DdbType) {
-    DdbType[DdbType["void"] = 0] = "void";
-    DdbType[DdbType["bool"] = 1] = "bool";
-    DdbType[DdbType["char"] = 2] = "char";
-    DdbType[DdbType["short"] = 3] = "short";
-    DdbType[DdbType["int"] = 4] = "int";
-    DdbType[DdbType["long"] = 5] = "long";
-    DdbType[DdbType["date"] = 6] = "date";
-    DdbType[DdbType["month"] = 7] = "month";
-    DdbType[DdbType["time"] = 8] = "time";
-    DdbType[DdbType["minute"] = 9] = "minute";
-    DdbType[DdbType["second"] = 10] = "second";
-    DdbType[DdbType["datetime"] = 11] = "datetime";
-    DdbType[DdbType["timestamp"] = 12] = "timestamp";
-    DdbType[DdbType["nanotime"] = 13] = "nanotime";
-    DdbType[DdbType["nanotimestamp"] = 14] = "nanotimestamp";
-    DdbType[DdbType["float"] = 15] = "float";
-    DdbType[DdbType["double"] = 16] = "double";
-    DdbType[DdbType["symbol"] = 17] = "symbol";
-    DdbType[DdbType["string"] = 18] = "string";
-    DdbType[DdbType["uuid"] = 19] = "uuid";
-    DdbType[DdbType["functiondef"] = 20] = "functiondef";
-    DdbType[DdbType["handle"] = 21] = "handle";
-    DdbType[DdbType["code"] = 22] = "code";
-    DdbType[DdbType["datasource"] = 23] = "datasource";
-    DdbType[DdbType["resource"] = 24] = "resource";
-    DdbType[DdbType["any"] = 25] = "any";
-    DdbType[DdbType["compress"] = 26] = "compress";
-    DdbType[DdbType["dict"] = 27] = "dict";
-    DdbType[DdbType["datehour"] = 28] = "datehour";
-    DdbType[DdbType["ipaddr"] = 30] = "ipaddr";
-    DdbType[DdbType["int128"] = 31] = "int128";
-    DdbType[DdbType["blob"] = 32] = "blob";
-    DdbType[DdbType["complex"] = 34] = "complex";
-    DdbType[DdbType["point"] = 35] = "point";
-    DdbType[DdbType["duration"] = 36] = "duration";
-    DdbType[DdbType["decimal32"] = 37] = "decimal32";
-    DdbType[DdbType["decimal64"] = 38] = "decimal64";
-    DdbType[DdbType["decimal128"] = 39] = "decimal128";
-    DdbType[DdbType["object"] = 40] = "object";
-    DdbType[DdbType["pynone"] = 41] = "pynone";
-    DdbType[DdbType["symbol_extended"] = 145] = "symbol_extended";
-})(DdbType = DdbType || (DdbType = {}));
-export var DdbFunctionType;
-(function (DdbFunctionType) {
-    DdbFunctionType[DdbFunctionType["SystemFunc"] = 0] = "SystemFunc";
-    DdbFunctionType[DdbFunctionType["SystemProc"] = 1] = "SystemProc";
-    DdbFunctionType[DdbFunctionType["OperatorFunc"] = 2] = "OperatorFunc";
-    DdbFunctionType[DdbFunctionType["UserDefinedFunc"] = 3] = "UserDefinedFunc";
-    DdbFunctionType[DdbFunctionType["PartialFunc"] = 4] = "PartialFunc";
-    DdbFunctionType[DdbFunctionType["DynamicFunc"] = 5] = "DynamicFunc";
-    DdbFunctionType[DdbFunctionType["PiecewiseFunc"] = 6] = "PiecewiseFunc";
-    DdbFunctionType[DdbFunctionType["JitFunc"] = 7] = "JitFunc";
-    DdbFunctionType[DdbFunctionType["JitPartialFunc"] = 8] = "JitPartialFunc";
-})(DdbFunctionType = DdbFunctionType || (DdbFunctionType = {}));
-export var DdbDurationUnit;
-(function (DdbDurationUnit) {
-    DdbDurationUnit[DdbDurationUnit["ns"] = 0] = "ns";
-    DdbDurationUnit[DdbDurationUnit["us"] = 1] = "us";
-    DdbDurationUnit[DdbDurationUnit["ms"] = 2] = "ms";
-    DdbDurationUnit[DdbDurationUnit["s"] = 3] = "s";
-    DdbDurationUnit[DdbDurationUnit["m"] = 4] = "m";
-    DdbDurationUnit[DdbDurationUnit["H"] = 5] = "H";
-    DdbDurationUnit[DdbDurationUnit["d"] = 6] = "d";
-    DdbDurationUnit[DdbDurationUnit["w"] = 7] = "w";
-    DdbDurationUnit[DdbDurationUnit["M"] = 8] = "M";
-    DdbDurationUnit[DdbDurationUnit["y"] = 9] = "y";
-    DdbDurationUnit[DdbDurationUnit["B"] = 10] = "B";
-})(DdbDurationUnit = DdbDurationUnit || (DdbDurationUnit = {}));
-export var DdbChartType;
-(function (DdbChartType) {
-    DdbChartType[DdbChartType["area"] = 0] = "area";
-    DdbChartType[DdbChartType["bar"] = 1] = "bar";
-    DdbChartType[DdbChartType["column"] = 2] = "column";
-    DdbChartType[DdbChartType["histogram"] = 3] = "histogram";
-    DdbChartType[DdbChartType["line"] = 4] = "line";
-    DdbChartType[DdbChartType["pie"] = 5] = "pie";
-    DdbChartType[DdbChartType["scatter"] = 6] = "scatter";
-    DdbChartType[DdbChartType["trend"] = 7] = "trend";
-    DdbChartType[DdbChartType["kline"] = 8] = "kline";
-})(DdbChartType = DdbChartType || (DdbChartType = {}));
-export const nulls = {
-    int8: -0x80,
-    int16: -0x80_00,
-    int32: -0x80_00_00_00,
-    int64: -0x8000000000000000n,
-    float32: -3.4028234663852886e+38,
-    /** -Number.MAX_VALUE */
-    double: -Number.MAX_VALUE,
-    bytes16: Uint8Array.from(new Array(16).fill(0))
-};
+import { DdbDecimal128Serializor } from './data-types/decimal-128.js';
+import { is_decimal_type, is_decimal_null_value } from './shared/utils/decimal-type.js';
+import { nulls, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType } from './shared/constants.js';
+export * from './shared/constants.js';
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 class DdbObj {
     static dec = new TextDecoder('utf-8');
@@ -475,6 +367,9 @@ class DdbObj {
                 const data = dv.getBigInt64(4, le);
                 return [12, { scale: dv.getInt32(0, le), data: data === nulls.int64 ? null : data }];
             }
+            case DdbType.decimal128: {
+                return DdbDecimal128Serializor.parse_as_scalar(buf, le);
+            }
             default:
                 throw new Error(String(DdbType[type] || type) + t(' 暂时不支持解析'));
         }
@@ -543,8 +438,8 @@ class DdbObj {
         const type_ = type - 64;
         const cols = dv.getUint32(4, le);
         let blocks = [];
-        // decimal32/64 会在所有 blocks 之前多一个 scale
-        if (type_ === DdbType.decimal32 || type_ === DdbType.decimal64) {
+        // decimal 会在所有 blocks 之前多一个 scale
+        if (is_decimal_type(type_)) {
             blocks.scale = dv.getInt32(i_items_start, le);
             i_items_start += 4;
         }
@@ -587,6 +482,9 @@ class DdbObj {
                     len_items = total_length * 8;
                     data = new BigInt64Array(buf.buffer.slice(buf.byteOffset + i_data_start, buf.byteOffset + i_data_start + len_items));
                     break;
+                case DdbType.decimal128:
+                    [len_items, data] = DdbDecimal128Serializor.parse_as_same_type_vector_values(buf, i_data_start, total_length);
+                    break;
                 default:
                     [len_items, data] = this.parse_vector_items(buf.subarray(i_data_start), le, type - 64, total_length);
             }
@@ -779,6 +677,8 @@ class DdbObj {
                     }
                 ];
             }
+            case DdbType.decimal128:
+                return DdbDecimal128Serializor.parse_as_vector_items(buf, length, le);
             // 以下情况时, DdbType.duration 实际会返回一个 any vector
             // [2y, 1M, 3d, 7H, 11m, 12s, 15ms, 16us, 17ns]
             // <Buffer 19 01 type = any, form = vector
@@ -915,6 +815,8 @@ class DdbObj {
                             const { scale, data } = this.value;
                             return [Int32Array.of(scale), BigInt64Array.of(data === null ? nulls.int64 : data)];
                         }
+                        case DdbType.decimal128:
+                            return DdbDecimal128Serializor.pack(this.value);
                         default:
                             throw new Error(String(DdbType[type] || type) + t(' 暂时不支持序列化'));
                     }
@@ -924,7 +826,7 @@ class DdbObj {
                     if (form === DdbForm.vector && 64 <= type && type < 128)
                         return [
                             Uint32Array.of(this.rows, this.cols),
-                            ...(type - 64 === DdbType.decimal32 || type - 64 === DdbType.decimal64) ?
+                            ...(is_decimal_type(type - 64)) ?
                                 [Int32Array.of(this.value.scale)]
                                 :
                                     [],
@@ -1071,7 +973,8 @@ class DdbObj {
                 ];
             }
             case DdbType.decimal32:
-            case DdbType.decimal64: {
+            case DdbType.decimal64:
+            case DdbType.decimal128: {
                 const { scale, data } = value;
                 return [Int32Array.of(scale), data];
             }
@@ -1118,9 +1021,9 @@ class DdbObj {
                                     switch (type_) {
                                         case DdbType.decimal32:
                                         case DdbType.decimal64:
+                                        case DdbType.decimal128:
                                             const x = data[acc_len + i];
-                                            if (x === nulls.int64 /* && type_ === DdbType.decimal64 一定成立 */ ||
-                                                x === nulls.int32 && type_ === DdbType.decimal32)
+                                            if (is_decimal_null_value(type_, x))
                                                 return '';
                                             const { scale } = this.value;
                                             const s = String(x < 0 ? -x : x).padStart(scale, '0');
@@ -1185,7 +1088,8 @@ class DdbObj {
                             return format_array(items, len_data > limit);
                         }
                         case DdbType.decimal32:
-                        case DdbType.decimal64: {
+                        case DdbType.decimal64:
+                        case DdbType.decimal128: {
                             const limit = 50;
                             const { data } = this.value;
                             let items = new Array(Math.min(limit, data.length));
@@ -1513,11 +1417,11 @@ export function format(type, value, le, options = {}) {
             return colors ? magenta(str) : str;
         }
         case DdbType.decimal32:
-        case DdbType.decimal64: {
+        case DdbType.decimal64:
+        case DdbType.decimal128: {
             const { scale, data } = value;
             if (data === null ||
-                (data === nulls.int64 && type === DdbType.decimal64) ||
-                (data === nulls.int32 && type === DdbType.decimal32))
+                is_decimal_null_value(type, data))
                 return get_nullstr();
             const s = String(data < 0 ? -data : data).padStart(scale, '0');
             const str = (data < 0 ? '-' : '') + (scale ? `${s.slice(0, -scale) || '0'}.${s.slice(-scale)}` : s);
@@ -1560,9 +1464,9 @@ export function formati(obj, index, options = {}) {
                     switch (type_) {
                         case DdbType.decimal32:
                         case DdbType.decimal64:
+                        case DdbType.decimal128:
                             const x = data[acc_len + i];
-                            if (x === nulls.int64 /* && type_ === DdbType.decimal64 一定成立 */ ||
-                                x === nulls.int32 && type_ === DdbType.decimal32)
+                            if (is_decimal_null_value(type_, x))
                                 return '';
                             const { scale } = obj.value;
                             const s = String(x < 0 ? -x : x).padStart(scale, '0');
@@ -1612,11 +1516,11 @@ export function formati(obj, index, options = {}) {
         case DdbType.point:
             return format(obj.type, obj.value.subarray(2 * index, 2 * (index + 1)), obj.le, options);
         case DdbType.decimal32:
-        case DdbType.decimal64: {
+        case DdbType.decimal64:
+        case DdbType.decimal128: {
             const { scale, data } = obj.value;
             const x = data[index];
-            if (x === nulls.int64 && obj.type === DdbType.decimal64 ||
-                x === nulls.int32 && obj.type === DdbType.decimal32)
+            if (is_decimal_null_value(obj.type, x))
                 return '';
             const s = String(x < 0 ? -x : x).padStart(scale, '0');
             const str = (x < 0 ? '-' : '') + (scale ? `${s.slice(0, -scale) || '0'}.${s.slice(-scale)}` : s);