@allior/wmake-streamelements-events 0.0.1

package/src/root/message/tags.ts

@@ -0,0 +1,119 @@
+/**
+ * Минимальный тип тегов Twitch (IRCParser / StreamElements)
+ */
+export type TwitchMessageTags = Record<string, unknown> & {
+  "badge-info"?: string;
+  badges?: string;
+  "first-msg"?: string;
+  turbo?: string;
+  subscriber?: string;
+  mod?: string;
+  vip?: string;
+  "user-type"?: string;
+}
+
+/**
+ * Бейдж пользователя (как в event.data.badges)
+ */
+export interface TwitchBadge {
+  type: string;
+  version?: string;
+  url?: string;
+  description?: string;
+}
+
+/**
+ * Парсит месяц подписки из badge-info.
+ * Формат: "subscriber/<NUMBER>" — номер месяца текущей подписки.
+ * @returns номер месяца или null, если нет/не подписчик
+ */
+export function parseSubscriberMonth(tags: TwitchMessageTags): number | null {
+  const badgeInfo = tags["badge-info"] ?? "";
+  const match = badgeInfo.match(/^subscriber\/(\d+)$/);
+  if (!match) {
+    return null;
+  }
+  const n = parseInt(match[1], 10);
+  return Number.isNaN(n) ? null : n;
+}
+
+/**
+ * Подписка активна, если:
+ * - в badge-info subscriber/<NUMBER> и NUMBER !== 0, или
+ * - в badges есть broadcaster/1 (стример всегда «активный подписчик» в своём чате).
+ */
+export function isSubscriptionActive(tags: TwitchMessageTags): boolean {
+  const month = parseSubscriberMonth(tags);
+  if (month !== null && month !== 0) {
+    return true;
+  }
+  const badges = tags.badges ?? "";
+  return badges.includes("broadcaster/1");
+}
+
+export const isSubscriber = isSubscriptionActive;
+
+/**
+ * Подписка активна, если:
+ * - в badge-info subscriber/<NUMBER> и NUMBER !== 0, или
+ * - в badges есть broadcaster/1 (стример всегда «активный подписчик» в своём чате).
+ */
+export function isBroadcaster(tags: TwitchMessageTags): boolean {
+  const badges = tags.badges ?? "";
+  return badges.includes("broadcaster/1");
+}
+
+/**
+ * Первое сообщение в чате: first-msg === "1".
+ */
+export function isFirstMessageChatter(tags: TwitchMessageTags): boolean {
+  return tags["first-msg"] === "1";
+}
+
+/**
+ * Twitch Turbo: turbo === "1".
+ */
+export function isTurbo(tags: TwitchMessageTags): boolean {
+  return tags.turbo === "1";
+}
+
+/**
+ * VIP: vip === "1" или бейдж vip/1.
+ */
+export function isVip(tags: TwitchMessageTags): boolean {
+  const badges = tags.badges ?? "";
+  return tags.vip === "1" || badges.includes("vip/1");
+}
+
+/**
+ * Модератор: mod === "1", бейдж moderator/1 или user-type === "mod".
+ */
+export function isModerator(tags: TwitchMessageTags): boolean {
+  const badges = tags.badges ?? "";
+  const userType = tags["user-type"] ?? "";
+  return (
+    tags.mod === "1" || badges.includes("moderator/1") || userType === "mod"
+  );
+}
+
+/**
+ * Artist: бейдж artist-badge/1.
+ */
+export function isArtist(tags: TwitchMessageTags): boolean {
+  const badges = tags.badges ?? "";
+  return badges.includes("artist-badge/1");
+}
+
+/**
+ * Возвращает URL бейджа по типу из массива бейджей (формат как в event.data.badges).
+ * @param badges массив вида [{ type, version, url, description }, ...]
+ * @param type тип бейджа (например "subscriber", "broadcaster")
+ * @returns url бейджа или undefined
+ */
+export function getBadgeUrlByType(
+  badges: TwitchBadge[],
+  type: string,
+): string | undefined {
+  const badge = badges.find((b) => b.type === type);
+  return badge?.url;
+}

package/src/root/sources/alerts.ts

@@ -0,0 +1,163 @@
+export const testAlerts = {
+  follower: {
+    listener: "follower-latest",
+    event: {
+      name: "An1by",
+    },
+  },
+  communityGiftAnonymous: {
+    listener: "event",
+    event: {
+      type: "communityGiftPurchase",
+      provider: "twitch",
+      channel: "663b10ba6cd449c4162a2230",
+      activityGroup: "41a50a915794e4ae7cf5e600fd3445d4",
+      data: {
+        amount: 2,
+        username: "anonymous",
+        displayName: "AnAnonymousGifter",
+        tier: "2000",
+        sender: "Anonymous",
+      },
+      _id: "699868d7df734989ec85d393",
+      activityId: "699868d7df734989ec85d393",
+    },
+  },
+  communityGift: {
+    listener: "event",
+    event: {
+      type: "communityGiftPurchase",
+      provider: "twitch",
+      channel: "663b10ba6cd449c4162a2230",
+      activityGroup: "841592c0bccbf3e1e7de71e1c8f4d9f0",
+      data: {
+        amount: 1,
+        username: "rishamon",
+        displayName: "rishamon",
+        tier: "1000",
+        sender: "rishamon",
+      },
+      _id: "699867c7fef23197a6a089f5",
+      activityId: "699867c7fef23197a6a089f5",
+    },
+  },
+  sub: {
+    listener: "subscriber-latest",
+    event: {
+      name: "An1by",
+      amount: 1,
+    },
+  },
+  selfSub: {
+    listener: "event",
+    event: {
+      type: "subscriber",
+      provider: "twitch",
+      channel: "663b10ba6cd449c4162a2230",
+      data: {
+        amount: 1,
+        username: "rishamon",
+        displayName: "rishamon",
+        tier: "1000",
+      },
+      _id: "6998676317aed69e62b8f283",
+      activityId: "6998676317aed69e62b8f283",
+    },
+  },
+  soloSubToSomeone: {
+    listener: "event",
+    event: {
+      type: "subscriber",
+      provider: "twitch",
+      channel: "663b10ba6cd449c4162a2230",
+      data: {
+        amount: 1,
+        username: "encry_s",
+        displayName: "encry_s",
+        message:
+          "rishamon gifted a Tier 1 sub to encry_s! This is their first Gift Sub in the channel!",
+        tier: "1000",
+        sender: "rishamon",
+        gifted: true,
+      },
+      _id: "699866e82d9cd9a70854baf2",
+      activityId: "699866e82d9cd9a70854baf2",
+    },
+  },
+  subRenewal: {
+    listener: "event",
+    event: {
+      type: "subscriber",
+      provider: "twitch",
+      channel: "663b10ba6cd449c4162a2230",
+      data: {
+        amount: 8,
+        username: "silgestian",
+        displayName: "SilgeStian",
+        tier: "1000",
+      },
+      _id: "69986dfaf25724ff4162bd1a",
+      activityId: "69986dfaf25724ff4162bd1a",
+    },
+  },
+  bits: {
+    listener: "cheer-latest",
+    event: {
+      name: "An1by",
+      amount: 30,
+    },
+  },
+  raid: {
+    listener: "raid-latest",
+    event: {
+      name: "An1by",
+      amount: 50,
+    },
+  },
+  donationShortText: {
+    listener: "donation",
+    event: {
+      data: {
+        alert_type: "1",
+        currency: "RUB",
+        billing_system: "CARD",
+        id: 5,
+        amount_main: 500,
+        amount: 500,
+        username: "An1by",
+        message: "Simple message text",
+      },
+    },
+  },
+  donationLongText: {
+    listener: "donation",
+    event: {
+      data: {
+        alert_type: "1",
+        currency: "RUB",
+        billing_system: "CARD",
+        id: 5,
+        amount_main: 500,
+        amount: 500,
+        username: "An1by",
+        message:
+          "A plain gray stone lay on the shore, basking in the sun's warmth. A shove broke its peace—a thoughtless toss sent it flying. The stone splashed into water. Ripples spread, yet none noticed. It sank to the bottom, heavy with loneliness. \"Didn't I deserve to stay where I was happy still?\" it wondered.",
+      },
+    },
+  },
+  donation: {
+    listener: "donation",
+    event: {
+      data: {
+        alert_type: "1",
+        currency: "RUB",
+        billing_system: "CARD",
+        id: 5,
+        amount_main: 500,
+        amount: 500,
+        username: "An1by",
+        message: "",
+      },
+    },
+  },
+};

package/src/root/sources/index.ts

@@ -0,0 +1,5 @@
+import testOnWidgetLoadDetail from "./on-widget-load-detail.js";
+
+export * from "./alerts.js";
+export * from "./messages.js";
+export { testOnWidgetLoadDetail };