@noxfly/noxus 1.1.10 → 2.0.0

package/dist/{noxus.js → main.js}

@@ -25,9 +25,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
+// src/main.ts
+var main_exports = {};
+__export(main_exports, {
   AppInjector: () => AppInjector,
   Authorize: () => Authorize,
   BadGatewayException: () => BadGatewayException,
@@ -56,11 +56,15 @@ __export(src_exports, {
   NotFoundException: () => NotFoundException,
   NotImplementedException: () => NotImplementedException,
   NoxApp: () => NoxApp,
+  NoxRendererClient: () => NoxRendererClient,
+  NoxSocket: () => NoxSocket,
   Patch: () => Patch,
   PaymentRequiredException: () => PaymentRequiredException,
   Post: () => Post,
   Put: () => Put,
+  RENDERER_EVENT_TYPE: () => RENDERER_EVENT_TYPE,
   ROUTE_METADATA_KEY: () => ROUTE_METADATA_KEY,
+  RendererEventRegistry: () => RendererEventRegistry,
   Request: () => Request,
   RequestTimeoutException: () => RequestTimeoutException,
   ResponseException: () => ResponseException,
@@ -73,6 +77,8 @@ __export(src_exports, {
   UseMiddlewares: () => UseMiddlewares,
   VariantAlsoNegotiatesException: () => VariantAlsoNegotiatesException,
   bootstrapApplication: () => bootstrapApplication,
+  createRendererEventMessage: () => createRendererEventMessage,
+  exposeNoxusBridge: () => exposeNoxusBridge,
   getControllerMetadata: () => getControllerMetadata,
   getGuardForController: () => getGuardForController,
   getGuardForControllerAction: () => getGuardForControllerAction,
@@ -81,9 +87,11 @@ __export(src_exports, {
   getMiddlewaresForControllerAction: () => getMiddlewaresForControllerAction,
   getModuleMetadata: () => getModuleMetadata,
   getRouteMetadata: () => getRouteMetadata,
-  inject: () => inject
+  hasInjectableMetadata: () => hasInjectableMetadata,
+  inject: () => inject,
+  isRendererEventMessage: () => isRendererEventMessage
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(main_exports);
 
 // src/DI/app-injector.ts
 var import_reflect_metadata = require("reflect-metadata");
@@ -392,6 +400,21 @@ function getGuardForControllerAction(controllerName, actionName) {
 __name(getGuardForControllerAction, "getGuardForControllerAction");
 var authorizations = /* @__PURE__ */ new Map();
 
+// src/decorators/injectable.metadata.ts
+var INJECTABLE_METADATA_KEY = Symbol("INJECTABLE_METADATA_KEY");
+function defineInjectableMetadata(target, lifetime) {
+  Reflect.defineMetadata(INJECTABLE_METADATA_KEY, lifetime, target);
+}
+__name(defineInjectableMetadata, "defineInjectableMetadata");
+function getInjectableMetadata(target) {
+  return Reflect.getMetadata(INJECTABLE_METADATA_KEY, target);
+}
+__name(getInjectableMetadata, "getInjectableMetadata");
+function hasInjectableMetadata(target) {
+  return Reflect.hasMetadata(INJECTABLE_METADATA_KEY, target);
+}
+__name(hasInjectableMetadata, "hasInjectableMetadata");
+
 // src/decorators/method.decorator.ts
 function createRouteDecorator(verb) {
   return (path) => {
@@ -639,16 +662,11 @@ function Injectable(lifetime = "scope") {
     if (typeof target !== "function" || !target.prototype) {
       throw new Error(`@Injectable can only be used on classes, not on ${typeof target}`);
     }
-    Reflect.defineMetadata(INJECTABLE_METADATA_KEY, lifetime, target);
+    defineInjectableMetadata(target, lifetime);
     InjectorExplorer.register(target, lifetime);
   };
 }
 __name(Injectable, "Injectable");
-function getInjectableMetadata(target) {
-  return Reflect.getMetadata(INJECTABLE_METADATA_KEY, target);
-}
-__name(getInjectableMetadata, "getInjectableMetadata");
-var INJECTABLE_METADATA_KEY = Symbol("INJECTABLE_METADATA_KEY");
 
 // src/decorators/controller.decorator.ts
 function Controller(path) {
@@ -702,8 +720,9 @@ var middlewares = /* @__PURE__ */ new Map();
 // src/request.ts
 var import_reflect_metadata2 = require("reflect-metadata");
 var _Request = class _Request {
-  constructor(event, id, method, path, body) {
+  constructor(event, senderId, id, method, path, body) {
     __publicField(this, "event");
+    __publicField(this, "senderId");
     __publicField(this, "id");
     __publicField(this, "method");
     __publicField(this, "path");
@@ -711,6 +730,7 @@ var _Request = class _Request {
     __publicField(this, "context", RootInjector.createScope());
     __publicField(this, "params", {});
     this.event = event;
+    this.senderId = senderId;
     this.id = id;
     this.method = method;
     this.path = path;
@@ -720,6 +740,23 @@ var _Request = class _Request {
 };
 __name(_Request, "Request");
 var Request = _Request;
+var RENDERER_EVENT_TYPE = "noxus:event";
+function createRendererEventMessage(event, payload) {
+  return {
+    type: RENDERER_EVENT_TYPE,
+    event,
+    payload
+  };
+}
+__name(createRendererEventMessage, "createRendererEventMessage");
+function isRendererEventMessage(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const possibleMessage = value;
+  return possibleMessage.type === RENDERER_EVENT_TYPE && typeof possibleMessage.event === "string";
+}
+__name(isRendererEventMessage, "isRendererEventMessage");
 
 // src/utils/radix-tree.ts
 var _a;
@@ -1029,7 +1066,7 @@ var _Router = class _Router {
       const batchResponses = [];
       for (const [index, item] of payload.requests.entries()) {
         const subRequestId = item.requestId ?? `${request.id}:${index}`;
-        const atomicRequest = new Request(request.event, subRequestId, item.method, item.path, item.body);
+        const atomicRequest = new Request(request.event, request.senderId, subRequestId, item.method, item.path, item.body);
         batchResponses.push(await this.handleAtomic(atomicRequest));
       }
       response.body.responses = batchResponses;
@@ -1238,6 +1275,8 @@ Router = _ts_decorate([
 
 // src/app.ts
 var import_main = require("electron/main");
+
+// src/socket.ts
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -1245,16 +1284,104 @@ function _ts_decorate2(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate2, "_ts_decorate");
+var _NoxSocket = class _NoxSocket {
+  constructor() {
+    __publicField(this, "channels", /* @__PURE__ */ new Map());
+  }
+  register(senderId, requestChannel, socketChannel) {
+    this.channels.set(senderId, {
+      request: requestChannel,
+      socket: socketChannel
+    });
+  }
+  get(senderId) {
+    return this.channels.get(senderId);
+  }
+  unregister(senderId) {
+    this.channels.delete(senderId);
+  }
+  getSenderIds() {
+    return [
+      ...this.channels.keys()
+    ];
+  }
+  emit(eventName, payload, targetSenderIds) {
+    const normalizedEvent = eventName.trim();
+    if (normalizedEvent.length === 0) {
+      throw new Error("Renderer event name must be a non-empty string.");
+    }
+    const recipients = targetSenderIds ?? this.getSenderIds();
+    let delivered = 0;
+    for (const senderId of recipients) {
+      const channel = this.channels.get(senderId);
+      if (!channel) {
+        Logger.warn(`No message channel found for sender ID: ${senderId} while emitting "${normalizedEvent}".`);
+        continue;
+      }
+      try {
+        channel.socket.port1.postMessage(createRendererEventMessage(normalizedEvent, payload));
+        delivered++;
+      } catch (error) {
+        Logger.error(`[Noxus] Failed to emit "${normalizedEvent}" to sender ${senderId}.`, error);
+      }
+    }
+    return delivered;
+  }
+  emitToRenderer(senderId, eventName, payload) {
+    return this.emit(eventName, payload, [
+      senderId
+    ]) > 0;
+  }
+};
+__name(_NoxSocket, "NoxSocket");
+var NoxSocket = _NoxSocket;
+NoxSocket = _ts_decorate2([
+  Injectable("singleton")
+], NoxSocket);
+
+// src/app.ts
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate3, "_ts_decorate");
 function _ts_metadata(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata, "_ts_metadata");
 var _NoxApp = class _NoxApp {
-  constructor(router) {
+  constructor(router, socket) {
     __publicField(this, "router");
-    __publicField(this, "messagePorts", /* @__PURE__ */ new Map());
+    __publicField(this, "socket");
     __publicField(this, "app");
+    /**
+     *
+     */
+    __publicField(this, "onRendererMessage", /* @__PURE__ */ __name(async (event) => {
+      const { senderId, requestId, path, method, body } = event.data;
+      const channels = this.socket.get(senderId);
+      if (!channels) {
+        Logger.error(`No message channel found for sender ID: ${senderId}`);
+        return;
+      }
+      try {
+        const request = new Request(event, senderId, requestId, method, path, body);
+        const response = await this.router.handle(request);
+        channels.request.port1.postMessage(response);
+      } catch (err) {
+        const response = {
+          requestId,
+          status: 500,
+          body: null,
+          error: err.message || "Internal Server Error"
+        };
+        channels.request.port1.postMessage(response);
+      }
+    }, "onRendererMessage"));
     this.router = router;
+    this.socket = socket;
   }
   /**
    * Initializes the NoxApp instance.
@@ -1276,44 +1403,22 @@ var _NoxApp = class _NoxApp {
    */
   giveTheRendererAPort(event) {
     const senderId = event.sender.id;
-    if (this.messagePorts.has(senderId)) {
+    if (this.socket.get(senderId)) {
       this.shutdownChannel(senderId);
     }
-    const channel = new import_main.MessageChannelMain();
-    this.messagePorts.set(senderId, channel);
-    channel.port1.on("message", this.onRendererMessage.bind(this));
-    channel.port1.start();
+    const requestChannel = new import_main.MessageChannelMain();
+    const socketChannel = new import_main.MessageChannelMain();
+    requestChannel.port1.on("message", this.onRendererMessage);
+    requestChannel.port1.start();
+    socketChannel.port1.start();
+    this.socket.register(senderId, requestChannel, socketChannel);
     event.sender.postMessage("port", {
       senderId
     }, [
-      channel.port2
+      requestChannel.port2,
+      socketChannel.port2
     ]);
   }
-  /**
-   * Electron specific message handling.
-   * Replaces HTTP calls by using Electron's IPC mechanism.
-   */
-  async onRendererMessage(event) {
-    const { senderId, requestId, path, method, body } = event.data;
-    const channel = this.messagePorts.get(senderId);
-    if (!channel) {
-      Logger.error(`No message channel found for sender ID: ${senderId}`);
-      return;
-    }
-    try {
-      const request = new Request(event, requestId, method, path, body);
-      const response = await this.router.handle(request);
-      channel.port1.postMessage(response);
-    } catch (err) {
-      const response = {
-        requestId,
-        status: 500,
-        body: null,
-        error: err.message || "Internal Server Error"
-      };
-      channel.port1.postMessage(response);
-    }
-  }
   /**
    * MacOS specific behavior.
    */
@@ -1330,25 +1435,26 @@ var _NoxApp = class _NoxApp {
    * @param remove - Whether to remove the channel from the messagePorts map.
    */
   shutdownChannel(channelSenderId) {
-    const channel = this.messagePorts.get(channelSenderId);
-    if (!channel) {
+    const channels = this.socket.get(channelSenderId);
+    if (!channels) {
       Logger.warn(`No message channel found for sender ID: ${channelSenderId}`);
       return;
     }
-    channel.port1.off("message", this.onRendererMessage.bind(this));
-    channel.port1.close();
-    channel.port2.close();
-    this.messagePorts.delete(channelSenderId);
+    channels.request.port1.off("message", this.onRendererMessage);
+    channels.request.port1.close();
+    channels.request.port2.close();
+    channels.socket.port1.close();
+    channels.socket.port2.close();
+    this.socket.unregister(channelSenderId);
   }
   /**
    * Handles the application shutdown process.
    * This method is called when all windows are closed, and it cleans up the message channels
    */
   async onAllWindowsClosed() {
-    this.messagePorts.forEach((channel, senderId) => {
+    for (const senderId of this.socket.getSenderIds()) {
       this.shutdownChannel(senderId);
-    });
-    this.messagePorts.clear();
+    }
     Logger.info("All windows closed, shutting down application...");
     await this.app?.dispose();
     if (process.platform !== "darwin") {
@@ -1387,11 +1493,12 @@ var _NoxApp = class _NoxApp {
 };
 __name(_NoxApp, "NoxApp");
 var NoxApp = _NoxApp;
-NoxApp = _ts_decorate2([
+NoxApp = _ts_decorate3([
   Injectable("singleton"),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
-    typeof Router === "undefined" ? Object : Router
+    typeof Router === "undefined" ? Object : Router,
+    typeof NoxSocket === "undefined" ? Object : NoxSocket
   ])
 ], NoxApp);
 
@@ -1407,6 +1514,368 @@ async function bootstrapApplication(rootModule) {
   return noxApp;
 }
 __name(bootstrapApplication, "bootstrapApplication");
+
+// src/preload-bridge.ts
+var import_renderer = require("electron/renderer");
+var DEFAULT_EXPOSE_NAME = "noxus";
+var DEFAULT_INIT_EVENT = "init-port";
+var DEFAULT_REQUEST_CHANNEL = "gimme-my-port";
+var DEFAULT_RESPONSE_CHANNEL = "port";
+function exposeNoxusBridge(options = {}) {
+  const { exposeAs = DEFAULT_EXPOSE_NAME, initMessageType = DEFAULT_INIT_EVENT, requestChannel = DEFAULT_REQUEST_CHANNEL, responseChannel = DEFAULT_RESPONSE_CHANNEL, targetWindow = window } = options;
+  const api = {
+    requestPort: /* @__PURE__ */ __name(() => {
+      import_renderer.ipcRenderer.send(requestChannel);
+      import_renderer.ipcRenderer.once(responseChannel, (event, message) => {
+        const ports = (event.ports ?? []).filter((port) => port !== void 0);
+        if (ports.length === 0) {
+          console.error("[Noxus] No MessagePort received from main process.");
+          return;
+        }
+        for (const port of ports) {
+          try {
+            port.start();
+          } catch (error) {
+            console.error("[Noxus] Failed to start MessagePort.", error);
+          }
+        }
+        targetWindow.postMessage({
+          type: initMessageType,
+          senderId: message?.senderId
+        }, "*", ports);
+      });
+    }, "requestPort")
+  };
+  import_renderer.contextBridge.exposeInMainWorld(exposeAs, api);
+  return api;
+}
+__name(exposeNoxusBridge, "exposeNoxusBridge");
+
+// src/renderer-events.ts
+var _RendererEventRegistry = class _RendererEventRegistry {
+  constructor() {
+    __publicField(this, "listeners", /* @__PURE__ */ new Map());
+  }
+  /**
+   *
+   */
+  subscribe(eventName, handler) {
+    const normalizedEventName = eventName.trim();
+    if (normalizedEventName.length === 0) {
+      throw new Error("Renderer event name must be a non-empty string.");
+    }
+    const handlers = this.listeners.get(normalizedEventName) ?? /* @__PURE__ */ new Set();
+    handlers.add(handler);
+    this.listeners.set(normalizedEventName, handlers);
+    return {
+      unsubscribe: /* @__PURE__ */ __name(() => this.unsubscribe(normalizedEventName, handler), "unsubscribe")
+    };
+  }
+  /**
+   *
+   */
+  unsubscribe(eventName, handler) {
+    const handlers = this.listeners.get(eventName);
+    if (!handlers) {
+      return;
+    }
+    handlers.delete(handler);
+    if (handlers.size === 0) {
+      this.listeners.delete(eventName);
+    }
+  }
+  /**
+   *
+   */
+  clear(eventName) {
+    if (eventName) {
+      this.listeners.delete(eventName);
+      return;
+    }
+    this.listeners.clear();
+  }
+  /**
+   *
+   */
+  dispatch(message) {
+    const handlers = this.listeners.get(message.event);
+    if (!handlers || handlers.size === 0) {
+      return;
+    }
+    handlers.forEach((handler) => {
+      try {
+        handler(message.payload);
+      } catch (error) {
+        console.error(`[Noxus] Renderer event handler for "${message.event}" threw an error.`, error);
+      }
+    });
+  }
+  /**
+   *
+   */
+  tryDispatchFromMessageEvent(event) {
+    if (!isRendererEventMessage(event.data)) {
+      return false;
+    }
+    this.dispatch(event.data);
+    return true;
+  }
+  /**
+   *
+   */
+  hasHandlers(eventName) {
+    const handlers = this.listeners.get(eventName);
+    return !!handlers && handlers.size > 0;
+  }
+};
+__name(_RendererEventRegistry, "RendererEventRegistry");
+var RendererEventRegistry = _RendererEventRegistry;
+
+// src/renderer-client.ts
+var DEFAULT_INIT_EVENT2 = "init-port";
+var DEFAULT_BRIDGE_NAMES = [
+  "noxus",
+  "ipcRenderer"
+];
+function defaultRequestId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `${Date.now().toString(16)}-${Math.floor(Math.random() * 1e8).toString(16)}`;
+}
+__name(defaultRequestId, "defaultRequestId");
+function normalizeBridgeNames(preferred) {
+  const names = [];
+  const add = /* @__PURE__ */ __name((name) => {
+    if (!name) return;
+    if (!names.includes(name)) {
+      names.push(name);
+    }
+  }, "add");
+  if (Array.isArray(preferred)) {
+    for (const name of preferred) {
+      add(name);
+    }
+  } else {
+    add(preferred);
+  }
+  for (const fallback of DEFAULT_BRIDGE_NAMES) {
+    add(fallback);
+  }
+  return names;
+}
+__name(normalizeBridgeNames, "normalizeBridgeNames");
+function resolveBridgeFromWindow(windowRef, preferred) {
+  const names = normalizeBridgeNames(preferred);
+  const globalRef = windowRef;
+  if (!globalRef) {
+    return null;
+  }
+  for (const name of names) {
+    const candidate = globalRef[name];
+    if (candidate && typeof candidate.requestPort === "function") {
+      return candidate;
+    }
+  }
+  return null;
+}
+__name(resolveBridgeFromWindow, "resolveBridgeFromWindow");
+var _NoxRendererClient = class _NoxRendererClient {
+  constructor(options = {}) {
+    __publicField(this, "events", new RendererEventRegistry());
+    __publicField(this, "pendingRequests", /* @__PURE__ */ new Map());
+    __publicField(this, "requestPort");
+    __publicField(this, "socketPort");
+    __publicField(this, "senderId");
+    __publicField(this, "bridge");
+    __publicField(this, "initMessageType");
+    __publicField(this, "windowRef");
+    __publicField(this, "generateRequestId");
+    __publicField(this, "isReady", false);
+    __publicField(this, "setupPromise");
+    __publicField(this, "setupResolve");
+    __publicField(this, "setupReject");
+    __publicField(this, "onWindowMessage", /* @__PURE__ */ __name((event) => {
+      if (event.data?.type !== this.initMessageType) {
+        return;
+      }
+      if (!Array.isArray(event.ports) || event.ports.length < 2) {
+        const error = new Error("[Noxus] Renderer expected two MessagePorts (request + socket).");
+        console.error(error);
+        this.setupReject?.(error);
+        this.resetSetupState();
+        return;
+      }
+      this.windowRef.removeEventListener("message", this.onWindowMessage);
+      this.requestPort = event.ports[0];
+      this.socketPort = event.ports[1];
+      this.senderId = event.data.senderId;
+      if (this.requestPort === void 0 || this.socketPort === void 0) {
+        const error = new Error("[Noxus] Renderer failed to receive valid MessagePorts.");
+        console.error(error);
+        this.setupReject?.(error);
+        this.resetSetupState();
+        return;
+      }
+      this.attachRequestPort(this.requestPort);
+      this.attachSocketPort(this.socketPort);
+      this.isReady = true;
+      this.setupResolve?.();
+      this.resetSetupState(true);
+    }, "onWindowMessage"));
+    __publicField(this, "onSocketMessage", /* @__PURE__ */ __name((event) => {
+      if (this.events.tryDispatchFromMessageEvent(event)) {
+        return;
+      }
+      console.warn("[Noxus] Received a socket message that is not a renderer event payload.", event.data);
+    }, "onSocketMessage"));
+    __publicField(this, "onRequestMessage", /* @__PURE__ */ __name((event) => {
+      if (this.events.tryDispatchFromMessageEvent(event)) {
+        return;
+      }
+      const response = event.data;
+      if (!response || typeof response.requestId !== "string") {
+        console.error("[Noxus] Renderer received an invalid response payload.", response);
+        return;
+      }
+      const pending = this.pendingRequests.get(response.requestId);
+      if (!pending) {
+        console.error(`[Noxus] No pending handler found for request ${response.requestId}.`);
+        return;
+      }
+      this.pendingRequests.delete(response.requestId);
+      this.onRequestCompleted(pending, response);
+      if (response.status >= 400) {
+        pending.reject(response);
+        return;
+      }
+      pending.resolve(response.body);
+    }, "onRequestMessage"));
+    this.windowRef = options.windowRef ?? window;
+    const resolvedBridge = options.bridge ?? resolveBridgeFromWindow(this.windowRef, options.bridgeName);
+    this.bridge = resolvedBridge ?? null;
+    this.initMessageType = options.initMessageType ?? DEFAULT_INIT_EVENT2;
+    this.generateRequestId = options.generateRequestId ?? defaultRequestId;
+  }
+  async setup() {
+    if (this.isReady) {
+      return Promise.resolve();
+    }
+    if (this.setupPromise) {
+      return this.setupPromise;
+    }
+    if (!this.bridge || typeof this.bridge.requestPort !== "function") {
+      throw new Error("[Noxus] Renderer bridge is missing requestPort().");
+    }
+    this.setupPromise = new Promise((resolve, reject) => {
+      this.setupResolve = resolve;
+      this.setupReject = reject;
+    });
+    this.windowRef.addEventListener("message", this.onWindowMessage);
+    this.bridge.requestPort();
+    return this.setupPromise;
+  }
+  dispose() {
+    this.windowRef.removeEventListener("message", this.onWindowMessage);
+    this.requestPort?.close();
+    this.socketPort?.close();
+    this.requestPort = void 0;
+    this.socketPort = void 0;
+    this.senderId = void 0;
+    this.isReady = false;
+    this.pendingRequests.clear();
+  }
+  async request(request) {
+    const senderId = this.senderId;
+    const requestId = this.generateRequestId();
+    if (senderId === void 0) {
+      return Promise.reject(this.createErrorResponse(requestId, "MessagePort is not available"));
+    }
+    const readinessError = this.validateReady(requestId);
+    if (readinessError) {
+      return Promise.reject(readinessError);
+    }
+    const message = {
+      requestId,
+      senderId,
+      ...request
+    };
+    return new Promise((resolve, reject) => {
+      const pending = {
+        resolve,
+        reject: /* @__PURE__ */ __name((response) => reject(response), "reject"),
+        request: message,
+        submittedAt: Date.now()
+      };
+      this.pendingRequests.set(message.requestId, pending);
+      this.requestPort.postMessage(message);
+    });
+  }
+  async batch(requests) {
+    return this.request({
+      method: "BATCH",
+      path: "",
+      body: {
+        requests
+      }
+    });
+  }
+  getSenderId() {
+    return this.senderId;
+  }
+  onRequestCompleted(pending, response) {
+    if (typeof console.groupCollapsed === "function") {
+      console.groupCollapsed(`${response.status} ${pending.request.method} /${pending.request.path}`);
+    }
+    if (response.error) {
+      console.error("error message:", response.error);
+    }
+    if (response.body !== void 0) {
+      console.info("response:", response.body);
+    }
+    console.info("request:", pending.request);
+    console.info(`Request duration: ${Date.now() - pending.submittedAt} ms`);
+    if (typeof console.groupCollapsed === "function") {
+      console.groupEnd();
+    }
+  }
+  attachRequestPort(port) {
+    port.onmessage = this.onRequestMessage;
+    port.start();
+  }
+  attachSocketPort(port) {
+    port.onmessage = this.onSocketMessage;
+    port.start();
+  }
+  validateReady(requestId) {
+    if (!this.isElectronEnvironment()) {
+      return this.createErrorResponse(requestId, "Not running in Electron environment");
+    }
+    if (!this.requestPort) {
+      return this.createErrorResponse(requestId, "MessagePort is not available");
+    }
+    return void 0;
+  }
+  createErrorResponse(requestId, message) {
+    return {
+      status: 500,
+      requestId,
+      error: message
+    };
+  }
+  resetSetupState(success = false) {
+    if (!success) {
+      this.setupPromise = void 0;
+    }
+    this.setupResolve = void 0;
+    this.setupReject = void 0;
+  }
+  isElectronEnvironment() {
+    return typeof window !== "undefined" && /Electron/.test(window.navigator.userAgent);
+  }
+};
+__name(_NoxRendererClient, "NoxRendererClient");
+var NoxRendererClient = _NoxRendererClient;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AppInjector,
@@ -1437,11 +1906,15 @@ __name(bootstrapApplication, "bootstrapApplication");
   NotFoundException,
   NotImplementedException,
   NoxApp,
+  NoxRendererClient,
+  NoxSocket,
   Patch,
   PaymentRequiredException,
   Post,
   Put,
+  RENDERER_EVENT_TYPE,
   ROUTE_METADATA_KEY,
+  RendererEventRegistry,
   Request,
   RequestTimeoutException,
   ResponseException,
@@ -1454,6 +1927,8 @@ __name(bootstrapApplication, "bootstrapApplication");
   UseMiddlewares,
   VariantAlsoNegotiatesException,
   bootstrapApplication,
+  createRendererEventMessage,
+  exposeNoxusBridge,
   getControllerMetadata,
   getGuardForController,
   getGuardForControllerAction,
@@ -1462,11 +1937,13 @@ __name(bootstrapApplication, "bootstrapApplication");
   getMiddlewaresForControllerAction,
   getModuleMetadata,
   getRouteMetadata,
-  inject
+  hasInjectableMetadata,
+  inject,
+  isRendererEventMessage
 });
 /**
  * @copyright 2025 NoxFly
  * @license MIT
  * @author NoxFly
  */
-//# sourceMappingURL=noxus.js.map
+//# sourceMappingURL=main.js.map