dolphindb 3.1.2 → 3.1.5

package/browser.d.ts

@@ -1,8 +1,7 @@
 import type { Dayjs } from 'dayjs';
-import 'xshell/prototype.browser.js';
 import { Lock } from 'xshell/utils.browser.js';
 import { type WebSocketConnectionError } from 'xshell/net.browser.js';
-import { DdbChartType, DdbForm, DdbFunctionType, DdbType, DdbVoidType, type ConvertOptions, type DdbDecimal32Value, type DdbDecimal32VectorValue, type DdbDecimal64Value, type DdbDecimal64VectorValue, type DdbDurationValue, type DdbDurationVectorValue, type DdbFunctionDefValue, type DdbRpcType, type DdbScalarValue, type DdbSymbolExtendedValue, type DdbTableData, type DdbTensorValue, type IotVectorItemValue, type TensorData } from './common.ts';
+import { DdbChartType, DdbForm, DdbFunctionType, DdbType, DdbVoidType, type ConvertOptions, type DdbDecimal32Value, type DdbDecimal32VectorValue, type DdbDecimal64Value, type DdbDecimal64VectorValue, type DdbDurationValue, type DdbDurationVectorValue, type DdbFunctionDefValue, type DdbRpcType, type DdbScalarValue, type DdbSymbolExtendedValue, type DdbTableData, type DdbTensorValue, type IotVectorItemValue, type TensorData, type DdbExtObjValue, type ConvertableDdbTimeValue } from './common.ts';
 export * from './common.ts';
 export interface DdbDecimal128VectorValue {
     scale: number;
@@ -51,7 +50,7 @@ export interface DdbChartValue {
     };
     data: DdbMatrixObj;
 }
-export type DdbValue = DdbScalarValue | DdbVectorValue | DdbMatrixValue | DdbDictValue | DdbChartValue | DdbTensorValue;
+export type DdbValue = DdbScalarValue | DdbVectorValue | DdbMatrixValue | DdbDictValue | DdbChartValue | DdbTensorValue | DdbExtObjValue;
 export type DdbStringObj = DdbObj<string>;
 export type DdbVectorObj<TValue extends DdbVectorValue = DdbVectorValue> = DdbObj<TValue>;
 export type DdbVectorAnyObj = DdbVectorObj<DdbObj[]>;
@@ -185,7 +184,7 @@ export interface InspectOptions {
 export declare function format(type: DdbType, value: DdbValue, le: boolean, options?: InspectOptions): string;
 /** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export declare function formati(obj: DdbVectorObj, index: number, options?: InspectOptions): string;
-export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | number[] | Uint8Array<ArrayBufferLike> | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | string[] | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue | DdbTensorValue;
+export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | string[] | number[] | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbSymbolExtendedValue | DdbExtObjValue | DdbTensorValue | Uint8Array<ArrayBufferLike> | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbArrayVectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
 /** 构造 void 类型，默认为 `DdbVoidType.undefined` */
@@ -252,6 +251,21 @@ export declare class DdbVectorSymbol extends DdbObj<DdbSymbolExtendedValue> {
 export declare class DdbVectorChar extends DdbObj<Int8Array> {
     constructor(chars?: Uint8Array | Int8Array | ArrayBuffer, name?: string);
 }
+export declare class DdbVectorBool extends DdbObj<Int8Array> {
+    constructor(bools?: (boolean | null)[], name?: string);
+}
+export declare class DdbVectorDatetime extends DdbObj<Int32Array> {
+    constructor(datetimes: ConvertableDdbTimeValue[], name?: string);
+}
+export declare class DdbVectorTimeStamp extends DdbObj<BigInt64Array> {
+    constructor(timestamps: ConvertableDdbTimeValue[], name?: string);
+}
+export declare class DdbVectorNanoTimeStamp extends DdbObj<BigInt64Array> {
+    constructor(nanotimestamps: ConvertableDdbTimeValue[], name?: string);
+}
+export declare class DdbVectorDate extends DdbObj<BigInt64Array> {
+    constructor(dates: ConvertableDdbTimeValue[], name?: string);
+}
 export declare class DdbSetInt extends DdbObj<Int32Array> {
     constructor(ints: (number | null)[] | Set<number> | Int32Array);
 }

package/browser.js

@@ -1,9 +1,9 @@
-import 'xshell/prototype.browser.js';
+import { empty } from 'xshell/prototype.browser.js';
 import { blue, cyan, green, grey, magenta } from 'xshell/chalk.browser.js';
 import { concat, assert, Lock, genid, seq, zip_object, decode, delay, check } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
 import { t } from "./i18n/index.js";
-import { date2str, datehour2str, datetime2str, ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables, function_definition_pattern, generate_array_type, get_big_int_128, get_ddb_time_value, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, minute2str, month2str, nanotime2str, nanotimestamp2str, nulls, second2str, set_big_int_128, time2str, timestamp2str, uuid2str } from "./common.js";
+import { date2str, datehour2str, datetime2str, ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables, function_definition_pattern, generate_array_type, get_big_int_128, get_time_ddbobj, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, minute2str, month2str, nanotime2str, nanotimestamp2str, nulls, second2str, set_big_int_128, time2str, timestamp2str, uuid2str, get_times_ddbobj } from "./common.js";
 export * from "./common.js";
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
@@ -283,6 +283,23 @@ export class DdbObj {
                     }
                 });
             }
+            case DdbForm.extobj: {
+                const dv = new DataView(buf_data.buffer, buf_data.byteOffset, buf_data.byteLength);
+                const version_and_size = dv.getUint32(4, le);
+                const length = version_and_size & 0x00ffffff;
+                return new this({
+                    le,
+                    form,
+                    type,
+                    // 低 24 位为 size
+                    length: i_data + 8 + length,
+                    value: {
+                        type: buf_data.subarray(0, 4),
+                        version: (version_and_size >>> 24) & 0xff,
+                        data: buf_data.subarray(8, 8 + length)
+                    }
+                });
+            }
             default:
                 return new this({
                     le,
@@ -989,8 +1006,14 @@ export class DdbObj {
                     uint8Array.set(data, dataStart);
                     return [uint8Array];
                 }
+                case DdbForm.extobj: {
+                    const { data, type: exttype, version } = value;
+                    let version_and_size = new Uint8Array(4);
+                    version_and_size.dataview.setUint32(0, (version << 24) | data.length, this.le);
+                    return [exttype, version_and_size, data];
+                }
                 default:
-                    throw new Error(t('vector {{type}} 暂不支持序列化', { type: get_type_name(type) }));
+                    throw new Error(t('{{form}} 暂不支持序列化', { form: DdbForm[form] || `form ${form}` }));
             }
         })();
         if (!body)
@@ -1148,7 +1171,7 @@ export class DdbObj {
             case DdbForm.tensor: {
                 const { data_type, tensor_type, device_type, tensor_flags, dimensions, shape, strides, preserve_value, elem_count, data, } = this.value;
                 const dataByte = ddb_tensor_bytes[data_type];
-                const returnData = {
+                return {
                     data_type,
                     tensor_type,
                     device_type,
@@ -1160,10 +1183,12 @@ export class DdbObj {
                     elem_count,
                     data: DdbObj.parse_tensor({ currentDim: 0, dimensions, rawData: data, le: this.le, dataByte, dataType: data_type, shape, strides })
                 };
-                return returnData;
             }
+            case DdbForm.extobj:
+                // return (this.value as DdbExtObjValue).data as TResult
+                return `ExtObj<${get_type_name(type)}>`;
             default:
-                throw new Error(t('{{form}} {{type}} 暂不支持 data()', { form, type: get_type_name(type) }));
+                throw new Error(t('{{form}} {{type}} 暂不支持 data()', { form: DdbForm[form] || form, type: get_type_name(type) }));
         }
     }
     /** 构建 Tensor
@@ -2072,38 +2097,22 @@ export class DdbDouble extends DdbObj {
 }
 export class DdbDateTime extends DdbObj {
     constructor(value) {
-        super({
-            form: DdbForm.scalar,
-            type: DdbType.datetime,
-            value: get_ddb_time_value('DdbDateTime', value)
-        });
+        super(get_time_ddbobj(DdbType.datetime, value));
     }
 }
 export class DdbTimeStamp extends DdbObj {
     constructor(value) {
-        super({
-            form: DdbForm.scalar,
-            type: DdbType.timestamp,
-            value: get_ddb_time_value('DdbTimeStamp', value)
-        });
+        super(get_time_ddbobj(DdbType.timestamp, value));
     }
 }
 export class DdbNanoTimeStamp extends DdbObj {
     constructor(value) {
-        super({
-            form: DdbForm.scalar,
-            type: DdbType.nanotimestamp,
-            value: get_ddb_time_value('DdbNanoTimeStamp', value)
-        });
+        super(get_time_ddbobj(DdbType.nanotimestamp, value));
     }
 }
 export class DdbDate extends DdbObj {
     constructor(value) {
-        super({
-            form: DdbForm.scalar,
-            type: DdbType.date,
-            value: get_ddb_time_value('DdbDate', value)
-        });
+        super(get_time_ddbobj(DdbType.date, value));
     }
 }
 export class DdbBlob extends DdbObj {
@@ -2266,6 +2275,45 @@ export class DdbVectorChar extends DdbObj {
         });
     }
 }
+export class DdbVectorBool extends DdbObj {
+    constructor(bools, name) {
+        const length = bools?.length || 0;
+        let value = new Int8Array(length);
+        if (length)
+            for (let i = 0; i < length; ++i) {
+                const x = bools[i];
+                value[i] = empty(x) ? nulls.int8 : x ? 1 : 0;
+            }
+        super({
+            form: DdbForm.vector,
+            type: DdbType.bool,
+            rows: length,
+            cols: 1,
+            value,
+            name
+        });
+    }
+}
+export class DdbVectorDatetime extends DdbObj {
+    constructor(datetimes, name) {
+        super(get_times_ddbobj(DdbType.datetime, datetimes, name));
+    }
+}
+export class DdbVectorTimeStamp extends DdbObj {
+    constructor(timestamps, name) {
+        super(get_times_ddbobj(DdbType.timestamp, timestamps, name));
+    }
+}
+export class DdbVectorNanoTimeStamp extends DdbObj {
+    constructor(nanotimestamps, name) {
+        super(get_times_ddbobj(DdbType.nanotimestamp, nanotimestamps, name));
+    }
+}
+export class DdbVectorDate extends DdbObj {
+    constructor(dates, name) {
+        super(get_times_ddbobj(DdbType.date, dates, name));
+    }
+}
 export class DdbSetInt extends DdbObj {
     constructor(ints) {
         super({