@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.
- 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 +396 -396
- 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 +248 -283
- 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 +47 -47
- 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 +23 -11
- 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/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
|
@@ -1,238 +1,238 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode Rate Limiting Middleware
|
|
3
|
-
*
|
|
4
|
-
* In-memory sliding window rate limiter for API endpoints.
|
|
5
|
-
* Framework-level middleware — protect by default.
|
|
6
|
-
*
|
|
7
|
-
* Algorithm: Fixed window with sliding expiry
|
|
8
|
-
* - Each client (identified by IP) gets a counter per window
|
|
9
|
-
* - When the window expires, the counter resets
|
|
10
|
-
* - If the counter exceeds the limit, requests are rejected with 429
|
|
11
|
-
*
|
|
12
|
-
* Limitations:
|
|
13
|
-
* - In-memory only (resets on server restart)
|
|
14
|
-
* - Single-process only (not shared across workers/instances)
|
|
15
|
-
* - For production multi-instance environments, use Redis-backed rate limiting
|
|
16
|
-
*
|
|
17
|
-
* Future: This interface is designed so a Redis/KV adapter can be
|
|
18
|
-
* swapped in without changing the middleware API.
|
|
19
|
-
*
|
|
20
|
-
* @module core/server/rate-limit
|
|
21
|
-
*/
|
|
22
|
-
|
|
23
|
-
import { RateLimitError } from '../errors.js';
|
|
24
|
-
import { emitRateLimit } from '../config.js';
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* @typedef {Object} RateLimitConfig
|
|
28
|
-
* @property {number} [windowMs=60000] - Time window in milliseconds (default: 1 minute)
|
|
29
|
-
* @property {number} [maxRequests=60] - Maximum requests per window (default: 60)
|
|
30
|
-
* @property {string} [message='Too many requests'] - Error message
|
|
31
|
-
* @property {Function} [keyGenerator] - Custom key generator: (request) => string
|
|
32
|
-
* @property {string[]} [excludePaths=[]] - Paths that skip rate limiting
|
|
33
|
-
* @property {Function} [onLimitReached] - Callback when limit is reached: (key, request) => void
|
|
34
|
-
* @property {Object} [headers=true] - Include rate limit headers in response
|
|
35
|
-
*/
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* In-memory rate limit store.
|
|
39
|
-
* Maps client keys to their request tracking data.
|
|
40
|
-
*
|
|
41
|
-
* @type {Map<string, { count: number, resetAt: number }>}
|
|
42
|
-
*/
|
|
43
|
-
const store = new Map();
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Cleanup interval reference.
|
|
47
|
-
* Periodically removes expired entries to prevent memory leaks.
|
|
48
|
-
*/
|
|
49
|
-
let cleanupInterval = null;
|
|
50
|
-
|
|
51
|
-
/**
|
|
52
|
-
* Get the client identifier from a request.
|
|
53
|
-
* Default: uses IP address from various headers.
|
|
54
|
-
*
|
|
55
|
-
* @param {Request} request
|
|
56
|
-
* @returns {string} Client identifier
|
|
57
|
-
*/
|
|
58
|
-
function defaultKeyGenerator(request) {
|
|
59
|
-
// Check standard headers in priority order
|
|
60
|
-
const forwarded = request.headers.get('X-Forwarded-For');
|
|
61
|
-
if (forwarded) {
|
|
62
|
-
// X-Forwarded-For can contain multiple IPs, take the first (client)
|
|
63
|
-
return forwarded.split(',')[0].trim();
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
const realIp = request.headers.get('X-Real-IP');
|
|
67
|
-
if (realIp) {return realIp;}
|
|
68
|
-
|
|
69
|
-
// Fallback: use the request URL host (not ideal, but safe fallback)
|
|
70
|
-
try {
|
|
71
|
-
const url = new URL(request.url);
|
|
72
|
-
return url.hostname;
|
|
73
|
-
} catch {
|
|
74
|
-
return 'unknown';
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
/**
|
|
79
|
-
* Create a rate limiting middleware.
|
|
80
|
-
*
|
|
81
|
-
* @param {RateLimitConfig} [config] - Configuration
|
|
82
|
-
* @returns {Function} Middleware function: (request) => { response: Response|null, headers: Record<string, string> }
|
|
83
|
-
*
|
|
84
|
-
* @example
|
|
85
|
-
* // Basic usage — 60 requests per minute
|
|
86
|
-
* const limiter = createRateLimiter();
|
|
87
|
-
*
|
|
88
|
-
* // In your request handler:
|
|
89
|
-
* const { response, headers } = limiter(request);
|
|
90
|
-
* if (response) return response; // 429 Too Many Requests
|
|
91
|
-
* // Add headers to your success response for transparency
|
|
92
|
-
*
|
|
93
|
-
* @example
|
|
94
|
-
* // Custom limits for auth endpoints
|
|
95
|
-
* const authLimiter = createRateLimiter({
|
|
96
|
-
* windowMs: 15 * 60 * 1000, // 15 minutes
|
|
97
|
-
* maxRequests: 5, // 5 attempts
|
|
98
|
-
* message: 'Too many login attempts. Please try again later.',
|
|
99
|
-
* onLimitReached: (key) => console.warn(`Rate limit reached for ${key}`)
|
|
100
|
-
* });
|
|
101
|
-
*
|
|
102
|
-
* @example
|
|
103
|
-
* // Skip rate limiting for certain paths
|
|
104
|
-
* const limiter = createRateLimiter({
|
|
105
|
-
* excludePaths: ['/api/health', '/api/status']
|
|
106
|
-
* });
|
|
107
|
-
*/
|
|
108
|
-
export function createRateLimiter(config = {}) {
|
|
109
|
-
const {
|
|
110
|
-
windowMs = 60 * 1000, // 1 minute
|
|
111
|
-
maxRequests = 60, // 60 requests per window
|
|
112
|
-
message = 'Too many requests. Please try again later.',
|
|
113
|
-
keyGenerator = defaultKeyGenerator,
|
|
114
|
-
excludePaths = [],
|
|
115
|
-
onLimitReached = null
|
|
116
|
-
} = config;
|
|
117
|
-
|
|
118
|
-
// Start cleanup interval if not already running
|
|
119
|
-
if (!cleanupInterval) {
|
|
120
|
-
cleanupInterval = setInterval(() => {
|
|
121
|
-
const now = Date.now();
|
|
122
|
-
for (const [key, data] of store.entries()) {
|
|
123
|
-
if (now >= data.resetAt) {
|
|
124
|
-
store.delete(key);
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
|
-
}, windowMs);
|
|
128
|
-
|
|
129
|
-
// Don't keep the process alive just for cleanup
|
|
130
|
-
if (cleanupInterval.unref) {
|
|
131
|
-
cleanupInterval.unref();
|
|
132
|
-
}
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
/**
|
|
136
|
-
* @param {Request} request
|
|
137
|
-
* @returns {{ response: Response|null, headers: Record<string, string> }}
|
|
138
|
-
*/
|
|
139
|
-
return function rateLimitMiddleware(request) {
|
|
140
|
-
// Check excluded paths
|
|
141
|
-
try {
|
|
142
|
-
const url = new URL(request.url);
|
|
143
|
-
if (excludePaths.some(path => url.pathname.startsWith(path))) {
|
|
144
|
-
return { response: null, headers: {} };
|
|
145
|
-
}
|
|
146
|
-
} catch {
|
|
147
|
-
// Invalid URL, continue with rate limiting
|
|
148
|
-
}
|
|
149
|
-
|
|
150
|
-
const key = keyGenerator(request);
|
|
151
|
-
const now = Date.now();
|
|
152
|
-
|
|
153
|
-
// Get or create entry
|
|
154
|
-
let entry = store.get(key);
|
|
155
|
-
|
|
156
|
-
if (!entry || now >= entry.resetAt) {
|
|
157
|
-
// Window expired or new client — reset
|
|
158
|
-
entry = { count: 0, resetAt: now + windowMs };
|
|
159
|
-
store.set(key, entry);
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
// Increment count
|
|
163
|
-
entry.count++;
|
|
164
|
-
|
|
165
|
-
// Build rate limit headers (always returned for transparency)
|
|
166
|
-
const remaining = Math.max(0, maxRequests - entry.count);
|
|
167
|
-
const resetAtSeconds = Math.ceil(entry.resetAt / 1000);
|
|
168
|
-
const headers = {
|
|
169
|
-
'X-RateLimit-Limit': String(maxRequests),
|
|
170
|
-
'X-RateLimit-Remaining': String(remaining),
|
|
171
|
-
'X-RateLimit-Reset': String(resetAtSeconds)
|
|
172
|
-
};
|
|
173
|
-
|
|
174
|
-
// Check if over limit
|
|
175
|
-
if (entry.count > maxRequests) {
|
|
176
|
-
const retryAfter = Math.ceil((entry.resetAt - now) / 1000);
|
|
177
|
-
|
|
178
|
-
// Emit hook
|
|
179
|
-
emitRateLimit(key, request);
|
|
180
|
-
|
|
181
|
-
// Call user callback if provided
|
|
182
|
-
if (onLimitReached) {
|
|
183
|
-
onLimitReached(key, request);
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
const error = new RateLimitError(retryAfter, message);
|
|
187
|
-
|
|
188
|
-
return {
|
|
189
|
-
response: new Response(
|
|
190
|
-
JSON.stringify(error.toJSON()),
|
|
191
|
-
{
|
|
192
|
-
status: 429,
|
|
193
|
-
headers: {
|
|
194
|
-
'Content-Type': 'application/json',
|
|
195
|
-
'Retry-After': String(retryAfter),
|
|
196
|
-
...headers
|
|
197
|
-
}
|
|
198
|
-
}
|
|
199
|
-
),
|
|
200
|
-
headers
|
|
201
|
-
};
|
|
202
|
-
}
|
|
203
|
-
|
|
204
|
-
// Under limit — pass through
|
|
205
|
-
return { response: null, headers };
|
|
206
|
-
};
|
|
207
|
-
}
|
|
208
|
-
|
|
209
|
-
/**
|
|
210
|
-
* Reset the rate limit store.
|
|
211
|
-
* Useful for testing or administrative purposes.
|
|
212
|
-
*/
|
|
213
|
-
export function resetRateLimitStore() {
|
|
214
|
-
store.clear();
|
|
215
|
-
}
|
|
216
|
-
|
|
217
|
-
/**
|
|
218
|
-
* Get the current store size (number of tracked clients).
|
|
219
|
-
* Useful for monitoring.
|
|
220
|
-
*
|
|
221
|
-
* @returns {number}
|
|
222
|
-
*/
|
|
223
|
-
export function getRateLimitStoreSize() {
|
|
224
|
-
return store.size;
|
|
225
|
-
}
|
|
226
|
-
|
|
227
|
-
/**
|
|
228
|
-
* Stop the cleanup interval.
|
|
229
|
-
* Call this during server shutdown.
|
|
230
|
-
*/
|
|
231
|
-
export function stopRateLimitCleanup() {
|
|
232
|
-
if (cleanupInterval) {
|
|
233
|
-
clearInterval(cleanupInterval);
|
|
234
|
-
cleanupInterval = null;
|
|
235
|
-
}
|
|
236
|
-
}
|
|
237
|
-
|
|
238
|
-
export default { createRateLimiter, resetRateLimitStore, getRateLimitStoreSize, stopRateLimitCleanup };
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode Rate Limiting Middleware
|
|
3
|
+
*
|
|
4
|
+
* In-memory sliding window rate limiter for API endpoints.
|
|
5
|
+
* Framework-level middleware — protect by default.
|
|
6
|
+
*
|
|
7
|
+
* Algorithm: Fixed window with sliding expiry
|
|
8
|
+
* - Each client (identified by IP) gets a counter per window
|
|
9
|
+
* - When the window expires, the counter resets
|
|
10
|
+
* - If the counter exceeds the limit, requests are rejected with 429
|
|
11
|
+
*
|
|
12
|
+
* Limitations:
|
|
13
|
+
* - In-memory only (resets on server restart)
|
|
14
|
+
* - Single-process only (not shared across workers/instances)
|
|
15
|
+
* - For production multi-instance environments, use Redis-backed rate limiting
|
|
16
|
+
*
|
|
17
|
+
* Future: This interface is designed so a Redis/KV adapter can be
|
|
18
|
+
* swapped in without changing the middleware API.
|
|
19
|
+
*
|
|
20
|
+
* @module core/server/rate-limit
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
import { RateLimitError } from '../errors.js';
|
|
24
|
+
import { emitRateLimit } from '../config.js';
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* @typedef {Object} RateLimitConfig
|
|
28
|
+
* @property {number} [windowMs=60000] - Time window in milliseconds (default: 1 minute)
|
|
29
|
+
* @property {number} [maxRequests=60] - Maximum requests per window (default: 60)
|
|
30
|
+
* @property {string} [message='Too many requests'] - Error message
|
|
31
|
+
* @property {Function} [keyGenerator] - Custom key generator: (request) => string
|
|
32
|
+
* @property {string[]} [excludePaths=[]] - Paths that skip rate limiting
|
|
33
|
+
* @property {Function} [onLimitReached] - Callback when limit is reached: (key, request) => void
|
|
34
|
+
* @property {Object} [headers=true] - Include rate limit headers in response
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* In-memory rate limit store.
|
|
39
|
+
* Maps client keys to their request tracking data.
|
|
40
|
+
*
|
|
41
|
+
* @type {Map<string, { count: number, resetAt: number }>}
|
|
42
|
+
*/
|
|
43
|
+
const store = new Map();
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Cleanup interval reference.
|
|
47
|
+
* Periodically removes expired entries to prevent memory leaks.
|
|
48
|
+
*/
|
|
49
|
+
let cleanupInterval = null;
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* Get the client identifier from a request.
|
|
53
|
+
* Default: uses IP address from various headers.
|
|
54
|
+
*
|
|
55
|
+
* @param {Request} request
|
|
56
|
+
* @returns {string} Client identifier
|
|
57
|
+
*/
|
|
58
|
+
function defaultKeyGenerator(request) {
|
|
59
|
+
// Check standard headers in priority order
|
|
60
|
+
const forwarded = request.headers.get('X-Forwarded-For');
|
|
61
|
+
if (forwarded) {
|
|
62
|
+
// X-Forwarded-For can contain multiple IPs, take the first (client)
|
|
63
|
+
return forwarded.split(',')[0].trim();
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const realIp = request.headers.get('X-Real-IP');
|
|
67
|
+
if (realIp) {return realIp;}
|
|
68
|
+
|
|
69
|
+
// Fallback: use the request URL host (not ideal, but safe fallback)
|
|
70
|
+
try {
|
|
71
|
+
const url = new URL(request.url);
|
|
72
|
+
return url.hostname;
|
|
73
|
+
} catch {
|
|
74
|
+
return 'unknown';
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Create a rate limiting middleware.
|
|
80
|
+
*
|
|
81
|
+
* @param {RateLimitConfig} [config] - Configuration
|
|
82
|
+
* @returns {Function} Middleware function: (request) => { response: Response|null, headers: Record<string, string> }
|
|
83
|
+
*
|
|
84
|
+
* @example
|
|
85
|
+
* // Basic usage — 60 requests per minute
|
|
86
|
+
* const limiter = createRateLimiter();
|
|
87
|
+
*
|
|
88
|
+
* // In your request handler:
|
|
89
|
+
* const { response, headers } = limiter(request);
|
|
90
|
+
* if (response) return response; // 429 Too Many Requests
|
|
91
|
+
* // Add headers to your success response for transparency
|
|
92
|
+
*
|
|
93
|
+
* @example
|
|
94
|
+
* // Custom limits for auth endpoints
|
|
95
|
+
* const authLimiter = createRateLimiter({
|
|
96
|
+
* windowMs: 15 * 60 * 1000, // 15 minutes
|
|
97
|
+
* maxRequests: 5, // 5 attempts
|
|
98
|
+
* message: 'Too many login attempts. Please try again later.',
|
|
99
|
+
* onLimitReached: (key) => console.warn(`Rate limit reached for ${key}`)
|
|
100
|
+
* });
|
|
101
|
+
*
|
|
102
|
+
* @example
|
|
103
|
+
* // Skip rate limiting for certain paths
|
|
104
|
+
* const limiter = createRateLimiter({
|
|
105
|
+
* excludePaths: ['/api/health', '/api/status']
|
|
106
|
+
* });
|
|
107
|
+
*/
|
|
108
|
+
export function createRateLimiter(config = {}) {
|
|
109
|
+
const {
|
|
110
|
+
windowMs = 60 * 1000, // 1 minute
|
|
111
|
+
maxRequests = 60, // 60 requests per window
|
|
112
|
+
message = 'Too many requests. Please try again later.',
|
|
113
|
+
keyGenerator = defaultKeyGenerator,
|
|
114
|
+
excludePaths = [],
|
|
115
|
+
onLimitReached = null
|
|
116
|
+
} = config;
|
|
117
|
+
|
|
118
|
+
// Start cleanup interval if not already running
|
|
119
|
+
if (!cleanupInterval) {
|
|
120
|
+
cleanupInterval = setInterval(() => {
|
|
121
|
+
const now = Date.now();
|
|
122
|
+
for (const [key, data] of store.entries()) {
|
|
123
|
+
if (now >= data.resetAt) {
|
|
124
|
+
store.delete(key);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}, windowMs);
|
|
128
|
+
|
|
129
|
+
// Don't keep the process alive just for cleanup
|
|
130
|
+
if (cleanupInterval.unref) {
|
|
131
|
+
cleanupInterval.unref();
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* @param {Request} request
|
|
137
|
+
* @returns {{ response: Response|null, headers: Record<string, string> }}
|
|
138
|
+
*/
|
|
139
|
+
return function rateLimitMiddleware(request) {
|
|
140
|
+
// Check excluded paths
|
|
141
|
+
try {
|
|
142
|
+
const url = new URL(request.url);
|
|
143
|
+
if (excludePaths.some(path => url.pathname.startsWith(path))) {
|
|
144
|
+
return { response: null, headers: {} };
|
|
145
|
+
}
|
|
146
|
+
} catch {
|
|
147
|
+
// Invalid URL, continue with rate limiting
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
const key = keyGenerator(request);
|
|
151
|
+
const now = Date.now();
|
|
152
|
+
|
|
153
|
+
// Get or create entry
|
|
154
|
+
let entry = store.get(key);
|
|
155
|
+
|
|
156
|
+
if (!entry || now >= entry.resetAt) {
|
|
157
|
+
// Window expired or new client — reset
|
|
158
|
+
entry = { count: 0, resetAt: now + windowMs };
|
|
159
|
+
store.set(key, entry);
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
// Increment count
|
|
163
|
+
entry.count++;
|
|
164
|
+
|
|
165
|
+
// Build rate limit headers (always returned for transparency)
|
|
166
|
+
const remaining = Math.max(0, maxRequests - entry.count);
|
|
167
|
+
const resetAtSeconds = Math.ceil(entry.resetAt / 1000);
|
|
168
|
+
const headers = {
|
|
169
|
+
'X-RateLimit-Limit': String(maxRequests),
|
|
170
|
+
'X-RateLimit-Remaining': String(remaining),
|
|
171
|
+
'X-RateLimit-Reset': String(resetAtSeconds)
|
|
172
|
+
};
|
|
173
|
+
|
|
174
|
+
// Check if over limit
|
|
175
|
+
if (entry.count > maxRequests) {
|
|
176
|
+
const retryAfter = Math.ceil((entry.resetAt - now) / 1000);
|
|
177
|
+
|
|
178
|
+
// Emit hook
|
|
179
|
+
emitRateLimit(key, request);
|
|
180
|
+
|
|
181
|
+
// Call user callback if provided
|
|
182
|
+
if (onLimitReached) {
|
|
183
|
+
onLimitReached(key, request);
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
const error = new RateLimitError(retryAfter, message);
|
|
187
|
+
|
|
188
|
+
return {
|
|
189
|
+
response: new Response(
|
|
190
|
+
JSON.stringify(error.toJSON()),
|
|
191
|
+
{
|
|
192
|
+
status: 429,
|
|
193
|
+
headers: {
|
|
194
|
+
'Content-Type': 'application/json',
|
|
195
|
+
'Retry-After': String(retryAfter),
|
|
196
|
+
...headers
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
),
|
|
200
|
+
headers
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
// Under limit — pass through
|
|
205
|
+
return { response: null, headers };
|
|
206
|
+
};
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* Reset the rate limit store.
|
|
211
|
+
* Useful for testing or administrative purposes.
|
|
212
|
+
*/
|
|
213
|
+
export function resetRateLimitStore() {
|
|
214
|
+
store.clear();
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Get the current store size (number of tracked clients).
|
|
219
|
+
* Useful for monitoring.
|
|
220
|
+
*
|
|
221
|
+
* @returns {number}
|
|
222
|
+
*/
|
|
223
|
+
export function getRateLimitStoreSize() {
|
|
224
|
+
return store.size;
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* Stop the cleanup interval.
|
|
229
|
+
* Call this during server shutdown.
|
|
230
|
+
*/
|
|
231
|
+
export function stopRateLimitCleanup() {
|
|
232
|
+
if (cleanupInterval) {
|
|
233
|
+
clearInterval(cleanupInterval);
|
|
234
|
+
cleanupInterval = null;
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
export default { createRateLimiter, resetRateLimitStore, getRateLimitStoreSize, stopRateLimitCleanup };
|
package/core/server/render.js
CHANGED
|
@@ -1,69 +1,67 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode SSR Engine
|
|
3
|
-
* Implements Declarative Shadow DOM (DSD) for instant loading.
|
|
4
|
-
*
|
|
5
|
-
* "The primary requirement... is the optimization of the rendering pipeline." - Blueprint
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
//
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
//
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
});
|
|
69
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode SSR Engine
|
|
3
|
+
* Implements Declarative Shadow DOM (DSD) for instant loading.
|
|
4
|
+
*
|
|
5
|
+
* "The primary requirement... is the optimization of the rendering pipeline." - Blueprint
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
// Registry of component definitions for SSR
|
|
9
|
+
// In a real framework, this would parse the component class
|
|
10
|
+
// For v1, we map tags to their Shadow DOM HTML
|
|
11
|
+
const componentRegistry = {
|
|
12
|
+
'af-navbar': (attrs) => `
|
|
13
|
+
<template shadowrootmode="open">
|
|
14
|
+
<style>
|
|
15
|
+
:host { display: block; font-family: 'Inter', system-ui; }
|
|
16
|
+
nav { background: #1EB53A; padding: 16px; color: white; display: flex; justify-content: space-between; }
|
|
17
|
+
.logo { font-weight: 800; font-size: 1.2rem; }
|
|
18
|
+
</style>
|
|
19
|
+
<nav>
|
|
20
|
+
<div class="logo">${attrs.logo || 'AfriCode'}</div>
|
|
21
|
+
<div class="links"><slot></slot></div>
|
|
22
|
+
</nav>
|
|
23
|
+
</template>
|
|
24
|
+
`,
|
|
25
|
+
'af-card': (_attrs) => `
|
|
26
|
+
<template shadowrootmode="open">
|
|
27
|
+
<style>
|
|
28
|
+
:host { display: block; background: #1e293b; border: 1px solid #334155; border-radius: 12px; padding: 24px; color: white; }
|
|
29
|
+
</style>
|
|
30
|
+
<slot></slot>
|
|
31
|
+
</template>
|
|
32
|
+
`
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
// Bun-specific imports moved inside functions to allow browser-side evaluation without crashes
|
|
36
|
+
export async function renderPage(filePath) {
|
|
37
|
+
const { file } = await import("bun");
|
|
38
|
+
const fileRef = file(filePath);
|
|
39
|
+
let html = await fileRef.text();
|
|
40
|
+
|
|
41
|
+
// 1. SSR: Inject Declarative Shadow DOM
|
|
42
|
+
// Matches <af-tag ...></af-tag>
|
|
43
|
+
// Regex is simple for v1, real parser needed for production
|
|
44
|
+
for (const [tag, renderFn] of Object.entries(componentRegistry)) {
|
|
45
|
+
const regex = new RegExp(`<${tag}([^>]*)>`, 'g');
|
|
46
|
+
|
|
47
|
+
html = html.replace(regex, (match, attrString) => {
|
|
48
|
+
// Parse attributes
|
|
49
|
+
const attrs = {};
|
|
50
|
+
attrString.replace(/(\w+)="([^"]*)"/g, (m, key, value) => {
|
|
51
|
+
attrs[key] = value;
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
// Return tag + DSD Template
|
|
55
|
+
return `<${tag}${attrString}>${renderFn(attrs)}`;
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// 2. SEO: Inject Meta Tags if missing
|
|
60
|
+
if (!html.includes('<meta name="generator"')) {
|
|
61
|
+
html = html.replace('</head>', '<meta name="generator" content="AfriCode v1.0 SSR"></head>');
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
return new Response(html, {
|
|
65
|
+
headers: { 'Content-Type': 'text/html' }
|
|
66
|
+
});
|
|
67
|
+
}
|