@africode/core 5.0.10 → 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.
- package/AGENTS.md +585 -585
- package/AGENT_INSTRUCTIONS.md +595 -595
- package/COMPONENT_SCHEMA.json +1826 -1800
- package/LICENSE +623 -623
- package/README.md +476 -476
- package/bin/africode.js +73 -73
- package/bin/cli.ts +82 -82
- package/bin/create-africode.js +220 -220
- package/bin/scaffold.ts +218 -218
- package/components/accordion.js +183 -183
- package/components/alert.js +131 -131
- package/components/auth-form.js +154 -154
- package/components/auth.js +172 -172
- package/components/avatar.js +117 -117
- package/components/badge.js +104 -104
- package/components/base.d.ts +139 -139
- package/components/base.js +234 -234
- package/components/breadcrumb.js +76 -72
- package/components/button.js +164 -164
- package/components/card.js +144 -137
- package/components/carousel.js +32 -32
- package/components/cart-drawer.js +28 -28
- package/components/code-block.js +20 -20
- package/components/contact-form.js +25 -25
- package/components/cookie-consent.js +23 -23
- package/components/cta-banner.js +38 -38
- package/components/cultural-card.js +243 -243
- package/components/dashboard-activity-list.js +103 -103
- package/components/dashboard-card.js +85 -85
- package/components/dashboard-metric.js +81 -81
- package/components/dashboard-shell.js +85 -85
- package/components/dashboard-topbar.js +84 -84
- package/components/divider.js +83 -83
- package/components/dropdown.js +171 -171
- package/components/error-boundary.js +155 -155
- package/components/faq-accordion.js +23 -23
- package/components/feature-grid.js +85 -85
- package/components/file-uploader.js +22 -22
- package/components/filter-bar.js +19 -19
- package/components/footer.js +113 -113
- package/components/form.js +131 -131
- package/components/gallery.js +22 -22
- package/components/hero.js +140 -138
- package/components/icon.js +36 -36
- package/components/index.js +128 -128
- package/components/input.js +252 -256
- package/components/kanga-card.js +185 -185
- package/components/kyc-upload.js +173 -173
- package/components/language-switcher.js +108 -108
- package/components/loader.js +80 -80
- package/components/modal.js +262 -262
- package/components/motion.js +84 -84
- package/components/nav-drawer.js +216 -216
- package/components/navbar.js +243 -236
- package/components/newsletter-signup.js +24 -24
- package/components/pagination.js +31 -31
- package/components/pattern-showcase.js +225 -225
- package/components/pricing-card.js +100 -100
- package/components/product-card.js +41 -41
- package/components/progress.js +132 -134
- package/components/react.js +111 -111
- package/components/search-box.js +24 -24
- package/components/section.js +54 -54
- package/components/select.js +321 -322
- package/components/sidebar.js +180 -180
- package/components/simple-chart.js +22 -22
- package/components/skeleton.js +85 -85
- package/components/stepper.js +28 -28
- package/components/table.js +181 -181
- package/components/tabs.js +202 -202
- package/components/team-grid.js +23 -23
- package/components/testimonial.js +94 -94
- package/components/theme-toggle.js +82 -82
- package/components/toast.js +139 -139
- package/components/tooltip.js +167 -167
- package/components/transaction-ledger.js +138 -138
- package/components/ui-avatar.js +79 -79
- package/components/ui-badge.js +61 -61
- package/components/ui-button.js +149 -149
- package/components/ui-card.js +74 -75
- package/components/ui-chip.js +87 -87
- package/components/ui-input.js +110 -110
- package/components/ui-popover.js +84 -84
- package/components/ui-progress-ring.js +60 -60
- package/components/ui-select.js +85 -85
- package/components/ui-stat.js +75 -75
- package/components/ui-switch.js +85 -85
- package/components/ui-table.js +69 -69
- package/components/ui-tabs.js +99 -99
- package/components/ui-tag.js +64 -64
- package/components/ui-textarea.js +84 -84
- package/components/ui-tooltip.js +66 -66
- package/components/video-player.js +22 -22
- package/components/wallet-balance.js +114 -114
- package/core/a2ui-schema-manager.js +351 -351
- package/core/a2ui.js +696 -696
- package/core/actions.js +27 -27
- package/core/bun-runtime.js +398 -397
- package/core/cli/commands/add.js +23 -23
- package/core/cli/commands/audit.js +58 -58
- package/core/cli/commands/build.js +193 -193
- package/core/cli/commands/create-plugin.js +241 -241
- package/core/cli/commands/dev.js +252 -285
- package/core/cli/commands/lint.js +23 -23
- package/core/cli/commands/test.js +33 -34
- package/core/cli/migrator.js +71 -71
- package/core/cli/ui.js +56 -56
- package/core/compliance.js +823 -823
- package/core/config.js +265 -265
- package/core/db-advanced.js +478 -481
- package/core/db.js +282 -284
- package/core/enhanced-hmr.js +406 -406
- package/core/errors.js +222 -222
- package/core/file-router.js +52 -50
- package/core/hmr-client.js +203 -204
- package/core/hmr.js +205 -197
- package/core/html.d.ts +30 -30
- package/core/html.js +84 -84
- package/core/hydration.js +52 -52
- package/core/lipa-namba-journey.js +548 -605
- package/core/logging.js +14 -14
- package/core/middleware.js +145 -145
- package/core/motion.js +106 -106
- package/core/nida-cig-middleware.js +417 -460
- package/core/patterns.d.ts +124 -124
- package/core/patterns.js +947 -1001
- package/core/plugins/index.js +345 -345
- package/core/request-analytics.js +253 -253
- package/core/request-identity.js +93 -93
- package/core/router.js +386 -386
- package/core/sdk-browser.js +140 -140
- package/core/sdk-client.js +61 -61
- package/core/sdk.d.ts +133 -133
- package/core/sdk.js +148 -148
- package/core/seo.js +76 -76
- package/core/server/auth-endpoints.js +339 -339
- package/core/server/auth.js +180 -180
- package/core/server/csrf.js +200 -206
- package/core/server/db.js +39 -39
- package/core/server/middleware.js +324 -324
- package/core/server/rate-limit.js +238 -238
- package/core/server/render.js +67 -69
- package/core/server/router.js +102 -120
- package/core/session-store.js +68 -68
- package/core/shim.js +28 -28
- package/core/state.d.ts +86 -86
- package/core/state.js +276 -276
- package/core/store.d.ts +122 -122
- package/core/store.js +61 -61
- package/core/validation.d.ts +232 -232
- package/core/validation.js +602 -602
- package/core/websocket.js +656 -641
- package/dist/africode.js +233 -230
- package/dist/africode.js.map +83 -83
- package/dist/build-info.json +3 -3
- package/dist/components.js +195 -192
- package/dist/components.js.map +73 -73
- package/dist/styles/africanity.css +321 -321
- package/dist/styles/typography.css +140 -140
- package/docs/IDE-Guide.md +50 -50
- package/package.json +113 -113
- package/scripts/generate-component-schema.js +82 -79
- package/styles/africanity.css +321 -321
- package/styles/typography.css +140 -140
- package/templates/starter/.env.example +15 -15
- package/templates/starter/africode.config.js +40 -40
- package/templates/starter/package.json +13 -13
- package/templates/starter/src/index.js +18 -18
- package/templates/starter/src/pages/index.html +55 -55
- package/templates/starter/src/pages/index.js +17 -17
- package/templates/starter/src/styles/main.css +3 -3
- package/templates/starter-3d/.env.example +7 -7
- package/templates/starter-3d/africode.config.js +29 -29
- package/templates/starter-3d/components/af-model-viewer.js +125 -125
- package/templates/starter-3d/package.json +14 -14
- package/templates/starter-3d/src/pages/index.html +55 -55
- package/templates/starter-3d/src/pages/index.js +50 -50
- package/templates/starter-3d/src/styles/main.css +3 -3
- package/templates/starter-dashboard/.env.example +21 -21
- package/templates/starter-dashboard/africode.config.js +20 -20
- package/templates/starter-dashboard/package.json +14 -14
- package/templates/starter-dashboard/src/index.js +17 -17
- package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
- package/templates/starter-dashboard/src/pages/index.html +118 -118
- package/templates/starter-dashboard/src/pages/index.js +110 -110
- package/templates/starter-dashboard/src/styles/main.css +172 -172
- package/templates/starter-fintech/.env.example +28 -28
- package/templates/starter-fintech/africode.config.js +20 -20
- package/templates/starter-fintech/package.json +15 -15
- package/templates/starter-fintech/src/index.js +17 -17
- package/templates/starter-fintech/src/pages/api/auth.js +45 -45
- package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
- package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
- package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
- package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
- package/templates/starter-fintech/src/pages/index.html +169 -169
- package/templates/starter-fintech/src/pages/index.js +161 -161
- package/templates/starter-fintech/src/styles/main.css +246 -246
- package/templates/starter-react/.env.example +15 -15
- package/templates/starter-react/africode.config.js +40 -40
- package/templates/starter-react/package.json +15 -15
- package/templates/starter-react/src/pages/index.html +55 -55
- package/templates/starter-react/src/pages/index.js +68 -68
- package/templates/starter-react/src/styles/main.css +3 -3
- package/templates/starter-tailwind/.env.example +15 -15
- package/templates/starter-tailwind/africode.config.js +40 -40
- package/templates/starter-tailwind/package.json +19 -19
- package/templates/starter-tailwind/src/pages/index.html +55 -55
- package/templates/starter-tailwind/src/pages/index.js +67 -67
- package/templates/starter-tailwind/src/styles/main.css +3 -3
- package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
- package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
- package/templates/starter-tailwind/tailwind.config.cjs +18 -18
- package/templates/starter-website/.env.example +18 -18
- package/templates/starter-website/africode.config.js +20 -20
- package/templates/starter-website/package.json +14 -14
- package/templates/starter-website/src/index.js +17 -17
- package/templates/starter-website/src/pages/index.html +124 -124
- package/templates/starter-website/src/pages/index.js +116 -116
- package/templates/starter-website/src/styles/main.css +195 -195
- package/bin/africode.js.1758507140 +0 -343
- package/core/heartbeat.js +0 -64
package/core/enhanced-hmr.js
CHANGED
|
@@ -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
|
|
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
|
|
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;
|
|
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;
|