dimsum-chat 0.4.7 → 0.5.0

package/dist/dimsum-chat.js

@@ -1,7 +1,7 @@
 var T = Object.defineProperty;
-var A = (r, t, i) => t in r ? T(r, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : r[t] = i;
-var b = (r, t, i) => (A(r, typeof t != "symbol" ? t + "" : t, i), i);
-const I = {
+var A = (b, t, i) => t in b ? T(b, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : b[t] = i;
+var a = (b, t, i) => (A(b, typeof t != "symbol" ? t + "" : t, i), i);
+const k = {
   type: "LIVE_OPEN_PLATFORM_DM",
   content: {
     cmd: "LIVE_OPEN_PLATFORM_DM",
@@ -14,7 +14,7 @@ const I = {
       dm_type: 0
     }
   }
-}, k = {
+}, I = {
   type: "LIVE_OPEN_PLATFORM_SEND_GIFT",
   content: {
     cmd: "LIVE_OPEN_PLATFORM_SEND_GIFT",
@@ -30,17 +30,17 @@ const I = {
       gift_icon: "data:image/png;base64,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"
     }
   }
-}, _ = [I, k], m = class m {
+}, D = [k, I], f = class f {
   constructor() {
-    b(this, "AUTH_HOST", "https://dimsum-widget-auth-1301031323.cos.ap-guangzhou.myqcloud.com");
-    b(this, "WHITELIST_WIDGETS", ["dimsum-bonk-2024-widget", "douyin-bonk-2024-widget"]);
-    b(this, "MAX_RETRY_COUNT", 3);
-    b(this, "authenticatedPlatformAndRoomId");
-    b(this, "isPiracy", !1);
-    b(this, "retryCount", 0);
+    a(this, "AUTH_HOST", "https://dimsum-widget-auth-1301031323.cos.ap-guangzhou.myqcloud.com");
+    a(this, "WHITELIST_WIDGETS", ["dimsum-bonk-2024-widget", "douyin-bonk-2024-widget"]);
+    a(this, "MAX_RETRY_COUNT", 3);
+    a(this, "authenticatedPlatformAndRoomId");
+    a(this, "isPiracy", !1);
+    a(this, "retryCount", 0);
   }
   static getInstance() {
-    return m.instance || (m.instance = new m()), m.instance;
+    return f.instance || (f.instance = new f()), f.instance;
   }
   updateWidgetId(t) {
     return t === "douyin-bonk-2024-widget" ? "dimsum-bonk-2024-widget" : t;
@@ -77,15 +77,15 @@ const I = {
         this.checkAuthentication(n, s, e);
       }
       if (this.isPiracy)
-        return _[Math.floor(Math.random() * _.length)];
+        return D[Math.floor(Math.random() * D.length)];
     } catch (i) {
       console.log("DimSumAuth error", i);
     }
     return t;
   }
 };
-b(m, "instance");
-let l = m;
+a(f, "instance");
+let _ = f;
 const B = {
   type: "LIVE_OPEN_PLATFORM_DM",
   content: {
@@ -108,7 +108,7 @@ const B = {
       guard_level: 1
     }
   }
-}, z = {
+}, w = {
   connected: B,
   welcome: M
 };
@@ -116,34 +116,57 @@ function E() {
   const t = window.location.pathname.split("/");
   return t.length > 1 ? t[1] : "unknown base name";
 }
-function L(r) {
-  let t;
-  switch (r.type) {
+function L(b, t = {}) {
+  const { widgetNickName: i } = t;
+  let s;
+  switch (b.type) {
     case "DimSumChatWidgetInfoRequest":
-      t = {
+      s = {
         type: "DimSumChatWidgetInfoResponse",
         content: {
           base: E(),
-          url: window.location.href
+          url: window.location.href,
+          ...i ? { widgetNickName: i } : {}
         }
       };
   }
-  return t;
+  return s;
 }
 const x = class x {
   constructor() {
-    b(this, "webSocket");
-    b(this, "messageListeners");
+    a(this, "webSocket");
+    a(this, "messageListeners");
+    /**
+     * Nickname for this widget instance.
+     * Set before connection (via onMessageOptions) or dynamically at runtime.
+     * When non-empty, it will be included in DimSumChatWidgetInfoResponse
+     * so other components can identify this widget via DimSumChatCallMessageRequest.
+     */
+    a(this, "widgetNickName", "");
     this.webSocket = null, this.messageListeners = [];
   }
+  /**
+   * 获取唯一的 WebSocket 管理器实例。
+   *
+   * @returns WebSocketManager 单例
+   */
   static getInstance() {
     return x.instance || (x.instance = new x()), x.instance;
   }
+  /**
+   * 连接到指定 WebSocket 服务器。
+   *
+   * 仅可调用一次，重复调用将被忽略。
+   * 连接断开后自动每 3 秒尝试重连。
+   *
+   * @param url - WebSocket 服务器 URL
+   * @see {@link https://dimsum.chat/zh/api/websocket-manager.html#websocketmanager-connect}
+   */
   connect(t) {
     this.webSocket || (this.webSocket = new WebSocket(t), this.webSocket.onmessage = this.handleMessage.bind(this), this.webSocket.onopen = () => {
       console.log("connected"), setTimeout(() => {
         this.messageListeners.forEach(
-          (i) => i(JSON.stringify(z.connected))
+          (i) => i(JSON.stringify(w.connected))
         );
       }, 100);
     }, this.webSocket.onclose = () => {
@@ -156,39 +179,56 @@ const x = class x {
     var n;
     const i = t.data;
     this.messageListeners.forEach((p) => p(i));
-    const s = JSON.parse(i), e = L(s);
+    const s = JSON.parse(i), e = L(s, {
+      widgetNickName: this.widgetNickName
+    });
     e && ((n = this.webSocket) == null || n.send(JSON.stringify(e)));
   }
+  /**
+   * 注册消息监听器。
+   *
+   * 收到 WebSocket 消息后以字符串形式传递给监听器。
+   * 添加监听器时若连接已建立，会自动推送一条欢迎消息。
+   *
+   * @param listener - 消息回调，接收原始 JSON 字符串
+   * @see {@link https://dimsum.chat/zh/api/websocket-manager.html#websocketmanager-addmessagelistener}
+   */
   addMessageListener(t) {
     this.messageListeners.push(t), setTimeout(() => {
-      t(JSON.stringify(z.welcome));
+      t(JSON.stringify(w.welcome));
     }, 100);
   }
+  /**
+   * 移除已注册的消息监听器。
+   *
+   * @param listener - 之前通过 addMessageListener 注册的回调
+   */
   removeMessageListener(t) {
     const i = this.messageListeners.indexOf(t);
     i !== -1 && this.messageListeners.splice(i, 1);
   }
 };
-b(x, "instance");
-let j = x;
+a(x, "instance");
+let z = x;
 function S() {
-  const r = new URL(window.location.href), t = r.protocol === "https:" ? "wss:" : "ws:", i = r.host;
+  const b = new URL(window.location.href), t = b.protocol === "https:" ? "wss:" : "ws:", i = b.host;
   return `${t}//${i}/websocket`;
 }
-function N(r) {
+function P(b) {
   const t = new URL(window.location.href), i = t.protocol, s = t.host;
-  return `${i}//${s}/bface/${r}`;
+  return `${i}//${s}/bface/${b}`;
 }
-function U(r, t = {}) {
+function U(b, t = {}) {
   const {
-    customWsServer: i = S()
-  } = t, s = l.getInstance(), e = j.getInstance();
-  e.connect(i), e.addMessageListener((n) => {
-    const p = JSON.parse(n), d = s.passMessage(p), f = new v(d);
-    r(d, f);
+    customWsServer: i = S(),
+    widgetNickName: s = ""
+  } = t, e = _.getInstance(), n = z.getInstance();
+  n.widgetNickName = s, n.connect(i), n.addMessageListener((p) => {
+    const h = JSON.parse(p), m = e.passMessage(h), o = new C(m);
+    b(m, o);
   });
 }
-const C = [
+const l = [
   ["[过年牛]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/3bb984085d52480ca846fa8f9a1782f6?x-expires=1949886000&x-signature=d8vUokaGkWD%2B4sAHNTLJquCrHrs%3D"],
   ["[元宝]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/5f8ac1b1ddd347c4be34b81b496fcc45?x-expires=2023614000&x-signature=UT%2F8fnFld4xuvjj2bttu6fh76lI%3D"],
   ["[鞭炮]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/02f8ee9536de4c6595171584e2322f0f?x-expires=2023614000&x-signature=Aa8eXgZqb0bx0QNeLONQVgNUbLI%3D"],
@@ -449,7 +489,7 @@ const C = [
   ["[糖葫芦]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/d4aa8a0ff46a445e861ad8fb78c07140?x-expires=2023614000&x-signature=FvN4ytTGjC7Mww8KX4BRIg9wcTE%3D"],
   ["[虎头]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/7569ffeaa3894b8b8ea843c0e5a05f63?x-expires=2023614000&x-signature=m%2Bi3d034xBQkuBqx4xrvzru5q6A%3D"],
   ["[iloveyou]", "https://p3-pc-sign.douyinpic.com/obj/tos-cn-i-tsj2vxp0zn/798bcfd9811f4fcd97df92af06c87a0e?x-expires=2023614000&x-signature=DuK8xhX7glgLx44H53PrhM32D44%3D"]
-], D = [
+], j = [
   ["[dog]", "http://i0.hdslb.com/bfs/live/4428c84e694fbf4e0ef6c06e958d9352c3582740.png"],
   ["[花]", "http://i0.hdslb.com/bfs/live/7dd2ef03e13998575e4d8a803c6e12909f94e72b.png"],
   ["[妙]", "http://i0.hdslb.com/bfs/live/08f735d950a0fba267dda140673c9ab2edf6410d.png"],
@@ -532,7 +572,7 @@ const C = [
   ["[抱拳]", "http://i0.hdslb.com/bfs/live/3f170894dd08827ee293afcb5a3d2b60aecdb5b1.png"],
   ["[给力]", "http://i0.hdslb.com/bfs/live/d1ba5f4c54332a21ed2ca0dcecaedd2add587839.png"],
   ["[耶]", "http://i0.hdslb.com/bfs/live/eb2d84ba623e2335a48f73fb5bef87bcf53c1239.png"]
-], w = [
+], v = [
   ["[666]", "https://ali2.a.yximgs.com/bs2/emotion/1704763447505third_party_s1296657489.png"],
   ["[奸笑]", "https://ali2.a.yximgs.com/bs2/emotion/1704776059816third_party_s1296748052.png"],
   ["[捂脸]", "https://bd.a.yximgs.com/bs2/emotion/1704776021202third_party_s1296747457.png"],
@@ -740,11 +780,13 @@ const C = [
   ["[抱拳]", "https://bd.a.yximgs.com/bs2/emotion/1704790113221third_party_s1296853443.png"],
   ["[早上好]", "https://ali2.a.yximgs.com/bs2/emotion/1704790167344third_party_s1296853922.png"],
   ["[胡思乱想]", "https://ali2.a.yximgs.com/bs2/emotion/1704790657229third_party_s1296858542.png"]
-], h = class h {
+], r = class r {
   constructor(t) {
-    b(this, "rawType");
-    b(this, "rawContent");
-    b(this, "_cachedValues", {});
+    /** 原始消息类型。 */
+    a(this, "rawType");
+    /** 原始消息内容（字符串已自动反序列化为对象）。 */
+    a(this, "rawContent");
+    a(this, "_cachedValues", {});
     this.rawType = t.type;
     try {
       typeof t.content == "string" ? this.rawContent = JSON.parse(t.content) : this.rawContent = t.content;
@@ -916,6 +958,7 @@ const C = [
     if (this.platform === "chzzk" && "uid" in this.rawContent)
       return this.rawContent.uid;
   }
+  /** 粉丝团/守护团等级。 */
   get clubLevel() {
     if (this.platform === "bilibili" || this.platform === "openblive") {
       if (this.rawType === "DANMU_MSG")
@@ -937,6 +980,7 @@ const C = [
     if (this.platform === "douyin" && "user" in this.rawContent && this.rawContent.user.fansClub !== null)
       return this.rawContent.user.fansClub.data.level;
   }
+  /** 粉丝团/守护团名称。 */
   get clubName() {
     var t, i;
     if (this.platform === "bilibili" || this.platform === "openblive") {
@@ -959,6 +1003,7 @@ const C = [
     if (this.platform === "douyin" && "user" in this.rawContent)
       return (i = (t = this.rawContent.user.fansClub) == null ? void 0 : t.data) == null ? void 0 : i.clubName;
   }
+  /** AcFun 守护团所属主播的用户 ID。 */
   get acfunClubUid() {
     if (this.platform === "acfun") {
       let t;
@@ -978,6 +1023,13 @@ const C = [
       return "6" in t && t[6].uri.includes("subscribe_year") || "5" in t && t[5].uri.includes("subscribe_year") ? 2 : "3" in t || "5" in t ? 1 : 0;
     }
   }
+  /**
+   * 用户头像 URL。
+   *
+   * B 站头像存在跨域限制，建议配合 getBfaceURL() 使用。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-avatar}
+   */
   get avatar() {
     var t, i;
     if ((this.platform === "bilibili" || this.platform === "openblive") && "data" in this.rawContent) {
@@ -1005,6 +1057,13 @@ const C = [
     if (this.platform === "kuaishou" && "user" in this.rawContent && "headUrl" in this.rawContent.user && this.rawContent.user.headUrl)
       return this.rawContent.user.headUrl;
   }
+  /**
+   * 弹幕聊天内容。
+   *
+   * 当 type 为 comment 或 superchat 时均有值。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-comment}
+   */
   get comment() {
     const t = {
       acfun: () => this.rawContent.content,
@@ -1030,16 +1089,16 @@ const C = [
       emotStyle: e = "",
       emotClass: n = "",
       acfunCustomStickers: p = [],
-      acfunCustomHtmlBuilder: d
-    } = t, f = {
+      acfunCustomHtmlBuilder: h
+    } = t, m = {
       acfun: () => {
         let o = g(this.rawContent.content);
         if ("emotionUrl" in this.rawContent && this.rawContent.emotionUrl)
           return `<img src="${this.rawContent.emotionUrl}" alt="" style="${i}" class="${s}">`;
         let c;
-        return p.forEach((a) => {
-          o.includes(a.keyWord) && (c = a.path);
-        }), c != null ? d != null ? d(c, o) : `<div style="display:flex;">
+        return p.forEach((d) => {
+          o.includes(d.keyWord) && (c = d.path);
+        }), c != null ? h != null ? h(c, o) : `<div style="display:flex;">
           <img src="${c}" alt="" style="${i}" class="${s}">
           <div style="flex-grow:1;">${o}</div>
           </div>` : g(this.rawContent.content);
@@ -1048,51 +1107,51 @@ const C = [
         if (typeof this.rawContent.info[0][13] == "object")
           return `<img src="${this.rawContent.info[0][13].url}" alt="" style="${i}" class="${s}">`;
         const o = this.rawContent.info[0][15].extra, c = JSON.parse(o);
-        let a = g(c.content);
+        let d = g(c.content);
         const u = c.emots;
         for (let y in u) {
           const F = new RegExp(`\\${y}`, "g");
-          a = a.replace(F, `<img src="${u[y].url}" alt="" style="${e}" class="${n}">`);
+          d = d.replace(F, `<img src="${u[y].url}" alt="" style="${e}" class="${n}">`);
         }
-        return a;
+        return d;
       },
       openblive: () => {
         if (this.rawContent.data.emoji_img_url)
           return `<img src="${this.rawContent.data.emoji_img_url}" alt="" style="${i}" class="${s}">`;
         let o = g(this.rawContent.data.msg);
-        return D.forEach((c) => {
-          const a = new RegExp(`\\${c[0]}`, "g");
-          o = o.replace(a, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
+        return j.forEach((c) => {
+          const d = new RegExp(`\\${c[0]}`, "g");
+          o = o.replace(d, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
         }), o;
       },
       douyin: () => {
         let o = g(this.rawContent.content);
-        return C.forEach((c) => {
-          const a = new RegExp(`\\${c[0]}`, "g");
-          o = o.replace(a, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
+        return l.forEach((c) => {
+          const d = new RegExp(`\\${c[0]}`, "g");
+          o = o.replace(d, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
         }), o;
       },
       kuaishou: () => {
         let o = g(this.rawContent.content);
-        return w.forEach((c) => {
-          const a = new RegExp(`\\${c[0]}`, "g");
-          o = o.replace(a, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
+        return v.forEach((c) => {
+          const d = new RegExp(`\\${c[0]}`, "g");
+          o = o.replace(d, `<img src="${c[1]}" alt="" style="${e}" class="${n}">`);
         }), o;
       },
       chzzk: () => {
         let o = g(this.rawContent.msg);
         if (this.rawContent.extras) {
-          const a = JSON.parse(this.rawContent.extras).emojis || {};
-          for (let u in a) {
+          const d = JSON.parse(this.rawContent.extras).emojis || {};
+          for (let u in d) {
             const y = new RegExp(`\\{:${u}:}`, "g");
-            o = o.replace(y, `<img src="${a[u]}" alt="" style="${e}" class="${n}">`);
+            o = o.replace(y, `<img src="${d[u]}" alt="" style="${e}" class="${n}">`);
           }
           return o;
         }
       }
     };
-    if (this.type === "comment" && f[this.platform])
-      return f[this.platform]();
+    if (this.type === "comment" && m[this.platform])
+      return m[this.platform]();
   }
   /**
    * Custom comment content builder.
@@ -1110,31 +1169,31 @@ const C = [
       bilibili: () => {
         let s, e = [];
         typeof this.rawContent.info[0][13] == "object" && (s = this.rawContent.info[0][13].url);
-        const n = this.rawContent.info[0][15].extra, p = JSON.parse(n), d = g(p.content), f = p.emots;
-        for (let o in f)
-          e.push([o, f[o].url]);
-        return t(d, s, e);
+        const n = this.rawContent.info[0][15].extra, p = JSON.parse(n), h = g(p.content), m = p.emots;
+        for (let o in m)
+          e.push([o, m[o].url]);
+        return t(h, s, e);
       },
       openblive: () => {
         let s;
         this.rawContent.data.emoji_img_url && (s = this.rawContent.data.emoji_img_url);
         const e = g(this.rawContent.data.msg);
-        return t(e, s, D);
+        return t(e, s, j);
       },
       douyin: () => {
         const s = g(this.rawContent.content);
-        return t(s, void 0, C);
+        return t(s, void 0, l);
       },
       kuaishou: () => {
         const s = g(this.rawContent.content);
-        return t(s, void 0, w);
+        return t(s, void 0, v);
       },
       chzzk: () => {
         let s = g(this.rawContent.msg), e = [];
         if (this.rawContent.extras) {
           const p = JSON.parse(this.rawContent.extras).emojis || {};
-          for (let d in p)
-            e.push([`{:${d}:}`, p[d]]);
+          for (let h in p)
+            e.push([`{:${h}:}`, p[h]]);
         }
         return t(s, void 0, e);
       }
@@ -1143,8 +1202,14 @@ const C = [
       return i[this.platform]();
   }
   /**
-   * 大航海等级：0-无 3-舰长 2-提督 1-总督
-   * 若type为guard，则为购买的大航海等级
+   * 大航海等级。
+   *
+   * 0=无，3=舰长，2=提督，1=总督。
+   * 当 type 为 guard 时，表示本次购买的大航海等级；
+   * 其他消息类型中表示该用户当前的大航海等级。
+   * Chzzk 平台的 Subscription 事件也支持此属性。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-guardlevel}
    */
   get guardLevel() {
     if (this.platform === "bilibili" || this.platform === "openblive") {
@@ -1162,6 +1227,13 @@ const C = [
       return t && t <= 3 && t >= 1 ? 4 - t : 0;
     }
   }
+  /**
+   * 大航海购买数量。
+   *
+   * B 站表示购买月数，Chzzk 表示订阅月数。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-guardnum}
+   */
   get guardNum() {
     if (this.platform === "bilibili" || this.platform === "openblive") {
       if (this.rawType === "GUARD_BUY")
@@ -1172,19 +1244,27 @@ const C = [
     if (this.platform === "chzzk")
       return this.chzzkTierMonth;
   }
+  /**
+   * 大航海购买价格（CNY）。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-guardprice}
+   */
   // 可能是单价（未确认），舰长价格198实际可能为138
   get guardPrice() {
     if ((this.platform === "bilibili" || this.platform === "openblive") && "data" in this.rawContent && "price" in this.rawContent.data)
       return this.rawContent.data.price / 1e3;
   }
+  /** Chzzk 订阅等级（1-3）。 */
   get chzzkTier() {
     if (this.platform === "chzzk" && this.rawType === "ChzzkSubscriptionMessage" && this.rawContent.extras)
       return JSON.parse(this.rawContent.extras).tierNo;
   }
+  /** Chzzk 订阅月数。 */
   get chzzkTierMonth() {
     if (this.platform === "chzzk" && this.rawType === "ChzzkSubscriptionMessage" && this.rawContent.extras)
       return JSON.parse(this.rawContent.extras).month;
   }
+  /** 礼物名称。 */
   get giftName() {
     const t = {
       acfun: () => this.rawContent.giftInfo.name,
@@ -1196,6 +1276,13 @@ const C = [
     if (this.type === "gift" && t[this.platform])
       return t[this.platform]();
   }
+  /**
+   * 礼物数量。
+   *
+   * 抖音和快手已由 SDK 内部处理连击去重，每次返回增量值。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-giftnum}
+   */
   get giftNum() {
     const t = {
       acfun: () => this.rawContent.gift.batchSize,
@@ -1203,21 +1290,28 @@ const C = [
       openblive: () => this.rawContent.data.gift_num,
       douyin: () => {
         if (this.rawContent.sendType === 4) {
-          const s = this.rawContent.comboCount, e = this.rawContent.groupId, n = this.rawContent.giftId, p = this.uid, d = `${e}_${p}_${n}`;
-          let f = 0;
-          return h.douyinGiftGroup.has(d) && (f = h.douyinGiftGroup.get(d) ?? 0), h.douyinGiftGroup.set(d, s), h.douyinGiftGroup.size > 1024 && h.douyinGiftGroup.delete(h.douyinGiftGroup.keys().next().value ?? ""), s - f;
+          const s = this.rawContent.comboCount, e = this.rawContent.groupId, n = this.rawContent.giftId, p = this.uid, h = `${e}_${p}_${n}`;
+          let m = 0;
+          return r.douyinGiftGroup.has(h) && (m = r.douyinGiftGroup.get(h) ?? 0), r.douyinGiftGroup.set(h, s), r.douyinGiftGroup.size > 1024 && r.douyinGiftGroup.delete(r.douyinGiftGroup.keys().next().value ?? ""), s - m;
         }
         return this.rawContent.groupCount;
       },
       kuaishou: () => {
         const s = this.rawContent.batchSize * this.rawContent.comboCount, e = this.rawContent.mergeKey;
         let n = 0;
-        return h.kuaishouGiftGroup.has(e) && (n = h.kuaishouGiftGroup.get(e) ?? 0), h.kuaishouGiftGroup.set(e, s), h.kuaishouGiftGroup.size > 1024 && h.kuaishouGiftGroup.delete(h.kuaishouGiftGroup.keys().next().value ?? ""), s - n;
+        return r.kuaishouGiftGroup.has(e) && (n = r.kuaishouGiftGroup.get(e) ?? 0), r.kuaishouGiftGroup.set(e, s), r.kuaishouGiftGroup.size > 1024 && r.kuaishouGiftGroup.delete(r.kuaishouGiftGroup.keys().next().value ?? ""), s - n;
       }
     };
     if (this.type === "gift" && t[this.platform])
       return t[this.platform]();
   }
+  /**
+   * 单个礼物价格（CNY）。
+   *
+   * 免费礼物（如 B 站银瓜子）返回 0。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-giftunitprice}
+   */
   get giftUnitPrice() {
     const t = {
       acfun: () => this.rawContent.gift.giftId !== 1 ? this.rawContent.giftInfo.value / 10 : 0,
@@ -1229,10 +1323,18 @@ const C = [
     if (this.type === "gift" && t[this.platform])
       return t[this.platform]();
   }
+  /**
+   * 礼物总价值（CNY）。
+   *
+   * 等价于 giftNum × giftUnitPrice。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-gifttotalprice}
+   */
   get giftTotalPrice() {
     if (this.giftNum !== void 0 && this.giftUnitPrice !== void 0)
       return this.giftNum * this.giftUnitPrice;
   }
+  /** 礼物图片 URL。 */
   get giftImage() {
     return this.type !== "gift" ? void 0 : {
       acfun: () => this.rawContent.giftInfo.pic,
@@ -1246,6 +1348,7 @@ const C = [
       kuaishou: () => this.rawContent.giftInfo.picUrl[0].url
     }[this.platform]();
   }
+  /** 超级聊天评论内容。 */
   get superChatComment() {
     const t = {
       bilibili: () => this.rawContent.data.message,
@@ -1255,6 +1358,13 @@ const C = [
     if (this.type === "superchat" && t[this.platform])
       return t[this.platform]();
   }
+  /**
+   * 超级聊天价格。
+   *
+   * B 站与 OpenBLive 为人民币（元），Chzzk 为韩元（KRW）。
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-superchatprice}
+   */
   get superChatPrice() {
     const t = {
       bilibili: () => this.rawContent.data.price,
@@ -1267,6 +1377,18 @@ const C = [
     if (this.type === "superchat" && t[this.platform])
       return t[this.platform]();
   }
+  /**
+   * 广义价格，根据消息类型自动选择对应价格属性：
+   *
+   * | 消息类型   | 对应属性          |
+   * |-----------|-----------------|
+   * | gift      | giftTotalPrice  |
+   * | superchat | superChatPrice  |
+   * | guard     | guardPrice      |
+   * | 其它      | undefined       |
+   *
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-price}
+   */
   get price() {
     if (this.type === "gift")
       return this.giftTotalPrice;
@@ -1275,6 +1397,15 @@ const C = [
     if (this.type === "guard")
       return this.guardPrice;
   }
+  /**
+   * 获取用户的抽象化分级，用于渲染用户等级标识。
+   *
+   * 不同平台的映射规则见官网文档。
+   *
+   * @param options - 各平台分段阈值配置，见 {@link abstractLevelOptions}
+   * @returns 0-3 等级，undefined 表示不支持
+   * @see {@link https://dimsum.chat/zh/api/parser.html#parser-getabstractlevel}
+   */
   getAbstractLevel(t = {}) {
     const {
       douyinSteps: i = [7, 11, 15],
@@ -1284,25 +1415,43 @@ const C = [
     } = t, p = (o) => {
       if (this.clubLevel === void 0)
         return 0;
-      const c = o.findIndex((a) => this.clubLevel <= a);
+      const c = o.findIndex((d) => this.clubLevel <= d);
       return c !== -1 ? c : o.length;
-    }, d = () => this.guardLevel && this.guardLevel > 0 ? 4 - this.guardLevel : 0, f = {
+    }, h = () => this.guardLevel && this.guardLevel > 0 ? 4 - this.guardLevel : 0, m = {
       douyin: () => p(i),
       kuaishou: () => p(s),
       acfun: () => n > 0 && this.acfunClubUid !== n ? 0 : p(e),
-      bilibili: () => d(),
-      openblive: () => d(),
+      bilibili: () => h(),
+      openblive: () => h(),
       chzzk: () => this.chzzkTier ?? 0
     };
-    if (f[this.platform])
-      return f[this.platform]();
+    if (m[this.platform])
+      return m[this.platform]();
   }
 };
-// groupId_userId_giftId : comboCount
-b(h, "douyinGiftGroup", /* @__PURE__ */ new Map()), b(h, "kuaishouGiftGroup", /* @__PURE__ */ new Map());
-let v = h;
-function g(r) {
-  return r.replace(/[&<>"']/g, function(t) {
+/**
+ * Douyin emoji mappings. Accessible directly without going through CommentBuilder.
+ *
+ * @example
+ * Parser.DouyinEmots.forEach(([emot, url]) => console.log(emot, url));
+ */
+a(r, "DouyinEmots", l), /**
+ * Bilibili emoji mappings (also used by OpenBLive).
+ *
+ * @example
+ * Parser.BilibiliEmots.forEach(([emot, url]) => console.log(emot, url));
+ */
+a(r, "BilibiliEmots", j), /**
+ * Kuaishou emoji mappings.
+ *
+ * @example
+ * Parser.KuaishouEmots.forEach(([emot, url]) => console.log(emot, url));
+ */
+a(r, "KuaishouEmots", v), // groupId_userId_giftId : comboCount
+a(r, "douyinGiftGroup", /* @__PURE__ */ new Map()), a(r, "kuaishouGiftGroup", /* @__PURE__ */ new Map());
+let C = r;
+function g(b) {
+  return b.replace(/[&<>"']/g, function(t) {
     switch (t) {
       case "&":
         return "&amp;";
@@ -1320,9 +1469,9 @@ function g(r) {
   });
 }
 export {
-  v as Parser,
-  j as WebSocketManager,
-  N as getBfaceURL,
+  C as Parser,
+  z as WebSocketManager,
+  P as getBfaceURL,
   S as getWebSocketURL,
   U as onMessage
 };