@allior/wmake-streamelements-events 0.0.1

package/dist/root/types/on-event-received.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Типы для входящих событий StreamElements/Twitch и результата классификации.
+ */
+/** Алерт: новый подписчик (follower-latest). */
+export interface FollowerDetail {
+    listener: "follower-latest";
+    event: {
+        name: string;
+    };
+}
+/** Алерт: массовая раздача подписок (communityGiftPurchase). */
+export interface CommunityGiftPurchaseDetail {
+    listener: "event";
+    event: {
+        type: "communityGiftPurchase";
+        provider: string;
+        channel: string;
+        activityGroup: string;
+        data: {
+            amount: number;
+            username: string;
+            displayName: string;
+            tier: string;
+            sender?: string;
+        };
+        _id: string;
+        activityId: string;
+    };
+}
+/** Алерт: подписка latest (subscriber-latest). */
+export interface SubscriberLatestDetail {
+    listener: "subscriber-latest";
+    event: {
+        name: string;
+        amount: number;
+    };
+}
+/** Алерт: подписка (self, подарок одному, продление). */
+export interface SubscriberDetail {
+    listener: "event";
+    event: {
+        type: "subscriber";
+        provider: string;
+        channel: string;
+        data: {
+            amount: number;
+            username: string;
+            displayName: string;
+            tier: string;
+            sender?: string;
+            gifted?: boolean;
+            message?: string;
+        };
+        _id: string;
+        activityId: string;
+    };
+}
+/** Алерт: чиры (bits). */
+export interface CheerDetail {
+    listener: "cheer-latest";
+    event: {
+        name: string;
+        amount: number;
+    };
+}
+/** Алерт: рейд. */
+export interface RaidDetail {
+    listener: "raid-latest";
+    event: {
+        name: string;
+        amount: number;
+    };
+}
+/** Алерт: донат. */
+export interface DonationDetail {
+    listener: "donation";
+    event: {
+        data: {
+            alert_type?: string;
+            currency?: string;
+            billing_system?: string;
+            id?: number;
+            amount_main?: number;
+            amount?: number;
+            username?: string;
+            message?: string;
+            [key: string]: unknown;
+        };
+    };
+}
+/** Все типы алертов (onEventReceived). */
+export type AlertDetail = FollowerDetail | SubscriberLatestDetail | CommunityGiftPurchaseDetail | SubscriberDetail | CheerDetail | RaidDetail | DonationDetail;
+/** Входящее событие (обобщённый вид для classifyEvent и т.д.). */
+export interface IncomingDetail {
+    listener: string;
+    event?: {
+        type?: string;
+        provider?: string;
+        channel?: string;
+        activityGroup?: string;
+        activityId?: string;
+        _id?: string;
+        bulkGifted?: boolean;
+        sender?: string;
+        name?: string;
+        amount?: number;
+        tier?: string | number;
+        gifted?: boolean;
+        isCommunityGift?: boolean;
+        communityGifted?: boolean;
+        message?: string;
+        data?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+}
+export interface TierInfo {
+    tier: number;
+    tierText: string;
+}
+export type NormalizedType = "community-gift-anonymous" | "community-gift" | "self-sub" | "solo-sub-to-someone" | "sub-renewal";
+export interface ClassifiedBase {
+    type: NormalizedType;
+    tier: number;
+    tierText: string;
+}
+export interface ClassifiedCommunityGiftPurchase extends ClassifiedBase {
+    type: "community-gift" | "community-gift-anonymous";
+    totalAmount: number;
+    recipients: string[];
+    sender?: string;
+    anonymousDisplayName?: string;
+}
+export interface ClassifiedRecipient extends ClassifiedBase {
+    _role: "recipient";
+    activityGroup: string;
+    recipient: string;
+}
+export interface ClassifiedSoloSub extends ClassifiedBase {
+    type: "solo-sub-to-someone";
+    sender: string;
+    recipient: string;
+    firstGiftInChannel?: boolean;
+}
+export interface ClassifiedSubRenewal extends ClassifiedBase {
+    type: "sub-renewal";
+    name: string;
+    months: number;
+}
+export interface ClassifiedSelfSub extends ClassifiedBase {
+    type: "self-sub";
+    name: string;
+}
+export type ClassifiedEvent = ClassifiedCommunityGiftPurchase | ClassifiedRecipient | ClassifiedSoloSub | ClassifiedSubRenewal | ClassifiedSelfSub | (ClassifiedBase & {
+    type: NormalizedType;
+    [key: string]: unknown;
+});
+export interface CacheLike {
+    _has(key: string): boolean;
+    _set(key: string, value: boolean): void;
+}
+export interface CacheSubsByType {
+    _has?(key: string): boolean;
+    _set?(key: string, value: boolean): void;
+    [type: string]: CacheLike | ((k: string) => boolean) | ((k: string, v: boolean) => void) | undefined;
+}
+export interface NormalizerOptions {
+    cacheSubs?: CacheSubsByType;
+    broadcasterLogin?: string;
+}
+//# sourceMappingURL=on-event-received.d.ts.map

package/dist/root/types/on-event-received.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-event-received.d.ts","sourceRoot":"","sources":["../../../src/root/types/on-event-received.ts"],"names":[],"mappings":"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"}

package/dist/root/types/on-widget-load.d.ts

@@ -0,0 +1,135 @@
+export interface OnWidgetLoadEventDetails {
+    channel: Channel;
+    currency: Currency;
+    fieldData: FieldData;
+    overlay: Overlay;
+    recents: Recents;
+    session: Session;
+}
+export interface Channel {
+    /**
+     * StreamElements API Token (not JWT Token)
+     */
+    apiToken: string;
+    avatar: string;
+    id: string;
+    providerId: string;
+    username: string;
+}
+export interface Currency {
+    code: string;
+    name: string;
+    symbol: string;
+}
+export type FieldData = Record<string, unknown>;
+export interface Overlay {
+    isEditorMode: boolean;
+    muted: boolean;
+}
+/** Base for recent (onWidgetLoad): follower / subscriber / cheer / raid */
+export interface RecentItemBase {
+    name: string;
+    createdAt: string;
+}
+export interface RecentItemFollower extends RecentItemBase {
+    type: "follower";
+}
+export interface RecentItemSubscriber extends RecentItemBase {
+    type: "subscriber";
+    tier: string;
+    amount: number;
+}
+export interface RecentItemCheer extends RecentItemBase {
+    type: "cheer";
+    amount: number;
+}
+export interface RecentItemRaid extends RecentItemBase {
+    type: "raid";
+    amount: number;
+}
+export type RecentsItem = RecentItemFollower | RecentItemSubscriber | RecentItemCheer | RecentItemRaid;
+export type Recents = RecentsItem[];
+export interface SessionSettings {
+    autoReset: boolean;
+    calendar: boolean;
+    resetOnStart: boolean;
+}
+/** Запись в списке follower-recent / subscriber-recent / raid-recent / cheer-recent */
+export interface SessionRecentItem {
+    name: string;
+    createdAt: string;
+    type: string;
+    amount?: number;
+    tier?: string;
+}
+/** Объект *-latest с полями name и amount (subscriber, cheer, tip, host, raid и т.д.) */
+export interface SessionLatestNamedAmount {
+    name: string;
+    amount: number;
+    message?: string;
+    tier?: string;
+    sender?: string;
+    redemption?: string;
+    items?: unknown[];
+}
+/** Объект *-session / *-total и т.п. с полем count */
+export interface SessionCountEntry {
+    count: number;
+}
+/** Объект *-goal / *-session (amount) и т.п. с полем amount */
+export interface SessionAmountEntry {
+    amount: number;
+}
+/** Объект top-donation / top-donator */
+export interface SessionTopEntry {
+    name: string;
+    amount: number;
+}
+/** channel-points-latest */
+export interface SessionChannelPointsLatest {
+    name: string;
+    amount: number;
+    message: string;
+    redemption: string;
+}
+/** community-gift-latest */
+export interface SessionCommunityGiftLatest {
+    name: string;
+    amount: number;
+    tier: string;
+}
+/** hypetrain-latest */
+export interface SessionHypetrainLatest {
+    active: number;
+    amount: number;
+    level: number;
+    levelChanged: number;
+    name: string;
+    type: string;
+}
+/** merch-latest */
+export interface SessionMerchLatest {
+    name: string;
+    amount: number;
+    items: unknown[];
+}
+/** Элемент массива purchase-latest */
+export interface SessionPurchaseLatest {
+    name: string;
+    amount: number;
+    avatar: string;
+    message: string;
+    items: unknown[];
+}
+export type SessionDataEntry = SessionLatestNamedAmount | SessionCountEntry | SessionAmountEntry | SessionTopEntry | SessionChannelPointsLatest | SessionCommunityGiftLatest | SessionHypetrainLatest | SessionMerchLatest | SessionPurchaseLatest | SessionRecentItem[] | {
+    name: string;
+} | {
+    level?: number;
+    percent?: number;
+    amount?: number;
+} | Record<string, unknown>;
+export interface Session {
+    data: Record<string, SessionDataEntry>;
+    settings: SessionSettings;
+}
+//# sourceMappingURL=on-widget-load.d.ts.map

package/dist/root/types/on-widget-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-widget-load.d.ts","sourceRoot":"","sources":["../../../src/root/types/on-widget-load.ts"],"names":[],"mappings":"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"}

package/dist/root/window-event-map.d.ts

@@ -0,0 +1,10 @@
+import type { EventDetail } from "./data/event-detail.js";
+import type { WidgetLoadDetail } from "./data/widget-load.js";
+declare global {
+    interface WindowEventMap {
+        onEventReceived: CustomEvent<EventDetail>;
+        onWidgetLoad: CustomEvent<WidgetLoadDetail>;
+    }
+}
+export {};
+//# sourceMappingURL=window-event-map.d.ts.map

package/dist/root/window-event-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-event-map.d.ts","sourceRoot":"","sources":["../../src/root/window-event-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc;QACtB,eAAe,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;QAC1C,YAAY,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;KAC7C;CACF;AAED,OAAO,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@allior/wmake-streamelements-events",
+  "version": "0.0.1",
+  "description": "Twitch/StreamElements subscription event normalizer for widgets (alerts).",
+  "type": "module",
+  "types": "./dist/root/index.d.ts",
+  "main": "./dist/root/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/root/index.d.ts",
+      "import": "./dist/root/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./src/*": "./src/*"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "README_RU.md"
+  ],
+  "keywords": [
+    "wmake",
+    "events",
+    "twitch",
+    "subscriber",
+    "normalizer",
+    "streamelements"
+  ],
+  "author": "An1by",
+  "license": "ISC",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "cross-env": "^10.1.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "rimraf dist && vite build && cross-env VITE_IIFE_ENTRY=root vite build --config vite.iife.config.ts && cross-env VITE_IIFE_ENTRY=react vite build --config vite.iife.config.ts && tsc -p tsconfig.types.json",
+    "build:iife": "cross-env VITE_IIFE_ENTRY=root vite build --config vite.iife.config.ts && cross-env VITE_IIFE_ENTRY=react vite build --config vite.iife.config.ts",
+    "clean": "rimraf dist"
+  }
+}

package/src/react/hooks/index.ts

@@ -0,0 +1,3 @@
+export * from "./use-event-listener.js";
+export * from "./use-on-event-received.js";
+export * from "./use-on-widget-load.js";

package/src/react/hooks/use-event-listener.ts

@@ -0,0 +1,17 @@
+import { type DependencyList, useEffect, useRef } from "react";
+import type { WindowEventKey, WindowEventListener } from "../types/window-events.js";
+
+export function useEventListener<K extends WindowEventKey>(
+  eventName: K,
+  handler: WindowEventListener<K>,
+  deps: DependencyList = [],
+): void {
+  const callbackRef = useRef<WindowEventListener<K>>(handler);
+  callbackRef.current = handler;
+
+  useEffect(() => {
+    const fn = (ev: WindowEventMap[K]) => callbackRef.current.call(window, ev);
+    window.addEventListener(eventName, fn as EventListener);
+    return () => window.removeEventListener(eventName, fn as EventListener);
+  }, [eventName, ...deps]);
+}

package/src/react/hooks/use-on-event-received.ts

@@ -0,0 +1,206 @@
+import type { DependencyList } from "react";
+import type { WindowEventListener } from "../types/window-events";
+import type {
+  CheerDetail,
+  CommunityGiftPurchaseDetail,
+  DonationDetail,
+  FollowerDetail,
+  RaidDetail,
+  SubscriberDetail,
+  SubscriberLatestDetail,
+} from "@/root/types/on-event-received";
+import type { WidgetButtonDetail } from "@/root/data/event-detail";
+import type { MessageEvent } from "@/root/message";
+import { useEventListener } from "./use-event-listener";
+
+/** Проверка, что detail — сообщение чата (listener "message"). */
+export function isMessageEvent(d: unknown): d is MessageEvent {
+  return (d as { listener?: string }).listener === "message";
+}
+
+/** Проверка, что detail — FollowerDetail (follower-latest). */
+export function isFollowerDetail(d: unknown): d is FollowerDetail {
+  return (d as { listener?: string }).listener === "follower-latest";
+}
+
+/** Проверка, что detail — CommunityGiftPurchaseDetail. */
+export function isCommunityGiftPurchaseDetail(
+  d: unknown,
+): d is CommunityGiftPurchaseDetail {
+  const x = d as { listener?: string; event?: { type?: string } };
+  return x.listener === "event" && x.event?.type === "communityGiftPurchase";
+}
+
+/** Проверка, что detail — SubscriberLatestDetail. */
+export function isSubscriberLatestDetail(
+  d: unknown,
+): d is SubscriberLatestDetail {
+  return (d as { listener?: string }).listener === "subscriber-latest";
+}
+
+/** Проверка, что detail — SubscriberDetail (event type subscriber). */
+export function isSubscriberDetail(d: unknown): d is SubscriberDetail {
+  const x = d as { listener?: string; event?: { type?: string } };
+  return x.listener === "event" && x.event?.type === "subscriber";
+}
+
+/** Проверка, что detail — CheerDetail. */
+export function isCheerDetail(d: unknown): d is CheerDetail {
+  return (d as { listener?: string }).listener === "cheer-latest";
+}
+
+/** Проверка, что detail — RaidDetail. */
+export function isRaidDetail(d: unknown): d is RaidDetail {
+  return (d as { listener?: string }).listener === "raid-latest";
+}
+
+/** Проверка, что detail — DonationDetail. */
+export function isDonationDetail(d: unknown): d is DonationDetail {
+  return (d as { listener?: string }).listener === "donation";
+}
+
+/** Проверка, что detail — WidgetButtonDetail (event:test, widget-button). */
+export function isWidgetButtonDetail(d: unknown): d is WidgetButtonDetail {
+  const x = d as { listener?: string; event?: { listener?: string } };
+  return x.listener === "event:test" && x.event?.listener === "widget-button";
+}
+
+/** Общий хук на любое событие onEventReceived. */
+export function useOnEventReceived(
+  handler: WindowEventListener<"onEventReceived">,
+  deps: DependencyList = [],
+): void {
+  useEventListener("onEventReceived", handler, deps);
+}
+
+/** Хук на сообщение чата (listener "message"). */
+export function useOnMessageReceived(
+  handler: (ev: CustomEvent<MessageEvent>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isMessageEvent(ev.detail)) handler(ev as CustomEvent<MessageEvent>);
+    },
+    deps,
+  );
+}
+
+/** Хук на нажатие кнопки виджета (event:test, widget-button). В detail.event.field — имя поля кнопки. */
+export function useOnWidgetButtonReceived(
+  handler: (ev: CustomEvent<WidgetButtonDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isWidgetButtonDetail(ev.detail))
+        handler(ev as CustomEvent<WidgetButtonDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт follower-latest. */
+export function useOnFollowerReceived(
+  handler: (ev: CustomEvent<FollowerDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isFollowerDetail(ev.detail))
+        handler(ev as CustomEvent<FollowerDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт communityGiftPurchase. */
+export function useOnCommunityGiftPurchaseReceived(
+  handler: (ev: CustomEvent<CommunityGiftPurchaseDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isCommunityGiftPurchaseDetail(ev.detail))
+        handler(ev as CustomEvent<CommunityGiftPurchaseDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт subscriber-latest. */
+export function useOnSubscriberLatestReceived(
+  handler: (ev: CustomEvent<SubscriberLatestDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isSubscriberLatestDetail(ev.detail))
+        handler(ev as CustomEvent<SubscriberLatestDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт subscriber (self / подарок / продление). */
+export function useOnSubscriberReceived(
+  handler: (ev: CustomEvent<SubscriberDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isSubscriberDetail(ev.detail))
+        handler(ev as CustomEvent<SubscriberDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт cheer-latest (биты). */
+export function useOnCheerReceived(
+  handler: (ev: CustomEvent<CheerDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isCheerDetail(ev.detail)) handler(ev as CustomEvent<CheerDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт raid-latest. */
+export function useOnRaidReceived(
+  handler: (ev: CustomEvent<RaidDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isRaidDetail(ev.detail)) handler(ev as CustomEvent<RaidDetail>);
+    },
+    deps,
+  );
+}
+
+/** Хук на алерт donation. */
+export function useOnDonationReceived(
+  handler: (ev: CustomEvent<DonationDetail>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onEventReceived",
+    function (this: Window, ev: WindowEventMap["onEventReceived"]) {
+      if (isDonationDetail(ev.detail))
+        handler(ev as CustomEvent<DonationDetail>);
+    },
+    deps,
+  );
+}

package/src/react/hooks/use-on-widget-load.ts

@@ -0,0 +1,15 @@
+import type { DependencyList } from "react";
+import type { WindowEventListener } from "../types/window-events.js";
+import type { OnWidgetLoadEventDetails } from "@/root/types/on-widget-load";
+import { useEventListener } from "./use-event-listener.js";
+
+export function useOnWidgetLoad(
+  handler: (ev: CustomEvent<OnWidgetLoadEventDetails>) => void,
+  deps: DependencyList = [],
+): void {
+  useEventListener(
+    "onWidgetLoad",
+    handler as WindowEventListener<"onWidgetLoad">,
+    deps,
+  );
+}

package/src/react/index.ts

@@ -0,0 +1,3 @@
+export * from "../root";
+export * from "./hooks";
+export * from "./types";

package/src/react/types/index.ts

@@ -0,0 +1 @@
+export * from "./window-events";

package/src/react/types/window-events.ts

@@ -0,0 +1,6 @@
+export type WindowEventKey = keyof WindowEventMap;
+
+export type WindowEventListener<K extends WindowEventKey> = (
+  this: Window,
+  ev: WindowEventMap[K],
+) => unknown;