@lumiastream/lumia-types 3.2.8 → 3.3.0

package/dist/activity.types.d.ts

@@ -287,6 +287,10 @@ export declare enum LumiaAlertValues {
     YOUTUBE_SUPERSTICKER = "youtube-supersticker",
     /** YouTube session superstickers */
     YOUTUBE_SESSION_SUPERSTICKERS = "youtube-sessionSuperstickers",
+    /** YouTube gift event (jewel-based) */
+    YOUTUBE_GIFTS = "youtube-gifts",
+    /** YouTube session gifts */
+    YOUTUBE_SESSION_GIFTS = "youtube-sessionGifts",
     /** YouTube total likes */
     YOUTUBE_LIKE = "youtube-like",
     /** YouTube total views */
@@ -622,6 +626,8 @@ export declare const LumiaAlertFriendlyValues: {
     "youtube-subscriber": string;
     "youtube-superchat": string;
     "youtube-supersticker": string;
+    "youtube-gifts": string;
+    "youtube-sessionGifts": string;
     "youtube-entrance": string;
     "youtube-like": string;
     "youtube-viewers": string;

package/dist/activity.types.js

@@ -303,6 +303,10 @@ var LumiaAlertValues;
     LumiaAlertValues["YOUTUBE_SUPERSTICKER"] = "youtube-supersticker";
     /** YouTube session superstickers */
     LumiaAlertValues["YOUTUBE_SESSION_SUPERSTICKERS"] = "youtube-sessionSuperstickers";
+    /** YouTube gift event (jewel-based) */
+    LumiaAlertValues["YOUTUBE_GIFTS"] = "youtube-gifts";
+    /** YouTube session gifts */
+    LumiaAlertValues["YOUTUBE_SESSION_GIFTS"] = "youtube-sessionGifts";
     /** YouTube total likes */
     LumiaAlertValues["YOUTUBE_LIKE"] = "youtube-like";
     /** YouTube total views */
@@ -652,6 +656,8 @@ exports.LumiaAlertFriendlyValues = {
     [LumiaAlertValues.YOUTUBE_SUBSCRIBER]: 'Youtube Subscriber',
     [LumiaAlertValues.YOUTUBE_SUPERCHAT]: 'Youtube Superchat',
     [LumiaAlertValues.YOUTUBE_SUPERSTICKER]: 'Youtube Supersticker',
+    [LumiaAlertValues.YOUTUBE_GIFTS]: 'Youtube Gifts',
+    [LumiaAlertValues.YOUTUBE_SESSION_GIFTS]: 'Youtube Session Gifts',
     [LumiaAlertValues.YOUTUBE_ENTRANCE]: 'Youtube Entrance',
     [LumiaAlertValues.YOUTUBE_LIKE]: 'Youtube Like',
     [LumiaAlertValues.YOUTUBE_VIEWERS]: 'Youtube Viewers',

package/dist/alert.types.js

@@ -3906,6 +3906,152 @@ exports.LumiaAlertConfigs = {
             { type: LumiaVariationConditions.COUNT_IS_MULTIPLE_OF, description: 'Total Session Gift Member Count is a multiple of' },
         ],
     },
+    [activity_types_1.LumiaAlertValues.YOUTUBE_GIFTS]: {
+        connection: event_types_1.LumiaIntegrations.YOUTUBE,
+        message: '{{username}} sent x{{comboCount}} {{giftName}} ({{jewelsAmount}} jewels)',
+        eventlistMessage: 'Gift',
+        eventlistDetailedMessage: 'sent x{{comboCount}} {{giftName}} worth {{jewelsAmount}} jewels',
+        acceptedVariables: variables_types_1.AllVariables.youtube.alerts.gifts,
+        quickActions: [
+            {
+                label: '10 Jewels',
+                dynamic: { value: 10, name: 'Heart' },
+                extraSettings: {
+                    username: 'lumiastream',
+                    displayname: 'LumiaStream',
+                    avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    giftName: 'Heart',
+                    jewelsAmount: 10,
+                    totalJewels: 10,
+                    comboCount: 1,
+                    hasVisualEffect: false,
+                },
+            },
+            {
+                label: '100 Jewels',
+                dynamic: { value: 100, name: 'Rose' },
+                extraSettings: {
+                    username: 'lumiastream',
+                    displayname: 'LumiaStream',
+                    avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    giftName: 'Rose',
+                    jewelsAmount: 100,
+                    totalJewels: 100,
+                    comboCount: 1,
+                    hasVisualEffect: true,
+                },
+            },
+            {
+                label: '500 Jewels Combo',
+                dynamic: { value: 500, name: 'Star' },
+                extraSettings: {
+                    username: 'lumiastream',
+                    displayname: 'LumiaStream',
+                    avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    giftName: 'Star',
+                    jewelsAmount: 500,
+                    totalJewels: 500,
+                    comboCount: 5,
+                    hasVisualEffect: true,
+                },
+            },
+        ],
+        inputFields: [
+            {
+                type: 'text',
+                label: 'Username',
+                variableField: 'username',
+                required: false,
+                default: 'lumiastream',
+            },
+            {
+                type: 'text',
+                label: 'Gift Name',
+                variableField: 'giftName',
+                required: false,
+                default: 'Rose',
+            },
+            {
+                type: 'number',
+                label: 'Jewels Amount',
+                dynamicField: 'value',
+                variableField: 'jewelsAmount',
+                required: true,
+                default: 100,
+            },
+            {
+                type: 'number',
+                label: 'Combo Count',
+                variableField: 'comboCount',
+                required: false,
+                default: 1,
+            },
+        ],
+        LumiaVariationConditions: [
+            { type: LumiaVariationConditions.RANDOM },
+            {
+                type: LumiaVariationConditions.EQUAL_STRING,
+                description: 'Gift Name is equal to',
+            },
+            {
+                type: LumiaVariationConditions.EQUAL_NUMBER,
+                description: 'Jewels is equal to',
+            },
+            {
+                type: LumiaVariationConditions.GREATER_NUMBER,
+                description: 'Jewels is greater than',
+            },
+            { type: LumiaVariationConditions.EQUAL_USERNAME },
+            { type: LumiaVariationConditions.EQUAL_VARIABLE },
+        ],
+    },
+    [activity_types_1.LumiaAlertValues.YOUTUBE_SESSION_GIFTS]: {
+        connection: event_types_1.LumiaIntegrations.YOUTUBE,
+        message: 'Reached {{total}} jewels this session',
+        eventlistMessage: 'Total Gifts {{total}}',
+        eventlistDetailedMessage: 'reached {{total}} jewels',
+        acceptedVariables: variables_types_1.AllVariables.youtube.alerts.sessionGifts,
+        eventlistSpecialUsername: 'Total Gifts',
+        quickActions: [
+            {
+                label: '100 Total Jewels',
+                dynamic: { value: 100, total: 100, previousTotal: 50 },
+                extraSettings: { total: 100, previousTotal: 50 },
+            },
+            {
+                label: '500 Total Jewels',
+                dynamic: { value: 500, total: 500, previousTotal: 100 },
+                extraSettings: { total: 500, previousTotal: 100 },
+            },
+            {
+                label: '1000 Total Jewels',
+                dynamic: { value: 1000, total: 1000, previousTotal: 500 },
+                extraSettings: { total: 1000, previousTotal: 500 },
+            },
+        ],
+        inputFields: [
+            {
+                type: 'number',
+                label: 'Total Jewels',
+                dynamicField: 'value',
+                variableField: 'total',
+                required: true,
+                default: 100,
+            },
+            {
+                type: 'number',
+                label: 'Previous Total',
+                dynamicField: 'previousTotal',
+                variableField: 'previousTotal',
+                required: false,
+                default: 0,
+            },
+        ],
+        LumiaVariationConditions: [
+            { type: LumiaVariationConditions.GREATER_NUMBER, description: 'Total Session Jewels Greater Than' },
+            { type: LumiaVariationConditions.COUNT_IS_MULTIPLE_OF, description: 'Total Session Jewels is a multiple of' },
+        ],
+    },
     [activity_types_1.LumiaAlertValues.YOUTUBE_SUPERCHAT]: {
         connection: event_types_1.LumiaIntegrations.YOUTUBE,
         message: '{{username}} just super chatted with {{currencySymbol}}{{amount}}. They said {{message}}',

package/dist/custom-overlays/custom-overlays-cheatsheet.md

@@ -18,6 +18,7 @@ Runtime reminders:
 - Read Config/Data values from `Overlay.data`, not from a bare top-level `data` variable.
 - JS is already wrapped by Lumia in an async function, so top-level `await` is allowed.
 - Use literal listener names like `Overlay.on('chat', ...)` so Lumia can auto-subscribe to events.
+- For full event payload shapes, use the Overlay Type Definitions page or `custom-overlays.d.ts`.
 - Use `Overlay.deleteStorage`, not `Overlay.removeStorage`.
 
 ### `window.Overlay` interface

package/dist/custom-overlays/custom-overlays-documentation.md

@@ -106,6 +106,57 @@ Overlay.on("chat", (data) => {
 	toast(`New chat message received from ${username}. They said ${message}`);
 });
 
+// Full chat payload shape.
+Overlay.on("chat", (data) => {
+	const {
+		origin, // Platform origin, such as "twitch", "youtube", "kick", "tiktok", or "facebook"
+		id, // Platform message id when available
+		username, // Account username/login
+		displayname, // Display name when available
+		channel, // Channel or room where the message was sent
+		avatar, // User avatar URL when available
+		message, // Chat message text
+		color, // User chat color, usually a hex value
+		badges, // Badge ids or badge image URLs
+		badgesLookup, // Badge id to image URL lookup map for some platforms
+		badgesRaw, // Raw platform badge string
+		emotesRaw, // Raw platform emote string
+		emotesPack, // Platform-specific emote metadata
+		isCheer, // Whether the message includes a cheer/bits event
+		reply, // Reply metadata: { username, body }
+		isPowerup, // Twitch Power-up flag
+		powerupType, // Twitch Power-up type
+		powerupName, // Twitch Power-up animation name
+		sharedMessage, // Twitch shared chat source metadata
+		lumiauserlevels, // Numeric Lumia user level ids
+		userLevels, // Boolean role map: isSelf, broadcaster, mod, vip, tier3, tier2, subscriber, regular, follower, anyone
+		time, // Local HH:mm:ss time generated by Lumia
+		timestamp, // Millisecond timestamp generated by Lumia
+	} = data;
+
+	console.log(origin, displayname || username, message, {
+		id,
+		channel,
+		avatar,
+		color,
+		badges,
+		badgesLookup,
+		badgesRaw,
+		emotesRaw,
+		emotesPack,
+		isCheer,
+		reply,
+		isPowerup,
+		powerupType,
+		powerupName,
+		sharedMessage,
+		lumiauserlevels,
+		userLevels,
+		time,
+		timestamp,
+	});
+});
+
 Overlay.on("alert", (data) => {
 	console.log("alert", data);
 	const settings = data.extraSettings || {};
@@ -199,6 +250,8 @@ Overlay.on('overlaycontent', (data) => {
 
 Lumia auto-detects event subscriptions from literal `Overlay.on("event", ...)` calls in the JS tab. Use direct string literals so the overlay subscribes to the needed events. The Data tab only needs an `events` array for legacy/manual cases.
 
+For full event payload shapes, see the [Overlay Type Definitions](/docs/custom-overlays/types). The raw declarations live in `custom-overlays.d.ts` as `ChatEvent`, `AlertEvent`, `HfxEvent`, `VirtualLightEvent`, and `CustomOverlayContentEvent`.
+
 ### OverlayListener types
 
 | Value          | Label                  |
@@ -210,7 +263,7 @@ Lumia auto-detects event subscriptions from literal `Overlay.on("event", ...)` c
 | overlaycontent | Custom Overlay Content |
 
 > 💡 Performance Tip: Only selected events are delivered to the overlay.
-> 💡 The TypeScript types for each alert are within the Types tab.
+> 💡 The TypeScript types for chat, alerts, HFX, virtual lights, and overlay content are within the Types tab.
 > 💡 `overlaycontent` sends custom content only to custom overlay layers with the matching `codeId`.
 
 ### Showing Toasts

package/dist/custom-overlays/custom-overlays-examples.md

@@ -1,6 +1,6 @@
 # Custom Overlays Examples
 
-> Need to inspect what an alert returns? Open the [alert explorer](/docs/variables#alert-explorer) on the Platform Variables page to browse `data.alert`, `data.extraSettings.*`, and the fields available for each alert.
+> Need to inspect what an alert returns? Open the [alert explorer](/docs/variables#alert-explorer) on the Platform Variables page to browse `data.alert`, `data.extraSettings.*`, and the fields available for each alert. For full `Overlay.on(...)` payload types, see [Overlay Type Definitions](/docs/custom-overlays/types).
 
 ## Index
 

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

@@ -48,6 +48,26 @@ export enum ConfigsFieldType {
  */
 export type OverlayListener = 'chat' | 'alert' | 'hfx' | 'virtuallight' | 'overlaycontent';
 
+export type ChatUserLevelKey = 'isSelf' | 'broadcaster' | 'mod' | 'vip' | 'tier3' | 'tier2' | 'subscriber' | 'regular' | 'follower' | 'anyone';
+
+export type ChatUserLevels = Record<ChatUserLevelKey, boolean>;
+
+export interface ChatReply {
+	/** Username of the message being replied to */
+	username: string;
+	/** Body of the message being replied to */
+	body: string;
+}
+
+export interface ChatSharedMessage {
+	/** Avatar for the source user/channel of the shared message */
+	avatar: string;
+	/** Display name for the source user/channel of the shared message */
+	displayname: string;
+	/** User ID for the source user/channel of the shared message */
+	userId: string;
+}
+
 /**
  * Chat message event data structure.
  * Fired when a chat message is received from any connected platform.
@@ -55,53 +75,50 @@ export type OverlayListener = 'chat' | 'alert' | 'hfx' | 'virtuallight' | 'overl
 export interface ChatEvent {
 	/** Platform origin (e.g., "twitch", "kick", "youtube", "tiktok") */
 	origin: string;
-	/** Unique message identifier */
-	id: string;
-	/** User's account username */
-	username: string;
+	/** Unique message identifier when the platform provides one */
+	id?: string;
+	/** User's account username/login */
+	username?: string;
 	/** User's display name (may differ from username) */
-	displayname: string;
+	displayname?: string;
 	/** Channel name where the message was sent */
-	channel: string;
+	channel?: string;
 	/** URL to the user's avatar image */
-	avatar: string;
+	avatar?: string | null;
 	/** The chat message content */
-	message: string;
+	message?: string;
 	/** User's chat color as hex code (e.g., "#00FF7F") */
-	color: string;
-	/** Array of badge image URLs */
-	badges: string[];
-	/** Raw badge data string (e.g., "broadcaster/1,sub/12,vip/1") */
-	badgesRaw: string;
-	/** Raw emotes data string */
-	emotesRaw: string;
-	/** Emote pack data structure */
-	emotesPack: Record<string, unknown>;
+	color?: string;
+	/** Badge identifiers or badge image URLs */
+	badges?: string[];
+	/** Lookup map used by some platforms to resolve badge identifiers to image URLs */
+	badgesLookup?: Record<string, string>;
+	/** Raw badge data string (e.g., "broadcaster/1,subscriber/12,vip/1") */
+	badgesRaw?: string;
+	/** Raw emotes data string from the platform */
+	emotesRaw?: string;
+	/** Emote pack data structure; shape varies by platform */
+	emotesPack?: Record<string, unknown>;
+	/** Whether the message contains a cheer/bits event */
+	isCheer?: boolean;
 	/** Reply data if this message is a reply to another */
-	reply: unknown | null;
+	reply?: ChatReply | null;
+	/** Whether this is a Twitch Power-up message */
+	isPowerup?: boolean;
+	/** Twitch Power-up message type */
+	powerupType?: 'animated-message' | 'gigantified-emote-message' | string | false;
+	/** Twitch Power-up animation name */
+	powerupName?: 'simmer' | 'rainbow-eclipse' | 'cosmic-abyss' | string | false;
+	/** Shared chat source metadata when Twitch shared chat provides it */
+	sharedMessage?: ChatSharedMessage;
 	/** Lumia-specific user level identifiers */
-	lumiauserlevels: number[];
+	lumiauserlevels?: number[];
 	/** User permission levels and roles */
-	userLevels: {
-		/** Whether this is the streamer's own message */
-		isSelf: boolean;
-		/** Whether the user is a moderator */
-		mod: boolean;
-		/** Whether the user is a VIP */
-		vip: boolean;
-		/** Whether the user is a tier 3 subscriber */
-		tier3: boolean;
-		/** Whether the user is a tier 2 subscriber */
-		tier2: boolean;
-		/** Whether the user is a subscriber (any tier) */
-		subscriber: boolean;
-		/** Whether the user is a regular viewer */
-		regular: boolean;
-		/** Whether the user is a follower */
-		follower: boolean;
-		/** Always true - indicates any user level */
-		anyone: boolean;
-	};
+	userLevels?: ChatUserLevels;
+	/** Local HH:mm:ss time string generated by Lumia */
+	time?: string;
+	/** Millisecond timestamp generated by Lumia */
+	timestamp?: number;
 }
 
 /**
@@ -558,6 +575,10 @@ export declare enum LumiaAlertValues {
     YOUTUBE_SUPERSTICKER = "youtube-supersticker",
     /** YouTube session superstickers */
     YOUTUBE_SESSION_SUPERSTICKERS = "youtube-sessionSuperstickers",
+    /** YouTube gift event (jewel-based) */
+    YOUTUBE_GIFTS = "youtube-gifts",
+    /** YouTube session gifts */
+    YOUTUBE_SESSION_GIFTS = "youtube-sessionGifts",
     /** YouTube total likes */
     YOUTUBE_LIKE = "youtube-like",
     /** YouTube total views */
@@ -1193,6 +1214,16 @@ export declare enum SystemVariables {
     YOUTUBE_LAST_GIFT_MEMBER = "youtube_last_gift_member",
     /** Session gift members (list). Use as {{youtube_session_gift_members}}. */
     YOUTUBE_SESSION_GIFT_MEMBERS = "youtube_session_gift_members",
+    /** Lifetime jewels count. Use as {{youtube_total_jewels_count}}. */
+    YOUTUBE_TOTAL_JEWELS_COUNT = "youtube_total_jewels_count",
+    /** Session jewels count. Use as {{youtube_session_jewels_count}}. */
+    YOUTUBE_SESSION_JEWELS_COUNT = "youtube_session_jewels_count",
+    /** Last jewel amount. Use as {{youtube_last_jewels}}. */
+    YOUTUBE_LAST_JEWELS = "youtube_last_jewels",
+    /** Last user that sent jewels. Use as {{youtube_last_jewels_user}}. */
+    YOUTUBE_LAST_JEWELS_USER = "youtube_last_jewels_user",
+    /** Session jewel gifters (list). Use as {{youtube_session_jewels_gifters}}. */
+    YOUTUBE_SESSION_JEWELS_GIFTERS = "youtube_session_jewels_gifters",
     /** Last subscriber. Use as {{youtube_last_subscriber}}. */
     YOUTUBE_LAST_SUBSCRIBER = "youtube_last_subscriber",
     /** Total uploaded videos. Use as {{youtube_total_video_count}}. */

package/dist/custom-overlays/gpt-instructions.md

@@ -52,6 +52,8 @@ In JS, wrap tokens in quotes: `const n = Number("{{twitch_session_bits_count}}")
 
 Valid listener names: `chat`, `alert`, `hfx`, `virtuallight`, `overlaycontent`.
 
+Full event payload shapes are in `custom-overlays.d.ts` and the Overlay Type Definitions page. Use `ChatEvent`, `AlertEvent`, `HfxEvent`, `VirtualLightEvent`, and `CustomOverlayContentEvent` there before guessing fields.
+
 Alert rules:
 
 - Branch on exact `data.alert` string equality. No `includes`, no `type`, no `platform` heuristics.

package/dist/custom-overlays.d.ts

@@ -48,6 +48,26 @@ export enum ConfigsFieldType {
  */
 export type OverlayListener = 'chat' | 'alert' | 'hfx' | 'virtuallight' | 'overlaycontent';
 
+export type ChatUserLevelKey = 'isSelf' | 'broadcaster' | 'mod' | 'vip' | 'tier3' | 'tier2' | 'subscriber' | 'regular' | 'follower' | 'anyone';
+
+export type ChatUserLevels = Record<ChatUserLevelKey, boolean>;
+
+export interface ChatReply {
+	/** Username of the message being replied to */
+	username: string;
+	/** Body of the message being replied to */
+	body: string;
+}
+
+export interface ChatSharedMessage {
+	/** Avatar for the source user/channel of the shared message */
+	avatar: string;
+	/** Display name for the source user/channel of the shared message */
+	displayname: string;
+	/** User ID for the source user/channel of the shared message */
+	userId: string;
+}
+
 /**
  * Chat message event data structure.
  * Fired when a chat message is received from any connected platform.
@@ -55,53 +75,50 @@ export type OverlayListener = 'chat' | 'alert' | 'hfx' | 'virtuallight' | 'overl
 export interface ChatEvent {
 	/** Platform origin (e.g., "twitch", "kick", "youtube", "tiktok") */
 	origin: string;
-	/** Unique message identifier */
-	id: string;
-	/** User's account username */
-	username: string;
+	/** Unique message identifier when the platform provides one */
+	id?: string;
+	/** User's account username/login */
+	username?: string;
 	/** User's display name (may differ from username) */
-	displayname: string;
+	displayname?: string;
 	/** Channel name where the message was sent */
-	channel: string;
+	channel?: string;
 	/** URL to the user's avatar image */
-	avatar: string;
+	avatar?: string | null;
 	/** The chat message content */
-	message: string;
+	message?: string;
 	/** User's chat color as hex code (e.g., "#00FF7F") */
-	color: string;
-	/** Array of badge image URLs */
-	badges: string[];
-	/** Raw badge data string (e.g., "broadcaster/1,sub/12,vip/1") */
-	badgesRaw: string;
-	/** Raw emotes data string */
-	emotesRaw: string;
-	/** Emote pack data structure */
-	emotesPack: Record<string, unknown>;
+	color?: string;
+	/** Badge identifiers or badge image URLs */
+	badges?: string[];
+	/** Lookup map used by some platforms to resolve badge identifiers to image URLs */
+	badgesLookup?: Record<string, string>;
+	/** Raw badge data string (e.g., "broadcaster/1,subscriber/12,vip/1") */
+	badgesRaw?: string;
+	/** Raw emotes data string from the platform */
+	emotesRaw?: string;
+	/** Emote pack data structure; shape varies by platform */
+	emotesPack?: Record<string, unknown>;
+	/** Whether the message contains a cheer/bits event */
+	isCheer?: boolean;
 	/** Reply data if this message is a reply to another */
-	reply: unknown | null;
+	reply?: ChatReply | null;
+	/** Whether this is a Twitch Power-up message */
+	isPowerup?: boolean;
+	/** Twitch Power-up message type */
+	powerupType?: 'animated-message' | 'gigantified-emote-message' | string | false;
+	/** Twitch Power-up animation name */
+	powerupName?: 'simmer' | 'rainbow-eclipse' | 'cosmic-abyss' | string | false;
+	/** Shared chat source metadata when Twitch shared chat provides it */
+	sharedMessage?: ChatSharedMessage;
 	/** Lumia-specific user level identifiers */
-	lumiauserlevels: number[];
+	lumiauserlevels?: number[];
 	/** User permission levels and roles */
-	userLevels: {
-		/** Whether this is the streamer's own message */
-		isSelf: boolean;
-		/** Whether the user is a moderator */
-		mod: boolean;
-		/** Whether the user is a VIP */
-		vip: boolean;
-		/** Whether the user is a tier 3 subscriber */
-		tier3: boolean;
-		/** Whether the user is a tier 2 subscriber */
-		tier2: boolean;
-		/** Whether the user is a subscriber (any tier) */
-		subscriber: boolean;
-		/** Whether the user is a regular viewer */
-		regular: boolean;
-		/** Whether the user is a follower */
-		follower: boolean;
-		/** Always true - indicates any user level */
-		anyone: boolean;
-	};
+	userLevels?: ChatUserLevels;
+	/** Local HH:mm:ss time string generated by Lumia */
+	time?: string;
+	/** Millisecond timestamp generated by Lumia */
+	timestamp?: number;
 }
 
 /**
@@ -558,6 +575,10 @@ export declare enum LumiaAlertValues {
     YOUTUBE_SUPERSTICKER = "youtube-supersticker",
     /** YouTube session superstickers */
     YOUTUBE_SESSION_SUPERSTICKERS = "youtube-sessionSuperstickers",
+    /** YouTube gift event (jewel-based) */
+    YOUTUBE_GIFTS = "youtube-gifts",
+    /** YouTube session gifts */
+    YOUTUBE_SESSION_GIFTS = "youtube-sessionGifts",
     /** YouTube total likes */
     YOUTUBE_LIKE = "youtube-like",
     /** YouTube total views */
@@ -1193,6 +1214,16 @@ export declare enum SystemVariables {
     YOUTUBE_LAST_GIFT_MEMBER = "youtube_last_gift_member",
     /** Session gift members (list). Use as {{youtube_session_gift_members}}. */
     YOUTUBE_SESSION_GIFT_MEMBERS = "youtube_session_gift_members",
+    /** Lifetime jewels count. Use as {{youtube_total_jewels_count}}. */
+    YOUTUBE_TOTAL_JEWELS_COUNT = "youtube_total_jewels_count",
+    /** Session jewels count. Use as {{youtube_session_jewels_count}}. */
+    YOUTUBE_SESSION_JEWELS_COUNT = "youtube_session_jewels_count",
+    /** Last jewel amount. Use as {{youtube_last_jewels}}. */
+    YOUTUBE_LAST_JEWELS = "youtube_last_jewels",
+    /** Last user that sent jewels. Use as {{youtube_last_jewels_user}}. */
+    YOUTUBE_LAST_JEWELS_USER = "youtube_last_jewels_user",
+    /** Session jewel gifters (list). Use as {{youtube_session_jewels_gifters}}. */
+    YOUTUBE_SESSION_JEWELS_GIFTERS = "youtube_session_jewels_gifters",
     /** Last subscriber. Use as {{youtube_last_subscriber}}. */
     YOUTUBE_LAST_SUBSCRIBER = "youtube_last_subscriber",
     /** Total uploaded videos. Use as {{youtube_total_video_count}}. */

package/dist/eventlist.types.d.ts

@@ -116,6 +116,7 @@ export declare const LumiaMapAlertTypeToEventListType: {
     "youtube-subscriber": LumiaEventListTypes;
     "youtube-superchat": LumiaEventListTypes;
     "youtube-supersticker": LumiaEventListTypes;
+    "youtube-gifts": LumiaEventListTypes;
     "youtube-like": LumiaEventListTypes;
     "youtube-viewers": LumiaEventListTypes;
     "crowdcontrol-effect": LumiaEventListTypes;

package/dist/eventlist.types.js

@@ -121,6 +121,7 @@ exports.LumiaMapAlertTypeToEventListType = {
     [activity_types_1.LumiaAlertValues.YOUTUBE_SUBSCRIBER]: LumiaEventListTypes.FOLLOWER,
     [activity_types_1.LumiaAlertValues.YOUTUBE_SUPERCHAT]: LumiaEventListTypes.SUPERCHATS,
     [activity_types_1.LumiaAlertValues.YOUTUBE_SUPERSTICKER]: LumiaEventListTypes.SUPERSTICKERS,
+    [activity_types_1.LumiaAlertValues.YOUTUBE_GIFTS]: LumiaEventListTypes.GIFTS,
     [activity_types_1.LumiaAlertValues.YOUTUBE_LIKE]: LumiaEventListTypes.LIKES,
     [activity_types_1.LumiaAlertValues.YOUTUBE_VIEWERS]: LumiaEventListTypes.OTHERS,
     [activity_types_1.LumiaAlertValues.CROWDCONTROL_EFFECT]: LumiaEventListTypes.OTHERS,

package/dist/variables.types.d.ts

@@ -367,6 +367,16 @@ export declare enum SystemVariables {
     YOUTUBE_LAST_GIFT_MEMBER = "youtube_last_gift_member",
     /** Session gift members (list). Use as {{youtube_session_gift_members}}. */
     YOUTUBE_SESSION_GIFT_MEMBERS = "youtube_session_gift_members",
+    /** Lifetime jewels count. Use as {{youtube_total_jewels_count}}. */
+    YOUTUBE_TOTAL_JEWELS_COUNT = "youtube_total_jewels_count",
+    /** Session jewels count. Use as {{youtube_session_jewels_count}}. */
+    YOUTUBE_SESSION_JEWELS_COUNT = "youtube_session_jewels_count",
+    /** Last jewel amount. Use as {{youtube_last_jewels}}. */
+    YOUTUBE_LAST_JEWELS = "youtube_last_jewels",
+    /** Last user that sent jewels. Use as {{youtube_last_jewels_user}}. */
+    YOUTUBE_LAST_JEWELS_USER = "youtube_last_jewels_user",
+    /** Session jewel gifters (list). Use as {{youtube_session_jewels_gifters}}. */
+    YOUTUBE_SESSION_JEWELS_GIFTERS = "youtube_session_jewels_gifters",
     /** Last subscriber. Use as {{youtube_last_subscriber}}. */
     YOUTUBE_LAST_SUBSCRIBER = "youtube_last_subscriber",
     /** Total uploaded videos. Use as {{youtube_total_video_count}}. */
@@ -1039,6 +1049,8 @@ export declare const AllVariables: {
             sessionMembers: string[];
             giftMembers: string[];
             sessionGiftMembers: string[];
+            gifts: string[];
+            sessionGifts: string[];
             superchat: string[];
             sessionSuperchats: string[];
             supersticker: string[];

package/dist/variables.types.js

@@ -381,6 +381,16 @@ var SystemVariables;
     SystemVariables["YOUTUBE_LAST_GIFT_MEMBER"] = "youtube_last_gift_member";
     /** Session gift members (list). Use as {{youtube_session_gift_members}}. */
     SystemVariables["YOUTUBE_SESSION_GIFT_MEMBERS"] = "youtube_session_gift_members";
+    /** Lifetime jewels count. Use as {{youtube_total_jewels_count}}. */
+    SystemVariables["YOUTUBE_TOTAL_JEWELS_COUNT"] = "youtube_total_jewels_count";
+    /** Session jewels count. Use as {{youtube_session_jewels_count}}. */
+    SystemVariables["YOUTUBE_SESSION_JEWELS_COUNT"] = "youtube_session_jewels_count";
+    /** Last jewel amount. Use as {{youtube_last_jewels}}. */
+    SystemVariables["YOUTUBE_LAST_JEWELS"] = "youtube_last_jewels";
+    /** Last user that sent jewels. Use as {{youtube_last_jewels_user}}. */
+    SystemVariables["YOUTUBE_LAST_JEWELS_USER"] = "youtube_last_jewels_user";
+    /** Session jewel gifters (list). Use as {{youtube_session_jewels_gifters}}. */
+    SystemVariables["YOUTUBE_SESSION_JEWELS_GIFTERS"] = "youtube_session_jewels_gifters";
     /** Last subscriber. Use as {{youtube_last_subscriber}}. */
     SystemVariables["YOUTUBE_LAST_SUBSCRIBER"] = "youtube_last_subscriber";
     /** Total uploaded videos. Use as {{youtube_total_video_count}}. */
@@ -2011,6 +2021,11 @@ exports.AllVariables = {
             'youtube_session_gift_members_count',
             'youtube_last_gift_member',
             'youtube_session_gift_members',
+            'youtube_total_jewels_count',
+            'youtube_session_jewels_count',
+            'youtube_last_jewels',
+            'youtube_last_jewels_user',
+            'youtube_session_jewels_gifters',
             'youtube_total_video_count',
             'youtube_total_view_count',
         ],
@@ -2040,6 +2055,22 @@ exports.AllVariables = {
                 'subPlanName',
             ],
             sessionGiftMembers: ['total', 'previousTotal'],
+            gifts: [
+                'username',
+                'displayname',
+                'avatar',
+                'userId',
+                'jewelsAmount',
+                'totalJewels',
+                'comboCount',
+                'giftName',
+                'giftUrl',
+                'hasVisualEffect',
+                'altText',
+                'language',
+                'message',
+            ],
+            sessionGifts: ['total', 'previousTotal'],
             superchat: ['username', 'displayname', 'currency', 'currencySymbol', 'amount', 'message'],
             sessionSuperchats: ['total', 'previousTotal', 'currency', 'currencySymbol'],
             supersticker: ['username', 'displayname', 'stickerId', 'stickerName', 'amount', 'currency', 'currencySymbol', 'imageUrl'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumiastream/lumia-types",
-  "version": "3.2.8",
+  "version": "3.3.0",
   "description": "",
   "main": "./dist/index.js",
   "files": [