@lumiastream/lumia-types 3.5.9 → 3.6.0-beta.2

package/dist/alert.types.js

@@ -1681,6 +1681,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     type: 'gigantify_an_emote',
                     amount: 100,
+                    contentImage: 'https://static-cdn.jtvnw.net/twitch-power-ups/gigantify_an_emote/black/v1/default_2x.png',
                 },
             },
             {
@@ -1691,6 +1692,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     type: 'celebration',
                     amount: 500,
+                    contentImage: 'https://static-cdn.jtvnw.net/twitch-power-ups/celebration/black/v1/default_2x.png',
                 },
             },
         ],
@@ -2784,7 +2786,7 @@ exports.LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2800,7 +2802,7 @@ exports.LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2816,7 +2818,7 @@ exports.LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2891,7 +2893,7 @@ exports.LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 0,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -2954,7 +2956,7 @@ exports.LumiaAlertConfigs = {
                 extraSettings: {
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 20,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -3016,7 +3018,7 @@ exports.LumiaAlertConfigs = {
                 extraSettings: {
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 100,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -3130,6 +3132,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     clip_title: 'Lumia Stream',
                     clip_url: 'https://www.twitch.tv/lumiastream/clip/EnchantingSuccessfulMoonBlargNaut-ev_c6MJ_Qb0o7gEx',
+                    contentImage: 'https://clips-media-assets2.twitch.tv/AT-cm%7CEnchantingSuccessfulMoonBlargNaut-preview-480x272.jpg',
                 },
             },
         ],
@@ -3924,7 +3927,7 @@ exports.LumiaAlertConfigs = {
                     comboCount: 1,
                     hasVisualEffect: false,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Heart',
@@ -3944,7 +3947,7 @@ exports.LumiaAlertConfigs = {
                     comboCount: 1,
                     hasVisualEffect: true,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Rose',
@@ -3964,7 +3967,7 @@ exports.LumiaAlertConfigs = {
                     comboCount: 5,
                     hasVisualEffect: true,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Star',
@@ -4218,7 +4221,7 @@ exports.LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_beaming_face',
                     stickerName: 'Emoji Beaming Face',
-                    imageUrl: (_b = (_a = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _a === void 0 ? void 0 : _a.imageUrl) !== null && _b !== void 0 ? _b : '',
+                    contentImage: (_b = (_a = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _a === void 0 ? void 0 : _a.imageUrl) !== null && _b !== void 0 ? _b : '',
                 },
             },
             {
@@ -4233,7 +4236,7 @@ exports.LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_laughing',
                     stickerName: 'Emoji Laughing',
-                    imageUrl: (_d = (_c = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_laughing')) === null || _c === void 0 ? void 0 : _c.imageUrl) !== null && _d !== void 0 ? _d : '',
+                    contentImage: (_d = (_c = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_laughing')) === null || _c === void 0 ? void 0 : _c.imageUrl) !== null && _d !== void 0 ? _d : '',
                 },
             },
             {
@@ -4248,7 +4251,7 @@ exports.LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_sad',
                     stickerName: 'Emoji Sad',
-                    imageUrl: (_f = (_e = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_sad')) === null || _e === void 0 ? void 0 : _e.imageUrl) !== null && _f !== void 0 ? _f : '',
+                    contentImage: (_f = (_e = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_sad')) === null || _e === void 0 ? void 0 : _e.imageUrl) !== null && _f !== void 0 ? _f : '',
                 },
             },
         ],
@@ -4287,7 +4290,7 @@ exports.LumiaAlertConfigs = {
             {
                 type: 'text',
                 label: 'Image URL',
-                variableField: 'imageUrl',
+                variableField: 'contentImage',
                 required: false,
                 default: (_h = (_g = youtube_superstickers_1.YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _g === void 0 ? void 0 : _g.imageUrl) !== null && _h !== void 0 ? _h : '',
             },
@@ -4959,7 +4962,7 @@ exports.LumiaAlertConfigs = {
                     coins: 1,
                     diamonds: 1,
                     amount: 1,
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png',
                 },
             },
             {
@@ -4969,7 +4972,7 @@ exports.LumiaAlertConfigs = {
                     username: 'lumiastream',
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     giftName: 'Pumpkin',
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
                     giftType: 2,
                     giftId: 7095,
                     giftAmount: 1,
@@ -4986,7 +4989,7 @@ exports.LumiaAlertConfigs = {
                     username: 'lumiastream',
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     giftName: 'Boiling Cauldron',
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
                     giftType: 2,
                     giftId: 7158,
                     giftAmount: 1,
@@ -7832,6 +7835,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7842,6 +7846,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 200,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7852,6 +7857,7 @@ exports.LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 300,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -7910,6 +7916,7 @@ exports.LumiaAlertConfigs = {
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7921,6 +7928,7 @@ exports.LumiaAlertConfigs = {
                     amount: 200,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7932,6 +7940,7 @@ exports.LumiaAlertConfigs = {
                     amount: 300,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -7997,6 +8006,7 @@ exports.LumiaAlertConfigs = {
                     giveawayId: 'TEST123',
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -8061,6 +8071,7 @@ exports.LumiaAlertConfigs = {
                     giveawayId: 'TEST123',
                     winners: ['winner1', 'winner2', 'winner3'],
                     winnerCount: 3,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],

package/dist/emulate.helpers.d.ts

@@ -6,4 +6,5 @@ export interface InputFieldLike {
 }
 export declare function isRedundantInputField(inputField: InputFieldLike, allInputFields: ReadonlyArray<InputFieldLike> | undefined): boolean;
 export declare function syncLinkedVariableFields(values: Record<string, any>): void;
+export declare function aliasContentImageFromLegacy(values: Record<string, any>): void;
 export declare function coerceNumericAlertFields(values: Record<string, any>): void;

package/dist/emulate.helpers.js

@@ -5,6 +5,7 @@ exports.getExampleAlertVariableValue = getExampleAlertVariableValue;
 exports.buildExampleAlertVariables = buildExampleAlertVariables;
 exports.isRedundantInputField = isRedundantInputField;
 exports.syncLinkedVariableFields = syncLinkedVariableFields;
+exports.aliasContentImageFromLegacy = aliasContentImageFromLegacy;
 exports.coerceNumericAlertFields = coerceNumericAlertFields;
 exports.EMULATE_EXAMPLE_AVATAR_URL = 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-300x300.png';
 function getExampleAlertVariableValue(variableName) {
@@ -85,6 +86,21 @@ function buildExampleAlertVariables(acceptedVariables, existingExtraSettings) {
     }, {});
 }
 const LINKED_VARIABLE_FIELD_GROUPS = [['giftAmount', 'amount']];
+// One-way alias: any of the legacy per-platform image field names (the
+// pre-canonical names — giftPictureUrl, imageUrl, etc.) backfills
+// `contentImage` if it's empty. We don't do the reverse — populating every
+// legacy field from canonical would scatter the URL across alert types it
+// doesn't belong to. Real platform managers continue to emit their own
+// legacy field directly; this only matters for emulated payloads and any
+// older form that still binds to a legacy variableField.
+const LEGACY_CONTENT_IMAGE_FIELDS = [
+    'giftPictureUrl',
+    'imageUrl',
+    'giftImageUrl',
+    'clip_thumbnail',
+    'charity_logo',
+    'offerImageUrl',
+];
 function isRedundantInputField(inputField, allInputFields) {
     if (!inputField || !allInputFields)
         return false;
@@ -164,6 +180,19 @@ const NUMERIC_ALERT_FIELDS = new Set([
     'progress',
     'goal',
 ]);
+function aliasContentImageFromLegacy(values) {
+    if (!values)
+        return;
+    if (typeof values.contentImage === 'string' && values.contentImage !== '')
+        return;
+    for (const key of LEGACY_CONTENT_IMAGE_FIELDS) {
+        const v = values[key];
+        if (typeof v === 'string' && v !== '') {
+            values.contentImage = v;
+            return;
+        }
+    }
+}
 function coerceNumericAlertFields(values) {
     if (!values)
         return;

package/dist/esm/alert.types.js

@@ -1678,6 +1678,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     type: 'gigantify_an_emote',
                     amount: 100,
+                    contentImage: 'https://static-cdn.jtvnw.net/twitch-power-ups/gigantify_an_emote/black/v1/default_2x.png',
                 },
             },
             {
@@ -1688,6 +1689,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     type: 'celebration',
                     amount: 500,
+                    contentImage: 'https://static-cdn.jtvnw.net/twitch-power-ups/celebration/black/v1/default_2x.png',
                 },
             },
         ],
@@ -2781,7 +2783,7 @@ export const LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2797,7 +2799,7 @@ export const LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2813,7 +2815,7 @@ export const LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_website: 'https://lumiastream.com',
                     started_at: '2022-07-26T17:00:03.17106713Z',
                 },
@@ -2888,7 +2890,7 @@ export const LumiaAlertConfigs = {
                     charity_id: 'lumia123',
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 0,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -2951,7 +2953,7 @@ export const LumiaAlertConfigs = {
                 extraSettings: {
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 20,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -3013,7 +3015,7 @@ export const LumiaAlertConfigs = {
                 extraSettings: {
                     charity_name: 'Lumia Charity',
                     charity_description: 'Give me more lights',
-                    charity_logo: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
+                    contentImage: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     charity_amount: 100,
                     charity_target_amount: 100,
                     charity_website: 'https://lumiastream.com',
@@ -3127,6 +3129,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     clip_title: 'Lumia Stream',
                     clip_url: 'https://www.twitch.tv/lumiastream/clip/EnchantingSuccessfulMoonBlargNaut-ev_c6MJ_Qb0o7gEx',
+                    contentImage: 'https://clips-media-assets2.twitch.tv/AT-cm%7CEnchantingSuccessfulMoonBlargNaut-preview-480x272.jpg',
                 },
             },
         ],
@@ -3921,7 +3924,7 @@ export const LumiaAlertConfigs = {
                     comboCount: 1,
                     hasVisualEffect: false,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Heart',
@@ -3941,7 +3944,7 @@ export const LumiaAlertConfigs = {
                     comboCount: 1,
                     hasVisualEffect: true,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Rose',
@@ -3961,7 +3964,7 @@ export const LumiaAlertConfigs = {
                     comboCount: 5,
                     hasVisualEffect: true,
                     giftUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
-                    giftImageUrl: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
+                    contentImage: 'https://www.gstatic.com/youtube/img/pdg/gift/assets/gold_coin_v2_320x320.png',
                     giftDurationSeconds: 3,
                     giftDurationNanos: 0,
                     altText: 'Star',
@@ -4215,7 +4218,7 @@ export const LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_beaming_face',
                     stickerName: 'Emoji Beaming Face',
-                    imageUrl: (_b = (_a = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _a === void 0 ? void 0 : _a.imageUrl) !== null && _b !== void 0 ? _b : '',
+                    contentImage: (_b = (_a = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _a === void 0 ? void 0 : _a.imageUrl) !== null && _b !== void 0 ? _b : '',
                 },
             },
             {
@@ -4230,7 +4233,7 @@ export const LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_laughing',
                     stickerName: 'Emoji Laughing',
-                    imageUrl: (_d = (_c = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_laughing')) === null || _c === void 0 ? void 0 : _c.imageUrl) !== null && _d !== void 0 ? _d : '',
+                    contentImage: (_d = (_c = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_laughing')) === null || _c === void 0 ? void 0 : _c.imageUrl) !== null && _d !== void 0 ? _d : '',
                 },
             },
             {
@@ -4245,7 +4248,7 @@ export const LumiaAlertConfigs = {
                     currencySymbol: '$',
                     stickerId: 'emoji_sad',
                     stickerName: 'Emoji Sad',
-                    imageUrl: (_f = (_e = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_sad')) === null || _e === void 0 ? void 0 : _e.imageUrl) !== null && _f !== void 0 ? _f : '',
+                    contentImage: (_f = (_e = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_sad')) === null || _e === void 0 ? void 0 : _e.imageUrl) !== null && _f !== void 0 ? _f : '',
                 },
             },
         ],
@@ -4284,7 +4287,7 @@ export const LumiaAlertConfigs = {
             {
                 type: 'text',
                 label: 'Image URL',
-                variableField: 'imageUrl',
+                variableField: 'contentImage',
                 required: false,
                 default: (_h = (_g = YoutubeSuperstickersData.find((sticker) => sticker.value === 'emoji_beaming_face')) === null || _g === void 0 ? void 0 : _g.imageUrl) !== null && _h !== void 0 ? _h : '',
             },
@@ -4956,7 +4959,7 @@ export const LumiaAlertConfigs = {
                     coins: 1,
                     diamonds: 1,
                     amount: 1,
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/eba3a9bb85c33e017f3648eaf88d7189~tplv-obj.png',
                 },
             },
             {
@@ -4966,7 +4969,7 @@ export const LumiaAlertConfigs = {
                     username: 'lumiastream',
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     giftName: 'Pumpkin',
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
                     giftType: 2,
                     giftId: 7095,
                     giftAmount: 1,
@@ -4983,7 +4986,7 @@ export const LumiaAlertConfigs = {
                     username: 'lumiastream',
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     giftName: 'Boiling Cauldron',
-                    giftPictureUrl: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
+                    contentImage: 'https://p19-webcast.tiktokcdn.com/img/maliva/webcast-va/e675252b83e97135f9ede3b5d32c2c71~tplv-obj.png',
                     giftType: 2,
                     giftId: 7158,
                     giftAmount: 1,
@@ -7829,6 +7832,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7839,6 +7843,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 200,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7849,6 +7854,7 @@ export const LumiaAlertConfigs = {
                     avatar: 'https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png',
                     amount: 300,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -7907,6 +7913,7 @@ export const LumiaAlertConfigs = {
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7918,6 +7925,7 @@ export const LumiaAlertConfigs = {
                     amount: 200,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
             {
@@ -7929,6 +7937,7 @@ export const LumiaAlertConfigs = {
                     amount: 300,
                     currency: LumiaVariationCurrency.USD,
                     items: 'Shirt, Keyblade, Chaos Emerald',
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -7994,6 +8003,7 @@ export const LumiaAlertConfigs = {
                     giveawayId: 'TEST123',
                     amount: 100,
                     currency: LumiaVariationCurrency.USD,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],
@@ -8058,6 +8068,7 @@ export const LumiaAlertConfigs = {
                     giveawayId: 'TEST123',
                     winners: ['winner1', 'winner2', 'winner3'],
                     winnerCount: 3,
+                    contentImage: 'https://cdn.fourthwall.com/storefront-en/_next/image?url=https%3A%2F%2Fcdn.fourthwall.com%2Fpublic%2Flogos%2Ffw-logo-stacked-purple.png',
                 },
             },
         ],

package/dist/esm/emulate.helpers.js

@@ -77,6 +77,21 @@ export function buildExampleAlertVariables(acceptedVariables, existingExtraSetti
     }, {});
 }
 const LINKED_VARIABLE_FIELD_GROUPS = [['giftAmount', 'amount']];
+// One-way alias: any of the legacy per-platform image field names (the
+// pre-canonical names — giftPictureUrl, imageUrl, etc.) backfills
+// `contentImage` if it's empty. We don't do the reverse — populating every
+// legacy field from canonical would scatter the URL across alert types it
+// doesn't belong to. Real platform managers continue to emit their own
+// legacy field directly; this only matters for emulated payloads and any
+// older form that still binds to a legacy variableField.
+const LEGACY_CONTENT_IMAGE_FIELDS = [
+    'giftPictureUrl',
+    'imageUrl',
+    'giftImageUrl',
+    'clip_thumbnail',
+    'charity_logo',
+    'offerImageUrl',
+];
 export function isRedundantInputField(inputField, allInputFields) {
     if (!inputField || !allInputFields)
         return false;
@@ -156,6 +171,19 @@ const NUMERIC_ALERT_FIELDS = new Set([
     'progress',
     'goal',
 ]);
+export function aliasContentImageFromLegacy(values) {
+    if (!values)
+        return;
+    if (typeof values.contentImage === 'string' && values.contentImage !== '')
+        return;
+    for (const key of LEGACY_CONTENT_IMAGE_FIELDS) {
+        const v = values[key];
+        if (typeof v === 'string' && v !== '') {
+            values.contentImage = v;
+            return;
+        }
+    }
+}
 export function coerceNumericAlertFields(values) {
     if (!values)
         return;

package/dist/esm/index.js

@@ -4,7 +4,7 @@ export { LumiaIntegrations, LumiaEventTypes, } from './event.types.js';
 export { LumiaEventListTypes, LumiaMapAlertTypeToEventListType, AlertsToFilter, PlatformsToFilter, LumiaEventListTypeColors, getEventListCategoryColor } from './eventlist.types.js';
 export { SystemVariables, ReservedVariables, AllVariables, getAcceptedVariableName, getAcceptedVariableNames, } from './variables.types.js';
 export { formatCondition } from './helpers.js';
-export { EMULATE_EXAMPLE_AVATAR_URL, getExampleAlertVariableValue, buildExampleAlertVariables, coerceNumericAlertFields, isRedundantInputField, syncLinkedVariableFields, } from './emulate.helpers.js';
+export { EMULATE_EXAMPLE_AVATAR_URL, getExampleAlertVariableValue, buildExampleAlertVariables, coerceNumericAlertFields, aliasContentImageFromLegacy, isRedundantInputField, syncLinkedVariableFields, } from './emulate.helpers.js';
 export { KickKicksData } from './kick_kicks.js';
 export { BLANK_OVERLAY_TEMPLATE_ID } from './overlay_template.types.js';
 export { TiktokGiftsData } from './tiktok_gifts.js';

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { ILumiaSendPack, ILumiaEvent, ILumiaEventChatCommandBody, ILumiaEventCha
 export { LumiaEventListTypes, LumiaMapAlertTypeToEventListType, AlertsToFilter, PlatformsToFilter, LumiaEventListTypeColors, getEventListCategoryColor } from './eventlist.types';
 export { SystemVariables, ReservedVariables, AllVariables, getAcceptedVariableName, getAcceptedVariableNames, type LumiaAcceptedVariable, type LumiaAcceptedVariableDefinition, } from './variables.types';
 export { formatCondition } from './helpers';
-export { EMULATE_EXAMPLE_AVATAR_URL, getExampleAlertVariableValue, buildExampleAlertVariables, coerceNumericAlertFields, isRedundantInputField, syncLinkedVariableFields, type InputFieldLike, } from './emulate.helpers';
+export { EMULATE_EXAMPLE_AVATAR_URL, getExampleAlertVariableValue, buildExampleAlertVariables, coerceNumericAlertFields, aliasContentImageFromLegacy, isRedundantInputField, syncLinkedVariableFields, type InputFieldLike, } from './emulate.helpers';
 export { KickKicksData } from './kick_kicks';
 export { BLANK_OVERLAY_TEMPLATE_ID, type OverlayTemplate, type OverlayTemplateLayerDescriptor, type OverlayTemplateAnchor, type OverlayTemplateLayerOverrides } from './overlay_template.types';
 export { TiktokGiftsData } from './tiktok_gifts';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SongRequestPlaybackTarget = exports.SongRequestProvider = exports.SongRequestSource = exports.SongRequestStatus = exports.VIEWER_PROFILE_ACHIEVEMENTS = exports.YoutubeSuperstickersData = exports.TiktokGiftsData = exports.BLANK_OVERLAY_TEMPLATE_ID = exports.KickKicksData = exports.syncLinkedVariableFields = exports.isRedundantInputField = exports.coerceNumericAlertFields = exports.buildExampleAlertVariables = exports.getExampleAlertVariableValue = exports.EMULATE_EXAMPLE_AVATAR_URL = exports.formatCondition = exports.getAcceptedVariableNames = exports.getAcceptedVariableName = exports.AllVariables = exports.ReservedVariables = exports.SystemVariables = exports.getEventListCategoryColor = exports.LumiaEventListTypeColors = exports.PlatformsToFilter = exports.AlertsToFilter = 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;
+exports.SongRequestPlaybackTarget = exports.SongRequestProvider = exports.SongRequestSource = exports.SongRequestStatus = exports.VIEWER_PROFILE_ACHIEVEMENTS = exports.YoutubeSuperstickersData = exports.TiktokGiftsData = exports.BLANK_OVERLAY_TEMPLATE_ID = exports.KickKicksData = exports.syncLinkedVariableFields = exports.isRedundantInputField = exports.aliasContentImageFromLegacy = exports.coerceNumericAlertFields = exports.buildExampleAlertVariables = exports.getExampleAlertVariableValue = exports.EMULATE_EXAMPLE_AVATAR_URL = exports.formatCondition = exports.getAcceptedVariableNames = exports.getAcceptedVariableName = exports.AllVariables = exports.ReservedVariables = exports.SystemVariables = exports.getEventListCategoryColor = exports.LumiaEventListTypeColors = exports.PlatformsToFilter = exports.AlertsToFilter = 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; } });
@@ -41,6 +41,7 @@ Object.defineProperty(exports, "EMULATE_EXAMPLE_AVATAR_URL", { enumerable: true,
 Object.defineProperty(exports, "getExampleAlertVariableValue", { enumerable: true, get: function () { return emulate_helpers_1.getExampleAlertVariableValue; } });
 Object.defineProperty(exports, "buildExampleAlertVariables", { enumerable: true, get: function () { return emulate_helpers_1.buildExampleAlertVariables; } });
 Object.defineProperty(exports, "coerceNumericAlertFields", { enumerable: true, get: function () { return emulate_helpers_1.coerceNumericAlertFields; } });
+Object.defineProperty(exports, "aliasContentImageFromLegacy", { enumerable: true, get: function () { return emulate_helpers_1.aliasContentImageFromLegacy; } });
 Object.defineProperty(exports, "isRedundantInputField", { enumerable: true, get: function () { return emulate_helpers_1.isRedundantInputField; } });
 Object.defineProperty(exports, "syncLinkedVariableFields", { enumerable: true, get: function () { return emulate_helpers_1.syncLinkedVariableFields; } });
 var kick_kicks_1 = require("./kick_kicks");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumiastream/lumia-types",
-  "version": "3.5.9",
+  "version": "3.6.0-beta.2",
   "description": "",
   "main": "./dist/index.js",
   "module": "./dist/esm/index.js",