dolphindb 3.1.39 → 3.1.42

package/browser.d.ts

@@ -1,7 +1,7 @@
 import type { Dayjs } from 'dayjs';
 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, type DdbExtObjValue, type ConvertableDdbTimeValue, type DdbLanguage } from './common.ts';
+import { DdbChartType, DdbForm, DdbFunctionType, DdbType, DdbVoidType, SqlStandard, 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, type DdbLanguage } from './common.ts';
 export * from './common.ts';
 export interface DdbDecimal128VectorValue {
     scale: number;
@@ -47,7 +47,9 @@ export interface DdbChartValue {
         z_axis?: string;
     };
     extras?: {
-        multi_y_axes: boolean;
+        multi_y_axes?: boolean;
+        /** 自适应 y 轴，而不是从 0 刻度开始 */
+        auto_scale_y_axes?: boolean;
     };
     data: DdbMatrixObj;
 }
@@ -138,7 +140,7 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
         strides: number[];
     }, limit?: number): TensorData;
     toString(options?: InspectOptions): string;
-    inspect_type(): string;
+    inspect_type(): any;
     /** 自动转换 Convertable 为 DdbObj */
     static to_ddbobj(value: Convertable): DdbObj;
     /** 转换 js 数组为 DdbObj[] */
@@ -185,7 +187,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 | DdbExtObjValue;
+export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | number[] | string[] | 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` */
@@ -362,19 +364,13 @@ export declare class DdbDatabaseError extends Error {
     options: DdbRpcOptions;
     constructor(message: string, url: string, type: DdbRpcType, options: DdbRpcOptions, id: number);
 }
-/** SQL Standrd 标准类型 */
-export declare enum SqlStandard {
-    DolphinDB = 0,
-    Oracle = 1,
-    MySQL = 2
-}
 export interface DdbOptions {
     autologin?: boolean;
     ticket?: string;
     username?: string;
     password?: string;
     python?: boolean;
-    kdb?: boolean;
+    q?: boolean;
     sql?: SqlStandard;
     streaming?: StreamingParams;
     verbose?: boolean;
@@ -414,8 +410,8 @@ export declare class DDB {
     password: string;
     /** python session flag (2048) */
     python: boolean;
-    /** kdb session flag (4096) */
-    kdb: boolean;
+    /** q session flag (4096) */
+    q: boolean;
     /** 是否为 dolphindb 语言 */
     dolphindb: boolean;
     language: DdbLanguage;
@@ -458,7 +454,7 @@ export declare class DDB {
             - username?: DolphinDB 登录用户名，默认 `'admin'`  DolphinDB username, default `'admin'`
             - password?: DolphinDB 登录密码，默认 `'123456'`  DolphinDB password, default `'123456'`
             - python?: 设置 python session flag，默认 `false`  set python session flag, default `false`
-            - kdb?: 设置 kdb session flag，默认 `false`  set kdb session flag, default `false`
+            - q?: 设置 q session flag，默认 `false`  set q session flag, default `false`
             - streaming?: 设置该选项后，该 WebSocket 连接只用于流数据  When this option is set, the WebSocket connection is only used for streaming data
             - verbose?: 是否打印每个 rpc 的信息用于调试
             - sql?: 设置当前会话执行的 sql 标准, 请使用 SqlStandard 枚举进行传参，默认 `DolphinDB`

package/browser.js

@@ -1,9 +1,9 @@
-import { empty } from 'xshell/prototype.browser.js';
+import { empty, to_lower_camel_case } from 'xshell/prototype.browser.js';
 import { blue, cyan, green, gray, magenta } from 'xshell/chalk.browser.js';
-import { concat, assert, Lock, genid, seq, zip_object, decode, check } from 'xshell/utils.browser.js';
+import { concat, assert, Lock, genid, seq, zip_object, decode, check, map_keys } from 'xshell/utils.browser.js';
 import { connect_websocket } from 'xshell/net.browser.js';
 import { t } from "./i18n/index.js";
-import { ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, generate_array_type, DdbFunctionType, DdbType, DdbVoidType, dictables, function_definition_patterns, get_big_int_128, get_time_ddbobj, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, time_formatters, number_nulls, nulls, set_big_int_128, uuid2str, get_times_ddbobj, funcdefs, get_number_formatter, urgent } from "./common.js";
+import { ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, generate_array_type, DdbFunctionType, DdbType, DdbVoidType, dictables, function_definition_patterns, get_big_int_128, get_time_ddbobj, get_duration_unit, get_type_name, int1282str, ipaddr2str, is_decimal_null_value, is_decimal_type, time_formatters, number_nulls, nulls, set_big_int_128, SqlStandard, uuid2str, get_times_ddbobj, funcdefs, get_number_formatter, urgent } from "./common.js";
 export * from "./common.js";
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
@@ -172,15 +172,7 @@ export class DdbObj {
                         },
                         ...bin_start ? { bin_start, bin_end, } : {},
                         ...bin_count ? { bin_count } : {},
-                        ...extras ? (() => {
-                            const { multiYAxes: multi_y_axes = false, ...extras_others } = extras.to_dict({ strip: true });
-                            return {
-                                extras: {
-                                    multi_y_axes,
-                                    ...extras_others,
-                                }
-                            };
-                        })() : {},
+                        ...extras ? { extras: map_keys(extras.data()) } : {},
                         data,
                         ...others,
                     };
@@ -956,10 +948,7 @@ export class DdbObj {
                         ...bin_start ? { binStart: bin_start, binEnd: bin_end } : {},
                         ...bin_count ? { binCount: bin_count } : {},
                         title: new DdbVectorString([chart, x_axis, y_axis, z_axis]),
-                        ...extras ? (() => {
-                            const { multi_y_axes, ...extras_other } = extras;
-                            return { extras: new DdbDict({ multiYAxes: multi_y_axes, ...extras_other }) };
-                        })() : {},
+                        ...extras ? { extras: new DdbDict(map_keys(extras, to_lower_camel_case)) } : {},
                         data,
                     });
                     return [keys.pack(), values.pack()];
@@ -2402,13 +2391,6 @@ export class DdbDatabaseError extends Error {
         this.id = id;
     }
 }
-/** SQL Standrd 标准类型 */
-export var SqlStandard;
-(function (SqlStandard) {
-    SqlStandard[SqlStandard["DolphinDB"] = 0] = "DolphinDB";
-    SqlStandard[SqlStandard["Oracle"] = 1] = "Oracle";
-    SqlStandard[SqlStandard["MySQL"] = 2] = "MySQL";
-})(SqlStandard || (SqlStandard = {}));
 export class DDB {
     /** 当前的 session id (http 或 tcp) */
     sid = '0';
@@ -2434,8 +2416,8 @@ export class DDB {
     password = '123456';
     /** python session flag (2048) */
     python = false;
-    /** kdb session flag (4096) */
-    kdb = false;
+    /** q session flag (4096) */
+    q = false;
     /** 是否为 dolphindb 语言 */
     dolphindb = true;
     language = 'dolphindb';
@@ -2481,7 +2463,7 @@ export class DDB {
             - username?: DolphinDB 登录用户名，默认 `'admin'`  DolphinDB username, default `'admin'`
             - password?: DolphinDB 登录密码，默认 `'123456'`  DolphinDB password, default `'123456'`
             - python?: 设置 python session flag，默认 `false`  set python session flag, default `false`
-            - kdb?: 设置 kdb session flag，默认 `false`  set kdb session flag, default `false`
+            - q?: 设置 q session flag，默认 `false`  set q session flag, default `false`
             - streaming?: 设置该选项后，该 WebSocket 连接只用于流数据  When this option is set, the WebSocket connection is only used for streaming data
             - verbose?: 是否打印每个 rpc 的信息用于调试
             - sql?: 设置当前会话执行的 sql 标准, 请使用 SqlStandard 枚举进行传参，默认 `DolphinDB`
@@ -2512,9 +2494,9 @@ export class DDB {
             this.dolphindb = false;
             this.language = 'python';
         }
-        if (options.kdb !== undefined && (this.kdb = Boolean(options.kdb))) {
+        if (options.q !== undefined && (this.q = Boolean(options.q))) {
             this.dolphindb = false;
-            this.language = 'kdb';
+            this.language = 'q';
         }
         if (options.sql !== undefined)
             this.sql = options.sql;
@@ -2617,8 +2599,8 @@ export class DDB {
         // python session
         if (this.python)
             flag += 2048;
-        // kdb session
-        if (this.kdb)
+        // q session
+        if (this.q)
             flag += 4096;
         // sql standrd
         flag += 2 ** 19 * this.sql;