@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.
Files changed (222) 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 +398 -397
  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 +252 -285
  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 +52 -50
  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 +102 -120
  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/dashboard.js +19 -0
  193. package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
  194. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  195. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  196. package/templates/starter-fintech/src/pages/index.html +169 -169
  197. package/templates/starter-fintech/src/pages/index.js +161 -161
  198. package/templates/starter-fintech/src/styles/main.css +246 -246
  199. package/templates/starter-react/.env.example +15 -15
  200. package/templates/starter-react/africode.config.js +40 -40
  201. package/templates/starter-react/package.json +15 -15
  202. package/templates/starter-react/src/pages/index.html +55 -55
  203. package/templates/starter-react/src/pages/index.js +68 -68
  204. package/templates/starter-react/src/styles/main.css +3 -3
  205. package/templates/starter-tailwind/.env.example +15 -15
  206. package/templates/starter-tailwind/africode.config.js +40 -40
  207. package/templates/starter-tailwind/package.json +19 -19
  208. package/templates/starter-tailwind/src/pages/index.html +55 -55
  209. package/templates/starter-tailwind/src/pages/index.js +67 -67
  210. package/templates/starter-tailwind/src/styles/main.css +3 -3
  211. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  212. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  213. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  214. package/templates/starter-website/.env.example +18 -18
  215. package/templates/starter-website/africode.config.js +20 -20
  216. package/templates/starter-website/package.json +14 -14
  217. package/templates/starter-website/src/index.js +17 -17
  218. package/templates/starter-website/src/pages/index.html +124 -124
  219. package/templates/starter-website/src/pages/index.js +116 -116
  220. package/templates/starter-website/src/styles/main.css +195 -195
  221. package/bin/africode.js.1758507140 +0 -343
  222. 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 };
@@ -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
- import { file } from "bun";
9
-
10
- // Registry of component definitions for SSR
11
- // In a real framework, this would parse the component class
12
- // For v1, we map tags to their Shadow DOM HTML
13
- const componentRegistry = {
14
- 'af-navbar': (attrs) => `
15
- <template shadowrootmode="open">
16
- <style>
17
- :host { display: block; font-family: 'Inter', system-ui; }
18
- nav { background: #1EB53A; padding: 16px; color: white; display: flex; justify-content: space-between; }
19
- .logo { font-weight: 800; font-size: 1.2rem; }
20
- </style>
21
- <nav>
22
- <div class="logo">${attrs.logo || 'AfriCode'}</div>
23
- <div class="links"><slot></slot></div>
24
- </nav>
25
- </template>
26
- `,
27
- 'af-card': (attrs) => `
28
- <template shadowrootmode="open">
29
- <style>
30
- :host { display: block; background: #1e293b; border: 1px solid #334155; border-radius: 12px; padding: 24px; color: white; }
31
- </style>
32
- <slot></slot>
33
- </template>
34
- `
35
- };
36
-
37
- // Bun-specific imports moved inside functions to allow browser-side evaluation without crashes
38
- export async function renderPage(filePath) {
39
- const { file } = await import("bun");
40
- const fileRef = file(filePath);
41
- let html = await fileRef.text();
42
-
43
- // 1. SSR: Inject Declarative Shadow DOM
44
- // Matches <af-tag ...></af-tag>
45
- // Regex is simple for v1, real parser needed for production
46
- for (const [tag, renderFn] of Object.entries(componentRegistry)) {
47
- const regex = new RegExp(`<${tag}([^>]*)>`, 'g');
48
-
49
- html = html.replace(regex, (match, attrString) => {
50
- // Parse attributes
51
- const attrs = {};
52
- attrString.replace(/(\w+)="([^"]*)"/g, (m, key, value) => {
53
- attrs[key] = value;
54
- });
55
-
56
- // Return tag + DSD Template
57
- return `<${tag}${attrString}>${renderFn(attrs)}`;
58
- });
59
- }
60
-
61
- // 2. SEO: Inject Meta Tags if missing
62
- if (!html.includes('<meta name="generator"')) {
63
- html = html.replace('</head>', '<meta name="generator" content="AfriCode v1.0 SSR"></head>');
64
- }
65
-
66
- return new Response(html, {
67
- headers: { 'Content-Type': 'text/html' }
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
+ }