@tixyel/streamelements 6.5.0 → 7.0.0

package/dist/index.d.ts

@@ -7,220 +7,297 @@
 import { ComfyJSInstance, OnErrorHandler, OnCommandHandler, OnChatHandler, OnWhisperHandler, OnMessageDeletedHandler, OnJoinHandler, OnPartHandler, OnHostedHandler, OnRaidHandler, OnSubHandler, OnResubHandler, OnSubGiftHandler, OnSubMysteryGiftHandler, OnGiftSubContinueHandler, OnCheerHandler, OnChatModeHandler, OnRewardHandler, OnConnectedHandler, OnReconnectHandler } from 'comfy.js';
 export { ComfyJSInstance } from 'comfy.js';
 
-declare namespace YoutubeEvents {
-    namespace Message {
-        export type Data = {
-            listener: 'message';
-            event: Event;
-        };
-        export type Event = {
-            service: 'youtube';
-            data: {
-                kind: string;
-                etag: string;
-                id: string;
-                snippet: {
-                    type: string;
-                    liveChatId: string;
-                    authorChannelId: string;
-                    publishedAt: string;
-                    hasDisplayContent: boolean;
-                    displayMessage: string;
-                    textMessageDetails: {
-                        messageText: string;
-                    };
-                };
-                authorDetails: {
-                    channelId: string;
-                    channelUrl: string;
-                    displayName: string;
-                    profileImageUrl: string;
-                    isVerified: boolean;
-                    isChatOwner: boolean;
-                    isChatSponsor: boolean;
-                    isChatModerator: boolean;
-                };
-                msgId: string;
-                userId: string;
-                nick: string;
-                badges: Array<Badges>;
-                displayName: string;
-                isAction: boolean;
-                time: number;
-                tags: Array<Tags>;
-                displayColor: string | null;
-                channel: string;
-                text: string;
-                avatar: string;
-                emotes: Array<Emotes>;
-            };
-            renderedText: string;
-        };
-        type Badges = {};
-        type Tags = {};
-        type Emotes = {};
-        export {};
-    }
-    namespace Superchat {
+type Provider$1 = 'twitch' | 'youtube' | 'kick' | 'facebook' | 'streamelements';
+type ClientEvents$1 = {
+    provider: 'streamelements';
+    data: StreamElements.Event.Provider.StreamElements.Events;
+} | {
+    provider: 'twitch';
+    data: StreamElements.Event.Provider.Twitch.Events;
+} | {
+    provider: 'youtube';
+    data: StreamElements.Event.Provider.YouTube.Events;
+} | {
+    provider: 'kick';
+    data: StreamElements.Event.Provider.Kick.Events;
+} | {
+    provider: 'facebook';
+    data: StreamElements.Event.Provider.Facebook.Events;
+};
+
+declare namespace StreamElementsEvents {
+    namespace Tip {
         type Data = {
-            listener: 'superchat-latest';
+            listener: 'tip-latest';
             event: Event;
         };
         type Event = {
             amount: number;
             avatar: string;
+            name: string;
             displayName: string;
             providerId: string;
-            name: string;
             _id: string;
             sessionTop: boolean;
-            type: 'superchat';
-            originalEventName: 'superchat-latest';
+            type: 'tip';
+            originalEventName: 'tip-latest';
         };
     }
-    namespace Subscriber {
+    namespace KVStore {
         type Data = {
-            listener: 'subscriber-latest';
+            listener: 'kvstore:update';
             event: Event;
         };
         type Event = {
-            avatar: string;
-            displayName: string;
-            providerId: string;
-            name: string;
-            _id: string;
-            sessionTop: boolean;
-            type: 'subscriber';
-            originalEventName: 'subscriber-latest';
+            data: {
+                key: `customWidget.${string}`;
+                value: string | number | boolean | Record<string, any>;
+            };
         };
     }
-    namespace Sponsor {
+    namespace BotCounter {
         type Data = {
-            listener: 'sponsor-latest';
+            listener: 'bot:counter';
             event: Event;
         };
-        type Event = common & (normal | gift | community | spam);
-        type common = {
-            amount: number;
-            name: string;
-            displayName: string;
-            message?: string;
-            providerId?: string;
-            avatar?: string;
-            sender?: string;
-            gifted?: boolean;
-            bulkGifted?: boolean;
-            isCommunityGift?: boolean;
-            _id?: string;
-            sessionTop?: boolean;
-            playedAsCommunityGift?: boolean;
-            type: 'sponsor';
-            originalEventName: 'sponsor-latest';
-        };
-        type normal = {
-            sender?: undefined;
-            gifted?: false;
-            bulkGifted?: false;
-            isCommunityGift?: false;
-        };
-        type gift = {
-            sender: string;
-            gifted: true;
-            bulkGifted?: false;
-            isCommunityGift?: false;
+        type Event = {
+            counter: string;
+            value: number;
         };
-        type community = {
-            message: string;
-            sender: string;
-            gifted?: false;
-            bulkGifted: true;
-            isCommunityGift?: false;
+    }
+    namespace AlertService {
+        type Data = {
+            listener: 'alertService:toggleSound';
+            event: Event;
         };
-        type spam = {
-            sender: string;
-            gifted: true;
-            bulkGifted?: false;
-            isCommunityGift: true;
+        type Event = {
+            muted: boolean;
         };
     }
-    interface BaseEvent {
-        provider: 'youtube';
-        flagged: boolean;
-        channel: string;
-        createdAt: string;
-        _id: string;
-        expiresAt: string;
-        updatedAt: string;
-        activityId: string;
-        sessionEventsCount: number;
-        isMock?: boolean;
-    }
-    namespace Event {
+    namespace EventSkip {
         type Data = {
-            listener: 'event';
+            listener: 'event:skip';
             event: Event;
         };
-        type Event = Superchat | Subscriber | Sponsor | CommunityGiftedSponsor;
-        interface Superchat extends BaseEvent {
-            type: 'superchat';
-            data: {
-                amount: string;
-                username: string;
-                message: string;
-                avatar: string;
-                providerId: string;
-            };
-        }
-        interface Subscriber extends BaseEvent {
-            type: 'subscriber';
-            data: {
-                avatar: string;
-                displayName: string;
-                username: string;
-                providerId: string;
-            };
-        }
-        interface Sponsor extends BaseEvent {
-            type: 'sponsor';
-            data: FirstTimeSponsor | Resubscribe | GiftedSponsor;
-        }
-        type FirstTimeSponsor = {
-            amount: number;
-            username: string;
-            displayName: string;
-            providerId: string;
-            avatar: string;
+        type Event = {};
+    }
+    namespace EventTest {
+        export type Data = {
+            listener: 'event:test';
+            event: Event;
         };
-        type Resubscribe = {
-            amount: number;
-            username: string;
-            displayName: string;
-            providerId: string;
-            avatar: string;
+        export type Event = widgetButton | emulatedEvents<EventType> | Session;
+        type items = {
+            name: string;
+            price: number;
+            quantity: number;
         };
-        type GiftedSponsor = {
-            amount: number;
-            username: string;
-            displayName: string;
-            providerId: string;
-            sender: string;
-            gifted: true;
-            avatar: string;
+        type widgetButton = {
+            listener: 'widget-button';
+            field: string;
+            value: string | number | boolean;
         };
-        interface CommunityGiftedSponsor extends BaseEvent {
-            type: 'communityGiftPurchase';
-            data: {
+        type EventType = 'follower' | 'subscriber' | 'tip' | 'cheer' | 'raid';
+        type EventTier = 'prime' | '1000' | '2000' | '3000';
+        type emulatedEvents<T extends EventType> = {
+            listener: `${T}-latest`;
+            event: {
+                type: T;
+                name: string;
                 amount: number;
-                username: string;
-                displayName: string;
-                providerId: string;
-                avatar: string;
+                count: number;
+                message?: string;
+                gifted?: boolean;
+                bulkGifted?: boolean;
+                sender?: string;
+                subExtension?: boolean;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
             };
-        }
-    }
-}
-
+        };
+        type Session = SessionCount | SessionTotal | SessionTop | SessionGoal | SessionRecent | SessionPoints;
+        type SessionCount = {
+            listener: `${EventType}-count`;
+            event: {
+                type: EventType;
+                name: string;
+                count: number;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
+            };
+        };
+        type SessionTotal = {
+            listener: `${EventType}-total`;
+            event: {
+                type: EventType;
+                name: string;
+                amount: number;
+                count: number;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
+            };
+        };
+        type SessionTop = {
+            listener: `${EventType}-top`;
+            event: {
+                type: EventType;
+                name: string;
+                amount: number;
+                count: number;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
+            };
+        };
+        type SessionGoal = {
+            listener: `${EventType}-goal`;
+            event: {
+                type: EventType;
+                name: string;
+                amount: number;
+                count: number;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
+            };
+        };
+        type SessionRecent = {
+            listener: `${EventType}-recent`;
+            event: {
+                event: SessionRecentEvent[];
+            };
+        };
+        type SessionRecentEvent = {
+            type: EventType;
+            name: string;
+            amount: number;
+            count: number;
+            tier: EventTier;
+            isTest: true;
+        };
+        type SessionPoints = {
+            listener: `${EventType}-points`;
+            event: {
+                type: EventType;
+                name: string;
+                amount: number;
+                count: number;
+                items: items[];
+                tier: EventTier;
+                month: string;
+                isTest: true;
+            };
+        };
+        export {};
+    }
+    interface BaseEvent {
+        provider: Provider$1;
+        flagged: boolean;
+        channel: string;
+        createdAt: string;
+        _id: string;
+        expiresAt: string;
+        updatedAt: string;
+        activityId: string;
+        sessionEventsCount: number;
+        isMock?: boolean;
+    }
+    namespace Event {
+        type Data = {
+            listener: 'event';
+            event: Event;
+        };
+        type Event = Tip;
+        interface Tip extends BaseEvent {
+            type: 'tip';
+            data: {
+                amount: string;
+                currency: string;
+                username: string;
+                message: string;
+                avatar: string;
+            };
+        }
+    }
+}
+
+type TwitchEmote = {
+    type: 'twitch';
+    name: string;
+    id: string;
+    gif: boolean;
+    urls: {
+        '1': string;
+        '2': string;
+        '4': string;
+    };
+    start: number;
+    end: number;
+};
+type FfzEmote = {
+    type: 'ffz';
+    id: string;
+    name: string;
+    gif: boolean;
+    animated: boolean;
+    urls: {
+        '1': string;
+        '2': string;
+        '4': string;
+    };
+    start: number;
+    end: number;
+};
+type SeventvEmote = {
+    type: '7tv';
+    name: string;
+    id: string;
+    gif: boolean;
+    animated: boolean;
+    urls: {
+        '1': string;
+        '2': string;
+        '3': string;
+        '4': string;
+    };
+    start: number;
+    end: number;
+};
+type BttvEmote = {
+    type: 'bttv';
+    name: string;
+    id: string;
+    gif: boolean;
+    animated: boolean;
+    urls: {
+        '1': string;
+        '2': string;
+        '4': string;
+    };
+    start: number;
+    end: number;
+};
+type Emoji = {
+    type: 'emoji';
+    name: string;
+    id: string;
+    gif: boolean;
+    urls: {
+        '1': string;
+    };
+};
+type Emote = TwitchEmote | BttvEmote | SeventvEmote | FfzEmote | Emoji;
+
 type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+type NumberAsString = string;
 type MapNumberValuesToString<T> = {
     [K in keyof T]: T[K] extends number ? `${T[K]}` | ReturnType<T[K]['toString']> : T[K];
 };
@@ -235,7 +312,7 @@ declare namespace Twitch {
          * 'subscriber/25'
          * ```
          */
-        'badge-info': String;
+        'badge-info': string;
         /**
          * Comma-separated list of chat badges in the form, <badge>/<version>. For example admin/1. There are many possible badge values, but here are few: admin, bits, broadcaster, moderator, subscriber, staff, turbo
          * Most badges have only 1 version, but some badges like subscriber badges offer different versions of the badge depending on how long the user has subscribed.
@@ -244,7 +321,7 @@ declare namespace Twitch {
          * 'staff/1,bits/1000,partner/1'
          * ```
          */
-        'badges': String;
+        badges: string;
         /**
          * The color of the user's name in the chat.
          * @example
@@ -252,7 +329,7 @@ declare namespace Twitch {
          * '#FF0000'
          * ```
          */
-        'color': string | undefined;
+        color: string | undefined;
         /**
          * The user’s display name, escaped as described in the [IRCv3 spec](https://ircv3.net/specs/extensions/message-tags.html). This tag may be empty if it is never set.
          * @example
@@ -260,11 +337,11 @@ declare namespace Twitch {
          * 'TwitchUser'
          * ```
          */
-        'display-name': String;
+        'display-name': string;
         /**
          * A comma-delimited list of IDs that identify the emote sets that the user has access to. Is always set to at least zero (0).
          */
-        'emote-sets': String;
+        'emote-sets': string;
         /**
          * A slash-delimited list of emotes and their positions in the message. Each emote is in the form, `<emote ID>:<ranges>`, where ranges are comma-delimited pairs of indices in the form `<start position>-<end position>`. The position indices are zero-based.
          * NOTE: It’s possible for a message to begin with with `\001ACTION` when /me is used by a user in chat. In these cases emote positions should be considered to begin after `001ACTION `, which includes its succeeding whitespace.
@@ -273,12 +350,12 @@ declare namespace Twitch {
          * '25:0-4,12-16/1902:6-10'
          * ```
          */
-        'emotes': String;
-        'flags': String;
+        emotes: string;
+        flags: string;
         /**
          * A Boolean value that indicates whether the user has site-wide commercial free mode enabled. Is true (1) if enabled; otherwise, false (0).
          */
-        'turbo': 0 | 1;
+        turbo: 0 | 1;
         /**
          * The User ID of the relevant user.
          * @example
@@ -286,25 +363,26 @@ declare namespace Twitch {
          * '1337'
          * ```
          */
-        'user-id': String;
+        'user-id': string;
         /**
          * The type of user. Possible values are:
          * ```
          *  • "" - A normal user
+         *  • mod - A channel moderator
          *  • admin - A Twitch administrator
          *  • global_mod - A global moderator
          *  • staff - A Twitch employee
          * ```
          */
-        'user-type': '' | 'admin' | 'global_mod' | 'staff';
+        'user-type': '' | 'mod' | 'admin' | 'global_mod' | 'staff';
         /**
          * The amount of Bits the user cheered. Only a Bits cheer message includes this tag.
          */
-        'bits': number;
+        bits: number;
         /**
          * A Boolean value that determines whether the user is a moderator. Is true (1) if the user is a moderator; otherwise, false (0).
          */
-        'mod': 0 | 1;
+        mod: 0 | 1;
         /**
          * The ID of the message. In UUID format.
          */
@@ -340,19 +418,19 @@ declare namespace Twitch {
         /**
          * An ID that identifies the chat room (channel).
          */
-        'room-id': String;
+        'room-id': string;
         /**
          * Comma-separated list of chat badges for the chatter in the room the message was sent from. This uses the same format as the `badges` tag.
          */
-        'source-badges': String;
+        'source-badges': string;
         /**
          * Contains metadata related to the chat badges in the source-badges tag.
          */
-        'source-badge-info': String;
+        'source-badge-info': string;
         /**
          * A UUID that identifies the source message from the channel the message was sent from.
          */
-        'source-id': String;
+        'source-id': string;
         /**
          * A Boolean that indicates if a message sent during a shared chat session is only sent to the source channel. Has no effect if the message is not sent during a shared chat session.
          */
@@ -360,11 +438,11 @@ declare namespace Twitch {
         /**
          * An ID that identifies the chat room (channel) the message was sent from.
          */
-        'source-room-id': String;
+        'source-room-id': string;
         /**
          * A Boolean value that determines whether the user is a subscriber. Is true (1) if the user is a subscriber; otherwise, false (0).
          */
-        'subscriber': 0 | 1;
+        subscriber: 0 | 1;
         /**
          * The UNIX timestamp.
          */
@@ -372,7 +450,18 @@ declare namespace Twitch {
         /**
          * A Boolean value that determines whether the user that sent the chat is a VIP. The message includes this tag if the user is a VIP; otherwise, the message doesn’t include this tag (check for the presence of the tag instead of whether the tag is set to true or false).
          */
-        'vip': undefined | '';
+        vip: undefined | '';
+    };
+    type Reply = {
+        msgId: string;
+        userId: string;
+        userLogin: string;
+        displayName: string;
+        msgBody: string;
+    };
+    type Thread = {
+        parentMsgId: string;
+        parentUserLogin: string;
     };
     type badge = {
         type: string;
@@ -380,7 +469,20 @@ declare namespace Twitch {
         url: string;
         description: string;
     };
-    type roles = '100 bits' | 'no audio' | 'no video' | 'bot' | 'twitch staff' | 'admins' | 'artist' | 'game developer' | 'prime' | 'turbo' | 'subscriber' | 'broadcaster' | 'verified' | 'moderator' | 'vip';
+    type GlobalBadge = {
+        set_id: tags;
+        versions: Array<{
+            id: string;
+            image_url_1x: string;
+            image_url_2x: string;
+            image_url_4x: string;
+            title: string;
+            description: string;
+            click_action: string | null;
+            click_url: string | null;
+        }>;
+    };
+    type tags = 'qsmp2' | 'jasontheween-7-day-survival' | 'support-a-streamer-ho26-badge' | 'twitch-recap-2025' | 'ugly-sweater' | 'fright-fest-2025' | 'gamerduo' | 'video-games-day' | 'twitch-intern-2022' | 'touch-grass' | 'twitchcon-referral-program-2025-chrome-star' | 'twitchcon-referral-program-2025-bleedpurple' | 'share-the-love' | 'gone-bananas' | 'twitchcon-2025---rotterdam' | 'clip-the-halls' | 'twitch-recap-2024' | 'subtember-2024' | 'twitch-intern-2024' | 'twitch-dj' | 'destiny-2-the-final-shape-streamer' | 'destiny-2-final-shape-raid-race' | 'twitchcon-2024---san-diego' | 'minecraft-15th-anniversary-celebration' | 'warcraft' | 'vip' | 'vga-champ-2017' | 'tyranny_1' | 'twitchconNA2023' | 'twitchconNA2020' | 'twitchconNA2022' | 'twitchconNA2019' | 'twitchconEU2023' | 'twitchconEU2022' | 'twitchcon2018' | 'twitchconAmsterdam2020' | 'twitchconEU2019' | 'twitchbot' | 'twitchcon2017' | 'twitchcon-2024---rotterdam' | 'twitch-recap-2023' | 'twitch-intern-2023' | 'treasure-adventure-world_1' | 'titan-souls_1' | 'this-war-of-mine_1' | 'the-surge_2' | 'the-surge_1' | 'the-surge_3' | 'the-golden-predictor-of-the-game-awards-2023' | 'the-game-awards-2023' | 'superhot_1' | 'strafe_1' | 'streamer-awards-2024' | 'starbound_1' | 'staff' | 'samusoffer_beta' | 'rplace-2023' | 'rift_1' | 'raiden-v-directors-cut_1' | 'psychonauts_1' | 'premium' | 'overwatch-league-insider_2019B' | 'partner' | 'overwatch-league-insider_2019A' | 'okhlos_1' | 'overwatch-league-insider_2018B' | 'overwatch-league-insider_1' | 'kingdom-new-lands_1' | 'jackbox-party-pack_1' | 'innerspace_2' | 'innerspace_1' | 'hype-train' | 'hello_neighbor_1' | 'gold-pixel-heart' | 'heavy-bullets_1' | 'glitchcon2020' | 'glhf-pledge' | 'getting-over-it_2' | 'getting-over-it_1' | 'frozen-synapse_1' | 'founder' | 'frozen-cortext_1' | 'firewatch_1' | 'enter-the-gungeon_1' | 'duelyst_5' | 'duelyst_6' | 'duelyst_7' | 'duelyst_2' | 'duelyst_4' | 'duelyst_3' | 'duelyst_1' | 'devilian_1' | 'devil-may-cry-hd_4' | 'devil-may-cry-hd_3' | 'devil-may-cry-hd_2' | 'devil-may-cry-hd_1' | 'deceit_1' | 'darkest-dungeon_1' | 'cuphead_1' | 'clip-champ' | 'broken-age_1' | 'bubsy-the-woolies_1' | 'bits-leader' | 'brawlhalla_1' | 'bits' | 'bits-charity' | 'battlechefbrigade_3' | 'battlerite_1' | 'battlechefbrigade_2' | 'battlechefbrigade_1' | 'axiom-verge_1' | 'anomaly-2_1' | 'anomaly-warzone-earth_1' | 'ambassador' | 'H1Z1_1' | '60-seconds_3' | '60-seconds_2' | '60-seconds_1' | '1979-revolution_1' | '10-years-as-twitch-staff' | '15-years-as-twitch-staff' | '5-years-as-twitch-staff' | 'aang' | 'admin' | 'alone' | 'anonymous-cheerer' | 'arc-raiders-launch-2025' | 'arcane-season-2-premiere' | 'artist-badge' | 'battlefield-6' | 'bingbonglove' | 'black-ops-7-global-launch' | 'borderlands-4-badge---ripper' | 'borderlands-4-badge---vault-symbol' | 'bot-badge' | 'broadcaster' | 'bungie-foundation-ally' | 'bungie-foundation-supporter' | 'chatter-cs-go-2022' | 'clips-leader' | 'creator-cs-go-2022' | 'crimson-butterfly' | 'diablo-30th-anniversary' | 'diana' | 'ditto' | 'dragonscimmy' | 'dreamcon-2024' | 'elden-ring-recluse' | 'elden-ring-wylder' | 'eso_1' | 'evo-2025' | 'extension' | 'fallout-season-2-ghoul' | 'first-stand-2026-supporter' | 'first-stand-2026-viewer' | 'fischer' | 'frog-lantern' | 'game-developer' | 'gears-of-war-superfan-badge' | 'gingko-leaf' | 'global_mod' | 'gold-pixel-heart---together-for-good-24' | 'gp-explorer-3' | 'hornet' | 'hunt-crosses' | 'hypershot-celestial' | 'jeff-the-land-shark' | 'k4sen-con-2025' | 'kodama' | 'la-velada-iv' | 'la-velada-v-badge' | 'lamby' | 'lead_moderator' | 'league-of-legends-mid-season-invitational-2025---grey' | 'league-of-legends-mid-season-invitational-2025---purple' | 'legendus' | 'lol-worlds-2025' | 'lost-ark-anniversary' | 'low' | 'marathon-reveal-runner' | 'marathon-silkworm' | 'marathon-sub-burger' | 'mel' | 'moderator' | 'moments' | 'mr-raccoon' | 'never-grave---witch-hat' | 'no_audio' | 'no_video' | 'path-of-exile-2-badge' | 'pokemon-30th-anniversary' | 'pokemon-legends-z-a-chikorita' | 'pokemon-legends-z-a-tepig' | 'pokemon-legends-z-a-totodile' | 'power-rangers' | 'predictions' | 'purple-noob' | 'purple-pixel-heart---together-for-good-24' | 'raging-wolf-helm' | 'raider-icon-badge' | 'rainbow-six-siege-x-10th-anniversary' | 'revedtv-stream-awards-2025' | 'ruby-pixel-heart---together-for-good-24' | 'rudy' | 'rustmas-2025' | 'sajam-slam-badge' | 'scampuss' | 'seeks-eye' | 'social-sharing' | 'sonic-racing-crossworlds' | 'speedons-5-badge' | 'stream-for-humanity-2-2025' | 'streamer-awards-tux' | 'sub-gift-leader' | 'sub-gifter' | 'subscriber' | 'subtember-2025' | 'superultracombo-2023' | 'survival-cup-4' | 'tft-paris-open' | 'the-deer' | 'the-first-descendant-badge' | 'the-man-without-fear' | 'the-onryos-mask' | 'together-for-good-25---good-badge' | 'together-for-good-25---gooder-badge' | 'together-for-good-25---goodest-badge' | 'together-for-good-25---wicked-dub-badge' | 'total-war-anniversary' | 'toxic-zombie' | 'turbo' | 'twitchcon-2026-europe-row-houses' | 'twitchcon-2026-europe-windmill' | 'umbrella-corporation' | 'user-anniversary' | 'vct-paris-2025' | 'yellow-noob' | 'zevent-2024' | 'zevent25';
 }
 
 declare namespace TwitchEvents {
@@ -394,11 +496,23 @@ declare namespace TwitchEvents {
             data: {
                 time: number;
                 tags: Partial<MapNumberValuesToString<Twitch.IRC>> & {
+                    'badge-info': string;
+                    'badges': string;
                     'client-nonce': string;
+                    'color': string;
+                    'display-name': string;
+                    'emotes': string;
+                    'first-msg': '1' | '0';
                     'flags': string;
                     'id': string;
-                    'first-msg': '1' | '0';
+                    'mod': '1' | '0';
                     'returning-chatter': '1' | '0';
+                    'room-id': string;
+                    'subscriber': '1' | '0';
+                    'tmi-sent-ts': string;
+                    'turbo': '1' | '0';
+                    'user-id': string;
+                    'user-type': '' | 'mod' | 'admin' | 'global_mod' | 'staff';
                 };
                 nick: string;
                 displayName: string;
@@ -419,19 +533,6 @@ declare namespace TwitchEvents {
             description: string;
             url: string;
         };
-        type Emote = {
-            type: string;
-            name: string;
-            id: string;
-            gif: boolean;
-            urls: {
-                '1': string;
-                '2': string;
-                '4': string;
-            };
-            start: number;
-            end: number;
-        };
         export {};
     }
     namespace DeleteMessage {
@@ -659,65 +760,278 @@ declare namespace TwitchEvents {
     }
 }
 
-declare namespace StreamElements {
-    namespace CustomField {
-        type Types = 'button' | 'number' | 'slider' | 'text' | 'hidden' | 'checkbox' | 'dropdown' | 'colorpicker' | 'googleFont' | 'video-input' | 'image-input' | 'sound-input';
-        type Schema = {
-            type: Types;
-            label: string;
-            value?: string | number | boolean;
-            group?: string;
-            min?: number | string;
-            max?: number | string;
-            step?: number | string;
-            options?: Record<string, string>;
-            multiple?: boolean;
-        };
-        type Value = string | number | boolean | undefined;
-    }
-    type SE_API = {
-        responses: Record<string, any>;
-        sendMessage: (message: string, data: object) => void;
-        counters: {
-            get: (key: string) => number | null;
-        };
-        store: {
-            get: <T>(key: string) => Promise<T | null>;
-            set: <T>(key: string, value: T) => void;
-        };
-        resumeQueue: () => void;
-        sanitize: (message: string) => string;
-        cheerFilter: (message: string) => string;
-        setField: (key: string, value: string | number | boolean | undefined, reload: boolean) => void;
-        getOverlayStatus: () => {
-            isEditorMode: boolean;
-            muted: boolean;
+declare namespace YoutubeEvents {
+    namespace Message {
+        export type Data = {
+            listener: 'message';
+            event: Event;
         };
-    };
-    namespace Event {
-        type onWidgetLoad = {
-            channel: {
-                username: string;
-                /**
-                 * The channel's streamelements api token (used to authenticate requests to the SE API)
-                 */
-                apiToken: string;
-                /**
-                 * The channel's unique identifier in the SE system
-                 */
+        export type Event = {
+            service: 'youtube';
+            data: {
+                kind: string;
+                etag: string;
                 id: string;
-                /**
-                 * The channel's unique identifier from the provider (e.g. Twitch user ID)
-                 */
-                providerId: string;
-                avatar: string;
-            };
-            currency: {
-                code: string;
-                name: string;
-                symbol: string;
-            };
-            fieldData: Record<string, StreamElements.CustomField.Value>;
+                snippet: {
+                    type: string;
+                    liveChatId: string;
+                    authorChannelId: string;
+                    publishedAt: string;
+                    hasDisplayContent: boolean;
+                    displayMessage: string;
+                    textMessageDetails: {
+                        messageText: string;
+                    };
+                };
+                authorDetails: {
+                    channelId: string;
+                    channelUrl: string;
+                    displayName: string;
+                    profileImageUrl: string;
+                    isVerified: boolean;
+                    isChatOwner: boolean;
+                    isChatSponsor: boolean;
+                    isChatModerator: boolean;
+                };
+                msgId: string;
+                userId: string;
+                nick: string;
+                badges: Array<Badges>;
+                displayName: string;
+                isAction: boolean;
+                time: number;
+                tags: Array<Tags>;
+                displayColor: string | null;
+                channel: string;
+                text: string;
+                avatar: string;
+                emotes: Array<Emotes>;
+            };
+            renderedText: string;
+        };
+        type Badges = {};
+        type Tags = {};
+        type Emotes = {};
+        export {};
+    }
+    namespace Superchat {
+        type Data = {
+            listener: 'superchat-latest';
+            event: Event;
+        };
+        type Event = {
+            amount: number;
+            avatar: string;
+            displayName: string;
+            providerId: string;
+            name: string;
+            _id: string;
+            sessionTop: boolean;
+            type: 'superchat';
+            originalEventName: 'superchat-latest';
+        };
+    }
+    namespace Subscriber {
+        type Data = {
+            listener: 'subscriber-latest';
+            event: Event;
+        };
+        type Event = {
+            avatar: string;
+            displayName: string;
+            providerId: string;
+            name: string;
+            _id: string;
+            sessionTop: boolean;
+            type: 'subscriber';
+            originalEventName: 'subscriber-latest';
+        };
+    }
+    namespace Sponsor {
+        type Data = {
+            listener: 'sponsor-latest';
+            event: Event;
+        };
+        type Event = common & (normal | gift | community | spam);
+        type common = {
+            amount: number;
+            name: string;
+            displayName: string;
+            message?: string;
+            providerId?: string;
+            avatar?: string;
+            sender?: string;
+            gifted?: boolean;
+            bulkGifted?: boolean;
+            isCommunityGift?: boolean;
+            _id?: string;
+            sessionTop?: boolean;
+            playedAsCommunityGift?: boolean;
+            type: 'sponsor';
+            originalEventName: 'sponsor-latest';
+        };
+        type normal = {
+            sender?: undefined;
+            gifted?: false;
+            bulkGifted?: false;
+            isCommunityGift?: false;
+        };
+        type gift = {
+            sender: string;
+            gifted: true;
+            bulkGifted?: false;
+            isCommunityGift?: false;
+        };
+        type community = {
+            message: string;
+            sender: string;
+            gifted?: false;
+            bulkGifted: true;
+            isCommunityGift?: false;
+        };
+        type spam = {
+            sender: string;
+            gifted: true;
+            bulkGifted?: false;
+            isCommunityGift: true;
+        };
+    }
+    interface BaseEvent {
+        provider: 'youtube';
+        flagged: boolean;
+        channel: string;
+        createdAt: string;
+        _id: string;
+        expiresAt: string;
+        updatedAt: string;
+        activityId: string;
+        sessionEventsCount: number;
+        isMock?: boolean;
+    }
+    namespace Event {
+        type Data = {
+            listener: 'event';
+            event: Event;
+        };
+        type Event = Superchat | Subscriber | Sponsor | CommunityGiftedSponsor;
+        interface Superchat extends BaseEvent {
+            type: 'superchat';
+            data: {
+                amount: string;
+                username: string;
+                message: string;
+                avatar: string;
+                providerId: string;
+            };
+        }
+        interface Subscriber extends BaseEvent {
+            type: 'subscriber';
+            data: {
+                avatar: string;
+                displayName: string;
+                username: string;
+                providerId: string;
+            };
+        }
+        interface Sponsor extends BaseEvent {
+            type: 'sponsor';
+            data: FirstTimeSponsor | Resubscribe | GiftedSponsor;
+        }
+        type FirstTimeSponsor = {
+            amount: number;
+            username: string;
+            displayName: string;
+            providerId: string;
+            avatar: string;
+        };
+        type Resubscribe = {
+            amount: number;
+            username: string;
+            displayName: string;
+            providerId: string;
+            avatar: string;
+        };
+        type GiftedSponsor = {
+            amount: number;
+            username: string;
+            displayName: string;
+            providerId: string;
+            sender: string;
+            gifted: true;
+            avatar: string;
+        };
+        interface CommunityGiftedSponsor extends BaseEvent {
+            type: 'communityGiftPurchase';
+            data: {
+                amount: number;
+                username: string;
+                displayName: string;
+                providerId: string;
+                avatar: string;
+            };
+        }
+    }
+}
+
+declare namespace StreamElements {
+    namespace CustomField {
+        type Types = 'button' | 'number' | 'slider' | 'text' | 'hidden' | 'checkbox' | 'dropdown' | 'colorpicker' | 'googleFont' | 'video-input' | 'image-input' | 'sound-input';
+        type Schema = {
+            type: Types;
+            label: string;
+            value?: string | number | boolean;
+            group?: string;
+            min?: number | string;
+            max?: number | string;
+            step?: number | string;
+            options?: Record<string, string>;
+            multiple?: boolean;
+        };
+        type Value = string | number | boolean | undefined;
+    }
+    type SE_API = {
+        responses: Record<string, any>;
+        sendMessage: (message: string, data: object) => void;
+        counters: {
+            get: (key: string) => number | null;
+        };
+        store: {
+            get: <T>(key: string) => Promise<T | null>;
+            set: <T>(key: string, value: T) => void;
+        };
+        resumeQueue: () => void;
+        sanitize: (message: string) => string;
+        cheerFilter: (message: string) => string;
+        setField: (key: string, value: string | number | boolean | undefined, reload: boolean) => void;
+        getOverlayStatus: () => {
+            isEditorMode: boolean;
+            muted: boolean;
+        };
+    };
+    namespace Event {
+        type onWidgetLoad = {
+            channel: {
+                username: string;
+                /**
+                 * The channel's streamelements api token (used to authenticate requests to the SE API)
+                 */
+                apiToken: string;
+                /**
+                 * The channel's unique identifier in the SE system
+                 */
+                id: string;
+                /**
+                 * The channel's unique identifier from the provider (e.g. Twitch user ID)
+                 */
+                providerId: string;
+                avatar: string;
+            };
+            currency: {
+                code: string;
+                name: string;
+                symbol: string;
+            };
+            fieldData: Record<string, StreamElements.CustomField.Value>;
             recents: Array<Object>;
             session: {
                 data: StreamElements.Session.Data;
@@ -1277,1454 +1591,1524 @@ declare namespace StreamElements {
                 name: string;
                 amount: number;
             };
-            'tip-session-top-donator': {
-                name: string;
-                amount: number;
-            };
-            'tip-weekly-top-donator': {
-                name: string;
-                amount: number;
-            };
-            'tip-monthly-top-donator': {
-                name: string;
-                amount: number;
-            };
-            'tip-alltime-top-donator': {
-                name: string;
-                amount: number;
-            };
-            'tip-session': {
-                amount: number;
-            };
-            'tip-week': {
-                amount: number;
-            };
-            'tip-month': {
-                amount: number;
-            };
-            'tip-total': {
-                amount: number;
-            };
-            'tip-count': {
-                count: number;
-            };
-            'tip-goal': {
-                amount: number;
-            };
-            'tip-recent': {
-                name: string;
-                amount: number;
-                createdAt: string;
-            }[];
-        }
-        interface Merch {
-            'merch-latest': {
-                name: string;
-                amount: number;
-                items: any[];
-            };
-            'merch-goal-orders': {
-                amount: number;
-            };
-            'merch-goal-items': {
-                amount: number;
-            };
-            'merch-goal-total': {
-                amount: number;
-            };
-            'merch-recent': {
-                name: string;
-            }[];
-        }
-        interface Purchase {
-            'purchase-latest': {
-                name: string;
-                amount: number;
-                items: any[];
-                avatar: string;
-                message: string;
-            };
-        }
-    }
-}
-
-type Provider$1 = 'twitch' | 'youtube' | 'kick' | 'facebook' | 'streamelements';
-type ClientEvents$1 = {
-    provider: 'streamelements';
-    data: StreamElements.Event.Provider.StreamElements.Events;
-} | {
-    provider: 'twitch';
-    data: StreamElements.Event.Provider.Twitch.Events;
-} | {
-    provider: 'youtube';
-    data: StreamElements.Event.Provider.YouTube.Events;
-} | {
-    provider: 'kick';
-    data: StreamElements.Event.Provider.Kick.Events;
-} | {
-    provider: 'facebook';
-    data: StreamElements.Event.Provider.Facebook.Events;
-};
-
-declare namespace StreamElementsEvents {
-    namespace Tip {
-        type Data = {
-            listener: 'tip-latest';
-            event: Event;
-        };
-        type Event = {
-            amount: number;
-            avatar: string;
-            name: string;
-            displayName: string;
-            providerId: string;
-            _id: string;
-            sessionTop: boolean;
-            type: 'tip';
-            originalEventName: 'tip-latest';
-        };
-    }
-    namespace KVStore {
-        type Data = {
-            listener: 'kvstore:update';
-            event: Event;
-        };
-        type Event = {
-            data: {
-                key: `customWidget.${string}`;
-                value: string | number | boolean | Record<string, any>;
-            };
-        };
-    }
-    namespace BotCounter {
-        type Data = {
-            listener: 'bot:counter';
-            event: Event;
-        };
-        type Event = {
-            counter: string;
-            value: number;
-        };
-    }
-    namespace AlertService {
-        type Data = {
-            listener: 'alertService:toggleSound';
-            event: Event;
-        };
-        type Event = {
-            muted: boolean;
-        };
-    }
-    namespace EventSkip {
-        type Data = {
-            listener: 'event:skip';
-            event: Event;
-        };
-        type Event = {};
-    }
-    namespace EventTest {
-        export type Data = {
-            listener: 'event:test';
-            event: Event;
-        };
-        export type Event = widgetButton | emulatedEvents<EventType> | Session;
-        type items = {
-            name: string;
-            price: number;
-            quantity: number;
-        };
-        type widgetButton = {
-            listener: 'widget-button';
-            field: string;
-            value: string | number | boolean;
-        };
-        type EventType = 'follower' | 'subscriber' | 'tip' | 'cheer' | 'raid';
-        type EventTier = 'prime' | '1000' | '2000' | '3000';
-        type emulatedEvents<T extends EventType> = {
-            listener: `${T}-latest`;
-            event: {
-                type: T;
-                name: string;
-                amount: number;
-                count: number;
-                message?: string;
-                gifted?: boolean;
-                bulkGifted?: boolean;
-                sender?: string;
-                subExtension?: boolean;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
-            };
-        };
-        type Session = SessionCount | SessionTotal | SessionTop | SessionGoal | SessionRecent | SessionPoints;
-        type SessionCount = {
-            listener: `${EventType}-count`;
-            event: {
-                type: EventType;
+            'tip-session-top-donator': {
                 name: string;
-                count: number;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
+                amount: number;
             };
-        };
-        type SessionTotal = {
-            listener: `${EventType}-total`;
-            event: {
-                type: EventType;
+            'tip-weekly-top-donator': {
                 name: string;
                 amount: number;
-                count: number;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
             };
-        };
-        type SessionTop = {
-            listener: `${EventType}-top`;
-            event: {
-                type: EventType;
+            'tip-monthly-top-donator': {
                 name: string;
                 amount: number;
-                count: number;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
             };
-        };
-        type SessionGoal = {
-            listener: `${EventType}-goal`;
-            event: {
-                type: EventType;
+            'tip-alltime-top-donator': {
                 name: string;
                 amount: number;
+            };
+            'tip-session': {
+                amount: number;
+            };
+            'tip-week': {
+                amount: number;
+            };
+            'tip-month': {
+                amount: number;
+            };
+            'tip-total': {
+                amount: number;
+            };
+            'tip-count': {
                 count: number;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
             };
-        };
-        type SessionRecent = {
-            listener: `${EventType}-recent`;
-            event: {
-                event: SessionRecentEvent[];
+            'tip-goal': {
+                amount: number;
             };
-        };
-        type SessionRecentEvent = {
-            type: EventType;
-            name: string;
-            amount: number;
-            count: number;
-            tier: EventTier;
-            isTest: true;
-        };
-        type SessionPoints = {
-            listener: `${EventType}-points`;
-            event: {
-                type: EventType;
+            'tip-recent': {
                 name: string;
                 amount: number;
-                count: number;
-                items: items[];
-                tier: EventTier;
-                month: string;
-                isTest: true;
+                createdAt: string;
+            }[];
+        }
+        interface Merch {
+            'merch-latest': {
+                name: string;
+                amount: number;
+                items: any[];
             };
-        };
-        export {};
-    }
-    interface BaseEvent {
-        provider: Provider$1;
-        flagged: boolean;
-        channel: string;
-        createdAt: string;
-        _id: string;
-        expiresAt: string;
-        updatedAt: string;
-        activityId: string;
-        sessionEventsCount: number;
-        isMock?: boolean;
-    }
-    namespace Event {
-        type Data = {
-            listener: 'event';
-            event: Event;
-        };
-        type Event = Tip;
-        interface Tip extends BaseEvent {
-            type: 'tip';
-            data: {
-                amount: string;
-                currency: string;
-                username: string;
-                message: string;
+            'merch-goal-orders': {
+                amount: number;
+            };
+            'merch-goal-items': {
+                amount: number;
+            };
+            'merch-goal-total': {
+                amount: number;
+            };
+            'merch-recent': {
+                name: string;
+            }[];
+        }
+        interface Purchase {
+            'purchase-latest': {
+                name: string;
+                amount: number;
+                items: any[];
                 avatar: string;
+                message: string;
             };
         }
     }
 }
 
-type TwitchEmote = {
-    type: 'twitch';
-    name: string;
-    id: string;
-    gif: boolean;
-    urls: {
-        '1': string;
-        '2': string;
-        '4': string;
-    };
-    start: number;
-    end: number;
+interface CommandOptions {
+    prefix?: string;
+    name: string;
+    description?: string;
+    arguments?: boolean;
+    run: (this: Client, args: string[], event: CommandEvent) => void;
+    test?: string;
+    aliases?: string[];
+    permissions?: string[] | boolean;
+    admins?: string[];
+}
+type CommandEvent = {
+    provider: 'twitch';
+    data: StreamElements.Event.Provider.Twitch.Message;
+} | {
+    provider: 'youtube';
+    data: StreamElements.Event.Provider.YouTube.Message;
+} | {
+    provider: 'kick';
+    data: any;
+};
+declare class Command {
+    prefix: string;
+    name: string;
+    description: string;
+    arguments: boolean;
+    test: string | (() => string);
+    aliases: string[];
+    permissions?: string[] | boolean;
+    admins: string[];
+    constructor(options: CommandOptions);
+    run(this: Client | undefined, args: string[], event: CommandEvent): void;
+    verify(nickname: string, roles: string[], args: string[]): boolean;
+    parse(text: string, event: CommandEvent): boolean;
+    remove(): void;
+    static execute(received: CommandEvent): boolean;
+}
+
+/**
+ * EventProvider class for managing event listeners and emitters.
+ * This class allows you to register event listeners, emit events, and manage event subscriptions.
+ * @example
+ * ```typescript
+ * type TestEvents = {
+ *   load: [event: { type: 'load' }];
+ *   event: [event: { type: 'event' }];
+ * };
+ *
+ * class Test extends EventProvider<TestEvents> {}
+ *
+ * const test = new Test();
+ * test.once('load', (data) => {});
+ * test.emit('load', { type: 'load' });
+ *
+ * test.on('event', (data) => {});
+ * test.emit('event', { type: 'event' });
+ * ```
+ */
+declare class EventProvider<EventMap extends Record<string, any[]> = Record<string, any[]>> {
+    /**
+     * Stores registered event listeners.
+     */
+    private registeredEvents;
+    /**
+     * Emits an event to all registered listeners.
+     * Returns an array of return values from the listeners.
+     * @param eventName The name of the event.
+     * @param args Arguments to pass to the listeners.
+     */
+    emit<K extends keyof EventMap>(eventName: K, ...args: EventMap[K]): any[];
+    /**
+     * Registers an event listener.
+     * @param eventName The name of the event.
+     * @param callback The callback function.
+     */
+    on<K extends keyof EventMap>(eventName: K, callback: (this: this, ...args: EventMap[K]) => any): this;
+    /**
+     * Removes a specific event listener.
+     * @param eventName The name of the event.
+     * @param callback The callback function to remove.
+     */
+    off<K extends keyof EventMap>(eventName: K, callback?: (this: this, ...args: EventMap[K]) => any): this;
+    /**
+     * Registers a listener that is executed only once.
+     * @param eventName The name of the event.
+     * @param callback The callback function.
+     */
+    once<K extends keyof EventMap>(eventName: K, callback: (this: this, ...args: EventMap[K]) => any): this;
+    /**
+     * Removes all listeners for a specific event.
+     * @param eventName The name of the event.
+     */
+    removeAllListeners<K extends keyof EventMap>(eventName: K): this;
+}
+
+type JSONPrimitive = string | number | boolean | null;
+type JSONSerializable = JSONPrimitive | JSONSerializable[] | {
+    [k: string]: JSONSerializable | undefined;
+};
+type JSONObject = {
+    [key: string]: JSONSerializable | undefined;
+};
+
+type UseStorageEvents<T> = {
+    load: [T | null];
+    update: [T];
+};
+type UseStorageOptions<T> = {
+    id?: string;
+    data: T;
+};
+declare class useStorage<T extends JSONObject> extends EventProvider<UseStorageEvents<T>> {
+    private SE_API;
+    /** The unique identifier for the storage instance. */
+    id: string;
+    loaded: boolean;
+    data: T;
+    constructor(options: UseStorageOptions<T>);
+    /**
+     * Saves the current data to storage.
+     * @param data Data to save (defaults to current)
+     */
+    private save;
+    /**
+     * Updates the storage data and emits an update event
+     * @param data Data to update (defaults to current)
+     */
+    update(data?: Partial<T>): void;
+    /**
+     * Adds a value to the storage at the specified path.
+     * @param path Path to add the value to
+     * @param value Value to add
+     */
+    add<P extends string>(path: P, value: PathValue<T, P>): void;
+    /**
+     * Clears all data from the storage.
+     */
+    clear(): void;
+    /**
+     * Sets a value in the storage at the specified path.
+     * @param obj The object to set the value in
+     * @param path The path to set the value at
+     * @param value The value to set
+     * @returns The updated object
+     */
+    static setByPath<P extends string, T extends object>(obj: T, path: P, value: PathValue<T, P>): void;
+    on<K extends keyof UseStorageEvents<T>>(eventName: K, callback: (this: useStorage<T>, ...args: UseStorageEvents<T>[K]) => void): this;
+}
+
+declare namespace Alejo {
+    namespace Pronouns {
+        type name = 'hehim' | 'sheher' | 'theythem' | 'shethem' | 'hethem' | 'heshe' | 'xexem' | 'faefaer' | 'vever' | 'aeaer' | 'ziehir' | 'perper' | 'eem' | 'itits';
+        type display = 'He/Him' | 'She/Her' | 'They/Them' | 'She/They' | 'He/They' | 'He/She' | 'Xe/Xem' | 'Fae/Faer' | 'Ve/Ver' | 'Ae/Aer' | 'Zie/Hir' | 'Per/Per' | 'E/Em' | 'It/Its';
+        enum map {
+            hehim = "He/Him",
+            sheher = "She/Her",
+            theythem = "They/Them",
+            shethem = "She/They",
+            hethem = "He/They",
+            heshe = "He/She",
+            xexem = "Xe/Xem",
+            faefaer = "Fae/Faer",
+            vever = "Ve/Ver",
+            aeaer = "Ae/Aer",
+            ziehir = "Zie/Hir",
+            perper = "Per/Per",
+            eem = "E/Em",
+            itits = "It/Its"
+        }
+    }
+    function list(): Promise<typeof Pronouns.map>;
+    type user = {
+        id: string;
+        login: string;
+        pronoun_id: Pronouns.name;
+    };
+    function get(username: string): Promise<Pronouns.name | undefined>;
+}
+
+type ClientEvents = {
+    load: [event: StreamElements.Event.onWidgetLoad];
+    action: [action: Button | Command, type: 'created' | 'executed' | 'removed'];
+    session: [session: StreamElements.Session.Data];
+    event: [provider: 'streamelements', event: StreamElements.Event.Provider.StreamElements.Events] | [provider: 'twitch', event: StreamElements.Event.Provider.Twitch.Events] | [provider: 'youtube', event: StreamElements.Event.Provider.YouTube.Events] | [provider: 'kick', event: StreamElements.Event.Provider.Kick.Events] | [provider: 'facebook', event: StreamElements.Event.Provider.Facebook.Events];
 };
-type SeventvEmote = {
-    type: '7tv';
-    name: string;
-    id: string;
-    gif: boolean;
-    animated: boolean;
-    urls: {
-        '1': string;
-        '2': string;
-        '3': string;
-        '4': string;
-    };
-    start: number;
-    end: number;
-    cords: {
-        x: number;
-        y: number;
-    };
+type ClientStorageOptions<T> = {
+    value: T;
+    timestamp: number;
+    expire: number;
 };
-type BttvEmote = {
-    type: 'bttv';
-    name: string;
+type ClientStorage = {
+    user: Record<string, ClientStorageOptions<string>>;
+    avatar: Record<string, ClientStorageOptions<string>>;
+    pronoun: Record<string, ClientStorageOptions<Alejo.Pronouns.name>>;
+    emote: Record<string, ClientStorageOptions<string>>;
+};
+type ClientOptions = {
+    id?: string;
+    debug?: boolean | (() => boolean);
+};
+declare class Client extends EventProvider<ClientEvents> {
     id: string;
-    gif: boolean;
-    animated: boolean;
-    urls: {
-        '1': string;
-        '2': string;
-        '4': string;
+    debug: boolean;
+    storage: useStorage<ClientStorage>;
+    fields: StreamElements.Event.onWidgetLoad['fieldData'];
+    session: StreamElements.Session.Data;
+    loaded: boolean;
+    constructor(options: ClientOptions);
+    actions: {
+        commands: Command[];
+        buttons: Button[];
     };
-    start: number;
-    end: number;
-    coords: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
+    details: {
+        provider: Provider$1 | 'local';
+        user: StreamElements.Event.onWidgetLoad['channel'];
+        currency: StreamElements.Event.onWidgetLoad['currency'];
+        overlay: StreamElements.Event.onWidgetLoad['overlay'];
     };
-};
-type Emoji = {
-    type: 'emoji';
-    name: string;
-    id: string;
-    gif: boolean;
-    urls: {
-        '1': string;
+    cache: {
+        /**
+         * Avatar cache duration in minutes.
+         */
+        avatar: number;
+        /**
+         * Pronoun cache duration in minutes.
+         */
+        pronoun: number;
+        /**
+         * Emote cache duration in minutes.
+         */
+        emote: number;
     };
-};
-type Emote = TwitchEmote | BttvEmote | SeventvEmote | Emoji;
+    on<K extends keyof ClientEvents>(eventName: K, callback: (this: Client, ...args: ClientEvents[K]) => void): this;
+}
+
+type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+
+interface ButtonOptions {
+    field: string | ((field: string, value: string | boolean | number) => boolean);
+    template?: string;
+    name?: string;
+    value?: string;
+    run: (this: Client | undefined, field: string, value: string | boolean | number) => void;
+}
+/**
+ * Represents a button action that can be triggered by custom fields in StreamElements.
+ * The button can be configured with a template and a name, and it will execute a specified function when triggered.
+ * @example
+ * ```javascript
+ * const button = new Button({
+ *   field: (field, value) => field.startsWith('message-') && field.split('-')[1],
+ *   template: 'message-{role}',
+ *   // name: '[CAP={role}] role message',
+ *   name: 'Generate {role} message',
+ *   run(field, value) {
+ *     console.log(`Button ${field} was clicked with value: ${value}`);
+ *   }
+ * })
+ *
+ * const field = button.generate([{ role: 'broadcaster' }, { role: 'moderator' }]);
+ * // This will create buttons with fields "message-broadcaster" and "message-moderator" and names "Generate broadcaster message" and "Generate moderator message".
+ * // field['message-broadcaster'] => { type: 'button', label: 'Generate broadcaster message' }
+ * // field['message-moderator'] => { type: 'button', label: 'Generate moderator message' }
+ *
+ * // When a custom field with the name "message-broadcaster" or "message-moderator" is triggered, the run function will be called with the field and value.
+ * ```
+ */
+declare class Button {
+    field: ButtonOptions['field'];
+    template: string;
+    name: string;
+    value: string;
+    run: ButtonOptions['run'];
+    constructor(options: ButtonOptions);
+    generate(values: Array<Record<string, string | number>>): Record<string, StreamElements.CustomField.Schema>;
+    parse(field: string, value: string | boolean | number): Button;
+    remove(): void;
+    static execute(field: string, value: string | boolean | number): boolean;
+}
+
+interface Theme {
+    color?: string;
+    background?: string;
+    bold?: boolean;
+    italic?: boolean;
+    fontSize?: number;
+    icon?: string;
+}
+interface Options {
+    enabled?: boolean;
+    prefix?: string | (() => string);
+}
+type LogMethod = (...args: unknown[]) => void;
+declare class useLogger {
+    enabled: boolean;
+    prefix: string | (() => string);
+    constructor(options?: Options);
+    apply(theme: Theme): LogMethod;
+    private style;
+    group(label: string): void;
+    groupCollapsed(label: string): void;
+    groupEnd(): void;
+    table(data: unknown): void;
+    time(label: string): void;
+    timeEnd(label: string): void;
+    readonly error: LogMethod;
+    readonly warn: LogMethod;
+    readonly success: LogMethod;
+    readonly info: LogMethod;
+    readonly debug: LogMethod;
+    readonly alert: LogMethod;
+    readonly status: LogMethod;
+    readonly received: LogMethod;
+    readonly simple: LogMethod;
+}
 
+type QueueEvents<T> = {
+    load: [];
+    cancel: [];
+    update: [
+        queue: QueueItem<T>[],
+        priorityQueue: QueueItem<T>[],
+        history: QueueItem<T>[],
+        timeouts: Array<ReturnType<typeof setTimeout>>
+    ];
+    process: [item: QueueItem<T>, queue: useQueue<T>];
+};
+type QueueProps = {
+    isoDate: string;
+    isLoop: boolean;
+    isPriority: boolean;
+    isImmediate: boolean;
+};
+type QueueItem<T> = {
+    value: T;
+} & QueueProps;
+type QueueProcessor<T> = (this: useQueue<T>, item: T, queue: useQueue<T>) => Promise<any>;
+type QueueDuration = number | boolean | undefined;
+interface QueueOptions<T> {
+    /**
+     * Duration between processing each item in milliseconds. Set to `0` or `false` for immediate processing.
+     */
+    duration?: QueueDuration | 'client';
+    /**
+     * Function to process each item in the queue.
+     */
+    processor: QueueProcessor<T>;
+}
 /**
- * EventProvider class for managing event listeners and emitters.
- * This class allows you to register event listeners, emit events, and manage event subscriptions.
+ * A utility class to manage a queue of items with support for priority, looping, and immediate processing.
+ * @template T - The type of items in the queue.
+ * @extends EventProvider<QueueEvents<T>>
  * @example
- * ```typescript
- * type TestEvents = {
- *   load: [event: { type: 'load' }];
- *   event: [event: { type: 'event' }];
- * };
- *
- * class Test extends EventProvider<TestEvents> {}
- *
- * const test = new Test();
- * test.once('load', (data) => {});
- * test.emit('load', { type: 'load' });
+ * ```javascript
+ * const myQueue = new useQueue({
+ *   duration: 1000,
+ *   processor: async function (item) {
+ *    console.log('Processing item:', item);
+ *  },
+ * });
  *
- * test.on('event', (data) => {});
- * test.emit('event', { type: 'event' });
+ * myQueue.enqueue('Item 1');
+ * myQueue.enqueue('Item 2', { isPriority: true });
  * ```
  */
-declare class EventProvider<EventMap extends Record<string, any[]> = Record<string, any[]>> {
+declare class useQueue<T> extends EventProvider<QueueEvents<T>> {
+    queue: QueueItem<T>[];
+    priorityQueue: QueueItem<T>[];
+    history: QueueItem<T>[];
+    private timeouts;
+    running: boolean;
+    duration: QueueDuration;
+    private loaded;
+    processor: QueueProcessor<T>;
+    private readonly clientWaitRetryDelay;
+    constructor(options: QueueOptions<T>);
+    private waitForClientAndBindLoad;
     /**
-     * Stores registered event listeners.
+     * Enqueue an item or multiple items into the queue with optional processing options.
+     * @param value - The item or items to be enqueued. Can be a single value of type T or an array of objects containing the value and options.
+     * @param options - Optional processing options for the item(s) being enqueued. Ignored if an array of items is provided, as each item can have its own options.
+     * @returns The instance of the queue for chaining.
+     * @example
+     * ```javascript
+     * myQueue.enqueue('Single Item', { isPriority: true });
+     * myQueue.enqueue([
+     *   { value: 'Item 1', options: { isPriority: true } },
+     *   { value: 'Item 2', options: { isLoop: true } }
+     * ]);
+     * ```
      */
-    private registeredEvents;
+    enqueue(value: T, options?: Partial<QueueProps>): this;
+    enqueue(items: {
+        value: T;
+        options?: Partial<QueueProps>;
+    }[]): this;
+    private run;
+    private next;
     /**
-     * Emits an event to all registered listeners.
-     * Returns an array of return values from the listeners.
-     * @param eventName The name of the event.
-     * @param args Arguments to pass to the listeners.
+     * Resume processing the queue if it is paused. If the queue is already running, it will be restarted, which can be useful if new items have been added or if you want to reset the processing timer.
+     * If the queue was empty before, it will start processing immediately.
+     * @returns - The instance of the queue for chaining.
+     * @example
+     * ```javascript
+     * myQueue.resume();
+     * ```
      */
-    emit<K extends keyof EventMap>(eventName: K, ...args: EventMap[K]): any[];
+    resume(): this;
     /**
-     * Registers an event listener.
-     * @param eventName The name of the event.
-     * @param callback The callback function.
+     * Update the queue's state with new values. This can be used to replace the current queue, priority queue, history, or timeouts with new data. If the queue is not currently running and there are items in the queue after the update, it will start processing immediately.
+     * @param save - An object containing the new state for the queue, priority queue, history, and timeouts. Each property is optional, and if not provided, the current state will be retained.
+     * @returns - The instance of the queue for chaining.
+     * @example
+     * ```javascript
+     * myQueue.update({
+     *   queue: newQueueItems,
+     *   priorityQueue: newPriorityItems,
+     *   history: newHistory,
+     * });
+     * ```
      */
-    on<K extends keyof EventMap>(eventName: K, callback: (this: this, ...args: EventMap[K]) => any): this;
+    update(save: Partial<useQueue<T>>): this;
     /**
-     * Removes a specific event listener.
-     * @param eventName The name of the event.
-     * @param callback The callback function to remove.
+     * Cancel all pending timeouts and stop the queue from processing further items. This will clear any scheduled processing and prevent any new items from being processed until `resume()` is called again. The current state of the queue, priority queue, and history will be retained, allowing you to resume processing later without losing any data.
      */
-    off<K extends keyof EventMap>(eventName: K, callback?: (this: this, ...args: EventMap[K]) => any): this;
+    cancel(): void;
     /**
-     * Registers a listener that is executed only once.
-     * @param eventName The name of the event.
-     * @param callback The callback function.
+     * Check if there are any items in the queue or priority queue. This method returns `true` if there are items waiting to be processed in either the main queue or the priority queue, and `false` if both queues are empty.
+     * @returns - A boolean indicating whether there are items in the queue or priority queue.
      */
-    once<K extends keyof EventMap>(eventName: K, callback: (this: this, ...args: EventMap[K]) => any): this;
+    hasItems(): boolean;
+    on<K extends keyof QueueEvents<T>>(eventName: K, callback: (this: useQueue<T>, ...args: QueueEvents<T>[K]) => void): this;
+}
+
+type ComfyEvents = {
+    load: [instance: ComfyJSInstance];
+    error: Parameters<OnErrorHandler>;
+    command: Parameters<OnCommandHandler>;
+    chat: Parameters<OnChatHandler>;
+    whisper: Parameters<OnWhisperHandler>;
+    messageDeleted: Parameters<OnMessageDeletedHandler>;
+    join: Parameters<OnJoinHandler>;
+    part: Parameters<OnPartHandler>;
+    hosted: Parameters<OnHostedHandler>;
+    raid: Parameters<OnRaidHandler>;
+    sub: Parameters<OnSubHandler>;
+    resub: Parameters<OnResubHandler>;
+    subGift: Parameters<OnSubGiftHandler>;
+    subMysteryGift: Parameters<OnSubMysteryGiftHandler>;
+    giftSubContinue: Parameters<OnGiftSubContinueHandler>;
+    cheer: Parameters<OnCheerHandler>;
+    chatMode: Parameters<OnChatModeHandler>;
+    reward: Parameters<OnRewardHandler>;
+    connected: Parameters<OnConnectedHandler>;
+    reconnect: Parameters<OnReconnectHandler>;
+};
+/**
+ * Creates and manages a ComfyJS instance for Twitch chat interaction.
+ */
+declare class useComfyJs extends EventProvider<ComfyEvents> {
+    instance: ComfyJSInstance;
+    username: string;
+    password?: string;
+    channels: string[];
+    isDebug: boolean;
+    private init;
+    emulate: boolean;
     /**
-     * Removes all listeners for a specific event.
-     * @param eventName The name of the event.
+     * Initializes a new ComfyJS instance and connects to Twitch chat.
+     * @param options - Configuration options for ComfyJS instance.
+     * @param emulate - Whether to emulate chat messages in the Local  module.
      */
-    removeAllListeners<K extends keyof EventMap>(eventName: K): this;
+    constructor(options: {
+        username: string;
+        password?: string;
+        channels: string[];
+        isDebug?: boolean;
+        init?: boolean;
+    }, emulate: boolean);
+    /**
+     * Loads the ComfyJS script if not already loaded.
+     * @returns A promise that resolves to the ComfyJS instance.
+     */
+    private load;
+    /**
+     * Connects event handlers to the ComfyJS instance.
+     */
+    private connect;
 }
 
-type JSONPrimitive = string | number | boolean | null;
-type JSONSerializable = JSONPrimitive | JSONSerializable[] | {
-    [k: string]: JSONSerializable | undefined;
-};
-type JSONObject = {
-    [key: string]: JSONSerializable | undefined;
-};
+declare namespace Data {
+    const avatars: string[];
+    const badges: Twitch.GlobalBadge[];
+    const css_color_names: string[];
+    const items: any[];
+    const names: string[];
+    const tiers: string[];
+    const tts: string[];
+    const messages: string[];
+    const normal_messages: string[];
+    const twitch_messages: string[];
+    const youtube_messages: string[];
+    const emotes: (TwitchEmote | BttvEmote | SeventvEmote)[];
+    const ffz_emotes: {
+        id: string;
+        name: string;
+        platform: string;
+        animated: boolean;
+        urls: {
+            '1': string;
+            '2': string;
+            '4': string;
+        };
+    }[];
+    const bttv_emotes: {
+        id: string;
+        name: string;
+        platform: string;
+        animated: boolean;
+        urls: {
+            '1': string;
+            '2': string;
+            '4': string;
+        };
+    }[];
+    const seventv_emotes: {
+        id: string;
+        name: string;
+        platform: string;
+        animated: boolean;
+        urls: {
+            '1': string;
+            '2': string;
+            '3': string;
+            '4': string;
+        };
+    }[];
+    const twitch_emotes: ({
+        type: string;
+        name: string;
+        id: string;
+        gif: boolean;
+        animated: boolean;
+        urls: {
+            '1': string;
+            '2': string;
+            '4': string;
+        };
+        start: number;
+        end: number;
+    } | {
+        type: string;
+        name: string;
+        id: string;
+        gif: boolean;
+        urls: {
+            '1': string;
+            '2': string;
+            '4': string;
+        };
+        start: number;
+        end: number;
+        animated?: undefined;
+    })[];
+    const youtube_emotes: {
+        emojiId: string;
+        shortcuts: string[];
+        searchTerms: string[];
+        image: {
+            thumbnails: {
+                url: string;
+                width: number;
+                height: number;
+            }[];
+            accessibility: {
+                accessibilityData: {
+                    label: string;
+                };
+            };
+        };
+        isCustomEmoji: boolean;
+        index: number;
+    }[];
+}
 
-type UseStorageEvents<T> = {
-    load: [T | null];
-    update: [T];
-};
-type UseStorageOptions<T> = {
-    id?: string;
-    data: T;
-};
-declare class useStorage<T extends JSONObject> extends EventProvider<UseStorageEvents<T>> {
-    private SE_API;
-    /** The unique identifier for the storage instance. */
-    id: string;
-    loaded: boolean;
-    data: T;
-    constructor(options: UseStorageOptions<T>);
+/**
+ * NumberHelper class provides utility methods for working with numbers, including translation to words, balancing within a range, rounding, and generating random numbers.
+ */
+declare class NumberHelper {
+    /**
+     * Translate number to words
+     * @param num - Number to translate
+     * @param type - Translation type
+     * @returns - Number in words
+     * @example
+     * ```javascript
+     * const cardinal = translate(42, 'cardinal');
+     * console.log(cardinal); // "forty-two"
+     * const ordinal = translate(42, 'ordinal');
+     * console.log(ordinal); // "forty-second"
+     * const suffix = translate(42, 'suffix');
+     * console.log(suffix); // "42nd"
+     * ```
+     */
+    translate(num: number, type?: 'cardinal' | 'ordinal' | 'suffix'): string;
+    /**
+     * Balances a number within a specified range
+     * @param amount - Number to balance
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @param decimals - Number of decimal places to round to (default is 0)
+     * @returns - Balanced number
+     * @example
+     * ```javascript
+     * const balancedValue = balance(150, 0, 100);
+     * console.log(balancedValue); // 100
+     * ```
+     */
+    balance(amount: number, min?: number, max?: number, decimals?: number): number;
+    /**
+     * Rounds a number to a specified number of decimal places
+     * @param value - Number to round
+     * @param decimals - Number of decimal places (default is 2)
+     * @returns Rounded number
+     * @example
+     * ```javascript
+     * const roundedValue = round(3.14159, 3);
+     * console.log(roundedValue); // 3.142
+     * const roundedValueDefault = round(3.14159);
+     * console.log(roundedValueDefault); // 3.14
+     * const roundedValueZero = round(3.14159, 0);
+     * console.log(roundedValueZero); // 3
+     * ```
+     */
+    round(value: number, decimals?: number): number;
+    /**
+     * Generate random number
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @param float - Number of decimal places (0 for integer)
+     * @returns - Random number
+     * @example
+     * ```javascript
+     * const intNumber = random(1, 10);
+     * console.log(intNumber); // e.g. 7
+     *
+     * const floatNumber = random(1, 10, 2);
+     * console.log(floatNumber); // e.g. 3.14
+     * ```
+     */
+    random(min: number, max: number, float?: number): number;
+}
+
+interface ScaleOptions<T extends HTMLElement> {
     /**
-     * Saves the current data to storage.
-     * @param data Data to save (defaults to current)
+     * The parent element to use for scaling calculations. If not provided, the element's parent will be used.
      */
-    private save;
+    parent?: HTMLElement;
     /**
-     * Updates the storage data and emits an update event
-     * @param data Data to update (defaults to current)
+     * The preferred dimension to base the scaling on. Can be 'width', 'height', or 'auto' (default).
      */
-    update(data?: Partial<T>): void;
+    prefer?: 'width' | 'height' | 'auto';
     /**
-     * Adds a value to the storage at the specified path.
-     * @param path Path to add the value to
-     * @param value Value to add
+     * The minimum percentage of the parent size to scale to. Default is 0.
      */
-    add<P extends string>(path: P, value: PathValue<T, P>): void;
+    min?: number;
     /**
-     * Clears all data from the storage.
+     * The maximum percentage of the parent size to scale to. Default is 1 (100%).
      */
-    clear(): void;
+    max?: number;
     /**
-     * Sets a value in the storage at the specified path.
-     * @param obj The object to set the value in
-     * @param path The path to set the value at
-     * @param value The value to set
-     * @returns The updated object
+     * A callback function that is called after scaling is applied.
+     * @param this - The HTML element being scaled.
+     * @param number - The scale factor applied to the element.
+     * @param element - The HTML element being scaled.
+     * @returns void
      */
-    static setByPath<P extends string, T extends object>(obj: T, path: P, value: PathValue<T, P>): void;
-    on<K extends keyof UseStorageEvents<T>>(eventName: K, callback: (this: useStorage<T>, ...args: UseStorageEvents<T>[K]) => void): this;
-}
-
-interface CommandOptions {
-    prefix?: string;
-    name: string;
-    description?: string;
-    arguments?: boolean;
-    run: (this: Client, args: string[], event: CommandEvent) => void;
-    test?: string;
-    aliases?: string[];
-    permissions?: string[] | boolean;
-    admins?: string[];
-}
-type CommandEvent = {
-    provider: 'twitch';
-    data: StreamElements.Event.Provider.Twitch.Message;
-} | {
-    provider: 'youtube';
-    data: StreamElements.Event.Provider.YouTube.Message;
-} | {
-    provider: 'kick';
-    data: any;
-};
-declare class Command {
-    prefix: string;
-    name: string;
-    description: string;
-    arguments: boolean;
-    test: string | (() => string);
-    aliases: string[];
-    permissions?: string[] | boolean;
-    admins: string[];
-    constructor(options: CommandOptions);
-    run(this: Client | undefined, args: string[], event: CommandEvent): void;
-    verify(nickname: string, roles: string[], args: string[]): boolean;
-    parse(text: string, event: CommandEvent): boolean;
-    remove(): void;
-    static execute(received: CommandEvent): boolean;
-}
-
-declare namespace Alejo {
-    namespace Pronouns {
-        type name = 'hehim' | 'sheher' | 'theythem' | 'shethem' | 'hethem' | 'heshe' | 'xexem' | 'faefaer' | 'vever' | 'aeaer' | 'ziehir' | 'perper' | 'eem' | 'itits';
-        type display = 'He/Him' | 'She/Her' | 'They/Them' | 'She/They' | 'He/They' | 'He/She' | 'Xe/Xem' | 'Fae/Faer' | 'Ve/Ver' | 'Ae/Aer' | 'Zie/Hir' | 'Per/Per' | 'E/Em' | 'It/Its';
-        enum map {
-            hehim = "He/Him",
-            sheher = "She/Her",
-            theythem = "They/Them",
-            shethem = "She/They",
-            hethem = "He/They",
-            heshe = "He/She",
-            xexem = "Xe/Xem",
-            faefaer = "Fae/Faer",
-            vever = "Ve/Ver",
-            aeaer = "Ae/Aer",
-            ziehir = "Zie/Hir",
-            perper = "Per/Per",
-            eem = "E/Em",
-            itits = "It/Its"
-        }
-    }
-    function list(): Promise<typeof Pronouns.map>;
-    type user = {
-        id: string;
-        login: string;
-        pronoun_id: Pronouns.name;
-    };
-    function get(username: string): Promise<Pronouns.name | undefined>;
+    apply?: (this: T, number: number, element: T) => void;
 }
-
-type ClientEvents = {
-    load: [event: StreamElements.Event.onWidgetLoad];
-    action: [action: Button | Command, type: 'created' | 'executed' | 'removed'];
-    session: [session: StreamElements.Session.Data];
-    event: [provider: 'streamelements', event: StreamElements.Event.Provider.StreamElements.Events] | [provider: 'twitch', event: StreamElements.Event.Provider.Twitch.Events] | [provider: 'youtube', event: StreamElements.Event.Provider.YouTube.Events] | [provider: 'kick', event: StreamElements.Event.Provider.Kick.Events] | [provider: 'facebook', event: StreamElements.Event.Provider.Facebook.Events];
-};
-type ClientStorageOptions<T> = {
-    value: T;
-    timestamp: number;
-    expire: number;
-};
-type ClientStorage = {
-    user: Record<string, ClientStorageOptions<string>>;
-    avatar: Record<string, ClientStorageOptions<string>>;
-    pronoun: Record<string, ClientStorageOptions<Alejo.Pronouns.name>>;
-    emote: Record<string, ClientStorageOptions<string>>;
-};
-type ClientOptions = {
-    id?: string;
-    debug?: boolean | (() => boolean);
+type FitTextOptions = {
+    minFontSize?: number;
+    maxFontSize?: number;
+    parent?: HTMLElement;
 };
-declare class Client extends EventProvider<ClientEvents> {
-    id: string;
-    debug: boolean;
-    storage: useStorage<ClientStorage>;
-    fields: StreamElements.Event.onWidgetLoad['fieldData'];
-    session: StreamElements.Session.Data;
-    loaded: boolean;
-    constructor(options: ClientOptions);
-    actions: {
-        commands: Command[];
-        buttons: Button[];
-    };
-    details: {
-        provider: Provider$1 | 'local';
-        user: StreamElements.Event.onWidgetLoad['channel'];
-        currency: StreamElements.Event.onWidgetLoad['currency'];
-        overlay: StreamElements.Event.onWidgetLoad['overlay'];
-    };
-    cache: {
-        /**
-         * Avatar cache duration in minutes.
-         */
-        avatar: number;
-        /**
-         * Pronoun cache duration in minutes.
-         */
-        pronoun: number;
-        /**
-         * Emote cache duration in minutes.
-         */
-        emote: number;
-    };
-    on<K extends keyof ClientEvents>(eventName: K, callback: (this: Client, ...args: ClientEvents[K]) => void): this;
-}
-
-interface ButtonOptions {
-    field: string | ((field: string, value: string | boolean | number) => boolean);
-    template?: string;
-    name?: string;
-    value?: string;
-    run: (this: Client | undefined, field: string, value: string | boolean | number) => void;
-}
-/**
- * Represents a button action that can be triggered by custom fields in StreamElements.
- * The button can be configured with a template and a name, and it will execute a specified function when triggered.
- * @example
- * ```javascript
- * const button = new Button({
- *   field: (field, value) => field.startsWith('message-') && field.split('-')[1],
- *   template: 'message-{role}',
- *   // name: '[CAP={role}] role message',
- *   name: 'Generate {role} message',
- *   run(field, value) {
- *     console.log(`Button ${field} was clicked with value: ${value}`);
- *   }
- * })
- *
- * const field = button.generate([{ role: 'broadcaster' }, { role: 'moderator' }]);
- * // This will create buttons with fields "message-broadcaster" and "message-moderator" and names "Generate broadcaster message" and "Generate moderator message".
- * // field['message-broadcaster'] => { type: 'button', label: 'Generate broadcaster message' }
- * // field['message-moderator'] => { type: 'button', label: 'Generate moderator message' }
- *
- * // When a custom field with the name "message-broadcaster" or "message-moderator" is triggered, the run function will be called with the field and value.
- * ```
- */
-declare class Button {
-    field: ButtonOptions['field'];
-    template: string;
-    name: string;
-    value: string;
-    run: ButtonOptions['run'];
-    constructor(options: ButtonOptions);
-    generate(values: Array<Record<string, string | number>>): Record<string, StreamElements.CustomField.Schema>;
-    parse(field: string, value: string | boolean | number): Button;
-    remove(): void;
-    static execute(field: string, value: string | boolean | number): boolean;
+declare class ElementHelper {
+    /**
+     * Merges outer span styles with inner span styles in the provided HTML string.
+     * @param outerStyle - The style string to be applied to the outer span.
+     * @param innerHTML - The inner HTML string which may contain a span with its own styles.
+     * @returns A new HTML string with merged styles applied to a single span.
+     * @example
+     * ```javascript
+     * const result = mergeSpanStyles("color: red; font-weight: bold;", '<span style="font-size: 14px;">Hello World</span>');
+     * console.log(result); // Output: '<span style="font-size: 14px; color: red; font-weight: bold;">Hello World</span>'
+     * ```
+     */
+    mergeSpanStyles(outerStyle: string, innerHTML: string, className?: string): string;
+    /**
+     * Scales an HTML element to fit within its parent element based on specified minimum and maximum scale factors.
+     * @param element - The HTML element to be scaled.
+     * @param min - Minimum scale factor (default is 0).
+     * @param max - Maximum scale factor (default is 1).
+     * @param options - Optional settings for scaling.
+     * @returns - An object containing the new width, height, and scale factor, or void if not applied.
+     * @example
+     * ```javascript
+     * const element = document.getElementById('myElement');
+     * scale(element, 0.5, 1, { return: false });
+     * ```
+     */
+    scale(element: HTMLElement, min?: number, max?: number, options?: {
+        return: boolean;
+        parent: HTMLElement;
+        base: 'width' | 'height';
+    }): {
+        width: number;
+        height: number;
+        scale: number;
+    } | void;
+    /**
+     * Scales an HTML element to fit within its parent element based on specified options.
+     * @param element - The HTML element to be scaled.
+     * @param options - Optional settings for scaling.
+     * @returns The scale factor applied to the element.
+     * @example
+     * ```javascript
+     * const element = document.getElementById('myElement');
+     * const scaleFactor  scalev2(element, {
+     *   min: 0.5,
+     *   max: 1,
+     *   prefer: 'width',
+     *   apply: (scale, el) => el.style.transform = `scale(${scale})`
+     * });
+     * console.log(`Element scaled by a factor of ${scaleFactor}`);
+     * ```
+     */
+    scalev2<T extends HTMLElement>(element: T, options?: ScaleOptions<T>): number;
+    /**
+     * Fits the text within the parent element by adjusting the font size.
+     * @param element - The HTML element containing the text to be fitted.
+     * @param compressor - A multiplier to adjust the fitting sensitivity (default is 1).
+     * @param options - Optional settings for fitting text.
+     * @returns The HTML element with adjusted font size.
+     * @example
+     * ```javascript
+     * const element = document.getElementById('myTextElement');
+     * fitText(element, 1, { minFontSize: 12, maxFontSize: 36 });
+     * console.log(`Adjusted font size: ${element.style.fontSize}`);
+     * ```
+     */
+    fitText(element: HTMLElement, compressor?: number, options?: FitTextOptions): HTMLElement;
+    /**
+     * Wraps formatted HTML text with containers and splits characters into indexed spans.
+     * Adds 'container' class and data-index to all parent elements, and wraps each character in a span with class 'char' and data-index.
+     * @param htmlString - The input HTML string containing formatted text elements (span, strong, em, etc).
+     * @param startIndex - The starting index for the data-index attribute (default is 0).
+     * @returns - A new HTML string with containers and character-level indexing.
+     * @example
+     * ```javascript
+     * const result = splitTextToChars('<span>TesTe</span> <strong>bold</strong>', 0);
+     * console.log(result);
+     * // Output: '<span class="container" data-index="0"><span class="char" data-index="0">T</span><span class="char" data-index="1">e</span>...'
+     * ```
+     */
+    splitTextToChars(htmlString: string, startIndex?: number, preserveInterElementWhitespace?: boolean): string;
 }
 
-interface Theme {
-    color?: string;
-    background?: string;
-    bold?: boolean;
-    italic?: boolean;
-    fontSize?: number;
-    icon?: string;
-}
-interface Options {
-    enabled?: boolean;
-    prefix?: string | (() => string);
-}
-type LogMethod = (...args: unknown[]) => void;
-declare class useLogger {
-    enabled: boolean;
-    prefix: string | (() => string);
-    constructor(options?: Options);
-    apply(theme: Theme): LogMethod;
-    private style;
-    group(label: string): void;
-    groupCollapsed(label: string): void;
-    groupEnd(): void;
-    table(data: unknown): void;
-    time(label: string): void;
-    timeEnd(label: string): void;
-    readonly error: LogMethod;
-    readonly warn: LogMethod;
-    readonly success: LogMethod;
-    readonly info: LogMethod;
-    readonly debug: LogMethod;
-    readonly alert: LogMethod;
-    readonly status: LogMethod;
-    readonly received: LogMethod;
-    readonly simple: LogMethod;
+declare class ObjectHelper {
+    /**
+     * Flattens a nested object into a single-level object with dot-separated keys.
+     * @param obj - The nested object to be flattened.
+     * @param prefix  - The prefix to be added to each key (used for recursion).
+     * @returns A flattened object with dot-separated keys.
+     * @example
+     * ```javascript
+     * const nestedObj = { a: { b: 1, c: { d: 2 } }, e: [3, 4] };
+     * const flatObj = flatten(nestedObj);
+     * console.log(flatObj);
+     * // Output: { 'a.b': '1', 'a.c.d': '2', 'e:0': '3', 'e:1': '4' }
+     * ```
+     */
+    flatten(obj: Record<string, any>, stringify?: boolean, prefix?: string): Record<string, typeof stringify extends true ? string : string | number | boolean>;
+    /**
+     * Returns the entries of an object as an array of key-value pairs, with proper typing.
+     * @param obj - The object to retrieve entries from.
+     * @returns An array of key-value pairs from the object, typed as an array of tuples with key and value types.
+     */
+    entries<K extends string, V>(obj: Record<K, V>): [K, V][];
+    /**
+     * Returns the values of an object as an array, with proper typing.
+     * @param obj - The object to retrieve values from.
+     * @returns An array of values from the object, typed as an array of the value type.
+     */
+    values<K extends string, V>(obj: Record<K, V>): V[];
+    /**
+     * Returns the keys of an object as an array of strings, with proper typing.
+     * @param obj - The object to retrieve keys from.
+     * @returns An array of keys from the object, typed as an array of strings.
+     */
+    keys<K extends string, V>(obj: Record<K, V>): K[];
 }
 
-type QueueEvents<T> = {
-    load: [];
-    cancel: [];
-    update: [
-        queue: QueueItem<T>[],
-        priorityQueue: QueueItem<T>[],
-        history: QueueItem<T>[],
-        timeouts: Array<ReturnType<typeof setTimeout>>
-    ];
-    process: [item: QueueItem<T>, queue: useQueue<T>];
+type BadgeOptions = Twitch.tags[] | Twitch.tags | `${Twitch.tags}/${string}` | `${Twitch.tags}/${string}`[];
+type TwitchResult = {
+    keys: Twitch.tags[];
+    badges: Twitch.badge[];
+    versions: {
+        [K in Twitch.tags]?: string | number;
+    };
+    amount: {
+        [K in Twitch.tags]?: string | number;
+    };
 };
-type QueueProps = {
-    isoDate: string;
-    isLoop: boolean;
-    isPriority: boolean;
-    isImmediate: boolean;
+type YouTubeResult = {
+    isVerified: boolean;
+    isChatOwner: boolean;
+    isChatSponsor: boolean;
+    isChatModerator: boolean;
 };
-type QueueItem<T> = {
-    value: T;
-} & QueueProps;
-type QueueProcessor<T> = (this: useQueue<T>, item: T, queue: useQueue<T>) => Promise<any>;
-type QueueDuration = number | boolean | undefined;
-interface QueueOptions<T> {
+declare class MessageHelper {
     /**
-     * Duration between processing each item in milliseconds. Set to `0` or `false` for immediate processing.
+     * Finds emotes in a given text.
+     * @param text - The text to search for emotes.
+     * @param emotes - An array of emotes to search for. Defaults to Local data emotes.
+     * @returns An array of emotes found in the text with their positions.
      */
-    duration?: QueueDuration | 'client';
+    findEmotesInText(text: string, emotes?: Emote[]): Emote[];
     /**
-     * Function to process each item in the queue.
+     * Replaces emotes in the text with corresponding HTML image tags.
+     * @param text - The text containing emotes.
+     * @param emotes - An array of emotes with their positions in the text.
+     * @returns The text with emotes replaced by HTML image tags.
      */
-    processor: QueueProcessor<T>;
+    replaceEmotesWithHTML(text: string, emotes: Emote[]): string;
+    /**
+     * Checks if the text contains only emotes and whitespace.
+     * @param text - The text to check.
+     * @param emotes - An array of emotes with their positions in the text.
+     * @returns True if the text contains only emotes and whitespace, false otherwise.
+     */
+    hasOnlyEmotes(text: string, emotes: Emote[]): boolean;
+    /**
+     * Replaces YouTube emotes in the text with corresponding HTML image tags.
+     * @param text - The text containing YouTube emotes.
+     * @param emotes - An array of YouTube emotes. Defaults to Local data YouTube emotes.
+     * @returns The text with YouTube emotes replaced by HTML image tags.
+     */
+    replaceYoutubeEmotesWithHTML(text: string, emotes?: {
+        emojiId: string;
+        shortcuts: string[];
+        searchTerms: string[];
+        image: {
+            thumbnails: {
+                url: string;
+                width: number;
+                height: number;
+            }[];
+            accessibility: {
+                accessibilityData: {
+                    label: string;
+                };
+            };
+        };
+        isCustomEmoji: boolean;
+        index: number;
+    }[]): string;
+    /**
+     * Maps global badge versions to a structured format.
+     * @param globalBadges - An array of Twitch global badges. Defaults to Local data badges.
+     * @returns An array of objects containing badge IDs and their corresponding versions.
+     * @example
+     * ```javascript
+     * const badgeVersions = mapGlobalBadgeVersions();
+     * console.log(badgeVersions);
+     * // Output:
+     * [
+     *   {
+     *     id: 'subscriber',
+     *     versions: [
+     *       { type: 'subscriber', version: '1', url: 'https://...', description: 'Subscriber' },
+     *       { type: 'subscriber', version: '2', url: 'https://...', description: '2-Month Subscriber' },
+     *       // ... more versions
+     *     ],
+     *   },
+     *   {
+     *     id: 'bits',
+     *     versions: [
+     *       { type: 'bits', version: '100', url: 'https://...', description: 'cheer 100' },
+     *       { type: 'bits', version: '1000', url: 'https://...', description: 'cheer 1000' },
+     *       // ... more versions
+     *     ],
+     *   },
+     *   // ... more badges
+     * ]
+     * ```
+     */
+    mapGlobalBadgeVersions(globalBadges?: Twitch.GlobalBadge[]): Array<{
+        id: Twitch.tags;
+        versions: Twitch.badge[];
+    }>;
+    /**
+     * Maps a badge type and variation to the corresponding badge version amount.
+     * @param type - The badge type (e.g., 'subscriber', 'bits', etc.).
+     * @param variation - The badge variation, which can be a number or a string (e.g., 'horde', 'alliance', etc.).
+     * @returns The badge version amount as a string. Returns '0' if no matching badge version is found.
+     * @example
+     * ```javascript
+     * // For subscriber badge with 3 months
+     * mapGlobalBadgeVersionAmount('subscriber', 3); // Returns '3'
+     * // For bits badge with 5000 bits
+     * mapGlobalBadgeVersionAmount('bits', 5000); // Returns the corresponding badge version based on the mapping
+     * // For warcraft badge with 'horde' variation
+     * mapGlobalBadgeVersionAmount('warcraft', 'horde'); // Returns 'horde'
+     * ```
+     */
+    mapGlobalBadgeVersionAmount(type: Twitch.tags, variation: string | number): string;
+    /**
+     * Generates badge data based on the provided badges and platform.
+     * @param badges - The badges to generate. Can be an array or a comma-separated string.
+     * @param provider - The platform provider ('twitch' or 'youtube'). Defaults to 'twitch'.
+     * @returns A promise that resolves to the generated badge data.
+     * @example
+     * ```javascript
+     * // Generate Twitch badges
+     * const twitchBadges = await generateBadges(['broadcaster', 'moderator'], 'twitch');
+     * // Generate YouTube badges
+     * const youtubeBadges = await generateBadges('sponsor, moderator', 'youtube');
+     * ```
+     */
+    generateBadges<T extends Provider$1>(badges: BadgeOptions | undefined, provider: T): Promise<T extends 'twitch' ? TwitchResult : YouTubeResult>;
 }
-/**
- * A utility class to manage a queue of items with support for priority, looping, and immediate processing.
- * @template T - The type of items in the queue.
- * @extends EventProvider<QueueEvents<T>>
- * @example
- * ```javascript
- * const myQueue = new useQueue({
- *   duration: 1000,
- *   processor: async function (item) {
- *    console.log('Processing item:', item);
- *  },
- * });
- *
- * myQueue.enqueue('Item 1');
- * myQueue.enqueue('Item 2', { isPriority: true });
- * ```
- */
-declare class useQueue<T> extends EventProvider<QueueEvents<T>> {
-    queue: QueueItem<T>[];
-    priorityQueue: QueueItem<T>[];
-    history: QueueItem<T>[];
-    private timeouts;
-    running: boolean;
-    duration: QueueDuration;
-    private loaded;
-    processor: QueueProcessor<T>;
-    private readonly clientWaitRetryDelay;
-    constructor(options: QueueOptions<T>);
-    private waitForClientAndBindLoad;
+
+declare class RandomHelper {
     /**
-     * Enqueue an item or multiple items into the queue with optional processing options.
-     * @param value - The item or items to be enqueued. Can be a single value of type T or an array of objects containing the value and options.
-     * @param options - Optional processing options for the item(s) being enqueued. Ignored if an array of items is provided, as each item can have its own options.
-     * @returns The instance of the queue for chaining.
+     * Generate random color
+     * @param type - Color format
+     * @returns - Random color in specified format
      * @example
      * ```javascript
-     * myQueue.enqueue('Single Item', { isPriority: true });
-     * myQueue.enqueue([
-     *   { value: 'Item 1', options: { isPriority: true } },
-     *   { value: 'Item 2', options: { isLoop: true } }
-     * ]);
+     * const hexColor = random.color('hex');
+     * console.log(hexColor); // e.g. #3e92cc
+     *
+     * const rgbColor = random.color('rgb');
+     * console.log(rgbColor); // e.g. rgb(62, 146, 204)
      * ```
      */
-    enqueue(value: T, options?: Partial<QueueProps>): this;
-    enqueue(items: {
-        value: T;
-        options?: Partial<QueueProps>;
-    }[]): this;
-    private run;
-    private next;
+    color(type?: 'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'css-color-name'): string;
     /**
-     * Resume processing the queue if it is paused. If the queue is already running, it will be restarted, which can be useful if new items have been added or if you want to reset the processing timer.
-     * If the queue was empty before, it will start processing immediately.
-     * @returns - The instance of the queue for chaining.
+     * Generate random number
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @param float - Number of decimal places (0 for integer)
+     * @returns - Random number
      * @example
      * ```javascript
-     * myQueue.resume();
+     * const intNumber = random.number(1, 10);
+     * console.log(intNumber); // e.g. 7
+     *
+     * const floatNumber = random.number(1, 10, 2);
+     * console.log(floatNumber); // e.g. 3.14
      * ```
      */
-    resume(): this;
+    number(min: number, max: number, float?: number): number;
     /**
-     * Update the queue's state with new values. This can be used to replace the current queue, priority queue, history, or timeouts with new data. If the queue is not currently running and there are items in the queue after the update, it will start processing immediately.
-     * @param save - An object containing the new state for the queue, priority queue, history, and timeouts. Each property is optional, and if not provided, the current state will be retained.
-     * @returns - The instance of the queue for chaining.
+     * Generate random boolean
+     * @param threshold - Threshold between 0 and 1
+     * @returns - Random boolean
      * @example
      * ```javascript
-     * myQueue.update({
-     *   queue: newQueueItems,
-     *   priorityQueue: newPriorityItems,
-     *   history: newHistory,
+     * const boolValue = random.boolean(0.7);
+     * console.log(boolValue); // e.g. true (70% chance)
+     * ```
+     */
+    boolean(threshold?: number): boolean;
+    /**
+     * Generate random string
+     * @param length - Length of the string
+     * @param chars - Characters to use
+     * @returns - Random string
+     * @example
+     * ```javascript
+     * const randString = random.string(10); // e.g. "aZ3bT9qP1x"
+     * const randHex = random.string(8, 'hex'); // e.g. "4f3c2a1b"
+     * const randNumStr = random.string(6, 'numbers'); // e.g. "839201"
+     * const randLetterStr = random.string(6, 'letters'); // e.g. "aZbTqP"
+     * const randHexUpper = random.string(6, 'hex-upper'); // e.g. "4F3C2A1B"
+     * const randHexLower = random.string(6, 'hex-lower'); // e.g. "4f3c2a1b"
+     * ```
+     */
+    string(length: number, chars?: 'numeric' | 'numbers' | 'letters' | 'hex' | 'hex-upper' | 'hex-lower' | string): string;
+    /**
+     * Pick random element from array
+     * @param arr - Array to pick from
+     * @returns - Random element and its index
+     * @example
+     * ```javascript
+     * const [element, index] = random.array(['apple', 'banana', 'cherry']);
+     * console.log(element, index); // e.g. "banana", 1
+     * ```
+     */
+    array<T>(arr: T[]): [value: T, index: number];
+    /**
+     * Generate random date
+     * @param start - Start date
+     * @param end - End date
+     * @returns - Random date between start and end
+     * @example
+     * ```javascript
+     * const randDate = random.date(new Date(2020, 0, 1), new Date());
+     * console.log(randDate); // e.g. 2022-05-15T10:30:00.000Z
+     * ```
+     */
+    date(start?: Date, end?: Date): Date;
+    /**
+     * Generate ISO date string offset by days
+     * @param daysAgo - Number of days to go back
+     * @returns - ISO date string
+     * @example
+     * ```javascript
+     * const isoDate = random.daysOffset(7);
+     * console.log(isoDate); // e.g. "2024-06-10T14:23:45.678Z"
+     *
+     * const isoDate30 = random.daysOffset(30);
+     * console.log(isoDate30); // e.g. "2024-05-18T09:15:30.123Z"
+     * ```
+     */
+    daysOffset(daysAgo: number): string;
+    /**
+     * Generate UUID v4
+     * @returns - UUID string
+     * @example
+     * ```javascript
+     * const uuid = random.uuid();
+     * console.log(uuid); // e.g. "3b12f1df-5232-4e3a-9a0c-3f9f1b1b1b1b"
+     * ```
+     */
+    uuid(): string;
+}
+
+declare class EventHelper {
+    /**
+     * Parses the provider information from the event detail object.
+     * @param detail - The event detail object received from the StreamElements event.
+     * @returns An object containing the provider and the original event data.
+     */
+    parseProvider(detail: StreamElements.Event.onEventReceived, _provider?: Provider$1): ClientEvents$1;
+}
+
+type Modifier = (value: string, param: string | null | undefined, values: {
+    amount?: number;
+    count?: number;
+}) => string;
+declare class StringHelper {
+    /**
+     * Replaces occurrences in a string based on a pattern with the result of an asynchronous callback function.
+     * @param string - The input string to perform replacements on.
+     * @param pattern - The pattern to match in the string (can be a string or a regular expression).
+     * @param callback - An asynchronous callback function that takes the matched substring and any captured groups as arguments and returns the replacement string.
+     * @returns A promise that resolves to the modified string with replacements applied.
+     * @example
+     * ```javascript
+     * const result = await string.replace("Hello World", /World/, async (match) => {
+     *   return await fetchSomeData(match); // Assume this function fetches data asynchronously
      * });
+     * console.log(result); // Output will depend on the fetched data
      * ```
      */
-    update(save: Partial<useQueue<T>>): this;
+    replace(string: string, pattern: string, callback: (match: string, ...groups: string[]) => Promise<string> | string): Promise<string>;
     /**
-     * Cancel all pending timeouts and stop the queue from processing further items. This will clear any scheduled processing and prevent any new items from being processed until `resume()` is called again. The current state of the queue, priority queue, and history will be retained, allowing you to resume processing later without losing any data.
+     * Capitalizes the first letter of a given string.
+     * @param string - The input string to be capitalized.
+     * @returns The capitalized string.
+     * @example
+     * ```javascript
+     * const result = string.capitalize("hello world");
+     * console.log(result); // Output: "Hello world"
+     * ```
      */
-    cancel(): void;
+    capitalize(string: string): Capitalize<string>;
+    PRESETS: Record<string, string>;
     /**
-     * Check if there are any items in the queue or priority queue. This method returns `true` if there are items waiting to be processed in either the main queue or the priority queue, and `false` if both queues are empty.
-     * @returns - A boolean indicating whether there are items in the queue or priority queue.
+     * Composes a template string by replacing placeholders with corresponding values and applying optional modifiers.
+     * @param template - The template string containing placeholders in the format {key} and optional modifiers in the format [MODIFIER:param=value].
+     * @param values - An object containing key-value pairs to replace the placeholders in the template.
+     * @param options - Optional settings for the composition process.
+     * @returns The composed string with placeholders replaced and modifiers applied.
+     * @example
+     * ```javascript
+     * const { string } = Tixyel.Helper;
+     *
+     * // Basic usage with placeholders and simple modifiers
+     * const template1 = "Hello, {username}! You have {amount} [UPC=messages] and your name is [CAP=name].";
+     * const values1 = { username: "john_doe", amount: 5, name: "john" };
+     * const result1 = string.compose(template1, values1);
+     * // "Hello, john_doe! You have 5 MESSAGES and your name is John."
+     *
+     * // Multiple modifiers in a single block (HTML enabled)
+     * const template2 = "[COLOR:#ff0056,BOLD={username}]";
+     * const values2 = { username: "john_doe" };
+     * const result2 = string.compose(template2, values2, { html: true });
+     * // '<span class="color bold" style="color: #ff0056; font-weight: bold;">john_doe</span>'
+     *
+     * // Conditional rendering with IF (supports ===, >=, &&, ||, !, etc.)
+     * const template3 = "[IF=vip && status === 'live'?VIP Online|Offline]";
+     * const values3 = { status: 'live', vip: true };
+     * const result3 = string.compose(template3, values3);
+     * // "VIP Online"
+     *
+     * // Pluralization using amount / count or an explicit key
+     * const template4 = "You have {amount} [PLURAL=message|messages].";
+     * const values4 = { amount: 1 };
+     * const values5 = { amount: 3 };
+     * const result4a = string.compose(template4, values4); // "You have 1 message."
+     * const result4b = string.compose(template4, values5); // "You have 3 messages."
+     *
+     * // Number formatting
+     * const template5 = "Total: [NUMBER:2=amount] {currency}";
+     * const values6 = { amount: 1234.5, currency: '$' };
+     * const result5 = string.compose(template5, values6);
+     * // e.g. "Total: 1,234.50 $" (locale dependent)
+     *
+     * // Date and time formatting
+     * const template6 = "Created at: [DATE:iso=createdAt] ([DATE:relative=createdAt])";
+     * const values7 = { createdAt: new Date('2020-01-02T03:04:05.000Z') };
+     * const result6 = string.compose(template6, values7);
+     * // e.g. "Created at: 2020-01-02T03:04:05.000Z (Xs ago)"
+     *
+     * // MAP / SWITCH style mapping
+     * const template7 = "Status: [MAP:status=live:Online|offline:Offline|default:Unknown]";
+     * const values8 = { status: 'offline' };
+     * const result7 = string.compose(template7, values8);
+     * // "Status: Offline"
+     *
+     * // Escaping HTML
+     * const template8 = "[ESCAPE={message}]";
+     * const values9 = { message: '<b>Danger & "HTML"</b>' };
+     * const result8 = string.compose(template8, values9);
+     * // "&lt;b&gt;Danger &amp; &quot;HTML&quot;&lt;/b&gt;"
+     *
+     * // Using global presets
+     * Helper.string.PRESETS['alert'] = 'BOLD,COLOR:#ff0056';
+     * const template10 = "[PRESET:alert={username}]";
+     * const values11 = { username: 'john_doe' };
+     * const result10 = string.compose(template10, values11, { html: true });
+     * // '<span class="color bold" style="color: #ff0056; font-weight: bold;">john_doe</span>'
+     * ```
      */
-    hasItems(): boolean;
-    on<K extends keyof QueueEvents<T>>(eventName: K, callback: (this: useQueue<T>, ...args: QueueEvents<T>[K]) => void): this;
+    compose(template: string, values?: Record<string, any>, options?: {
+        method?: 'loop' | 'index';
+        html?: boolean;
+        debug?: boolean;
+        modifiers?: Record<string, Modifier>;
+        aliases?: Record<string, string[]>;
+    }): string;
 }
 
-type ComfyEvents = {
-    load: [instance: ComfyJSInstance];
-    error: Parameters<OnErrorHandler>;
-    command: Parameters<OnCommandHandler>;
-    chat: Parameters<OnChatHandler>;
-    whisper: Parameters<OnWhisperHandler>;
-    messageDeleted: Parameters<OnMessageDeletedHandler>;
-    join: Parameters<OnJoinHandler>;
-    part: Parameters<OnPartHandler>;
-    hosted: Parameters<OnHostedHandler>;
-    raid: Parameters<OnRaidHandler>;
-    sub: Parameters<OnSubHandler>;
-    resub: Parameters<OnResubHandler>;
-    subGift: Parameters<OnSubGiftHandler>;
-    subMysteryGift: Parameters<OnSubMysteryGiftHandler>;
-    giftSubContinue: Parameters<OnGiftSubContinueHandler>;
-    cheer: Parameters<OnCheerHandler>;
-    chatMode: Parameters<OnChatModeHandler>;
-    reward: Parameters<OnRewardHandler>;
-    connected: Parameters<OnConnectedHandler>;
-    reconnect: Parameters<OnReconnectHandler>;
-};
-/**
- * Creates and manages a ComfyJS instance for Twitch chat interaction.
- */
-declare class useComfyJs extends EventProvider<ComfyEvents> {
-    instance: ComfyJSInstance;
-    username: string;
-    password?: string;
-    channels: string[];
-    isDebug: boolean;
-    private init;
-    emulate: boolean;
+declare class ColorHelper {
     /**
-     * Initializes a new ComfyJS instance and connects to Twitch chat.
-     * @param options - Configuration options for ComfyJS instance.
-     * @param emulate - Whether to emulate chat messages in the Local  module.
+     * Generate opacity hex value
+     * @param opacity - Opacity value from 0 to 100
+     * @param color - Hex color code
+     * @returns - Hex color code with opacity
      */
-    constructor(options: {
-        username: string;
-        password?: string;
-        channels: string[];
-        isDebug?: boolean;
-        init?: boolean;
-    }, emulate: boolean);
+    opacity(opacity?: number, color?: string): string;
+    /**
+     * Extract color and opacity from hex code
+     * @param hex - Hex color code
+     * @returns - Object with color and opacity
+     */
+    extract(hex: string): {
+        color: string;
+        opacity: number;
+    };
+    /**
+     * Validate color string format
+     * @param str - Color string to validate
+     * @returns Detected color format or false if invalid
+     * @example
+     * ```javascript
+     * const format1 = color.validate("#FF5733"); // "hex"
+     * const format2 = color.validate("rgb(255, 87, 51)"); // "rgb"
+     * const format3 = color.validate("hsl(14, 100%, 60%)"); // "hsl"
+     * const format4 = color.validate("orangered"); // "css-color-name"
+     * const format5 = color.validate("invalid-color"); // false
+     * ```
+     */
+    validate(str: string): false | "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "css-color-name";
+    /**
+     * Convert color to different format
+     * @param str - Color string to convert (e.g. "#FF5733", "rgb(255, 87, 51)")
+     * @param format - Target format
+     * @returns - Converted color string
+     * @example
+     * ```javascript
+     * const hexColor = color.convert("rgb(255, 87, 51)", "hex"); // "#FF5733"
+     * const rgbColor = color.convert("#FF5733", "rgb"); // "rgb(255, 87, 51)"
+     * const hslColor = color.convert("#FF5733", "hsl"); // "hsl(14, 100%, 60%)"
+     * const colorName = color.convert("#FF5733", "css-color-name"); // "orangered"
+     * ```
+     */
+    convert(str: string, format: 'hex' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'css-color-name'): Promise<string | null>;
+}
+
+declare class SoundHelper {
+    playing: boolean;
+    audio: AudioContext;
+    /**
+     * Play sound from URL with optional volume and replace parameters
+     * @param url - Sound URL to play
+     * @param volume - Volume level from 0 to 100 (default: 100)
+     * @param replace - If true, replaces currently playing sound (default: false)
+     */
+    play(url: string, volume?: number, replace?: boolean): void;
+}
+
+declare class FunctionHelper {
+    /**
+     * Apply function with given thisArg and arguments
+     * @param fn - Function to apply
+     * @param thisArg - Value to use as this when calling fn
+     * @param args - Arguments to pass to fn
+     * @returns Result of calling fn with thisArg and args
+     */
+    apply<TThis, TArgs extends unknown[], TReturn>(fn: (this: TThis, ...args: TArgs) => TReturn, thisArg: TThis, args: TArgs): TReturn;
+    /**
+     * Call function with given thisArg and arguments
+     * @param fn - Function to call
+     * @param thisArg - Value to use as this when calling fn
+     * @param args - Arguments to pass to fn
+     * @returns Result of calling fn with thisArg and args
+     */
+    call<TThis, TArgs extends unknown[], TReturn>(fn: (this: TThis, ...args: TArgs) => TReturn, thisArg: TThis, ...args: TArgs): TReturn;
+}
+
+declare class UtilsHelper {
+    /**
+     * Delays execution for a specified number of milliseconds.
+     * @param ms - The number of milliseconds to delay.
+     * @returns A Promise that resolves after the specified delay.
+     */
+    delay<R extends any, M extends number>(ms: M, callback?: () => R): Promise<R | null>;
+    /**
+     * Returns typed entries of an object.
+     * @param obj - The object to get entries from.
+     * @returns An array of key-value pairs from the object.
+     */
+    typedEntries<K extends string, V>(obj: Record<K, V> | Array<V>): [K, V][];
+    /**
+     * Returns typed values of an object.
+     * @param obj - The object to get values from.
+     * @returns An array of values from the object.
+     */
+    typedValues<K extends string, V>(obj: Record<K, V> | Array<V>): V[];
+    /**
+     * Returns typed keys of an object.
+     * @param obj - The object to get keys from.
+     * @returns An array of keys from the object.
+     */
+    typedKeys<K extends string, V>(obj: Record<K, V> | Array<V>): K[];
+    /**
+     * Compares two dates and returns the difference in multiple time units.
+     *
+     * `total` values are based on raw milliseconds (can be decimal).
+     * `calendar` values use calendar boundaries for full months/years.
+     */
+    compareDates(date1: Date | string, date2: Date | string): {
+        milliseconds: number;
+        seconds: number;
+        minutes: number;
+        hours: number;
+        days: number;
+        months: number;
+        years: number;
+        absolute: {
+            milliseconds: number;
+            seconds: number;
+            minutes: number;
+            hours: number;
+            days: number;
+            months: number;
+            years: number;
+        };
+        calendar: {
+            months: number;
+            years: number;
+        };
+        isFuture: boolean;
+        isPast: boolean;
+        isSameMoment: boolean;
+    };
+    /**
+     * Selects an item based on weighted probabilities.
+     * @param items - An object where keys are items and values are their weights.
+     * @returns A randomly selected item based on the given probabilities.
+     * @example
+     * ```ts
+     * const utils = new UtilsHelper();
+     * const result = utils.probability({
+     *   apple: 0.5,
+     *   banana: 0.3,
+     *   cherry: 0.2,
+     * });
+     * console.log(result); // 'apple', 'banana', or 'cherry' based on the defined probabilities
+     * ```
+     */
+    probability<K extends string, V extends number>(items: Record<K, V>): K | undefined;
     /**
-     * Loads the ComfyJS script if not already loaded.
-     * @returns A promise that resolves to the ComfyJS instance.
+     * Finds the subscription tier of a user based on various sources of information.
+     * @param data - An object containing userId, name, and broadcasterId to identify the user.
+     * @param session - The current session data which may contain recent subscription information.
+     * @param checkWithAPI - Whether to check the subscription tier with an external API as a last resort.
+     * @returns A promise that resolves to the subscription tier of the user (1, 2, or 3).
+     * @example
+     * ```javascript
+     * const utils = new UtilsHelper();
+     * const tier = await utils.findSubscriptionTier(
+     *   { userId: '12345', name: 'exampleUser', broadcasterId: '67890' },
+     *   sessionData,
+     *   true
+     * );
+     * console.log(tier); // 1, 2, or 3 based on the user's subscription tier
+     * ```
      */
-    private load;
+    findSubscriptionTier({ userId, name, broadcasterId, }: {
+        userId: string;
+        name: string;
+        broadcasterId?: string;
+    }, session: StreamElements.Session.Data, checkWithAPI?: boolean): Promise<1 | 2 | 3>;
     /**
-     * Connects event handlers to the ComfyJS instance.
+     * Identifies a user based on the received event and session data, returning their ID, name, role, badges, and top status.
+     * @param receivedEvent - The event received from the provider (Twitch or YouTube) containing user information.
+     * @param session - The current session data which may contain recent activity and top user information.
+     * @returns A promise that resolves to an object containing the user's ID, name, role, badges, and top status, or undefined if the user cannot be identified.
+     * @example
+     * ```javascript
+     * const utils = new UtilsHelper();
+     * const userInfo = await utils.identifyUser(receivedEvent, sessionData);
+     * console.log(userInfo);
+     * // {
+     * //   id: '12345',
+     * //   name: 'exampleUser',
+     * //   role: 'moderator',
+     * //   badges: [{ type: 'moderator', version: '1', url: 'https:...', description: 'Moderator' }],
+     * //   top: {
+     * //     gifter: false,
+     * //     tip: {
+     * //       session: { donator: false, donation: false },
+     * //       weekly: { donator: false, donation: false },
+     * //       monthly: { donator: false, donation: false },
+     * //       alltime: { donator: false, donation: false },
+     * //     },
+     * //     ...
+     * //   }
+     * // }
+     * ```
      */
-    private connect;
+    identifyUser(receivedEvent: StreamElements.Event.Provider.Twitch.Message | StreamElements.Event.Provider.YouTube.Message, session: StreamElements.Session.Data): Promise<IdentifyYouTubeResult | IdentifyTwitchResult | undefined>;
 }
-
-declare namespace Helper {
-    namespace number {
-        /**
-         * Translate number to words
-         * @param num - Number to translate
-         * @param type - Translation type
-         * @returns - Number in words
-         * @example
-         * ```javascript
-         * const cardinal = Simulation.number.translate(42, 'cardinal');
-         * console.log(cardinal); // "forty-two"
-         * ```
-         */
-        function translate(num: number, type?: 'cardinal' | 'ordinal' | 'suffix'): string;
-        /**
-         * Balances a number within a specified range
-         * @param amount - Number to balance
-         * @param min - Minimum value
-         * @param max - Maximum value
-         * @param decimals - Number of decimal places to round to (default is 0)
-         * @returns - Balanced number
-         * @example
-         * ```javascript
-         * const balancedValue = Simulation.number.balance(150, 0, 100);
-         * console.log(balancedValue); // 100
-         * ```
-         */
-        function balance(amount: number, min?: number, max?: number, decimals?: number): number;
-        /**
-         * Rounds a number to a specified number of decimal places
-         * @param value - Number to round
-         * @param decimals - Number of decimal places (default is 2)
-         * @returns Rounded number
-         * @example
-         * ```javascript
-         * const roundedValue = Simulation.number.round(3.14159, 3);
-         * console.log(roundedValue); // 3.142
-         * ```
-         */
-        function round(value: number, decimals?: number): number;
-        /**
-         * Generate random number
-         * @param min - Minimum value
-         * @param max - Maximum value
-         * @param float - Number of decimal places (0 for integer)
-         * @returns - Random number
-         * @example
-         * ```javascript
-         * const intNumber = number.random(1, 10);
-         * console.log(intNumber); // e.g. 7
-         *
-         * const floatNumber = number.random(1, 10, 2);
-         * console.log(floatNumber); // e.g. 3.14
-         * ```
-         */
-        function number(min: number, max: number, float?: number): number;
-    }
-    namespace element {
-        interface ScaleOptions<T extends HTMLElement> {
-            /**
-             * The parent element to use for scaling calculations. If not provided, the element's parent will be used.
-             */
-            parent?: HTMLElement;
-            /**
-             * The preferred dimension to base the scaling on. Can be 'width', 'height', or 'auto' (default).
-             */
-            prefer?: 'width' | 'height' | 'auto';
-            /**
-             * The minimum percentage of the parent size to scale to. Default is 0.
-             */
-            min?: number;
-            /**
-             * The maximum percentage of the parent size to scale to. Default is 1 (100%).
-             */
-            max?: number;
-            /**
-             * A callback function that is called after scaling is applied.
-             * @param this - The HTML element being scaled.
-             * @param number - The scale factor applied to the element.
-             * @param element - The HTML element being scaled.
-             * @returns void
-             */
-            apply?: (this: T, number: number, element: T) => void;
-        }
-        type FitTextOptions = {
-            minFontSize?: number;
-            maxFontSize?: number;
-            parent?: HTMLElement;
+type TopType = {
+    gifter: boolean;
+    tip: {
+        session: {
+            donator: boolean;
+            donation: boolean;
         };
-        /**
-         * Merges outer span styles with inner span styles in the provided HTML string.
-         * @param outerStyle - The style string to be applied to the outer span.
-         * @param innerHTML - The inner HTML string which may contain a span with its own styles.
-         * @returns A new HTML string with merged styles applied to a single span.
-         * @example
-         * ```javascript
-         * const result = mergeSpanStyles("color: red; font-weight: bold;", '<span style="font-size: 14px;">Hello World</span>');
-         * console.log(result); // Output: '<span style="font-size: 14px; color: red; font-weight: bold;">Hello World</span>'
-         * ```
-         */
-        function mergeSpanStyles(outerStyle: string, innerHTML: string, className?: string): string;
-        /**
-         * Scales an HTML element to fit within its parent element based on specified minimum and maximum scale factors.
-         * @param element - The HTML element to be scaled.
-         * @param min - Minimum scale factor (default is 0).
-         * @param max - Maximum scale factor (default is 1).
-         * @param options - Optional settings for scaling.
-         * @returns - An object containing the new width, height, and scale factor, or void if not applied.
-         * @example
-         * ```javascript
-         * const element = document.getElementById('myElement');
-         * scale(element, 0.5, 1, { return: false });
-         * ```
-         */
-        function scale(element: HTMLElement, min?: number, max?: number, options?: {
-            return: boolean;
-            parent: HTMLElement;
-            base: 'width' | 'height';
-        }): {
-            width: number;
-            height: number;
-            scale: number;
-        } | void;
-        /**
-         * Scales an HTML element to fit within its parent element based on specified options.
-         * @param element - The HTML element to be scaled.
-         * @param options - Optional settings for scaling.
-         * @returns The scale factor applied to the element.
-         * @example
-         * ```javascript
-         * const element = document.getElementById('myElement');
-         * const scaleFactor  scalev2(element, {
-         *   min: 0.5,
-         *   max: 1,
-         *   prefer: 'width',
-         *   apply: (scale, el) => el.style.transform = `scale(${scale})`
-         * });
-         * console.log(`Element scaled by a factor of ${scaleFactor}`);
-         * ```
-         */
-        function scalev2<T extends HTMLElement>(element: T, options?: ScaleOptions<T>): number;
-        /**
-         * Fits the text within the parent element by adjusting the font size.
-         * @param element - The HTML element containing the text to be fitted.
-         * @param compressor - A multiplier to adjust the fitting sensitivity (default is 1).
-         * @param options - Optional settings for fitting text.
-         * @returns The HTML element with adjusted font size.
-         * @example
-         * ```javascript
-         * const element = document.getElementById('myTextElement');
-         * fitText(element, 1, { minFontSize: 12, maxFontSize: 36 });
-         * console.log(`Adjusted font size: ${element.style.fontSize}`);
-         * ```
-         */
-        function fitText(element: HTMLElement, compressor?: number, options?: FitTextOptions): HTMLElement;
-        /**
-         * Wraps formatted HTML text with containers and splits characters into indexed spans.
-         * Adds 'container' class and data-index to all parent elements, and wraps each character in a span with class 'char' and data-index.
-         * @param htmlString - The input HTML string containing formatted text elements (span, strong, em, etc).
-         * @param startIndex - The starting index for the data-index attribute (default is 0).
-         * @returns - A new HTML string with containers and character-level indexing.
-         * @example
-         * ```javascript
-         * const result = splitTextToChars('<span>TesTe</span> <strong>bold</strong>', 0);
-         * console.log(result);
-         * // Output: '<span class="container" data-index="0"><span class="char" data-index="0">T</span><span class="char" data-index="1">e</span>...'
-         * ```
-         */
-        function splitTextToChars(htmlString: string, startIndex?: number, preserveInterElementWhitespace?: boolean): string;
-    }
-    namespace object {
-        /**
-         * Flattens a nested object into a single-level object with dot-separated keys.
-         * @param obj - The nested object to be flattened.
-         * @param prefix  - The prefix to be added to each key (used for recursion).
-         * @returns A flattened object with dot-separated keys.
-         * @example
-         * ```javascript
-         * const nestedObj = { a: { b: 1, c: { d: 2 } }, e: [3, 4] };
-         * const flatObj = flatten(nestedObj);
-         * console.log(flatObj);
-         * // Output: { 'a.b': '1', 'a.c.d': '2', 'e:0': '3', 'e:1': '4' }
-         * ```
-         */
-        function flatten(obj: Record<string, any>, stringify?: boolean, prefix?: string): Record<string, typeof stringify extends true ? string : string | number | boolean>;
-        /**
-         * Returns the entries of an object as an array of key-value pairs, with proper typing.
-         * @param obj - The object to retrieve entries from.
-         * @returns An array of key-value pairs from the object, typed as an array of tuples with key and value types.
-         */
-        function entries<K extends string, V>(obj: Record<K, V>): [K, V][];
-        /**
-         * Returns the values of an object as an array, with proper typing.
-         * @param obj - The object to retrieve values from.
-         * @returns An array of values from the object, typed as an array of the value type.
-         */
-        function values<K extends string, V>(obj: Record<K, V>): V[];
-        /**
-         * Returns the keys of an object as an array of strings, with proper typing.
-         * @param obj - The object to retrieve keys from.
-         * @returns An array of keys from the object, typed as an array of strings.
-         */
-        function keys<K extends string, V>(obj: Record<K, V>): K[];
-    }
-    namespace message {
-        type BadgeOptions = Twitch.roles[] | Twitch.roles | `${Twitch.roles}/${number}` | `${Twitch.roles}/${number}`[];
-        type TwitchResult = {
-            keys: Twitch.roles[];
-            badges: Twitch.badge[];
-            amount: {
-                [K in Twitch.roles]?: number;
-            };
+        weekly: {
+            donator: boolean;
+            donation: boolean;
         };
-        type YouTubeResult = {
-            isVerified: boolean;
-            isChatOwner: boolean;
-            isChatSponsor: boolean;
-            isChatModerator: boolean;
+        monthly: {
+            donator: boolean;
+            donation: boolean;
         };
-        /**
-         * Finds emotes in a given text.
-         * @param text - The text to search for emotes.
-         * @param emotes - An array of emotes to search for. Defaults to Local data emotes.
-         * @returns An array of emotes found in the text with their positions.
-         */
-        function findEmotesInText(text: string, emotes?: Emote[]): Emote[];
-        /**
-         * Replaces emotes in the text with corresponding HTML image tags.
-         * @param text - The text containing emotes.
-         * @param emotes - An array of emotes with their positions in the text.
-         * @returns The text with emotes replaced by HTML image tags.
-         */
-        function replaceEmotesWithHTML(text: string, emotes: Emote[]): string;
-        /**
-         * Checks if the text contains only emotes and whitespace.
-         * @param text - The text to check.
-         * @param emotes - An array of emotes with their positions in the text.
-         * @returns True if the text contains only emotes and whitespace, false otherwise.
-         */
-        function hasOnlyEmotes(text: string, emotes: Emote[]): boolean;
-        /**
-         * Replaces YouTube emotes in the text with corresponding HTML image tags.
-         * @param text - The text containing YouTube emotes.
-         * @param emotes - An array of YouTube emotes. Defaults to Local data YouTube emotes.
-         * @returns The text with YouTube emotes replaced by HTML image tags.
-         */
-        function replaceYoutubeEmotesWithHTML(text: string, emotes?: {
-            emojiId: string;
-            shortcuts: string[];
-            searchTerms: string[];
-            image: {
-                thumbnails: {
-                    url: string;
-                    width: number;
-                    height: number;
-                }[];
-                accessibility: {
-                    accessibilityData: {
-                        label: string;
-                    };
-                };
-            };
-            isCustomEmoji: boolean;
-            index: number;
-        }[]): string;
-        /**
-         * Generates badge data based on the provided badges and platform.
-         * @param badges - The badges to generate. Can be an array or a comma-separated string.
-         * @param provider - The platform provider ('twitch' or 'youtube'). Defaults to 'twitch'.
-         * @returns A promise that resolves to the generated badge data.
-         * @example
-         * ```javascript
-         * // Generate Twitch badges
-         * const twitchBadges = await generateBadges(['broadcaster', 'moderator'], 'twitch');
-         * // Generate YouTube badges
-         * const youtubeBadges = await generateBadges('sponsor, moderator', 'youtube');
-         * ```
-         */
-        function generateBadges<T extends Provider$1>(badges: BadgeOptions | undefined, provider: T): Promise<T extends 'twitch' ? TwitchResult : YouTubeResult>;
-    }
-    namespace event {
-        /**
-         * Parses the provider information from the event detail object.
-         * @param detail - The event detail object received from the StreamElements event.
-         * @returns An object containing the provider and the original event data.
-         */
-        function parseProvider(detail: StreamElements.Event.onEventReceived, _provider?: Provider$1): ClientEvents$1;
-    }
-    namespace string {
-        type Modifier = (value: string, param: string | null | undefined, values: {
-            amount?: number;
-            count?: number;
-        }) => string;
-        const PRESETS: Record<string, string>;
-        /**
-         * Replaces occurrences in a string based on a pattern with the result of an asynchronous callback function.
-         * @param string - The input string to perform replacements on.
-         * @param pattern - The pattern to match in the string (can be a string or a regular expression).
-         * @param callback - An asynchronous callback function that takes the matched substring and any captured groups as arguments and returns the replacement string.
-         * @returns A promise that resolves to the modified string with replacements applied.
-         * @example
-         * ```javascript
-         * const result = await string.replace("Hello World", /World/, async (match) => {
-         *   return await fetchSomeData(match); // Assume this function fetches data asynchronously
-         * });
-         * console.log(result); // Output will depend on the fetched data
-         * ```
-         */
-        function replace(string: string, pattern: string, callback: (match: string, ...groups: string[]) => Promise<string> | string): Promise<string>;
-        /**
-         * Capitalizes the first letter of a given string.
-         * @param string - The input string to be capitalized.
-         * @returns The capitalized string.
-         * @example
-         * ```javascript
-         * const result = string.capitalize("hello world");
-         * console.log(result); // Output: "Hello world"
-         * ```
-         */
-        function capitalize(string: string): Capitalize<string>;
-        /**
-         * Composes a template string by replacing placeholders with corresponding values and applying optional modifiers.
-         * @param template - The template string containing placeholders in the format {key} and optional modifiers in the format [MODIFIER:param=value].
-         * @param values - An object containing key-value pairs to replace the placeholders in the template.
-         * @param options - Optional settings for the composition process.
-         * @returns The composed string with placeholders replaced and modifiers applied.
-         * @example
-         * ```javascript
-         * const { string } = Tixyel.Helper;
-         *
-         * // Basic usage with placeholders and simple modifiers
-         * const template1 = "Hello, {username}! You have {amount} [UPC=messages] and your name is [CAP=name].";
-         * const values1 = { username: "john_doe", amount: 5, name: "john" };
-         * const result1 = string.compose(template1, values1);
-         * // "Hello, john_doe! You have 5 MESSAGES and your name is John."
-         *
-         * // Multiple modifiers in a single block (HTML enabled)
-         * const template2 = "[COLOR:#ff0056,BOLD={username}]";
-         * const values2 = { username: "john_doe" };
-         * const result2 = string.compose(template2, values2, { html: true });
-         * // '<span class="color bold" style="color: #ff0056; font-weight: bold;">john_doe</span>'
-         *
-         * // Conditional rendering with IF (supports ===, >=, &&, ||, !, etc.)
-         * const template3 = "[IF=vip && status === 'live'?VIP Online|Offline]";
-         * const values3 = { status: 'live', vip: true };
-         * const result3 = string.compose(template3, values3);
-         * // "VIP Online"
-         *
-         * // Pluralization using amount / count or an explicit key
-         * const template4 = "You have {amount} [PLURAL=message|messages].";
-         * const values4 = { amount: 1 };
-         * const values5 = { amount: 3 };
-         * const result4a = string.compose(template4, values4); // "You have 1 message."
-         * const result4b = string.compose(template4, values5); // "You have 3 messages."
-         *
-         * // Number formatting
-         * const template5 = "Total: [NUMBER:2=amount] {currency}";
-         * const values6 = { amount: 1234.5, currency: '$' };
-         * const result5 = string.compose(template5, values6);
-         * // e.g. "Total: 1,234.50 $" (locale dependent)
-         *
-         * // Date and time formatting
-         * const template6 = "Created at: [DATE:iso=createdAt] ([DATE:relative=createdAt])";
-         * const values7 = { createdAt: new Date('2020-01-02T03:04:05.000Z') };
-         * const result6 = string.compose(template6, values7);
-         * // e.g. "Created at: 2020-01-02T03:04:05.000Z (Xs ago)"
-         *
-         * // MAP / SWITCH style mapping
-         * const template7 = "Status: [MAP:status=live:Online|offline:Offline|default:Unknown]";
-         * const values8 = { status: 'offline' };
-         * const result7 = string.compose(template7, values8);
-         * // "Status: Offline"
-         *
-         * // Escaping HTML
-         * const template8 = "[ESCAPE={message}]";
-         * const values9 = { message: '<b>Danger & "HTML"</b>' };
-         * const result8 = string.compose(template8, values9);
-         * // "&lt;b&gt;Danger &amp; &quot;HTML&quot;&lt;/b&gt;"
-         *
-         * // Using global presets
-         * Helper.string.PRESETS['alert'] = 'BOLD,COLOR:#ff0056';
-         * const template10 = "[PRESET:alert={username}]";
-         * const values11 = { username: 'john_doe' };
-         * const result10 = string.compose(template10, values11, { html: true });
-         * // '<span class="color bold" style="color: #ff0056; font-weight: bold;">john_doe</span>'
-         * ```
-         */
-        function compose(template: string, values?: Record<string, any>, options?: {
-            method?: 'loop' | 'index';
-            html?: boolean;
-            debug?: boolean;
-            modifiers?: Record<string, Modifier>;
-            aliases?: Record<string, string[]>;
-        }): string;
-    }
-    namespace sound {
-        let playing: boolean;
-        let audio: AudioContext;
-        /**
-         * Play sound from URL with optional volume and replace parameters
-         * @param url - Sound URL to play
-         * @param volume - Volume level from 0 to 100 (default: 100)
-         * @param replace - If true, replaces currently playing sound (default: false)
-         */
-        function play(url: string, volume?: number, replace?: boolean): void;
-    }
-    namespace color {
-        /**
-         * Generate opacity hex value
-         * @param opacity - Opacity value from 0 to 100
-         * @param color - Hex color code
-         * @returns - Hex color code with opacity
-         */
-        function opacity(opacity?: number, color?: string): string;
-        /**
-         * Extract color and opacity from hex code
-         * @param hex - Hex color code
-         * @returns - Object with color and opacity
-         */
-        function extract(hex: string): {
-            color: string;
-            opacity: number;
+        alltime: {
+            donator: boolean;
+            donation: boolean;
         };
-        /**
-         * Validate color string format
-         * @param str - Color string to validate
-         * @returns Detected color format or false if invalid
-         * @example
-         * ```javascript
-         * const format1 = color.validate("#FF5733"); // "hex"
-         * const format2 = color.validate("rgb(255, 87, 51)"); // "rgb"
-         * const format3 = color.validate("hsl(14, 100%, 60%)"); // "hsl"
-         * const format4 = color.validate("orangered"); // "css-color-name"
-         * const format5 = color.validate("invalid-color"); // false
-         * ```
-         */
-        function validate(str: string): false | "hex" | "rgb" | "rgba" | "hsl" | "hsla" | "css-color-name";
-        /**
-         * Convert color to different format
-         * @param str - Color string to convert (e.g. "#FF5733", "rgb(255, 87, 51)")
-         * @param format - Target format
-         * @returns - Converted color string
-         * @example
-         * ```javascript
-         * const hexColor = color.convert("rgb(255, 87, 51)", "hex"); // "#FF5733"
-         * const rgbColor = color.convert("#FF5733", "rgb"); // "rgb(255, 87, 51)"
-         * const hslColor = color.convert("#FF5733", "hsl"); // "hsl(14, 100%, 60%)"
-         * const colorName = color.convert("#FF5733", "css-color-name"); // "orangered"
-         * ```
-         */
-        function convert(str: string, format: 'hex' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'css-color-name'): Promise<string | null>;
-    }
-    namespace random {
-        /**
-         * Generate random color
-         * @param type - Color format
-         * @returns - Random color in specified format
-         * @example
-         * ```javascript
-         * const hexColor = random.color('hex');
-         * console.log(hexColor); // e.g. #3e92cc
-         *
-         * const rgbColor = random.color('rgb');
-         * console.log(rgbColor); // e.g. rgb(62, 146, 204)
-         * ```
-         */
-        function color(type?: 'hex' | 'hexa' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'css-color-name'): string;
-        /**
-         * Generate random number
-         * @param min - Minimum value
-         * @param max - Maximum value
-         * @param float - Number of decimal places (0 for integer)
-         * @returns - Random number
-         * @example
-         * ```javascript
-         * const intNumber = random.number(1, 10);
-         * console.log(intNumber); // e.g. 7
-         *
-         * const floatNumber = random.number(1, 10, 2);
-         * console.log(floatNumber); // e.g. 3.14
-         * ```
-         */
-        function number(min: number, max: number, float?: number): number;
-        /**
-         * Generate random boolean
-         * @param threshold - Threshold between 0 and 1
-         * @returns - Random boolean
-         * @example
-         * ```javascript
-         * const boolValue = random.boolean(0.7);
-         * console.log(boolValue); // e.g. true (70% chance)
-         * ```
-         */
-        function boolean(threshold?: number): boolean;
-        /**
-         * Generate random string
-         * @param length - Length of the string
-         * @param chars - Characters to use
-         * @returns - Random string
-         * @example
-         * ```javascript
-         * const randString = random.string(10);
-         * console.log(randString); // e.g. "aZ3bT9xYqP"
-         * ```
-         */
-        function string(length: number, chars?: string): string;
-        /**
-         * Pick random element from array
-         * @param arr - Array to pick from
-         * @returns - Random element and its index
-         * @example
-         * ```javascript
-         * const [element, index] = random.array(['apple', 'banana', 'cherry']);
-         * console.log(element, index); // e.g. "banana", 1
-         * ```
-         */
-        function array<T>(arr: T[]): [value: T, index: number];
-        /**
-         * Generate random date
-         * @param start - Start date
-         * @param end - End date
-         * @returns - Random date between start and end
-         * @example
-         * ```javascript
-         * const randDate = random.date(new Date(2020, 0, 1), new Date());
-         * console.log(randDate); // e.g. 2022-05-15T10:30:00.000Z
-         * ```
-         */
-        function date(start?: Date, end?: Date): Date;
-        /**
-         * Generate ISO date string offset by days
-         * @param daysAgo - Number of days to go back
-         * @returns - ISO date string
-         * @example
-         * ```javascript
-         * const isoDate = random.daysOffset(7);
-         * console.log(isoDate); // e.g. "2024-06-10T14:23:45.678Z"
-         *
-         * const isoDate30 = random.daysOffset(30);
-         * console.log(isoDate30); // e.g. "2024-05-18T09:15:30.123Z"
-         * ```
-         */
-        function daysOffset(daysAgo: number): string;
-        /**
-         * Generate UUID v4
-         * @returns - UUID string
-         * @example
-         * ```javascript
-         * const uuid = random.uuid();
-         * console.log(uuid); // e.g. "3b12f1df-5232-4e3a-9a0c-3f9f1b1b1b1b"
-         * ```
-         */
-        function uuid(): string;
-    }
-    namespace fn {
-        /**
-         * Apply function with given thisArg and arguments
-         * @param fn - Function to apply
-         * @param thisArg - Value to use as this when calling fn
-         * @param args - Arguments to pass to fn
-         * @returns Result of calling fn with thisArg and args
-         */
-        function apply<TThis, TArgs extends unknown[], TReturn>(fn: (this: TThis, ...args: TArgs) => TReturn, thisArg: TThis, args: TArgs): TReturn;
-        /**
-         * Call function with given thisArg and arguments
-         * @param fn - Function to call
-         * @param thisArg - Value to use as this when calling fn
-         * @param args - Arguments to pass to fn
-         * @returns Result of calling fn with thisArg and args
-         */
-        function call<TThis, TArgs extends unknown[], TReturn>(fn: (this: TThis, ...args: TArgs) => TReturn, thisArg: TThis, ...args: TArgs): TReturn;
-    }
-    namespace utils {
-        /**
-         * Delays execution for a specified number of milliseconds.
-         * @param ms - The number of milliseconds to delay.
-         * @returns A Promise that resolves after the specified delay.
-         */
-        function delay<R extends any, M extends number>(ms: M, callback?: () => R): Promise<R | null>;
-        /**
-         * Returns typed entries of an object.
-         * @param obj - The object to get entries from.
-         * @returns An array of key-value pairs from the object.
-         */
-        function typedEntries<K extends string, V>(obj: Record<K, V> | Array<V>): [K, V][];
-        /**
-         * Returns typed values of an object.
-         * @param obj - The object to get values from.
-         * @returns An array of values from the object.
-         */
-        function typedValues<K extends string, V>(obj: Record<K, V> | Array<V>): V[];
-        /**
-         * Returns typed keys of an object.
-         * @param obj - The object to get keys from.
-         * @returns An array of keys from the object.
-         */
-        function typedKeys<K extends string, V>(obj: Record<K, V> | Array<V>): K[];
-        /**
-         * Selects an item based on weighted probabilities.
-         * @param items - An object where keys are items and values are their weights.
-         * @returns A randomly selected item based on the given probabilities.
-         */
-        function probability<K extends string, V extends number>(items: Record<K, V>): K | undefined;
-    }
+    };
+    cheer: {
+        session: {
+            donator: boolean;
+            amount: boolean;
+        };
+        weekly: {
+            donator: boolean;
+            amount: boolean;
+        };
+        monthly: {
+            donator: boolean;
+            amount: boolean;
+        };
+        alltime: {
+            donator: boolean;
+            amount: boolean;
+        };
+    };
+    superchat: {
+        session: {
+            donator: boolean;
+            amount: boolean;
+        };
+        weekly: {
+            donator: boolean;
+            amount: boolean;
+        };
+        monthly: {
+            donator: boolean;
+            amount: boolean;
+        };
+        alltime: {
+            donator: boolean;
+            amount: boolean;
+        };
+    };
+};
+type IdentifyTwitchResult = {
+    id: string;
+    name: string;
+    color: string;
+    role: Twitch.tags;
+    tags: Twitch.tags[];
+    badges: string;
+    tier?: 1 | 2 | 3;
+    top: TopType;
+};
+type IdentifyYouTubeResult = {
+    id: string;
+    name: string;
+    role: 'broadcaster' | 'moderator' | 'sponsor' | 'verified' | 'viewer';
+    badges: unknown[];
+    top: TopType;
+};
+
+declare namespace Helper {
+    const number: NumberHelper;
+    const element: ElementHelper;
+    const object: ObjectHelper;
+    const message: MessageHelper;
+    const event: EventHelper;
+    const string: StringHelper;
+    const sound: SoundHelper;
+    const color: ColorHelper;
+    const random: RandomHelper;
+    const fn: FunctionHelper;
+    const utils: UtilsHelper;
 }
 
 declare namespace Local {
@@ -2784,7 +3168,7 @@ declare namespace Local {
             message(data?: Partial<{
                 name: string;
                 message: string;
-                badges: Helper.message.BadgeOptions;
+                badges: BadgeOptions;
                 color: string;
                 userId: string;
                 msgId: string;
@@ -2844,7 +3228,7 @@ declare namespace Local {
             message(data?: Partial<{
                 name: string;
                 message: string;
-                badges: Helper.message.BadgeOptions;
+                badges: BadgeOptions;
                 color: string;
                 userId: string;
                 msgId: string;
@@ -2880,35 +3264,48 @@ declare namespace Local {
     function start(fieldsFile?: string[], dataFiles?: string[], session?: StreamElements.Session.Data): Promise<void>;
 }
 
-declare namespace Data {
-    const avatars: string[];
-    const badges: Record<Twitch.roles, Twitch.badge>;
-    const css_color_names: string[];
-    const emotes: (TwitchEmote | BttvEmote | SeventvEmote)[];
-    const items: any[];
-    const messages: string[];
-    const names: string[];
-    const tiers: string[];
-    const tts: string[];
-    const youtube_emotes: {
-        emojiId: string;
-        shortcuts: string[];
-        searchTerms: string[];
-        image: {
-            thumbnails: {
-                url: string;
-                width: number;
-                height: number;
-            }[];
-            accessibility: {
-                accessibilityData: {
-                    label: string;
-                };
-            };
-        };
-        isCustomEmoji: boolean;
-        index: number;
-    }[];
+declare class FakeUser {
+    readonly id: string;
+    readonly name: string;
+    readonly login: string;
+    badges: Twitch.tags[];
+    isSubscriber: boolean;
+    tier?: StreamElements.Event.Provider.Twitch.SubscriberTier;
+    constructor(id: string, name: string, badges?: Twitch.tags[], isSubscriber?: boolean, tier?: StreamElements.Event.Provider.Twitch.SubscriberTier);
+}
+interface FakeUserPoolOptions {
+    id?: string;
+    badges?: Twitch.tags[];
+    limits?: {
+        [key in Twitch.tags]?: number;
+    };
+    fixed?: {
+        [key in Twitch.tags]?: string[];
+    };
+}
+type FakeUserPoolEvents = {
+    'warn': [warning: Error];
+};
+declare class FakeUserPool extends EventProvider<FakeUserPoolEvents> {
+    readonly users: FakeUser[];
+    readonly id: string;
+    private readonly byId;
+    private readonly byName;
+    private readonly byBadge;
+    private static fixUser;
+    private static getRandomSubTier;
+    constructor(names?: string[], options?: FakeUserPoolOptions);
+    private start;
+    pick(): FakeUser | null;
+    getByName(name: string): FakeUser | null;
+    getById(id: string): FakeUser | null;
+    getByBadge(badge: Twitch.tags): FakeUser[];
+    getToReply(target: {
+        id?: string;
+        name?: string;
+    }, extend?: Partial<Twitch.Reply>): Twitch.Reply | null;
+    buildTwitchMessage(messages?: string[]): Parameters<(typeof Local)['emulate']['twitch']['message']>[0];
+    buildYouTubeMessage(messages?: string[]): Parameters<(typeof Local)['emulate']['youtube']['message']>[0];
 }
 
 type MessageMap = Record<string, any>;
@@ -2976,6 +3373,7 @@ declare const main: {
         useQueue: typeof useQueue;
         useLogger: typeof useLogger;
         useComms: typeof useComms;
+        FakeUserPool: typeof FakeUserPool;
     };
     actions: {
         Button: typeof Button;
@@ -2989,6 +3387,7 @@ declare const main: {
         usedComms: useComms<any>[];
         usedCommands: Command[];
         usedButtons: Button[];
+        fakeUserPools: FakeUserPool[];
     };
     pronouns: {
         Alejo: typeof Alejo;
@@ -3012,4 +3411,4 @@ declare global {
 }
 
 export { Alejo, Button, Command, EventProvider, StreamElements, StreamElementsEvents, Twitch, TwitchEvents, YoutubeEvents, main as default, useComfyJs, useLogger, useQueue, useStorage };
-export type { BttvEmote, ClientEvents$1 as ClientEvents, Emoji, Emote, Provider$1 as Provider, SeventvEmote, TwitchEmote };
+export type { BttvEmote, ClientEvents$1 as ClientEvents, Emoji, Emote, FfzEmote, JSONObject, JSONPrimitive, JSONSerializable, MapNumberValuesToString, NumberAsString, PathValue, Provider$1 as Provider, RequireAtLeastOne, SeventvEmote, TwitchEmote };