@zaflun/lumio-protocol 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to `@zaflun/lumio-protocol` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.10.0
+
+### Added
+
+- **Shopify event types** — `shopify:order`, `shopify:order_paid` and
+  `shopify:product` in `LUMIO_EVENT_TYPES`, with payload schemas. Every
+  Shopify payload names its store in `shop { domain, label }`; `label` is the
+  store's label in Lumio when the event arrived. `shop` is optional: events
+  stored before stores carried it have none. Order payloads carry
+  `total_price` / `currency` and `line_items` only as the store's settings
+  allow, and `customer_display` only with the buyer's consent (untrusted
+  buyer text). Golden fixtures in `fixtures/events/shopify/`.
+
+### Changed
+
+- **zod `^4.6.7`** — the `zod` dependency range moves up from `^4.3.6`.
+- **Built with tsup 9** — the type declarations emit `export type { … }`
+  instead of `export { type … }`; the exported types are unchanged.
+
 ## 0.9.0
 
 ### Added

package/README.md

@@ -10,7 +10,7 @@ npm install @zaflun/lumio-protocol
 
 ## What's included
 
-- **54 Event Types** — Twitch, YouTube, Kick, Spotify, StreamElements, Chat
+- **65 Event Types** — Twitch, YouTube, Kick, Spotify, StreamElements, Shopify, Chat
 - **21 Action Types** — Chat, OBS, Spotify, Events, Overlay
 - **Message Schemas** — JSON-RPC 2.0 wire format (Zod validated)
 - **30 Component Types** — `LumioComponentNode` for serialized UI trees

package/dist/index.d.ts

@@ -283,7 +283,7 @@ declare const lumioMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "type">;
 type LumioMessage = z.infer<typeof lumioMessageSchema>;
 
-declare const LUMIO_EVENT_TYPES: readonly ["twitch:follower", "twitch:subscribe", "twitch:gift", "twitch:resub", "twitch:cheer", "twitch:raid", "twitch:reward", "twitch:reward_status", "twitch:reward_add", "twitch:reward_update", "twitch:reward_remove", "twitch:hype_train", "twitch:hype_train_end", "twitch:poll", "twitch:poll_end", "twitch:prediction", "twitch:prediction_lock", "twitch:prediction_end", "twitch:goal", "twitch:goal_end", "twitch:ad_break", "twitch:ban", "twitch:unban", "twitch:stream_online", "twitch:stream_offline", "twitch:stream_update", "youtube:subscribe", "youtube:member", "youtube:superchat", "youtube:supersticker", "youtube:gift_membership", "youtube:gift_membership_received", "youtube:poll", "youtube:stream_online", "youtube:stream_offline", "kick:follower", "kick:subscribe", "kick:resub", "kick:gift", "kick:kicks", "kick:reward", "kick:reward_status", "kick:stream_online", "kick:stream_offline", "kick:stream_update", "spotify:track", "spotify:play", "spotify:pause", "spotify:skip", "spotify:volume", "spotify:queue_add", "spotify:device", "spotify:playlist_add", "spotify:playlist_remove", "spotify:playlist_create", "spotify:playlist_edit", "spotify:playlist_delete", "streamelements:tip", "twitch:chat", "youtube:chat", "kick:chat", "chat:message"];
+declare const LUMIO_EVENT_TYPES: readonly ["twitch:follower", "twitch:subscribe", "twitch:gift", "twitch:resub", "twitch:cheer", "twitch:raid", "twitch:reward", "twitch:reward_status", "twitch:reward_add", "twitch:reward_update", "twitch:reward_remove", "twitch:hype_train", "twitch:hype_train_end", "twitch:poll", "twitch:poll_end", "twitch:prediction", "twitch:prediction_lock", "twitch:prediction_end", "twitch:goal", "twitch:goal_end", "twitch:ad_break", "twitch:ban", "twitch:unban", "twitch:stream_online", "twitch:stream_offline", "twitch:stream_update", "youtube:subscribe", "youtube:member", "youtube:superchat", "youtube:supersticker", "youtube:gift_membership", "youtube:gift_membership_received", "youtube:poll", "youtube:stream_online", "youtube:stream_offline", "kick:follower", "kick:subscribe", "kick:resub", "kick:gift", "kick:kicks", "kick:reward", "kick:reward_status", "kick:stream_online", "kick:stream_offline", "kick:stream_update", "spotify:track", "spotify:play", "spotify:pause", "spotify:skip", "spotify:volume", "spotify:queue_add", "spotify:device", "spotify:playlist_add", "spotify:playlist_remove", "spotify:playlist_create", "spotify:playlist_edit", "spotify:playlist_delete", "streamelements:tip", "shopify:order", "shopify:order_paid", "shopify:product", "twitch:chat", "youtube:chat", "kick:chat", "chat:message"];
 type LumioEventType = (typeof LUMIO_EVENT_TYPES)[number];
 declare const lumioEventTypeSchema: z.ZodEnum<{
     "twitch:follower": "twitch:follower";
@@ -344,6 +344,9 @@ declare const lumioEventTypeSchema: z.ZodEnum<{
     "spotify:playlist_edit": "spotify:playlist_edit";
     "spotify:playlist_delete": "spotify:playlist_delete";
     "streamelements:tip": "streamelements:tip";
+    "shopify:order": "shopify:order";
+    "shopify:order_paid": "shopify:order_paid";
+    "shopify:product": "shopify:product";
     "twitch:chat": "twitch:chat";
     "youtube:chat": "youtube:chat";
     "kick:chat": "kick:chat";
@@ -394,8 +397,8 @@ interface SoundStopEvent {
 declare const STORAGE_SCOPES: readonly ["instance", "overlay", "account", "global"];
 type StorageScope = (typeof STORAGE_SCOPES)[number];
 declare const storageScopeSchema: z.ZodEnum<{
-    overlay: "overlay";
     instance: "instance";
+    overlay: "overlay";
     account: "account";
     global: "global";
 }>;
@@ -428,11 +431,8 @@ declare const chatMessagePayloadSchema: z.ZodObject<{
     display_name: z.ZodNullable<z.ZodString>;
     avatar_url: z.ZodNullable<z.ZodString>;
     message: z.ZodString;
-    /** Platform-specific emote entries. */
     emotes: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
-    /** Twitch GIF fragments `{ id, url, provider, alt }`; absent without a GIF. */
     gifs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-    /** Platform-specific badge entries. */
     badges: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
     color: z.ZodNullable<z.ZodString>;
     is_mod: z.ZodBoolean;
@@ -453,11 +453,6 @@ declare const chatMessagePayloadSchema: z.ZodObject<{
     source_channel: z.ZodOptional<z.ZodUnknown>;
     announcement_color: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$loose>;
-/**
- * zod schema for the payload of every event type. `satisfies` makes a
- * `LUMIO_EVENT_TYPES` entry without a schema (or a schema for a type that is
- * not listed) a type error.
- */
 declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
     readonly "twitch:follower": z.ZodObject<{
         followed_at: z.ZodString;
@@ -495,7 +490,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         message_id: z.ZodString;
         notice_type: z.ZodString;
         system_message: z.ZodString;
-        /** Emotes of `message`, normalised like chat-message emotes (ZAF-1306). */
         emotes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         avatarUrl: z.ZodOptional<z.ZodString>;
         user_id: z.ZodString;
@@ -506,15 +500,11 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         broadcaster_user_name: z.ZodString;
     }, z.core.$loose>;
     readonly "twitch:gift": z.ZodObject<{
-        /** Sub tier (`1000`, `2000`, `3000`). */
         tier: z.ZodOptional<z.ZodString>;
         duration_months: z.ZodOptional<z.ZodNumber>;
-        /** Gifts in a community gift (`community_sub_gift`). */
         total: z.ZodOptional<z.ZodNumber>;
-        /** The gifter's all-time gift count; `null` when anonymous. */
         cumulative_total: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         community_gift_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        /** Set for a single gift (`sub_gift`), absent for a community gift. */
         recipient_user_id: z.ZodOptional<z.ZodString>;
         recipient_user_login: z.ZodOptional<z.ZodString>;
         recipient_user_name: z.ZodOptional<z.ZodString>;
@@ -535,7 +525,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         message_id: z.ZodString;
         notice_type: z.ZodString;
         system_message: z.ZodString;
-        /** Emotes of `message`, normalised like chat-message emotes (ZAF-1306). */
         emotes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         avatarUrl: z.ZodOptional<z.ZodString>;
         user_id: z.ZodString;
@@ -579,7 +568,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         message_id: z.ZodString;
         notice_type: z.ZodString;
         system_message: z.ZodString;
-        /** Emotes of `message`, normalised like chat-message emotes (ZAF-1306). */
         emotes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
         avatarUrl: z.ZodOptional<z.ZodString>;
         user_id: z.ZodString;
@@ -596,9 +584,7 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         is_anonymous: z.ZodBoolean;
         bits: z.ZodNumber;
         message: z.ZodString;
-        /** Cheermote entries for the cheer words in `message` (`kind: "cheermote"`). */
         emotes: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        /** The cheermote for the total, when the channel's cheermotes loaded. */
         cheermote: z.ZodOptional<z.ZodUnknown>;
         avatarUrl: z.ZodOptional<z.ZodString>;
         broadcaster_user_id: z.ZodString;
@@ -607,7 +593,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
     }, z.core.$loose>;
     readonly "twitch:raid": z.ZodObject<{
         displayName: z.ZodOptional<z.ZodString>;
-        /** The raider's channel info from Helix, when it loaded. */
         title: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodString>;
         avatarUrl: z.ZodOptional<z.ZodString>;
@@ -967,9 +952,7 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         requester_user_id: z.ZodString;
         requester_user_login: z.ZodString;
         requester_user_name: z.ZodString;
-        /** Seconds; Twitch's own sample payload sends it as a string. */
         duration_seconds: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
-        /** Twitch's own sample payload sends it as a string. */
         is_automatic: z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>;
         started_at: z.ZodString;
         broadcaster_user_id: z.ZodString;
@@ -1008,7 +991,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         id: z.ZodString;
         type: z.ZodString;
         started_at: z.ZodString;
-        /** Channel info from Helix, when it loaded. */
         title: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodString>;
         broadcaster_user_id: z.ZodString;
@@ -1016,7 +998,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         broadcaster_user_name: z.ZodString;
     }, z.core.$loose>;
     readonly "twitch:stream_offline": z.ZodObject<{
-        /** Set when the stream's start is known. */
         started_at: z.ZodOptional<z.ZodString>;
         duration_seconds: z.ZodOptional<z.ZodNumber>;
         broadcaster_user_id: z.ZodString;
@@ -1030,7 +1011,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         category_name: z.ZodString;
         content_classification_labels: z.ZodArray<z.ZodString>;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        /** Diff against the previous channel info, when it was known. */
         title_changed: z.ZodOptional<z.ZodBoolean>;
         category_changed: z.ZodOptional<z.ZodBoolean>;
         language_changed: z.ZodOptional<z.ZodBoolean>;
@@ -1236,13 +1216,11 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
             is_anonymous: z.ZodOptional<z.ZodBoolean>;
             identity: z.ZodOptional<z.ZodUnknown>;
         }, z.core.$loose>>;
-        /** Usernames of `giftees`. */
         giftRecipients: z.ZodArray<z.ZodString>;
         giftCount: z.ZodNumber;
         total: z.ZodNumber;
         isGift: z.ZodBoolean;
         is_gift: z.ZodBoolean;
-        /** The first giftee. */
         recipient_user_id: z.ZodOptional<z.ZodString>;
         recipient_user_login: z.ZodOptional<z.ZodString>;
         recipient_user_name: z.ZodOptional<z.ZodString>;
@@ -1422,7 +1400,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         has_mature_content: z.ZodBoolean;
         category_id: z.ZodString;
         category_name: z.ZodString;
-        /** Diff against the previous stream info, when it was known. */
         title_changed: z.ZodOptional<z.ZodBoolean>;
         category_changed: z.ZodOptional<z.ZodBoolean>;
         language_changed: z.ZodOptional<z.ZodBoolean>;
@@ -1456,7 +1433,6 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
             name: z.ZodNullable<z.ZodString>;
             uri: z.ZodString;
         }, z.core.$loose>>;
-        /** The Lumio user whose action caused the change; `null` when it came from Spotify. */
         triggered_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$loose>;
     readonly "spotify:play": z.ZodObject<{
@@ -1552,6 +1528,51 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
             avatar: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
     }, z.core.$loose>;
+    readonly "shopify:order": z.ZodObject<{
+        shop: z.ZodOptional<z.ZodObject<{
+            domain: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$loose>>;
+        order_number: z.ZodNullable<z.ZodNumber>;
+        name: z.ZodNullable<z.ZodString>;
+        financial_status: z.ZodNullable<z.ZodString>;
+        total_price: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        line_items: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            title: z.ZodNullable<z.ZodString>;
+            quantity: z.ZodNullable<z.ZodNumber>;
+            price: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>>>;
+        customer_display: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly "shopify:order_paid": z.ZodObject<{
+        shop: z.ZodOptional<z.ZodObject<{
+            domain: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$loose>>;
+        order_number: z.ZodNullable<z.ZodNumber>;
+        name: z.ZodNullable<z.ZodString>;
+        financial_status: z.ZodNullable<z.ZodString>;
+        total_price: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        line_items: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            title: z.ZodNullable<z.ZodString>;
+            quantity: z.ZodNullable<z.ZodNumber>;
+            price: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>>>;
+        customer_display: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly "shopify:product": z.ZodObject<{
+        shop: z.ZodOptional<z.ZodObject<{
+            domain: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$loose>>;
+        title: z.ZodNullable<z.ZodString>;
+        vendor: z.ZodNullable<z.ZodString>;
+        product_type: z.ZodNullable<z.ZodString>;
+        handle: z.ZodNullable<z.ZodString>;
+        image_url: z.ZodNullable<z.ZodString>;
+    }, z.core.$loose>;
     readonly "twitch:chat": z.ZodObject<{
         account_id: z.ZodString;
         platform: z.ZodString;
@@ -1561,11 +1582,8 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         display_name: z.ZodNullable<z.ZodString>;
         avatar_url: z.ZodNullable<z.ZodString>;
         message: z.ZodString;
-        /** Platform-specific emote entries. */
         emotes: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
-        /** Twitch GIF fragments `{ id, url, provider, alt }`; absent without a GIF. */
         gifs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        /** Platform-specific badge entries. */
         badges: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
         color: z.ZodNullable<z.ZodString>;
         is_mod: z.ZodBoolean;
@@ -1595,11 +1613,8 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         display_name: z.ZodNullable<z.ZodString>;
         avatar_url: z.ZodNullable<z.ZodString>;
         message: z.ZodString;
-        /** Platform-specific emote entries. */
         emotes: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
-        /** Twitch GIF fragments `{ id, url, provider, alt }`; absent without a GIF. */
         gifs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        /** Platform-specific badge entries. */
         badges: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
         color: z.ZodNullable<z.ZodString>;
         is_mod: z.ZodBoolean;
@@ -1629,11 +1644,8 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         display_name: z.ZodNullable<z.ZodString>;
         avatar_url: z.ZodNullable<z.ZodString>;
         message: z.ZodString;
-        /** Platform-specific emote entries. */
         emotes: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
-        /** Twitch GIF fragments `{ id, url, provider, alt }`; absent without a GIF. */
         gifs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        /** Platform-specific badge entries. */
         badges: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
         color: z.ZodNullable<z.ZodString>;
         is_mod: z.ZodBoolean;
@@ -1663,11 +1675,8 @@ declare const LUMIO_EVENT_PAYLOAD_SCHEMAS: {
         display_name: z.ZodNullable<z.ZodString>;
         avatar_url: z.ZodNullable<z.ZodString>;
         message: z.ZodString;
-        /** Platform-specific emote entries. */
         emotes: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
-        /** Twitch GIF fragments `{ id, url, provider, alt }`; absent without a GIF. */
         gifs: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
-        /** Platform-specific badge entries. */
         badges: z.ZodNullable<z.ZodArray<z.ZodUnknown>>;
         color: z.ZodNullable<z.ZodString>;
         is_mod: z.ZodBoolean;
@@ -1912,4 +1921,5 @@ declare const REALTIME_LIMITS: {
     readonly MAX_BYTES_PER_MINUTE: number;
 };
 
-export { ACTION_EXECUTE_ERRORS, ACTION_TYPES, type ActionExecuteErrorCode, type ActionExecuteParams, type ActionExecuteResult, type ActionMessage, type ChatMessagePayload, type ConfigUpdateMessage, type ErrorMessage, type EventCallbackParams, type EventMessage, type EventPlatformParams, type ExtensionConfig, HOST_METHODS, type InitMessage, type JsonRpcMessage, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, LUMIO_COMPONENT_TYPES, LUMIO_EVENT_PAYLOAD_SCHEMAS, LUMIO_EVENT_TYPES, type LifecycleDestroyParams, type LifecycleInitParams, type LumioActionType, type LumioComponentNode, type LumioComponentType, type LumioEventPayload, type LumioEventPayloadMap, type LumioEventType, type LumioMessage, MESSAGE_TYPES, type MessageType, type ModerationLogPayload, type NodeConfigRequestMessage, type NodeConfigUpdateMessage, REALTIME_LIMITS, type ReadyMessage, SERVER_FUNCTION_ERRORS, STORAGE_SCOPES, type ServerFunctionErrorCode, type ServerMutationParams, type ServerQueryParams, type ServerRealtimeParams, type Sound, type SoundGetListParams, type SoundPlayEvent, type SoundPlayParams, type SoundStopEvent, type SoundStopParams, type StorageGetParams, type StorageScope, type StorageSetParams, type StorageUpdateMessage, type StorageUpdateParams, type Theme, type ThemeBorderRadius, type ThemeChangeMessage, type ThemeChangeParams, type ThemeColors, type ThemeFonts, type UiKeyframesParams, type UiReadyParams, type UiRenderParams, WORKER_METHODS, actionMessageSchema, chatMessagePayloadSchema, configUpdateMessageSchema, errorMessageSchema, eventMessageSchema, extensionConfigSchema, initMessageSchema, lumioActionTypeSchema, lumioEventPayloadSchema, lumioEventTypeSchema, lumioMessageSchema, nodeConfigRequestMessageSchema, nodeConfigUpdateMessageSchema, parseLumioEventPayload, readyMessageSchema, storageScopeSchema, storageUpdateMessageSchema, themeBorderRadiusSchema, themeChangeMessageSchema, themeColorsSchema, themeFontsSchema, themeSchema };
+export { ACTION_EXECUTE_ERRORS, ACTION_TYPES, HOST_METHODS, LUMIO_COMPONENT_TYPES, LUMIO_EVENT_PAYLOAD_SCHEMAS, LUMIO_EVENT_TYPES, MESSAGE_TYPES, REALTIME_LIMITS, SERVER_FUNCTION_ERRORS, STORAGE_SCOPES, WORKER_METHODS, actionMessageSchema, chatMessagePayloadSchema, configUpdateMessageSchema, errorMessageSchema, eventMessageSchema, extensionConfigSchema, initMessageSchema, lumioActionTypeSchema, lumioEventPayloadSchema, lumioEventTypeSchema, lumioMessageSchema, nodeConfigRequestMessageSchema, nodeConfigUpdateMessageSchema, parseLumioEventPayload, readyMessageSchema, storageScopeSchema, storageUpdateMessageSchema, themeBorderRadiusSchema, themeChangeMessageSchema, themeColorsSchema, themeFontsSchema, themeSchema };
+export type { ActionExecuteErrorCode, ActionExecuteParams, ActionExecuteResult, ActionMessage, ChatMessagePayload, ConfigUpdateMessage, ErrorMessage, EventCallbackParams, EventMessage, EventPlatformParams, ExtensionConfig, InitMessage, JsonRpcMessage, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, LifecycleDestroyParams, LifecycleInitParams, LumioActionType, LumioComponentNode, LumioComponentType, LumioEventPayload, LumioEventPayloadMap, LumioEventType, LumioMessage, MessageType, ModerationLogPayload, NodeConfigRequestMessage, NodeConfigUpdateMessage, ReadyMessage, ServerFunctionErrorCode, ServerMutationParams, ServerQueryParams, ServerRealtimeParams, Sound, SoundGetListParams, SoundPlayEvent, SoundPlayParams, SoundStopEvent, SoundStopParams, StorageGetParams, StorageScope, StorageSetParams, StorageUpdateMessage, StorageUpdateParams, Theme, ThemeBorderRadius, ThemeChangeMessage, ThemeChangeParams, ThemeColors, ThemeFonts, UiKeyframesParams, UiReadyParams, UiRenderParams };

package/dist/index.js

@@ -186,6 +186,11 @@ var LUMIO_EVENT_TYPES = [
   "spotify:playlist_delete",
   // StreamElements
   "streamelements:tip",
+  // Shopify — order and product webhooks of the account's connected stores.
+  // Every payload names its store in `shop` (ZAF-3288).
+  "shopify:order",
+  "shopify:order_paid",
+  "shopify:product",
   // Chat (per-platform)
   "twitch:chat",
   "youtube:chat",
@@ -462,6 +467,33 @@ var youtubeAuthor = {
   displayName: str,
   avatarUrl: str
 };
+var shopifyShop = {
+  shop: z3.looseObject({ domain: str, label: str }).optional()
+};
+var shopifyOrder = z3.looseObject({
+  order_number: num.nullable(),
+  /** Shopify's order name, e.g. `#1042`. */
+  name: nullableStr,
+  financial_status: nullableStr,
+  /** Only when the store shows prices. */
+  total_price: nullableStr.optional(),
+  currency: nullableStr.optional(),
+  /** Only when the store shows items; `price` per line only when it also shows prices. */
+  line_items: z3.array(
+    z3.looseObject({
+      title: nullableStr,
+      quantity: num.nullable(),
+      price: nullableStr.optional()
+    })
+  ).nullable().optional(),
+  /**
+   * The buyer label the buyer consented to, in the form the store chose.
+   * Absent without consent or when a blocklist hid it. Untrusted buyer text:
+   * render it as text, never as HTML.
+   */
+  customer_display: str.optional(),
+  ...shopifyShop
+});
 var LUMIO_EVENT_PAYLOAD_SCHEMAS = {
   // Twitch
   "twitch:follower": z3.looseObject({
@@ -860,6 +892,18 @@ var LUMIO_EVENT_PAYLOAD_SCHEMAS = {
       avatar: str.optional()
     })
   }),
+  // Shopify
+  "shopify:order": shopifyOrder,
+  "shopify:order_paid": shopifyOrder,
+  "shopify:product": z3.looseObject({
+    title: nullableStr,
+    vendor: nullableStr,
+    product_type: nullableStr,
+    handle: nullableStr,
+    /** The product's first image. */
+    image_url: nullableStr,
+    ...shopifyShop
+  }),
   // Chat
   "twitch:chat": chatMessagePayloadSchema,
   "youtube:chat": chatMessagePayloadSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaflun/lumio-protocol",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Wire-format types for Lumio extension iframe-to-host communication",
   "type": "module",
   "main": "dist/index.js",
@@ -23,11 +23,11 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "zod": "^4.3.6"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "typescript": "^6.0.2",
-    "tsup": "^8.4.0"
+    "tsup": "^9.0.0"
   },
   "author": {
     "name": "zaflun",