@africode/core 5.0.11 → 5.0.13

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 (221) hide show
  1. package/AGENTS.md +585 -585
  2. package/AGENT_INSTRUCTIONS.md +595 -595
  3. package/COMPONENT_SCHEMA.json +1826 -1800
  4. package/LICENSE +623 -623
  5. package/README.md +476 -476
  6. package/bin/africode.js +73 -73
  7. package/bin/cli.ts +82 -82
  8. package/bin/create-africode.js +220 -220
  9. package/bin/scaffold.ts +218 -218
  10. package/components/accordion.js +183 -183
  11. package/components/alert.js +131 -131
  12. package/components/auth-form.js +154 -154
  13. package/components/auth.js +172 -172
  14. package/components/avatar.js +117 -117
  15. package/components/badge.js +104 -104
  16. package/components/base.d.ts +139 -139
  17. package/components/base.js +234 -234
  18. package/components/breadcrumb.js +76 -72
  19. package/components/button.js +164 -164
  20. package/components/card.js +144 -137
  21. package/components/carousel.js +32 -32
  22. package/components/cart-drawer.js +28 -28
  23. package/components/code-block.js +20 -20
  24. package/components/contact-form.js +25 -25
  25. package/components/cookie-consent.js +23 -23
  26. package/components/cta-banner.js +38 -38
  27. package/components/cultural-card.js +243 -243
  28. package/components/dashboard-activity-list.js +103 -103
  29. package/components/dashboard-card.js +85 -85
  30. package/components/dashboard-metric.js +81 -81
  31. package/components/dashboard-shell.js +85 -85
  32. package/components/dashboard-topbar.js +84 -84
  33. package/components/divider.js +83 -83
  34. package/components/dropdown.js +171 -171
  35. package/components/error-boundary.js +155 -155
  36. package/components/faq-accordion.js +23 -23
  37. package/components/feature-grid.js +85 -85
  38. package/components/file-uploader.js +22 -22
  39. package/components/filter-bar.js +19 -19
  40. package/components/footer.js +113 -113
  41. package/components/form.js +131 -131
  42. package/components/gallery.js +22 -22
  43. package/components/hero.js +140 -138
  44. package/components/icon.js +36 -36
  45. package/components/index.js +128 -128
  46. package/components/input.js +252 -256
  47. package/components/kanga-card.js +185 -185
  48. package/components/kyc-upload.js +173 -173
  49. package/components/language-switcher.js +108 -108
  50. package/components/loader.js +80 -80
  51. package/components/modal.js +262 -262
  52. package/components/motion.js +84 -84
  53. package/components/nav-drawer.js +216 -216
  54. package/components/navbar.js +243 -236
  55. package/components/newsletter-signup.js +24 -24
  56. package/components/pagination.js +31 -31
  57. package/components/pattern-showcase.js +225 -225
  58. package/components/pricing-card.js +100 -100
  59. package/components/product-card.js +41 -41
  60. package/components/progress.js +132 -134
  61. package/components/react.js +111 -111
  62. package/components/search-box.js +24 -24
  63. package/components/section.js +54 -54
  64. package/components/select.js +321 -322
  65. package/components/sidebar.js +180 -180
  66. package/components/simple-chart.js +22 -22
  67. package/components/skeleton.js +85 -85
  68. package/components/stepper.js +28 -28
  69. package/components/table.js +181 -181
  70. package/components/tabs.js +202 -202
  71. package/components/team-grid.js +23 -23
  72. package/components/testimonial.js +94 -94
  73. package/components/theme-toggle.js +82 -82
  74. package/components/toast.js +139 -139
  75. package/components/tooltip.js +167 -167
  76. package/components/transaction-ledger.js +138 -138
  77. package/components/ui-avatar.js +79 -79
  78. package/components/ui-badge.js +61 -61
  79. package/components/ui-button.js +149 -149
  80. package/components/ui-card.js +74 -75
  81. package/components/ui-chip.js +87 -87
  82. package/components/ui-input.js +110 -110
  83. package/components/ui-popover.js +84 -84
  84. package/components/ui-progress-ring.js +60 -60
  85. package/components/ui-select.js +85 -85
  86. package/components/ui-stat.js +75 -75
  87. package/components/ui-switch.js +85 -85
  88. package/components/ui-table.js +69 -69
  89. package/components/ui-tabs.js +99 -99
  90. package/components/ui-tag.js +64 -64
  91. package/components/ui-textarea.js +84 -84
  92. package/components/ui-tooltip.js +66 -66
  93. package/components/video-player.js +22 -22
  94. package/components/wallet-balance.js +114 -114
  95. package/core/a2ui-schema-manager.js +351 -351
  96. package/core/a2ui.js +696 -696
  97. package/core/actions.js +27 -27
  98. package/core/bun-runtime.js +396 -396
  99. package/core/cli/commands/add.js +23 -23
  100. package/core/cli/commands/audit.js +58 -58
  101. package/core/cli/commands/build.js +193 -193
  102. package/core/cli/commands/create-plugin.js +241 -241
  103. package/core/cli/commands/dev.js +248 -283
  104. package/core/cli/commands/lint.js +23 -23
  105. package/core/cli/commands/test.js +33 -34
  106. package/core/cli/migrator.js +71 -71
  107. package/core/cli/ui.js +56 -56
  108. package/core/compliance.js +823 -823
  109. package/core/config.js +265 -265
  110. package/core/db-advanced.js +478 -481
  111. package/core/db.js +282 -284
  112. package/core/enhanced-hmr.js +406 -406
  113. package/core/errors.js +222 -222
  114. package/core/file-router.js +47 -47
  115. package/core/hmr-client.js +203 -204
  116. package/core/hmr.js +205 -197
  117. package/core/html.d.ts +30 -30
  118. package/core/html.js +84 -84
  119. package/core/hydration.js +52 -52
  120. package/core/lipa-namba-journey.js +548 -605
  121. package/core/logging.js +14 -14
  122. package/core/middleware.js +145 -145
  123. package/core/motion.js +106 -106
  124. package/core/nida-cig-middleware.js +417 -460
  125. package/core/patterns.d.ts +124 -124
  126. package/core/patterns.js +947 -1001
  127. package/core/plugins/index.js +345 -345
  128. package/core/request-analytics.js +253 -253
  129. package/core/request-identity.js +93 -93
  130. package/core/router.js +386 -386
  131. package/core/sdk-browser.js +140 -140
  132. package/core/sdk-client.js +61 -61
  133. package/core/sdk.d.ts +133 -133
  134. package/core/sdk.js +148 -148
  135. package/core/seo.js +76 -76
  136. package/core/server/auth-endpoints.js +339 -339
  137. package/core/server/auth.js +180 -180
  138. package/core/server/csrf.js +200 -206
  139. package/core/server/db.js +39 -39
  140. package/core/server/middleware.js +324 -324
  141. package/core/server/rate-limit.js +238 -238
  142. package/core/server/render.js +67 -69
  143. package/core/server/router.js +23 -11
  144. package/core/session-store.js +68 -68
  145. package/core/shim.js +28 -28
  146. package/core/state.d.ts +86 -86
  147. package/core/state.js +276 -276
  148. package/core/store.d.ts +122 -122
  149. package/core/store.js +61 -61
  150. package/core/validation.d.ts +232 -232
  151. package/core/validation.js +602 -602
  152. package/core/websocket.js +656 -641
  153. package/dist/africode.js +233 -230
  154. package/dist/africode.js.map +83 -83
  155. package/dist/build-info.json +3 -3
  156. package/dist/components.js +195 -192
  157. package/dist/components.js.map +73 -73
  158. package/dist/styles/africanity.css +321 -321
  159. package/dist/styles/typography.css +140 -140
  160. package/docs/IDE-Guide.md +50 -50
  161. package/package.json +113 -113
  162. package/scripts/generate-component-schema.js +82 -79
  163. package/styles/africanity.css +321 -321
  164. package/styles/typography.css +140 -140
  165. package/templates/starter/.env.example +15 -15
  166. package/templates/starter/africode.config.js +40 -40
  167. package/templates/starter/package.json +13 -13
  168. package/templates/starter/src/index.js +18 -18
  169. package/templates/starter/src/pages/index.html +55 -55
  170. package/templates/starter/src/pages/index.js +17 -17
  171. package/templates/starter/src/styles/main.css +3 -3
  172. package/templates/starter-3d/.env.example +7 -7
  173. package/templates/starter-3d/africode.config.js +29 -29
  174. package/templates/starter-3d/components/af-model-viewer.js +125 -125
  175. package/templates/starter-3d/package.json +14 -14
  176. package/templates/starter-3d/src/pages/index.html +55 -55
  177. package/templates/starter-3d/src/pages/index.js +50 -50
  178. package/templates/starter-3d/src/styles/main.css +3 -3
  179. package/templates/starter-dashboard/.env.example +21 -21
  180. package/templates/starter-dashboard/africode.config.js +20 -20
  181. package/templates/starter-dashboard/package.json +14 -14
  182. package/templates/starter-dashboard/src/index.js +17 -17
  183. package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
  184. package/templates/starter-dashboard/src/pages/index.html +118 -118
  185. package/templates/starter-dashboard/src/pages/index.js +110 -110
  186. package/templates/starter-dashboard/src/styles/main.css +172 -172
  187. package/templates/starter-fintech/.env.example +28 -28
  188. package/templates/starter-fintech/africode.config.js +20 -20
  189. package/templates/starter-fintech/package.json +15 -15
  190. package/templates/starter-fintech/src/index.js +17 -17
  191. package/templates/starter-fintech/src/pages/api/auth.js +45 -45
  192. package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
  193. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  194. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  195. package/templates/starter-fintech/src/pages/index.html +169 -169
  196. package/templates/starter-fintech/src/pages/index.js +161 -161
  197. package/templates/starter-fintech/src/styles/main.css +246 -246
  198. package/templates/starter-react/.env.example +15 -15
  199. package/templates/starter-react/africode.config.js +40 -40
  200. package/templates/starter-react/package.json +15 -15
  201. package/templates/starter-react/src/pages/index.html +55 -55
  202. package/templates/starter-react/src/pages/index.js +68 -68
  203. package/templates/starter-react/src/styles/main.css +3 -3
  204. package/templates/starter-tailwind/.env.example +15 -15
  205. package/templates/starter-tailwind/africode.config.js +40 -40
  206. package/templates/starter-tailwind/package.json +19 -19
  207. package/templates/starter-tailwind/src/pages/index.html +55 -55
  208. package/templates/starter-tailwind/src/pages/index.js +67 -67
  209. package/templates/starter-tailwind/src/styles/main.css +3 -3
  210. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  211. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  212. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  213. package/templates/starter-website/.env.example +18 -18
  214. package/templates/starter-website/africode.config.js +20 -20
  215. package/templates/starter-website/package.json +14 -14
  216. package/templates/starter-website/src/index.js +17 -17
  217. package/templates/starter-website/src/pages/index.html +124 -124
  218. package/templates/starter-website/src/pages/index.js +116 -116
  219. package/templates/starter-website/src/styles/main.css +195 -195
  220. package/bin/africode.js.1758507140 +0 -343
  221. package/core/heartbeat.js +0 -64
@@ -1,406 +1,406 @@
1
- /**
2
- * Enhanced HMR Middleware for AfriCode v5.0.0
3
- * Zero-downtime hot reload with session preservation
4
- *
5
- * Features:
6
- * - WebSocket-based file watching
7
- * - Graceful module replacement
8
- * - Database connection persistence
9
- * - Session state retention
10
- * - Soft reloads without full restart
11
- */
12
-
13
- import { watch } from 'node:fs';
14
- import { join, extname, dirname } from 'node:path';
15
- import { frameworkLog } from './logging.js';
16
-
17
- export class EnhancedHMRMiddleware {
18
- constructor(options = {}) {
19
- this.options = {
20
- port: options.port || 3001,
21
- watchPaths: options.watchPaths || ['pages', 'components', 'core', 'styles'],
22
- ignorePatterns: options.ignorePatterns || [
23
- 'node_modules',
24
- '.git',
25
- 'dist',
26
- '.bun',
27
- 'build',
28
- 'coverage',
29
- 'test-results',
30
- '*.test.js',
31
- '*.spec.js'
32
- ],
33
- debounceMs: options.debounceMs || 100,
34
- ...options
35
- };
36
-
37
- this.clients = new Set();
38
- this.watchers = new Map();
39
- this.fileChanges = new Map();
40
- this.sessions = new Map(); // Store session data during reloads
41
- this.dbConnections = new Map(); // Preserve database connections
42
- }
43
-
44
- /**
45
- * Initialize HMR server with Bun.serve integration
46
- */
47
- async initialize(devServer) {
48
- frameworkLog('log', `[HMR] Initializing enhanced hot reload on port ${this.options.port}`);
49
-
50
- // Setup WebSocket upgrade handler
51
- devServer.upgrade({
52
- open: (ws) => this.handleClientConnect(ws),
53
- message: (ws, message) => this.handleClientMessage(ws, message),
54
- close: (ws) => this.handleClientDisconnect(ws)
55
- });
56
-
57
- // Start file watching
58
- await this.startFileWatching();
59
-
60
- frameworkLog('log', `[HMR] Watching ${this.options.watchPaths.length} paths for changes...`);
61
- }
62
-
63
- /**
64
- * Handle new client connection
65
- */
66
- handleClientConnect(ws) {
67
- frameworkLog('log', `[HMR] Client connected from ${ws.remoteAddress}`);
68
- this.clients.add(ws);
69
-
70
- // Send welcome message with current state
71
- ws.send(JSON.stringify({
72
- type: 'welcome',
73
- timestamp: Date.now(),
74
- sessionId: this.generateSessionId()
75
- }));
76
- }
77
-
78
- /**
79
- * Handle client messages (ping, session data, etc.)
80
- */
81
- handleClientMessage(ws, message) {
82
- try {
83
- const data = JSON.parse(message);
84
-
85
- switch (data.type) {
86
- case 'ping':
87
- ws.send(JSON.stringify({ type: 'pong', timestamp: Date.now() }));
88
- break;
89
-
90
- case 'session-data':
91
- // Store session data for preservation during reloads
92
- this.sessions.set(data.sessionId, data.data);
93
- break;
94
-
95
- case 'db-connection':
96
- // Preserve database connection state
97
- this.dbConnections.set(data.connectionId, data.state);
98
- break;
99
-
100
- default:
101
- frameworkLog('log', `[HMR] Unknown message type: ${data.type}`);
102
- break;
103
- }
104
- } catch (error) {
105
- frameworkLog('error', '[HMR] Error parsing client message:', error);
106
- }
107
- }
108
-
109
- /**
110
- * Handle client disconnection
111
- */
112
- handleClientDisconnect(ws) {
113
- frameworkLog('log', '[HMR] Client disconnected');
114
- this.clients.delete(ws);
115
- }
116
-
117
- /**
118
- * Start watching files for changes
119
- */
120
- async startFileWatching() {
121
- const watchPromises = this.options.watchPaths.map(path =>
122
- this.watchDirectory(path)
123
- );
124
-
125
- await Promise.all(watchPromises);
126
- }
127
-
128
- /**
129
- * Watch a directory recursively
130
- */
131
- async watchDirectory(dirPath) {
132
- try {
133
- const watcher = watch(dirPath, { recursive: true }, (eventType, filename) => {
134
- if (!filename) return;
135
-
136
- const fullPath = join(dirPath, filename);
137
-
138
- // Check ignore patterns
139
- if (this.shouldIgnoreFile(fullPath)) return;
140
-
141
- // Debounce rapid changes
142
- const changeKey = fullPath;
143
- if (this.fileChanges.has(changeKey)) {
144
- clearTimeout(this.fileChanges.get(changeKey));
145
- }
146
-
147
- const timeoutId = setTimeout(() => {
148
- this.handleFileChange(filename, fullPath);
149
- this.fileChanges.delete(changeKey);
150
- }, this.options.debounceMs);
151
-
152
- this.fileChanges.set(changeKey, timeoutId);
153
- });
154
-
155
- this.watchers.set(dirPath, watcher);
156
- frameworkLog('log', `[HMR] Watching directory: ${dirPath}`);
157
-
158
- } catch (error) {
159
- frameworkLog('error', `[HMR] Failed to watch ${dirPath}:`, error.message);
160
- }
161
- }
162
-
163
- /**
164
- * Check if file should be ignored
165
- */
166
- shouldIgnoreFile(filePath) {
167
- const normalizedPath = filePath.replace(/\\/g, '/');
168
-
169
- return this.options.ignorePatterns.some(pattern => {
170
- if (pattern.includes('*')) {
171
- // Simple glob matching
172
- const regex = new RegExp(pattern.replace(/\*/g, '.*'));
173
- return regex.test(normalizedPath);
174
- }
175
- return normalizedPath.includes(pattern);
176
- });
177
- }
178
-
179
- /**
180
- * Handle file change and determine reload strategy
181
- */
182
- handleFileChange(filename, fullPath) {
183
- const ext = extname(filename);
184
- const relativePath = this.getRelativePath(fullPath);
185
-
186
- frameworkLog('log', `[HMR] File changed: ${relativePath}`);
187
-
188
- // Determine change type and reload strategy
189
- const changeType = this.classifyChange(filename, ext);
190
-
191
- switch (changeType) {
192
- case 'page':
193
- this.handlePageChange(relativePath);
194
- break;
195
-
196
- case 'component':
197
- this.handleComponentChange(relativePath);
198
- break;
199
-
200
- case 'core':
201
- this.handleCoreChange(relativePath);
202
- break;
203
-
204
- case 'style':
205
- this.handleStyleChange(relativePath);
206
- break;
207
-
208
- case 'config':
209
- this.handleConfigChange(relativePath);
210
- break;
211
-
212
- default:
213
- this.handleGenericChange(relativePath);
214
- }
215
- }
216
-
217
- /**
218
- * Classify the type of file change
219
- */
220
- classifyChange(filename, ext) {
221
- if (filename.includes('pages/')) {
222
- return ext === '.html' ? 'page' : 'api';
223
- }
224
-
225
- if (filename.includes('components/')) {
226
- return 'component';
227
- }
228
-
229
- if (filename.includes('core/')) {
230
- return 'core';
231
- }
232
-
233
- if (ext === '.css') {
234
- return 'style';
235
- }
236
-
237
- if (filename.includes('config') || filename.includes('bunfig')) {
238
- return 'config';
239
- }
240
-
241
- return 'generic';
242
- }
243
-
244
- /**
245
- * Handle page changes (soft reload)
246
- */
247
- handlePageChange(relativePath) {
248
- this.broadcast({
249
- type: 'page-update',
250
- path: relativePath,
251
- strategy: 'soft-reload',
252
- preserveSession: true,
253
- timestamp: Date.now()
254
- });
255
- }
256
-
257
- /**
258
- * Handle component changes (hot swap)
259
- */
260
- handleComponentChange(relativePath) {
261
- this.broadcast({
262
- type: 'component-update',
263
- path: relativePath,
264
- strategy: 'hot-swap',
265
- componentName: this.extractComponentName(relativePath),
266
- timestamp: Date.now()
267
- });
268
- }
269
-
270
- /**
271
- * Handle core module changes (full reload required)
272
- */
273
- handleCoreChange(relativePath) {
274
- frameworkLog('log', `[HMR] Core module changed, triggering full reload: ${relativePath}`);
275
-
276
- this.broadcast({
277
- type: 'core-update',
278
- path: relativePath,
279
- strategy: 'full-reload',
280
- preserveSession: true,
281
- preserveConnections: true,
282
- timestamp: Date.now()
283
- });
284
- }
285
-
286
- /**
287
- * Handle style changes (CSS injection)
288
- */
289
- handleStyleChange(relativePath) {
290
- this.broadcast({
291
- type: 'style-update',
292
- path: relativePath,
293
- strategy: 'css-injection',
294
- timestamp: Date.now()
295
- });
296
- }
297
-
298
- /**
299
- * Handle config changes (server restart)
300
- */
301
- handleConfigChange(relativePath) {
302
- frameworkLog('log', `[HMR] Config changed, server restart required: ${relativePath}`);
303
-
304
- this.broadcast({
305
- type: 'config-update',
306
- path: relativePath,
307
- strategy: 'server-restart',
308
- timestamp: Date.now()
309
- });
310
- }
311
-
312
- /**
313
- * Handle generic file changes
314
- */
315
- handleGenericChange(relativePath) {
316
- this.broadcast({
317
- type: 'file-update',
318
- path: relativePath,
319
- strategy: 'soft-reload',
320
- timestamp: Date.now()
321
- });
322
- }
323
-
324
- /**
325
- * Broadcast message to all connected clients
326
- */
327
- broadcast(message) {
328
- const messageStr = JSON.stringify(message);
329
-
330
- for (const client of this.clients) {
331
- try {
332
- client.send(messageStr);
333
- } catch (error) {
334
- frameworkLog('error', '[HMR] Failed to send to client:', error);
335
- this.clients.delete(client);
336
- }
337
- }
338
- }
339
-
340
- /**
341
- * Extract component name from path
342
- */
343
- extractComponentName(path) {
344
- const match = path.match(/components\/([^/]+)\.js$/);
345
- return match ? match[1] : 'unknown';
346
- }
347
-
348
- /**
349
- * Get relative path from project root
350
- */
351
- getRelativePath(fullPath) {
352
- return fullPath.replace(process.cwd() + '/', '');
353
- }
354
-
355
- /**
356
- * Generate unique session ID
357
- */
358
- generateSessionId() {
359
- return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
360
- }
361
-
362
- /**
363
- * Get preserved session data
364
- */
365
- getSessionData(sessionId) {
366
- return this.sessions.get(sessionId) || {};
367
- }
368
-
369
- /**
370
- * Get preserved database connection state
371
- */
372
- getConnectionState(connectionId) {
373
- return this.dbConnections.get(connectionId) || {};
374
- }
375
-
376
- /**
377
- * Cleanup watchers on shutdown
378
- */
379
- async shutdown() {
380
- frameworkLog('log', '[HMR] Shutting down...');
381
-
382
- // Close all watchers
383
- for (const [path, watcher] of this.watchers) {
384
- watcher.close();
385
- }
386
- this.watchers.clear();
387
-
388
- // Close all client connections
389
- for (const client of this.clients) {
390
- try {
391
- client.close();
392
- } catch (error) {
393
- // Ignore errors during shutdown
394
- }
395
- }
396
- this.clients.clear();
397
-
398
- // Clear session data
399
- this.sessions.clear();
400
- this.dbConnections.clear();
401
-
402
- frameworkLog('log', '[HMR] Shutdown complete');
403
- }
404
- }
405
-
406
- export default EnhancedHMRMiddleware;
1
+ /**
2
+ * Enhanced HMR Middleware for AfriCode v5.0.0
3
+ * Zero-downtime hot reload with session preservation
4
+ *
5
+ * Features:
6
+ * - WebSocket-based file watching
7
+ * - Graceful module replacement
8
+ * - Database connection persistence
9
+ * - Session state retention
10
+ * - Soft reloads without full restart
11
+ */
12
+
13
+ import { watch } from 'node:fs';
14
+ import { join, extname } from 'node:path';
15
+ import { frameworkLog } from './logging.js';
16
+
17
+ export class EnhancedHMRMiddleware {
18
+ constructor(options = {}) {
19
+ this.options = {
20
+ port: options.port || 3001,
21
+ watchPaths: options.watchPaths || ['pages', 'components', 'core', 'styles'],
22
+ ignorePatterns: options.ignorePatterns || [
23
+ 'node_modules',
24
+ '.git',
25
+ 'dist',
26
+ '.bun',
27
+ 'build',
28
+ 'coverage',
29
+ 'test-results',
30
+ '*.test.js',
31
+ '*.spec.js'
32
+ ],
33
+ debounceMs: options.debounceMs || 100,
34
+ ...options
35
+ };
36
+
37
+ this.clients = new Set();
38
+ this.watchers = new Map();
39
+ this.fileChanges = new Map();
40
+ this.sessions = new Map(); // Store session data during reloads
41
+ this.dbConnections = new Map(); // Preserve database connections
42
+ }
43
+
44
+ /**
45
+ * Initialize HMR server with Bun.serve integration
46
+ */
47
+ async initialize(devServer) {
48
+ frameworkLog('log', `[HMR] Initializing enhanced hot reload on port ${this.options.port}`);
49
+
50
+ // Setup WebSocket upgrade handler
51
+ devServer.upgrade({
52
+ open: (ws) => this.handleClientConnect(ws),
53
+ message: (ws, message) => this.handleClientMessage(ws, message),
54
+ close: (ws) => this.handleClientDisconnect(ws)
55
+ });
56
+
57
+ // Start file watching
58
+ await this.startFileWatching();
59
+
60
+ frameworkLog('log', `[HMR] Watching ${this.options.watchPaths.length} paths for changes...`);
61
+ }
62
+
63
+ /**
64
+ * Handle new client connection
65
+ */
66
+ handleClientConnect(ws) {
67
+ frameworkLog('log', `[HMR] Client connected from ${ws.remoteAddress}`);
68
+ this.clients.add(ws);
69
+
70
+ // Send welcome message with current state
71
+ ws.send(JSON.stringify({
72
+ type: 'welcome',
73
+ timestamp: Date.now(),
74
+ sessionId: this.generateSessionId()
75
+ }));
76
+ }
77
+
78
+ /**
79
+ * Handle client messages (ping, session data, etc.)
80
+ */
81
+ handleClientMessage(ws, message) {
82
+ try {
83
+ const data = JSON.parse(message);
84
+
85
+ switch (data.type) {
86
+ case 'ping':
87
+ ws.send(JSON.stringify({ type: 'pong', timestamp: Date.now() }));
88
+ break;
89
+
90
+ case 'session-data':
91
+ // Store session data for preservation during reloads
92
+ this.sessions.set(data.sessionId, data.data);
93
+ break;
94
+
95
+ case 'db-connection':
96
+ // Preserve database connection state
97
+ this.dbConnections.set(data.connectionId, data.state);
98
+ break;
99
+
100
+ default:
101
+ frameworkLog('log', `[HMR] Unknown message type: ${data.type}`);
102
+ break;
103
+ }
104
+ } catch (error) {
105
+ frameworkLog('error', '[HMR] Error parsing client message:', error);
106
+ }
107
+ }
108
+
109
+ /**
110
+ * Handle client disconnection
111
+ */
112
+ handleClientDisconnect(ws) {
113
+ frameworkLog('log', '[HMR] Client disconnected');
114
+ this.clients.delete(ws);
115
+ }
116
+
117
+ /**
118
+ * Start watching files for changes
119
+ */
120
+ async startFileWatching() {
121
+ const watchPromises = this.options.watchPaths.map(path =>
122
+ this.watchDirectory(path)
123
+ );
124
+
125
+ await Promise.all(watchPromises);
126
+ }
127
+
128
+ /**
129
+ * Watch a directory recursively
130
+ */
131
+ async watchDirectory(dirPath) {
132
+ try {
133
+ const watcher = watch(dirPath, { recursive: true }, (eventType, filename) => {
134
+ if (!filename) {return;}
135
+
136
+ const fullPath = join(dirPath, filename);
137
+
138
+ // Check ignore patterns
139
+ if (this.shouldIgnoreFile(fullPath)) {return;}
140
+
141
+ // Debounce rapid changes
142
+ const changeKey = fullPath;
143
+ if (this.fileChanges.has(changeKey)) {
144
+ clearTimeout(this.fileChanges.get(changeKey));
145
+ }
146
+
147
+ const timeoutId = setTimeout(() => {
148
+ this.handleFileChange(filename, fullPath);
149
+ this.fileChanges.delete(changeKey);
150
+ }, this.options.debounceMs);
151
+
152
+ this.fileChanges.set(changeKey, timeoutId);
153
+ });
154
+
155
+ this.watchers.set(dirPath, watcher);
156
+ frameworkLog('log', `[HMR] Watching directory: ${dirPath}`);
157
+
158
+ } catch (error) {
159
+ frameworkLog('error', `[HMR] Failed to watch ${dirPath}:`, error.message);
160
+ }
161
+ }
162
+
163
+ /**
164
+ * Check if file should be ignored
165
+ */
166
+ shouldIgnoreFile(filePath) {
167
+ const normalizedPath = filePath.replace(/\\/g, '/');
168
+
169
+ return this.options.ignorePatterns.some(pattern => {
170
+ if (pattern.includes('*')) {
171
+ // Simple glob matching
172
+ const regex = new RegExp(pattern.replace(/\*/g, '.*'));
173
+ return regex.test(normalizedPath);
174
+ }
175
+ return normalizedPath.includes(pattern);
176
+ });
177
+ }
178
+
179
+ /**
180
+ * Handle file change and determine reload strategy
181
+ */
182
+ handleFileChange(filename, fullPath) {
183
+ const ext = extname(filename);
184
+ const relativePath = this.getRelativePath(fullPath);
185
+
186
+ frameworkLog('log', `[HMR] File changed: ${relativePath}`);
187
+
188
+ // Determine change type and reload strategy
189
+ const changeType = this.classifyChange(filename, ext);
190
+
191
+ switch (changeType) {
192
+ case 'page':
193
+ this.handlePageChange(relativePath);
194
+ break;
195
+
196
+ case 'component':
197
+ this.handleComponentChange(relativePath);
198
+ break;
199
+
200
+ case 'core':
201
+ this.handleCoreChange(relativePath);
202
+ break;
203
+
204
+ case 'style':
205
+ this.handleStyleChange(relativePath);
206
+ break;
207
+
208
+ case 'config':
209
+ this.handleConfigChange(relativePath);
210
+ break;
211
+
212
+ default:
213
+ this.handleGenericChange(relativePath);
214
+ }
215
+ }
216
+
217
+ /**
218
+ * Classify the type of file change
219
+ */
220
+ classifyChange(filename, ext) {
221
+ if (filename.includes('pages/')) {
222
+ return ext === '.html' ? 'page' : 'api';
223
+ }
224
+
225
+ if (filename.includes('components/')) {
226
+ return 'component';
227
+ }
228
+
229
+ if (filename.includes('core/')) {
230
+ return 'core';
231
+ }
232
+
233
+ if (ext === '.css') {
234
+ return 'style';
235
+ }
236
+
237
+ if (filename.includes('config') || filename.includes('bunfig')) {
238
+ return 'config';
239
+ }
240
+
241
+ return 'generic';
242
+ }
243
+
244
+ /**
245
+ * Handle page changes (soft reload)
246
+ */
247
+ handlePageChange(relativePath) {
248
+ this.broadcast({
249
+ type: 'page-update',
250
+ path: relativePath,
251
+ strategy: 'soft-reload',
252
+ preserveSession: true,
253
+ timestamp: Date.now()
254
+ });
255
+ }
256
+
257
+ /**
258
+ * Handle component changes (hot swap)
259
+ */
260
+ handleComponentChange(relativePath) {
261
+ this.broadcast({
262
+ type: 'component-update',
263
+ path: relativePath,
264
+ strategy: 'hot-swap',
265
+ componentName: this.extractComponentName(relativePath),
266
+ timestamp: Date.now()
267
+ });
268
+ }
269
+
270
+ /**
271
+ * Handle core module changes (full reload required)
272
+ */
273
+ handleCoreChange(relativePath) {
274
+ frameworkLog('log', `[HMR] Core module changed, triggering full reload: ${relativePath}`);
275
+
276
+ this.broadcast({
277
+ type: 'core-update',
278
+ path: relativePath,
279
+ strategy: 'full-reload',
280
+ preserveSession: true,
281
+ preserveConnections: true,
282
+ timestamp: Date.now()
283
+ });
284
+ }
285
+
286
+ /**
287
+ * Handle style changes (CSS injection)
288
+ */
289
+ handleStyleChange(relativePath) {
290
+ this.broadcast({
291
+ type: 'style-update',
292
+ path: relativePath,
293
+ strategy: 'css-injection',
294
+ timestamp: Date.now()
295
+ });
296
+ }
297
+
298
+ /**
299
+ * Handle config changes (server restart)
300
+ */
301
+ handleConfigChange(relativePath) {
302
+ frameworkLog('log', `[HMR] Config changed, server restart required: ${relativePath}`);
303
+
304
+ this.broadcast({
305
+ type: 'config-update',
306
+ path: relativePath,
307
+ strategy: 'server-restart',
308
+ timestamp: Date.now()
309
+ });
310
+ }
311
+
312
+ /**
313
+ * Handle generic file changes
314
+ */
315
+ handleGenericChange(relativePath) {
316
+ this.broadcast({
317
+ type: 'file-update',
318
+ path: relativePath,
319
+ strategy: 'soft-reload',
320
+ timestamp: Date.now()
321
+ });
322
+ }
323
+
324
+ /**
325
+ * Broadcast message to all connected clients
326
+ */
327
+ broadcast(message) {
328
+ const messageStr = JSON.stringify(message);
329
+
330
+ for (const client of this.clients) {
331
+ try {
332
+ client.send(messageStr);
333
+ } catch (error) {
334
+ frameworkLog('error', '[HMR] Failed to send to client:', error);
335
+ this.clients.delete(client);
336
+ }
337
+ }
338
+ }
339
+
340
+ /**
341
+ * Extract component name from path
342
+ */
343
+ extractComponentName(path) {
344
+ const match = path.match(/components\/([^/]+)\.js$/);
345
+ return match ? match[1] : 'unknown';
346
+ }
347
+
348
+ /**
349
+ * Get relative path from project root
350
+ */
351
+ getRelativePath(fullPath) {
352
+ return fullPath.replace(process.cwd() + '/', '');
353
+ }
354
+
355
+ /**
356
+ * Generate unique session ID
357
+ */
358
+ generateSessionId() {
359
+ return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
360
+ }
361
+
362
+ /**
363
+ * Get preserved session data
364
+ */
365
+ getSessionData(sessionId) {
366
+ return this.sessions.get(sessionId) || {};
367
+ }
368
+
369
+ /**
370
+ * Get preserved database connection state
371
+ */
372
+ getConnectionState(connectionId) {
373
+ return this.dbConnections.get(connectionId) || {};
374
+ }
375
+
376
+ /**
377
+ * Cleanup watchers on shutdown
378
+ */
379
+ async shutdown() {
380
+ frameworkLog('log', '[HMR] Shutting down...');
381
+
382
+ // Close all watchers
383
+ for (const watcher of this.watchers.values()) {
384
+ watcher.close();
385
+ }
386
+ this.watchers.clear();
387
+
388
+ // Close all client connections
389
+ for (const client of this.clients) {
390
+ try {
391
+ client.close();
392
+ } catch {
393
+ // Ignore errors during shutdown
394
+ }
395
+ }
396
+ this.clients.clear();
397
+
398
+ // Clear session data
399
+ this.sessions.clear();
400
+ this.dbConnections.clear();
401
+
402
+ frameworkLog('log', '[HMR] Shutdown complete');
403
+ }
404
+ }
405
+
406
+ export default EnhancedHMRMiddleware;