unreal-toolkit 0.1.11 → 0.1.12

package/README.md

@@ -16,3 +16,14 @@ npm install unreal-toolkit
 ```javascript
 import UnrealToolkit from 'unreal-toolkit';
 ```
+
+* Unreal Toolkit Message Bus Usage
+```typescript
+// Post window message
+UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
+
+// Handle window message
+UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+   console.log("My Event Args: ", args);
+});
+```

package/dist/index.d.ts

@@ -8,13 +8,13 @@ export declare class UnrealToolkit {
     /** Unreal Toolkit event message bus
      * @example
      * ```typescript
-     * // Handle myevent message
-     * UnrealToolkit.EventBus.OnMessage("myevent", (data:string) => {
-     *    console.log("My Event Data: " + data);
-     * });
+     * // Post myevent window message
+     * UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
      *
-     * // Post myevent message
-     * UnrealToolkit.EventBus.PostMessage("myevent", "Hello World!");
+     * // Handle myevent window message
+     * UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+     *    console.log("My Event Args: ", args);
+     * });
      * ```
     */
     static get EventBus(): UnrealMessageBus;
@@ -24,28 +24,27 @@ export declare class UnrealToolkit {
  * @class UnrealMessageBus - All rights reserved (c) 2024 Mackey Kinard
  */
 export declare class UnrealMessageBus {
-    RequiredOrigin: string;
+    static AllowedOrigin: string;
+    static TargetOrigin: string;
     constructor();
-    /** Handle event bus message
-     * @param message The message to handle
-     * @param data The data to handle
+    /** Post event bus message
+     * @param name The message to post
+     * @param args The args to post
      * @returns void
      */
-    OnMessage(message: string, handler: (data: string) => void): void;
-    /** Post event bus message
-     * @param message The message to post
-     * @param data The data to post
-     * @param target The target to post
-     * @param transfer The transfer to post
+    PostWindowMessage(name: string, args?: string[]): void;
+    /** Handle event bus message
+     * @param name The name to handle
+     * @param args The args to handle
      * @returns void
      */
-    PostMessage(message: string, data?: string, targetOrigin?: string): void;
+    OnWindowMessage(name: string, handler: (args: string[]) => void): void;
     /** Remove event bus message handler
      * @param message The message to remove
      * @param handler The handler to remove
      * @returns void
      */
-    RemoveHandler(message: string, handler: (data: string) => void): void;
+    RemoveHandler(message: string, handler: (args: string[]) => void): void;
     /** Clear and reset all event bus message handlers
      * @returns void
      */
@@ -60,8 +59,8 @@ export declare class UnrealMessageBus {
      */
     private HandleWindowMessage;
     /** Dispatch internal event bus message
-     * @param message The message to dispatch
-     * @param data The data to dispatch
+     * @param name The name to dispatch
+     * @param args The args to dispatch
      * @returns void
      */
     private OnDispatchMessage;

package/dist/unreal.toolkit.d.ts

@@ -8,13 +8,13 @@ export declare class UnrealToolkit {
     /** Unreal Toolkit event message bus
      * @example
      * ```typescript
-     * // Handle myevent message
-     * UnrealToolkit.EventBus.OnMessage("myevent", (data:string) => {
-     *    console.log("My Event Data: " + data);
-     * });
+     * // Post myevent window message
+     * UnrealToolkit.EventBus.PostWindowMessage("myevent", ["Hello World!"]);
      *
-     * // Post myevent message
-     * UnrealToolkit.EventBus.PostMessage("myevent", "Hello World!");
+     * // Handle myevent window message
+     * UnrealToolkit.EventBus.OnWindowMessage("myevent", (args:string[]) => {
+     *    console.log("My Event Args: ", args);
+     * });
      * ```
     */
     static get EventBus(): UnrealMessageBus;
@@ -24,28 +24,27 @@ export declare class UnrealToolkit {
  * @class UnrealMessageBus - All rights reserved (c) 2024 Mackey Kinard
  */
 export declare class UnrealMessageBus {
-    RequiredOrigin: string;
+    static AllowedOrigin: string;
+    static TargetOrigin: string;
     constructor();
-    /** Handle event bus message
-     * @param message The message to handle
-     * @param data The data to handle
+    /** Post event bus message
+     * @param name The message to post
+     * @param args The args to post
      * @returns void
      */
-    OnMessage(message: string, handler: (data: string) => void): void;
-    /** Post event bus message
-     * @param message The message to post
-     * @param data The data to post
-     * @param target The target to post
-     * @param transfer The transfer to post
+    PostWindowMessage(name: string, args?: string[]): void;
+    /** Handle event bus message
+     * @param name The name to handle
+     * @param args The args to handle
      * @returns void
      */
-    PostMessage(message: string, data?: string, targetOrigin?: string): void;
+    OnWindowMessage(name: string, handler: (args: string[]) => void): void;
     /** Remove event bus message handler
      * @param message The message to remove
      * @param handler The handler to remove
      * @returns void
      */
-    RemoveHandler(message: string, handler: (data: string) => void): void;
+    RemoveHandler(message: string, handler: (args: string[]) => void): void;
     /** Clear and reset all event bus message handlers
      * @returns void
      */
@@ -60,8 +59,8 @@ export declare class UnrealMessageBus {
      */
     private HandleWindowMessage;
     /** Dispatch internal event bus message
-     * @param message The message to dispatch
-     * @param data The data to dispatch
+     * @param name The name to dispatch
+     * @param args The args to dispatch
      * @returns void
      */
     private OnDispatchMessage;

package/dist/unreal.toolkit.js

@@ -1 +1 @@
-!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports.UnrealToolkit=n():e.UnrealToolkit=n()}(this,(()=>(()=>{"use strict";var e={d:(n,t)=>{for(var i in t)e.o(t,i)&&!e.o(n,i)&&Object.defineProperty(n,i,{enumerable:!0,get:t[i]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{default:()=>o});var t=function(){function e(){}return Object.defineProperty(e,"EventBus",{get:function(){return null==e._EventBus&&(e._EventBus=new i),e._EventBus},enumerable:!1,configurable:!0}),e._EventBus=null,e}(),i=function(){function e(){this.RequiredOrigin="*",this.ListenerDictionary={},window&&window.top?(this.HandleWindowMessage=this.HandleWindowMessage.bind(this),window.top.addEventListener("message",this.HandleWindowMessage)):console.warn("UnrealMessageBus: No Top Window Available")}return e.prototype.OnMessage=function(e,n){var t;null==this.ListenerDictionary[e]?(t=[],this.ListenerDictionary[e]=t):t=this.ListenerDictionary[e],t.findIndex((function(e){return n==e}))<0&&t.push(n)},e.prototype.PostMessage=function(e,n,t){void 0===t&&(t="*"),window&&window.top?window.top.postMessage({source:"unrealmessagebus",message:e,data:n},t):console.warn("UnrealMessageBus: No Top Window Available")},e.prototype.RemoveHandler=function(e,n){var t=this.ListenerDictionary[e];if(null!=t){var i=t.findIndex((function(e){return n==e}));i>=0&&t.splice(i,1)}},e.prototype.ResetHandlers=function(){this.ListenerDictionary={}},e.prototype.Dispose=function(){this.ResetHandlers(),window&&window.top&&window.top.removeEventListener("message",this.HandleWindowMessage)},e.prototype.HandleWindowMessage=function(e){null!=e&&null!=e.data&&(!0==(null!=this.RequiredOrigin&&""!==this.RequiredOrigin&&"*"!==this.RequiredOrigin)&&e.origin!==this.RequiredOrigin||null!=e.data.message&&null!=e.data.source&&"unrealmessagebus"==e.data.source&&this.OnDispatchMessage(e.data.message,null!=e.data.data?e.data.data:null))},e.prototype.OnDispatchMessage=function(e,n){void 0===n&&(n=null);var t=this.ListenerDictionary[e];null!=t&&t.forEach((function(e){try{e&&e(n)}catch(e){console.warn(e)}}))},e}();console.log("Unreal Toolkit Runtime - Version 0.1.8");const o=t;return n.default})()));
+!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports.UnrealToolkit=n():e.UnrealToolkit=n()}(this,(()=>(()=>{"use strict";var e={d:(n,t)=>{for(var i in t)e.o(t,i)&&!e.o(n,i)&&Object.defineProperty(n,i,{enumerable:!0,get:t[i]})},o:(e,n)=>Object.prototype.hasOwnProperty.call(e,n)},n={};e.d(n,{default:()=>o});var t=function(){function e(){}return Object.defineProperty(e,"EventBus",{get:function(){return null==e._EventBus&&(e._EventBus=new i),e._EventBus},enumerable:!1,configurable:!0}),e._EventBus=null,e}(),i=function(){function e(){this.ListenerDictionary={},this.HandleWindowMessage=this.HandleWindowMessage.bind(this),window.top.addEventListener("message",this.HandleWindowMessage)}return e.prototype.PostWindowMessage=function(n,t){try{window.top.postMessage({source:"unrealtoolkit",message:n,args:t},e.TargetOrigin)}catch(e){console.warn(e)}},e.prototype.OnWindowMessage=function(e,n){var t;null==this.ListenerDictionary[e]?(t=[],this.ListenerDictionary[e]=t):t=this.ListenerDictionary[e],t.findIndex((function(e){return n==e}))<0&&t.push(n)},e.prototype.RemoveHandler=function(e,n){var t=this.ListenerDictionary[e];if(null!=t){var i=t.findIndex((function(e){return n==e}));i>=0&&t.splice(i,1)}},e.prototype.ResetHandlers=function(){this.ListenerDictionary={}},e.prototype.Dispose=function(){this.ResetHandlers(),window.top.removeEventListener("message",this.HandleWindowMessage)},e.prototype.HandleWindowMessage=function(n){if(null!=n&&null!=n.origin&&null!=n.data&&null!=n.data.source&&null!=n.data.message)try{if(null!=e.AllowedOrigin&&""!==e.AllowedOrigin&&"*"!==e.AllowedOrigin&&n.origin!==e.AllowedOrigin)return void console.warn("UnrealMessageBus: Invalid Origin: "+n.origin);this.OnDispatchMessage(n.data.message,null!=n.data.args?n.data.args:null)}catch(e){console.warn(e)}},e.prototype.OnDispatchMessage=function(e,n){void 0===n&&(n=null);var t=this.ListenerDictionary[e];null!=t&&t.forEach((function(e){try{e&&e(n)}catch(e){console.warn(e)}}))},e.AllowedOrigin="*",e.TargetOrigin="*",e}();console.log("Unreal Toolkit Runtime - Version 0.1.8");const o=t;return n.default})()));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "unreal-toolkit",
-    "version": "0.1.11",
+    "version": "0.1.12",
     "description": "Unreal Toolkit Runtime Library (UMD)",
     "main": "dist/unreal.toolkit.js",
     "types": "dist/index.d.ts",