dolphindb 3.0.0 → 3.0.2

package/eslint.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: Linter.FlatConfig[];
+export default _default;

package/eslint.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.config.js","sourceRoot":"","sources":["eslint.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,iDAAiD;AACjD,eAAe,CAAC,YAAY,CAAC,CAAA","sourcesContent":["import { xlint_config } from 'xshell/xlint.js'\n\n// eslint-disable-next-line no-restricted-exports\nexport default [xlint_config]\n"]}

package/i18n/dict.json

@@ -11,8 +11,8 @@
     "this.form 必须是 DdbForm.dict, 否则不能调用 to_dict 转换为 js object": {
         "en": "this.form must be DdbForm.dict, otherwise to_dict cannot be called to convert to js object"
     },
-    "当前只支持自动转换 dict<string, any> 为 js object": {
-        "en": "currently api only supports automatic conversion of dict<string, any> to js object"
+    "当前只支持自动转换 dict<string, any | ...dictables> 为 js object": {
+        "en": "currently api only supports automatic conversion of dict<string, any | ...dictables> to js object"
     },
     "deep = true 时必须设置 strip = true": {
         "en": "strip = true must be set when deep = true"
@@ -74,8 +74,8 @@
     "new DdbBlob 不能传空的 value": {
         "en": "new DdbBlob cannot pass an empty value"
     },
-    "vector<{{type}}> 暂时不支持解析": {
-        "en": "cannot parse vector<{{type}}>"
+    "{{form}}<{{type}}> 暂时不支持解析": {
+        "en": "cannot parse {{form}}<{{type}}>"
     },
     "流数据订阅后一定先返回 schema": {
         "en": "After subscribing to streaming data, the schema must be returned first."

package/index.d.ts

@@ -162,8 +162,7 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     to_rows<T extends Record<string, any> = Record<string, any>>(): T[];
     /** 将 dict<string, any> 自动转换为 js object (Record<string, any>)  Automatically convert dict<string, any> to js object (Record<string, any>)
         - options?:
-            - strip?: `false` 是否将 DdbObj 中的 value 直接提取、剥离出来作为 js object 的 value (丢弃 DdbObj 中的其余信息，只保留 value)
-                Whether to directly extract and strip the value in DdbObj as the value of js object (discard the rest of the information in DdbObj, only keep the value)
+            - strip?: `false` 是否将 dict<string, any> 中的 value 直接提取、剥离出来作为 js object 的 value (丢弃 DdbObj 中的其余信息，只保留 value)
             - deep?: `false` 是否递归转换
                 Whether to convert recursively
     */
@@ -177,13 +176,14 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     }): T;
 }
 export interface InspectOptions extends UtilInspectOptions {
+    /** `util.inspect.defaultOptions.colors` */
     colors?: boolean;
     /** `null` decimal places 小数位数 */
     decimals?: number;
     /** `true` 决定格式化后的数据是否有千分位 */
     grouping?: boolean;
 }
-/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串  Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
+/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串 */
 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;
@@ -401,6 +401,7 @@ export interface DdbOptions {
     sql?: SqlStandard;
     streaming?: StreamingParams;
     verbose?: boolean;
+    proxy?: string;
 }
 export declare class DDB {
     /** 当前的 session id (http 或 tcp) */
@@ -409,8 +410,7 @@ export declare class DDB {
     dec: TextDecoder;
     enc: TextEncoder;
     /** DolphinDB WebSocket URL
-        e.g. `ws://127.0.0.1:8848/`, `wss://dolphindb.com`
-    */
+        e.g. `ws://127.0.0.1:8848/`, `wss://dolphindb.com` */
     url: string;
     /** 为所有 websocket 操作加锁，包括设置 this.on_message, this.on_error, websocket.send */
     lwebsocket: Lock<WebSocket>;
@@ -432,6 +432,8 @@ export declare class DDB {
     streaming: StreamingParams;
     /** 是否打印每个 rpc 的信息用于调试 */
     verbose: boolean;
+    /** websocket 连接所使用的 http 代理 */
+    proxy: string;
     print_message_buffer: boolean;
     print_object_buffer: boolean;
     print_message: boolean;

package/index.js

@@ -9,14 +9,14 @@ import { t } from './i18n/index.js';
 import { DdbDecimal128Serializor } from './data-types/decimal-128.js';
 import { BigInt128Array } from './shared/bigint-128-array.js';
 import { is_decimal_type, is_decimal_null_value, get_duration_unit } from './shared/utils.js';
-import { nulls, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType } from './shared/constants.js';
+import { nulls, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables } from './shared/constants.js';
 export * from './shared/constants.js';
 // Simulate other TypedArray behavior in nodejs
 BigInt128Array.prototype[inspect.custom] = function () {
     const values = [];
     for (const value of this)
         values.push(value);
-    const value_str = values.length ? ` ${values.map(v => v.toString() + 'n').join(', ')} ` : '';
+    const value_str = values.length ? ` ${values.map(v => String(v) + 'n').join(', ')} ` : '';
     return `${this[Symbol.toStringTag]}(${this.length}) [${value_str}]`;
 };
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
@@ -127,6 +127,8 @@ export class DdbObj {
                 let i_start = i_items_start + len_items;
                 for (let i = 0; i < cols; i++) {
                     const type = buf_data[i_start];
+                    if (type === DdbType.compress)
+                        throw new Error(t('{{form}}<{{type}}> 暂时不支持解析', { form: 'table', type: 'compress' }));
                     let col = this.parse_vector(buf_data.subarray(i_start + 2), le, type);
                     col.length += 2;
                     col.name = colnames[i];
@@ -708,8 +710,16 @@ export class DdbObj {
                     });
                 return [8 * length, durations];
             }
+            case DdbType.compress:
+                return [
+                    length,
+                    new Uint8Array(buf.buffer.slice(buf.byteOffset, buf.byteOffset + length))
+                ];
             default:
-                throw new Error(t('vector<{{type}}> 暂时不支持解析', { type: String(DdbType[type] || type) }));
+                throw new Error(t('{{form}}<{{type}}> 暂时不支持解析', {
+                    form: 'vector',
+                    type: String(DdbType[type] || type)
+                }));
         }
     }
     pack() {
@@ -940,6 +950,7 @@ export class DdbObj {
             case DdbType.uuid:
             case DdbType.ipaddr:
             case DdbType.int128:
+            case DdbType.compress:
                 return [value];
             case DdbType.blob: {
                 let bufs = new Array(length * 2);
@@ -1120,7 +1131,7 @@ export class DdbObj {
                             return format_array(items, data.length > limit);
                         }
                         default: {
-                            const limit = 50;
+                            const limit = this.type === DdbType.compress ? 5 : 50;
                             let items = new Array(Math.min(limit, this.value.length));
                             for (let i = 0; i < items.length; i++)
                                 items[i] = format(this.type, this.value[i], this.le, options);
@@ -1256,15 +1267,20 @@ export class DdbObj {
     to_dict({ strip, deep, } = {}) {
         assert(this.form === DdbForm.dict, t('this.form 必须是 DdbForm.dict, 否则不能调用 to_dict 转换为 js object'));
         const [{ value: keys, type: key_type }, { value: values, type: value_type }] = this.value;
-        assert(key_type === DdbType.string && value_type === DdbType.any, t('当前只支持自动转换 dict<string, any> 为 js object'));
+        assert(key_type === DdbType.string && dictables.has(value_type), t('当前只支持自动转换 dict<string, any | ...dictables> 为 js object'));
         assert(!(deep && !strip), t('deep = true 时必须设置 strip = true'));
         let obj = {};
         for (let i = 0; i < this.rows; i++) {
-            let value = values[i];
-            if (deep && value.form === DdbForm.dict)
-                obj[keys[i]] = value.to_dict({ strip, deep });
+            const key = keys[i];
+            if (value_type === DdbType.any) {
+                let value = values[i];
+                if (deep && value.form === DdbForm.dict)
+                    obj[key] = value.to_dict({ strip, deep });
+                else
+                    obj[key] = strip ? value.value : value;
+            }
             else
-                obj[keys[i]] = strip ? value.value : value;
+                obj[key] = values[i];
         }
         return obj;
     }
@@ -1277,7 +1293,7 @@ let _grouping = true;
 let _formatter = new Intl.NumberFormat('en-US', { maximumFractionDigits: 20 });
 /** 用来处理时差  To deal with jet lag */
 let _datetime_formatter = new Intl.DateTimeFormat('zh-CN', { dateStyle: 'short', timeStyle: 'medium', timeZone: 'UTC', hour12: false });
-/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串  Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
+/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串 */
 export function format(type, value, le, options = {}) {
     const formatter = (() => {
         const { grouping = true } = options;
@@ -2140,14 +2156,8 @@ export class DDB {
     /** utf-8 text decoder */
     dec = new TextDecoder('utf-8');
     enc = new TextEncoder();
-    // port = 8848
-    // /** ddb 连接状态 */
-    // state = '未连接'
-    // socket = null as Socket
-    // clients = new Set<Duplex>()
     /** DolphinDB WebSocket URL
-        e.g. `ws://127.0.0.1:8848/`, `wss://dolphindb.com`
-    */
+        e.g. `ws://127.0.0.1:8848/`, `wss://dolphindb.com` */
     url;
     /** 为所有 websocket 操作加锁，包括设置 this.on_message, this.on_error, websocket.send */
     lwebsocket = new Lock();
@@ -2169,6 +2179,8 @@ export class DDB {
     streaming = null;
     /** 是否打印每个 rpc 的信息用于调试 */
     verbose = false;
+    /** websocket 连接所使用的 http 代理 */
+    proxy;
     // --- 内部选项, 状态
     print_message_buffer = false;
     print_object_buffer = false;
@@ -2227,6 +2239,8 @@ export class DDB {
             this.sql = options.sql;
         if (options.streaming !== undefined)
             this.streaming = options.streaming;
+        if (options.proxy)
+            this.proxy = options.proxy;
     }
     on_message(buffer, websocket) {
         throw new Error(t('这是在调用 this.rpc 之前默认的 on_message, 不应该被调用到，除非建立连接后 server 先推送了 message'));
@@ -2268,6 +2282,7 @@ export class DDB {
                 // 连接建立之前应该不会有别的调用占用 this.lwebsocket
                 this.lwebsocket.resource = await connect_websocket(url, {
                     protocols: this.streaming ? ['streaming'] : this.python ? ['python'] : undefined,
+                    proxy: this.proxy,
                     on_message: (buffer, websocket) => {
                         this.on_message(new Uint8Array(buffer), websocket);
                     },
@@ -2729,157 +2744,4 @@ export class DDB {
         colnames);
     }
 }
-// const ddb_gateway = {
-//         server: null as SocketServer,
-//         clients: new Set<Socket>(),
-//         port: 8849,
-//         controllers: {
-//             /** alias */
-//             c0: {
-//                 hostname: '127.0.0.1',
-//                 port: 8850,
-//             },
-//             c1: {
-//                 hostname: '127.0.0.1',
-//                 port: 8851,
-//             },
-//             c2: {
-//                 hostname: '127.0.0.1',
-//                 port: 8852,
-//             }
-//         },
-//         master: '',
-//         sids: new Map<string, string>(),
-//         state: 'init',
-//         async start () {
-//             for (const alias in this.controllers) {
-//                 this.master = alias
-//                 break
-//             }
-//             this.server = create_socket_server(
-//                 {
-//                     allowHalfOpen: false,
-//                     pauseOnConnect: false,
-//                 },
-//                 this.accept.bind(this)
-//             )
-//             this.server.on('error', error => {
-//                 console.log(new Date(), 'gateway 出错:', error)
-//             })
-//             await new Promise<void>(resolve => {
-//                 this.server.listen(this.port, resolve)
-//             })
-//             this.auto_switch_master()
-//             console.log(new Date(), 'gateway 成功启动')
-//         },
-//         async stop () {
-//             this.state = 'stopping'
-//             console.log(new Date(), '正在停止 auto_switch_master')
-//             for (const client of this.clients)
-//                 client.end()
-//             await new Promise<void>((resolve, reject) => {
-//                 this.server.close(error => {
-//                     if (error) {
-//                         reject(error)
-//                         return
-//                     }
-//                     resolve()
-//                 })
-//             })
-//         },
-//         /** 接收到 client tcp 连接 */
-//         async accept (client: Socket) {
-//             this.clients.add(client)
-//             const port = client.remotePort
-//             // --- 
-//             console.log(port, new Date(), 'gateway accept client 连接，开始建立管道')
-//             let controller = new Socket({
-//                 allowHalfOpen: false,
-//                 readable: true,
-//                 writable: true,
-//             })
-//             controller.on('lookup', (error, address, family, host) => {
-//                 console.log(port, new Date(), 'controller 域名解析 (lookup) 完成', error, address, family, host)
-//             })
-//             controller.on('close', has_error => {
-//                 console.log(port, new Date(), 'controller 关闭连接，是否出错:', has_error)
-//             })
-//             controller.on('timeout', () => {
-//                 console.log(port, new Date(), 'controller 超时')
-//             })
-//             controller.on('error', error => {
-//                 console.log(port, new Date(), 'controller 出错了:', error)
-//                 client.end()
-//             })
-//             // --- client 错误处理
-//             client.on('error', error => {
-//                 console.log(port, new Date(), 'client 出错，关闭与 controller 的连接', error)
-//                 controller.end()
-//             })
-//             client.on('close', has_error => {
-//                 this.clients.delete(client)
-//                 console.log(port, new Date(), 'client 关闭连接，是否出错:', has_error)
-//             })
-//             // --- 
-//             console.log(port, new Date(), 'gateway 开始连接到 controller')
-//             const { hostname, port: master_port } = this.controllers[this.master]
-//             await new Promise<void>(resolve => {
-//                 // callback 会被 socket.once('connect', callback)
-//                 controller.connect({
-//                     port: master_port,
-//                     host: hostname,
-//                     // host: '127.0.0.1',
-//                     family: 0,
-//                 }, resolve)
-//             })
-//             console.log(port, new Date(), 'gateway 已连接到 controller')
-//             // --- 
-//             console.log(port, new Date(), 'gateway 建立 client <-> controller')
-//             client.pipe(controller)
-//             controller.pipe(client)
-//         },
-//         /** https://www.dolphindb.cn/cn/help/FunctionsandCommands/FunctionReferences/g/getActiveMaster.html?highlight=getactivemaster */
-//         async get_active_master () {
-//             for (const alias in this.controllers) {
-//                 const { hostname, port } = this.controllers[alias] as { hostname: string, port: number }
-//                 const sid = this.sids.get(alias)
-//                 try {
-//                     const master = (
-//                         await ddb.rpc_json('getActiveMaster()', { hostname, port, sid })
-//                     ).value as string
-//                     console.log(new Date(), `${alias}.getActiveMaster() -> ${this.master}`)
-//                     this.sids.set(alias, sid)
-//                     if (!master)
-//                         throw new Error(`${new Date().toString()} getActiveMaster 得到的 master 为空`)
-//                     return master
-//                 } catch (error) {
-//                     console.log(new Date(), error)
-//                 }
-//             }
-//             return this.master
-//         },
-//         async auto_switch_master () {
-//             if (this.state === 'stopping') {
-//                 this.state = 'running'
-//                 console.log('gateway 恢复 auto_switch_master')
-//                 return
-//             }
-//             this.state = 'running'
-//             for (;  this.state === 'running';  ) {
-//                 const master = this.master
-//                 const master_ = await this.get_active_master()
-//                 if (master === master_) {
-//                     await delay(10 * 1000)
-//                     continue
-//                 }
-//                 this.master = master_
-//                 console.log(new Date(), `master 从 ${master} 切换为 ${master_}, 断开所有 clients`)
-//                 for (const client of this.clients)
-//                     client.end()
-//                 await delay(3 * 1000)
-//             }
-//             console.log(new Date(), `gateway.state === ${this.state}, 停止 auto_switch_master`)
-//             this.state = 'stopped'
-//     }
-// }
 //# sourceMappingURL=index.js.map