feat: new action moderationMessageAction

CHANGELOG.md

@@ -10,6 +10,7 @@
   - `mc.getTranscript()`
 - Playlist API
   - `mc.getPlaylist()`
+- New: `ModerationMessageAction` (type: `moderationMessageAction`)
 
 ### Improvements
 

src/chat/actions/addChatItemAction.ts

@@ -12,11 +12,13 @@ import {
   MembershipGiftPurchaseAction,
   MembershipGiftRedemptionAction,
   MembershipGiftPurchaseTickerContent,
+  ModerationMessageAction,
 } from "../../interfaces/actions";
 import {
   YTAddChatItemAction,
   YTLiveChatMembershipItemRenderer,
   YTLiveChatModeChangeMessageRenderer,
+  YTLiveChatModerationMessageRenderer,
   YTLiveChatPaidMessageRenderer,
   YTLiveChatPaidStickerRenderer,
   YTLiveChatPlaceholderItemRenderer,
@@ -84,6 +86,9 @@ export function parseAddChatItemAction(payload: YTAddChatItemAction) {
     return parseLiveChatSponsorshipsGiftRedemptionAnnouncementRenderer(
       renderer
     );
+  } else if ("liveChatModerationMessageRenderer" in item) {
+    const renderer = item["liveChatModerationMessageRenderer"];
+    return parseLiveChatModerationMessageRenderer(renderer);
   }
 
   debugLog(
@@ -541,3 +546,23 @@ export function parseLiveChatSponsorshipsGiftRedemptionAnnouncementRenderer(
   };
   return parsed;
 }
+
+// Moderation message
+export function parseLiveChatModerationMessageRenderer(
+  renderer: YTLiveChatModerationMessageRenderer
+) {
+  const id = renderer.id;
+  const timestampUsec = renderer.timestampUsec;
+  const timestamp = tsToDate(timestampUsec);
+
+  const message = renderer.message.runs;
+
+  const parsed: ModerationMessageAction = {
+    type: "moderationMessageAction",
+    id,
+    timestamp,
+    timestampUsec,
+    message,
+  };
+  return parsed;
+}

src/interfaces/actions.ts

@@ -40,7 +40,8 @@ export type Action =
   | ShowTooltipAction
   | ModeChangeAction
   | MembershipGiftPurchaseAction
-  | MembershipGiftRedemptionAction;
+  | MembershipGiftRedemptionAction
+  | ModerationMessageAction;
 
 export interface AddChatItemAction {
   type: "addChatItemAction";
@@ -374,6 +375,14 @@ export interface MembershipGiftRedemptionAction {
   authorPhoto: string;
 }
 
+export interface ModerationMessageAction {
+  type: "moderationMessageAction";
+  id: string;
+  timestamp: Date;
+  timestampUsec: string;
+  message: YTRun[];
+}
+
 export interface UnknownAction {
   type: "unknown";
   payload: unknown;

src/interfaces/yt/chat.ts

@@ -254,7 +254,8 @@ export type YTAddChatItemActionItem =
   | YTLiveChatViewerEngagementMessageRendererContainer
   | YTLiveChatModeChangeMessageRendererContainer
   | YTLiveChatSponsorshipsGiftPurchaseAnnouncementRendererContainer
-  | YTLiveChatSponsorshipsGiftRedemptionAnnouncementRendererContainer;
+  | YTLiveChatSponsorshipsGiftRedemptionAnnouncementRendererContainer
+  | YTLiveChatModerationMessageRendererContainer;
 
 export interface YTAddLiveChatTickerItemAction {
   item: YTAddLiveChatTickerItem;
@@ -355,6 +356,10 @@ export interface YTLiveChatSponsorshipsGiftRedemptionAnnouncementRendererContain
   liveChatSponsorshipsGiftRedemptionAnnouncementRenderer: YTLiveChatSponsorshipsGiftRedemptionAnnouncementRenderer;
 }
 
+export interface YTLiveChatModerationMessageRendererContainer {
+  liveChatModerationMessageRenderer: YTLiveChatModerationMessageRenderer;
+}
+
 // LiveChat Renderers
 
 export interface YTLiveChatTextMessageRenderer {
@@ -592,6 +597,24 @@ export interface YTLiveChatSponsorshipsGiftRedemptionAnnouncementRenderer {
   trackingParams: string;
 }
 
+// Moderation message
+export interface YTLiveChatModerationMessageRenderer {
+  message: {
+    runs: [
+      { text: string; bold: true; italics: true },
+      {
+        // TODO: find other variants
+        text: " was hidden by " | " was unhidden by ";
+        italics: true;
+      },
+      { text: string; bold: true; italics: true },
+      { text: "."; italics: true }
+    ];
+  };
+  id: string;
+  timestampUsec: string;
+}
+
 // Ticker Renderers
 
 export interface YTAddLiveChatTickerItem {