dolphindb 3.0.224 → 3.0.227

package/index.js

@@ -1,142 +1,7 @@
-import { default as dayjs } from 'dayjs';
-import DayjsCustomParseFormat from 'dayjs/plugin/customParseFormat.js';
-dayjs.extend(DayjsCustomParseFormat);
-import ipaddrjs from 'ipaddr.js';
-const { fromByteArray: buf2ipaddr } = ipaddrjs;
 import { concat, assert, inspect, typed_array_to_buffer, connect_websocket, Lock, genid, seq, zip_object, WebSocketOpen, WebSocketClosed, WebSocketClosing, decode, delay, check } from 'xshell';
 import { t } from "./i18n/index.js";
-export const nulls = {
-    int8: -0x80, // -128
-    int16: -0x80_00, // -32768
-    int32: -0x80_00_00_00, // -21_4748_3648
-    int64: -0x8000000000000000n, // -922_3372_0368_5477_5808
-    int128: -0x80000000000000000000000000000000n, // -170_1411_8346_0469_2317_3168_7303_7158_8410_5728
-    float32: -3.4028234663852886e+38,
-    /** -Number.MAX_VALUE */
-    double: -Number.MAX_VALUE,
-    bytes16: Uint8Array.from(new Array(16).fill(0))
-};
-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";
-    /** 节点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型 */
-    DdbForm[DdbForm["chunk"] = 8] = "chunk";
-    /** sysobj */
-    DdbForm[DdbForm["object"] = 9] = "object";
-    DdbForm[DdbForm["tensor"] = 10] = "tensor";
-})(DdbForm || (DdbForm = {}));
-/** DolphinDB DataType
-    对应的 array vector 类型为 64 + 基本类型
-    对应的 extended 类型为 128 + 基本类型 */
-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["compressed"] = 26] = "compressed";
-    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["iotany"] = 41] = "iotany";
-    DdbType[DdbType["symbol_extended"] = 145] = "symbol_extended";
-})(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 = {}));
-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 = {}));
-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 = {}));
-// server 实现中区分了 0: NULL (nothing), 1: NULL (null), 2: DFLT (default)
-// Void::serialize()
-//     (isNothing() ? 0 : 1) + (isDefault_ ? 2 : 0);
-export var DdbVoidType;
-(function (DdbVoidType) {
-    DdbVoidType[DdbVoidType["undefined"] = 0] = "undefined";
-    DdbVoidType[DdbVoidType["null"] = 1] = "null";
-    DdbVoidType[DdbVoidType["default"] = 2] = "default";
-})(DdbVoidType || (DdbVoidType = {}));
-export const dictables = new Set([DdbType.any, DdbType.string, DdbType.double, DdbType.float, DdbType.int, DdbType.long]);
-/** 工具，取得某个 DdbType 的字节数 */
-export const ddb_tensor_bytes = {
-    [DdbType.bool]: 1,
-    [DdbType.char]: 1,
-    [DdbType.short]: 2,
-    [DdbType.int]: 4,
-    [DdbType.long]: 8,
-    [DdbType.float]: 4,
-    [DdbType.double]: 8,
-};
+import { date2str, datehour2str, datetime2str, ddb_tensor_bytes, DdbChartType, DdbDurationUnit, DdbForm, DdbFunctionType, DdbType, DdbVoidType, dictables, 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";
+export * from "./common.js";
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
     static dec = new TextDecoder('utf-8');
@@ -1662,33 +1527,12 @@ export class DdbObj {
         return obj;
     }
 }
-/** 根据 DdbType 获取其名称，array vector type 自动在后面加上 [] */
-export function get_type_name(type) {
-    return `${DdbType[type] || type}${64 <= type && type < 128 ? '[]' : ''}`;
-}
-export function is_decimal_type(type) {
-    return type === DdbType.decimal32 || type === DdbType.decimal64 || type === DdbType.decimal128;
-}
-export function is_decimal_null_value(type, value) {
-    return ((value === nulls.int128 && type === DdbType.decimal128) ||
-        (value === nulls.int64 && type === DdbType.decimal64) ||
-        (value === nulls.int32 && type === DdbType.decimal32));
-}
-export function get_duration_unit(code) {
-    let str = String.fromCharCode((code >> 24) & 0xff);
-    str += String.fromCharCode((code >> 16) & 0xff);
-    str += String.fromCharCode((code >> 8) & 0xff);
-    str += String.fromCharCode(code & 0xff);
-    return str;
-}
 /** 整数一定用这个 number formatter, InspectOptions.decimals 不传也用这个 */
 let default_formatter = new Intl.NumberFormat('en-US', { maximumFractionDigits: 20 });
 let _decimals = 20;
 let _grouping = true;
 /** 缓存，为了优化性能，通常 options.decimals 都是不变的 */
 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' 字符串 */
 export function format(type, value, le, options = {}) {
     const { grouping = true, timestamp = 'ms' } = options;
@@ -2232,33 +2076,6 @@ export class DdbDate extends DdbObj {
         });
     }
 }
-function get_ddb_time_value(classname, value) {
-    if (value === null)
-        return null;
-    if (classname === 'DdbNanoTimeStamp' && typeof value === 'string')
-        return str2nanotimestamp(value);
-    let date;
-    if (value === undefined)
-        date = new Date();
-    else if (typeof value === 'number' || typeof value === 'string')
-        date = new Date(value);
-    else if (value instanceof Date)
-        date = value;
-    else if (dayjs.isDayjs(value))
-        date = new Date(value.valueOf());
-    else
-        throw new Error(t('value 不能转换为 {{classname}}', { classname }));
-    switch (classname) {
-        case 'DdbDateTime':
-            return (date.getTime() - 1000 * 60 * date.getTimezoneOffset()) / 1000;
-        case 'DdbTimeStamp':
-            return BigInt(date.getTime() - 1000 * 60 * date.getTimezoneOffset());
-        case 'DdbNanoTimeStamp':
-            return BigInt(date.getTime() - 1000 * 60 * date.getTimezoneOffset()) * 1000000n;
-        case 'DdbDate':
-            return Math.floor((date.getTime() - 1000 * 60 * date.getTimezoneOffset()) / (1000 * 3600 * 24));
-    }
-}
 export class DdbBlob extends DdbObj {
     constructor(value) {
         assert(value, t('new DdbBlob 不能传空的 value'));
@@ -2514,230 +2331,6 @@ export class DdbTable extends DdbObj {
         });
     }
 }
-export function date2ms(date) {
-    // 将 server 的本地时间 (以 ms 为单位，1970.01.01 00:00:00 作为零点) 作为 UTC-0 格式化为字符串，然后根据本地的时区解析这个字符串转换为 UTC-8
-    // 本地的时区与实际的时间值相关，getTimezoneOffset() 可能会受到夏令时 (DST) 的影响，不能使用
-    // 得到的 utc 毫秒数交给 js date 或者 dayjs 去格式化
-    if (date === null || date === nulls.int32)
-        return null;
-    const ms = 1000 * 3600 * 24 * date;
-    return timestamp2ms(ms);
-}
-export function date2str(date, format = 'YYYY.MM.DD') {
-    return (date === null || date === nulls.int32) ?
-        'null'
-        :
-            dayjs(date2ms(date)).format(format);
-}
-export function month2ms(month) {
-    return (month === null || month === nulls.int32) ?
-        null
-        :
-            dayjs(month2str(month), 'YYYY.MM[M]').valueOf();
-}
-export function month2str(month) {
-    if (month === null || month === nulls.int32)
-        return 'null';
-    if (month < 0)
-        return String(month);
-    const _month = month % 12;
-    const year = Math.trunc(month / 12);
-    return `${String(year).padStart(4, '0')}.${String(_month + 1).padStart(2, '0')}M`;
-}
-export function time2ms(time) {
-    return (time === null || time === nulls.int32) ?
-        null
-        :
-            timestamp2ms(time);
-}
-export function time2str(time, format = 'HH:mm:ss.SSS') {
-    return (time === null || time === nulls.int32) ?
-        'null'
-        :
-            dayjs(time2ms(time)).format(format);
-}
-export function minute2ms(minute) {
-    if (minute === null || minute === nulls.int32)
-        return null;
-    const ms = 60 * 1000 * minute;
-    return timestamp2ms(ms);
-}
-export function minute2str(minute, format = 'HH:mm[m]') {
-    return (minute === null || minute === nulls.int32) ?
-        'null'
-        :
-            dayjs(minute2ms(minute)).format(format);
-}
-export function second2ms(second) {
-    if (second === null || second === nulls.int32)
-        return null;
-    const ms = 1000 * second;
-    return timestamp2ms(ms);
-}
-export function second2str(second, format = 'HH:mm:ss') {
-    return (second === null || second === nulls.int32) ?
-        'null'
-        :
-            dayjs(second2ms(second)).format(format);
-}
-export function datetime2ms(datetime) {
-    if (datetime === null || datetime === nulls.int32)
-        return null;
-    const date = new Date(1000 * datetime);
-    return new Date(`${_datetime_formatter.format(date)}.${String(date.getUTCMilliseconds()).padStart(3, '0')}`).valueOf();
-}
-export function datetime2str(datetime, format = 'YYYY.MM.DD HH:mm:ss') {
-    return (datetime === null || datetime === nulls.int32) ?
-        'null'
-        :
-            dayjs(datetime2ms(datetime)).format(format);
-}
-/** _datetime_formatter.format 会在 date 为 Invalid Date 时抛出错误 */
-export function timestamp2ms(timestamp) {
-    if (timestamp === null || timestamp === nulls.int64)
-        return null;
-    const date = new Date(Number(timestamp));
-    return new Date(`${_datetime_formatter.format(date)}.${String(date.getUTCMilliseconds()).padStart(3, '0')}`).valueOf();
-}
-/** format timestamp (bigint) to string
-    - timestamp: bigint value
-    - format?:
-        格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`  format string, default to `YYYY.MM.DD HH:mm:ss.SSS`
-        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens */
-export function timestamp2str(timestamp, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
-    return (timestamp === null || timestamp === nulls.int64) ?
-        'null'
-        :
-            dayjs(timestamp2ms(timestamp)).format(format);
-}
-export function datehour2ms(datehour) {
-    if (datehour === null || datehour === nulls.int32)
-        return null;
-    const ms = 1000 * 3600 * datehour;
-    return timestamp2ms(ms);
-}
-export function datehour2str(datehour, format = 'YYYY.MM.DDTHH') {
-    if (datehour === null || datehour === nulls.int32)
-        return 'null';
-    const ms = 1000 * 3600 * datehour;
-    return dayjs(timestamp2ms(ms)).format(format);
-}
-/** parse timestamp string to bigint value
-    - str: timestamp string, 如果为空字符串或 'null' 会返回对应的空值 (nulls.int64)
-        timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
-    - format?:
-        对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`
-        The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSS`
-        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens */
-export function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
-    if (!str || str === 'null')
-        return nulls.int64;
-    assert(str.length === format.length, t('timestamp 字符串长度必须等于格式串长度'));
-    const ms = dayjs(str, format).valueOf();
-    return BigInt(-(1000 * 60 * new Date(ms).getTimezoneOffset()) +
-        ms);
-}
-export function nanotime2ns(nanotime) {
-    return nanotimestamp2ns(nanotime);
-}
-export function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
-    if (nanotime === null || nanotime === nulls.int64)
-        return 'null';
-    if (nanotime < 0n)
-        return String(nanotime);
-    const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
-    const i_second_end = i_second_start + 2;
-    const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
-    const ms = Number(nanotime) / 1000000;
-    return (dayjs(timestamp2ms(ms)).format(format.slice(0, i_second_end)) +
-        format.slice(i_second_end, i_nanosecond_start) +
-        String(nanotime % 1000000000n).padStart(9, '0'));
-}
-export function nanotimestamp2ns(nanotimestamp) {
-    if (nanotimestamp === null || nanotimestamp === nulls.int64)
-        return null;
-    const date = new Date(Number(nanotimestamp / 1000000n));
-    return BigInt(new Date(`${_datetime_formatter.format(date)}.${String(date.getUTCMilliseconds()).padStart(3, '0')}`).valueOf()) * 1000000n + nanotimestamp % 1000000n;
-}
-/** format nanotimestamp value (bigint) to string
-    - nanotimestamp: bigint value
-    - format?:
-        格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`  format string, default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
-        秒的格式为 ss (必须包含); 纳秒的格式为 SSSSSSSSS (必须包含)  Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
-        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
-*/
-export function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
-    // tests:
-    // nanotimestamp2str(0n)
-    // nanotimestamp2str(-1n)
-    // nanotimestamp2str(-9_9999_9999n)
-    // nanotimestamp2str(-10_0000_0000n)
-    // nanotimestamp2str(-10_0000_0001n)
-    if (nanotimestamp === null || nanotimestamp === nulls.int64)
-        return 'null';
-    const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
-    const i_second_end = i_second_start + 2;
-    const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
-    const remainder = nanotimestamp % 1000000000n;
-    const borrow = remainder < 0n;
-    const ms = Number((nanotimestamp - remainder + (borrow ? -1000000000n : 0n)) / 1000000n);
-    return (dayjs(_datetime_formatter.format(new Date(ms))).format(format.slice(0, i_second_end)) +
-        format.slice(i_second_end, i_nanosecond_start) +
-        String(borrow ?
-            (remainder + 1000000000n) % 1000000000n
-            :
-                remainder).padStart(9, '0'));
-}
-/** parse nano timestamp string to bigint value
-    - str: nano timestamp string, 如果为空字符串或 'null' 会返回对应的空值 (nulls.int64)
-        nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
-    - format?:
-        对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
-        秒的格式为 ss (必须包含); 纳秒的格式为 SSSSSSSSS (必须包含)
-        https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
-        The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
-        Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included) */
-export function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
-    if (!str || str === 'null')
-        return nulls.int64;
-    check(str.length === format.length, t('nanotimestamp 字符串长度必须等于格式串长度'));
-    const i_second_start = format.indexOf('ss');
-    check(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
-    const i_second_end = i_second_start + 2;
-    const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    check(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
-    const ms = dayjs(str.slice(0, i_second_end), format.slice(0, i_second_end)).valueOf();
-    return (BigInt(-(1000 * 60 * new Date(ms).getTimezoneOffset()) +
-        ms) * 1000000n
-        +
-            BigInt(str.slice(i_nanosecond_start, i_nanosecond_start + 9)));
-}
-export function ipaddr2str(buffer, le = true, ipv6) {
-    let buf = buffer;
-    if (le)
-        buf = buffer.slice().reverse();
-    const i_non_zero = buf.findIndex(x => x !== 0);
-    if (ipv6 ||
-        i_non_zero !== -1 && i_non_zero < 12) // ipv6
-        return buf2ipaddr([...buf]).toString();
-    else // ipv4
-        return buf.subarray(12).join('.');
-}
-export function uuid2str(buffer, le = true) {
-    const str = int1282str(buffer, le);
-    return `${str.slice(0, 8)}-${str.slice(8, 12)}-${str.slice(12, 16)}-${str.slice(16, 20)}-${str.slice(20)}`;
-}
-export function int1282str(buffer, le = true) {
-    let buf = buffer;
-    if (le)
-        buf = buffer.slice().reverse();
-    return [...buf].map(x => x.toString(16)
-        .padStart(2, '0')).join('');
-}
 export const winsize = 10000;
 export class DdbConnectionError extends Error {
     name = 'DdbConnectionError';
@@ -2826,6 +2419,10 @@ export class DDB {
     pinvoke;
     /** 首次定义 jsrpc 的 promise，保证并发调用 rpc 时只定义一次 jsrpc */
     pjsrpc;
+    /** 函数定义缓存 */
+    definitions = new Map();
+    /** 函数定义锁，保证并发调用时不重复定义，直接返回第一次定义的结果 */
+    pdefinitions = new Map();
     get connected() {
         return !this.error && this.lwebsocket.resource?.readyState === WebSocketOpen;
     }
@@ -2970,7 +2567,7 @@ export class DDB {
             }
         });
     }
-    get_rpc_options({ urgent = false, secondary = false, async: _async = false, pickle = false, clear = false, api = false, compress = false, cancellable = true, priority = urgent ? 8 : 4, parallelism = 8, root_id = '', limit, } = {}) {
+    get_rpc_options({ urgent = false, secondary = false, async: _async = false, pickle = false, clear = false, api = false, compress = false, cancellable = true, priority = urgent ? 8 : 4, parallelism = 64, root_id = '', limit, } = {}) {
         let flag = 0;
         if (urgent)
             flag += 1;
@@ -3083,7 +2680,7 @@ export class DDB {
                 throw error;
             }
         // this 上的当前配置需要在 message 到达后使用，先保存起来
-        const _listeners = [...this.listeners].reverse();
+        const _listeners = [...this.listeners];
         // rpc 请求期间需要独占 websocket，所以设计了一个锁，申请之后才能使用
         // ddb 世界观：需要等待上一个 rpc 结果从 server 返回之后才能发起下一个调用  
         // 违反世界观可能造成:  
@@ -3156,8 +2753,8 @@ export class DDB {
                                 console.log(typed_array_to_buffer(buffer));
                             const message = this.parse_message(buffer, error);
                             listener?.(message, this);
-                            for (const listener of _listeners)
-                                listener(message, this);
+                            for (let i = _listeners.length - 1; i >= 0; --i)
+                                _listeners[i](message, this);
                             const { type, data } = message;
                             switch (type) {
                                 case 'print':
@@ -3544,6 +3141,35 @@ export class DDB {
             }
         })).data());
     }
+    /** 定义函数并保存，避免下次重复执行定义，会自动提取脚本中的函数名，作为缓存 key，
+        也同时作为返回值
+        - definition: 函数完整定义
+        @example
+        await ddb.invoke(
+            await ddb.define(
+                'def foo (bar) {\n' +
+                '    print(bar)\n' +
+                '}\n'),
+            ['hello']) */
+    async define(definition) {
+        const matches = /\bdef (\w+)\s?\(/.exec(definition);
+        if (!matches)
+            throw new Error(t('DDB.define 方法传入的 definition 不符合函数定义格式'));
+        const func_name = matches[1];
+        // 已定义成功
+        if (this.definitions.has(func_name))
+            return func_name;
+        // 防止并发调用 define 时多次重复定义
+        let promise = this.pdefinitions.get(func_name);
+        if (!promise)
+            this.pdefinitions.set(func_name, promise = this.execute(definition));
+        await promise;
+        this.definitions.set(func_name, definition);
+        // 成功定义之后，definitions 中有了，就不需要通过 promise 来防止并发了，清理掉
+        // 定义失败时 rejected promise 直接作为后续调用的结果返回
+        this.pdefinitions.delete(func_name);
+        return func_name;
+    }
 }
 export class BigInt128Array {
     static of(...items) {
@@ -3700,55 +3326,4 @@ Object.defineProperty(BigInt128Array.prototype, Symbol.toStringTag, {
     enumerable: false,
     value: 'BigInt128Array',
 });
-// DataView Extends for bigint 128 operations
-function get_big_uint_128(dataview, byte_offset, le = true) {
-    let cursor = byte_offset + (le ? 15 : 0);
-    const end = byte_offset + (le ? -1 : 16);
-    const step = le ? -1 : 1;
-    let value = 0n;
-    while (cursor !== end) {
-        value = value << 8n | BigInt(dataview.getUint8(cursor));
-        cursor += step;
-    }
-    return value;
-}
-function get_big_int_128(dataview, byte_offset, le = true) {
-    return BigInt.asIntN(128, get_big_uint_128(dataview, byte_offset, le));
-}
-function set_big_uint_128(dataView, byte_offset, value, le = true) {
-    let cursor = byte_offset + (le ? 0 : 15);
-    const end = byte_offset + (le ? 16 : -1);
-    const step = le ? 1 : -1;
-    while (cursor !== end) {
-        dataView.setUint8(cursor, Number(value & 0xffn));
-        value = value >> 8n;
-        cursor += step;
-    }
-}
-function set_big_int_128(dataview, byte_offset, value, le = true) {
-    set_big_uint_128(dataview, byte_offset, value, le);
-}
-function generate_array_type(baseType, dimensions) {
-    let result = baseType;
-    dimensions.forEach(dimension => {
-        result += `[${dimension}]`;
-    });
-    return result;
-}
-// 大端
-// const dataBE = new ArrayBuffer(16)
-// const dataViewBE = new DataView(dataBE)
-// set_big_int_128(dataViewBE, 0, -34355n, false)
-// console.log(dataViewBE.buffer)
-// const bigInt128BE = get_big_int_128(dataViewBE, 0, false)
-// const bigUint128BE = get_big_uint_128(dataViewBE, 0, false)
-// console.log(bigInt128BE.toString(), bigUint128BE.toString())
-// 小端
-// const dataLE = new ArrayBuffer(16)
-// const dataViewLE = new DataView(dataLE)
-// set_big_int_128(dataViewLE, 0, -34355n, true)
-// console.log(dataViewLE.buffer)
-// const bigInt128LE = get_big_int_128(dataViewLE, 0, true)
-// const bigUint128LE = get_big_uint_128(dataViewLE, 0, true)
-// console.log(bigInt128LE.toString(), bigUint128LE.toString())
 //# sourceMappingURL=index.js.map