@noxfly/noxus 3.0.0-dev.0 → 3.0.0-dev.2

package/README.md

@@ -451,26 +451,26 @@ class UserRepository {
 
 ```ts
 // preload.ts
-import { createPreloadBridge } from '@noxfly/noxus';
+import { exposeNoxusBridge } from '@noxfly/noxus/renderer';
 
-createPreloadBridge(); // exposes window.__noxus__ to the renderer
+exposeNoxusBridge(); // exposes window.__noxus__ to the renderer
 ```
 
 ### IPC client
 
 ```ts
 // In the renderer (Angular, React, Vue, Vanilla...)
-import { NoxusClient } from '@noxfly/noxus';
+import { NoxRendererClient } from '@noxfly/noxus';
 
-const client = new NoxusClient();
-await client.connect();
+const client = new NoxRendererClient();
+await client.setup(); // requests the MessagePort from main
 
 // Requests
-const users = await client.get<User[]>('users/list');
-const user  = await client.get<User>('users/42');
-await client.post('users/create', { name: 'Bob' });
-await client.put('users/42', { name: 'Bob Updated' });
-await client.delete('users/42');
+const users  = await client.request<User[]>({ method: 'GET',    path: 'users/list' });
+const user   = await client.request<User>  ({ method: 'GET',    path: 'users/42' });
+await client.request({ method: 'POST',   path: 'users/create',        body: { name: 'Bob' } });
+await client.request({ method: 'PUT',    path: 'users/42',            body: { name: 'Bob Updated' } });
+await client.request({ method: 'DELETE', path: 'users/42' });
 ```
 
 ### Push events (main → renderer)
@@ -495,9 +495,12 @@ class NotificationService {
 On the renderer side:
 
 ```ts
-client.on('notification', (payload) => {
+const sub = client.events.subscribe<INotification>('notification', (payload) => {
     console.log(payload.message);
 });
+
+// Unsubscribe when done
+sub.unsubscribe();
 ```
 
 ---

package/dist/child.d.mts

@@ -1,11 +1,119 @@
-import { L as Lifetime, a as TokenKey } from './app-injector-Bz3Upc0y.mjs';
-export { A as AppInjector, F as ForwardRefFn, b as ForwardReference, I as IBinding, M as MaybeAsync, R as RootInjector, c as Token, T as Type, f as forwardRef, i as inject } from './app-injector-Bz3Upc0y.mjs';
-
 /**
  * @copyright 2025 NoxFly
  * @license MIT
  * @author NoxFly
  */
+interface Type<T> extends Function {
+    new (...args: any[]): T;
+}
+/**
+ * Represents a generic type that can be either a value or a promise resolving to that value.
+ */
+type MaybeAsync<T> = T | Promise<T>;
+
+
+/**
+ * A function that returns a type.
+ * Used for forward references to types that are not yet defined.
+ */
+interface ForwardRefFn<T = any> {
+    (): Type<T>;
+}
+/**
+ * A wrapper class for forward referenced types.
+ */
+declare class ForwardReference<T = any> {
+    readonly forwardRefFn: ForwardRefFn<T>;
+    constructor(forwardRefFn: ForwardRefFn<T>);
+}
+/**
+ * Creates a forward reference to a type.
+ * @param fn A function that returns the type.
+ * @returns A ForwardReference instance.
+ */
+declare function forwardRef<T = any>(fn: ForwardRefFn<T>): ForwardReference<T>;
+
+
+/**
+ * A DI token uniquely identifies a dependency.
+ * It can wrap a class (Type<T>) or be a named symbol token.
+ *
+ * Using tokens instead of reflect-metadata means dependencies are
+ * declared explicitly — no magic type inference, no emitDecoratorMetadata.
+ *
+ * @example
+ * // Class token (most common)
+ * const MY_SERVICE = token(MyService);
+ *
+ * // Named symbol token (for interfaces or non-class values)
+ * const DB_URL = token<string>('DB_URL');
+ */
+declare class Token<T> {
+    readonly target: Type<T> | string;
+    readonly description: string;
+    constructor(target: Type<T> | string);
+    toString(): string;
+}
+/**
+ * The key used to look up a class token in the registry.
+ * For class tokens, the key is the class constructor itself.
+ * For named tokens, the key is the Token instance.
+ */
+type TokenKey<T = unknown> = Type<T> | Token<T>;
+
+
+/**
+ * Lifetime of a binding in the DI container.
+ * - singleton: created once, shared for the lifetime of the app.
+ * - scope:     created once per request scope.
+ * - transient: new instance every time it is resolved.
+ */
+type Lifetime = 'singleton' | 'scope' | 'transient';
+/**
+ * Internal representation of a registered binding.
+ */
+interface IBinding<T = unknown> {
+    lifetime: Lifetime;
+    implementation: Type<T>;
+    /** Explicit constructor dependencies, declared by the class itself. */
+    deps: ReadonlyArray<TokenKey>;
+    instance?: T;
+}
+/**
+ * AppInjector is the core DI container.
+ * It no longer uses reflect-metadata — all dependency information
+ * comes from explicitly declared `deps` arrays on each binding.
+ */
+declare class AppInjector {
+    readonly name: string | null;
+    readonly bindings: Map<Type<unknown> | Token<unknown>, IBinding<unknown>>;
+    readonly singletons: Map<Type<unknown> | Token<unknown>, unknown>;
+    readonly scoped: Map<Type<unknown> | Token<unknown>, unknown>;
+    constructor(name?: string | null);
+    /**
+     * Creates a child scope for per-request lifetime resolution.
+     */
+    createScope(): AppInjector;
+    /**
+     * Registers a binding explicitly.
+     */
+    register<T>(key: TokenKey<T>, implementation: Type<T>, lifetime: Lifetime, deps?: ReadonlyArray<TokenKey>): void;
+    /**
+     * Resolves a dependency by token or class reference.
+     */
+    resolve<T>(target: TokenKey<T> | ForwardReference<T>): T;
+    private _resolveForwardRef;
+    private _instantiate;
+}
+/**
+ * The global root injector. All singletons live here.
+ */
+declare const RootInjector: AppInjector;
+/**
+ * Convenience function: resolve a token from the root injector.
+ */
+declare function inject<T>(t: TokenKey<T> | ForwardReference<T>): T;
+
 declare class ResponseException extends Error {
     readonly status: number;
     constructor(message?: string);
@@ -232,4 +340,4 @@ declare namespace Logger {
     };
 }
 
-export { BadGatewayException, BadRequestException, ConflictException, ForbiddenException, GatewayTimeoutException, HttpVersionNotSupportedException, Injectable, type InjectableOptions, InsufficientStorageException, InternalServerException, Lifetime, type LogLevel, Logger, LoopDetectedException, MethodNotAllowedException, NetworkAuthenticationRequiredException, NetworkConnectTimeoutException, NotAcceptableException, NotExtendedException, NotFoundException, NotImplementedException, PaymentRequiredException, RequestTimeoutException, ResponseException, ServiceUnavailableException, TokenKey, TooManyRequestsException, UnauthorizedException, UpgradeRequiredException, VariantAlsoNegotiatesException };
+export { AppInjector, BadGatewayException, BadRequestException, ConflictException, ForbiddenException, type ForwardRefFn, ForwardReference, GatewayTimeoutException, HttpVersionNotSupportedException, type IBinding, Injectable, type InjectableOptions, InsufficientStorageException, InternalServerException, type Lifetime, type LogLevel, Logger, LoopDetectedException, type MaybeAsync, MethodNotAllowedException, NetworkAuthenticationRequiredException, NetworkConnectTimeoutException, NotAcceptableException, NotExtendedException, NotFoundException, NotImplementedException, PaymentRequiredException, RequestTimeoutException, ResponseException, RootInjector, ServiceUnavailableException, Token, type TokenKey, TooManyRequestsException, type Type, UnauthorizedException, UpgradeRequiredException, VariantAlsoNegotiatesException, forwardRef, inject };

package/dist/child.d.ts

@@ -1,11 +1,119 @@
-import { L as Lifetime, a as TokenKey } from './app-injector-Bz3Upc0y.js';
-export { A as AppInjector, F as ForwardRefFn, b as ForwardReference, I as IBinding, M as MaybeAsync, R as RootInjector, c as Token, T as Type, f as forwardRef, i as inject } from './app-injector-Bz3Upc0y.js';
-
 /**
  * @copyright 2025 NoxFly
  * @license MIT
  * @author NoxFly
  */
+interface Type<T> extends Function {
+    new (...args: any[]): T;
+}
+/**
+ * Represents a generic type that can be either a value or a promise resolving to that value.
+ */
+type MaybeAsync<T> = T | Promise<T>;
+
+
+/**
+ * A function that returns a type.
+ * Used for forward references to types that are not yet defined.
+ */
+interface ForwardRefFn<T = any> {
+    (): Type<T>;
+}
+/**
+ * A wrapper class for forward referenced types.
+ */
+declare class ForwardReference<T = any> {
+    readonly forwardRefFn: ForwardRefFn<T>;
+    constructor(forwardRefFn: ForwardRefFn<T>);
+}
+/**
+ * Creates a forward reference to a type.
+ * @param fn A function that returns the type.
+ * @returns A ForwardReference instance.
+ */
+declare function forwardRef<T = any>(fn: ForwardRefFn<T>): ForwardReference<T>;
+
+
+/**
+ * A DI token uniquely identifies a dependency.
+ * It can wrap a class (Type<T>) or be a named symbol token.
+ *
+ * Using tokens instead of reflect-metadata means dependencies are
+ * declared explicitly — no magic type inference, no emitDecoratorMetadata.
+ *
+ * @example
+ * // Class token (most common)
+ * const MY_SERVICE = token(MyService);
+ *
+ * // Named symbol token (for interfaces or non-class values)
+ * const DB_URL = token<string>('DB_URL');
+ */
+declare class Token<T> {
+    readonly target: Type<T> | string;
+    readonly description: string;
+    constructor(target: Type<T> | string);
+    toString(): string;
+}
+/**
+ * The key used to look up a class token in the registry.
+ * For class tokens, the key is the class constructor itself.
+ * For named tokens, the key is the Token instance.
+ */
+type TokenKey<T = unknown> = Type<T> | Token<T>;
+
+
+/**
+ * Lifetime of a binding in the DI container.
+ * - singleton: created once, shared for the lifetime of the app.
+ * - scope:     created once per request scope.
+ * - transient: new instance every time it is resolved.
+ */
+type Lifetime = 'singleton' | 'scope' | 'transient';
+/**
+ * Internal representation of a registered binding.
+ */
+interface IBinding<T = unknown> {
+    lifetime: Lifetime;
+    implementation: Type<T>;
+    /** Explicit constructor dependencies, declared by the class itself. */
+    deps: ReadonlyArray<TokenKey>;
+    instance?: T;
+}
+/**
+ * AppInjector is the core DI container.
+ * It no longer uses reflect-metadata — all dependency information
+ * comes from explicitly declared `deps` arrays on each binding.
+ */
+declare class AppInjector {
+    readonly name: string | null;
+    readonly bindings: Map<Type<unknown> | Token<unknown>, IBinding<unknown>>;
+    readonly singletons: Map<Type<unknown> | Token<unknown>, unknown>;
+    readonly scoped: Map<Type<unknown> | Token<unknown>, unknown>;
+    constructor(name?: string | null);
+    /**
+     * Creates a child scope for per-request lifetime resolution.
+     */
+    createScope(): AppInjector;
+    /**
+     * Registers a binding explicitly.
+     */
+    register<T>(key: TokenKey<T>, implementation: Type<T>, lifetime: Lifetime, deps?: ReadonlyArray<TokenKey>): void;
+    /**
+     * Resolves a dependency by token or class reference.
+     */
+    resolve<T>(target: TokenKey<T> | ForwardReference<T>): T;
+    private _resolveForwardRef;
+    private _instantiate;
+}
+/**
+ * The global root injector. All singletons live here.
+ */
+declare const RootInjector: AppInjector;
+/**
+ * Convenience function: resolve a token from the root injector.
+ */
+declare function inject<T>(t: TokenKey<T> | ForwardReference<T>): T;
+
 declare class ResponseException extends Error {
     readonly status: number;
     constructor(message?: string);
@@ -232,4 +340,4 @@ declare namespace Logger {
     };
 }
 
-export { BadGatewayException, BadRequestException, ConflictException, ForbiddenException, GatewayTimeoutException, HttpVersionNotSupportedException, Injectable, type InjectableOptions, InsufficientStorageException, InternalServerException, Lifetime, type LogLevel, Logger, LoopDetectedException, MethodNotAllowedException, NetworkAuthenticationRequiredException, NetworkConnectTimeoutException, NotAcceptableException, NotExtendedException, NotFoundException, NotImplementedException, PaymentRequiredException, RequestTimeoutException, ResponseException, ServiceUnavailableException, TokenKey, TooManyRequestsException, UnauthorizedException, UpgradeRequiredException, VariantAlsoNegotiatesException };
+export { AppInjector, BadGatewayException, BadRequestException, ConflictException, ForbiddenException, type ForwardRefFn, ForwardReference, GatewayTimeoutException, HttpVersionNotSupportedException, type IBinding, Injectable, type InjectableOptions, InsufficientStorageException, InternalServerException, type Lifetime, type LogLevel, Logger, LoopDetectedException, type MaybeAsync, MethodNotAllowedException, NetworkAuthenticationRequiredException, NetworkConnectTimeoutException, NotAcceptableException, NotExtendedException, NotFoundException, NotImplementedException, PaymentRequiredException, RequestTimeoutException, ResponseException, RootInjector, ServiceUnavailableException, Token, type TokenKey, TooManyRequestsException, type Type, UnauthorizedException, UpgradeRequiredException, VariantAlsoNegotiatesException, forwardRef, inject };

package/dist/child.js

@@ -129,6 +129,9 @@ var init_app_injector = __esm({
           return this._resolveForwardRef(target);
         }
         const k = keyOf(target);
+        if (this.singletons.has(k)) {
+          return this.singletons.get(k);
+        }
         const binding = this.bindings.get(k);
         if (!binding) {
           const name = target instanceof Token ? target.description : target.name ?? "unknown";
@@ -189,10 +192,10 @@ Did you forget to declare it in @Injectable({ deps }) or in bootstrapApplication
   }
 });
 
-// src/exceptions.ts
+// src/internal/exceptions.ts
 var _ResponseException, ResponseException, _BadRequestException, BadRequestException, _UnauthorizedException, UnauthorizedException, _PaymentRequiredException, PaymentRequiredException, _ForbiddenException, ForbiddenException, _NotFoundException, NotFoundException, _MethodNotAllowedException, MethodNotAllowedException, _NotAcceptableException, NotAcceptableException, _RequestTimeoutException, RequestTimeoutException, _ConflictException, ConflictException, _UpgradeRequiredException, UpgradeRequiredException, _TooManyRequestsException, TooManyRequestsException, _InternalServerException, InternalServerException, _NotImplementedException, NotImplementedException, _BadGatewayException, BadGatewayException, _ServiceUnavailableException, ServiceUnavailableException, _GatewayTimeoutException, GatewayTimeoutException, _HttpVersionNotSupportedException, HttpVersionNotSupportedException, _VariantAlsoNegotiatesException, VariantAlsoNegotiatesException, _InsufficientStorageException, InsufficientStorageException, _LoopDetectedException, LoopDetectedException, _NotExtendedException, NotExtendedException, _NetworkAuthenticationRequiredException, NetworkAuthenticationRequiredException, _NetworkConnectTimeoutException, NetworkConnectTimeoutException;
 var init_exceptions = __esm({
-  "src/exceptions.ts"() {
+  "src/internal/exceptions.ts"() {
     "use strict";
     _ResponseException = class _ResponseException extends Error {
       constructor(statusOrMessage, message) {
@@ -700,30 +703,6 @@ var init_method_decorator = __esm({
   }
 });
 
-// src/request.ts
-var _Request, Request;
-var init_request = __esm({
-  "src/request.ts"() {
-    "use strict";
-    init_app_injector();
-    _Request = class _Request {
-      constructor(event, senderId, id, method, path2, body) {
-        this.event = event;
-        this.senderId = senderId;
-        this.id = id;
-        this.method = method;
-        this.path = path2;
-        this.body = body;
-        this.context = RootInjector.createScope();
-        this.params = {};
-        this.path = path2.replace(/^\/|\/$/g, "");
-      }
-    };
-    __name(_Request, "Request");
-    Request = _Request;
-  }
-});
-
 // src/utils/radix-tree.ts
 var _RadixNode, RadixNode, _RadixTree, RadixTree;
 var init_radix_tree = __esm({
@@ -886,23 +865,47 @@ var init_radix_tree = __esm({
   }
 });
 
-// src/router.ts
+// src/internal/request.ts
+var _Request, Request;
+var init_request = __esm({
+  "src/internal/request.ts"() {
+    "use strict";
+    init_app_injector();
+    _Request = class _Request {
+      constructor(event, senderId, id, method, path2, body) {
+        this.event = event;
+        this.senderId = senderId;
+        this.id = id;
+        this.method = method;
+        this.path = path2;
+        this.body = body;
+        this.context = RootInjector.createScope();
+        this.params = {};
+        this.path = path2.replace(/^\/|\/$/g, "");
+      }
+    };
+    __name(_Request, "Request");
+    Request = _Request;
+  }
+});
+
+// src/internal/router.ts
 var router_exports = {};
 __export(router_exports, {
   Router: () => Router
 });
 var Router;
 var init_router = __esm({
-  "src/router.ts"() {
+  "src/internal/router.ts"() {
     "use strict";
     init_controller_decorator();
     init_injectable_decorator();
     init_method_decorator();
     init_injector_explorer();
-    init_exceptions();
-    init_request();
     init_logger();
     init_radix_tree();
+    init_exceptions();
+    init_request();
     Router = class {
       constructor() {
         this.routes = new RadixTree();

package/dist/child.mjs

@@ -118,6 +118,9 @@ var init_app_injector = __esm({
           return this._resolveForwardRef(target);
         }
         const k = keyOf(target);
+        if (this.singletons.has(k)) {
+          return this.singletons.get(k);
+        }
         const binding = this.bindings.get(k);
         if (!binding) {
           const name = target instanceof Token ? target.description : target.name ?? "unknown";
@@ -178,10 +181,10 @@ Did you forget to declare it in @Injectable({ deps }) or in bootstrapApplication
   }
 });
 
-// src/exceptions.ts
+// src/internal/exceptions.ts
 var _ResponseException, ResponseException, _BadRequestException, BadRequestException, _UnauthorizedException, UnauthorizedException, _PaymentRequiredException, PaymentRequiredException, _ForbiddenException, ForbiddenException, _NotFoundException, NotFoundException, _MethodNotAllowedException, MethodNotAllowedException, _NotAcceptableException, NotAcceptableException, _RequestTimeoutException, RequestTimeoutException, _ConflictException, ConflictException, _UpgradeRequiredException, UpgradeRequiredException, _TooManyRequestsException, TooManyRequestsException, _InternalServerException, InternalServerException, _NotImplementedException, NotImplementedException, _BadGatewayException, BadGatewayException, _ServiceUnavailableException, ServiceUnavailableException, _GatewayTimeoutException, GatewayTimeoutException, _HttpVersionNotSupportedException, HttpVersionNotSupportedException, _VariantAlsoNegotiatesException, VariantAlsoNegotiatesException, _InsufficientStorageException, InsufficientStorageException, _LoopDetectedException, LoopDetectedException, _NotExtendedException, NotExtendedException, _NetworkAuthenticationRequiredException, NetworkAuthenticationRequiredException, _NetworkConnectTimeoutException, NetworkConnectTimeoutException;
 var init_exceptions = __esm({
-  "src/exceptions.ts"() {
+  "src/internal/exceptions.ts"() {
     "use strict";
     _ResponseException = class _ResponseException extends Error {
       constructor(statusOrMessage, message) {
@@ -689,30 +692,6 @@ var init_method_decorator = __esm({
   }
 });
 
-// src/request.ts
-var _Request, Request;
-var init_request = __esm({
-  "src/request.ts"() {
-    "use strict";
-    init_app_injector();
-    _Request = class _Request {
-      constructor(event, senderId, id, method, path2, body) {
-        this.event = event;
-        this.senderId = senderId;
-        this.id = id;
-        this.method = method;
-        this.path = path2;
-        this.body = body;
-        this.context = RootInjector.createScope();
-        this.params = {};
-        this.path = path2.replace(/^\/|\/$/g, "");
-      }
-    };
-    __name(_Request, "Request");
-    Request = _Request;
-  }
-});
-
 // src/utils/radix-tree.ts
 var _RadixNode, RadixNode, _RadixTree, RadixTree;
 var init_radix_tree = __esm({
@@ -875,23 +854,47 @@ var init_radix_tree = __esm({
   }
 });
 
-// src/router.ts
+// src/internal/request.ts
+var _Request, Request;
+var init_request = __esm({
+  "src/internal/request.ts"() {
+    "use strict";
+    init_app_injector();
+    _Request = class _Request {
+      constructor(event, senderId, id, method, path2, body) {
+        this.event = event;
+        this.senderId = senderId;
+        this.id = id;
+        this.method = method;
+        this.path = path2;
+        this.body = body;
+        this.context = RootInjector.createScope();
+        this.params = {};
+        this.path = path2.replace(/^\/|\/$/g, "");
+      }
+    };
+    __name(_Request, "Request");
+    Request = _Request;
+  }
+});
+
+// src/internal/router.ts
 var router_exports = {};
 __export(router_exports, {
   Router: () => Router
 });
 var Router;
 var init_router = __esm({
-  "src/router.ts"() {
+  "src/internal/router.ts"() {
     "use strict";
     init_controller_decorator();
     init_injectable_decorator();
     init_method_decorator();
     init_injector_explorer();
-    init_exceptions();
-    init_request();
     init_logger();
     init_radix_tree();
+    init_exceptions();
+    init_request();
     Router = class {
       constructor() {
         this.routes = new RadixTree();