@noxfly/noxus 3.0.0-dev.1 → 3.0.0-dev.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +121 -8
  2. package/dist/child.d.mts +7 -1
  3. package/dist/child.d.ts +7 -1
  4. package/dist/child.js +402 -859
  5. package/dist/child.js.map +1 -0
  6. package/dist/child.mjs +389 -847
  7. package/dist/child.mjs.map +1 -0
  8. package/dist/main.d.mts +173 -125
  9. package/dist/main.d.ts +173 -125
  10. package/dist/main.js +990 -890
  11. package/dist/main.js.map +1 -0
  12. package/dist/main.mjs +939 -840
  13. package/dist/main.mjs.map +1 -0
  14. package/dist/preload.js.map +1 -0
  15. package/dist/preload.mjs.map +1 -0
  16. package/dist/renderer.d.mts +30 -4
  17. package/dist/renderer.d.ts +30 -4
  18. package/dist/renderer.js +163 -116
  19. package/dist/renderer.js.map +1 -0
  20. package/dist/renderer.mjs +152 -104
  21. package/dist/renderer.mjs.map +1 -0
  22. package/package.json +18 -9
  23. package/.editorconfig +0 -16
  24. package/.github/copilot-instructions.md +0 -32
  25. package/.vscode/settings.json +0 -3
  26. package/eslint.config.js +0 -109
  27. package/scripts/postbuild.js +0 -31
  28. package/src/DI/app-injector.ts +0 -151
  29. package/src/DI/injector-explorer.ts +0 -143
  30. package/src/DI/token.ts +0 -53
  31. package/src/decorators/controller.decorator.ts +0 -58
  32. package/src/decorators/guards.decorator.ts +0 -15
  33. package/src/decorators/injectable.decorator.ts +0 -81
  34. package/src/decorators/method.decorator.ts +0 -66
  35. package/src/decorators/middleware.decorator.ts +0 -15
  36. package/src/index.ts +0 -10
  37. package/src/internal/app.ts +0 -217
  38. package/src/internal/bootstrap.ts +0 -108
  39. package/src/internal/exceptions.ts +0 -57
  40. package/src/internal/preload-bridge.ts +0 -75
  41. package/src/internal/renderer-client.ts +0 -338
  42. package/src/internal/renderer-events.ts +0 -110
  43. package/src/internal/request.ts +0 -97
  44. package/src/internal/router.ts +0 -353
  45. package/src/internal/routes.ts +0 -78
  46. package/src/internal/socket.ts +0 -73
  47. package/src/main.ts +0 -26
  48. package/src/non-electron-process.ts +0 -22
  49. package/src/preload.ts +0 -10
  50. package/src/renderer.ts +0 -13
  51. package/src/utils/forward-ref.ts +0 -31
  52. package/src/utils/logger.ts +0 -430
  53. package/src/utils/radix-tree.ts +0 -210
  54. package/src/utils/types.ts +0 -21
  55. package/src/window/window-manager.ts +0 -255
  56. package/tsconfig.json +0 -29
  57. package/tsup.config.ts +0 -50
package/dist/renderer.mjs CHANGED
@@ -4,128 +4,155 @@
4
4
  * @author NoxFly
5
5
  */
6
6
  var __defProp = Object.defineProperty;
7
+ var __getOwnPropNames = Object.getOwnPropertyNames;
7
8
  var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
9
+ var __esm = (fn, res) => function __init() {
10
+ return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
11
+ };
8
12
 
9
13
  // src/utils/forward-ref.ts
10
- var _ForwardReference = class _ForwardReference {
11
- constructor(forwardRefFn) {
12
- this.forwardRefFn = forwardRefFn;
14
+ var _ForwardReference, ForwardReference;
15
+ var init_forward_ref = __esm({
16
+ "src/utils/forward-ref.ts"() {
17
+ "use strict";
18
+ _ForwardReference = class _ForwardReference {
19
+ constructor(forwardRefFn) {
20
+ this.forwardRefFn = forwardRefFn;
21
+ }
22
+ };
23
+ __name(_ForwardReference, "ForwardReference");
24
+ ForwardReference = _ForwardReference;
13
25
  }
14
- };
15
- __name(_ForwardReference, "ForwardReference");
16
- var ForwardReference = _ForwardReference;
26
+ });
17
27
 
18
28
  // src/DI/token.ts
19
- var _Token = class _Token {
20
- constructor(target) {
21
- this.target = target;
22
- this.description = typeof target === "string" ? target : target.name;
23
- }
24
- toString() {
25
- return `Token(${this.description})`;
29
+ var _Token, Token;
30
+ var init_token = __esm({
31
+ "src/DI/token.ts"() {
32
+ "use strict";
33
+ _Token = class _Token {
34
+ constructor(target) {
35
+ this.target = target;
36
+ this.description = typeof target === "string" ? target : target.name;
37
+ }
38
+ toString() {
39
+ return `Token(${this.description})`;
40
+ }
41
+ };
42
+ __name(_Token, "Token");
43
+ Token = _Token;
26
44
  }
27
- };
28
- __name(_Token, "Token");
29
- var Token = _Token;
45
+ });
30
46
 
31
47
  // src/DI/app-injector.ts
32
48
  function keyOf(k) {
33
49
  return k;
34
50
  }
35
- __name(keyOf, "keyOf");
36
- var _AppInjector = class _AppInjector {
37
- constructor(name = null) {
38
- this.name = name;
39
- this.bindings = /* @__PURE__ */ new Map();
40
- this.singletons = /* @__PURE__ */ new Map();
41
- this.scoped = /* @__PURE__ */ new Map();
42
- }
43
- /**
44
- * Creates a child scope for per-request lifetime resolution.
45
- */
46
- createScope() {
47
- const scope = new _AppInjector();
48
- scope.bindings = this.bindings;
49
- scope.singletons = this.singletons;
50
- return scope;
51
- }
52
- /**
53
- * Registers a binding explicitly.
54
- */
55
- register(key, implementation, lifetime, deps = []) {
56
- const k = keyOf(key);
57
- if (!this.bindings.has(k)) {
58
- this.bindings.set(k, { lifetime, implementation, deps });
59
- }
60
- }
61
- /**
62
- * Resolves a dependency by token or class reference.
63
- */
64
- resolve(target) {
65
- if (target instanceof ForwardReference) {
66
- return this._resolveForwardRef(target);
67
- }
68
- const k = keyOf(target);
69
- const binding = this.bindings.get(k);
70
- if (!binding) {
71
- const name = target instanceof Token ? target.description : target.name ?? "unknown";
72
- throw new Error(
73
- `[Noxus DI] No binding found for "${name}".
74
- Did you forget to declare it in @Injectable({ deps }) or in bootstrapApplication({ singletons })?`
75
- );
76
- }
77
- switch (binding.lifetime) {
78
- case "transient":
79
- return this._instantiate(binding);
80
- case "scope": {
81
- if (this.scoped.has(k)) return this.scoped.get(k);
82
- const inst = this._instantiate(binding);
83
- this.scoped.set(k, inst);
84
- return inst;
51
+ var _AppInjector, AppInjector, RootInjector;
52
+ var init_app_injector = __esm({
53
+ "src/DI/app-injector.ts"() {
54
+ "use strict";
55
+ init_forward_ref();
56
+ init_token();
57
+ __name(keyOf, "keyOf");
58
+ _AppInjector = class _AppInjector {
59
+ constructor(name = null) {
60
+ this.name = name;
61
+ this.bindings = /* @__PURE__ */ new Map();
62
+ this.singletons = /* @__PURE__ */ new Map();
63
+ this.scoped = /* @__PURE__ */ new Map();
85
64
  }
86
- case "singleton": {
87
- if (this.singletons.has(k)) return this.singletons.get(k);
88
- const inst = this._instantiate(binding);
89
- this.singletons.set(k, inst);
90
- if (binding.instance === void 0) {
91
- binding.instance = inst;
65
+ /**
66
+ * Creates a child scope for per-request lifetime resolution.
67
+ */
68
+ createScope() {
69
+ const scope = new _AppInjector();
70
+ scope.bindings = this.bindings;
71
+ scope.singletons = this.singletons;
72
+ return scope;
73
+ }
74
+ /**
75
+ * Registers a binding explicitly.
76
+ */
77
+ register(key, implementation, lifetime, deps = []) {
78
+ const k = keyOf(key);
79
+ if (!this.bindings.has(k)) {
80
+ this.bindings.set(k, { lifetime, implementation, deps });
92
81
  }
93
- return inst;
94
82
  }
95
- }
96
- }
97
- // -------------------------------------------------------------------------
98
- _resolveForwardRef(ref) {
99
- return new Proxy({}, {
100
- get: /* @__PURE__ */ __name((_obj, prop, receiver) => {
101
- const realType = ref.forwardRefFn();
102
- const instance = this.resolve(realType);
103
- const value = Reflect.get(instance, prop, receiver);
104
- return typeof value === "function" ? value.bind(instance) : value;
105
- }, "get"),
106
- set: /* @__PURE__ */ __name((_obj, prop, value, receiver) => {
107
- const realType = ref.forwardRefFn();
108
- const instance = this.resolve(realType);
109
- return Reflect.set(instance, prop, value, receiver);
110
- }, "set"),
111
- getPrototypeOf: /* @__PURE__ */ __name(() => {
112
- const realType = ref.forwardRefFn();
113
- return realType.prototype;
114
- }, "getPrototypeOf")
115
- });
116
- }
117
- _instantiate(binding) {
118
- const resolvedDeps = binding.deps.map((dep) => this.resolve(dep));
119
- return new binding.implementation(...resolvedDeps);
83
+ /**
84
+ * Resolves a dependency by token or class reference.
85
+ */
86
+ resolve(target) {
87
+ if (target instanceof ForwardReference) {
88
+ return this._resolveForwardRef(target);
89
+ }
90
+ const k = keyOf(target);
91
+ if (this.singletons.has(k)) {
92
+ return this.singletons.get(k);
93
+ }
94
+ const binding = this.bindings.get(k);
95
+ if (!binding) {
96
+ const name = target instanceof Token ? target.description : target.name ?? "unknown";
97
+ throw new Error(
98
+ `[Noxus DI] No binding found for "${name}".
99
+ Did you forget to declare it in @Injectable({ deps }) or in bootstrapApplication({ singletons })?`
100
+ );
101
+ }
102
+ switch (binding.lifetime) {
103
+ case "transient":
104
+ return this._instantiate(binding);
105
+ case "scope": {
106
+ if (this.scoped.has(k)) return this.scoped.get(k);
107
+ const inst = this._instantiate(binding);
108
+ this.scoped.set(k, inst);
109
+ return inst;
110
+ }
111
+ case "singleton": {
112
+ if (this.singletons.has(k)) return this.singletons.get(k);
113
+ const inst = this._instantiate(binding);
114
+ this.singletons.set(k, inst);
115
+ if (binding.instance === void 0) {
116
+ binding.instance = inst;
117
+ }
118
+ return inst;
119
+ }
120
+ }
121
+ }
122
+ // -------------------------------------------------------------------------
123
+ _resolveForwardRef(ref) {
124
+ let resolved;
125
+ return new Proxy({}, {
126
+ get: /* @__PURE__ */ __name((_obj, prop, receiver) => {
127
+ resolved ?? (resolved = this.resolve(ref.forwardRefFn()));
128
+ const value = Reflect.get(resolved, prop, receiver);
129
+ return typeof value === "function" ? value.bind(resolved) : value;
130
+ }, "get"),
131
+ set: /* @__PURE__ */ __name((_obj, prop, value, receiver) => {
132
+ resolved ?? (resolved = this.resolve(ref.forwardRefFn()));
133
+ return Reflect.set(resolved, prop, value, receiver);
134
+ }, "set"),
135
+ getPrototypeOf: /* @__PURE__ */ __name(() => {
136
+ resolved ?? (resolved = this.resolve(ref.forwardRefFn()));
137
+ return Object.getPrototypeOf(resolved);
138
+ }, "getPrototypeOf")
139
+ });
140
+ }
141
+ _instantiate(binding) {
142
+ const resolvedDeps = binding.deps.map((dep) => this.resolve(dep));
143
+ return new binding.implementation(...resolvedDeps);
144
+ }
145
+ };
146
+ __name(_AppInjector, "AppInjector");
147
+ AppInjector = _AppInjector;
148
+ RootInjector = new AppInjector("root");
120
149
  }
121
- };
122
- __name(_AppInjector, "AppInjector");
123
- var AppInjector = _AppInjector;
124
- var RootInjector = new AppInjector("root");
150
+ });
125
151
 
126
152
  // src/internal/request.ts
153
+ init_app_injector();
127
154
  var _Request = class _Request {
128
- constructor(event, senderId, id, method, path, body) {
155
+ constructor(event, senderId, id, method, path, body, query) {
129
156
  this.event = event;
130
157
  this.senderId = senderId;
131
158
  this.id = id;
@@ -135,6 +162,7 @@ var _Request = class _Request {
135
162
  this.context = RootInjector.createScope();
136
163
  this.params = {};
137
164
  this.path = path.replace(/^\/|\/$/g, "");
165
+ this.query = query ?? {};
138
166
  }
139
167
  };
140
168
  __name(_Request, "Request");
@@ -337,6 +365,9 @@ var _NoxRendererClient = class _NoxRendererClient {
337
365
  console.error(`[Noxus] No pending handler found for request ${response.requestId}.`);
338
366
  return;
339
367
  }
368
+ if (pending.timer !== void 0) {
369
+ clearTimeout(pending.timer);
370
+ }
340
371
  this.pendingRequests.delete(response.requestId);
341
372
  this.onRequestCompleted(pending, response);
342
373
  if (response.status >= 400) {
@@ -350,6 +381,8 @@ var _NoxRendererClient = class _NoxRendererClient {
350
381
  this.bridge = resolvedBridge ?? null;
351
382
  this.initMessageType = options.initMessageType ?? DEFAULT_INIT_EVENT;
352
383
  this.generateRequestId = options.generateRequestId ?? defaultRequestId;
384
+ this.requestTimeout = options.requestTimeout ?? 1e4;
385
+ this.enableLogging = options.enableLogging ?? true;
353
386
  }
354
387
  async setup() {
355
388
  if (this.isReady) {
@@ -377,9 +410,14 @@ var _NoxRendererClient = class _NoxRendererClient {
377
410
  this.socketPort = void 0;
378
411
  this.senderId = void 0;
379
412
  this.isReady = false;
413
+ for (const pending of this.pendingRequests.values()) {
414
+ if (pending.timer !== void 0) {
415
+ clearTimeout(pending.timer);
416
+ }
417
+ }
380
418
  this.pendingRequests.clear();
381
419
  }
382
- async request(request) {
420
+ async request(request, options) {
383
421
  const senderId = this.senderId;
384
422
  const requestId = this.generateRequestId();
385
423
  if (senderId === void 0) {
@@ -394,6 +432,7 @@ var _NoxRendererClient = class _NoxRendererClient {
394
432
  senderId,
395
433
  ...request
396
434
  };
435
+ const effectiveTimeout = options?.timeout ?? this.requestTimeout;
397
436
  return new Promise((resolve, reject) => {
398
437
  const pending = {
399
438
  resolve,
@@ -401,6 +440,12 @@ var _NoxRendererClient = class _NoxRendererClient {
401
440
  request: message,
402
441
  submittedAt: Date.now()
403
442
  };
443
+ if (effectiveTimeout > 0) {
444
+ pending.timer = setTimeout(() => {
445
+ this.pendingRequests.delete(message.requestId);
446
+ reject(this.createErrorResponse(message.requestId, `Request timed out after ${effectiveTimeout}ms`));
447
+ }, effectiveTimeout);
448
+ }
404
449
  this.pendingRequests.set(message.requestId, pending);
405
450
  this.requestPort.postMessage(message);
406
451
  });
@@ -418,6 +463,9 @@ var _NoxRendererClient = class _NoxRendererClient {
418
463
  return this.senderId;
419
464
  }
420
465
  onRequestCompleted(pending, response) {
466
+ if (!this.enableLogging) {
467
+ return;
468
+ }
421
469
  if (typeof console.groupCollapsed === "function") {
422
470
  console.groupCollapsed(`${response.status} ${pending.request.method} /${pending.request.path}`);
423
471
  }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils/forward-ref.ts","../src/DI/token.ts","../src/DI/app-injector.ts","../src/internal/request.ts","../src/internal/renderer-events.ts","../src/internal/renderer-client.ts"],"sourcesContent":["/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\nimport { Type } from \"./types\";\r\n\r\n/**\r\n * A function that returns a type.\r\n * Used for forward references to types that are not yet defined.\r\n */\r\nexport interface ForwardRefFn<T = any> {\r\n (): Type<T>;\r\n}\r\n\r\n/**\r\n * A wrapper class for forward referenced types.\r\n */\r\nexport class ForwardReference<T = any> {\r\n constructor(public readonly forwardRefFn: ForwardRefFn<T>) {}\r\n}\r\n\r\n/**\r\n * Creates a forward reference to a type.\r\n * @param fn A function that returns the type.\r\n * @returns A ForwardReference instance.\r\n */\r\nexport function forwardRef<T = any>(fn: ForwardRefFn<T>): ForwardReference<T> {\r\n return new ForwardReference(fn);\r\n}\r\n","/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\nimport { Type } from '../utils/types';\r\n\r\n/**\r\n * A DI token uniquely identifies a dependency.\r\n * It can wrap a class (Type<T>) or be a named symbol token.\r\n *\r\n * Using tokens instead of reflect-metadata means dependencies are\r\n * declared explicitly — no magic type inference, no emitDecoratorMetadata.\r\n *\r\n * @example\r\n * // Class token (most common)\r\n * const MY_SERVICE = token(MyService);\r\n *\r\n * // Named symbol token (for interfaces or non-class values)\r\n * const DB_URL = token<string>('DB_URL');\r\n */\r\nexport class Token<T> {\r\n public readonly description: string;\r\n\r\n constructor(\r\n public readonly target: Type<T> | string,\r\n ) {\r\n this.description = typeof target === 'string' ? target : target.name;\r\n }\r\n\r\n public toString(): string {\r\n return `Token(${this.description})`;\r\n }\r\n}\r\n\r\n/**\r\n * Creates a DI token for a class type or a named value.\r\n *\r\n * @example\r\n * export const MY_SERVICE = token(MyService);\r\n * export const DB_URL = token<string>('DB_URL');\r\n */\r\nexport function token<T>(target: Type<T> | string): Token<T> {\r\n return new Token<T>(target);\r\n}\r\n\r\n/**\r\n * The key used to look up a class token in the registry.\r\n * For class tokens, the key is the class constructor itself.\r\n * For named tokens, the key is the Token instance.\r\n */\r\nexport type TokenKey<T = unknown> = Type<T> | Token<T>;\r\n","/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\nimport { ForwardReference } from '../utils/forward-ref';\r\nimport { Type } from '../utils/types';\r\nimport { Token, TokenKey } from './token';\r\n\r\n/**\r\n * Lifetime of a binding in the DI container.\r\n * - singleton: created once, shared for the lifetime of the app.\r\n * - scope: created once per request scope.\r\n * - transient: new instance every time it is resolved.\r\n */\r\nexport type Lifetime = 'singleton' | 'scope' | 'transient';\r\n\r\n/**\r\n * Internal representation of a registered binding.\r\n */\r\nexport interface IBinding<T = unknown> {\r\n lifetime: Lifetime;\r\n implementation: Type<T>;\r\n /** Explicit constructor dependencies, declared by the class itself. */\r\n deps: ReadonlyArray<TokenKey>;\r\n instance?: T;\r\n}\r\n\r\nfunction keyOf<T>(k: TokenKey<T>): Type<T> | Token<T> {\r\n return k;\r\n}\r\n\r\n/**\r\n * AppInjector is the core DI container.\r\n * It no longer uses reflect-metadata — all dependency information\r\n * comes from explicitly declared `deps` arrays on each binding.\r\n */\r\nexport class AppInjector {\r\n public readonly bindings = new Map<Type<unknown> | Token<unknown>, IBinding<unknown>>();\r\n public readonly singletons = new Map<Type<unknown> | Token<unknown>, unknown>();\r\n public readonly scoped = new Map<Type<unknown> | Token<unknown>, unknown>();\r\n\r\n constructor(public readonly name: string | null = null) {}\r\n\r\n /**\r\n * Creates a child scope for per-request lifetime resolution.\r\n */\r\n public createScope(): AppInjector {\r\n const scope = new AppInjector();\r\n (scope as any).bindings = this.bindings;\r\n (scope as any).singletons = this.singletons;\r\n return scope;\r\n }\r\n\r\n /**\r\n * Registers a binding explicitly.\r\n */\r\n public register<T>(\r\n key: TokenKey<T>,\r\n implementation: Type<T>,\r\n lifetime: Lifetime,\r\n deps: ReadonlyArray<TokenKey> = [],\r\n ): void {\r\n const k = keyOf(key) as TokenKey<unknown>;\r\n if (!this.bindings.has(k)) {\r\n this.bindings.set(k, { lifetime, implementation: implementation as Type<unknown>, deps });\r\n }\r\n }\r\n\r\n /**\r\n * Resolves a dependency by token or class reference.\r\n */\r\n public resolve<T>(target: TokenKey<T> | ForwardReference<T>): T {\r\n if (target instanceof ForwardReference) {\r\n return this._resolveForwardRef(target);\r\n }\r\n\r\n const k = keyOf(target) as TokenKey<unknown>;\r\n\r\n if (this.singletons.has(k)) {\r\n return this.singletons.get(k) as T;\r\n }\r\n\r\n const binding = this.bindings.get(k);\r\n\r\n if (!binding) {\r\n const name = target instanceof Token\r\n ? target.description\r\n : (target as Type<unknown>).name\r\n ?? 'unknown';\r\n\r\n throw new Error(\r\n `[Noxus DI] No binding found for \"${name}\".\\n`\r\n + `Did you forget to declare it in @Injectable({ deps }) or in bootstrapApplication({ singletons })?`,\r\n );\r\n }\r\n\r\n switch (binding.lifetime) {\r\n case 'transient':\r\n return this._instantiate(binding) as T;\r\n\r\n case 'scope': {\r\n if (this.scoped.has(k)) return this.scoped.get(k) as T;\r\n const inst = this._instantiate(binding);\r\n this.scoped.set(k, inst);\r\n return inst as T;\r\n }\r\n\r\n case 'singleton': {\r\n if (this.singletons.has(k)) return this.singletons.get(k) as T;\r\n const inst = this._instantiate(binding);\r\n this.singletons.set(k, inst);\r\n if (binding.instance === undefined) {\r\n (binding as IBinding<unknown>).instance = inst as unknown;\r\n }\r\n return inst as T;\r\n }\r\n }\r\n }\r\n\r\n // -------------------------------------------------------------------------\r\n\r\n private _resolveForwardRef<T>(ref: ForwardReference<T>): T {\r\n let resolved: T | undefined;\r\n return new Proxy({} as object, {\r\n get: (_obj, prop, receiver) => {\r\n resolved ??= this.resolve(ref.forwardRefFn()) as T;\r\n const value = Reflect.get(resolved as object, prop, receiver);\r\n return typeof value === 'function' ? (value as Function).bind(resolved) : value;\r\n },\r\n set: (_obj, prop, value, receiver) => {\r\n resolved ??= this.resolve(ref.forwardRefFn()) as T;\r\n return Reflect.set(resolved as object, prop, value, receiver);\r\n },\r\n getPrototypeOf: () => {\r\n resolved ??= this.resolve(ref.forwardRefFn()) as T;\r\n return Object.getPrototypeOf(resolved);\r\n },\r\n }) as T;\r\n }\r\n\r\n private _instantiate<T>(binding: IBinding<T>): T {\r\n const resolvedDeps = binding.deps.map((dep) => this.resolve(dep));\r\n return new binding.implementation(...resolvedDeps) as T;\r\n }\r\n}\r\n\r\n/**\r\n * The global root injector. All singletons live here.\r\n */\r\nexport const RootInjector = new AppInjector('root');\r\n\r\n/**\r\n * Resets the root injector to a clean state.\r\n * **Intended for testing only** — clears all bindings, singletons, and scoped instances\r\n * so that each test can start from a fresh DI container without restarting the process.\r\n */\r\nexport function resetRootInjector(): void {\r\n RootInjector.bindings.clear();\r\n RootInjector.singletons.clear();\r\n RootInjector.scoped.clear();\r\n // Lazy import to avoid circular dependency (InjectorExplorer → app-injector → InjectorExplorer)\r\n const { InjectorExplorer } = require('./injector-explorer') as typeof import('./injector-explorer');\r\n InjectorExplorer.reset();\r\n}\r\n\r\n/**\r\n * Convenience function: resolve a token from the root injector.\r\n */\r\nexport function inject<T>(t: TokenKey<T> | ForwardReference<T>): T {\r\n return RootInjector.resolve(t);\r\n}\r\n","/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\n\r\nimport { AtomicHttpMethod, HttpMethod } from '../decorators/method.decorator';\r\nimport { AppInjector, RootInjector } from '../DI/app-injector';\r\n\r\n/**\r\n * The Request class represents an HTTP request in the Noxus framework.\r\n * It encapsulates the request data, including the event, ID, method, path, and body.\r\n * It also provides a context for dependency injection through the AppInjector.\r\n */\r\nexport class Request {\r\n public readonly context: AppInjector = RootInjector.createScope();\r\n\r\n public readonly params: Record<string, string> = {};\r\n public readonly query: Record<string, unknown>;\r\n\r\n constructor(\r\n public readonly event: Electron.MessageEvent,\r\n public readonly senderId: number,\r\n public readonly id: string,\r\n public readonly method: HttpMethod,\r\n public readonly path: string,\r\n public readonly body: unknown,\r\n query?: Record<string, unknown>,\r\n ) {\r\n this.path = path.replace(/^\\/|\\/$/g, '');\r\n this.query = query ?? {};\r\n }\r\n}\r\n\r\n/**\r\n * The IRequest interface defines the structure of a request object.\r\n * It includes properties for the sender ID, request ID, path, method, and an optional body.\r\n * This interface is used to standardize the request data across the application.\r\n */\r\nexport interface IRequest<TBody = unknown> {\r\n senderId: number;\r\n requestId: string;\r\n path: string;\r\n method: HttpMethod;\r\n body?: TBody;\r\n query?: Record<string, unknown>;\r\n}\r\n\r\nexport interface IBatchRequestItem<TBody = unknown> {\r\n requestId?: string;\r\n path: string;\r\n method: AtomicHttpMethod;\r\n body?: TBody;\r\n query?: Record<string, unknown>;\r\n}\r\n\r\nexport interface IBatchRequestPayload {\r\n requests: IBatchRequestItem[];\r\n}\r\n\r\n/**\r\n * Creates a Request object from the IPC event data.\r\n * This function extracts the necessary information from the IPC event and constructs a Request instance.\r\n */\r\nexport interface IResponse<TBody = unknown> {\r\n requestId: string;\r\n status: number;\r\n body?: TBody;\r\n error?: string;\r\n stack?: string;\r\n}\r\n\r\nexport interface IBatchResponsePayload {\r\n responses: IResponse[];\r\n}\r\n\r\nexport const RENDERER_EVENT_TYPE = 'noxus:event';\r\n\r\nexport interface IRendererEventMessage<TPayload = unknown> {\r\n type: typeof RENDERER_EVENT_TYPE;\r\n event: string;\r\n payload?: TPayload;\r\n}\r\n\r\nexport function createRendererEventMessage<TPayload = unknown>(event: string, payload?: TPayload): IRendererEventMessage<TPayload> {\r\n return {\r\n type: RENDERER_EVENT_TYPE,\r\n event,\r\n payload,\r\n };\r\n}\r\n\r\nexport function isRendererEventMessage(value: unknown): value is IRendererEventMessage {\r\n if(value === null || typeof value !== 'object') {\r\n return false;\r\n }\r\n\r\n const possibleMessage = value as Partial<IRendererEventMessage>;\r\n\r\n return possibleMessage.type === RENDERER_EVENT_TYPE && typeof possibleMessage.event === 'string';\r\n}\r\n","/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\n/**\r\n * Lightweight event registry to help renderer processes subscribe to\r\n * push messages sent by the main process through Noxus.\r\n */\r\nimport { IRendererEventMessage, isRendererEventMessage } from './request';\r\n\r\nexport type RendererEventHandler<TPayload = unknown> = (payload: TPayload) => void;\r\n\r\nexport interface RendererEventSubscription {\r\n unsubscribe(): void;\r\n}\r\n\r\nexport class RendererEventRegistry {\r\n private readonly listeners = new Map<string, Set<RendererEventHandler>>();\r\n\r\n /**\r\n *\r\n */\r\n public subscribe<TPayload>(eventName: string, handler: RendererEventHandler<TPayload>): RendererEventSubscription {\r\n const normalizedEventName = eventName.trim();\r\n\r\n if(normalizedEventName.length === 0) {\r\n throw new Error('Renderer event name must be a non-empty string.');\r\n }\r\n\r\n const handlers = this.listeners.get(normalizedEventName) ?? new Set<RendererEventHandler>();\r\n\r\n handlers.add(handler as RendererEventHandler);\r\n this.listeners.set(normalizedEventName, handlers);\r\n\r\n return {\r\n unsubscribe: () => this.unsubscribe(normalizedEventName, handler as RendererEventHandler),\r\n };\r\n }\r\n\r\n /**\r\n *\r\n */\r\n public unsubscribe<TPayload>(eventName: string, handler: RendererEventHandler<TPayload>): void {\r\n const handlers = this.listeners.get(eventName);\r\n\r\n if(!handlers) {\r\n return;\r\n }\r\n\r\n handlers.delete(handler as RendererEventHandler);\r\n\r\n if(handlers.size === 0) {\r\n this.listeners.delete(eventName);\r\n }\r\n }\r\n\r\n /**\r\n *\r\n */\r\n public clear(eventName?: string): void {\r\n if(eventName) {\r\n this.listeners.delete(eventName);\r\n return;\r\n }\r\n\r\n this.listeners.clear();\r\n }\r\n\r\n /**\r\n *\r\n */\r\n public dispatch<TPayload>(message: IRendererEventMessage<TPayload>): void {\r\n const handlers = this.listeners.get(message.event);\r\n\r\n if(!handlers || handlers.size === 0) {\r\n return;\r\n }\r\n\r\n handlers.forEach((handler) => {\r\n try {\r\n handler(message.payload as TPayload);\r\n }\r\n catch(error) {\r\n console.error(`[Noxus] Renderer event handler for \"${message.event}\" threw an error.`, error);\r\n }\r\n });\r\n }\r\n\r\n /**\r\n *\r\n */\r\n public tryDispatchFromMessageEvent(event: MessageEvent): boolean {\r\n if(!isRendererEventMessage(event.data)) {\r\n return false;\r\n }\r\n\r\n this.dispatch(event.data);\r\n return true;\r\n }\r\n\r\n /**\r\n *\r\n */\r\n public hasHandlers(eventName: string): boolean {\r\n const handlers = this.listeners.get(eventName);\r\n return !!handlers && handlers.size > 0;\r\n }\r\n}\r\n","/**\r\n * @copyright 2025 NoxFly\r\n * @license MIT\r\n * @author NoxFly\r\n */\r\n\r\nimport { IBatchRequestItem, IBatchResponsePayload, IRequest, IResponse } from './request';\r\nimport { RendererEventRegistry } from './renderer-events';\r\n\r\nexport interface IPortRequester {\r\n requestPort(): void;\r\n}\r\n\r\n/**\r\n * Per-request options that can override global client defaults.\r\n */\r\nexport interface RequestOptions {\r\n /**\r\n * Timeout in milliseconds for this specific request.\r\n * Overrides the global `requestTimeout` set on the client.\r\n * Set to 0 to disable timeout for this request.\r\n */\r\n timeout?: number;\r\n}\r\n\r\nexport interface RendererClientOptions {\r\n bridge?: IPortRequester | null;\r\n bridgeName?: string | string[];\r\n initMessageType?: string;\r\n windowRef?: Window;\r\n generateRequestId?: () => string;\r\n /**\r\n * Timeout in milliseconds for IPC requests.\r\n * If the main process does not respond within this duration,\r\n * the request Promise is rejected and the pending entry cleaned up.\r\n * Defaults to 10 000 ms. Set to 0 to disable.\r\n */\r\n requestTimeout?: number;\r\n /** @default true */\r\n enableLogging?: boolean;\r\n}\r\n\r\ninterface PendingRequest<T = unknown> {\r\n resolve: (value: T) => void;\r\n reject: (reason: IResponse<T>) => void;\r\n request: IRequest;\r\n submittedAt: number;\r\n timer?: ReturnType<typeof setTimeout>;\r\n}\r\n\r\nconst DEFAULT_INIT_EVENT = 'init-port';\r\nconst DEFAULT_BRIDGE_NAMES = ['noxus', 'ipcRenderer'];\r\n\r\nfunction defaultRequestId(): string {\r\n if(typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\r\n return crypto.randomUUID();\r\n }\r\n\r\n return `${Date.now().toString(16)}-${Math.floor(Math.random() * 1e8).toString(16)}`;\r\n}\r\n\r\nfunction normalizeBridgeNames(preferred?: string | string[]): string[] {\r\n const names: string[] = [];\r\n\r\n const add = (name: string | undefined): void => {\r\n if(!name)\r\n return;\r\n\r\n if(!names.includes(name)) {\r\n names.push(name);\r\n }\r\n };\r\n\r\n if(Array.isArray(preferred)) {\r\n for(const name of preferred) {\r\n add(name);\r\n }\r\n }\r\n else {\r\n add(preferred);\r\n }\r\n\r\n for(const fallback of DEFAULT_BRIDGE_NAMES) {\r\n add(fallback);\r\n }\r\n\r\n return names;\r\n}\r\n\r\nfunction resolveBridgeFromWindow(windowRef: Window, preferred?: string | string[]): IPortRequester | null {\r\n const names = normalizeBridgeNames(preferred);\r\n const globalRef = windowRef as unknown as Record<string, unknown> | null | undefined;\r\n\r\n if(!globalRef) {\r\n return null;\r\n }\r\n\r\n for(const name of names) {\r\n const candidate = globalRef[name];\r\n\r\n if(candidate && typeof (candidate as IPortRequester).requestPort === 'function') {\r\n return candidate as IPortRequester;\r\n }\r\n }\r\n\r\n return null;\r\n}\r\n\r\nexport class NoxRendererClient {\r\n public readonly events = new RendererEventRegistry();\r\n\r\n protected readonly pendingRequests = new Map<string, PendingRequest>();\r\n\r\n protected requestPort: MessagePort | undefined;\r\n protected socketPort: MessagePort | undefined;\r\n protected senderId: number | undefined;\r\n\r\n private readonly bridge: IPortRequester | null;\r\n private readonly initMessageType: string;\r\n private readonly windowRef: Window;\r\n private readonly generateRequestId: () => string;\r\n private readonly requestTimeout: number;\r\n\r\n private isReady = false;\r\n private setupPromise: Promise<void> | undefined;\r\n private setupResolve: (() => void) | undefined;\r\n private setupReject: ((reason: Error) => void) | undefined;\r\n\r\n private enableLogging: boolean;\r\n\r\n constructor(options: RendererClientOptions = {}) {\r\n this.windowRef = options.windowRef ?? window;\r\n const resolvedBridge = options.bridge ?? resolveBridgeFromWindow(this.windowRef, options.bridgeName);\r\n this.bridge = resolvedBridge ?? null;\r\n this.initMessageType = options.initMessageType ?? DEFAULT_INIT_EVENT;\r\n this.generateRequestId = options.generateRequestId ?? defaultRequestId;\r\n this.requestTimeout = options.requestTimeout ?? 10_000;\r\n this.enableLogging = options.enableLogging ?? true;\r\n }\r\n\r\n public async setup(): Promise<void> {\r\n if(this.isReady) {\r\n return Promise.resolve();\r\n }\r\n\r\n if(this.setupPromise) {\r\n return this.setupPromise;\r\n }\r\n\r\n if(!this.bridge || typeof this.bridge.requestPort !== 'function') {\r\n throw new Error('[Noxus] Renderer bridge is missing requestPort().');\r\n }\r\n\r\n this.setupPromise = new Promise<void>((resolve, reject) => {\r\n this.setupResolve = resolve;\r\n this.setupReject = reject;\r\n });\r\n\r\n this.windowRef.addEventListener('message', this.onWindowMessage);\r\n this.bridge.requestPort();\r\n\r\n return this.setupPromise;\r\n }\r\n\r\n public dispose(): void {\r\n this.windowRef.removeEventListener('message', this.onWindowMessage);\r\n\r\n this.requestPort?.close();\r\n this.socketPort?.close();\r\n\r\n this.requestPort = undefined;\r\n this.socketPort = undefined;\r\n this.senderId = undefined;\r\n this.isReady = false;\r\n\r\n for(const pending of this.pendingRequests.values()) {\r\n if(pending.timer !== undefined) {\r\n clearTimeout(pending.timer);\r\n }\r\n }\r\n\r\n this.pendingRequests.clear();\r\n }\r\n\r\n public async request<TResponse, TBody = unknown>(\r\n request: Omit<IRequest<TBody>, 'requestId' | 'senderId'>,\r\n options?: RequestOptions,\r\n ): Promise<TResponse> {\r\n const senderId = this.senderId;\r\n const requestId = this.generateRequestId();\r\n\r\n if(senderId === undefined) {\r\n return Promise.reject(this.createErrorResponse(requestId, 'MessagePort is not available'));\r\n }\r\n\r\n const readinessError = this.validateReady(requestId);\r\n\r\n if(readinessError) {\r\n return Promise.reject(readinessError as IResponse<TResponse>);\r\n }\r\n\r\n const message: IRequest<TBody> = {\r\n requestId,\r\n senderId,\r\n ...request,\r\n };\r\n\r\n const effectiveTimeout = options?.timeout ?? this.requestTimeout;\r\n\r\n return new Promise<TResponse>((resolve, reject) => {\r\n const pending: PendingRequest<TResponse> = {\r\n resolve,\r\n reject: (response: IResponse<TResponse>) => reject(response),\r\n request: message,\r\n submittedAt: Date.now(),\r\n };\r\n\r\n if(effectiveTimeout > 0) {\r\n pending.timer = setTimeout(() => {\r\n this.pendingRequests.delete(message.requestId);\r\n reject(this.createErrorResponse<TResponse>(message.requestId, `Request timed out after ${effectiveTimeout}ms`) as IResponse<TResponse>);\r\n }, effectiveTimeout);\r\n }\r\n\r\n this.pendingRequests.set(message.requestId, pending as PendingRequest);\r\n\r\n this.requestPort!.postMessage(message);\r\n });\r\n }\r\n\r\n public async batch(requests: Omit<IBatchRequestItem<unknown>, 'requestId'>[]): Promise<IBatchResponsePayload> {\r\n return this.request<IBatchResponsePayload>({\r\n method: 'BATCH',\r\n path: '',\r\n body: {\r\n requests,\r\n },\r\n });\r\n }\r\n\r\n public getSenderId(): number | undefined {\r\n return this.senderId;\r\n }\r\n\r\n private readonly onWindowMessage = (event: MessageEvent): void => {\r\n if(event.data?.type !== this.initMessageType) {\r\n return;\r\n }\r\n\r\n if(!Array.isArray(event.ports) || event.ports.length < 2) {\r\n const error = new Error('[Noxus] Renderer expected two MessagePorts (request + socket).');\r\n\r\n console.error(error);\r\n this.setupReject?.(error);\r\n this.resetSetupState();\r\n return;\r\n }\r\n\r\n this.windowRef.removeEventListener('message', this.onWindowMessage);\r\n\r\n this.requestPort = event.ports[0];\r\n this.socketPort = event.ports[1];\r\n this.senderId = event.data.senderId;\r\n\r\n if(this.requestPort === undefined || this.socketPort === undefined) {\r\n const error = new Error('[Noxus] Renderer failed to receive valid MessagePorts.');\r\n console.error(error);\r\n this.setupReject?.(error);\r\n this.resetSetupState();\r\n return;\r\n }\r\n\r\n this.attachRequestPort(this.requestPort);\r\n this.attachSocketPort(this.socketPort);\r\n\r\n this.isReady = true;\r\n this.setupResolve?.();\r\n this.resetSetupState(true);\r\n };\r\n\r\n private readonly onSocketMessage = (event: MessageEvent): void => {\r\n if(this.events.tryDispatchFromMessageEvent(event)) {\r\n return;\r\n }\r\n\r\n console.warn('[Noxus] Received a socket message that is not a renderer event payload.', event.data);\r\n };\r\n\r\n private readonly onRequestMessage = (event: MessageEvent): void => {\r\n if(this.events.tryDispatchFromMessageEvent(event)) {\r\n return;\r\n }\r\n\r\n const response: IResponse = event.data;\r\n\r\n if(!response || typeof response.requestId !== 'string') {\r\n console.error('[Noxus] Renderer received an invalid response payload.', response);\r\n return;\r\n }\r\n\r\n const pending = this.pendingRequests.get(response.requestId);\r\n\r\n if(!pending) {\r\n console.error(`[Noxus] No pending handler found for request ${response.requestId}.`);\r\n return;\r\n }\r\n\r\n if(pending.timer !== undefined) {\r\n clearTimeout(pending.timer);\r\n }\r\n\r\n this.pendingRequests.delete(response.requestId);\r\n\r\n this.onRequestCompleted(pending, response);\r\n\r\n if(response.status >= 400) {\r\n pending.reject(response as IResponse<any>);\r\n return;\r\n }\r\n\r\n pending.resolve(response.body as unknown);\r\n };\r\n\r\n protected onRequestCompleted(pending: PendingRequest, response: IResponse): void {\r\n if(!this.enableLogging) {\r\n return;\r\n }\r\n\r\n if(typeof console.groupCollapsed === 'function') {\r\n console.groupCollapsed(`${response.status} ${pending.request.method} /${pending.request.path}`);\r\n }\r\n\r\n if(response.error) {\r\n console.error('error message:', response.error);\r\n }\r\n\r\n if(response.body !== undefined) {\r\n console.info('response:', response.body);\r\n }\r\n\r\n console.info('request:', pending.request);\r\n console.info(`Request duration: ${Date.now() - pending.submittedAt} ms`);\r\n\r\n if(typeof console.groupCollapsed === 'function') {\r\n console.groupEnd();\r\n }\r\n }\r\n\r\n private attachRequestPort(port: MessagePort): void {\r\n port.onmessage = this.onRequestMessage;\r\n port.start();\r\n }\r\n\r\n private attachSocketPort(port: MessagePort): void {\r\n port.onmessage = this.onSocketMessage;\r\n port.start();\r\n }\r\n\r\n private validateReady(requestId: string): IResponse | undefined {\r\n if(!this.isElectronEnvironment()) {\r\n return this.createErrorResponse(requestId, 'Not running in Electron environment');\r\n }\r\n\r\n if(!this.requestPort) {\r\n return this.createErrorResponse(requestId, 'MessagePort is not available');\r\n }\r\n\r\n return undefined;\r\n }\r\n\r\n private createErrorResponse<T>(requestId: string, message: string): IResponse<T> {\r\n return {\r\n status: 500,\r\n requestId,\r\n error: message,\r\n };\r\n }\r\n\r\n private resetSetupState(success = false): void {\r\n if(!success) {\r\n this.setupPromise = undefined;\r\n }\r\n\r\n this.setupResolve = undefined;\r\n this.setupReject = undefined;\r\n }\r\n\r\n public isElectronEnvironment(): boolean {\r\n return typeof window !== 'undefined' && /Electron/.test(window.navigator.userAgent);\r\n }\r\n}\r\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,15 @@
1
1
  {
2
2
  "name": "@noxfly/noxus",
3
- "version": "3.0.0-dev.1",
3
+ "version": "3.0.0-dev.10",
4
+ "author": "NoxFly",
5
+ "license": "MIT",
6
+ "description": "Lightweight HTTP-like IPC framework for Electron with standalone controllers, explicit DI, and lazy route loading. No reflect-metadata required.",
7
+ "homepage": "https://github.com/NoxFly/noxus",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/NoxFly/noxus.git"
11
+ },
12
+ "files": ["dist"],
4
13
  "main": "dist/main.js",
5
14
  "module": "dist/main.mjs",
6
15
  "types": "dist/main.d.ts",
@@ -38,6 +47,14 @@
38
47
  "require": "./dist/child.js"
39
48
  }
40
49
  },
50
+ "typesVersions": {
51
+ "*": {
52
+ "main": ["./dist/main.d.ts"],
53
+ "renderer": ["./dist/renderer.d.ts"],
54
+ "preload": ["./dist/preload.d.ts"],
55
+ "child": ["./dist/child.d.ts"]
56
+ }
57
+ },
41
58
  "scripts": {
42
59
  "build": "tsup",
43
60
  "prepublishOnly": "npm run build",
@@ -56,14 +73,6 @@
56
73
  "standalone",
57
74
  "lazy-loading"
58
75
  ],
59
- "author": "NoxFly",
60
- "license": "MIT",
61
- "description": "Lightweight HTTP-like IPC framework for Electron with standalone controllers, explicit DI, and lazy route loading. No reflect-metadata required.",
62
- "homepage": "https://github.com/NoxFly/noxus",
63
- "repository": {
64
- "type": "git",
65
- "url": "git+https://github.com/NoxFly/noxus.git"
66
- },
67
76
  "engines": {
68
77
  "node": ">= 20"
69
78
  },
package/.editorconfig DELETED
@@ -1,16 +0,0 @@
1
- # Editor configuration, see https://editorconfig.org
2
- root = true
3
-
4
- [*]
5
- charset = utf-8
6
- indent_style = space
7
- indent_size = 4
8
- insert_final_newline = true
9
- trim_trailing_whitespace = true
10
-
11
- [*.ts]
12
- quote_type = single
13
-
14
- [*.md]
15
- max_line_length = off
16
- trim_trailing_whitespace = false
@@ -1,32 +0,0 @@
1
- # Copilot Instructions
2
- ## Core Architecture
3
- - bootstrapApplication in [src/bootstrap.ts](src/bootstrap.ts) waits for Electron app readiness, resolves NoxApp via DI, and returns a configured instance.
4
- - [src/app.ts](src/app.ts) wires ipcMain events, spawns paired request/socket MessageChannels per renderer, and delegates handling to Router and NoxSocket.
5
- - Package exports are split between renderer and main targets in [package.json](package.json); import Electron main APIs from @noxfly/noxus/main and renderer helpers from @noxfly/noxus or @noxfly/noxus/renderer.
6
- - Dependency injection centers on RootInjector in [src/DI/app-injector.ts](src/DI/app-injector.ts); @Injectable triggers auto-registration through [src/DI/injector-explorer.ts](src/DI/injector-explorer.ts) and supports singleton, scope, and transient lifetimes.
7
- - Modules decorated via [src/decorators/module.decorator.ts](src/decorators/module.decorator.ts) compose providers, controllers, and nested modules; bootstrapApplication rejects roots lacking Module metadata.
8
- ## Request Lifecycle
9
- - Request objects from [src/request.ts](src/request.ts) wrap Electron MessageEvents and spawn per-request DI scopes on Request.context.
10
- - Router in [src/router.ts](src/router.ts) indexes routes in a radix tree, merges controller-level and method-level decorators, and enforces root middlewares, route middlewares, then guards before invoking controller actions.
11
- - ResponseException subclasses in [src/exceptions.ts](src/exceptions.ts) propagate status codes; throwing one short-circuits the pipeline so Router returns a structured error payload.
12
- - Batch requests use HTTP method BATCH and normalization logic in Router.handleBatch; payloads must satisfy IBatchRequestPayload to fan out atomic subrequests.
13
- ## Communication Channels
14
- - ipcMain listens for gimme-my-port and posts two transferable ports back to the renderer: index 0 carries request/response traffic, index 1 is reserved for socket-style push messages.
15
- - NoxSocket in [src/socket.ts](src/socket.ts) maps sender IDs to {request, socket} channels and emits renderer events exclusively through channels.socket.port1.
16
- - Renderer helpers in [src/renderer-events.ts](src/renderer-events.ts) expose RendererEventRegistry.tryDispatchFromMessageEvent to route push events; the preload script must start both ports and hand the second to this registry.
17
- - Renderer-facing bootstrap lives in [src/renderer-client.ts](src/renderer-client.ts); NoxRendererClient requests ports, wires request/socket handlers, tracks pending promises, and surfaces RendererEventRegistry for push consumption.
18
- - Preload scripts should call exposeNoxusBridge from [src/preload-bridge.ts](src/preload-bridge.ts) to publish window.noxus.requestPort; the helper sends 'gimme-my-port' and forwards both transferable ports with the configured init message.
19
- - When adjusting preload or renderer glue, ensure window.postMessage('init-port', ...) forwards both ports so the socket channel stays alive alongside the request channel.
20
- ## Decorator Conventions
21
- - Controller paths omit leading/trailing slashes; method decorators (Get, Post, etc.) auto-trim segments via [src/decorators/method.decorator.ts](src/decorators/method.decorator.ts).
22
- - Guards registered through Authorize in [src/decorators/guards.decorator.ts](src/decorators/guards.decorator.ts) aggregate at controller and action scope; they must resolve truthy or Router throws UnauthorizedException.
23
- - Injectable lifetimes default to scope; use singleton for app-wide utilities (window managers, sockets) and transient for short-lived resources.
24
- ## Logging and Utilities
25
- - Logger in [src/utils/logger.ts](src/utils/logger.ts) standardizes color-coded log, warn, error, and comment output; use it when extending framework behavior.
26
- - Path resolution relies on RadixTree from [src/utils/radix-tree.ts](src/utils/radix-tree.ts); normalize controller and route paths to avoid duplicate slashes.
27
- - Request.params are filled by Router.extractParams; controllers read route params directly from Request without decorator helpers yet.
28
- ## Build and Tooling
29
- - Run npm run build to invoke tsup with dual ESM/CJS outputs configured in [tsup.config.ts](tsup.config.ts); the postbuild script at [scripts/postbuild.js](scripts/postbuild.js) deduplicates license banners.
30
- - Node 20 or newer is required; reflect-metadata is a peer dependency so host apps must install and import it before using decorators.
31
- - Source uses baseUrl ./ with tsc-alias, so prefer absolute imports like src/module/file when editing framework code to match existing style.
32
- - Dist artifacts live under dist/ and are published outputs; regenerate them via the build script rather than editing directly.
@@ -1,3 +0,0 @@
1
- {
2
- "typescript.tsdk": "node_modules\\typescript\\lib"
3
- }
package/eslint.config.js DELETED
@@ -1,109 +0,0 @@
1
- // @ts-nocheck
2
- const eslint = require("@eslint/js");
3
- const tseslint = require("typescript-eslint");
4
- const stylistic = require("@stylistic/eslint-plugin");
5
-
6
- module.exports = tseslint.config(
7
- {
8
- files: ["src/**/*.ts"],
9
- extends: [
10
- eslint.configs.recommended,
11
- ...tseslint.configs.recommended,
12
- ...tseslint.configs.stylistic,
13
- ],
14
- languageOptions: {
15
- parserOptions: {
16
- ecmaVersion: 2020,
17
- sourceType: "module",
18
- project: ["./tsconfig.json"],
19
- tsconfigRootDir: __dirname,
20
- }
21
- },
22
- plugins: {
23
- "@stylistic": stylistic,
24
- },
25
- rules: {
26
- "@typescript-eslint/no-empty-object-type": "off",
27
-
28
- "@typescript-eslint/no-require-imports": "off",
29
-
30
- "@typescript-eslint/explicit-member-accessibility": [
31
- "error",
32
- {
33
- "overrides": {
34
- "constructors": "no-public",
35
- }
36
- }
37
- ],
38
- "@typescript-eslint/explicit-function-return-type": [
39
- "error",
40
- {
41
- "allowExpressions": true,
42
- "allowHigherOrderFunctions": true,
43
- "allowIIFEs": true,
44
- }
45
- ],
46
- "@typescript-eslint/consistent-type-definitions": "off",
47
- "@typescript-eslint/no-explicit-any": "off",
48
- "@typescript-eslint/no-inferrable-types": "off",
49
- "@typescript-eslint/no-empty-function": "off",
50
- "@typescript-eslint/no-unused-vars": "off",
51
- "@typescript-eslint/no-namespace": "off",
52
- "@typescript-eslint/no-unsafe-function-type": "off",
53
- "@typescript-eslint/prefer-readonly": "warn",
54
-
55
- "@stylistic/object-curly-spacing": ["warn", "always"],
56
- "@stylistic/no-whitespace-before-property": "error",
57
- "@stylistic/space-before-blocks": ["warn", "always"],
58
- "@stylistic/comma-spacing": [
59
- "warn",
60
- {
61
- "before": false,
62
- "after": true
63
- }
64
- ],
65
- "@stylistic/block-spacing": ["warn", "always"],
66
- "@stylistic/brace-style": [
67
- "error",
68
- "stroustrup",
69
- {
70
- "allowSingleLine": true
71
- }
72
- ],
73
- "@stylistic/function-call-spacing": ["error", "never"],
74
- "@stylistic/arrow-spacing": "error",
75
- "@stylistic/computed-property-spacing": "warn",
76
- "@stylistic/generator-star-spacing": "error",
77
- "@stylistic/indent": ["error", 4, { "SwitchCase": 1 }],
78
- "@stylistic/semi": [2, "always"],
79
- "@stylistic/no-extra-semi": "warn",
80
- "@stylistic/semi-spacing": "warn",
81
- "@stylistic/quotes": "off",
82
- "@stylistic/keyword-spacing": [
83
- "warn",
84
- {
85
- "overrides": {
86
- "if": { "after": false },
87
- "for": { "after": false },
88
- "catch": { "after": false },
89
- "while": { "after": false },
90
- "as": { "after": false },
91
- "switch": { "after": false }
92
- }
93
- }
94
- ],
95
-
96
- "eqeqeq": "error",
97
- "no-duplicate-imports": "error",
98
- "no-empty": "off",
99
- "no-empty-function": "off",
100
- "no-extra-boolean-cast": "off",
101
- "no-inner-declarations": "off",
102
- "no-unsafe-finally": "off",
103
- "no-unsafe-optional-chaining": "error",
104
- "no-unused-vars": "off",
105
- "no-var": "error",
106
- "no-useless-catch": "off",
107
- },
108
- },
109
- );