antprotocol-websdk 1.0.0

package/dist/protocol/BMSProtocol.d.ts

@@ -0,0 +1,5 @@
+import ProtocolBasic from './common/ProtocolBasic';
+export default class BMSProtocol extends ProtocolBasic {
+    getProtocolType(): DeviceType;
+}
+//# sourceMappingURL=BMSProtocol.d.ts.map

package/dist/protocol/BMSProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BMSProtocol.d.ts","sourceRoot":"","sources":["../../websdk/protocol/BMSProtocol.ts"],"names":[],"mappings":"AAAA,OAAQ,aAAa,MAAO,wBAAwB,CAAC;AACrD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,aAAa;IAC9C,eAAe,IAAI,UAAU;CAGpC"}

package/dist/protocol/ChargerProtocol.d.ts

@@ -0,0 +1,5 @@
+import ProtocolBasic from './common/ProtocolBasic';
+export default class ChargerProtocol extends ProtocolBasic {
+    getProtocolType(): DeviceType;
+}
+//# sourceMappingURL=ChargerProtocol.d.ts.map

package/dist/protocol/ChargerProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargerProtocol.d.ts","sourceRoot":"","sources":["../../websdk/protocol/ChargerProtocol.ts"],"names":[],"mappings":"AAAA,OAAQ,aAAa,MAAO,wBAAwB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,aAAa;IAC/C,eAAe,IAAI,UAAU;CAGvC"}

package/dist/protocol/DisplayerProtocol.d.ts

@@ -0,0 +1,5 @@
+import ProtocolBasic from './common/ProtocolBasic';
+export default class DisplayerProtocol extends ProtocolBasic {
+    getProtocolType(): DeviceType;
+}
+//# sourceMappingURL=DisplayerProtocol.d.ts.map

package/dist/protocol/DisplayerProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayerProtocol.d.ts","sourceRoot":"","sources":["../../websdk/protocol/DisplayerProtocol.ts"],"names":[],"mappings":"AAAA,OAAQ,aAAa,MAAO,wBAAwB,CAAC;AACrD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IACpD,eAAe,IAAI,UAAU;CAGpC"}

package/dist/protocol/PowerProtocol.d.ts

@@ -0,0 +1,5 @@
+import ProtocolBasic from './common/ProtocolBasic';
+export default class PowerProtocol extends ProtocolBasic {
+    getProtocolType(): DeviceType;
+}
+//# sourceMappingURL=PowerProtocol.d.ts.map

package/dist/protocol/PowerProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PowerProtocol.d.ts","sourceRoot":"","sources":["../../websdk/protocol/PowerProtocol.ts"],"names":[],"mappings":"AAAA,OAAQ,aAAa,MAAO,wBAAwB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,aAAa;IAC7C,eAAe,IAAI,UAAU;CAGvC"}

package/dist/protocol/common/ProtocolBasic.d.ts

@@ -0,0 +1,320 @@
+import type ProtocolInterface from "./ProtocolInterface";
+/**
+ * 协议核心实现抽象类
+ */
+export default abstract class ProtocolBasic implements ProtocolInterface {
+    /**
+     * 获取协议类型
+     */
+    abstract getProtocolType(): DeviceType;
+    /**
+     * 本地存储的协议数据
+     */
+    private static storeProtocols;
+    /**
+     * 从API实时获取协议文件
+     */
+    private getListForApi;
+    /**
+     * 对外提供下载下拉框渲染的数据
+     */
+    list(forceRefresh?: boolean | false): Promise<SelectProtocol[]>;
+    /**
+     * 刷新协议缓存
+     */
+    private refreshCache;
+    /**
+     * 从 indexedDB 中获取协议
+     * @param key
+     * @returns
+     */
+    private fetchLocalProtocol;
+    /**
+     * 检查协议的 md5 值是否匹配，不匹配则更新并保存
+     * @param apiProtocol
+     * @param localProtocol
+     * @param key
+     */
+    private updateProtocolIfNeeded;
+    /**
+     * 新增协议并存储到 storeProtocols 和本地缓存中
+     * @param apiProtocol
+     * @param key
+     */
+    private addNewProtocol;
+    /**
+     * 保存协议到本地存储
+     * @param key
+     * @param protocol
+     */
+    private saveProtocol;
+    /**
+     * 用于被渲染的Select数据
+     */
+    private getSelectList;
+    /**
+     * 通过 apiProtocol 对象获取 StoreProtocol。方法实现了协议下载的核心功能
+     */
+    private getStoreProtocol;
+    /**
+     * 从 indexedDB 中获取协议数据
+     */
+    private getProtocolFromIndexedDB;
+    /**
+     * 将协议数据保存到 indexedDB
+     */
+    private saveProtocolToIndexedDB;
+    /**
+     * 清空缓存中的协议数据
+     */
+    static cleanStore(): void;
+    /**
+     * 构建下发指令
+     */
+    buildCommand(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string, ...input: string[]): BuildSendResult;
+    /**
+     * 将存储的协议类型转换为标准的DeviceType类型
+     * @param type 存储的协议类型字符串
+     * @returns 标准的DeviceType类型
+     */
+    static getStandardDeviceType(type: string | undefined): DeviceType | undefined;
+    /**
+     * 获取下发的指令定义
+     * @param protocolMD5
+     * @param versionNum
+     * @param packetConfigType
+     * @param fun
+     * @param code
+     * @returns
+     */
+    getCommandDefine(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string): CommandDetail | undefined;
+    /**
+     * 简单构建指令
+     * @param prefix 协议前缀
+     * @param suffix 协议后缀
+     * @param funCode 功能码
+     * @param registCode 寄存器码
+     * @param payload 荷载
+     * @param needCrc 是否需要CRC校验。默认true
+     * @returns 构建好的指令
+     */
+    simpleBuildCommand(prefix: string, suffix: string, funCode: string, registCode: string, payload: string, needCrc?: boolean): string;
+    /**
+     * 构建下发指令
+     */
+    buildCommandForHex(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string, ...hexInput: string[]): BuildSendResult;
+    /**
+     * 根据数据类型推断荷载是否需要高地位互换
+     * @param dataType
+     * @returns
+     */
+    private static highLowTransition;
+    /**
+     * 应用自定义通讯地址到前缀
+     * @param prefix 原始前缀
+     * @returns 应用自定义通讯地址后的前缀
+     */
+    private static applyCustomCommunicationAddress;
+    /**
+     * 构建批量读指令
+     */
+    buildBulkReadCommand(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, code: string, ...input: string[]): BuildSendResult;
+    /**
+     * 根据输入的字符串数组填充帧头、荷载、帧尾
+     * @param childProtocol
+     * @param protocolPayload 协议中的原始荷载Hex。可能包含占位符
+     * @param input
+     * @returns
+     */
+    private placeholdersHandel;
+    private packageCommand;
+    /**
+     * 指令填充。将带有占位符的指令填充成为完整的指令
+     * @param command
+     * @param input
+     * @param dataType
+     * @param highLowTransition
+     * @param range 倍数
+     * @returns
+     */
+    private static fillPlaceholder;
+    /**
+     * 构建批量指令Hex包
+     * @param prefix
+     * @param data
+     * @param useCrc
+     * @param suffix
+     * @returns
+     */
+    private packageBulkReadCommand;
+    /**
+     * 获取子协议
+     * @param md5
+     * @param versionNum
+     * @param packetConfigType
+     * @returns
+     */
+    get(md5: string, versionNum: string, packetConfigType: PacketConfigType): ChildProtocol | undefined;
+    /**
+     * 获取制定类型的协议包配置.主要用于获取CRC校验方式
+     * @param md5
+     * @param packetConfigType
+     * @returns
+     */
+    static getPacketConfig(md5: string, packetConfigType: PacketConfigType): PacketConfig | undefined;
+    /**
+     * 根据协议code和子协议版本获取子协议
+     * @param code 协议code
+     * @param versionNum 子版本号
+     * @param packetConfigType 包配置类型
+     * @returns
+     */
+    static findProtocolByCode(code: string, versionNum: string, packetConfigType: PacketConfigType): ChildProtocol | undefined;
+    /**
+     * 根据协议md5和子协议版本获取子协议
+     * @param md5 协议md5
+     * @param versionNum 子版本号
+     * @param packetConfigType 包配置类型
+     * @returns
+     */
+    static findProtocolByMD5(md5: string, versionNum: string, packetConfigType: PacketConfigType): ChildProtocol | undefined;
+    /**
+     * 根据协议md5获取主协议
+     * @param md5 协议md5
+     * @returns 主协议
+     */
+    static getMainProtocol(md5: string): MainProtocol | undefined;
+    /**
+     * 根据md5/code和子版本号查找协议
+     */
+    private static findProtocol;
+    /**
+     * 根据命令code在协议中查找批量读下发指令
+     * @param code
+     * @param protocol
+     * @returns
+     */
+    private static findBulkReadCommandDetail;
+    /**
+     * 根据功能码和命令code在协议中查找下发指令
+     * @param func 功能码
+     * @param code 英文编码
+     * @param protocol
+     * @returns
+     */
+    private static findCommandDetail;
+    /**
+     * 解析上报的Hex报文<br>
+     * 注意如果解析失败Data中包含的将是Hex报文。解析失败时success是false<br>
+     * 优先使用传入的packetConfigType进行解析，如果失败则尝试其他PacketConfigType类型
+     * @param protocolMD5 主协议MD5
+     * @param versionNum 子协议版本
+     * @param packetConfigType 包配置类型（优先使用此配置，若解析失败会尝试使用其他配置）
+     * @param hex Hex字符串原文
+     * @returns
+     */
+    analyzePackage(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, hex: string): AnalyzeSendResult;
+    /**
+     * 根据主协议Code获取并解析下发的Hex报文<br>
+     * 注意如果解析失败Data中包含的将是Hex报文。解析失败时success是false<br>
+     * 优先使用传入的packetConfigType进行解析，如果失败则尝试其他PacketConfigType类型
+     * @param protocolCode 协议code
+     * @param versionNum
+     * @param packetConfigType 包配置类型（优先使用此配置，若解析失败会尝试使用其他配置）
+     * @param hex
+     * @returns
+     */
+    analyzePackageByCode(protocolCode: string, versionNum: string, packetConfigType: PacketConfigType, hex: string): AnalyzeSendResult;
+    /**
+     * 智能解析Hex报文，支持PacketConfigType回退机制<br>
+     * 优先使用传入的packetConfigType进行解析，如果失败则尝试其他PacketConfigType类型
+     * @param protocolMD5 主协议MD5
+     * @param protocolCode 协议code
+     * @param versionNum 子协议版本
+     * @param packetConfigType 包配置类型（优先使用此配置，若解析失败会尝试使用其他配置）
+     * @param hex Hex字符串原文
+     * @returns AnalyzeSendResult
+     */
+    private analyzePackageWithFallback;
+    /**
+     * 解析上报的Hex报文<br>
+     * 注意如果解析失败Data中包含的将是Hex报文。解析失败时success是false
+     * @param protocolMD5 主协议MD5
+     * @param protocolCode 协议code
+     * @param versionNum 子协议版本
+     * @param packetConfigType 包配置类型
+     * @param hex Hex字符串原文
+     */
+    analyzePackageReal(protocolMD5: string | undefined, protocolCode: string | undefined, versionNum: string, packetConfigType: PacketConfigType, hex: string): AnalyzeSendResult;
+    /**
+     * 根据功能码找到上报协议定义
+     * @param func 功能码
+     * @param protocol
+     * @returns
+     */
+    private static findReportDefine;
+    /**
+     * 根据寄存器地址查找寄存器解释定义
+     * @param registCode
+     * @param reportValue
+     * @returns
+     */
+    private static findReportRegistValue;
+    /**
+     * 拿到批量度指令的后续所有指令
+     * @param currentRegister
+     * @param registers
+     * @returns
+     */
+    private static findReportRegistValuesBySort;
+    /**
+     * 解析单个包
+     * @param packet
+     * @param protocol
+     */
+    private static AnalyzeHexPackage;
+    private static hexToSignedInt;
+    private static signedIntToHex;
+    private static hexToSignedInt8;
+    private static signedIntToHex8;
+    /**
+     * 数据转换
+     * @param hexStr 原文
+     * @param type HEX原始数据类型
+     * @param range 倍数
+     * @returns
+     */
+    private static convertHexToString;
+    /**
+     * 基础拆包方法。根据帧头和帧尾拆包。
+     * @param prefix 帧头。若为空字符串，则不校验帧头。
+     * @param suffix 帧尾。若为空字符串，则不校验帧尾。
+     * @param hexString 原文
+     * @returns   拆包后的数组
+     */
+    simpleUpPackage(prefix: string, suffix: string, hexString: string): HexPackage[];
+    /**
+     * 数据拆包。把Hex报文拆包成HexPackage[]数组
+     * @param protocol
+     * @param hexString
+     * @returns
+     */
+    private unPackage;
+    ackCheck(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, ackFunc: string, hex: string, registCode?: string): boolean;
+    ackCheckForData(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, ackFunc: string, hex: string, dataHex: string): boolean;
+    /**
+     * 把十进制数字转换成16进制
+     * @param decimal
+     * @param minLength
+     * @param uppercase
+     * @returns
+     */
+    private decimalToHexString;
+    /**
+     * 根据 customCode 获取对应的分析器实例（优化版）
+     * @param code 自定义分析代码（如 "11", "13", "14" 等）
+     * @returns 分析器实例，如果未找到返回 null
+     */
+    private static getCustomAnalyzer;
+}
+//# sourceMappingURL=ProtocolBasic.d.ts.map

package/dist/protocol/common/ProtocolBasic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolBasic.d.ts","sourceRoot":"","sources":["../../../websdk/protocol/common/ProtocolBasic.ts"],"names":[],"mappings":"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"}

package/dist/protocol/common/ProtocolInterface.d.ts

@@ -0,0 +1,91 @@
+export default interface ProtocolInterface {
+    /**
+     * 获取协议列表
+     * @param forceRefresh
+     */
+    list(forceRefresh: boolean): Promise<SelectProtocol[]>;
+    /**
+     * 获取协议体
+     * @param protocolMD5
+     * @param versionNum
+     */
+    get(md5: string, versionNum: string, packetConfigType: PacketConfigType): ChildProtocol | undefined;
+    /**
+     * 构建批量读指令
+     */
+    buildBulkReadCommand(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, code: string, ...input: string[]): BuildSendResult;
+    /**
+     * 构建下发指令
+     */
+    buildCommand(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string, ...input: string[]): BuildSendResult;
+    /**
+     * 根据hex内容结合包配置进行指令构件
+     */
+    buildCommandForHex(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string, ...hexInput: string[]): BuildSendResult;
+    /**
+     * 简单构建指令
+     * @param prefix 协议前缀
+     * @param suffix 协议后缀
+     * @param funCode 功能码
+     * @param registCode 寄存器码
+     * @param payload 荷载
+     * @param needCrc 是否需要CRC校验。默认true
+     * @returns 构建好的指令
+     */
+    simpleBuildCommand(prefix: string, suffix: string, funCode: string, registCode: string, payload: string, needCrc?: boolean): string;
+    /**
+     * 简单拆包方法。根据帧头和帧尾拆包。
+     * @param prefix 帧头。若为空字符串，则不校验帧头。
+     * @param suffix 帧尾。若为空字符串，则不校验帧尾。
+     * @param hexString 原文
+     * @returns   拆包后的数组
+     */
+    simpleUpPackage(prefix: string, suffix: string, hexString: string): HexPackage[];
+    /**
+     * 获取下发的指令定义
+     * @param protocolMD5
+     * @param versionNum
+     * @param packetConfigType
+     * @param fun
+     * @param code
+     */
+    getCommandDefine(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, fun: string, code: string): CommandDetail | undefined;
+    /**
+     * 解析上报的Hex报文<br>
+     * 注意如果解析失败Data中包含的将是Hex报文。解析失败时success是false
+     * @param protocolMD5 主协议MD5
+     * @param versionNum 子协议版本
+     * @param hex Hex字符串原文
+     */
+    analyzePackage(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, hex: string): AnalyzeSendResult;
+    /**
+     * 根据协议码解析上报的Hex报文
+     * @param protocolCode 协议码
+     * @param versionNum 版本号
+     * @param packetConfigType 包配置类型（用于解析不同报文的帧头和帧尾，配置后优先使用配置，若解析失败会尝试使用其他配置）
+     * @param hex Hex字符串原文
+     * @returns 解析后的结果字符串
+     */
+    analyzePackageByCode(protocolCode: string, versionNum: string, packetConfigType: PacketConfigType, hex: string): AnalyzeSendResult;
+    /**
+     * 校验Hex报文的功能码和ackFunc是否一致
+     * @param protocolMD5
+     * @param versionNum
+     * @param packetConfigType
+     * @param ackFunc 校验功能码
+     * @param hex
+     * @param registCode 校验寄存器地址（可选）
+     */
+    ackCheck(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, ackFunc: string, hex: string, registCode?: string): boolean;
+    /**
+     * 根据数据内容和ackFunc校验Hex报文
+     * @param protocolMD5
+     * @param versionNum
+     * @param packetConfigType
+     * @param ackFunc
+     * @param hex
+     * @param dataHex
+     */
+    ackCheckForData(protocolMD5: string, versionNum: string, packetConfigType: PacketConfigType, ackFunc: string, hex: string, dataHex: string): boolean;
+}
+//# sourceMappingURL=ProtocolInterface.d.ts.map

package/dist/protocol/common/ProtocolInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolInterface.d.ts","sourceRoot":"","sources":["../../../websdk/protocol/common/ProtocolInterface.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC;;;OAGG;IACH,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEvD;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAAC;IAEpG;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAErJ;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAE1J;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;IAEnK;;;;;;;;;OASG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,CAAC,EAAE,OAAO,GAAE,MAAM,CAAC;IAE9H;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,MAAM,EAAC,SAAS,EAAC,MAAM,GAAG,UAAU,EAAE,CAAE;IAE7E;;;;;;;OAOG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAEpJ;;;;;;OAMG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAE5H;;;;;;;OAOG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAEnI;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAElJ;;;;;;;;OAQG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACtJ"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "antprotocol-websdk",
+  "version": "1.0.0",
+  "description": "AntProtocol Web SDK",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "webpack serve --config webpack.config.cjs --mode development",
+    "dev:ts": "npm run build:lib && TEST_MODE=ts webpack serve --config webpack.config.cjs --mode development",
+    "dev:js": "npm run build:lib && TEST_MODE=js webpack serve --config webpack.config.cjs --mode development",
+    "build": "npm run build:lib",
+    "build:lib": "webpack --config webpack.config.cjs && npm run build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build:lib",
+    "type-check": "tsc --noEmit",
+    "update-analyze": "tsx websdk/script/update-custom-analyze.ts"
+  },
+  "keywords": [
+    "antprotocol",
+    "websdk",
+    "protocol"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "buffer": "^6.0.3",
+    "decimal.js": "^10.4.3",
+    "json-bigint": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "adm-zip": "^0.5.16",
+    "ts-loader": "^9.5.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.3.3",
+    "webpack": "^5.89.0",
+    "webpack-cli": "^6.0.1",
+    "webpack-dev-server": "^5.2.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}