@virid/main 0.3.1 → 0.3.3

package/README.md

@@ -15,11 +15,10 @@ Conversely, messages sent from a rendering process to the main process are abstr
 ## 🔌Enable plugins
 
 ```ts
-import { createVirid } from '@virid/core'
-import { MainPlugin } from '@virid/main'
-import { app } from 'electron'
-const virid = createVirid()
-  .use(MainPlugin, { electronApp: app })
+import { createVirid } from "@virid/core";
+import { MainPlugin } from "@virid/main";
+import { app } from "electron";
+const virid = createVirid().use(MainPlugin, { electronApp: app });
 ```
 
 ## 🛠️ @virid/main Core API Overview
@@ -29,27 +28,27 @@ const virid = createVirid()
 - **Function**: A specialized message base class designed for inheritance. All messages inheriting from `ToRendererMessage` will be dispatched to the rendering process.
 - **Logic**: This message type requires two specific metadata tags:
   - `__virid_target`: Specifies the destination (e.g., a specific `windowId`).
-  - `__virid_messageType`: Defines the message type it should be restored to upon reaching the rendering process.
+  - `__virid_message_type`: Defines the message type it should be restored to upon reaching the rendering process.
 
 - Example:
 
 **In the Main Process:**
 
 ```ts
-import { ToRendererMessage } from '@virid/main'
+import { ToRendererMessage } from "@virid/main";
 
 /**
- * - __virid_target = 'renderer': Indicates the message is bound for the rendering process 
+ * - __virid_target = 'renderer': Indicates the message is bound for the rendering process
  * with the windowId 'renderer'.
- * - __virid_messageType = 'file-dialog': Describes the type this message will transform 
+ * - __virid_message_type = 'file-dialog': Describes the type this message will transform
  * into once it arrives in the rendering process.
  */
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
-  
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
+
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 ```
@@ -59,17 +58,17 @@ In the **Rendering Process**, you can use the `@FromIpc` decorator in conjunctio
 **In the Rendering Process:**
 
 ```ts
-import { FromIpc, FromMainMessage } from '@virid/renderer'
+import { FromIpc, FromMainMessage } from "@virid/renderer";
 
 /**
- * @FromIpc('file-dialog') indicates that when the Main Process sends a ToRendererMessage 
- * where __virid_messageType is 'file-dialog', this message will be automatically 
+ * @FromIpc('file-dialog') indicates that when the Main Process sends a ToRendererMessage
+ * where __virid_message_type is 'file-dialog', this message will be automatically
  * delivered to the Virid dispatcher to trigger the corresponding rendering process System.
  */
-@FromIpc('file-dialog')
+@FromIpc("file-dialog")
 class ChooseBgImageMessage extends FromMainMessage {
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 ```
@@ -77,38 +76,44 @@ class ChooseBgImageMessage extends FromMainMessage {
 ### FromRenderMessage / @FromRenderer()
 
 - **Function**: A specialized message base class designed for inheritance. All messages inheriting from `FromRenderMessage` will be automatically converted and dispatched to the **Virid Dispatcher** in the Main Process when sent from a Rendering Process.
-- **Logic**: The `@FromRenderer()` decorator accepts a string-based ID. This ID must match the `__virid_messageType` of the `ToMainMessage` dispatched from the Rendering Process.
+- **Logic**: The `@FromRenderer()` decorator accepts a string-based ID. This ID must match the `__virid_message_type` of the `ToMainMessage` dispatched from the Rendering Process.
 
 #### Example:
 
 **In the Main Process:**
 
 ```ts
-import { FromRenderer, FromRenderMessage, ToRendererMessage } from '@virid/main'
+import {
+  FromRenderer,
+  FromRenderMessage,
+  ToRendererMessage,
+} from "@virid/main";
 
 // Message to be sent to the Rendering Process
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
 /**
- * Converts incoming messages from the Rendering Process with 
- * __virid_messageType: 'open-dialog' into the Main Process's OpenDialogMessage.
+ * Converts incoming messages from the Rendering Process with
+ * __virid_message_type: 'open-dialog' into the Main Process's OpenDialogMessage.
  */
-@FromRenderer('open-dialog')
+@FromRenderer("open-dialog")
 export class OpenDialogMessage extends FromRenderMessage {
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 
@@ -116,14 +121,17 @@ export class WindowSystem {
   @System()
   async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
     // Invoke native Electron dialog
-    const result = await dialog.showOpenDialog(message.senderWindow, message.options)
-    
+    const result = await dialog.showOpenDialog(
+      message.senderWindow,
+      message.options,
+    );
+
     // If the user did not cancel and selected a file
     if (!result.canceled && result.filePaths.length > 0) {
-      const selectedPath = result.filePaths[0]
-      return new RenderDialogMessage(selectedPath)
+      const selectedPath = result.filePaths[0];
+      return new RenderDialogMessage(selectedPath);
     }
-    return
+    return;
   }
 }
 ```
@@ -133,28 +141,30 @@ In the **Rendering Process**, you can use `@FromIpc` in conjunction with `ToMain
 **In the Rendering Process:**
 
 ```ts
-import { ToMainMessage, FromIpc, FromMainMessage } from '@virid/renderer'
+import { ToMainMessage, FromIpc, FromMainMessage } from "@virid/renderer";
 
 // Handles the incoming file selection result
-@FromIpc('file-dialog')
+@FromIpc("file-dialog")
 class ChooseBgImageMessage extends FromMainMessage {
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
 // Initiates the request to open a dialog
 class OpenDialogMessage extends ToMainMessage {
-  __virid_target: string = 'main'
-  __virid_messageType: string = 'open-dialog'
+  __virid_target: string = "main";
+  __virid_message_type: string = "open-dialog";
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
-```
+```

package/README.zh.md

@@ -1,4 +1,4 @@
-#  @virid/main
+# @virid/main
 
 `@virid/main` 是electron应用的主适配器，提供`ToRendererMessage`和`FromRendererMessage`的自动路由功能与接受渲染进程报道功能。
 
@@ -8,16 +8,15 @@
 
 - **路由自动注册**：渲染进程窗口开启后，自动向主进程注册自身，以后所有的消息都将携带自身的窗口信息。
 - **类型恢复**：消息在通过IPC通道后，恢复成真正的Message类重新进入`@virid/core`并被调度器识别并分发。实现不同进程的位置无关性。
-- **消息定向与广播**：可以通过其他渲染进程的ID来实现定向通信，或者使用“*”来广播消息。
+- **消息定向与广播**：可以通过其他渲染进程的ID来实现定向通信，或者使用“\*”来广播消息。
 
 ## 🔌启用插件
 
 ```ts
-import { createVirid } from '@virid/core'
-import { MainPlugin } from '@virid/main'
-import { app } from 'electron'
-const virid = createVirid()
-  .use(MainPlugin, { electronApp: app })
+import { createVirid } from "@virid/core";
+import { MainPlugin } from "@virid/main";
+import { app } from "electron";
+const virid = createVirid().use(MainPlugin, { electronApp: app });
 ```
 
 ## 🛠️ @virid/main 核心 API 概览
@@ -25,19 +24,19 @@ const virid = createVirid()
 ### `ToRendererMessage`
 
 - **功能**：一个特殊的消息基类，可被继承。所有继承自`ToRendererMessage`的Message将被发往渲染进程
-- **逻辑**：该消息类型需要两个特殊标记，`__virid_target`标记了目的地，`__virid_messageType`标记了在目的地应该被还原为的Message类型
+- **逻辑**：该消息类型需要两个特殊标记，`__virid_target`标记了目的地，`__virid_message_type`标记了在目的地应该被还原为的Message类型
 - **示例**：
 
 ```ts
 //在主进程
-import { ToRendererMessage } from '@virid/main'
+import { ToRendererMessage } from "@virid/main";
 // __virid_target=‘renderer’,说明消息需要发往windowId为renderer的渲染进程
-//  __virid_messageType: string = 'file-dialog'，描述了在渲染进程，该消息将会重新变为的类型
+//  __virid_message_type: string = 'file-dialog'，描述了在渲染进程，该消息将会重新变为的类型
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 ```
@@ -46,15 +45,15 @@ export class RenderDialogMessage extends ToRendererMessage {
 
 ```ts
 //在渲染进程
-import { FromIpc, FromMainMessage } from '@virid/main'
+import { FromIpc, FromMainMessage } from "@virid/main";
 //@FromIpc('file-dialog')表明当主进程发送一个ToRenderMessage，而且
 //  __virid_target: string = 'renderer'
-//  __virid_messageType: string = 'file-dialog'
+//  __virid_message_type: string = 'file-dialog'
 // 时，这个消息将被自动投递到virid调度中心触发相应的渲染进程System
-@FromIpc('file-dialog')
+@FromIpc("file-dialog")
 class ChooseBgImageMessage extends FromMainMessage {
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 ```
@@ -67,26 +66,28 @@ class ChooseBgImageMessage extends FromMainMessage {
 
 ```ts
 //在主进程
-import { FromRenderer, FromRenderMessage } from '@virid/renderer'
+import { FromRenderer, FromRenderMessage } from "@virid/renderer";
 // 发往渲染进程的消息
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
   constructor(public path: string) {
-    super()
+    super();
   }
 }
-// 将来自渲染进程且 __virid_messageType: string = 'file-dialog'的消息转换成主进程的OpenDialogMessage
-@FromRenderer('open-dialog')
+// 将来自渲染进程且 __virid_message_type: string = 'file-dialog'的消息转换成主进程的OpenDialogMessage
+@FromRenderer("open-dialog")
 export class OpenDialogMessage extends FromRenderMessage {
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 
@@ -94,13 +95,16 @@ export class WindowSystem {
   @System()
   async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
     // 调用原生对话框
-    const result = await dialog.showOpenDialog(message.senderWindow, message.options)
+    const result = await dialog.showOpenDialog(
+      message.senderWindow,
+      message.options,
+    );
     // 如果用户没有取消，并且确实选择了文件
     if (!result.canceled && result.filePaths.length > 0) {
-      const selectedPath = result.filePaths[0]
-      return new RenderDialogMessage(selectedPath)
+      const selectedPath = result.filePaths[0];
+      return new RenderDialogMessage(selectedPath);
     }
-    return
+    return;
   }
 }
 ```
@@ -120,7 +124,7 @@ class ChooseBgImageMessage extends FromMainMessage {
 //打开文件选择框
 class OpenDialogMessage extends ToMainMessage {
   __virid_target: string = 'main'
-  __virid_messageType: string = 'open-dialog'
+  __virid_message_type: string = 'open-dialog'
   constructor(
     public options: {
       title?: string
@@ -133,6 +137,3 @@ class OpenDialogMessage extends ToMainMessage {
 }
 
 ```
-
-
-

package/dist/index.cjs

@@ -1,7 +1,6 @@
 /**
- *  @virid/main v0.3.1
+ *  @virid/main v0.3.3
  *  Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages
  */
-var g=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var $=(r,e,i)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var s=(r,e)=>g(r,"name",{value:e,configurable:!0});var b=(r,e)=>{for(var i in e)g(r,i,{get:e[i],enumerable:!0})},C=(r,e,i,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of h(e))!N.call(r,n)&&n!==i&&g(r,n,{get:()=>e[n],enumerable:!(t=W(e,n))||t.enumerable});return r};var D=r=>C(g({},"__esModule",{value:!0}),r);var c=(r,e,i)=>$(r,typeof e!="symbol"?e+"":e,i);var B={};b(B,{FromRenderer:()=>k,FromRendererMessage:()=>M,MainPlugin:()=>y,ROUTER_MAP:()=>_,ToRendererMessage:()=>f,VIRID_CHANNEL:()=>u,middleWare:()=>R,processMessage:()=>T});module.exports=D(B);var E=require("@virid/core");var I=class I extends E.EventMessage{constructor(){super(...arguments);c(this,"__virid_source","unknown");c(this,"__virid_target","unknown");c(this,"__virid_messageType","unknown");c(this,"senderWindow",null)}};s(I,"FromRendererMessage");var M=I,l=class l extends E.EventMessage{};s(l,"ToRendererMessage"),c(l,"__virid_source","main");var f=l;var x=require("@virid/core");var m=require("@virid/core");var u="VIRID_INTERNAL_BUS",_=new Map,w=new Map;function k(r){return function(e){w.has(r)&&m.MessageWriter.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),w.set(r,e)}}s(k,"FromRenderer");function L(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:n}=r;if(!w.has(i)){m.MessageWriter.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let o=w.get(i),a=new o;n&&Object.assign(a,n),a.__virid_source=e,a.__virid_target=t,a.__virid_messageType=i;let d=_.get(e);d&&(a.senderWindow=d),m.MessageWriter.write(a)}s(L,"ReceiveMessages");function S(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:n}=r,o=_.get(t);if(!o){m.MessageWriter.error(new Error(`[Virid Main] unknown Window: Cannot find ${t} in the windows registry.`));return}o.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:n})}s(S,"TransmitMessages");function U(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:n}=r;_.forEach(o=>{o.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:n})})}s(U,"broadcastMessage");function T(r){let{__virid_target:e,__virid_source:i,__virid_messageType:t}=r;return e==="main"?L(r):e==="all"||e==="*"?U(r):S(r)}s(T,"processMessage");var R=s((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:t,...n}=r;i=="main"&&x.MessageWriter.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);let o={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:t,payload:n},a=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);a.length>0?a.forEach(d=>d.webContents.send(u,o)):x.MessageWriter.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");var p=require("@virid/core"),v=require("electron");var O="VIRID_INTERNAL_BUS";function V(r,e){e?.electronApp||p.MessageWriter.error(new Error(`[Virid Main] Missing Initialization Parameters:
-electronApp:${e?.electronApp}.`)),v.ipcMain.on(O,(i,t)=>{let{__virid_target:n,__virid_source:o,__virid_messageType:a}=t;if(!n||!o||!a){p.MessageWriter.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${n}, __virid_source${o}, __virid_messageType${a}`));return}if(a==="VIRID_INTERNAL_REGISTER"){let d=v.BrowserWindow.fromWebContents(i.sender);if(!d){p.MessageWriter.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(o)){p.MessageWriter.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${o}`));return}_.set(o,d),d.once("closed",()=>{_.delete(o),p.MessageWriter.info(`[Virid Main] Window unregistered: ${o}`)}),p.MessageWriter.info(`[Virid Main] Window registered: ${o}`);return}T(t)}),r.useMiddleware(R)}s(V,"activateApp");var A=class A{constructor(){c(this,"name","@virid/main")}install(e,i){V(e,i)}};s(A,"MainPlugin");var y=A;0&&(module.exports={FromRenderer,FromRendererMessage,MainPlugin,ROUTER_MAP,ToRendererMessage,VIRID_CHANNEL,middleWare,processMessage});
+var u=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var D=(s,e,r)=>e in s?u(s,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):s[e]=r;var p=(s,e)=>u(s,"name",{value:e,configurable:!0});var T=(s,e)=>{for(var r in e)u(s,r,{get:e[r],enumerable:!0})},W=(s,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of y(e))!V.call(s,t)&&t!==r&&u(s,t,{get:()=>e[t],enumerable:!(i=A(e,t))||i.enumerable});return s};var b=s=>W(u({},"__esModule",{value:!0}),s);var d=(s,e,r)=>D(s,typeof e!="symbol"?e+"":e,r);var N={};T(N,{FromRenderer:()=>x,FromRendererMessage:()=>M,MainPlugin:()=>E,ToRendererMessage:()=>m});module.exports=b(N);var a=require("@virid/core"),w=require("electron");var v=require("@virid/core");var h=class h extends v.EventMessage{constructor(){super(...arguments);d(this,"__virid_source","unknown");d(this,"__virid_target","unknown");d(this,"__virid_message_type","unknown");d(this,"senderWindow",null)}};p(h,"FromRendererMessage");var M=h,g=class g extends v.EventMessage{};p(g,"ToRendererMessage"),d(g,"__virid_source","main");var m=g;var I=require("@virid/core"),f={...I.VIRID_METADATA,FROMRENDERER:"virid:main:fromrenderer"};function x(s){return function(e){Reflect.defineMetadata(f.FROMRENDERER,s,e)}}p(x,"FromRenderer");var l="VIRID_INTERNAL_BUS",R=class R{constructor(){d(this,"name","@virid/main");d(this,"message_map",new Map);d(this,"route_map",new Map)}install(e,r){if(!r?.electronApp){a.MessageWriter.error(new Error(`[Virid Main] Missing Initialization Parameters: electronApp:${r?.electronApp}.`));return}w.ipcMain.on(l,(i,t)=>{let{__virid_target:_,__virid_source:n,__virid_message_type:o}=t;if(!_||!n||!o){a.MessageWriter.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${_}, __virid_source${n}, __virid_message_type${o}`));return}if(o==="VIRID_INTERNAL_REGISTER"){let c=w.BrowserWindow.fromWebContents(i.sender);if(!c){a.MessageWriter.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(this.route_map.has(n)){a.MessageWriter.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${n}`));return}this.route_map.set(n,c),c.once("closed",()=>{this.route_map.delete(n),a.MessageWriter.info(`[Virid Main] Window unregistered: ${n}`)}),a.MessageWriter.info(`[Virid Main] Window registered: ${n}`);return}this.processMessage(t)}),e.useMiddleware(this.middleWare.bind(this))}bindRoute(e){let r=Reflect.getMetadata(f.FROMRENDERER,e);this.message_map.has(r)&&a.MessageWriter.error(new Error(`[Virid Main] Duplicate IpcMessage: Registration for route: ${r}, message class: ${e}`)),this.message_map.set(r,e)}middleWare(e,r){if(e instanceof m){let{__virid_target:i,__virid_message_type:t,..._}=e;if(i=="main"){a.MessageWriter.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);return}let n={__virid_source:m.__virid_source,__virid_target:i,__virid_message_type:t,payload:_},o=i==="*"||i==="all"?Array.from(this.route_map.values()):[this.route_map.get(i)].filter(Boolean);if(o.length>0)o.forEach(c=>c.webContents.send(l,n));else{a.MessageWriter.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`));return}}else r()}receiveMessages(e){let{__virid_source:r,__virid_message_type:i,__virid_target:t,payload:_}=e;if(!this.message_map.has(i)){a.MessageWriter.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let n=this.message_map.get(i),o=new n;_&&Object.assign(o,_),o.__virid_source=r,o.__virid_target=t,o.__virid_message_type=i;let c=this.route_map.get(r);c&&(o.senderWindow=c),a.MessageWriter.write(o)}transmitMessages(e){let{__virid_source:r,__virid_message_type:i,__virid_target:t,payload:_}=e,n=this.route_map.get(t);if(!n){a.MessageWriter.error(new Error(`[Virid Main] unknown Window: Cannot find ${t} in the windows registry.`));return}n.webContents.send(l,{__virid_source:r,__virid_message_type:i,__virid_target:t,payload:_})}broadcastMessage(e){let{__virid_source:r,__virid_message_type:i,__virid_target:t,payload:_}=e;this.route_map.forEach(n=>{n.webContents.send(l,{__virid_source:r,__virid_message_type:i,__virid_target:t,payload:_})})}processMessage(e){let{__virid_target:r,__virid_source:i,__virid_message_type:t}=e;return r==="main"?this.receiveMessages(e):r==="all"||r==="*"?this.broadcastMessage(e):this.transmitMessages(e)}};p(R,"MainPlugin");var E=R;0&&(module.exports={FromRenderer,FromRendererMessage,MainPlugin,ToRendererMessage});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/main/message.ts","../src/main/middleware.ts","../src/main/router.ts","../src/app.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport class MainPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/main\";\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * Message from rendering process\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //What message should I turn into at the destination?\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n *Message to be sent to the rendering process\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public static __virid_source = \"main\";\n  /**Where is my destination?\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_messageType: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRendererMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //If the message is inherited from MainRequestMessage, intercept and send it to the corresponding rendering process\n  if (message instanceof ToRendererMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //Don't send it to yourself\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n      );\n    }\n    const packet = {\n      __virid_source: ToRendererMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean);\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\n    }\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRendererMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nconst MESSAGE_MAP = new Map<string, Newable<FromRendererMessage>>();\n\nexport function FromRenderer(type: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n// The main process receives the message and sends it to its own system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // The main process did not register this message and reported an error directly\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // Search for message classes registered by the main process\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  const instance = new (MessageClass as any)();\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // Inject identity metadata\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // Inject context\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // System group assigned to the main process\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // Search for message classes registered by the main process\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // The main process did not register this message and reported an error directly\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //Check parameters\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //Bind Electron main process callback\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // If it is a registration message, then register this rendering process\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // Obtain the physical instance through event.sender and bind it with the logical ID\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //Unable to find window, error reported\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //If it already exists, report an error\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // Store in routing table\n      ROUTER_MAP.set(__virid_source, win);\n      // Automatically delete oneself when closed\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //Distribute messages\n    processMessage(message);\n  });\n  //Register your own middleware function to intercept ToRenderMessage and send it to the specified rendering process\n  app.useMiddleware(middleWare);\n}\n"],"mappings":"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","names":["index_exports","__export","FromRenderer","FromRendererMessage","MainPlugin","ROUTER_MAP","ToRendererMessage","VIRID_CHANNEL","middleWare","processMessage","__toCommonJS","import_core","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","import_core","import_core","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRenderer","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRendererMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","import_core","import_electron","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp","_MainPlugin"]}
+{"version":3,"sources":["../src/index.ts","../src/main/message.ts","../src/main/constant.ts","../src/main/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport {\n  BaseMessage,\n  MessageWriter,\n  Newable,\n  ViridPlugin,\n  type ViridApp,\n} from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { FromRendererMessage, ToRendererMessage } from \"./main\";\nimport { VIRID_MAIN_METADATA } from \"./main/constant\";\n\nexport * from \"./main\";\nexport * from \"./interfaces\";\n\nexport class MainPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/main\";\n  public message_map = new Map<string, Newable<FromRendererMessage>>();\n  public route_map = new Map<string, BrowserWindow>();\n  install(app: ViridApp, options: PluginOption) {\n    //Check parameters\n    if (!options?.electronApp) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Missing Initialization Parameters: electronApp:${options?.electronApp}.`,\n        ),\n      );\n      return;\n    }\n    //Bind Electron main process callback\n    ipcMain.on(VIRID_CHANNEL, (event, message) => {\n      const { __virid_target, __virid_source, __virid_message_type } = message;\n      if (!__virid_target || !__virid_source || !__virid_message_type) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_message_type${__virid_message_type}`,\n          ),\n        );\n        return;\n      }\n      // If it is a registration message, then register this rendering process\n      if (__virid_message_type === \"VIRID_INTERNAL_REGISTER\") {\n        // Obtain the physical instance through event.sender and bind it with the logical ID\n        const win = BrowserWindow.fromWebContents(event.sender);\n        //Unable to find window, error reported\n        if (!win) {\n          MessageWriter.error(\n            new Error(\n              `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n            ),\n          );\n          return;\n        }\n        //If it already exists, report an error\n        if (this.route_map.has(__virid_source)) {\n          MessageWriter.error(\n            new Error(\n              `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n            ),\n          );\n          return;\n        }\n        // Store in routing table\n        this.route_map.set(__virid_source, win);\n        // Automatically delete oneself when closed\n        win.once(\"closed\", () => {\n          this.route_map.delete(__virid_source);\n          MessageWriter.info(\n            `[Virid Main] Window unregistered: ${__virid_source}`,\n          );\n        });\n        MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n        return;\n      }\n      //Distribute messages\n      this.processMessage(message);\n    });\n    //Register your own middleware function to intercept ToRenderMessage and send it to the specified rendering process\n    app.useMiddleware(this.middleWare.bind(this));\n  }\n  bindRoute(target: Newable<FromRendererMessage>) {\n    const route = Reflect.getMetadata(VIRID_MAIN_METADATA.FROMRENDERER, target);\n    if (this.message_map.has(route)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for route: ${route}, message class: ${target}`,\n        ),\n      );\n    }\n    this.message_map.set(route, target);\n  }\n  middleWare(message: BaseMessage, next: () => void) {\n    //If the message is inherited from MainRequestMessage, intercept and send it to the corresponding rendering process\n    if (message instanceof ToRendererMessage) {\n      const { __virid_target, __virid_message_type, ...payload } = message;\n      //Don't send it to yourself\n      if (__virid_target == \"main\") {\n        MessageWriter.warn(\n          `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n        );\n        return;\n      }\n      const packet = {\n        __virid_source: ToRendererMessage.__virid_source,\n        __virid_target,\n        __virid_message_type,\n        payload,\n      };\n\n      const targetWindows =\n        __virid_target === \"*\" || __virid_target === \"all\"\n          ? Array.from(this.route_map.values())\n          : [this.route_map.get(__virid_target)].filter(Boolean);\n\n      if (targetWindows.length > 0) {\n        targetWindows.forEach((win) =>\n          win!.webContents.send(VIRID_CHANNEL, packet),\n        );\n      } else {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n          ),\n        );\n        return;\n      }\n    } else {\n      next();\n    }\n  }\n\n  // The main process receives the message and sends it to its own system\n  receiveMessages(message: any): void {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    if (!this.message_map.has(__virid_message_type)) {\n      // The main process did not register this message and reported an error directly\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] unknown Message Type: Cannot find ${__virid_message_type} in the main process registry.`,\n        ),\n      );\n      return;\n    }\n    // Search for message classes registered by the main process\n    const MessageClass = this.message_map.get(__virid_message_type);\n    const instance = new (MessageClass as any)();\n    if (payload) {\n      Object.assign(instance, payload);\n    }\n    // Inject identity metadata\n    instance.__virid_source = __virid_source;\n    instance.__virid_target = __virid_target;\n    instance.__virid_message_type = __virid_message_type;\n    // Inject context\n    const context = this.route_map.get(__virid_source);\n    if (context) {\n      instance.senderWindow = context;\n    }\n\n    // System group assigned to the main process\n    MessageWriter.write(instance);\n  }\n\n  transmitMessages(message: any): void {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    // Search for message classes registered by the main process\n    const targetWindow = this.route_map.get(__virid_target);\n    if (!targetWindow) {\n      // The main process did not register this message and reported an error directly\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n        ),\n      );\n      return;\n    }\n    targetWindow.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_message_type,\n      __virid_target,\n      payload,\n    });\n  }\n  broadcastMessage(message: any) {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    this.route_map.forEach((window: BrowserWindow) => {\n      window.webContents.send(VIRID_CHANNEL, {\n        __virid_source,\n        __virid_message_type,\n        __virid_target,\n        payload,\n      });\n    });\n  }\n\n  processMessage(message: any) {\n    const { __virid_target, __virid_source, __virid_message_type } = message;\n    if (__virid_target === \"main\") return this.receiveMessages(message);\n    else if (__virid_target === \"all\" || __virid_target === \"*\")\n      return this.broadcastMessage(message);\n    else return this.transmitMessages(message);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * Message from rendering process\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //What message should I turn into at the destination?\n  public __virid_message_type: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n *Message to be sent to the rendering process\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public static __virid_source = \"main\";\n  /**Where is my destination?\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_message_type: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { VIRID_METADATA } from \"@virid/core\";\n\nexport const VIRID_MAIN_METADATA = {\n  ...VIRID_METADATA,\n  FROMRENDERER: \"virid:main:fromrenderer\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { Newable } from \"@virid/core\";\nimport { type FromRendererMessage } from \"./message\";\nimport { VIRID_MAIN_METADATA } from \"./constant\";\nexport function FromRenderer(route: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    Reflect.defineMetadata(VIRID_MAIN_METADATA.FROMRENDERER, route, target);\n  };\n}\n"],"mappings":";;;;ulBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kBAAAE,EAAA,wBAAAC,EAAA,eAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAN,GAkBA,IAAAO,EAMO,uBAEPC,EAAuC,oBCrBvC,IAAAC,EAA6B,uBAKtB,IAAeC,EAAf,MAAeA,UAA4BC,cAAAA,CAA3C,kCAIEC,EAAAA,sBAAyB,WAMzBC,EAAAA,sBAAyB,WAGzBC,EAAAA,4BAA+B,WAC/BC,EAAAA,oBAAuC,MAChD,EAfkDJ,EAAAA,EAAAA,uBAA3C,IAAeD,EAAfM,EAoBeC,EAAf,MAAeA,UAA0BN,cAAAA,CAchD,EAdgDA,EAAAA,EAAAA,qBAI9CO,EAJoBD,EAINL,iBAAiB,QAJ1B,IAAeK,EAAfE,ECzBP,IAAAC,EAA+B,uBAElBC,EAAsB,CACjC,GAAGC,iBACHC,aAAc,yBAChB,ECFO,SAASC,EAAaC,EAAa,CACxC,OAAO,SAAUC,EAAoC,CACnDC,QAAQC,eAAeC,EAAoBC,aAAcL,EAAOC,CAAAA,CAClE,CACF,CAJgBF,EAAAA,EAAAA,gBHShB,IAAMO,EAAgB,qBAgBTC,EAAN,MAAMA,CAAAA,CAAN,cACLC,EAAAA,YAAO,eACAC,EAAAA,mBAAc,IAAIC,KAClBC,EAAAA,iBAAY,IAAID,KACvBE,QAAQC,EAAeC,EAAuB,CAE5C,GAAI,CAACA,GAASC,YAAa,CACzBC,gBAAcC,MACZ,IAAIC,MACF,+DAA+DJ,GAASC,WAAAA,GAAc,CAAA,EAG1F,MACF,CAEAI,UAAQC,GAAGd,EAAe,CAACe,EAAOC,IAAAA,CAChC,GAAM,CAAEC,eAAAA,EAAgBC,eAAAA,EAAgBC,qBAAAA,CAAoB,EAAKH,EACjE,GAAI,CAACC,GAAkB,CAACC,GAAkB,CAACC,EAAsB,CAC/DT,gBAAcC,MACZ,IAAIC,MACF,yFAAyFK,CAAAA,mBAAiCC,CAAAA,yBAAuCC,CAAAA,EAAsB,CAAA,EAG3L,MACF,CAEA,GAAIA,IAAyB,0BAA2B,CAEtD,IAAMC,EAAMC,gBAAcC,gBAAgBP,EAAMQ,MAAM,EAEtD,GAAI,CAACH,EAAK,CACRV,gBAAcC,MACZ,IAAIC,MACF,sFAAsF,CAAA,EAG1F,MACF,CAEA,GAAI,KAAKP,UAAUmB,IAAIN,CAAAA,EAAiB,CACtCR,gBAAcC,MACZ,IAAIC,MACF,6EAA6EM,CAAAA,EAAgB,CAAA,EAGjG,MACF,CAEA,KAAKb,UAAUoB,IAAIP,EAAgBE,CAAAA,EAEnCA,EAAIM,KAAK,SAAU,IAAA,CACjB,KAAKrB,UAAUsB,OAAOT,CAAAA,EACtBR,gBAAckB,KACZ,qCAAqCV,CAAAA,EAAgB,CAEzD,CAAA,EACAR,gBAAckB,KAAK,mCAAmCV,CAAAA,EAAgB,EACtE,MACF,CAEA,KAAKW,eAAeb,CAAAA,CACtB,CAAA,EAEAT,EAAIuB,cAAc,KAAKC,WAAWC,KAAK,IAAI,CAAA,CAC7C,CACAC,UAAUC,EAAsC,CAC9C,IAAMC,EAAQC,QAAQC,YAAYC,EAAoBC,aAAcL,CAAAA,EAChE,KAAK/B,YAAYqB,IAAIW,CAAAA,GACvBzB,gBAAcC,MACZ,IAAIC,MACF,8DAA8DuB,CAAAA,oBAAyBD,CAAAA,EAAQ,CAAA,EAIrG,KAAK/B,YAAYsB,IAAIU,EAAOD,CAAAA,CAC9B,CACAH,WAAWf,EAAsBwB,EAAkB,CAEjD,GAAIxB,aAAmByB,EAAmB,CACxC,GAAM,CAAExB,eAAAA,EAAgBE,qBAAAA,EAAsB,GAAGuB,CAAAA,EAAY1B,EAE7D,GAAIC,GAAkB,OAAQ,CAC5BP,gBAAciC,KACZ,6CAA6C1B,CAAAA,uCAAqD,EAEpG,MACF,CACA,IAAM2B,EAAS,CACb1B,eAAgBuB,EAAkBvB,eAClCD,eAAAA,EACAE,qBAAAA,EACAuB,QAAAA,CACF,EAEMG,EACJ5B,IAAmB,KAAOA,IAAmB,MACzC6B,MAAMC,KAAK,KAAK1C,UAAU2C,OAAM,CAAA,EAChC,CAAC,KAAK3C,UAAU4C,IAAIhC,CAAAA,GAAiBiC,OAAOC,OAAAA,EAElD,GAAIN,EAAcO,OAAS,EACzBP,EAAcQ,QAASjC,GACrBA,EAAKkC,YAAYC,KAAKvD,EAAe4C,CAAAA,CAAAA,MAElC,CACLlC,gBAAcC,MACZ,IAAIC,MACF,gDAAgDK,CAAAA,mBAAiC,CAAA,EAGrF,MACF,CACF,MACEuB,EAAAA,CAEJ,CAGAgB,gBAAgBxC,EAAoB,CAClC,GAAM,CAAEE,eAAAA,EAAgBC,qBAAAA,EAAsBF,eAAAA,EAAgByB,QAAAA,CAAO,EACnE1B,EACF,GAAI,CAAC,KAAKb,YAAYqB,IAAIL,CAAAA,EAAuB,CAE/CT,gBAAcC,MACZ,IAAIC,MACF,kDAAkDO,CAAAA,gCAAoD,CAAA,EAG1G,MACF,CAEA,IAAMsC,EAAe,KAAKtD,YAAY8C,IAAI9B,CAAAA,EACpCuC,EAAW,IAAKD,EAClBf,GACFiB,OAAOC,OAAOF,EAAUhB,CAAAA,EAG1BgB,EAASxC,eAAiBA,EAC1BwC,EAASzC,eAAiBA,EAC1ByC,EAASvC,qBAAuBA,EAEhC,IAAM0C,EAAU,KAAKxD,UAAU4C,IAAI/B,CAAAA,EAC/B2C,IACFH,EAASI,aAAeD,GAI1BnD,gBAAcqD,MAAML,CAAAA,CACtB,CAEAM,iBAAiBhD,EAAoB,CACnC,GAAM,CAAEE,eAAAA,EAAgBC,qBAAAA,EAAsBF,eAAAA,EAAgByB,QAAAA,CAAO,EACnE1B,EAEIiD,EAAe,KAAK5D,UAAU4C,IAAIhC,CAAAA,EACxC,GAAI,CAACgD,EAAc,CAEjBvD,gBAAcC,MACZ,IAAIC,MACF,4CAA4CK,CAAAA,2BAAyC,CAAA,EAGzF,MACF,CACAgD,EAAaX,YAAYC,KAAKvD,EAAe,CAC3CkB,eAAAA,EACAC,qBAAAA,EACAF,eAAAA,EACAyB,QAAAA,CACF,CAAA,CACF,CACAwB,iBAAiBlD,EAAc,CAC7B,GAAM,CAAEE,eAAAA,EAAgBC,qBAAAA,EAAsBF,eAAAA,EAAgByB,QAAAA,CAAO,EACnE1B,EACF,KAAKX,UAAUgD,QAASc,GAAAA,CACtBA,EAAOb,YAAYC,KAAKvD,EAAe,CACrCkB,eAAAA,EACAC,qBAAAA,EACAF,eAAAA,EACAyB,QAAAA,CACF,CAAA,CACF,CAAA,CACF,CAEAb,eAAeb,EAAc,CAC3B,GAAM,CAAEC,eAAAA,EAAgBC,eAAAA,EAAgBC,qBAAAA,CAAoB,EAAKH,EACjE,OAAIC,IAAmB,OAAe,KAAKuC,gBAAgBxC,CAAAA,EAClDC,IAAmB,OAASA,IAAmB,IAC/C,KAAKiD,iBAAiBlD,CAAAA,EACnB,KAAKgD,iBAAiBhD,CAAAA,CACpC,CACF,EA9Laf,EAAAA,EAAAA,cAAN,IAAMA,EAANmE","names":["index_exports","__export","FromRenderer","FromRendererMessage","MainPlugin","ToRendererMessage","__toCommonJS","import_core","import_electron","import_core","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_message_type","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","import_core","VIRID_MAIN_METADATA","VIRID_METADATA","FROMRENDERER","FromRenderer","route","target","Reflect","defineMetadata","VIRID_MAIN_METADATA","FROMRENDERER","VIRID_CHANNEL","MainPlugin","name","message_map","Map","route_map","install","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_message_type","win","BrowserWindow","fromWebContents","sender","has","set","once","delete","info","processMessage","useMiddleware","middleWare","bind","bindRoute","target","route","Reflect","getMetadata","VIRID_MAIN_METADATA","FROMRENDERER","next","ToRendererMessage","payload","warn","packet","targetWindows","Array","from","values","get","filter","Boolean","length","forEach","webContents","send","receiveMessages","MessageClass","instance","Object","assign","context","senderWindow","write","transmitMessages","targetWindow","broadcastMessage","window","_MainPlugin"]}

package/dist/index.d.cts

@@ -1,6 +1,10 @@
-import { EventMessage, Middleware, Newable, ViridPlugin, ViridApp } from '@virid/core';
+import { EventMessage, Newable, ViridPlugin, ViridApp, BaseMessage } from '@virid/core';
 export { SystemContext } from '@virid/core';
-import { BrowserWindow, App } from 'electron';
+import { App, BrowserWindow } from 'electron';
+
+interface PluginOption {
+    electronApp: App;
+}
 
 /**
  * Message from rendering process
@@ -16,7 +20,7 @@ declare abstract class FromRendererMessage extends EventMessage {
      *String: Specify the ID of a window (windowId)
      */
     __virid_target: string;
-    __virid_messageType: string;
+    __virid_message_type: string;
     senderWindow: Electron.BrowserWindow;
 }
 /**
@@ -35,23 +39,22 @@ declare abstract class ToRendererMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    abstract __virid_messageType: string;
+    abstract __virid_message_type: string;
 }
 
-declare const middleWare: Middleware;
-
-declare const VIRID_CHANNEL = "VIRID_INTERNAL_BUS";
-declare const ROUTER_MAP: Map<string, BrowserWindow>;
-declare function FromRenderer(type: string): (target: Newable<FromRendererMessage>) => void;
-declare function processMessage(message: any): void;
-
-interface PluginOption {
-    electronApp: App;
-}
+declare function FromRenderer(route: string): (target: Newable<FromRendererMessage>) => void;
 
 declare class MainPlugin implements ViridPlugin<PluginOption> {
     name: string;
+    message_map: Map<string, Newable<FromRendererMessage>>;
+    route_map: Map<string, BrowserWindow>;
     install(app: ViridApp, options: PluginOption): void;
+    bindRoute(target: Newable<FromRendererMessage>): void;
+    middleWare(message: BaseMessage, next: () => void): void;
+    receiveMessages(message: any): void;
+    transmitMessages(message: any): void;
+    broadcastMessage(message: any): void;
+    processMessage(message: any): void;
 }
 
-export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRendererMessage, VIRID_CHANNEL, middleWare, processMessage };
+export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ToRendererMessage };

package/dist/index.d.ts

@@ -1,6 +1,10 @@
-import { EventMessage, Middleware, Newable, ViridPlugin, ViridApp } from '@virid/core';
+import { EventMessage, Newable, ViridPlugin, ViridApp, BaseMessage } from '@virid/core';
 export { SystemContext } from '@virid/core';
-import { BrowserWindow, App } from 'electron';
+import { App, BrowserWindow } from 'electron';
+
+interface PluginOption {
+    electronApp: App;
+}
 
 /**
  * Message from rendering process
@@ -16,7 +20,7 @@ declare abstract class FromRendererMessage extends EventMessage {
      *String: Specify the ID of a window (windowId)
      */
     __virid_target: string;
-    __virid_messageType: string;
+    __virid_message_type: string;
     senderWindow: Electron.BrowserWindow;
 }
 /**
@@ -35,23 +39,22 @@ declare abstract class ToRendererMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    abstract __virid_messageType: string;
+    abstract __virid_message_type: string;
 }
 
-declare const middleWare: Middleware;
-
-declare const VIRID_CHANNEL = "VIRID_INTERNAL_BUS";
-declare const ROUTER_MAP: Map<string, BrowserWindow>;
-declare function FromRenderer(type: string): (target: Newable<FromRendererMessage>) => void;
-declare function processMessage(message: any): void;
-
-interface PluginOption {
-    electronApp: App;
-}
+declare function FromRenderer(route: string): (target: Newable<FromRendererMessage>) => void;
 
 declare class MainPlugin implements ViridPlugin<PluginOption> {
     name: string;
+    message_map: Map<string, Newable<FromRendererMessage>>;
+    route_map: Map<string, BrowserWindow>;
     install(app: ViridApp, options: PluginOption): void;
+    bindRoute(target: Newable<FromRendererMessage>): void;
+    middleWare(message: BaseMessage, next: () => void): void;
+    receiveMessages(message: any): void;
+    transmitMessages(message: any): void;
+    broadcastMessage(message: any): void;
+    processMessage(message: any): void;
 }
 
-export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRendererMessage, VIRID_CHANNEL, middleWare, processMessage };
+export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ToRendererMessage };

package/dist/index.js

@@ -1,7 +1,6 @@
 /**
- *  @virid/main v0.3.1
+ *  @virid/main v0.3.3
  *  Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages
  */
-var M=Object.defineProperty;var V=(r,e,i)=>e in r?M(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var o=(r,e)=>M(r,"name",{value:e,configurable:!0});var c=(r,e,i)=>V(r,typeof e!="symbol"?e+"":e,i);import{EventMessage as I}from"@virid/core";var w=class w extends I{constructor(){super(...arguments);c(this,"__virid_source","unknown");c(this,"__virid_target","unknown");c(this,"__virid_messageType","unknown");c(this,"senderWindow",null)}};o(w,"FromRendererMessage");var E=w,g=class g extends I{};o(g,"ToRendererMessage"),c(g,"__virid_source","main");var f=g;import{MessageWriter as x}from"@virid/core";import{MessageWriter as m}from"@virid/core";var l="VIRID_INTERNAL_BUS",_=new Map,u=new Map;function O(r){return function(e){u.has(r)&&m.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),u.set(r,e)}}o(O,"FromRenderer");function W(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;if(!u.has(i)){m.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let n=u.get(i),s=new n;a&&Object.assign(s,a),s.__virid_source=e,s.__virid_target=t,s.__virid_messageType=i;let d=_.get(e);d&&(s.senderWindow=d),m.write(s)}o(W,"ReceiveMessages");function h(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r,n=_.get(t);if(!n){m.error(new Error(`[Virid Main] unknown Window: Cannot find ${t} in the windows registry.`));return}n.webContents.send(l,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})}o(h,"TransmitMessages");function N(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;_.forEach(n=>{n.webContents.send(l,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})})}o(N,"broadcastMessage");function T(r){let{__virid_target:e,__virid_source:i,__virid_messageType:t}=r;return e==="main"?W(r):e==="all"||e==="*"?N(r):h(r)}o(T,"processMessage");var R=o((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:t,...a}=r;i=="main"&&x.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);let n={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:t,payload:a},s=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);s.length>0?s.forEach(d=>d.webContents.send(l,n)):x.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");import{MessageWriter as p}from"@virid/core";import{BrowserWindow as b,ipcMain as C}from"electron";var $="VIRID_INTERNAL_BUS";function y(r,e){e?.electronApp||p.error(new Error(`[Virid Main] Missing Initialization Parameters:
-electronApp:${e?.electronApp}.`)),C.on($,(i,t)=>{let{__virid_target:a,__virid_source:n,__virid_messageType:s}=t;if(!a||!n||!s){p.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${a}, __virid_source${n}, __virid_messageType${s}`));return}if(s==="VIRID_INTERNAL_REGISTER"){let d=b.fromWebContents(i.sender);if(!d){p.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(n)){p.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${n}`));return}_.set(n,d),d.once("closed",()=>{_.delete(n),p.info(`[Virid Main] Window unregistered: ${n}`)}),p.info(`[Virid Main] Window registered: ${n}`);return}T(t)}),r.useMiddleware(R)}o(y,"activateApp");var v=class v{constructor(){c(this,"name","@virid/main")}install(e,i){y(e,i)}};o(v,"MainPlugin");var A=v;export{O as FromRenderer,E as FromRendererMessage,A as MainPlugin,_ as ROUTER_MAP,f as ToRendererMessage,l as VIRID_CHANNEL,R as middleWare,T as processMessage};
+var M=Object.defineProperty;var R=(d,e,r)=>e in d?M(d,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):d[e]=r;var p=(d,e)=>M(d,"name",{value:e,configurable:!0});var _=(d,e,r)=>R(d,typeof e!="symbol"?e+"":e,r);import{MessageWriter as o}from"@virid/core";import{BrowserWindow as A,ipcMain as y}from"electron";import{EventMessage as h}from"@virid/core";var l=class l extends h{constructor(){super(...arguments);_(this,"__virid_source","unknown");_(this,"__virid_target","unknown");_(this,"__virid_message_type","unknown");_(this,"senderWindow",null)}};p(l,"FromRendererMessage");var v=l,u=class u extends h{};p(u,"ToRendererMessage"),_(u,"__virid_source","main");var m=u;import{VIRID_METADATA as I}from"@virid/core";var g={...I,FROMRENDERER:"virid:main:fromrenderer"};function $(d){return function(e){Reflect.defineMetadata(g.FROMRENDERER,d,e)}}p($,"FromRenderer");var f="VIRID_INTERNAL_BUS",w=class w{constructor(){_(this,"name","@virid/main");_(this,"message_map",new Map);_(this,"route_map",new Map)}install(e,r){if(!r?.electronApp){o.error(new Error(`[Virid Main] Missing Initialization Parameters: electronApp:${r?.electronApp}.`));return}y.on(f,(i,s)=>{let{__virid_target:a,__virid_source:t,__virid_message_type:n}=s;if(!a||!t||!n){o.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${a}, __virid_source${t}, __virid_message_type${n}`));return}if(n==="VIRID_INTERNAL_REGISTER"){let c=A.fromWebContents(i.sender);if(!c){o.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(this.route_map.has(t)){o.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${t}`));return}this.route_map.set(t,c),c.once("closed",()=>{this.route_map.delete(t),o.info(`[Virid Main] Window unregistered: ${t}`)}),o.info(`[Virid Main] Window registered: ${t}`);return}this.processMessage(s)}),e.useMiddleware(this.middleWare.bind(this))}bindRoute(e){let r=Reflect.getMetadata(g.FROMRENDERER,e);this.message_map.has(r)&&o.error(new Error(`[Virid Main] Duplicate IpcMessage: Registration for route: ${r}, message class: ${e}`)),this.message_map.set(r,e)}middleWare(e,r){if(e instanceof m){let{__virid_target:i,__virid_message_type:s,...a}=e;if(i=="main"){o.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);return}let t={__virid_source:m.__virid_source,__virid_target:i,__virid_message_type:s,payload:a},n=i==="*"||i==="all"?Array.from(this.route_map.values()):[this.route_map.get(i)].filter(Boolean);if(n.length>0)n.forEach(c=>c.webContents.send(f,t));else{o.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`));return}}else r()}receiveMessages(e){let{__virid_source:r,__virid_message_type:i,__virid_target:s,payload:a}=e;if(!this.message_map.has(i)){o.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let t=this.message_map.get(i),n=new t;a&&Object.assign(n,a),n.__virid_source=r,n.__virid_target=s,n.__virid_message_type=i;let c=this.route_map.get(r);c&&(n.senderWindow=c),o.write(n)}transmitMessages(e){let{__virid_source:r,__virid_message_type:i,__virid_target:s,payload:a}=e,t=this.route_map.get(s);if(!t){o.error(new Error(`[Virid Main] unknown Window: Cannot find ${s} in the windows registry.`));return}t.webContents.send(f,{__virid_source:r,__virid_message_type:i,__virid_target:s,payload:a})}broadcastMessage(e){let{__virid_source:r,__virid_message_type:i,__virid_target:s,payload:a}=e;this.route_map.forEach(t=>{t.webContents.send(f,{__virid_source:r,__virid_message_type:i,__virid_target:s,payload:a})})}processMessage(e){let{__virid_target:r,__virid_source:i,__virid_message_type:s}=e;return r==="main"?this.receiveMessages(e):r==="all"||r==="*"?this.broadcastMessage(e):this.transmitMessages(e)}};p(w,"MainPlugin");var E=w;export{$ as FromRenderer,v as FromRendererMessage,E as MainPlugin,m as ToRendererMessage};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/main/message.ts","../src/main/middleware.ts","../src/main/router.ts","../src/app.ts","../src/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * Message from rendering process\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //What message should I turn into at the destination?\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n *Message to be sent to the rendering process\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public static __virid_source = \"main\";\n  /**Where is my destination?\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_messageType: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRendererMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //If the message is inherited from MainRequestMessage, intercept and send it to the corresponding rendering process\n  if (message instanceof ToRendererMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //Don't send it to yourself\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n      );\n    }\n    const packet = {\n      __virid_source: ToRendererMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean);\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\n    }\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRendererMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nconst MESSAGE_MAP = new Map<string, Newable<FromRendererMessage>>();\n\nexport function FromRenderer(type: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n// The main process receives the message and sends it to its own system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // The main process did not register this message and reported an error directly\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // Search for message classes registered by the main process\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  const instance = new (MessageClass as any)();\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // Inject identity metadata\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // Inject context\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // System group assigned to the main process\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // Search for message classes registered by the main process\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // The main process did not register this message and reported an error directly\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //Check parameters\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //Bind Electron main process callback\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // If it is a registration message, then register this rendering process\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // Obtain the physical instance through event.sender and bind it with the logical ID\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //Unable to find window, error reported\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //If it already exists, report an error\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // Store in routing table\n      ROUTER_MAP.set(__virid_source, win);\n      // Automatically delete oneself when closed\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //Distribute messages\n    processMessage(message);\n  });\n  //Register your own middleware function to intercept ToRenderMessage and send it to the specified rendering process\n  app.useMiddleware(middleWare);\n}\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport class MainPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/main\";\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  }\n}\n"],"mappings":"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","names":["EventMessage","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","MessageWriter","MessageWriter","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRenderer","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRendererMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","MessageWriter","BrowserWindow","ipcMain","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp","_MainPlugin"]}
+{"version":3,"sources":["../src/index.ts","../src/main/message.ts","../src/main/constant.ts","../src/main/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport {\n  BaseMessage,\n  MessageWriter,\n  Newable,\n  ViridPlugin,\n  type ViridApp,\n} from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { FromRendererMessage, ToRendererMessage } from \"./main\";\nimport { VIRID_MAIN_METADATA } from \"./main/constant\";\n\nexport * from \"./main\";\nexport * from \"./interfaces\";\n\nexport class MainPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/main\";\n  public message_map = new Map<string, Newable<FromRendererMessage>>();\n  public route_map = new Map<string, BrowserWindow>();\n  install(app: ViridApp, options: PluginOption) {\n    //Check parameters\n    if (!options?.electronApp) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Missing Initialization Parameters: electronApp:${options?.electronApp}.`,\n        ),\n      );\n      return;\n    }\n    //Bind Electron main process callback\n    ipcMain.on(VIRID_CHANNEL, (event, message) => {\n      const { __virid_target, __virid_source, __virid_message_type } = message;\n      if (!__virid_target || !__virid_source || !__virid_message_type) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_message_type${__virid_message_type}`,\n          ),\n        );\n        return;\n      }\n      // If it is a registration message, then register this rendering process\n      if (__virid_message_type === \"VIRID_INTERNAL_REGISTER\") {\n        // Obtain the physical instance through event.sender and bind it with the logical ID\n        const win = BrowserWindow.fromWebContents(event.sender);\n        //Unable to find window, error reported\n        if (!win) {\n          MessageWriter.error(\n            new Error(\n              `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n            ),\n          );\n          return;\n        }\n        //If it already exists, report an error\n        if (this.route_map.has(__virid_source)) {\n          MessageWriter.error(\n            new Error(\n              `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n            ),\n          );\n          return;\n        }\n        // Store in routing table\n        this.route_map.set(__virid_source, win);\n        // Automatically delete oneself when closed\n        win.once(\"closed\", () => {\n          this.route_map.delete(__virid_source);\n          MessageWriter.info(\n            `[Virid Main] Window unregistered: ${__virid_source}`,\n          );\n        });\n        MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n        return;\n      }\n      //Distribute messages\n      this.processMessage(message);\n    });\n    //Register your own middleware function to intercept ToRenderMessage and send it to the specified rendering process\n    app.useMiddleware(this.middleWare.bind(this));\n  }\n  bindRoute(target: Newable<FromRendererMessage>) {\n    const route = Reflect.getMetadata(VIRID_MAIN_METADATA.FROMRENDERER, target);\n    if (this.message_map.has(route)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for route: ${route}, message class: ${target}`,\n        ),\n      );\n    }\n    this.message_map.set(route, target);\n  }\n  middleWare(message: BaseMessage, next: () => void) {\n    //If the message is inherited from MainRequestMessage, intercept and send it to the corresponding rendering process\n    if (message instanceof ToRendererMessage) {\n      const { __virid_target, __virid_message_type, ...payload } = message;\n      //Don't send it to yourself\n      if (__virid_target == \"main\") {\n        MessageWriter.warn(\n          `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n        );\n        return;\n      }\n      const packet = {\n        __virid_source: ToRendererMessage.__virid_source,\n        __virid_target,\n        __virid_message_type,\n        payload,\n      };\n\n      const targetWindows =\n        __virid_target === \"*\" || __virid_target === \"all\"\n          ? Array.from(this.route_map.values())\n          : [this.route_map.get(__virid_target)].filter(Boolean);\n\n      if (targetWindows.length > 0) {\n        targetWindows.forEach((win) =>\n          win!.webContents.send(VIRID_CHANNEL, packet),\n        );\n      } else {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n          ),\n        );\n        return;\n      }\n    } else {\n      next();\n    }\n  }\n\n  // The main process receives the message and sends it to its own system\n  receiveMessages(message: any): void {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    if (!this.message_map.has(__virid_message_type)) {\n      // The main process did not register this message and reported an error directly\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] unknown Message Type: Cannot find ${__virid_message_type} in the main process registry.`,\n        ),\n      );\n      return;\n    }\n    // Search for message classes registered by the main process\n    const MessageClass = this.message_map.get(__virid_message_type);\n    const instance = new (MessageClass as any)();\n    if (payload) {\n      Object.assign(instance, payload);\n    }\n    // Inject identity metadata\n    instance.__virid_source = __virid_source;\n    instance.__virid_target = __virid_target;\n    instance.__virid_message_type = __virid_message_type;\n    // Inject context\n    const context = this.route_map.get(__virid_source);\n    if (context) {\n      instance.senderWindow = context;\n    }\n\n    // System group assigned to the main process\n    MessageWriter.write(instance);\n  }\n\n  transmitMessages(message: any): void {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    // Search for message classes registered by the main process\n    const targetWindow = this.route_map.get(__virid_target);\n    if (!targetWindow) {\n      // The main process did not register this message and reported an error directly\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n        ),\n      );\n      return;\n    }\n    targetWindow.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_message_type,\n      __virid_target,\n      payload,\n    });\n  }\n  broadcastMessage(message: any) {\n    const { __virid_source, __virid_message_type, __virid_target, payload } =\n      message;\n    this.route_map.forEach((window: BrowserWindow) => {\n      window.webContents.send(VIRID_CHANNEL, {\n        __virid_source,\n        __virid_message_type,\n        __virid_target,\n        payload,\n      });\n    });\n  }\n\n  processMessage(message: any) {\n    const { __virid_target, __virid_source, __virid_message_type } = message;\n    if (__virid_target === \"main\") return this.receiveMessages(message);\n    else if (__virid_target === \"all\" || __virid_target === \"*\")\n      return this.broadcastMessage(message);\n    else return this.transmitMessages(message);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * Message from rendering process\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //What message should I turn into at the destination?\n  public __virid_message_type: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n *Message to be sent to the rendering process\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  /**\n   * Where am I from?\n   */\n  public static __virid_source = \"main\";\n  /**Where is my destination?\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_message_type: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { VIRID_METADATA } from \"@virid/core\";\n\nexport const VIRID_MAIN_METADATA = {\n  ...VIRID_METADATA,\n  FROMRENDERER: \"virid:main:fromrenderer\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nimport { Newable } from \"@virid/core\";\nimport { type FromRendererMessage } from \"./message\";\nimport { VIRID_MAIN_METADATA } from \"./constant\";\nexport function FromRenderer(route: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    Reflect.defineMetadata(VIRID_MAIN_METADATA.FROMRENDERER, route, target);\n  };\n}\n"],"mappings":"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","names":["MessageWriter","BrowserWindow","ipcMain","EventMessage","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_message_type","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","VIRID_METADATA","VIRID_MAIN_METADATA","FROMRENDERER","FromRenderer","route","target","Reflect","defineMetadata","VIRID_MAIN_METADATA","FROMRENDERER","VIRID_CHANNEL","MainPlugin","name","message_map","Map","route_map","install","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_message_type","win","BrowserWindow","fromWebContents","sender","has","set","once","delete","info","processMessage","useMiddleware","middleWare","bind","bindRoute","target","route","Reflect","getMetadata","VIRID_MAIN_METADATA","FROMRENDERER","next","ToRendererMessage","payload","warn","packet","targetWindows","Array","from","values","get","filter","Boolean","length","forEach","webContents","send","receiveMessages","MessageClass","instance","Object","assign","context","senderWindow","write","transmitMessages","targetWindow","broadcastMessage","window","_MainPlugin"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@virid/main",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages",
   "author": "Ailrid",
   "license": "Apache 2.0",
@@ -35,7 +35,7 @@
   "dependencies": {},
   "peerDependencies": {
     "electron": ">=30.0.0",
-    "@virid/core": "0.3.1"
+    "@virid/core": "0.3.3"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",