@noxfly/noxus 1.1.10 → 1.2.0

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

@@ -643,6 +643,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;
@@ -1161,6 +1178,8 @@ Router = _ts_decorate([
 
 // src/app.ts
 import { app, BrowserWindow, ipcMain, MessageChannelMain } from "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);
@@ -1168,16 +1187,98 @@ 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, "messagePorts", /* @__PURE__ */ new Map());
+  }
+  register(senderId, channel) {
+    this.messagePorts.set(senderId, channel);
+  }
+  get(senderId) {
+    return this.messagePorts.get(senderId);
+  }
+  unregister(senderId) {
+    this.messagePorts.delete(senderId);
+  }
+  getSenderIds() {
+    return [
+      ...this.messagePorts.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.messagePorts.get(senderId);
+      if (!channel) {
+        Logger.warn(`No message channel found for sender ID: ${senderId} while emitting "${normalizedEvent}".`);
+        continue;
+      }
+      try {
+        channel.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 channel = this.socket.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);
+      }
+    }, "onRendererMessage"));
     this.router = router;
+    this.socket = socket;
   }
   /**
    * Initializes the NoxApp instance.
@@ -1199,44 +1300,19 @@ 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 MessageChannelMain();
-    this.messagePorts.set(senderId, channel);
-    channel.port1.on("message", this.onRendererMessage.bind(this));
+    channel.port1.on("message", this.onRendererMessage);
     channel.port1.start();
+    this.socket.register(senderId, channel);
     event.sender.postMessage("port", {
       senderId
     }, [
       channel.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.
    */
@@ -1253,25 +1329,24 @@ var _NoxApp = class _NoxApp {
    * @param remove - Whether to remove the channel from the messagePorts map.
    */
   shutdownChannel(channelSenderId) {
-    const channel = this.messagePorts.get(channelSenderId);
+    const channel = this.socket.get(channelSenderId);
     if (!channel) {
       Logger.warn(`No message channel found for sender ID: ${channelSenderId}`);
       return;
     }
-    channel.port1.off("message", this.onRendererMessage.bind(this));
+    channel.port1.off("message", this.onRendererMessage);
     channel.port1.close();
     channel.port2.close();
-    this.messagePorts.delete(channelSenderId);
+    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") {
@@ -1310,11 +1385,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);
 
@@ -1330,6 +1406,86 @@ async function bootstrapApplication(rootModule) {
   return noxApp;
 }
 __name(bootstrapApplication, "bootstrapApplication");
+
+// 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;
 export {
   AppInjector,
   Authorize,
@@ -1359,11 +1515,14 @@ export {
   NotFoundException,
   NotImplementedException,
   NoxApp,
+  NoxSocket,
   Patch,
   PaymentRequiredException,
   Post,
   Put,
+  RENDERER_EVENT_TYPE,
   ROUTE_METADATA_KEY,
+  RendererEventRegistry,
   Request,
   RequestTimeoutException,
   ResponseException,
@@ -1376,6 +1535,7 @@ export {
   UseMiddlewares,
   VariantAlsoNegotiatesException,
   bootstrapApplication,
+  createRendererEventMessage,
   getControllerMetadata,
   getGuardForController,
   getGuardForControllerAction,
@@ -1384,11 +1544,12 @@ export {
   getMiddlewaresForControllerAction,
   getModuleMetadata,
   getRouteMetadata,
-  inject
+  inject,
+  isRendererEventMessage
 };
 /**
  * @copyright 2025 NoxFly
  * @license MIT
  * @author NoxFly
  */
-//# sourceMappingURL=noxus.mjs.map
+//# sourceMappingURL=main.mjs.map

package/dist/renderer.d.mts

@@ -0,0 +1 @@
+export { o as IBatchRequestItem, p as IBatchRequestPayload, q as IBatchResponsePayload, s as IRendererEventMessage, n as IRequest, I as IResponse, r as RENDERER_EVENT_TYPE, v as RendererEventHandler, x as RendererEventRegistry, w as RendererEventSubscription, R as Request, t as createRendererEventMessage, u as isRendererEventMessage } from './index-5OkVPHfI.mjs';

package/dist/renderer.d.ts

@@ -0,0 +1 @@
+export { o as IBatchRequestItem, p as IBatchRequestPayload, q as IBatchResponsePayload, s as IRendererEventMessage, n as IRequest, I as IResponse, r as RENDERER_EVENT_TYPE, v as RendererEventHandler, x as RendererEventRegistry, w as RendererEventSubscription, R as Request, t as createRendererEventMessage, u as isRendererEventMessage } from './index-5OkVPHfI.js';

package/dist/renderer.js

@@ -0,0 +1,265 @@
+/**
+ * @copyright 2025 NoxFly
+ * @license MIT
+ * @author NoxFly
+ */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+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, {
+  RENDERER_EVENT_TYPE: () => RENDERER_EVENT_TYPE,
+  RendererEventRegistry: () => RendererEventRegistry,
+  Request: () => Request,
+  createRendererEventMessage: () => createRendererEventMessage,
+  isRendererEventMessage: () => isRendererEventMessage
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/request.ts
+var import_reflect_metadata2 = require("reflect-metadata");
+
+// src/DI/app-injector.ts
+var import_reflect_metadata = require("reflect-metadata");
+
+// src/exceptions.ts
+var _ResponseException = class _ResponseException extends Error {
+  constructor(statusOrMessage, message) {
+    let statusCode;
+    if (typeof statusOrMessage === "number") {
+      statusCode = statusOrMessage;
+    } else if (typeof statusOrMessage === "string") {
+      message = statusOrMessage;
+    }
+    super(message ?? "");
+    __publicField(this, "status", 0);
+    if (statusCode !== void 0) {
+      this.status = statusCode;
+    }
+    this.name = this.constructor.name.replace(/([A-Z])/g, " $1");
+  }
+};
+__name(_ResponseException, "ResponseException");
+var ResponseException = _ResponseException;
+var _InternalServerException = class _InternalServerException extends ResponseException {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 500);
+  }
+};
+__name(_InternalServerException, "InternalServerException");
+var InternalServerException = _InternalServerException;
+
+// src/DI/app-injector.ts
+var _AppInjector = class _AppInjector {
+  constructor(name = null) {
+    __publicField(this, "name");
+    __publicField(this, "bindings", /* @__PURE__ */ new Map());
+    __publicField(this, "singletons", /* @__PURE__ */ new Map());
+    __publicField(this, "scoped", /* @__PURE__ */ new Map());
+    this.name = name;
+  }
+  /**
+   * Typically used to create a dependency injection scope
+   * at the "scope" level (i.e., per-request lifetime).
+   *
+   * SHOULD NOT BE USED by anything else than the framework itself.
+   */
+  createScope() {
+    const scope = new _AppInjector();
+    scope.bindings = this.bindings;
+    scope.singletons = this.singletons;
+    return scope;
+  }
+  /**
+   * Called when resolving a dependency,
+   * i.e., retrieving the instance of a given class.
+   */
+  resolve(target) {
+    const binding = this.bindings.get(target);
+    if (!binding) throw new InternalServerException(`Failed to resolve a dependency injection : No binding for type ${target.name}.
+Did you forget to use @Injectable() decorator ?`);
+    switch (binding.lifetime) {
+      case "transient":
+        return this.instantiate(binding.implementation);
+      case "scope": {
+        if (this.scoped.has(target)) {
+          return this.scoped.get(target);
+        }
+        const instance = this.instantiate(binding.implementation);
+        this.scoped.set(target, instance);
+        return instance;
+      }
+      case "singleton": {
+        if (binding.instance === void 0 && this.name === "root") {
+          binding.instance = this.instantiate(binding.implementation);
+          this.singletons.set(target, binding.instance);
+        }
+        return binding.instance;
+      }
+    }
+  }
+  /**
+   *
+   */
+  instantiate(target) {
+    const paramTypes = Reflect.getMetadata("design:paramtypes", target) || [];
+    const params = paramTypes.map((p) => this.resolve(p));
+    return new target(...params);
+  }
+};
+__name(_AppInjector, "AppInjector");
+var AppInjector = _AppInjector;
+var RootInjector = new AppInjector("root");
+
+// src/request.ts
+var _Request = class _Request {
+  constructor(event, id, method, path, body) {
+    __publicField(this, "event");
+    __publicField(this, "id");
+    __publicField(this, "method");
+    __publicField(this, "path");
+    __publicField(this, "body");
+    __publicField(this, "context", RootInjector.createScope());
+    __publicField(this, "params", {});
+    this.event = event;
+    this.id = id;
+    this.method = method;
+    this.path = path;
+    this.body = body;
+    this.path = path.replace(/^\/|\/$/g, "");
+  }
+};
+__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/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;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RENDERER_EVENT_TYPE,
+  RendererEventRegistry,
+  Request,
+  createRendererEventMessage,
+  isRendererEventMessage
+});
+/**
+ * @copyright 2025 NoxFly
+ * @license MIT
+ * @author NoxFly
+ */
+//# sourceMappingURL=renderer.js.map