@vlian/framework 1.2.59 → 1.2.61

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 (154) hide show
  1. package/dist/analytics/index.cjs +1 -22
  2. package/dist/analytics.umd.js +1 -1
  3. package/dist/components/LocaleSwitch.cjs +1 -116
  4. package/dist/components/ThemeSwitch.cjs +1 -115
  5. package/dist/components/index.cjs +1 -20
  6. package/dist/components/persistence.cjs +1 -58
  7. package/dist/core/Test.cjs +1 -64
  8. package/dist/core/app/AppContext.cjs +1 -348
  9. package/dist/core/app/AppContext.types.cjs +1 -4
  10. package/dist/core/app/BasicLayout.cjs +1 -122
  11. package/dist/core/app/DefaultApp.cjs +1 -150
  12. package/dist/core/app/index.cjs +1 -41
  13. package/dist/core/config/AppConfig.cjs +1 -139
  14. package/dist/core/config/ConfigLoader.cjs +1 -323
  15. package/dist/core/config/ConfigValidator.cjs +2 -133
  16. package/dist/core/config/index.cjs +1 -28
  17. package/dist/core/dev/DevTools.cjs +1 -226
  18. package/dist/core/error/ErrorBoundary.cjs +1 -401
  19. package/dist/core/error/ErrorHandler.cjs +1 -275
  20. package/dist/core/error/index.cjs +1 -34
  21. package/dist/core/event/AppEventBus.cjs +1 -444
  22. package/dist/core/event/frameworkEvents.cjs +1 -141
  23. package/dist/core/event/hooks.cjs +1 -69
  24. package/dist/core/event/index.cjs +1 -41
  25. package/dist/core/event/types.cjs +1 -62
  26. package/dist/core/event/useEventBus.cjs +1 -25
  27. package/dist/core/index.cjs +1 -140
  28. package/dist/core/initialization/InitializationErrorThrower.cjs +1 -75
  29. package/dist/core/initialization/index.cjs +1 -26
  30. package/dist/core/initialization/initialization.cjs +1 -64
  31. package/dist/core/initialization/initializationErrorState.cjs +1 -66
  32. package/dist/core/kernel/defaultAdapters.cjs +1 -184
  33. package/dist/core/kernel/errors.cjs +1 -69
  34. package/dist/core/kernel/index.cjs +1 -20
  35. package/dist/core/kernel/startKernel.cjs +1 -200
  36. package/dist/core/kernel/types.cjs +1 -4
  37. package/dist/core/middleware.cjs +1 -73
  38. package/dist/core/plugin/PluginEventBus.cjs +1 -298
  39. package/dist/core/plugin/PluginSandbox.cjs +1 -137
  40. package/dist/core/plugin.cjs +1 -494
  41. package/dist/core/router/RouterManager.cjs +1 -286
  42. package/dist/core/router/adapter/AdapterManager.cjs +1 -235
  43. package/dist/core/router/adapter/index.cjs +1 -22
  44. package/dist/core/router/adapter/react-router/ReactRouterAdapter.cjs +1 -128
  45. package/dist/core/router/adapter/react-router/index.cjs +1 -20
  46. package/dist/core/router/adapter/types.cjs +1 -6
  47. package/dist/core/router/dev/RouterDevTools.cjs +1 -260
  48. package/dist/core/router/dev/index.cjs +1 -20
  49. package/dist/core/router/dynamic/DynamicRouteManager.cjs +1 -193
  50. package/dist/core/router/dynamic/index.cjs +1 -20
  51. package/dist/core/router/errors/RouterError.cjs +1 -61
  52. package/dist/core/router/errors/index.cjs +1 -20
  53. package/dist/core/router/index.cjs +1 -36
  54. package/dist/core/router/lifecycle/RouterLifecycleManager.cjs +1 -144
  55. package/dist/core/router/lifecycle/index.cjs +1 -20
  56. package/dist/core/router/middleware/RouterMiddlewareManager.cjs +1 -193
  57. package/dist/core/router/middleware/auth.cjs +1 -66
  58. package/dist/core/router/middleware/index.cjs +1 -22
  59. package/dist/core/router/middleware/types.cjs +1 -6
  60. package/dist/core/router/monitoring/RouterMonitoring.cjs +1 -227
  61. package/dist/core/router/monitoring/index.cjs +1 -20
  62. package/dist/core/router/navigation/RouterNavigation.cjs +1 -239
  63. package/dist/core/router/navigation/index.cjs +1 -20
  64. package/dist/core/router/performance/RouteCache.cjs +1 -305
  65. package/dist/core/router/performance/RoutePreloader.cjs +1 -292
  66. package/dist/core/router/performance/index.cjs +1 -21
  67. package/dist/core/router/plugin/RouterPluginManager.cjs +1 -262
  68. package/dist/core/router/plugin/index.cjs +1 -21
  69. package/dist/core/router/plugin/types.cjs +1 -39
  70. package/dist/core/router/types.cjs +1 -4
  71. package/dist/core/router/utils/adapters/react-router/RouteErrorBoundary.cjs +1 -129
  72. package/dist/core/router/utils/adapters/react-router/transform.cjs +1 -250
  73. package/dist/core/router/utils/transform.cjs +1 -780
  74. package/dist/core/router/validation/RouterConfigValidator.cjs +2 -83
  75. package/dist/core/router/validation/index.cjs +1 -21
  76. package/dist/core/router/validation/schema.cjs +1 -159
  77. package/dist/core/router/version/RouteVersionManager.cjs +1 -205
  78. package/dist/core/router/version/index.cjs +1 -20
  79. package/dist/core/splash/SplashScreen.cjs +1 -341
  80. package/dist/core/splash/index.cjs +1 -22
  81. package/dist/core/splash/splashScreenUtils.cjs +1 -38
  82. package/dist/core/startup/AppInstance.cjs +1 -239
  83. package/dist/core/startup/environment.cjs +1 -169
  84. package/dist/core/startup/index.cjs +1 -23
  85. package/dist/core/startup/initializeServices.cjs +1 -226
  86. package/dist/core/startup/performanceTracker.cjs +1 -179
  87. package/dist/core/startup/renderApp.cjs +1 -314
  88. package/dist/core/startup/startApp.cjs +1 -317
  89. package/dist/core/types.cjs +1 -4
  90. package/dist/index.cjs +1 -52
  91. package/dist/index.umd.cjs +1 -27
  92. package/dist/index.umd.js +1 -1
  93. package/dist/kernel/constants.cjs +1 -65
  94. package/dist/kernel/index.cjs +1 -38
  95. package/dist/kernel/kernel.cjs +1 -295
  96. package/dist/kernel/manager/cacheManager.cjs +1 -46
  97. package/dist/kernel/manager/i18n/I18nManager.cjs +1 -91
  98. package/dist/kernel/manager/i18n/i18n.persistence.cjs +1 -60
  99. package/dist/kernel/manager/i18n/i18n.schema.cjs +1 -86
  100. package/dist/kernel/manager/i18n/index.cjs +1 -11
  101. package/dist/kernel/manager/i18nManager.cjs +1 -11
  102. package/dist/kernel/manager/index.cjs +1 -28
  103. package/dist/kernel/manager/logger/LoggerManager.cjs +1 -107
  104. package/dist/kernel/manager/logger/index.cjs +1 -11
  105. package/dist/kernel/manager/logger/logger.persistence.cjs +1 -62
  106. package/dist/kernel/manager/logger/logger.schema.cjs +1 -74
  107. package/dist/kernel/manager/loggerManager.cjs +1 -11
  108. package/dist/kernel/manager/theme/ThemeManager.cjs +1 -84
  109. package/dist/kernel/manager/theme/index.cjs +1 -11
  110. package/dist/kernel/manager/theme/theme.dom.cjs +1 -61
  111. package/dist/kernel/manager/theme/theme.persistence.cjs +1 -57
  112. package/dist/kernel/manager/theme/theme.schema.cjs +1 -122
  113. package/dist/kernel/manager/themeManager.cjs +1 -11
  114. package/dist/kernel/types.cjs +1 -4
  115. package/dist/library/index.cjs +1 -19
  116. package/dist/library/locale/index.cjs +1 -39
  117. package/dist/library/locale/langs/en-us/index.cjs +1 -32
  118. package/dist/library/locale/langs/zh-cn/index.cjs +1 -32
  119. package/dist/library/locale/types.cjs +1 -4
  120. package/dist/library/storage/cache.cjs +1 -243
  121. package/dist/library/storage/encryption.cjs +1 -147
  122. package/dist/library/storage/index.cjs +1 -124
  123. package/dist/state/StateManager.cjs +1 -166
  124. package/dist/state/adapters/AdapterFactory.cjs +1 -89
  125. package/dist/state/adapters/DefaultAdapter.cjs +1 -75
  126. package/dist/state/adapters/ReduxAdapter.cjs +1 -443
  127. package/dist/state/adapters/ZustandAdapter.cjs +1 -69
  128. package/dist/state/adapters/index.cjs +1 -44
  129. package/dist/state/adapters/types.cjs +1 -20
  130. package/dist/state/core/DerivedStateInstance.cjs +1 -174
  131. package/dist/state/core/StateInstance.cjs +1 -170
  132. package/dist/state/core/StateRegistry.cjs +1 -110
  133. package/dist/state/core/StateScope.cjs +1 -137
  134. package/dist/state/core/index.cjs +1 -30
  135. package/dist/state/index.cjs +1 -30
  136. package/dist/state/types.cjs +1 -12
  137. package/dist/state.umd.js +1 -1
  138. package/dist/types.cjs +1 -4
  139. package/dist/utils/analytics.cjs +1 -217
  140. package/dist/utils/configSecurity.cjs +3 -182
  141. package/dist/utils/csrf.cjs +1 -18
  142. package/dist/utils/errors/ErrorCodes.cjs +1 -25
  143. package/dist/utils/errors.cjs +1 -111
  144. package/dist/utils/index.cjs +1 -135
  145. package/dist/utils/logger.cjs +1 -25
  146. package/dist/utils/logger.types.cjs +1 -11
  147. package/dist/utils/monitoring.cjs +1 -18
  148. package/dist/utils/performance.cjs +1 -22
  149. package/dist/utils/resourceLoader.cjs +1 -22
  150. package/dist/utils/runtimeSecurity.cjs +1 -11
  151. package/dist/utils/security.cjs +1 -19
  152. package/dist/utils/traceId.cjs +1 -37
  153. package/dist/utils/validation.cjs +1 -19
  154. package/package.json +12 -3
@@ -1,444 +1 @@
1
- /**
2
- * 应用级事件总线
3
- * 提供高性能、类型安全、可观测的事件通信能力
4
- */ "use strict";
5
- Object.defineProperty(exports, "__esModule", {
6
- value: true
7
- });
8
- Object.defineProperty(exports, "AppEventBus", {
9
- enumerable: true,
10
- get: function() {
11
- return AppEventBus;
12
- }
13
- });
14
- const _logger = require("@vlian/logger");
15
- function _define_property(obj, key, value) {
16
- if (key in obj) {
17
- Object.defineProperty(obj, key, {
18
- value: value,
19
- enumerable: true,
20
- configurable: true,
21
- writable: true
22
- });
23
- } else {
24
- obj[key] = value;
25
- }
26
- return obj;
27
- }
28
- let AppEventBus = class AppEventBus {
29
- /**
30
- * 订阅事件
31
- *
32
- * @param event - 事件名称
33
- * @param listener - 事件监听器
34
- * @param options - 监听器选项
35
- * @returns 取消订阅函数
36
- *
37
- * @example
38
- * ```typescript
39
- * const unsubscribe = eventBus.on('user:login', (data, metadata) => {
40
- * console.log('用户登录:', data);
41
- * });
42
- *
43
- * // 取消订阅
44
- * unsubscribe();
45
- * ```
46
- */ on(event, listener, options = {}) {
47
- const fullEventName = this.getFullEventName(event);
48
- const listenerId = Symbol(`listener_${++this.listenerIdCounter}`);
49
- const listenerWithOptions = {
50
- listener: listener,
51
- options: {
52
- priority: options.priority ?? 100,
53
- once: options.once ?? false,
54
- namespace: options.namespace ?? this.config.namespacePrefix,
55
- async: options.async ?? true
56
- },
57
- id: listenerId
58
- };
59
- if (!this.listeners.has(fullEventName)) {
60
- this.listeners.set(fullEventName, new Set());
61
- }
62
- const listeners = this.listeners.get(fullEventName);
63
- listeners.add(listenerWithOptions);
64
- // 按优先级排序(数字越小优先级越高)
65
- const sortedListeners = Array.from(listeners).sort((a, b)=>a.options.priority - b.options.priority);
66
- this.listeners.set(fullEventName, new Set(sortedListeners));
67
- // 返回取消订阅函数
68
- return ()=>{
69
- const currentListeners = this.listeners.get(fullEventName);
70
- if (currentListeners) {
71
- currentListeners.delete(listenerWithOptions);
72
- if (currentListeners.size === 0) {
73
- this.listeners.delete(fullEventName);
74
- }
75
- }
76
- };
77
- }
78
- /**
79
- * 取消订阅事件
80
- *
81
- * @param event - 事件名称
82
- * @param listener - 事件监听器(可选,不提供则取消该事件的所有监听器)
83
- */ off(event, listener) {
84
- const fullEventName = this.getFullEventName(event);
85
- const listeners = this.listeners.get(fullEventName);
86
- if (!listeners) {
87
- return;
88
- }
89
- if (listener) {
90
- // 移除指定的监听器
91
- for (const item of listeners){
92
- if (item.listener === listener) {
93
- listeners.delete(item);
94
- break;
95
- }
96
- }
97
- } else {
98
- // 移除所有监听器
99
- listeners.clear();
100
- }
101
- if (listeners.size === 0) {
102
- this.listeners.delete(fullEventName);
103
- }
104
- }
105
- /**
106
- * 一次性订阅事件
107
- *
108
- * @param event - 事件名称
109
- * @param listener - 事件监听器
110
- * @param options - 监听器选项
111
- */ once(event, listener, options) {
112
- return this.on(event, listener, {
113
- ...options,
114
- once: true
115
- });
116
- }
117
- /**
118
- * 发布事件
119
- *
120
- * @param event - 事件名称
121
- * @param data - 事件数据
122
- * @param metadata - 事件元数据(可选)
123
- *
124
- * @example
125
- * ```typescript
126
- * await eventBus.emit('user:login', {
127
- * userId: '123',
128
- * username: 'john',
129
- * });
130
- * ```
131
- */ async emit(event, data, metadata) {
132
- const fullEventName = this.getFullEventName(event);
133
- const startTime = this.config.enablePerformanceMonitoring ? performance.now() : 0;
134
- // 事件验证
135
- if (this.config.enableValidation && !this.config.validator(fullEventName, data)) {
136
- _logger.logger.warn(`事件 ${fullEventName} 验证失败,已忽略`);
137
- return;
138
- }
139
- // 安全检查
140
- if (this.config.enableSecurityMode && metadata?.source) {
141
- if (!this.config.allowedSources.includes(metadata.source)) {
142
- _logger.logger.warn(`事件 ${fullEventName} 的来源 ${metadata.source} 不在白名单中,已忽略`);
143
- return;
144
- }
145
- }
146
- // 构建事件元数据
147
- const eventMetadata = {
148
- source: metadata?.source,
149
- timestamp: metadata?.timestamp ?? Date.now(),
150
- eventId: metadata?.eventId ?? `event_${++this.eventCounter}`,
151
- priority: metadata?.priority ?? 0,
152
- instanceId: metadata?.instanceId ?? this.config.instanceId,
153
- namespace: metadata?.namespace ?? this.config.namespacePrefix,
154
- ...metadata
155
- };
156
- // 创建事件包装器
157
- const eventWrapper = {
158
- data: data,
159
- metadata: eventMetadata
160
- };
161
- // 执行中间件(中间件可以阻止事件传播)
162
- if (this.middlewares.length > 0) {
163
- let middlewareIndex = 0;
164
- let nextCalled = false;
165
- const executeMiddleware = async ()=>{
166
- if (middlewareIndex < this.middlewares.length) {
167
- nextCalled = false;
168
- const currentIndex = middlewareIndex;
169
- const middleware = this.middlewares[middlewareIndex++];
170
- const next = async ()=>{
171
- nextCalled = true;
172
- if (currentIndex < this.middlewares.length - 1) {
173
- await executeMiddleware();
174
- }
175
- };
176
- await Promise.resolve(middleware(fullEventName, data, eventMetadata, next));
177
- // 如果中间件没有调用 next(),阻止事件传播
178
- if (!nextCalled) {
179
- return;
180
- }
181
- }
182
- };
183
- await executeMiddleware();
184
- // 如果最后一个中间件没有调用 next(),阻止事件传播
185
- if (!nextCalled && this.middlewares.length > 0) {
186
- return;
187
- }
188
- }
189
- // 获取监听器
190
- const listeners = this.listeners.get(fullEventName);
191
- // 记录事件历史(无论是否有监听器)
192
- if (this.config.enableTracking) {
193
- const executionTime = this.config.enablePerformanceMonitoring ? performance.now() - startTime : undefined;
194
- this.recordEventHistory(fullEventName, data, eventMetadata, executionTime);
195
- }
196
- if (!listeners || listeners.size === 0) {
197
- // 更新统计(即使没有监听器也记录)
198
- this.updateStats(fullEventName, 0);
199
- return;
200
- }
201
- // 执行监听器
202
- const executionPromises = [];
203
- const listenersToRemove = [];
204
- for (const listenerWithOptions of listeners){
205
- const executeListener = async ()=>{
206
- try {
207
- if (listenerWithOptions.options.async) {
208
- await Promise.resolve(listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata));
209
- } else {
210
- listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata);
211
- }
212
- // 如果是一次性监听器,标记为待移除
213
- if (listenerWithOptions.options.once) {
214
- listenersToRemove.push(listenerWithOptions);
215
- }
216
- } catch (error) {
217
- _logger.logger.error(`事件 ${fullEventName} 的监听器执行失败:`, error);
218
- }
219
- };
220
- executionPromises.push(executeListener());
221
- }
222
- // 等待所有监听器执行完成
223
- await Promise.allSettled(executionPromises);
224
- // 移除一次性监听器
225
- for (const listenerToRemove of listenersToRemove){
226
- listeners.delete(listenerToRemove);
227
- }
228
- if (listeners.size === 0) {
229
- this.listeners.delete(fullEventName);
230
- }
231
- // 更新统计信息
232
- const executionTime = this.config.enablePerformanceMonitoring ? performance.now() - startTime : 0;
233
- this.updateStats(fullEventName, executionTime, listeners.size);
234
- }
235
- /**
236
- * 同步发布事件(不等待异步监听器完成)
237
- *
238
- * @param event - 事件名称
239
- * @param data - 事件数据
240
- * @param metadata - 事件元数据(可选)
241
- */ emitSync(event, data, metadata) {
242
- // 同步执行 emit,但不等待 Promise 完成
243
- this.emit(event, data, metadata).catch((error)=>{
244
- _logger.logger.error(`同步发布事件 ${event} 失败:`, error);
245
- });
246
- }
247
- /**
248
- * 注册事件中间件
249
- *
250
- * @param middleware - 中间件函数
251
- * @returns 取消注册函数
252
- *
253
- * @example
254
- * ```typescript
255
- * const unsubscribe = eventBus.use((event, data, metadata, next) => {
256
- * console.log('事件触发:', event);
257
- * return next();
258
- * });
259
- * ```
260
- */ use(middleware) {
261
- this.middlewares.push(middleware);
262
- return ()=>{
263
- const index = this.middlewares.indexOf(middleware);
264
- if (index > -1) {
265
- this.middlewares.splice(index, 1);
266
- }
267
- };
268
- }
269
- /**
270
- * 清空所有事件监听器
271
- */ clear() {
272
- this.listeners.clear();
273
- }
274
- /**
275
- * 清空事件历史记录
276
- */ clearHistory() {
277
- this.eventHistory = [];
278
- }
279
- /**
280
- * 获取事件监听器数量
281
- *
282
- * @param event - 事件名称(可选,不提供则返回所有事件的监听器总数)
283
- */ listenerCount(event) {
284
- if (event) {
285
- const fullEventName = this.getFullEventName(event);
286
- return this.listeners.get(fullEventName)?.size || 0;
287
- }
288
- let count = 0;
289
- for (const listeners of this.listeners.values()){
290
- count += listeners.size;
291
- }
292
- return count;
293
- }
294
- /**
295
- * 获取所有事件名称
296
- */ eventNames() {
297
- return Array.from(this.listeners.keys());
298
- }
299
- /**
300
- * 获取事件历史记录
301
- *
302
- * @param event - 事件名称(可选,如果提供则只返回该事件的历史)
303
- * @param limit - 限制返回的记录数
304
- */ getEventHistory(event, limit) {
305
- if (!this.config.enableTracking) {
306
- return [];
307
- }
308
- let history = this.eventHistory;
309
- if (event) {
310
- const fullEventName = this.getFullEventName(event);
311
- history = history.filter((h)=>h.event === fullEventName);
312
- }
313
- if (limit) {
314
- history = history.slice(-limit);
315
- }
316
- return [
317
- ...history
318
- ];
319
- }
320
- /**
321
- * 获取事件统计信息
322
- *
323
- * @param event - 事件名称(可选,不提供则返回所有事件的统计)
324
- */ getStats(event) {
325
- if (event) {
326
- const fullEventName = this.getFullEventName(event);
327
- return this.stats.get(fullEventName) || {
328
- event: fullEventName,
329
- count: 0,
330
- avgExecutionTime: 0,
331
- listenerCount: 0,
332
- lastTriggered: 0
333
- };
334
- }
335
- return new Map(this.stats);
336
- }
337
- /**
338
- * 获取配置
339
- */ getConfig() {
340
- return {
341
- ...this.config
342
- };
343
- }
344
- /**
345
- * 更新配置
346
- */ updateConfig(config) {
347
- this.config = {
348
- ...this.config,
349
- ...config
350
- };
351
- }
352
- /**
353
- * 销毁事件总线(清理所有资源)
354
- */ destroy() {
355
- this.clear();
356
- this.clearHistory();
357
- this.middlewares = [];
358
- this.stats.clear();
359
- }
360
- /**
361
- * 获取完整事件名称(包含命名空间前缀)
362
- */ getFullEventName(event) {
363
- if (this.config.namespacePrefix) {
364
- return `${this.config.namespacePrefix}${event}`;
365
- }
366
- return event;
367
- }
368
- /**
369
- * 记录事件历史
370
- */ recordEventHistory(event, data, metadata, executionTime) {
371
- this.eventHistory.push({
372
- event,
373
- data,
374
- metadata,
375
- executionTime
376
- });
377
- // 限制历史记录大小
378
- if (this.eventHistory.length > this.config.maxHistorySize) {
379
- this.eventHistory.shift();
380
- }
381
- }
382
- /**
383
- * 更新统计信息
384
- */ updateStats(event, executionTime, listenerCount = 0) {
385
- if (!this.config.enablePerformanceMonitoring) {
386
- return;
387
- }
388
- const existingStats = this.stats.get(event);
389
- if (existingStats) {
390
- const totalTime = existingStats.avgExecutionTime * existingStats.count + executionTime;
391
- const newCount = existingStats.count + 1;
392
- this.stats.set(event, {
393
- ...existingStats,
394
- count: newCount,
395
- avgExecutionTime: totalTime / newCount,
396
- listenerCount,
397
- lastTriggered: Date.now()
398
- });
399
- } else {
400
- this.stats.set(event, {
401
- event,
402
- count: 1,
403
- avgExecutionTime: executionTime,
404
- listenerCount,
405
- lastTriggered: Date.now()
406
- });
407
- }
408
- }
409
- constructor(config = {}){
410
- /**
411
- * 事件监听器映射表
412
- * 使用 Map + Set 结构提高性能
413
- */ _define_property(this, "listeners", new Map());
414
- /**
415
- * 事件历史记录
416
- */ _define_property(this, "eventHistory", []);
417
- /**
418
- * 事件中间件列表
419
- */ _define_property(this, "middlewares", []);
420
- /**
421
- * 事件统计信息
422
- */ _define_property(this, "stats", new Map());
423
- /**
424
- * 配置
425
- */ _define_property(this, "config", void 0);
426
- /**
427
- * 事件计数器(用于生成唯一事件ID)
428
- */ _define_property(this, "eventCounter", 0);
429
- /**
430
- * 监听器ID计数器
431
- */ _define_property(this, "listenerIdCounter", 0);
432
- this.config = {
433
- enableTracking: config.enableTracking ?? process.env.NODE_ENV === 'development',
434
- maxHistorySize: config.maxHistorySize ?? 100,
435
- enableValidation: config.enableValidation ?? false,
436
- validator: config.validator ?? (()=>true),
437
- enablePerformanceMonitoring: config.enablePerformanceMonitoring ?? process.env.NODE_ENV === 'development',
438
- namespacePrefix: config.namespacePrefix ?? '',
439
- instanceId: config.instanceId,
440
- enableSecurityMode: config.enableSecurityMode ?? false,
441
- allowedSources: config.allowedSources ?? []
442
- };
443
- }
444
- };
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"AppEventBus",{enumerable:true,get:function(){return AppEventBus}});const _logger=require("@vlian/logger");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}let AppEventBus=class AppEventBus{on(event,listener,options={}){const fullEventName=this.getFullEventName(event);const listenerId=Symbol(`listener_${++this.listenerIdCounter}`);const listenerWithOptions={listener:listener,options:{priority:options.priority??100,once:options.once??false,namespace:options.namespace??this.config.namespacePrefix,async:options.async??true},id:listenerId};if(!this.listeners.has(fullEventName)){this.listeners.set(fullEventName,new Set)}const listeners=this.listeners.get(fullEventName);listeners.add(listenerWithOptions);const sortedListeners=Array.from(listeners).sort((a,b)=>a.options.priority-b.options.priority);this.listeners.set(fullEventName,new Set(sortedListeners));return()=>{const currentListeners=this.listeners.get(fullEventName);if(currentListeners){currentListeners.delete(listenerWithOptions);if(currentListeners.size===0){this.listeners.delete(fullEventName)}}}}off(event,listener){const fullEventName=this.getFullEventName(event);const listeners=this.listeners.get(fullEventName);if(!listeners){return}if(listener){for(const item of listeners){if(item.listener===listener){listeners.delete(item);break}}}else{listeners.clear()}if(listeners.size===0){this.listeners.delete(fullEventName)}}once(event,listener,options){return this.on(event,listener,{...options,once:true})}async emit(event,data,metadata){const fullEventName=this.getFullEventName(event);const startTime=this.config.enablePerformanceMonitoring?performance.now():0;if(this.config.enableValidation&&!this.config.validator(fullEventName,data)){_logger.logger.warn(`事件 ${fullEventName} 验证失败,已忽略`);return}if(this.config.enableSecurityMode&&metadata?.source){if(!this.config.allowedSources.includes(metadata.source)){_logger.logger.warn(`事件 ${fullEventName} 的来源 ${metadata.source} 不在白名单中,已忽略`);return}}const eventMetadata={source:metadata?.source,timestamp:metadata?.timestamp??Date.now(),eventId:metadata?.eventId??`event_${++this.eventCounter}`,priority:metadata?.priority??0,instanceId:metadata?.instanceId??this.config.instanceId,namespace:metadata?.namespace??this.config.namespacePrefix,...metadata};const eventWrapper={data:data,metadata:eventMetadata};if(this.middlewares.length>0){let middlewareIndex=0;let nextCalled=false;const executeMiddleware=async()=>{if(middlewareIndex<this.middlewares.length){nextCalled=false;const currentIndex=middlewareIndex;const middleware=this.middlewares[middlewareIndex++];const next=async()=>{nextCalled=true;if(currentIndex<this.middlewares.length-1){await executeMiddleware()}};await Promise.resolve(middleware(fullEventName,data,eventMetadata,next));if(!nextCalled){return}}};await executeMiddleware();if(!nextCalled&&this.middlewares.length>0){return}}const listeners=this.listeners.get(fullEventName);if(this.config.enableTracking){const executionTime=this.config.enablePerformanceMonitoring?performance.now()-startTime:undefined;this.recordEventHistory(fullEventName,data,eventMetadata,executionTime)}if(!listeners||listeners.size===0){this.updateStats(fullEventName,0);return}const executionPromises=[];const listenersToRemove=[];for(const listenerWithOptions of listeners){const executeListener=async()=>{try{if(listenerWithOptions.options.async){await Promise.resolve(listenerWithOptions.listener(eventWrapper.data,eventWrapper.metadata))}else{listenerWithOptions.listener(eventWrapper.data,eventWrapper.metadata)}if(listenerWithOptions.options.once){listenersToRemove.push(listenerWithOptions)}}catch(error){_logger.logger.error(`事件 ${fullEventName} 的监听器执行失败:`,error)}};executionPromises.push(executeListener())}await Promise.allSettled(executionPromises);for(const listenerToRemove of listenersToRemove){listeners.delete(listenerToRemove)}if(listeners.size===0){this.listeners.delete(fullEventName)}const executionTime=this.config.enablePerformanceMonitoring?performance.now()-startTime:0;this.updateStats(fullEventName,executionTime,listeners.size)}emitSync(event,data,metadata){this.emit(event,data,metadata).catch(error=>{_logger.logger.error(`同步发布事件 ${event} 失败:`,error)})}use(middleware){this.middlewares.push(middleware);return()=>{const index=this.middlewares.indexOf(middleware);if(index>-1){this.middlewares.splice(index,1)}}}clear(){this.listeners.clear()}clearHistory(){this.eventHistory=[]}listenerCount(event){if(event){const fullEventName=this.getFullEventName(event);return this.listeners.get(fullEventName)?.size||0}let count=0;for(const listeners of this.listeners.values()){count+=listeners.size}return count}eventNames(){return Array.from(this.listeners.keys())}getEventHistory(event,limit){if(!this.config.enableTracking){return[]}let history=this.eventHistory;if(event){const fullEventName=this.getFullEventName(event);history=history.filter(h=>h.event===fullEventName)}if(limit){history=history.slice(-limit)}return[...history]}getStats(event){if(event){const fullEventName=this.getFullEventName(event);return this.stats.get(fullEventName)||{event:fullEventName,count:0,avgExecutionTime:0,listenerCount:0,lastTriggered:0}}return new Map(this.stats)}getConfig(){return{...this.config}}updateConfig(config){this.config={...this.config,...config}}destroy(){this.clear();this.clearHistory();this.middlewares=[];this.stats.clear()}getFullEventName(event){if(this.config.namespacePrefix){return`${this.config.namespacePrefix}${event}`}return event}recordEventHistory(event,data,metadata,executionTime){this.eventHistory.push({event,data,metadata,executionTime});if(this.eventHistory.length>this.config.maxHistorySize){this.eventHistory.shift()}}updateStats(event,executionTime,listenerCount=0){if(!this.config.enablePerformanceMonitoring){return}const existingStats=this.stats.get(event);if(existingStats){const totalTime=existingStats.avgExecutionTime*existingStats.count+executionTime;const newCount=existingStats.count+1;this.stats.set(event,{...existingStats,count:newCount,avgExecutionTime:totalTime/newCount,listenerCount,lastTriggered:Date.now()})}else{this.stats.set(event,{event,count:1,avgExecutionTime:executionTime,listenerCount,lastTriggered:Date.now()})}}constructor(config={}){_define_property(this,"listeners",new Map);_define_property(this,"eventHistory",[]);_define_property(this,"middlewares",[]);_define_property(this,"stats",new Map);_define_property(this,"config",void 0);_define_property(this,"eventCounter",0);_define_property(this,"listenerIdCounter",0);this.config={enableTracking:config.enableTracking??process.env.NODE_ENV==="development",maxHistorySize:config.maxHistorySize??100,enableValidation:config.enableValidation??false,validator:config.validator??(()=>true),enablePerformanceMonitoring:config.enablePerformanceMonitoring??process.env.NODE_ENV==="development",namespacePrefix:config.namespacePrefix??"",instanceId:config.instanceId,enableSecurityMode:config.enableSecurityMode??false,allowedSources:config.allowedSources??[]}}};
@@ -1,141 +1 @@
1
- /**
2
- * 框架生命周期事件集成
3
- * 自动在框架关键节点触发事件
4
- */ "use strict";
5
- Object.defineProperty(exports, "__esModule", {
6
- value: true
7
- });
8
- Object.defineProperty(exports, "FrameworkEventManager", {
9
- enumerable: true,
10
- get: function() {
11
- return FrameworkEventManager;
12
- }
13
- });
14
- const _types = require("./types");
15
- function _define_property(obj, key, value) {
16
- if (key in obj) {
17
- Object.defineProperty(obj, key, {
18
- value: value,
19
- enumerable: true,
20
- configurable: true,
21
- writable: true
22
- });
23
- } else {
24
- obj[key] = value;
25
- }
26
- return obj;
27
- }
28
- let FrameworkEventManager = class FrameworkEventManager {
29
- /**
30
- * 触发应用启动事件
31
- */ emitAppStart(instanceId) {
32
- this.eventBus.emitSync(_types.FrameworkEventType.APP_START, {
33
- instanceId
34
- });
35
- }
36
- /**
37
- * 触发应用启动完成事件
38
- */ emitAppStarted(instanceId, duration) {
39
- this.eventBus.emitSync(_types.FrameworkEventType.APP_STARTED, {
40
- instanceId,
41
- duration
42
- });
43
- }
44
- /**
45
- * 触发应用初始化开始事件
46
- */ emitAppInitStart(instanceId) {
47
- this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_START, {
48
- instanceId
49
- });
50
- }
51
- /**
52
- * 触发应用初始化完成事件
53
- */ emitAppInitComplete(instanceId, context, duration) {
54
- this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_COMPLETE, {
55
- instanceId,
56
- context,
57
- duration
58
- });
59
- }
60
- /**
61
- * 触发应用初始化错误事件
62
- */ emitAppInitError(instanceId, error) {
63
- this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_ERROR, {
64
- instanceId,
65
- error
66
- });
67
- }
68
- /**
69
- * 触发应用渲染开始事件
70
- */ emitAppRenderStart(instanceId) {
71
- this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_START, {
72
- instanceId
73
- });
74
- }
75
- /**
76
- * 触发应用渲染完成事件
77
- */ emitAppRenderComplete(instanceId, duration) {
78
- this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_COMPLETE, {
79
- instanceId,
80
- duration
81
- });
82
- }
83
- /**
84
- * 触发路由变化事件
85
- */ emitRouteChange(from, to, params) {
86
- this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_CHANGE, {
87
- from,
88
- to,
89
- params
90
- });
91
- }
92
- /**
93
- * 触发路由导航开始事件
94
- */ emitRouteNavigateStart(to, options) {
95
- this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_START, {
96
- to,
97
- options
98
- });
99
- }
100
- /**
101
- * 触发路由导航完成事件
102
- */ emitRouteNavigateComplete(to, duration) {
103
- this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_COMPLETE, {
104
- to,
105
- duration
106
- });
107
- }
108
- /**
109
- * 触发错误发生事件
110
- */ emitErrorOccurred(error, context) {
111
- this.eventBus.emitSync(_types.FrameworkEventType.ERROR_OCCURRED, {
112
- error,
113
- context
114
- });
115
- }
116
- /**
117
- * 触发实例创建事件
118
- */ emitInstanceCreated(instanceId) {
119
- this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_CREATED, {
120
- instanceId
121
- });
122
- }
123
- /**
124
- * 触发实例销毁事件
125
- */ emitInstanceDestroyed(instanceId) {
126
- this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_DESTROYED, {
127
- instanceId
128
- });
129
- }
130
- /**
131
- * 触发性能指标更新事件
132
- */ emitPerformanceUpdate(metrics) {
133
- this.eventBus.emitSync(_types.FrameworkEventType.PERFORMANCE_UPDATE, {
134
- metrics
135
- });
136
- }
137
- constructor(eventBus){
138
- _define_property(this, "eventBus", void 0);
139
- this.eventBus = eventBus;
140
- }
141
- };
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"FrameworkEventManager",{enumerable:true,get:function(){return FrameworkEventManager}});const _types=require("./types");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}let FrameworkEventManager=class FrameworkEventManager{emitAppStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_START,{instanceId})}emitAppStarted(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_STARTED,{instanceId,duration})}emitAppInitStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_START,{instanceId})}emitAppInitComplete(instanceId,context,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_COMPLETE,{instanceId,context,duration})}emitAppInitError(instanceId,error){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_ERROR,{instanceId,error})}emitAppRenderStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_START,{instanceId})}emitAppRenderComplete(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_COMPLETE,{instanceId,duration})}emitRouteChange(from,to,params){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_CHANGE,{from,to,params})}emitRouteNavigateStart(to,options){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_START,{to,options})}emitRouteNavigateComplete(to,duration){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_COMPLETE,{to,duration})}emitErrorOccurred(error,context){this.eventBus.emitSync(_types.FrameworkEventType.ERROR_OCCURRED,{error,context})}emitInstanceCreated(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_CREATED,{instanceId})}emitInstanceDestroyed(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_DESTROYED,{instanceId})}emitPerformanceUpdate(metrics){this.eventBus.emitSync(_types.FrameworkEventType.PERFORMANCE_UPDATE,{metrics})}constructor(eventBus){_define_property(this,"eventBus",void 0);this.eventBus=eventBus}};
@@ -1,69 +1 @@
1
- /**
2
- * React Hooks 支持
3
- * 提供便捷的 React 组件事件订阅能力
4
- */ "use strict";
5
- Object.defineProperty(exports, "__esModule", {
6
- value: true
7
- });
8
- function _export(target, all) {
9
- for(var name in all)Object.defineProperty(target, name, {
10
- enumerable: true,
11
- get: Object.getOwnPropertyDescriptor(all, name).get
12
- });
13
- }
14
- _export(exports, {
15
- get useAppEvent () {
16
- return useAppEvent;
17
- },
18
- get useAppEventEmitter () {
19
- return useAppEventEmitter;
20
- },
21
- get useAppEventOnce () {
22
- return useAppEventOnce;
23
- }
24
- });
25
- const _react = require("react");
26
- function useAppEvent(eventBus, event, listener, options) {
27
- // 使用 ref 保存最新的 listener,避免重复订阅
28
- const listenerRef = (0, _react.useRef)(listener);
29
- listenerRef.current = listener;
30
- // 使用 ref 保存 options
31
- const optionsRef = (0, _react.useRef)(options);
32
- optionsRef.current = options;
33
- (0, _react.useEffect)(()=>{
34
- // 创建包装的监听器,使用最新的 listener
35
- const wrappedListener = (data, metadata)=>{
36
- return listenerRef.current(data, metadata);
37
- };
38
- // 订阅事件
39
- const unsubscribe = eventBus.on(event, wrappedListener, optionsRef.current);
40
- // 清理函数:取消订阅
41
- return unsubscribe;
42
- }, [
43
- eventBus,
44
- event
45
- ]); // 只在 eventBus 或 event 变化时重新订阅
46
- }
47
- function useAppEventOnce(eventBus, event, listener, options) {
48
- const listenerRef = (0, _react.useRef)(listener);
49
- listenerRef.current = listener;
50
- const optionsRef = (0, _react.useRef)(options);
51
- optionsRef.current = options;
52
- (0, _react.useEffect)(()=>{
53
- const wrappedListener = (data, metadata)=>{
54
- return listenerRef.current(data, metadata);
55
- };
56
- const unsubscribe = eventBus.once(event, wrappedListener, optionsRef.current);
57
- return unsubscribe;
58
- }, [
59
- eventBus,
60
- event
61
- ]);
62
- }
63
- function useAppEventEmitter(eventBus) {
64
- return (0, _react.useCallback)((event, data, metadata)=>{
65
- return eventBus.emit(event, data, metadata);
66
- }, [
67
- eventBus
68
- ]);
69
- }
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get useAppEvent(){return useAppEvent},get useAppEventEmitter(){return useAppEventEmitter},get useAppEventOnce(){return useAppEventOnce}});const _react=require("react");function useAppEvent(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.on(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventOnce(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.once(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventEmitter(eventBus){return(0,_react.useCallback)((event,data,metadata)=>{return eventBus.emit(event,data,metadata)},[eventBus])}