tmc.js 0.3.2 → 0.3.3

package/README.md

@@ -9,6 +9,12 @@ Events driven and chained Taobao Message Channel(TMC) for NodeJS
 [![downloads](https://img.shields.io/npm/dm/tmc.js)](https://www.npmjs.com/package/tmc.js)
 [![license](https://img.shields.io/npm/l/tmc.js)](https://www.npmjs.com/package/tmc.js)
 
+## 设计
+
+核心包以事件作为驱动，通过注册`TOPIC`回调处理函数，实现了TMC产品服务的消息消费处理能力，同时通过`Proxy`代理，以`TOPIC`作为键值，平序注册消息消费处理函数，序图如下：
+
+[![SDK Sequence](./.github/sdk-sequence.svg)](./.github/sdk-sequence.mmd)
+
 ## 使用
 
 `npm i tmc.js`

package/lib/consumer.js

@@ -187,16 +187,12 @@ class TaoMessageConsumer extends EventEmitter {
   connect(address) {
     if (address) { this[kAddress] = address; }
 
-    this[kWebSocket]?.close();
-
-    const ws = new WebSocket(this[kAddress]);
-    Reflect.set(this, kWebSocket, ws);
-
-    ws.on('open', () => this.onopen());
-    ws.on('ping', (...arg) => this.onping(...arg));
-    ws.on('error', (err) => this.onerror(err));
-    ws.on('close', (...arg) => this.onclose(...arg));
-    ws.on('message', (...arg) => this.onmessage(...arg));
+    this[kWebSocket] = new WebSocket(this[kAddress])
+      .on('message', (data, isBinary) => this.onmessage(data, isBinary))
+      .on('close', (code, reason) => this.onclose(code, reason))
+      .on('error', (err) => this.onerror(err))
+      .on('ping', (data) => this.onping(data))
+      .on('open', () => this.onopen());
 
     return this;
   }

package/lib/message-fields.js

@@ -12,6 +12,11 @@ const SDK = 'sdk';
 const INTRANET_IP = 'intranet_ip';
 const ID = 'id';
 const TOPIC = 'topic';
+const MSG = 'msg';
+const DATAID = 'dataid';
+const USERID = 'userid';
+const OUTTIME = 'outtime';
+const PUBLISHER = 'publisher';
 
 class MessageFields {
   static TYPE = TYPE;
@@ -41,6 +46,16 @@ class MessageFields {
   static ID = ID;
 
   static TOPIC = TOPIC;
+
+  static MSG = MSG;
+
+  static DATAID = DATAID;
+
+  static USERID = USERID;
+
+  static OUTTIME = OUTTIME;
+
+  static PUBLISHER = PUBLISHER;
 }
 
 module.exports = MessageFields;
@@ -59,3 +74,8 @@ module.exports.SDK = SDK;
 module.exports.INTRANET_IP = INTRANET_IP;
 module.exports.ID = ID;
 module.exports.TOPIC = TOPIC;
+module.exports.MSG = MSG;
+module.exports.DATAID = DATAID;
+module.exports.USERID = USERID;
+module.exports.OUTTIME = OUTTIME;
+module.exports.PUBLISHER = PUBLISHER;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmc.js",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Events driven and chained Taobao Message Channel(TMC) for NodeJS",
   "author": "James ZHANG",
   "license": "MIT",

package/types/index.d.ts

@@ -784,6 +784,10 @@ declare interface TaoTopicsDescriptor {
   tmall_auto_TradeModify(fn: (this: TaoMessageConsumer, message: IncomingMessage.TmallAutoTradeModify) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallAutoTwoWheelsReceiptCreate 天猫汽车 > 天猫二轮车服务工单创建开放} */
   tmall_auto_TwoWheelsReceiptCreate(fn: (this: TaoMessageConsumer, message: IncomingMessage.TmallAutoTwoWheelsReceiptCreate) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TmallCarContractSign 天猫汽车 > 合同签署消息} */
+  tmall_car_ContractSign(fn: (this: TaoMessageConsumer, message: IncomingMessage.TmallCarContractSign) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TmallCarFinanceMsg 天猫汽车 > 汽车金融消息} */
+  tmall_car_FinanceMsg(fn: (this: TaoMessageConsumer, message: IncomingMessage.TmallCarFinanceMsg) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallChannelApplyOrderChange 渠道中心API > 申请单变更消息} */
   tmall_channel_ApplyOrderChange(fn: (this: TaoMessageConsumer, message: IncomingMessage.TmallChannelApplyOrderChange) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallChannelDeliverOrderChange 渠道中心API > 发货单消息变更} */
@@ -1609,6 +1613,10 @@ declare interface TaoEventsListener {
   on(topic: 'tmall_auto_TradeModify', listener: (this: TaoMessageConsumer, message: IncomingMessage.TmallAutoTradeModify) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallAutoTwoWheelsReceiptCreate 天猫汽车 > 天猫二轮车服务工单创建开放} */
   on(topic: 'tmall_auto_TwoWheelsReceiptCreate', listener: (this: TaoMessageConsumer, message: IncomingMessage.TmallAutoTwoWheelsReceiptCreate) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TmallCarContractSign 天猫汽车 > 合同签署消息} */
+  on(topic: 'tmall_car_ContractSign', listener: (this: TaoMessageConsumer, message: IncomingMessage.TmallCarContractSign) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TmallCarFinanceMsg 天猫汽车 > 汽车金融消息} */
+  on(topic: 'tmall_car_FinanceMsg', listener: (this: TaoMessageConsumer, message: IncomingMessage.TmallCarFinanceMsg) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallChannelApplyOrderChange 渠道中心API > 申请单变更消息} */
   on(topic: 'tmall_channel_ApplyOrderChange', listener: (this: TaoMessageConsumer, message: IncomingMessage.TmallChannelApplyOrderChange) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TmallChannelDeliverOrderChange 渠道中心API > 发货单消息变更} */

package/types/message-fields.d.ts

@@ -13,6 +13,11 @@ declare namespace MessageFields {
   type INTRANET_IP = 'intranet_ip';
   type ID = 'id';
   type TOPIC = 'topic';
+  type MSG = 'msg';
+  type DATAID = 'dataid';
+  type USERID = 'userid';
+  type OUTTIME = 'outtime';
+  type PUBLISHER = 'publisher';
 }
 
 declare class MessageFields {
@@ -30,4 +35,9 @@ declare class MessageFields {
   static INTRANET_IP: MessageFields.INTRANET_IP;
   static ID: MessageFields.ID;
   static TOPIC: MessageFields.TOPIC;
+  static MSG: MessageFields.MSG;
+  static DATAID: MessageFields.DATAID;
+  static USERID: MessageFields.USERID;
+  static OUTTIME: MessageFields.OUTTIME;
+  static PUBLISHER: MessageFields.PUBLISHER;
 }

package/types/message.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-/// <reference path="header-type.d.ts" />
+/// <reference path="message-type.d.ts" />
 /// <reference path="message-kind.d.ts" />
 
 declare class Message {
@@ -7,14 +7,14 @@ declare class Message {
     type?: MessageType.CONNECT | MessageType.CONNECTACK | MessageType.SEND | MessageType.SENDACK,
     kind?: MessageKind.None | MessageKind.PullRequest | MessageKind.Confirm | MessageKind.Data | MessageKind.Failed
   );
-  protocolVersion: number;
-  messageType: number;
+  protocolVersion: 2;
+  messageType: MessageType.CONNECT | MessageType.CONNECTACK | MessageType.SEND | MessageType.SENDACK;
   statusCode?: number;
   statusPhrase?: string;
   flag?: number;
   token?: string;
   content?: MessageContent;
-  with(key: string, value?: number | bigint | string | Buffer | Date): this;
+  with(key: string | MessageKind, value?: number | bigint | string | Buffer | Date): this;
   get buffer(): Buffer;
   static from(buf: Buffer): Message;
 }

package/types/message.in.d.ts

@@ -751,6 +751,10 @@ declare namespace IncomingMessage {
   type TmallAutoTradeModify = Message & { content?: MessageContent & { content?: string | Tmall.Auto.TradeModify } };
   /** {@link Tmall.Auto.TwoWheelsReceiptCreate 天猫汽车 > 天猫二轮车服务工单创建开放} */
   type TmallAutoTwoWheelsReceiptCreate = Message & { content?: MessageContent & { content?: string | Tmall.Auto.TwoWheelsReceiptCreate } };
+  /** {@link Tmall.Car.ContractSign 天猫汽车 > 合同签署消息} */
+  type TmallCarContractSign = Message & { content?: MessageContent & { content?: string | Tmall.Car.ContractSign } };
+  /** {@link Tmall.Car.FinanceMsg 天猫汽车 > 汽车金融消息} */
+  type TmallCarFinanceMsg = Message & { content?: MessageContent & { content?: string | Tmall.Car.FinanceMsg } };
   /** {@link Tmall.Channel.ApplyOrderChange 渠道中心API > 申请单变更消息} */
   type TmallChannelApplyOrderChange = Message & { content?: MessageContent & { content?: string | Tmall.Channel.ApplyOrderChange } };
   /** {@link Tmall.Channel.DeliverOrderChange 渠道中心API > 发货单消息变更} */

package/types/tmall.d.ts

@@ -28,6 +28,25 @@ declare namespace Tmall.Auto {
   }
 }
 
+/** 天猫汽车 */
+declare namespace Tmall.Car {
+  /** 合同签署消息 */
+  interface ContractSign {
+    /** 合同下载地址，有效期10分钟 */
+    contract_url: string;
+    /** 订单id */
+    order_id: number;
+  }
+
+  /** 汽车金融消息 */
+  interface FinanceMsg {
+    /** 订单id */
+    order_id: number;
+    /** 消息类型： FULL_PURCHASE_FINANCE_CANCEL_MSG_TYPE?，因全款购车导致金融取消 REFUND_FINANCE_CANCEL，因退款导致的金融单关闭 */
+    type: string;
+  }
+}
+
 /** 渠道中心API */
 declare namespace Tmall.Channel {
   /** 申请单变更消息 */