@zaflun/lumio-protocol 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+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.2.4
+
+Wire-format types for the Lumio Extension Platform — the contract for
+communication between extension iframes/workers and the Lumio host. Ships as an
+ESM build with generated `.d.ts` declarations; `zod` is a runtime dependency for
+the validated schemas.
+
+### Exports
+
+- **Events** (`src/events.ts`)
+  - `LUMIO_EVENT_TYPES` — 54 platform event types across Twitch, YouTube, Kick,
+    Trovo, Spotify, StreamElements, and per-platform + cross-platform chat, with
+    `LumioEventType` and the `lumioEventTypeSchema` Zod enum.
+  - `ACTION_TYPES` — 21 action types (Chat, OBS, Spotify, Events, Overlay), with
+    `LumioActionType` and `lumioActionTypeSchema`.
+  - Sound-system event payloads `SoundPlayEvent` / `SoundStopEvent`.
+  - `STORAGE_SCOPES` (`instance`, `overlay`, `account`, `global`) with
+    `StorageScope` and `storageScopeSchema`.
+- **Messages** (`src/messages.ts`)
+  - Theme schemas (`themeSchema`, colors/fonts/border-radius) and
+    `extensionConfigSchema`.
+  - `MESSAGE_TYPES` — 10 host↔iframe message types, individual per-type Zod
+    schemas, and the `lumioMessageSchema` discriminated union with `LumioMessage`.
+- **Components** (`src/components.ts`)
+  - `LUMIO_COMPONENT_TYPES` — 30 serialized-UI component types with
+    `LumioComponentType` and the `LumioComponentNode` tree interface.
+  - JSON-RPC 2.0 wire types (`JsonRpcRequest` / `JsonRpcResponse` /
+    `JsonRpcNotification`), worker↔host param interfaces, the `Sound` data type,
+    and the `WORKER_METHODS` / `HOST_METHODS` method-name constants (including
+    `sound.play` / `sound.stop` / `sound.list`).
+
+### Notes
+
+- Adds the sound-system surface (`SoundPlayEvent` / `SoundStopEvent`, `Sound`,
+  and the `SOUND_PLAY` / `SOUND_STOP` / `SOUND_LIST` worker methods) that mirrors
+  the host sound-management contract.
+- First release published with a changelog. Prior public releases: `0.2.3`,
+  `0.1.1`, `0.1.0`.

package/README.md

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

package/dist/index.d.ts

@@ -464,6 +464,7 @@ interface Sound {
     file_size: number;
     duration_ms: number | null;
     created_at: string;
+    source_extension_name: string | null;
 }
 interface LifecycleInitParams {
     extensionId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaflun/lumio-protocol",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Wire-format types for Lumio extension iframe-to-host communication",
   "type": "module",
   "main": "dist/index.js",
@@ -15,7 +15,8 @@
     "access": "public"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "zod": "^4.3.6"