@crowbartools/firebot-types 5.67.0-alpha22 → 5.67.0-alpha24

package/backend/backup-manager.d.ts

@@ -27,6 +27,7 @@ declare class BackupManager {
     private extractBackupZip;
     private copyRestoreFilesToUserData;
     private moveBackupFolder;
+    triggerUiRefresh(): void;
 }
 declare const backupManager: BackupManager;
 export { backupManager as BackupManager };

package/backend/channel-rewards/channel-reward-manager.d.ts

@@ -25,6 +25,7 @@ declare class ChannelRewardManager {
     getChannelRewardRedemptions(): Record<string, RewardRedemption[]>;
     approveOrRejectChannelRewardRedemptions(request: RewardRedemptionsApprovalRequest): Promise<void>;
     approveOrRejectAllRedemptionsForChannelRewards(rewardIds: string[], approve?: boolean): Promise<void>;
+    triggerUiRefresh(): void;
 }
 declare const channelRewardManager: ChannelRewardManager;
 export = channelRewardManager;

package/backend/chat/moderation/chat-moderation-manager.d.ts

@@ -39,6 +39,7 @@ declare class ChatModerationManager {
     private deleteMessage;
     load(): void;
     moderateMessage(chatMessage: FirebotChatMessage): Promise<void>;
+    triggerUiRefresh(): void;
 }
 declare const chatModerationManager: ChatModerationManager;
 export { chatModerationManager as ChatModerationManager };

package/backend/common/frontend-communicator.d.ts

@@ -2,9 +2,9 @@ import type { FrontendCommunicatorModule } from "../../types";
 declare class FrontendCommunicator implements FrontendCommunicatorModule {
     private _listeners;
     private registerEventWithElectron;
-    send<ExpectedArg = unknown>(eventName: string, data?: ExpectedArg): void;
-    sendToVariableInspector(eventName: string, data?: unknown): void;
-    fireEventAsync<ReturnPayload = void, ExpectedArg = unknown>(eventName: string, data?: ExpectedArg): Promise<ReturnPayload>;
+    send<ExpectedArgs extends Array<unknown> = []>(eventName: string, ...data: ExpectedArgs): void;
+    sendToVariableInspector(eventName: string, ...data: unknown[]): void;
+    fireEventAsync<ReturnPayload = void, ExpectedArgs extends Array<unknown> = []>(eventName: string, ...data: ExpectedArgs): Promise<ReturnPayload>;
     private registerListener;
     on<ExpectedArgs extends Array<unknown> = [], ReturnPayload = void>(eventName: string, callback: (...args: ExpectedArgs) => ReturnPayload): string;
     onAsync<ExpectedArgs extends Array<unknown> = [], ReturnPayload = void>(eventName: string, callback: (...args: ExpectedArgs) => Promise<ReturnPayload>): string;

package/backend/common/icon-manager.d.ts

@@ -1,8 +1,10 @@
 import type { FontAwesomeIcon } from "../../types";
 declare class IconManager {
+    private logger;
     icons: FontAwesomeIcon[];
     constructor();
     loadFontAwesomeIcons(): Promise<void>;
+    triggerUiRefresh(): void;
 }
 declare const iconManager: IconManager;
 export { iconManager as IconManager };

package/backend/control-deck/control-type-manager.d.ts

@@ -8,6 +8,7 @@ declare class ControlDeckControlTypeManager {
     getControlType(id: string): ControlDeckControlType<any, any> | null;
     getAllControlTypes(): ControlDeckControlType<any, any>[];
     private getControlTypesForFrontend;
+    triggerUiRefresh(): void;
 }
 declare const manager: ControlDeckControlTypeManager;
 export { manager as ControlDeckControlTypeManager };

package/backend/currency/currency-access.d.ts

@@ -20,6 +20,7 @@ declare class CurrencyAccess extends EventEmitter {
     updateCurrency(currency: Currency): void;
     deleteCurrency(id: string): void;
     private saveAllCurrencies;
+    triggerUiRefresh(): void;
 }
 declare const currencyAccess: CurrencyAccess;
 export default currencyAccess;

package/backend/effects/builtin/overlay-widgets/clear-chat-widget.d.ts

@@ -0,0 +1,5 @@
+import type { EffectType } from "../../../../types";
+declare const model: EffectType<{
+    chatWidgetId: string;
+}>;
+export = model;

package/backend/effects/effect-manager.d.ts

@@ -36,7 +36,6 @@ declare class EffectManager extends TypedEmitter<{
     mapEffectForFrontEnd(e: EffectType): {
         definition?: undefined;
         optionsTemplate?: undefined;
-        optionsTemplateUrl?: undefined;
         optionsControllerRaw?: undefined;
         optionsValidatorRaw?: undefined;
         getDefaultLabelRaw?: undefined;
@@ -59,7 +58,6 @@ declare class EffectManager extends TypedEmitter<{
             isNoOp?: boolean;
         };
         optionsTemplate: string;
-        optionsTemplateUrl: string;
         optionsControllerRaw: string;
         optionsValidatorRaw: string;
         getDefaultLabelRaw: string;

package/backend/games/game-manager.d.ts

@@ -28,6 +28,7 @@ declare class GameManager {
     private getGameSettingsFromValues;
     private updateGameSettings;
     private saveAllGameSettings;
+    triggerUiRefresh(): void;
 }
 declare const manager: GameManager;
 export { manager as GameManager };

package/backend/integrations/builtin/obs/effects/change-scene-collection.d.ts

@@ -1,4 +1,5 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const ChangeSceneCollectionEffectType: EffectType<{
     sceneCollectionName: string;
+    custom: boolean;
 }>;

package/backend/integrations/builtin/obs/effects/change-scene-effect-type.d.ts

@@ -1,4 +1,5 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const ChangeSceneEffectType: EffectType<{
     sceneName: string;
+    custom: boolean;
 }>;

package/backend/integrations/builtin/obs/effects/create-recording-chapter.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const CreateRecordChapter: EffectType<{
     chapterName: string;
 }>;

package/backend/integrations/builtin/obs/effects/save-replay-buffer.d.ts

@@ -1,2 +1,2 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SaveReplayBufferEffectType: EffectType;

package/backend/integrations/builtin/obs/effects/send-raw-obs-websocket-request.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SendRawOBSWebSocketRequestEffectType: EffectType<{
     functionName: string;
     payload: string;

package/backend/integrations/builtin/obs/effects/set-obs-browser-source-url.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SetOBSBrowserSourceUrlEffectType: EffectType<{
     browserSourceName: string;
     url: string;

package/backend/integrations/builtin/obs/effects/set-obs-color-source-color.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SetOBSColorSourceColorEffectType: EffectType<{
     colorSourceName: string;
     color: string;

package/backend/integrations/builtin/obs/effects/set-obs-image-source-file.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SetOBSImageSourceFileEffectType: EffectType<{
     imageSourceName: string;
     file: string;

package/backend/integrations/builtin/obs/effects/set-obs-media-source-file.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SetOBSMediaSourceFileEffectType: EffectType<{
     mediaSourceName: string;
     file: string;

package/backend/integrations/builtin/obs/effects/set-obs-source-text.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const SetOBSSourceTextEffectType: EffectType<{
     textSourceName: string;
     textSource: "static" | "file";

package/backend/integrations/builtin/obs/effects/start-stream.d.ts

@@ -1,2 +1,2 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const StartStreamEffectType: EffectType;

package/backend/integrations/builtin/obs/effects/start-virtual-cam.d.ts

@@ -1,2 +1,2 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const StartVirtualCamEffectType: EffectType;

package/backend/integrations/builtin/obs/effects/stop-stream.d.ts

@@ -1,2 +1,2 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const StopStreamEffectType: EffectType;

package/backend/integrations/builtin/obs/effects/stop-virtual-cam.d.ts

@@ -1,2 +1,2 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 export declare const StopVirtualCamEffectType: EffectType;

package/backend/integrations/builtin/obs/effects/toggle-obs-source-filter.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 type SourceAction = boolean | "toggle";
 type EffectProperties = {
     selectedFilters: Array<{

package/backend/integrations/builtin/obs/effects/toggle-obs-source-muted.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 type SourceAction = boolean | "toggle";
 type EffectProperties = {
     selectedSources: Array<{

package/backend/integrations/builtin/obs/effects/toggle-obs-source-visibility.d.ts

@@ -1,4 +1,4 @@
-import { EffectType } from "../../../../../types/effects";
+import type { EffectType } from "../../../../../types";
 type SourceAction = boolean | "toggle";
 type EffectProperties = {
     selectedSources: Array<{

package/backend/integrations/builtin/obs/effects/transform-obs-source.d.ts

@@ -1,5 +1,5 @@
-import { EffectType } from "../../../../../types/effects";
-import { OBSSceneItem } from "../obs-remote";
+import type { EffectType } from "../../../../../types";
+import { type OBSSceneItem } from "../obs-remote";
 export declare const TransformSourceEffectType: EffectType<{
     sceneName?: string;
     sceneItem?: OBSSceneItem;

package/backend/integrations/builtin/obs/events/obs-event-source.d.ts

@@ -1,2 +1,2 @@
-import { EventSource } from "../../../../../types/events";
+import type { EventSource } from "../../../../../types";
 export declare const OBSEventSource: EventSource;

package/backend/integrations/builtin/obs/filters/group-name-filter.d.ts

@@ -1,3 +1,3 @@
-import { EventFilter } from "../../../../../types/events";
+import type { EventFilter } from "../../../../../types";
 declare const filter: EventFilter;
 export default filter;

package/backend/integrations/builtin/obs/filters/scene-name-filter.d.ts

@@ -1,3 +1,3 @@
-import { EventFilter } from "../../../../../types/events";
+import type { EventFilter } from "../../../../../types";
 declare const filter: EventFilter;
 export default filter;

package/backend/integrations/builtin/obs/variables/group-item-id.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const GroupItemIdVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/group-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const GroupNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-active.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputActiveVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-audio-balance.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputAudioBalanceVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-audio-monitor-type.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputAudioMonitorTypeVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-audio-sync-offset.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputAudioSyncOffsetVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-audio-tracks.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputAudioTracksVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-kind.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputKindVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-muted.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputMutedVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-settings.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputSettingsVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-showing.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputShowingVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-uuid.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputUuidVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-volume-db.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputVolumeDbVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/input-volume-multiplier.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const InputVolumeMultiplierVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/is-connected.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const IsConnectedVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/is-recording.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const IsRecordingVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/is-streaming.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const IsStreamingVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/obs-color-value.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const ColorValueVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/old-input-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const OldInputNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/profile-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const ProfileNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/replay-buffer-path.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const ReplayBufferPathVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/scene-collection-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const SceneCollectionNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/scene-item-enabled.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const SceneItemEnabledVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/scene-item-id.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const SceneItemIdVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/scene-item-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const SceneItemNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/scene-name-variable.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const SceneNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/transition-duration.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const TransitionDurationVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/transition-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const TransitionNameVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/vendor-event-data.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const VendorEventDataVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/vendor-event-type.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const VendorEventTypeVariable: ReplaceVariable;

package/backend/integrations/builtin/obs/variables/vendor-name.d.ts

@@ -1,2 +1,2 @@
-import { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 export declare const VendorNameVariable: ReplaceVariable;

package/backend/internal-bus.d.ts

@@ -0,0 +1,16 @@
+import { ChannelPoll, ChannelPrediction } from "../types";
+import { TypedEmitter } from "tiny-typed-emitter";
+type Events = {
+    'channel-poll-begin': (poll: ChannelPoll) => void;
+    'channel-poll-progress': (poll: ChannelPoll) => void;
+    'channel-poll-end': (poll: ChannelPoll) => void;
+    'channel-prediction-begin': (prediction: ChannelPrediction) => void;
+    'channel-prediction-progress': (prediction: ChannelPrediction) => void;
+    'channel-prediction-lock': (prediction: ChannelPrediction) => void;
+    'channel-prediction-end': (prediction: ChannelPrediction) => void;
+};
+declare class InternalBus extends TypedEmitter<Events> {
+    constructor();
+}
+declare const bus: InternalBus;
+export { bus as InternalBus };

package/backend/notifications/notification-manager.d.ts

@@ -19,6 +19,7 @@ declare class NotificationManager {
     startExternalNotificationCheck(): void;
     stopExternalNotificationCheck(): void;
     migrateLegacyScriptNotifications(): void;
+    triggerUiRefresh(): void;
 }
 declare const manager: NotificationManager;
 export { manager as NotificationManager };

package/backend/overlay-widgets/builtin-types/index.d.ts

@@ -44,5 +44,5 @@ declare const _default: (import("../../../types").OverlayWidgetType<{
     imageType: "local" | "url";
     filepath: string;
     url: string;
-}, {}> | import("../../../types").OverlayWidgetType<import("./chat/chat").ChatWidgetSettings, import("./chat/chat").ChatWidgetState> | import("../../../types").OverlayWidgetType<import("./chat/chat-advanced").AdvancedChatWidgetSettings, import("./chat/chat").ChatWidgetState>)[];
+}, {}> | import("../../../types").OverlayWidgetType<import("./chat/chat").ChatWidgetSettings, import("./chat/chat").ChatWidgetState> | import("../../../types").OverlayWidgetType<import("./chat/chat-advanced").AdvancedChatWidgetSettings, import("./chat/chat").ChatWidgetState> | import("../../../types").OverlayWidgetType<import("./twitch-poll/twitch-poll").PollSettings, import("./twitch-poll/twitch-poll").PollState> | import("../../../types").OverlayWidgetType<import("./twitch-prediction/twitch-prediction").PredictionSettings, import("./twitch-prediction/twitch-prediction").PredictionState>)[];
 export default _default;

package/backend/overlay-widgets/builtin-types/twitch-poll/twitch-poll.d.ts

@@ -0,0 +1,17 @@
+import { OverlayWidgetType } from "../../../../types/overlay-widgets";
+import { FontOptions } from "../../../../types/parameters";
+import { ChannelPoll } from "../../../../types";
+export declare const TWITCH_POLL_TYPE_ID = "firebot:twitch-poll";
+export type PollSettings = {
+    fontOptions?: FontOptions;
+    accentColor: string;
+    backgroundColor: string;
+    timeBarColor: string;
+    showPercentages: boolean;
+    /** How long (seconds) to keep the final results visible after the poll ends. */
+    lingerSeconds: number;
+};
+export type PollState = {
+    poll: ChannelPoll | null;
+};
+export declare const twitchPoll: OverlayWidgetType<PollSettings, PollState>;

package/backend/overlay-widgets/builtin-types/twitch-prediction/twitch-prediction.d.ts

@@ -0,0 +1,16 @@
+import { OverlayWidgetType } from "../../../../types/overlay-widgets";
+import { FontOptions } from "../../../../types/parameters";
+import { ChannelPrediction } from "../../../../types";
+export declare const TWITCH_PREDICTION_TYPE_ID = "firebot:twitch-prediction";
+export type PredictionSettings = {
+    fontOptions?: FontOptions;
+    backgroundColor: string;
+    timeBarColor: string;
+    showUsers: boolean;
+    /** How long (seconds) to keep the final results visible after the prediction ends. */
+    lingerSeconds: number;
+};
+export type PredictionState = {
+    prediction: ChannelPrediction | null;
+};
+export declare const twitchPrediction: OverlayWidgetType<PredictionSettings, PredictionState>;

package/backend/overlay-widgets/builtin-widget-helpers.d.ts

@@ -0,0 +1,2 @@
+import { OverlayWidgetType } from "../../types";
+export declare function loadComponentExtension(componentFileName: string): OverlayWidgetType<any, any>["componentExtension"];

package/backend/overlay-widgets/overlay-widgets-manager.d.ts

@@ -26,11 +26,28 @@ declare class OverlayWidgetsManager extends TypedEmitter<Events> {
         eventHandler: (event: WidgetOverlayEvent, utils: import("../../types").IOverlayWidgetEventUtils) => void;
         onInitialLoad: (utils: import("../../types").IOverlayWidgetInitUtils) => import("../../types").Awaitable<void>;
     }[];
+    getOverlayComponents(): {
+        typeId: string;
+        dependencies: {
+            css?: string[];
+            js?: Array<string | {
+                module: boolean;
+                url: string;
+            }>;
+            globalStyles?: string;
+        };
+    }[];
+    /**
+     * Returns the inline ESM bundle source for a component widget registered with `bundleSource`
+     */
+    getOverlayComponentSource(typeId: string): string | null;
     sendWidgetEventToOverlay<EventName extends WidgetOverlayEvent["name"]>(eventName: EventName, widgetConfig: OverlayWidgetConfig, messageInfo?: EventName extends "message" ? {
         messageName: string;
         messageData?: unknown;
     } : undefined, previewMode?: boolean): Promise<void>;
     private formatForFrontend;
+    private formatStateDisplaysForFrontend;
+    triggerUiRefresh(): void;
 }
 declare const manager: OverlayWidgetsManager;
 export = manager;

package/backend/power-ups/power-ups-manager.d.ts

@@ -12,6 +12,7 @@ declare class PowerUpsManager {
     getPowerUpIdByName(powerUpName: string): string;
     private triggerPowerUpEffects;
     triggerPowerUp(powerUpId: string, metadata: PowerUpRedemptionMetadata, manual?: boolean): Promise<boolean | void>;
+    triggerUiRefresh(): void;
 }
 declare const powerUpsManager: PowerUpsManager;
 export = powerUpsManager;

package/backend/roles/team-roles-manager.d.ts

@@ -1,10 +1,12 @@
 import type { FirebotRole } from "../../types";
 declare class TeamRolesManager {
+    private logger;
     private _streamerTeams;
     constructor();
     loadTeamRoles(): Promise<void>;
     getTeamRoles(): Promise<FirebotRole[]>;
     getAllTeamRolesForViewer(userIdOrName: string): Promise<FirebotRole[]>;
+    triggerUiRefresh(): Promise<void>;
 }
 declare const teamRolesManager: TeamRolesManager;
 export = teamRolesManager;

package/backend/sort-tags/sort-tag-manager.d.ts

@@ -12,6 +12,7 @@ declare class SortTagManager {
     saveSortTagsForContext(context: string, sortTags: SortTag[]): void;
     getSortTagsForContext(context: string): SortTag[];
     private saveAllSortTags;
+    triggerUiRefresh(): void;
 }
 declare const sortTagManager: SortTagManager;
 export { sortTagManager as SortTagManager };

package/backend/streaming-platforms/twitch/api/twurple-logger.d.ts

@@ -0,0 +1,2 @@
+import type { LogLevel } from "@d-fischer/logger";
+export declare function logTwurpleMessage(level: LogLevel, message: string): void;

package/backend/ui-extensions/ui-extension-manager.d.ts

@@ -1,11 +1,13 @@
 import type { UIExtension } from "../../types";
 declare class UIExtensionManager {
+    private _logger;
     private _extensions;
     private uiReady;
-    registerUIExtension(extension: UIExtension): void;
-    setUIReadyForExtensions(): void;
+    constructor();
+    registerUIExtension(extension: UIExtension, pluginId?: string): boolean;
+    private setUIReadyForExtensions;
     private prepareExtensionForFrontend;
     private prepareFunc;
 }
 declare const manager: UIExtensionManager;
-export = manager;
+export { manager as UIExtensionManager };

package/backend/variables/builtin/metadata/arg.d.ts

@@ -1,3 +1,3 @@
-import type { ReplaceVariable } from "../../../../types/variables";
+import type { ReplaceVariable } from "../../../../types";
 declare const model: ReplaceVariable;
 export default model;

package/backend/variables/builtin/metadata/target.d.ts

@@ -1,4 +1,4 @@
-import type { ReplaceVariable } from "../../../../types/variables";
+import type { ReplaceVariable } from "../../../../types";
 /**
  * The $target variable
  */

package/backend/variables/builtin/misc/discord-timestamp.d.ts

@@ -1,3 +1,3 @@
-import type { ReplaceVariable } from "../../../../types/variables";
+import type { ReplaceVariable } from "../../../../types";
 declare const model: ReplaceVariable;
 export default model;

package/backend/variables/builtin/user/roles/has-role.d.ts

@@ -1,3 +1,3 @@
-import type { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 declare const model: ReplaceVariable;
 export default model;

package/backend/variables/builtin/user/roles/has-roles.d.ts

@@ -1,3 +1,3 @@
-import type { ReplaceVariable } from "../../../../../types/variables";
+import type { ReplaceVariable } from "../../../../../types";
 declare const model: ReplaceVariable;
 export default model;

package/backend/variables/replace-variable-manager.d.ts

@@ -40,6 +40,7 @@ declare class ReplaceVariableManager extends EventEmitter {
     addEventToVariable(variableHandle: string, eventSourceId: string, eventId: string): void;
     removeEventFromVariable(variableHandle: string, eventSourceId: string, eventId: string): void;
     getSuggestionsForVariable(variableHandle: string, triggerType: TriggerType, triggerMeta: TriggerMeta): Awaitable<VariableUsage[]>;
+    triggerUiRefresh(): void;
 }
 declare const manager: ReplaceVariableManager;
 export { manager as ReplaceVariableManager };

package/backend/viewers/viewer-database.d.ts

@@ -23,6 +23,18 @@ interface ViewerPurgeOptions {
         enabled: boolean;
     };
 }
+interface ViewersPageRequest {
+    page: number;
+    pageSize: number;
+    sortField?: string;
+    sortReversed?: boolean;
+    search?: string;
+}
+interface ViewersPage {
+    viewers: FirebotViewer[];
+    total: number;
+    totalUnfiltered: number;
+}
 interface UserDetails {
     firebotData: FirebotViewer;
     twitchData: Record<string, unknown>;
@@ -48,13 +60,13 @@ declare class ViewerDatabase extends TypedEmitter<{
      */
     isViewerDBOn(): boolean;
     connectViewerDatabase(): Promise<void>;
-    disconnectViewerDatabase(): void;
     getViewerDb(): Datastore<FirebotViewer>;
     createNewViewer(viewer: NewFirebotViewer): Promise<FirebotViewer>;
     addNewViewerFromChat(viewerDetails: BasicViewer, isOnline?: boolean): Promise<FirebotViewer>;
     getViewerById(id: string): Promise<FirebotViewer>;
     getViewerByUsername(username: string): Promise<FirebotViewer>;
     getAllViewers(): Promise<FirebotViewer[]>;
+    getViewersPage({ page, pageSize, sortField, sortReversed, search }: ViewersPageRequest): Promise<ViewersPage>;
     getAllUsernames(): Promise<string[]>;
     getAllUsernamesWithIds(): Promise<{
         id: string;

package/backend/webhooks/webhook-config-manager.d.ts

@@ -21,6 +21,7 @@ declare class WebhookConfigManager extends JsonDbManager<WebhookConfig, ExtraEve
     getPluginWebhookUrl(pluginId: string, webhookName: string): string;
     registerPluginHandler(pluginId: string, handler: PluginWebhookEventHandler): boolean;
     unregisterPluginHandler(pluginId: string): boolean;
+    triggerUiRefresh(): void;
 }
 declare const webhookConfigManager: WebhookConfigManager;
 export = webhookConfigManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowbartools/firebot-types",
-  "version": "5.67.0-alpha22",
+  "version": "5.67.0-alpha24",
   "description": "Type definitions and plugin API for Firebot plugins.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -43,7 +43,7 @@
   "license": "GPL-3.0",
   "peerDependencies": {
     "@types/express": "^5.0.5",
-    "@types/node": "^24.1.0"
+    "@types/node": "^22.19.21"
   },
   "publishConfig": {
     "access": "public"

package/types/effects.d.ts

@@ -121,7 +121,6 @@ export type EffectInstance<EffectModel = unknown> = {
 export type EffectType<EffectModel = unknown, OverlayData = unknown> = {
     definition: EffectDefinition<EffectModel>;
     optionsTemplate: string;
-    optionsTemplateUrl?: string;
     optionsController?: ($scope: EffectScope<EffectModel>, ...args: any[]) => void;
     optionsValidator?: (effect: EffectModel, $scope: EffectScope<EffectModel>) => string[];
     getDefaultLabel?: (effect: EffectModel, ...args: any[]) => Awaitable<string | undefined>;

package/types/index.d.ts

@@ -23,6 +23,7 @@ export * from "./notifications";
 export * from "./overlay-widgets";
 export * from "./parameters";
 export * from "./plugins";
+export * from "./poll-predictions";
 export * from "./power-ups";
 export * from "./pronouns";
 export * from "./quick-actions";

package/types/modules/frontend-communicator.d.ts

@@ -4,7 +4,7 @@ export interface FrontendCommunicatorModule {
      * @param eventName The name of the event to send.
      * @param data Data to provide to the event handler.
      */
-    send<ExpectedArg = unknown>(eventName: string, data?: ExpectedArg): void;
+    send<ExpectedArgs extends Array<unknown> = []>(eventName: string, ...data: ExpectedArgs): void;
     /** Handle a synchronous event triggered by the frontend.
      * @template ExpectedArgs The type of data provided with the event.
      * @template ReturnPayload The type of data returned from the event handler.
@@ -27,7 +27,7 @@ export interface FrontendCommunicatorModule {
      * @param eventName The name of the event to send.
      * @param data The data to provide with the event.
      */
-    fireEventAsync<ReturnPayload = void, ExpectedArg = unknown>(eventName: string, data?: ExpectedArg): Promise<ReturnPayload>;
+    fireEventAsync<ReturnPayload = void, ExpectedArgs extends Array<unknown> = []>(eventName: string, ...data: ExpectedArgs): Promise<ReturnPayload>;
     /**
      * Unregisters a previously registered frontend event handler.
      * @param eventName The name of the event.

package/types/overlay-widgets.d.ts

@@ -93,7 +93,7 @@ export type OverlayWidgetType<Settings extends Record<string, unknown> = Record<
     /**
      * State that is used when the widget is shown in live preview mode.
      */
-    livePreviewState?: State;
+    livePreviewState?: State | (() => State);
     /**
      * Array of setting keys that reference local resource paths.
      * These properties will be automatically converted to resource tokens when sent to the overlay,
@@ -132,8 +132,10 @@ export type OverlayWidgetType<Settings extends Record<string, unknown> = Record<
     onOverlayMessage?: (config: OverlayWidgetConfig<Settings, State>, messageName: string, messageData?: unknown) => Awaitable<void>;
     /**
      * This code is injected into the overlay. Do not reference any variables outside this scope.
+     *
+     * A widget type must register exactly one of `overlayExtension` or `componentExtension`.
      */
-    overlayExtension: {
+    overlayExtension?: {
         dependencies?: {
             css?: string[];
             js?: Array<string | {
@@ -148,7 +150,62 @@ export type OverlayWidgetType<Settings extends Record<string, unknown> = Record<
          */
         onInitialLoad?: (utils: IOverlayWidgetInitUtils) => Awaitable<void>;
     };
+    /**
+     * Points the overlay at a prebuilt ESM bundle whose default export is an {@link OverlayWidgetComponent}.
+     * The overlay dynamically imports the bundle and keeps an instance-based lifecycle, so a framework
+     * (such as Vue) owns the widget's DOM instead.
+     *
+     * A widget type must register exactly one of `overlayExtension` or `componentExtension`.
+     */
+    componentExtension?: {
+        /**
+         * The full string source of a prebuilt ESM bundle whose default export is an
+         * {@link OverlayWidgetComponent}
+         */
+        bundleSource: string;
+        /**
+         * Note: `"vue"` is already provided globally
+         */
+        dependencies?: {
+            css?: string[];
+            js?: Array<string | {
+                module: boolean;
+                url: string;
+            }>;
+            globalStyles?: string;
+        };
+    };
 };
+/**
+ * A single mounted widget instance, returned by {@link OverlayWidgetComponent.mount}.
+ */
+export interface OverlayWidgetInstance<Settings extends Record<string, unknown> = Record<string, unknown>, State = Record<string, unknown>> {
+    /**
+     * Called on `"settings-update"` and `"state-update"` events with a fresh widget config.
+     */
+    update(config: WidgetOverlayEvent<Settings, State>["data"]["widgetConfig"]): void;
+    /**
+     * Called on `"message"` events sent from the backend (via the Send Message effect).
+     */
+    onMessage?(messageName: string, messageData?: unknown): void;
+    /**
+     * Called on `"remove"`
+     */
+    destroy(): void;
+}
+/**
+ * The default export of a component widget's bundle. `mount` is called once when the widget is
+ * shown and returns an {@link OverlayWidgetInstance} the overlay uses for the rest of the lifecycle.
+ */
+export interface OverlayWidgetComponent<Settings extends Record<string, unknown> = Record<string, unknown>, State = Record<string, unknown>> {
+    mount(args: {
+        /** The widget's container element, already positioned/sized by the overlay. */
+        container: HTMLElement;
+        /** The widget config at mount time (settings + initial state). */
+        config: WidgetOverlayEvent<Settings, State>["data"]["widgetConfig"];
+        utils: IOverlayWidgetEventUtils;
+    }): OverlayWidgetInstance<Settings, State> | Promise<OverlayWidgetInstance<Settings, State>>;
+}
 export type OverlayWidgetConfig<Settings = Record<string, unknown>, State = Record<string, unknown>> = {
     id: string;
     name: string;
@@ -179,6 +236,10 @@ export type WidgetOverlayEvent<Settings = Record<string, unknown>, State = Recor
             };
         };
         widgetType: Pick<OverlayWidgetType, "id" | "userCanConfigure">;
+        /**
+         * True if the event is being fired for a component widget.
+         */
+        isComponentWidget: boolean;
         previewMode: boolean;
         /**
          * For "message" events, the name of the message being sent.
@@ -201,10 +262,15 @@ export interface IOverlayWidgetEventUtils {
      * @param updateOnMessage If true, the widget HTML will be updated when a "message" event is received. Default is false.
      */
     handleOverlayEvent(generateWidgetHtml: (widgetConfig: WidgetOverlayEvent["data"]["widgetConfig"]) => string, updateOnMessage?: boolean): void;
-    getWidgetPositionStyle(position?: Position): string;
+    getWidgetPositionStyle(position?: Position, zIndex?: number, additionalStyles?: Record<string, string | number | undefined>): string;
     getWidgetContainerElement(): HTMLElement | null;
-    initializeWidget(html: string): void;
-    updateWidgetContent(newHtml: string): void;
+    /**
+     * Initializes the widget by injecting the provided HTML into the widget's container element and applying any specified container styles.
+     * @param html The HTML content to inject into the widget's container element.
+     * @param additionalContainerStyles Optional styles to apply to the widget's container element.
+     */
+    initializeWidget(html: string, additionalContainerStyles?: Record<string, string | number | undefined>): HTMLElement | null;
+    updateWidgetContent(newHtml: string): HTMLElement | null;
     updateWidgetPosition(): void;
     removeWidget(): void;
     stylesToString(styles: Record<string, string | number | undefined>): string;

package/types/plugins.d.ts

@@ -15,11 +15,53 @@ import type { CustomWebSocketHandler } from "./websocket";
 import type { PluginWebhooks } from "./webhooks";
 type NoResult = Awaitable<void>;
 type GenericParameters = Record<string, unknown>;
+export type ManagedPluginManifest = {
+    name: string;
+    author: string;
+    description: string;
+    /** Must be a semver string */
+    version: string;
+    downloadUrl: string;
+    sha256: string;
+    /** Must be an ISO-8601 string */
+    releaseDate: string;
+    type: "single-file" | "zip";
+    icon?: PluginIcon;
+    tags?: string[];
+    repo?: string;
+    website?: string;
+    support?: string;
+    minimumFirebotVersion?: ManifestFirebotVersion;
+    maximumFirebotVersion?: ManifestFirebotVersion;
+};
+export type ManagedPlugin = {
+    author: string;
+    name: string;
+    version: string;
+};
+export type ManagedPluginWithManifest = ManagedPlugin & {
+    manifest: ManagedPluginManifest;
+};
+export type ManagedPluginUpdateRequest = {
+    author: string;
+    name: string;
+    version: string;
+    firebotVersion: ManifestFirebotVersion;
+};
+export type ManagedPluginBatchUpdateRequest = {
+    plugins: Array<{
+        author: string;
+        name: string;
+        version: string;
+    }>;
+    firebotVersion: ManifestFirebotVersion;
+};
 export type InstalledPluginConfig<Params extends GenericParameters = GenericParameters> = {
     id: string;
     fileName: string;
     enabled?: boolean;
     legacyImport?: boolean;
+    managedPluginDetails?: ManagedPlugin;
     parameters: Params;
 };
 export type PluginContext<Params extends FirebotParams = FirebotParams> = {
@@ -33,7 +75,7 @@ interface ManifestDescription {
     short: string;
     long?: string;
 }
-interface ManifestFirebotVersion {
+export interface ManifestFirebotVersion {
     major: number;
     minor?: number;
     patch?: number;

package/types/poll-predictions.d.ts

@@ -0,0 +1,28 @@
+import type { EventSubChannelPollChoice } from "@twurple/eventsub-base/lib";
+type ChannelPollChoice = Pick<EventSubChannelPollChoice, "id" | "title" | "totalVotes" | "channelPointsVotes">;
+export type ChannelPoll = {
+    title: string;
+    startDate: Date;
+    endDate: Date;
+    choices: ChannelPollChoice[];
+    winningChoiceIds: string[];
+    isChannelPointsVotingEnabled: boolean;
+    channelPointsPerVote: number;
+    status: "active" | "completed" | "archived" | "terminated";
+};
+type ChannelPredictionOutcome = {
+    id: string;
+    title: string;
+    channelPoints: number;
+    users: number;
+    color?: "blue" | "pink";
+};
+export type ChannelPrediction = {
+    title: string;
+    startDate: Date;
+    lockDate: Date;
+    outcomes: ChannelPredictionOutcome[];
+    winningOutcomeId: string | null;
+    status: "active" | "locked" | "resolved" | "canceled";
+};
+export {};

package/types/power-ups.d.ts

@@ -11,8 +11,10 @@ export type PowerUpRedemptionMetadata = {
     userId: string;
     userDisplayName: string;
     messageText: string;
+    args: string[];
     powerUpId: string;
     powerUpImage: string;
     powerUpName: string;
+    powerUpDescription: string;
     bits: number;
 };