@lumiastream/lumia-types 3.3.6 → 3.3.7-alpha.2

package/dist/activity.types.d.ts

@@ -23,6 +23,7 @@ export declare enum LumiaActivityCommandTypes {
     CHAT_COMMAND = "chat-command",
     CHATBOT_COMMAND = "chatbot-command",
     CHAT_MATCH = "chat-match",
+    SONG_REQUEST = "song-request",
     TWITCH_POINTS = "twitch-points",
     TWITCH_POINTS_OUTPUT = "twitch-points-output",
     TWITCH_EXTENSION = "twitch-extension",

package/dist/activity.types.js

@@ -29,6 +29,10 @@ var LumiaActivityCommandTypes;
     LumiaActivityCommandTypes["CHAT_COMMAND"] = "chat-command";
     LumiaActivityCommandTypes["CHATBOT_COMMAND"] = "chatbot-command";
     LumiaActivityCommandTypes["CHAT_MATCH"] = "chat-match";
+    // Marker for song-request items mirrored into ModQueue. When QueueEngine
+    // sees this type on an approve/deny path, it routes to SongRequestManager
+    // instead of the default chat-command execution.
+    LumiaActivityCommandTypes["SONG_REQUEST"] = "song-request";
     LumiaActivityCommandTypes["TWITCH_POINTS"] = "twitch-points";
     LumiaActivityCommandTypes["TWITCH_POINTS_OUTPUT"] = "twitch-points-output";
     LumiaActivityCommandTypes["TWITCH_EXTENSION"] = "twitch-extension";

package/dist/custom-overlays/custom-overlays.d.ts

@@ -1272,6 +1272,10 @@ export declare enum SystemVariables {
     TWITCH_CURRENT_POLL_ID = "twitch_current_poll_id",
     /** Current prediction ID. Use as {{twitch_current_prediction_id}}. */
     TWITCH_CURRENT_PREDICTION_ID = "twitch_current_prediction_id",
+    /** Channel id. Use as {{youtube_channel_id}}. */
+    YOUTUBE_CHANNEL_ID = "youtube_channel_id",
+    /** Channel username (custom URL slug, falls back to channel title). Use as {{youtube_username}}. */
+    YOUTUBE_USERNAME = "youtube_username",
     /** Current viewer count. Use as {{youtube_current_viewer_count}}. */
     YOUTUBE_CURRENT_VIEWER_COUNT = "youtube_current_viewer_count",
     /** Total viewer count (stream). Use as {{youtube_total_viewer_count}}. */
@@ -1350,6 +1354,10 @@ export declare enum SystemVariables {
     YOUTUBE_TOTAL_VIDEO_COUNT = "youtube_total_video_count",
     /** Total channel views. Use as {{youtube_total_view_count}}. */
     YOUTUBE_TOTAL_VIEW_COUNT = "youtube_total_view_count",
+    /** Page / user id. Use as {{facebook_user_id}}. */
+    FACEBOOK_USER_ID = "facebook_user_id",
+    /** Page / user username. Use as {{facebook_username}}. */
+    FACEBOOK_USERNAME = "facebook_username",
     /** Session chat count. Use as {{facebook_session_chat_count}}. */
     FACEBOOK_SESSION_CHAT_COUNT = "facebook_session_chat_count",
     /** Current first chatter. Use as {{facebook_current_first_chatter}}. */
@@ -1388,6 +1396,10 @@ export declare enum SystemVariables {
     FACEBOOK_SESSION_STARS = "facebook_session_stars",
     /** Session Stars with amounts list. Use as {{facebook_session_stars_with_amount}}. */
     FACEBOOK_SESSION_STARS_WITH_AMOUNT = "facebook_session_stars_with_amount",
+    /** Channel user id. Use as {{tiktok_user_id}}. */
+    TIKTOK_USER_ID = "tiktok_user_id",
+    /** Channel username. Use as {{tiktok_username}}. */
+    TIKTOK_USERNAME = "tiktok_username",
     /** Session chat count. Use as {{tiktok_session_chat_count}}. */
     TIKTOK_SESSION_CHAT_COUNT = "tiktok_session_chat_count",
     /** Current first chatter. Use as {{tiktok_current_first_chatter}}. */

package/dist/custom-overlays.d.ts

@@ -1272,6 +1272,10 @@ export declare enum SystemVariables {
     TWITCH_CURRENT_POLL_ID = "twitch_current_poll_id",
     /** Current prediction ID. Use as {{twitch_current_prediction_id}}. */
     TWITCH_CURRENT_PREDICTION_ID = "twitch_current_prediction_id",
+    /** Channel id. Use as {{youtube_channel_id}}. */
+    YOUTUBE_CHANNEL_ID = "youtube_channel_id",
+    /** Channel username (custom URL slug, falls back to channel title). Use as {{youtube_username}}. */
+    YOUTUBE_USERNAME = "youtube_username",
     /** Current viewer count. Use as {{youtube_current_viewer_count}}. */
     YOUTUBE_CURRENT_VIEWER_COUNT = "youtube_current_viewer_count",
     /** Total viewer count (stream). Use as {{youtube_total_viewer_count}}. */
@@ -1350,6 +1354,10 @@ export declare enum SystemVariables {
     YOUTUBE_TOTAL_VIDEO_COUNT = "youtube_total_video_count",
     /** Total channel views. Use as {{youtube_total_view_count}}. */
     YOUTUBE_TOTAL_VIEW_COUNT = "youtube_total_view_count",
+    /** Page / user id. Use as {{facebook_user_id}}. */
+    FACEBOOK_USER_ID = "facebook_user_id",
+    /** Page / user username. Use as {{facebook_username}}. */
+    FACEBOOK_USERNAME = "facebook_username",
     /** Session chat count. Use as {{facebook_session_chat_count}}. */
     FACEBOOK_SESSION_CHAT_COUNT = "facebook_session_chat_count",
     /** Current first chatter. Use as {{facebook_current_first_chatter}}. */
@@ -1388,6 +1396,10 @@ export declare enum SystemVariables {
     FACEBOOK_SESSION_STARS = "facebook_session_stars",
     /** Session Stars with amounts list. Use as {{facebook_session_stars_with_amount}}. */
     FACEBOOK_SESSION_STARS_WITH_AMOUNT = "facebook_session_stars_with_amount",
+    /** Channel user id. Use as {{tiktok_user_id}}. */
+    TIKTOK_USER_ID = "tiktok_user_id",
+    /** Channel username. Use as {{tiktok_username}}. */
+    TIKTOK_USERNAME = "tiktok_username",
     /** Session chat count. Use as {{tiktok_session_chat_count}}. */
     TIKTOK_SESSION_CHAT_COUNT = "tiktok_session_chat_count",
     /** Current first chatter. Use as {{tiktok_current_first_chatter}}. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { LumiaStreamingSites, LumiaActivityCommandTypes, LumiaExternalActivityCommandTypes, LumiaAlertValues, LumiaAlertFriendlyValues, LumiaActivityOriginTypes, LumiaActivityApiValueType, LumiaActivityNoValueTypes, LumiaActivityTestType, } from './activity.types';
-export { LumiaVariationConditions, LumiaVariationCurrency, VariationCurrencySymbol, LumiaAlertConfigs, LumiaDynamicCondition, type LumiaSelectionOption } from './alert.types';
+export { LumiaVariationConditions, LumiaVariationCurrency, VariationCurrencySymbol, LumiaRedemptionCurrency, LumiaRedemptionCurrencySymbol, LumiaAlertConfigs, LumiaDynamicCondition, type LumiaSelectionOption, } from './alert.types';
 export { ILumiaSendPack, ILumiaEvent, ILumiaEventChatCommandBody, ILumiaEventChatBody, ILumiaEventAlertBody, ILumiaEventStateBody, ILumiaLight, LumiaIntegrations, LumiaEventTypes, } from './event.types';
 export { LumiaEventListTypes, LumiaMapAlertTypeToEventListType } from './eventlist.types';
 export { SystemVariables, ReservedVariables, AllVariables, getAcceptedVariableName, getAcceptedVariableNames, type LumiaAcceptedVariable, type LumiaAcceptedVariableDefinition, } from './variables.types';
@@ -8,3 +8,4 @@ export { KickKicksData } from './kick_kicks';
 export { TiktokGiftsData } from './tiktok_gifts';
 export { YoutubeSuperstickersData } from './youtube_superstickers';
 export { VIEWER_PROFILE_ACHIEVEMENTS, type ViewerProfileAchievementColor, type ViewerProfileAchievementDefinition, type ViewerProfileAchievementMetric, type ViewerProfileCollectionMode, type ViewerProfileCollectionRule, type ViewerProfileCollectionSettings, type ViewerProfileCollectionSource, } from './viewer_profile_achievements';
+export { SongRequestStatus, SongRequestSource, SongRequestProvider, SongRequestPlaybackTarget, type SongRequestItem, type SongRequestConfig, type SongRequestState, type SongRequestQueueUpdatePayload, type SongRequestPendingUpdatePayload, type SongRequestNowPlayingPayload, type SongRequestAddParams, type SongRequestModerationParams, } from './songrequest.types';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VIEWER_PROFILE_ACHIEVEMENTS = exports.YoutubeSuperstickersData = exports.TiktokGiftsData = exports.KickKicksData = exports.formatCondition = exports.getAcceptedVariableNames = exports.getAcceptedVariableName = exports.AllVariables = exports.ReservedVariables = exports.SystemVariables = exports.LumiaMapAlertTypeToEventListType = exports.LumiaEventListTypes = exports.LumiaEventTypes = exports.LumiaIntegrations = exports.LumiaAlertConfigs = exports.VariationCurrencySymbol = exports.LumiaVariationCurrency = exports.LumiaVariationConditions = exports.LumiaActivityTestType = exports.LumiaActivityNoValueTypes = exports.LumiaActivityApiValueType = exports.LumiaActivityOriginTypes = exports.LumiaAlertFriendlyValues = exports.LumiaAlertValues = exports.LumiaExternalActivityCommandTypes = exports.LumiaActivityCommandTypes = exports.LumiaStreamingSites = void 0;
+exports.SongRequestPlaybackTarget = exports.SongRequestProvider = exports.SongRequestSource = exports.SongRequestStatus = exports.VIEWER_PROFILE_ACHIEVEMENTS = exports.YoutubeSuperstickersData = exports.TiktokGiftsData = exports.KickKicksData = exports.formatCondition = exports.getAcceptedVariableNames = exports.getAcceptedVariableName = exports.AllVariables = exports.ReservedVariables = exports.SystemVariables = exports.LumiaMapAlertTypeToEventListType = exports.LumiaEventListTypes = exports.LumiaEventTypes = exports.LumiaIntegrations = exports.LumiaAlertConfigs = exports.LumiaRedemptionCurrencySymbol = exports.LumiaRedemptionCurrency = exports.VariationCurrencySymbol = exports.LumiaVariationCurrency = exports.LumiaVariationConditions = exports.LumiaActivityTestType = exports.LumiaActivityNoValueTypes = exports.LumiaActivityApiValueType = exports.LumiaActivityOriginTypes = exports.LumiaAlertFriendlyValues = exports.LumiaAlertValues = exports.LumiaExternalActivityCommandTypes = exports.LumiaActivityCommandTypes = exports.LumiaStreamingSites = void 0;
 var activity_types_1 = require("./activity.types");
 Object.defineProperty(exports, "LumiaStreamingSites", { enumerable: true, get: function () { return activity_types_1.LumiaStreamingSites; } });
 Object.defineProperty(exports, "LumiaActivityCommandTypes", { enumerable: true, get: function () { return activity_types_1.LumiaActivityCommandTypes; } });
@@ -15,6 +15,8 @@ var alert_types_1 = require("./alert.types");
 Object.defineProperty(exports, "LumiaVariationConditions", { enumerable: true, get: function () { return alert_types_1.LumiaVariationConditions; } });
 Object.defineProperty(exports, "LumiaVariationCurrency", { enumerable: true, get: function () { return alert_types_1.LumiaVariationCurrency; } });
 Object.defineProperty(exports, "VariationCurrencySymbol", { enumerable: true, get: function () { return alert_types_1.VariationCurrencySymbol; } });
+Object.defineProperty(exports, "LumiaRedemptionCurrency", { enumerable: true, get: function () { return alert_types_1.LumiaRedemptionCurrency; } });
+Object.defineProperty(exports, "LumiaRedemptionCurrencySymbol", { enumerable: true, get: function () { return alert_types_1.LumiaRedemptionCurrencySymbol; } });
 Object.defineProperty(exports, "LumiaAlertConfigs", { enumerable: true, get: function () { return alert_types_1.LumiaAlertConfigs; } });
 var event_types_1 = require("./event.types");
 Object.defineProperty(exports, "LumiaIntegrations", { enumerable: true, get: function () { return event_types_1.LumiaIntegrations; } });
@@ -38,3 +40,8 @@ var youtube_superstickers_1 = require("./youtube_superstickers");
 Object.defineProperty(exports, "YoutubeSuperstickersData", { enumerable: true, get: function () { return youtube_superstickers_1.YoutubeSuperstickersData; } });
 var viewer_profile_achievements_1 = require("./viewer_profile_achievements");
 Object.defineProperty(exports, "VIEWER_PROFILE_ACHIEVEMENTS", { enumerable: true, get: function () { return viewer_profile_achievements_1.VIEWER_PROFILE_ACHIEVEMENTS; } });
+var songrequest_types_1 = require("./songrequest.types");
+Object.defineProperty(exports, "SongRequestStatus", { enumerable: true, get: function () { return songrequest_types_1.SongRequestStatus; } });
+Object.defineProperty(exports, "SongRequestSource", { enumerable: true, get: function () { return songrequest_types_1.SongRequestSource; } });
+Object.defineProperty(exports, "SongRequestProvider", { enumerable: true, get: function () { return songrequest_types_1.SongRequestProvider; } });
+Object.defineProperty(exports, "SongRequestPlaybackTarget", { enumerable: true, get: function () { return songrequest_types_1.SongRequestPlaybackTarget; } });

package/dist/songrequest.types.d.ts

@@ -0,0 +1,157 @@
+import { LumiaStreamingSites } from './activity.types';
+/** Lifecycle of a single song request. */
+export declare enum SongRequestStatus {
+    /** Awaiting moderator approval (only used when `config.approvalRequired`). */
+    PENDING = "pending",
+    /** Approved, waiting in the queue. */
+    QUEUED = "queued",
+    /** Currently playing. */
+    PLAYING = "playing",
+    /** Finished playing naturally. */
+    COMPLETED = "completed",
+    /** Rejected by streamer / mod before playing. */
+    DENIED = "denied",
+    /** Ended early (skip button or skip command). */
+    SKIPPED = "skipped"
+}
+/** Where a request entered the system. Used for analytics + permission checks. */
+export declare enum SongRequestSource {
+    /** Triggered by the `!sr` system chatbot command. */
+    CHAT_COMMAND = "chat",
+    /** Triggered by the ADD_SONG_REQUEST Lumia action (decks, automations, …). */
+    LUMIA_ACTION = "action",
+    /** Streamer added directly from the dashboard. */
+    STREAMER = "streamer",
+    /** Mod added directly from the modtool window. */
+    MOD = "mod"
+}
+/** Format of the user's submission, before resolution. */
+export declare enum SongRequestProvider {
+    /** YouTube watch URL or short URL. */
+    YOUTUBE = "youtube",
+    /** Spotify track URL — may be routed to Spotify queue or converted to YouTube. */
+    SPOTIFY = "spotify",
+    /** YouTube Music URL (less common; usually treated like YouTube). */
+    YOUTUBE_MUSIC = "youtubeMusic",
+    /** Free-text query that needs a search before it can play. */
+    TEXT = "text"
+}
+/** Where the resolved song actually plays once approved. */
+export declare enum SongRequestPlaybackTarget {
+    /** Hidden YT iframe inside the songrequest overlay module (default). */
+    OVERLAY = "overlay",
+    /** Streamer's Spotify Premium player via Spotify Web API queue. */
+    SPOTIFY = "spotify",
+    /** Streamer's YouTube Music player via YT Music queue. */
+    YOUTUBE_MUSIC = "youtubeMusic"
+}
+/** A single request item — one row in the queue / pending tray / history. */
+export interface SongRequestItem {
+    id: string;
+    status: SongRequestStatus;
+    source: SongRequestSource;
+    provider: SongRequestProvider;
+    /** Raw user input — the URL or text query they submitted. */
+    query: string;
+    resolvedUrl?: string;
+    /** YouTube video ID (resolved for both YOUTUBE and TEXT providers). */
+    videoId?: string;
+    /** Spotify track ID, when applicable. */
+    spotifyTrackId?: string;
+    title?: string;
+    artist?: string;
+    thumbnailUrl?: string;
+    durationSeconds?: number;
+    requesterUsername: string;
+    requesterPlatform?: LumiaStreamingSites;
+    requesterAvatar?: string;
+    approvedBy?: string;
+    approvedAt?: number;
+    deniedBy?: string;
+    deniedReason?: string;
+    /** Chosen at queue-entry time based on connected services + config. */
+    playbackTarget?: SongRequestPlaybackTarget;
+    createdAt: number;
+    startedAt?: number;
+    endedAt?: number;
+    tipAmount?: number;
+    tipCurrency?: string;
+}
+/**
+ * User-configurable settings for the song-request system. Lives in user
+ * settings (not in runtime state). Role gating for the `!sr` command piggybacks
+ * on the system command's own `userLevels` field — we deliberately do NOT
+ * duplicate it here.
+ */
+export interface SongRequestConfig {
+    enabled: boolean;
+    /** Trigger word for the system chatbot command. Default: `!sr`. */
+    triggerCommand: string;
+    cooldownPerUserSeconds: number;
+    cooldownGlobalSeconds: number;
+    maxRequestsPerUserInSession: number;
+    /** When true, requests land in `pending` until a mod / streamer approves. */
+    approvalRequired: boolean;
+    maxQueueSize: number;
+    maxSongDurationSeconds: number;
+    allowYouTubeUrls: boolean;
+    allowSpotifyUrls: boolean;
+    allowFreeTextSearch: boolean;
+    /** Required for free-text → YouTube Data API v3 search. */
+    youtubeApiKey?: string;
+    /**
+     * Where approved songs play. `'auto'` = use the streamer's connected music
+     * service (Spotify Premium > YT Music) when available, otherwise the overlay
+     * iframe. The other values force a single target regardless of connections.
+     */
+    preferredPlaybackTarget: 'auto' | SongRequestPlaybackTarget;
+    announceInChat: boolean;
+    chatTemplateAdded: string;
+    chatTemplateNowPlaying: string;
+    chatTemplateDenied: string;
+    /** Used for dedup / cooldown / queue-full / disallowed-source rejections. */
+    chatTemplateRejected: string;
+}
+/** Runtime queue state. Lives in the LumiaStream Redux slice; the dashboard
+ *  widgets and the overlay module consume slices of this shape. */
+export interface SongRequestState {
+    /** Awaiting moderator approval (empty when `approvalRequired: false`). */
+    pending: SongRequestItem[];
+    /** Approved, waiting to play. Index 0 plays next. */
+    queue: SongRequestItem[];
+    /** Currently playing item, if any. */
+    nowPlaying: SongRequestItem | null;
+    /** Recently completed / skipped / denied items, newest first. Capped. */
+    history: SongRequestItem[];
+}
+/** Fired whenever the active queue or now-playing changes. */
+export interface SongRequestQueueUpdatePayload {
+    queue: SongRequestItem[];
+    nowPlaying: SongRequestItem | null;
+}
+/** Fired whenever the pending tray changes (drives the moderation widget). */
+export interface SongRequestPendingUpdatePayload {
+    pending: SongRequestItem[];
+}
+/** Lighter-weight ping when only nowPlaying changed (e.g., natural advance). */
+export interface SongRequestNowPlayingPayload {
+    nowPlaying: SongRequestItem | null;
+}
+export interface SongRequestAddParams {
+    /** Raw input — URL or free text. The parser resolves it. */
+    query: string;
+    requesterUsername?: string;
+    requesterPlatform?: LumiaStreamingSites;
+    /** Defaults to `LUMIA_ACTION` when omitted (matches the action call site). */
+    source?: SongRequestSource;
+    /**
+     * Streamer / mod additions can skip the pending state. Chat-command
+     * additions ignore this flag — chat is always subject to `approvalRequired`.
+     */
+    forceApprove?: boolean;
+}
+export interface SongRequestModerationParams {
+    id: string;
+    /** Optional reason for deny actions (surfaced in chat / mod log). */
+    reason?: string;
+}

package/dist/songrequest.types.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SongRequestPlaybackTarget = exports.SongRequestProvider = exports.SongRequestSource = exports.SongRequestStatus = void 0;
+// ---------------------------------------------------------------------------
+// Song Request — shared types for the native LumiaStream song-request system.
+//
+// Used by:
+//   - LumiaStream renderer (queue manager, system chatbot command, Lumia
+//     action handler, dashboard page + widgets)
+//   - Overlay-UI `songrequest` module (now-playing card + queue list + skip/
+//     pause UI; consumes SongRequestQueueUpdatePayload via SSE)
+//   - Lumia-UI `se-import` (`mapMediaShare` translates SE's
+//     `se-widget-media-share` widget into a Lumia `songrequest` module)
+//
+// Architecture summary (so this file's shape is legible standalone):
+//   1. Viewers submit via `!sr <youtube-url|spotify-url|free text>` chat
+//      command. Streamer / mods can also add via the dashboard UI or via the
+//      ADD_SONG_REQUEST Lumia action.
+//   2. Submission lands in `pending` for moderator approval (default) or
+//      jumps directly to `queue` when `forceApprove: true` (streamer / mod
+//      additions) or when `config.approvalRequired: false`.
+//   3. Approved items get a `playbackTarget` chosen at queue time:
+//        - `OVERLAY` (default): hidden YT iframe inside the songrequest
+//          overlay module
+//        - `SPOTIFY`: routed to streamer's Spotify Premium queue via
+//          spotify.manager.SearchAndAddToQueue (already implemented)
+//        - `YOUTUBE_MUSIC`: routed to streamer's YT Music queue (handler
+//          to be added in Phase E)
+//   4. Items move queue → nowPlaying → history (capped) as they play out.
+// ---------------------------------------------------------------------------
+/** Lifecycle of a single song request. */
+var SongRequestStatus;
+(function (SongRequestStatus) {
+    /** Awaiting moderator approval (only used when `config.approvalRequired`). */
+    SongRequestStatus["PENDING"] = "pending";
+    /** Approved, waiting in the queue. */
+    SongRequestStatus["QUEUED"] = "queued";
+    /** Currently playing. */
+    SongRequestStatus["PLAYING"] = "playing";
+    /** Finished playing naturally. */
+    SongRequestStatus["COMPLETED"] = "completed";
+    /** Rejected by streamer / mod before playing. */
+    SongRequestStatus["DENIED"] = "denied";
+    /** Ended early (skip button or skip command). */
+    SongRequestStatus["SKIPPED"] = "skipped";
+})(SongRequestStatus || (exports.SongRequestStatus = SongRequestStatus = {}));
+/** Where a request entered the system. Used for analytics + permission checks. */
+var SongRequestSource;
+(function (SongRequestSource) {
+    /** Triggered by the `!sr` system chatbot command. */
+    SongRequestSource["CHAT_COMMAND"] = "chat";
+    /** Triggered by the ADD_SONG_REQUEST Lumia action (decks, automations, …). */
+    SongRequestSource["LUMIA_ACTION"] = "action";
+    /** Streamer added directly from the dashboard. */
+    SongRequestSource["STREAMER"] = "streamer";
+    /** Mod added directly from the modtool window. */
+    SongRequestSource["MOD"] = "mod";
+})(SongRequestSource || (exports.SongRequestSource = SongRequestSource = {}));
+/** Format of the user's submission, before resolution. */
+var SongRequestProvider;
+(function (SongRequestProvider) {
+    /** YouTube watch URL or short URL. */
+    SongRequestProvider["YOUTUBE"] = "youtube";
+    /** Spotify track URL — may be routed to Spotify queue or converted to YouTube. */
+    SongRequestProvider["SPOTIFY"] = "spotify";
+    /** YouTube Music URL (less common; usually treated like YouTube). */
+    SongRequestProvider["YOUTUBE_MUSIC"] = "youtubeMusic";
+    /** Free-text query that needs a search before it can play. */
+    SongRequestProvider["TEXT"] = "text";
+})(SongRequestProvider || (exports.SongRequestProvider = SongRequestProvider = {}));
+/** Where the resolved song actually plays once approved. */
+var SongRequestPlaybackTarget;
+(function (SongRequestPlaybackTarget) {
+    /** Hidden YT iframe inside the songrequest overlay module (default). */
+    SongRequestPlaybackTarget["OVERLAY"] = "overlay";
+    /** Streamer's Spotify Premium player via Spotify Web API queue. */
+    SongRequestPlaybackTarget["SPOTIFY"] = "spotify";
+    /** Streamer's YouTube Music player via YT Music queue. */
+    SongRequestPlaybackTarget["YOUTUBE_MUSIC"] = "youtubeMusic";
+})(SongRequestPlaybackTarget || (exports.SongRequestPlaybackTarget = SongRequestPlaybackTarget = {}));

package/dist/variables.types.d.ts

@@ -426,6 +426,10 @@ export declare enum SystemVariables {
     TWITCH_CURRENT_POLL_ID = "twitch_current_poll_id",
     /** Current prediction ID. Use as {{twitch_current_prediction_id}}. */
     TWITCH_CURRENT_PREDICTION_ID = "twitch_current_prediction_id",
+    /** Channel id. Use as {{youtube_channel_id}}. */
+    YOUTUBE_CHANNEL_ID = "youtube_channel_id",
+    /** Channel username (custom URL slug, falls back to channel title). Use as {{youtube_username}}. */
+    YOUTUBE_USERNAME = "youtube_username",
     /** Current viewer count. Use as {{youtube_current_viewer_count}}. */
     YOUTUBE_CURRENT_VIEWER_COUNT = "youtube_current_viewer_count",
     /** Total viewer count (stream). Use as {{youtube_total_viewer_count}}. */
@@ -504,6 +508,10 @@ export declare enum SystemVariables {
     YOUTUBE_TOTAL_VIDEO_COUNT = "youtube_total_video_count",
     /** Total channel views. Use as {{youtube_total_view_count}}. */
     YOUTUBE_TOTAL_VIEW_COUNT = "youtube_total_view_count",
+    /** Page / user id. Use as {{facebook_user_id}}. */
+    FACEBOOK_USER_ID = "facebook_user_id",
+    /** Page / user username. Use as {{facebook_username}}. */
+    FACEBOOK_USERNAME = "facebook_username",
     /** Session chat count. Use as {{facebook_session_chat_count}}. */
     FACEBOOK_SESSION_CHAT_COUNT = "facebook_session_chat_count",
     /** Current first chatter. Use as {{facebook_current_first_chatter}}. */
@@ -542,6 +550,10 @@ export declare enum SystemVariables {
     FACEBOOK_SESSION_STARS = "facebook_session_stars",
     /** Session Stars with amounts list. Use as {{facebook_session_stars_with_amount}}. */
     FACEBOOK_SESSION_STARS_WITH_AMOUNT = "facebook_session_stars_with_amount",
+    /** Channel user id. Use as {{tiktok_user_id}}. */
+    TIKTOK_USER_ID = "tiktok_user_id",
+    /** Channel username. Use as {{tiktok_username}}. */
+    TIKTOK_USERNAME = "tiktok_username",
     /** Session chat count. Use as {{tiktok_session_chat_count}}. */
     TIKTOK_SESSION_CHAT_COUNT = "tiktok_session_chat_count",
     /** Current first chatter. Use as {{tiktok_current_first_chatter}}. */

package/dist/variables.types.js

@@ -435,6 +435,10 @@ var SystemVariables;
     /** Current prediction ID. Use as {{twitch_current_prediction_id}}. */
     SystemVariables["TWITCH_CURRENT_PREDICTION_ID"] = "twitch_current_prediction_id";
     // ─────────────────────────────────── YouTube ──────────────────────────────────
+    /** Channel id. Use as {{youtube_channel_id}}. */
+    SystemVariables["YOUTUBE_CHANNEL_ID"] = "youtube_channel_id";
+    /** Channel username (custom URL slug, falls back to channel title). Use as {{youtube_username}}. */
+    SystemVariables["YOUTUBE_USERNAME"] = "youtube_username";
     /** Current viewer count. Use as {{youtube_current_viewer_count}}. */
     SystemVariables["YOUTUBE_CURRENT_VIEWER_COUNT"] = "youtube_current_viewer_count";
     /** Total viewer count (stream). Use as {{youtube_total_viewer_count}}. */
@@ -514,6 +518,10 @@ var SystemVariables;
     /** Total channel views. Use as {{youtube_total_view_count}}. */
     SystemVariables["YOUTUBE_TOTAL_VIEW_COUNT"] = "youtube_total_view_count";
     // ────────────────────────────────── Facebook ──────────────────────────────────
+    /** Page / user id. Use as {{facebook_user_id}}. */
+    SystemVariables["FACEBOOK_USER_ID"] = "facebook_user_id";
+    /** Page / user username. Use as {{facebook_username}}. */
+    SystemVariables["FACEBOOK_USERNAME"] = "facebook_username";
     /** Session chat count. Use as {{facebook_session_chat_count}}. */
     SystemVariables["FACEBOOK_SESSION_CHAT_COUNT"] = "facebook_session_chat_count";
     /** Current first chatter. Use as {{facebook_current_first_chatter}}. */
@@ -553,6 +561,10 @@ var SystemVariables;
     /** Session Stars with amounts list. Use as {{facebook_session_stars_with_amount}}. */
     SystemVariables["FACEBOOK_SESSION_STARS_WITH_AMOUNT"] = "facebook_session_stars_with_amount";
     // ─────────────────────────────────── TikTok ───────────────────────────────────
+    /** Channel user id. Use as {{tiktok_user_id}}. */
+    SystemVariables["TIKTOK_USER_ID"] = "tiktok_user_id";
+    /** Channel username. Use as {{tiktok_username}}. */
+    SystemVariables["TIKTOK_USERNAME"] = "tiktok_username";
     /** Session chat count. Use as {{tiktok_session_chat_count}}. */
     SystemVariables["TIKTOK_SESSION_CHAT_COUNT"] = "tiktok_session_chat_count";
     /** Current first chatter. Use as {{tiktok_current_first_chatter}}. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumiastream/lumia-types",
-  "version": "3.3.6",
+  "version": "3.3.7-alpha.2",
   "description": "",
   "main": "./dist/index.js",
   "files": [