@widy/sdk 1.0.13 → 1.0.15

package/README.md

@@ -13,6 +13,7 @@ npm install @widy/sdk
 ## Package Exports
 
 - `WidgetOutboundBridge` - the main bridge class for widget outbound communication
+- `rsBuildHotReloadPlugin` - a development plugin for automatic widget reloads during rsbuild watch builds
 - `enums` - shared enum values used across the SDK
 - `types` - rich TypeScript interfaces for messages, events, alerts, donations, subscriptions, goals, settings, and more
 
@@ -40,6 +41,31 @@ bridge.destroy();
 
 > `WidgetOutboundBridge` is intended for use inside a browser widget iframe. It communicates with `window.parent` using `postMessage` and listens for replies via `message` events.
 
+## Development Hot Reload
+
+This package also exports `rsBuildHotReloadPlugin`, a helper plugin for `rsbuild` watch mode. It injects a small client-side script into the configured entry file and sends a reload signal over WebSocket after every build.
+
+```ts
+import { rsBuildHotReloadPlugin } from "@widy/sdk";
+
+export default {
+  plugins: [
+    rsBuildHotReloadPlugin({
+      port: 4777,
+      delay: 400,
+      entryFilePath: "src/index.ts",
+    }),
+  ],
+};
+```
+
+Options:
+- `port?: number` — WebSocket port to listen on (default: `4777`)
+- `delay?: number` — milliseconds to wait before reloading the browser after a rebuild (default: `400`)
+- `entryFilePath: string` — path to the entry file that should receive the hot reload snippet
+
+When `rsbuild` runs with `--watch`, the plugin starts a WebSocket server and reloads the widget in the browser automatically after rebuilds.
+
 ## `WidgetOutboundBridge` API
 
 ### `new WidgetOutboundBridge()`

package/dist/rsBuildHotReloadPlugin.js

@@ -1,12 +1,12 @@
 import { WebSocketServer } from "ws";
 export function rsBuildHotReloadPlugin({ port = 4777, delay = 400, entryFilePath, }) {
     const isWatch = process.argv.includes("--watch");
-    const ws = new WebSocketServer({ port });
     return {
         name: "hot-reload-widget",
         setup(api) {
             if (!isWatch)
                 return;
+            const ws = new WebSocketServer({ port });
             api.transform({}, ({ code, resourcePath }) => {
                 if (resourcePath === entryFilePath) {
                     const hotReloadSnippet = `

package/dist/types.d.ts

@@ -120,6 +120,7 @@ export interface ISettings {
     currency: Currency;
     tts_type: TtsType;
     tts_settings?: IEdgeTtsSettings;
+    widget_token: string;
 }
 export interface IAuctionSettings {
     id: number;
@@ -374,7 +375,7 @@ export type WidgetScopes = WidgetQuery | WidgetSubscription | WidgetMutation;
 export interface IWidgetRequest<T = unknown> {
     id: string;
     scope: WidgetScopes;
-    payload?: T;
+    arg?: T;
 }
 export interface IWidgetResponse<T = unknown> {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@widy/sdk",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "A TypeScript SDK for Widy widget integrations.",
   "license": "ISC",
   "author": "ik1s3v",