@allior/wmake-streamelements-events 2.0.2 → 2.0.3

package/src/root/classifier.ts

@@ -1,271 +0,0 @@
-/**
- * Shared classification and tier parsing for Twitch/StreamElements subscription events.
- * Used by aggregate normalizer.
- */
-
-import type { ClassifiedEvent, IncomingDetail, TierInfo } from "./types";
-
-export function parseTier(raw: string | number | null | undefined): TierInfo {
-	if (raw == null) return { tier: 0, tierText: "" };
-	const tierText = typeof raw === "string" ? raw : String(raw);
-	const num = parseInt(tierText, 10);
-	if (Number.isNaN(num)) return { tier: 0, tierText };
-	const tier = num >= 3000 ? 3 : num >= 2000 ? 2 : num >= 1000 ? 1 : 0;
-	return { tier, tierText };
-}
-
-export function getCacheKey(detail: IncomingDetail): string {
-	const listener = detail.listener;
-	const event = detail.event ?? {};
-	const ag = event.activityGroup;
-	const aid = event.activityId ?? event._id;
-	if (ag) return String(ag);
-	if (aid) return String(aid);
-	if (listener === "subscriber-latest" && event.bulkGifted) {
-		return (
-			"sl-bulk-" +
-			(event.sender ?? "") +
-			"-" +
-			(event.amount ?? "") +
-			"-" +
-			(event.tier ?? "") +
-			"-" +
-			(event._id ?? "")
-		);
-	}
-	return `sl-${event._id ?? event.activityId ?? ""}`;
-}
-
-export function classifyEvent(detail: IncomingDetail): ClassifiedEvent | null {
-	const listener = detail.listener;
-	const event = detail.event ?? {};
-	const data = (event.data ?? event) as Record<string, unknown>;
-	const tierInfo = parseTier(
-		(data.tier ?? event.tier) as string | number | undefined,
-	);
-
-	if (listener === "event") {
-		if (event.type === "communityGiftPurchase") {
-			const isAnon =
-				(data.username &&
-					String(data.username).toLowerCase() === "anonymous") ||
-				data.sender === "Anonymous";
-			return {
-				type: isAnon ? "community-gift-anonymous" : "community-gift",
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-				totalAmount: parseInt(String(data.amount), 10) || 1,
-				recipients: [],
-				sender: isAnon
-					? undefined
-					: ((data.sender ?? data.displayName ?? data.username) as string),
-				anonymousDisplayName: isAnon
-					? ((data.displayName as string) ?? "Anonymous")
-					: undefined,
-			};
-		}
-		if (event.type === "subscriber") {
-			const gifted = data.gifted === true;
-			const sender = data.sender as string | undefined;
-			const amount = parseInt(String(data.amount), 10) || 1;
-			const username = (data.username ?? data.displayName) as
-				| string
-				| undefined;
-			const activityGroup = event.activityGroup as string | undefined;
-
-			if (sender === "Anonymous" && activityGroup) {
-				return {
-					type: "community-gift-anonymous",
-					_role: "recipient",
-					activityGroup,
-					recipient: (username ?? data.displayName) as string,
-					tier: tierInfo.tier,
-					tierText: tierInfo.tierText,
-				};
-			}
-			if (gifted && sender && sender !== "Anonymous") {
-				const isCommunity =
-					data.communityGifted === true ||
-					(activityGroup != null && activityGroup !== "");
-				if (!isCommunity) {
-					const firstGift =
-						String(data.message ?? "").indexOf("first Gift Sub") !== -1;
-					return {
-						type: "solo-sub-to-someone",
-						sender,
-						recipient: (username ?? data.displayName) as string,
-						tier: tierInfo.tier,
-						tierText: tierInfo.tierText,
-						firstGiftInChannel: firstGift,
-					};
-				}
-				return {
-					type: "community-gift",
-					_role: "recipient",
-					activityGroup: activityGroup ?? "",
-					recipient: (username ?? data.displayName) as string,
-					tier: tierInfo.tier,
-					tierText: tierInfo.tierText,
-				};
-			}
-			if (!gifted && amount > 1) {
-				return {
-					type: "sub-renewal",
-					name: (username ?? data.displayName) as string,
-					months: amount,
-					tier: tierInfo.tier,
-					tierText: tierInfo.tierText,
-				};
-			}
-			if (!gifted && amount === 1) {
-				return {
-					type: "self-sub",
-					name: (username ?? data.displayName) as string,
-					tier: tierInfo.tier,
-					tierText: tierInfo.tierText,
-				};
-			}
-			if (activityGroup) {
-				return {
-					type: "community-gift",
-					_role: "recipient",
-					activityGroup,
-					recipient: (username ?? data.displayName) as string,
-					tier: tierInfo.tier,
-					tierText: tierInfo.tierText,
-				};
-			}
-			return {
-				type: "unknown",
-				detail,
-			};
-		}
-		return {
-			type: "unknown",
-			detail,
-		};
-	}
-
-	if (listener === "subscriber-latest") {
-		const bulkGifted = event.bulkGifted === true;
-		const sender = event.sender as string | undefined;
-		const name = event.name as string | undefined;
-		const amount = parseInt(String(event.amount), 10) || 1;
-		const gifted = event.gifted === true;
-		const isCommunityGift =
-			event.isCommunityGift === true || event.communityGifted === true;
-
-		if (bulkGifted && sender === "Anonymous") {
-			return {
-				type: "community-gift-anonymous",
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-				totalAmount: amount,
-				recipients: [],
-			};
-		}
-		if (bulkGifted && sender) {
-			return {
-				type: "community-gift",
-				sender,
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-				totalAmount: amount,
-				recipients: [],
-			};
-		}
-		if (gifted && !isCommunityGift && sender) {
-			const firstGift =
-				String(event.message ?? "").indexOf("first Gift Sub") !== -1;
-			return {
-				type: "solo-sub-to-someone",
-				sender,
-				recipient: name ?? "",
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-				firstGiftInChannel: firstGift,
-			};
-		}
-		if (!gifted && amount > 1) {
-			return {
-				type: "sub-renewal",
-				name: name ?? "",
-				months: amount,
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-			};
-		}
-		if (!gifted && amount === 1 && (sender == null || name === sender)) {
-			return {
-				type: "self-sub",
-				name: name ?? "",
-				tier: tierInfo.tier,
-				tierText: tierInfo.tierText,
-			};
-		}
-		return {
-			type: "unknown",
-			detail,
-		};
-	}
-
-	if (listener === "follower-latest") {
-		return {
-			type: "follow",
-			name: (event.name as string) ?? "",
-		};
-	}
-
-	if (listener === "cheer-latest") {
-		const amount = parseInt(String(event.amount), 10) || 0;
-		return {
-			type: "cheer",
-			name: (event.name as string) ?? "",
-			amount,
-		};
-	}
-
-	if (listener === "raid-latest") {
-		const amount = parseInt(String(event.amount), 10) || 0;
-		return {
-			type: "raid",
-			name: (event.name as string) ?? "",
-			viewers: amount,
-		};
-	}
-
-	if (listener === "donation") {
-		const d = detail.event?.data as
-			| {
-					alert_type?: string;
-					currency?: string;
-					billing_system?: string;
-					id?: number;
-					amount_main?: number;
-					amount?: number;
-					username?: string;
-					message?: string;
-			  }
-			| undefined;
-
-		const donationAmount =
-			(d?.amount_main as number | undefined) ??
-			(d?.amount as number | undefined) ??
-			0;
-
-		return {
-			type: "donation",
-			amount: donationAmount,
-			currency: d?.currency,
-			username: d?.username,
-			message: d?.message,
-			billingSystem: d?.billing_system,
-			id: d?.id,
-		};
-	}
-
-	return {
-		type: "unknown",
-		detail,
-	};
-}

package/src/root/commands.ts

@@ -1,39 +0,0 @@
-/**
- * Команды, вызывающие onEventReceived с тестовыми сообщением или алертом.
- * Работают только в браузере (требуется window).
- */
-import { testAlerts, testMessages } from "./sources";
-
-const EVENT_NAME = "onEventReceived";
-
-/**
- * Отправляет тестовое сообщение по ключу: диспатчит CustomEvent onEventReceived.
- */
-export function testMessage(key: string): void {
-	if (typeof window === "undefined") {
-		return;
-	}
-	const cleanKey = key.startsWith("testMessage_")
-		? key.replace("testMessage_", "")
-		: key;
-	const msg = testMessages[cleanKey as keyof typeof testMessages];
-	if (msg) {
-		window.dispatchEvent(new CustomEvent(EVENT_NAME, { detail: msg }));
-	}
-}
-
-/**
- * Отправляет тестовый алерт по ключу: диспатчит CustomEvent onEventReceived.
- */
-export function testAlert(key: string): void {
-	if (typeof window === "undefined") {
-		return;
-	}
-	const cleanKey = key.startsWith("testAlert_")
-		? key.replace("testAlert_", "")
-		: key;
-	const alert = testAlerts[cleanKey as keyof typeof testAlerts];
-	if (alert) {
-		window.dispatchEvent(new CustomEvent(EVENT_NAME, { detail: alert }));
-	}
-}

package/src/root/data/field-value.ts

@@ -1,2 +0,0 @@
-/** Минимальный тип для fieldData в WidgetLoadDetail (без зависимости от streamelements). */
-export type FieldValue = string | number | boolean | undefined | null;

package/src/root/data/index.ts

@@ -1,2 +0,0 @@
-export * from "./field-value";
-export * from "./widget-load";

package/src/root/data/widget-load.ts

@@ -1,5 +0,0 @@
-import type { FieldValue } from "./field-value.js";
-
-export interface WidgetLoadDetail {
-	fieldData: Record<string, FieldValue>;
-}

package/src/root/guards/index.ts

@@ -1 +0,0 @@
-export * from "./on-event-received";

package/src/root/guards/on-event-received.ts

@@ -1,58 +0,0 @@
-import type {
-	CheerDetail,
-	CommunityGiftPurchaseDetail,
-	DeleteMessageDetail,
-	DeleteMessagesDetail,
-	DonationDetail,
-	FollowerDetail,
-	MinimalEvent,
-	RaidDetail,
-	SubscriberDetail,
-	SubscriberLatestDetail,
-	TwitchMessageDetail,
-	WidgetButtonDetail,
-} from "@/root/types/on-event-received";
-
-export const isDetail = (d: unknown): d is MinimalEvent =>
-	typeof d === "object" && d !== null && "listener" in d;
-
-export function createGuard<T extends MinimalEvent>(
-	predicate: (d: MinimalEvent) => boolean,
-) {
-	return (d: unknown): d is T => isDetail(d) && predicate(d);
-}
-
-export const isTwitchMessageEvent = createGuard<TwitchMessageDetail>(
-	(d) => d.listener === "message",
-);
-export const isFollowerDetail = createGuard<FollowerDetail>(
-	(d) => d.listener === "follower-latest",
-);
-export const isSubscriberLatestDetail = createGuard<SubscriberLatestDetail>(
-	(d) => d.listener === "subscriber-latest",
-);
-export const isCheerDetail = createGuard<CheerDetail>(
-	(d) => d.listener === "cheer-latest",
-);
-export const isRaidDetail = createGuard<RaidDetail>(
-	(d) => d.listener === "raid-latest",
-);
-export const isDonationDetail = createGuard<DonationDetail>(
-	(d) => d.listener === "donation",
-);
-export const isDeleteMessageDetail = createGuard<DeleteMessageDetail>(
-	(d) => d.listener === "delete-message",
-);
-export const isDeleteMessagesDetail = createGuard<DeleteMessagesDetail>(
-	(d) => d.listener === "delete-messages",
-);
-export const isCommunityGiftPurchaseDetail =
-	createGuard<CommunityGiftPurchaseDetail>(
-		(d) => d.listener === "event" && d.event?.type === "communityGiftPurchase",
-	);
-export const isSubscriberDetail = createGuard<SubscriberDetail>(
-	(d) => d.listener === "event" && d.event?.type === "subscriber",
-);
-export const isWidgetButtonDetail = createGuard<WidgetButtonDetail>(
-	(d) => d.listener === "event:test" && d.event?.listener === "widget-button",
-);

package/src/root/index.ts

@@ -1,11 +0,0 @@
-export * from "./aggregate.js";
-export * from "./classifier.js";
-export * from "./types";
-import "./window-event-map";
-
-export * from "./commands";
-export * from "./data";
-export * from "./keys";
-export * from "./message";
-export * from "./queue";
-export * from "./sources/index";

package/src/root/keys.ts

@@ -1,14 +0,0 @@
-/**
- * Преобразование fieldId виджета в ключ тестовых данных.
- */
-export function getTestMessageKey(fieldId: string): string | null {
-	if (!fieldId.startsWith("testMessage")) return null;
-	const name = fieldId.replace("testMessage", "");
-	return name.charAt(0).toLowerCase() + name.slice(1);
-}
-
-export function getTestAlertKey(fieldId: string): string | null {
-	if (!fieldId.startsWith("testAlert")) return null;
-	const name = fieldId.replace("testAlert", "");
-	return name.charAt(0).toLowerCase() + name.slice(1);
-}

package/src/root/message/index.ts

@@ -1 +0,0 @@
-export * from "./twitch"

package/src/root/message/twitch/index.ts

@@ -1,2 +0,0 @@
-export * from "./message";
-export * from "./user-message-data";

package/src/root/message/twitch/message.ts

@@ -1,48 +0,0 @@
-export namespace TwitchMessage {
-	export interface Data {
-		tags: Tags;
-		nick: string;
-		userId: string;
-		displayName: string;
-		displayColor?: string;
-		badges: Array<Badge>;
-		channel: string;
-		text: string;
-		isAction: boolean;
-		emotes: Array<Emote>;
-		msgId: string;
-		time?: number;
-	}
-
-	export type Tags = Record<string, unknown> & {
-		"badge-info"?: string;
-		badges?: string;
-		"first-msg"?: string;
-		turbo?: string;
-		subscriber?: string;
-		mod?: string;
-		vip?: string;
-		"user-type"?: string;
-		"reply-parent-msg-id"?: string;
-		"reply-parent-msg-body"?: string;
-		"reply-parent-display-name"?: string;
-		"reply-parent-user-login"?: string;
-		"reply-parent-user-id"?: string;
-	};
-
-	export interface Badge {
-		type: string;
-		version?: string;
-		url?: string;
-		description?: string;
-	}
-
-	export interface Emote {
-		type: string;
-		name: string;
-		id: string;
-		urls: Record<string, string>;
-		start?: number;
-		end?: number;
-	}
-}

package/src/root/message/twitch/user-message-data.ts

@@ -1,112 +0,0 @@
-import type { TwitchMessage } from "./message";
-
-export enum UserRole {
-	BROADCASTER = "broadcaster",
-	LEAD_MODERATOR = "lead_moderator",
-	MODERATOR = "moderator",
-	VIP = "vip",
-	ARTIST = "artist",
-	FOUNDER = "founder",
-	SUBSCRIBER = "subscriber",
-	TURBO = "turbo",
-	DEFAULT = "default",
-}
-
-type UserMessageDataOptions = {
-	badges?: TwitchMessage.Badge[];
-	tags?: TwitchMessage.Tags;
-};
-
-export const TwitchUserMessageData = ({
-	badges = [],
-	tags = {},
-}: UserMessageDataOptions) => {
-	const includesBadgeType = (type: string) => {
-		return !!badges.find((b) => b.type === type);
-	};
-
-	const tagBadgesString = tags.badges ?? "";
-	const userType = tags["user-type"] ?? "";
-
-	const isSubscriber =
-		tagBadgesString.includes("subscriber/1") ||
-		tags.subscriber === "1" ||
-		includesBadgeType("subscriber");
-
-	const isFounder =
-		tagBadgesString.includes("founder/1") || includesBadgeType("founder");
-
-	const isBroadcaster =
-		tagBadgesString.includes("broadcaster/1") ||
-		includesBadgeType("broadcaster");
-
-	const isFirstMessageChatter = tags["first-msg"] === "1";
-
-	const isTurbo = tags.turbo === "1";
-
-	const isVip =
-		tags.vip === "1" ||
-		tagBadgesString.includes("vip/1") ||
-		includesBadgeType("vip");
-
-	const isLeadModerator =
-		tagBadgesString.includes("lead_moderator/1") ||
-		includesBadgeType("lead_moderator");
-
-	const isModerator =
-		((tags.mod === "1" ||
-			tagBadgesString.includes("moderator/1") ||
-			userType === "mod") &&
-			!isLeadModerator) ||
-		includesBadgeType("moderator");
-
-	const isAnyModerator = isModerator || isLeadModerator;
-
-	const isArtist =
-		tagBadgesString.includes("artist-badge/1") ||
-		includesBadgeType("artist-badge");
-
-	const roles: UserRole[] = [];
-	if (isBroadcaster) roles.push(UserRole.BROADCASTER);
-	if (isLeadModerator) roles.push(UserRole.LEAD_MODERATOR);
-	if (isModerator) roles.push(UserRole.MODERATOR);
-	if (isVip) roles.push(UserRole.VIP);
-	if (isArtist) roles.push(UserRole.ARTIST);
-	if (isFounder) roles.push(UserRole.FOUNDER);
-	if (isSubscriber) roles.push(UserRole.SUBSCRIBER);
-	if (isTurbo) roles.push(UserRole.TURBO);
-	roles.push(UserRole.DEFAULT);
-
-	const getSubscriberMonths = (): number => {
-		for (const key of ["badge-info", "badges"]) {
-			const tag = tags[key] as string;
-			if (tag) {
-				const match = tag.match(/^subscriber\/(\d+)$/);
-				if (match) {
-					return parseInt(match[1], 10);
-				}
-			}
-		}
-		return 0;
-	};
-
-	const getBadgeUrlByType = (type: string) =>
-		badges.find((b) => b.type === type)?.url;
-
-	return {
-		isSubscriber,
-		isBroadcaster,
-		isFirstMessageChatter,
-		isFounder,
-		isTurbo,
-		isVip,
-		isAnyModerator,
-		isModerator,
-		isLeadModerator,
-		isArtist,
-		roles,
-		includesBadgeType,
-		getSubscriberMonths,
-		getBadgeUrlByType,
-	};
-};

package/src/root/queue/alert-queue.ts

@@ -1,31 +0,0 @@
-import type { ClassifiedEvent } from "@/root";
-import type { NextAlertCallback } from ".";
-
-export class AlertQueue {
-	private readonly queue: ClassifiedEvent[] = [];
-	public isShowingAlert: boolean = false;
-	public onNextAlert: NextAlertCallback;
-
-	constructor(onNextAlert: NextAlertCallback) {
-		this.onNextAlert = onNextAlert;
-	}
-
-	public push(event: ClassifiedEvent) {
-		this.queue.push(event);
-	}
-
-	// DON'T FORGET SET "this.isShowingAlert = false" AFTER EXECUTION
-	public processNextAlert() {
-		if (this.queue.length === 0 || this.isShowingAlert) {
-			return;
-		}
-
-		const alertData = this.queue.shift();
-		if (!alertData) {
-			return;
-		}
-		this.isShowingAlert = true;
-
-		this.onNextAlert(this, alertData);
-	}
-}

package/src/root/queue/index.ts

@@ -1,2 +0,0 @@
-export * from "./alert-queue";
-export * from "./next-alert-callback";

package/src/root/queue/next-alert-callback.ts

@@ -1,7 +0,0 @@
-import type { ClassifiedEvent } from "@/root";
-import type { AlertQueue } from ".";
-
-export type NextAlertCallback = (
-	self: AlertQueue,
-	event: ClassifiedEvent | null,
-) => void;