@africode/core 5.0.11 → 5.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/AGENTS.md +585 -585
  2. package/AGENT_INSTRUCTIONS.md +595 -595
  3. package/COMPONENT_SCHEMA.json +1826 -1800
  4. package/LICENSE +623 -623
  5. package/README.md +476 -476
  6. package/bin/africode.js +73 -73
  7. package/bin/cli.ts +82 -82
  8. package/bin/create-africode.js +220 -220
  9. package/bin/scaffold.ts +218 -218
  10. package/components/accordion.js +183 -183
  11. package/components/alert.js +131 -131
  12. package/components/auth-form.js +154 -154
  13. package/components/auth.js +172 -172
  14. package/components/avatar.js +117 -117
  15. package/components/badge.js +104 -104
  16. package/components/base.d.ts +139 -139
  17. package/components/base.js +234 -234
  18. package/components/breadcrumb.js +76 -72
  19. package/components/button.js +164 -164
  20. package/components/card.js +144 -137
  21. package/components/carousel.js +32 -32
  22. package/components/cart-drawer.js +28 -28
  23. package/components/code-block.js +20 -20
  24. package/components/contact-form.js +25 -25
  25. package/components/cookie-consent.js +23 -23
  26. package/components/cta-banner.js +38 -38
  27. package/components/cultural-card.js +243 -243
  28. package/components/dashboard-activity-list.js +103 -103
  29. package/components/dashboard-card.js +85 -85
  30. package/components/dashboard-metric.js +81 -81
  31. package/components/dashboard-shell.js +85 -85
  32. package/components/dashboard-topbar.js +84 -84
  33. package/components/divider.js +83 -83
  34. package/components/dropdown.js +171 -171
  35. package/components/error-boundary.js +155 -155
  36. package/components/faq-accordion.js +23 -23
  37. package/components/feature-grid.js +85 -85
  38. package/components/file-uploader.js +22 -22
  39. package/components/filter-bar.js +19 -19
  40. package/components/footer.js +113 -113
  41. package/components/form.js +131 -131
  42. package/components/gallery.js +22 -22
  43. package/components/hero.js +140 -138
  44. package/components/icon.js +36 -36
  45. package/components/index.js +128 -128
  46. package/components/input.js +252 -256
  47. package/components/kanga-card.js +185 -185
  48. package/components/kyc-upload.js +173 -173
  49. package/components/language-switcher.js +108 -108
  50. package/components/loader.js +80 -80
  51. package/components/modal.js +262 -262
  52. package/components/motion.js +84 -84
  53. package/components/nav-drawer.js +216 -216
  54. package/components/navbar.js +243 -236
  55. package/components/newsletter-signup.js +24 -24
  56. package/components/pagination.js +31 -31
  57. package/components/pattern-showcase.js +225 -225
  58. package/components/pricing-card.js +100 -100
  59. package/components/product-card.js +41 -41
  60. package/components/progress.js +132 -134
  61. package/components/react.js +111 -111
  62. package/components/search-box.js +24 -24
  63. package/components/section.js +54 -54
  64. package/components/select.js +321 -322
  65. package/components/sidebar.js +180 -180
  66. package/components/simple-chart.js +22 -22
  67. package/components/skeleton.js +85 -85
  68. package/components/stepper.js +28 -28
  69. package/components/table.js +181 -181
  70. package/components/tabs.js +202 -202
  71. package/components/team-grid.js +23 -23
  72. package/components/testimonial.js +94 -94
  73. package/components/theme-toggle.js +82 -82
  74. package/components/toast.js +139 -139
  75. package/components/tooltip.js +167 -167
  76. package/components/transaction-ledger.js +138 -138
  77. package/components/ui-avatar.js +79 -79
  78. package/components/ui-badge.js +61 -61
  79. package/components/ui-button.js +149 -149
  80. package/components/ui-card.js +74 -75
  81. package/components/ui-chip.js +87 -87
  82. package/components/ui-input.js +110 -110
  83. package/components/ui-popover.js +84 -84
  84. package/components/ui-progress-ring.js +60 -60
  85. package/components/ui-select.js +85 -85
  86. package/components/ui-stat.js +75 -75
  87. package/components/ui-switch.js +85 -85
  88. package/components/ui-table.js +69 -69
  89. package/components/ui-tabs.js +99 -99
  90. package/components/ui-tag.js +64 -64
  91. package/components/ui-textarea.js +84 -84
  92. package/components/ui-tooltip.js +66 -66
  93. package/components/video-player.js +22 -22
  94. package/components/wallet-balance.js +114 -114
  95. package/core/a2ui-schema-manager.js +351 -351
  96. package/core/a2ui.js +696 -696
  97. package/core/actions.js +27 -27
  98. package/core/bun-runtime.js +396 -396
  99. package/core/cli/commands/add.js +23 -23
  100. package/core/cli/commands/audit.js +58 -58
  101. package/core/cli/commands/build.js +193 -193
  102. package/core/cli/commands/create-plugin.js +241 -241
  103. package/core/cli/commands/dev.js +248 -283
  104. package/core/cli/commands/lint.js +23 -23
  105. package/core/cli/commands/test.js +33 -34
  106. package/core/cli/migrator.js +71 -71
  107. package/core/cli/ui.js +56 -56
  108. package/core/compliance.js +823 -823
  109. package/core/config.js +265 -265
  110. package/core/db-advanced.js +478 -481
  111. package/core/db.js +282 -284
  112. package/core/enhanced-hmr.js +406 -406
  113. package/core/errors.js +222 -222
  114. package/core/file-router.js +47 -47
  115. package/core/hmr-client.js +203 -204
  116. package/core/hmr.js +205 -197
  117. package/core/html.d.ts +30 -30
  118. package/core/html.js +84 -84
  119. package/core/hydration.js +52 -52
  120. package/core/lipa-namba-journey.js +548 -605
  121. package/core/logging.js +14 -14
  122. package/core/middleware.js +145 -145
  123. package/core/motion.js +106 -106
  124. package/core/nida-cig-middleware.js +417 -460
  125. package/core/patterns.d.ts +124 -124
  126. package/core/patterns.js +947 -1001
  127. package/core/plugins/index.js +345 -345
  128. package/core/request-analytics.js +253 -253
  129. package/core/request-identity.js +93 -93
  130. package/core/router.js +386 -386
  131. package/core/sdk-browser.js +140 -140
  132. package/core/sdk-client.js +61 -61
  133. package/core/sdk.d.ts +133 -133
  134. package/core/sdk.js +148 -148
  135. package/core/seo.js +76 -76
  136. package/core/server/auth-endpoints.js +339 -339
  137. package/core/server/auth.js +180 -180
  138. package/core/server/csrf.js +200 -206
  139. package/core/server/db.js +39 -39
  140. package/core/server/middleware.js +324 -324
  141. package/core/server/rate-limit.js +238 -238
  142. package/core/server/render.js +67 -69
  143. package/core/server/router.js +23 -11
  144. package/core/session-store.js +68 -68
  145. package/core/shim.js +28 -28
  146. package/core/state.d.ts +86 -86
  147. package/core/state.js +276 -276
  148. package/core/store.d.ts +122 -122
  149. package/core/store.js +61 -61
  150. package/core/validation.d.ts +232 -232
  151. package/core/validation.js +602 -602
  152. package/core/websocket.js +656 -641
  153. package/dist/africode.js +233 -230
  154. package/dist/africode.js.map +83 -83
  155. package/dist/build-info.json +3 -3
  156. package/dist/components.js +195 -192
  157. package/dist/components.js.map +73 -73
  158. package/dist/styles/africanity.css +321 -321
  159. package/dist/styles/typography.css +140 -140
  160. package/docs/IDE-Guide.md +50 -50
  161. package/package.json +113 -113
  162. package/scripts/generate-component-schema.js +82 -79
  163. package/styles/africanity.css +321 -321
  164. package/styles/typography.css +140 -140
  165. package/templates/starter/.env.example +15 -15
  166. package/templates/starter/africode.config.js +40 -40
  167. package/templates/starter/package.json +13 -13
  168. package/templates/starter/src/index.js +18 -18
  169. package/templates/starter/src/pages/index.html +55 -55
  170. package/templates/starter/src/pages/index.js +17 -17
  171. package/templates/starter/src/styles/main.css +3 -3
  172. package/templates/starter-3d/.env.example +7 -7
  173. package/templates/starter-3d/africode.config.js +29 -29
  174. package/templates/starter-3d/components/af-model-viewer.js +125 -125
  175. package/templates/starter-3d/package.json +14 -14
  176. package/templates/starter-3d/src/pages/index.html +55 -55
  177. package/templates/starter-3d/src/pages/index.js +50 -50
  178. package/templates/starter-3d/src/styles/main.css +3 -3
  179. package/templates/starter-dashboard/.env.example +21 -21
  180. package/templates/starter-dashboard/africode.config.js +20 -20
  181. package/templates/starter-dashboard/package.json +14 -14
  182. package/templates/starter-dashboard/src/index.js +17 -17
  183. package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
  184. package/templates/starter-dashboard/src/pages/index.html +118 -118
  185. package/templates/starter-dashboard/src/pages/index.js +110 -110
  186. package/templates/starter-dashboard/src/styles/main.css +172 -172
  187. package/templates/starter-fintech/.env.example +28 -28
  188. package/templates/starter-fintech/africode.config.js +20 -20
  189. package/templates/starter-fintech/package.json +15 -15
  190. package/templates/starter-fintech/src/index.js +17 -17
  191. package/templates/starter-fintech/src/pages/api/auth.js +45 -45
  192. package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
  193. package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
  194. package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
  195. package/templates/starter-fintech/src/pages/index.html +169 -169
  196. package/templates/starter-fintech/src/pages/index.js +161 -161
  197. package/templates/starter-fintech/src/styles/main.css +246 -246
  198. package/templates/starter-react/.env.example +15 -15
  199. package/templates/starter-react/africode.config.js +40 -40
  200. package/templates/starter-react/package.json +15 -15
  201. package/templates/starter-react/src/pages/index.html +55 -55
  202. package/templates/starter-react/src/pages/index.js +68 -68
  203. package/templates/starter-react/src/styles/main.css +3 -3
  204. package/templates/starter-tailwind/.env.example +15 -15
  205. package/templates/starter-tailwind/africode.config.js +40 -40
  206. package/templates/starter-tailwind/package.json +19 -19
  207. package/templates/starter-tailwind/src/pages/index.html +55 -55
  208. package/templates/starter-tailwind/src/pages/index.js +67 -67
  209. package/templates/starter-tailwind/src/styles/main.css +3 -3
  210. package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
  211. package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
  212. package/templates/starter-tailwind/tailwind.config.cjs +18 -18
  213. package/templates/starter-website/.env.example +18 -18
  214. package/templates/starter-website/africode.config.js +20 -20
  215. package/templates/starter-website/package.json +14 -14
  216. package/templates/starter-website/src/index.js +17 -17
  217. package/templates/starter-website/src/pages/index.html +124 -124
  218. package/templates/starter-website/src/pages/index.js +116 -116
  219. package/templates/starter-website/src/styles/main.css +195 -195
  220. package/bin/africode.js.1758507140 +0 -343
  221. package/core/heartbeat.js +0 -64
@@ -1,254 +1,254 @@
1
- /**
2
- * AfriCode Request Identity System
3
- *
4
- * Identifies and tracks request origins, geolocation, and device characteristics
5
- * to enhance security and analytics in the African digital economy context.
6
- *
7
- * Features:
8
- * - IP geolocation detection (Africa-focused)
9
- * - Device fingerprinting
10
- * - Request origin tracking
11
- * - Bot detection
12
- * - Fraud pattern recognition
13
- *
14
- * @module core/request-identity
15
- */
16
-
17
- import { frameworkLog } from './logging.js';
18
-
19
- /**
20
- * African countries ISO codes for geolocation
21
- */
22
- const AFRICAN_COUNTRIES = [
23
- 'AO', 'BF', 'BI', 'BJ', 'BW', 'CD', 'CF', 'CG', 'CI', 'CM', 'CV', 'DJ',
24
- 'DZ', 'EG', 'EH', 'ER', 'ET', 'GA', 'GH', 'GM', 'GN', 'GQ', 'GW', 'KE',
25
- 'KM', 'LR', 'LS', 'LY', 'MA', 'MG', 'ML', 'MR', 'MU', 'MW', 'MZ', 'NA',
26
- 'NE', 'NG', 'RE', 'RW', 'SC', 'SD', 'SH', 'SL', 'SN', 'SO', 'SS', 'ST',
27
- 'SZ', 'TD', 'TG', 'TN', 'TZ', 'UG', 'YT', 'ZA', 'ZM', 'ZW'
28
- ];
29
-
30
- /**
31
- * Detect bot traffic based on common patterns
32
- */
33
- function isBotUserAgent(userAgent) {
34
- if (!userAgent) return false;
35
-
36
- const botPatterns = [
37
- /bot/i,
38
- /crawl/i,
39
- /spider/i,
40
- /slurp/i,
41
- /facebookexternalhit/i,
42
- /linkedinbot/i,
43
- /twitterbot/i,
44
- /whatsapp/i,
45
- /telegram/i
46
- ];
47
-
48
- return botPatterns.some(pattern => pattern.test(userAgent));
49
- }
50
-
51
- /**
52
- * Extract country from IP (simplified - in real implementation would use a service)
53
- */
54
- function getCountryFromIP(ip) {
55
- // This would normally call a geolocation service
56
- // For now, return a mock implementation
57
- // In production, integrate with services like ipapi.co or ipinfo.io
58
- return 'UNKNOWN';
59
- }
60
-
61
- /**
62
- * Generate request fingerprint
63
- */
64
- function generateFingerprint(req) {
65
- const headers = req.headers || new Headers();
66
- const userAgent = headers.get('user-agent') || '';
67
- const acceptLanguage = headers.get('accept-language') || '';
68
- const acceptEncoding = headers.get('accept-encoding') || '';
69
-
70
- // Get IP from various headers (considering proxies)
71
- let ip = headers.get('x-forwarded-for') ||
72
- headers.get('x-real-ip') ||
73
- headers.get('x-client-ip') ||
74
- (req.connection ? req.connection.remoteAddress : null) ||
75
- (req.socket ? req.socket.remoteAddress : null) ||
76
- (req.connection ? req.connection.socket.remoteAddress : null) ||
77
- '127.0.0.1';
78
-
79
- // Handle comma-separated IPs from x-forwarded-for
80
- if (ip.includes(',')) {
81
- ip = ip.split(',')[0].trim();
82
- }
83
-
84
- // Create a hash of the identifying characteristics
85
- const fingerprintData = {
86
- ip,
87
- userAgent: sanitizeUserAgent(userAgent),
88
- acceptLanguage,
89
- acceptEncoding,
90
- path: req.url || '',
91
- method: req.method || 'GET'
92
- };
93
-
94
- return calculateHash(JSON.stringify(fingerprintData));
95
- }
96
-
97
- /**
98
- * Sanitize user agent to remove potentially identifying info
99
- */
100
- function sanitizeUserAgent(userAgent) {
101
- if (!userAgent) return '';
102
-
103
- // Remove version numbers and build info for privacy
104
- return userAgent
105
- .replace(/\d+\.\d+(\.\d+)?/g, '[VERSION]')
106
- .replace(/\([^\)]*\)/g, '(***REDACTED***)');
107
- }
108
-
109
- /**
110
- * Simple hash function for fingerprinting
111
- */
112
- function calculateHash(str) {
113
- let hash = 0;
114
- for (let i = 0; i < str.length; i++) {
115
- const char = str.charCodeAt(i);
116
- hash = ((hash << 5) - hash) + char;
117
- hash |= 0; // Convert to 32bit integer
118
- }
119
- return Math.abs(hash).toString(36);
120
- }
121
-
122
- /**
123
- * Enhanced logging with request identity
124
- */
125
- export function requestIdentityMiddleware(options = {}) {
126
- const {
127
- logAllRequests = false,
128
- logSuspicious = true,
129
- logAfricanTraffic = true,
130
- fraudDetection = true
131
- } = options;
132
-
133
- return async (ctx) => {
134
- const startTime = Date.now();
135
- const fingerprint = generateFingerprint(ctx.req);
136
-
137
- // Add identity info to context
138
- ctx.identity = {
139
- fingerprint,
140
- timestamp: new Date().toISOString(),
141
- userAgent: ctx.req.headers?.get('user-agent') || '',
142
- ip: getIPFromRequest(ctx.req),
143
- isBot: isBotUserAgent(ctx.req.headers?.get('user-agent')),
144
- country: getCountryFromIP(getIPFromRequest(ctx.req)),
145
- isAfrican: false, // Would be set based on geolocation
146
- responseTime: 0
147
- };
148
-
149
- // Log request if configured
150
- if (logAllRequests) {
151
- frameworkLog('info', `[Request Identity] ${ctx.req.method} ${ctx.pathname} | Fingerprint: ${fingerprint}`);
152
- }
153
-
154
- // Continue with request processing
155
- const result = {};
156
-
157
- // Set up response time calculation for post-processing
158
- const originalEnd = ctx.res?.end;
159
- if (originalEnd) {
160
- ctx.res.end = function(...args) {
161
- ctx.identity.responseTime = Date.now() - startTime;
162
- if (ctx.identity.responseTime > 5000) { // Slow requests
163
- frameworkLog('warn', `[Slow Request] ${ctx.pathname} took ${ctx.identity.responseTime}ms`);
164
- }
165
- return originalEnd.apply(this, args);
166
- };
167
- }
168
-
169
- return result;
170
- };
171
- }
172
-
173
- /**
174
- * Get IP from request considering various proxy headers
175
- */
176
- function getIPFromRequest(req) {
177
- const headers = req.headers || new Headers();
178
- let ip = headers.get('x-forwarded-for') ||
179
- headers.get('x-real-ip') ||
180
- headers.get('x-client-ip') ||
181
- (req.connection ? req.connection.remoteAddress : null) ||
182
- (req.socket ? req.socket.remoteAddress : null) ||
183
- (req.connection ? req.connection.socket.remoteAddress : null) ||
184
- '127.0.0.1';
185
-
186
- // Handle comma-separated IPs from x-forwarded-for
187
- if (ip.includes(',')) {
188
- ip = ip.split(',')[0].trim();
189
- }
190
-
191
- return ip;
192
- }
193
-
194
- /**
195
- * Fraud detection middleware
196
- */
197
- export function fraudDetectionMiddleware(options = {}) {
198
- const {
199
- maxRequestsPerMinute = 60,
200
- suspiciousPatterns = [],
201
- blockBots = true
202
- } = options;
203
-
204
- // In-memory store for request tracking (would use Redis in production)
205
- const requestCounts = new Map();
206
-
207
- return async (ctx) => {
208
- const ip = getIPFromRequest(ctx.req);
209
- const now = Date.now();
210
- const minuteKey = `${ip}:${Math.floor(now / 60000)}`;
211
-
212
- // Track requests per minute
213
- if (!requestCounts.has(minuteKey)) {
214
- requestCounts.set(minuteKey, 0);
215
- }
216
- requestCounts.set(minuteKey, requestCounts.get(minuteKey) + 1);
217
-
218
- const requestCount = requestCounts.get(minuteKey);
219
-
220
- // Check for excessive requests
221
- if (requestCount > maxRequestsPerMinute) {
222
- frameworkLog('warn', `[Fraud Detection] Potential DoS from IP: ${ip}, requests: ${requestCount}`);
223
- return {
224
- response: new Response('Too many requests', { status: 429 })
225
- };
226
- }
227
-
228
- // Check for bot traffic if configured
229
- if (blockBots && isBotUserAgent(ctx.req.headers?.get('user-agent'))) {
230
- frameworkLog('info', `[Bot Traffic] Blocked bot: ${ctx.req.headers?.get('user-agent')} from ${ip}`);
231
- return {
232
- response: new Response('Bot traffic not allowed', { status: 403 })
233
- };
234
- }
235
-
236
- // Add identity info to context
237
- ctx.identity = ctx.identity || {};
238
- Object.assign(ctx.identity, {
239
- ip,
240
- isBot: isBotUserAgent(ctx.req.headers?.get('user-agent')),
241
- requestCount
242
- });
243
-
244
- return {};
245
- };
246
- }
247
-
248
- export default {
249
- requestIdentityMiddleware,
250
- fraudDetectionMiddleware,
251
- generateFingerprint,
252
- getIPFromRequest,
253
- isBotUserAgent
1
+ /**
2
+ * AfriCode Request Identity System
3
+ *
4
+ * Identifies and tracks request origins, geolocation, and device characteristics
5
+ * to enhance security and analytics in the African digital economy context.
6
+ *
7
+ * Features:
8
+ * - IP geolocation detection (Africa-focused)
9
+ * - Device fingerprinting
10
+ * - Request origin tracking
11
+ * - Bot detection
12
+ * - Fraud pattern recognition
13
+ *
14
+ * @module core/request-identity
15
+ */
16
+
17
+ import { frameworkLog } from './logging.js';
18
+
19
+ /**
20
+ * African countries ISO codes for geolocation
21
+ */
22
+ const _AFRICAN_COUNTRIES = [
23
+ 'AO', 'BF', 'BI', 'BJ', 'BW', 'CD', 'CF', 'CG', 'CI', 'CM', 'CV', 'DJ',
24
+ 'DZ', 'EG', 'EH', 'ER', 'ET', 'GA', 'GH', 'GM', 'GN', 'GQ', 'GW', 'KE',
25
+ 'KM', 'LR', 'LS', 'LY', 'MA', 'MG', 'ML', 'MR', 'MU', 'MW', 'MZ', 'NA',
26
+ 'NE', 'NG', 'RE', 'RW', 'SC', 'SD', 'SH', 'SL', 'SN', 'SO', 'SS', 'ST',
27
+ 'SZ', 'TD', 'TG', 'TN', 'TZ', 'UG', 'YT', 'ZA', 'ZM', 'ZW'
28
+ ];
29
+
30
+ /**
31
+ * Detect bot traffic based on common patterns
32
+ */
33
+ function isBotUserAgent(userAgent) {
34
+ if (!userAgent) {return false;}
35
+
36
+ const botPatterns = [
37
+ /bot/i,
38
+ /crawl/i,
39
+ /spider/i,
40
+ /slurp/i,
41
+ /facebookexternalhit/i,
42
+ /linkedinbot/i,
43
+ /twitterbot/i,
44
+ /whatsapp/i,
45
+ /telegram/i
46
+ ];
47
+
48
+ return botPatterns.some(pattern => pattern.test(userAgent));
49
+ }
50
+
51
+ /**
52
+ * Extract country from IP (simplified - in real implementation would use a service)
53
+ */
54
+ function getCountryFromIP(_ip) {
55
+ // This would normally call a geolocation service
56
+ // For now, return a mock implementation
57
+ // In production, integrate with services like ipapi.co or ipinfo.io
58
+ return 'UNKNOWN';
59
+ }
60
+
61
+ /**
62
+ * Generate request fingerprint
63
+ */
64
+ function generateFingerprint(req) {
65
+ const headers = req.headers || new Headers();
66
+ const userAgent = headers.get('user-agent') || '';
67
+ const acceptLanguage = headers.get('accept-language') || '';
68
+ const acceptEncoding = headers.get('accept-encoding') || '';
69
+
70
+ // Get IP from various headers (considering proxies)
71
+ let ip = headers.get('x-forwarded-for') ||
72
+ headers.get('x-real-ip') ||
73
+ headers.get('x-client-ip') ||
74
+ (req.connection ? req.connection.remoteAddress : null) ||
75
+ (req.socket ? req.socket.remoteAddress : null) ||
76
+ (req.connection ? req.connection.socket.remoteAddress : null) ||
77
+ '127.0.0.1';
78
+
79
+ // Handle comma-separated IPs from x-forwarded-for
80
+ if (ip.includes(',')) {
81
+ ip = ip.split(',')[0].trim();
82
+ }
83
+
84
+ // Create a hash of the identifying characteristics
85
+ const fingerprintData = {
86
+ ip,
87
+ userAgent: sanitizeUserAgent(userAgent),
88
+ acceptLanguage,
89
+ acceptEncoding,
90
+ path: req.url || '',
91
+ method: req.method || 'GET'
92
+ };
93
+
94
+ return calculateHash(JSON.stringify(fingerprintData));
95
+ }
96
+
97
+ /**
98
+ * Sanitize user agent to remove potentially identifying info
99
+ */
100
+ function sanitizeUserAgent(userAgent) {
101
+ if (!userAgent) {return '';}
102
+
103
+ // Remove version numbers and build info for privacy
104
+ return userAgent
105
+ .replace(/\d+\.\d+(\.\d+)?/g, '[VERSION]')
106
+ .replace(/\([^)]*\)/g, '(***REDACTED***)');
107
+ }
108
+
109
+ /**
110
+ * Simple hash function for fingerprinting
111
+ */
112
+ function calculateHash(str) {
113
+ let hash = 0;
114
+ for (let i = 0; i < str.length; i++) {
115
+ const char = str.charCodeAt(i);
116
+ hash = ((hash << 5) - hash) + char;
117
+ hash |= 0; // Convert to 32bit integer
118
+ }
119
+ return Math.abs(hash).toString(36);
120
+ }
121
+
122
+ /**
123
+ * Enhanced logging with request identity
124
+ */
125
+ export function requestIdentityMiddleware(options = {}) {
126
+ const {
127
+ logAllRequests = false,
128
+ logSuspicious: _logSuspicious = true,
129
+ logAfricanTraffic: _logAfricanTraffic = true,
130
+ fraudDetection: _fraudDetection = true
131
+ } = options;
132
+
133
+ return async (ctx) => {
134
+ const startTime = Date.now();
135
+ const fingerprint = generateFingerprint(ctx.req);
136
+
137
+ // Add identity info to context
138
+ ctx.identity = {
139
+ fingerprint,
140
+ timestamp: new Date().toISOString(),
141
+ userAgent: ctx.req.headers?.get('user-agent') || '',
142
+ ip: getIPFromRequest(ctx.req),
143
+ isBot: isBotUserAgent(ctx.req.headers?.get('user-agent')),
144
+ country: getCountryFromIP(getIPFromRequest(ctx.req)),
145
+ isAfrican: false, // Would be set based on geolocation
146
+ responseTime: 0
147
+ };
148
+
149
+ // Log request if configured
150
+ if (logAllRequests) {
151
+ frameworkLog('info', `[Request Identity] ${ctx.req.method} ${ctx.pathname} | Fingerprint: ${fingerprint}`);
152
+ }
153
+
154
+ // Continue with request processing
155
+ const result = {};
156
+
157
+ // Set up response time calculation for post-processing
158
+ const originalEnd = ctx.res?.end;
159
+ if (originalEnd) {
160
+ ctx.res.end = function(...args) {
161
+ ctx.identity.responseTime = Date.now() - startTime;
162
+ if (ctx.identity.responseTime > 5000) { // Slow requests
163
+ frameworkLog('warn', `[Slow Request] ${ctx.pathname} took ${ctx.identity.responseTime}ms`);
164
+ }
165
+ return originalEnd.apply(this, args);
166
+ };
167
+ }
168
+
169
+ return result;
170
+ };
171
+ }
172
+
173
+ /**
174
+ * Get IP from request considering various proxy headers
175
+ */
176
+ function getIPFromRequest(req) {
177
+ const headers = req.headers || new Headers();
178
+ let ip = headers.get('x-forwarded-for') ||
179
+ headers.get('x-real-ip') ||
180
+ headers.get('x-client-ip') ||
181
+ (req.connection ? req.connection.remoteAddress : null) ||
182
+ (req.socket ? req.socket.remoteAddress : null) ||
183
+ (req.connection ? req.connection.socket.remoteAddress : null) ||
184
+ '127.0.0.1';
185
+
186
+ // Handle comma-separated IPs from x-forwarded-for
187
+ if (ip.includes(',')) {
188
+ ip = ip.split(',')[0].trim();
189
+ }
190
+
191
+ return ip;
192
+ }
193
+
194
+ /**
195
+ * Fraud detection middleware
196
+ */
197
+ export function fraudDetectionMiddleware(options = {}) {
198
+ const {
199
+ maxRequestsPerMinute = 60,
200
+ suspiciousPatterns: _suspiciousPatterns = [],
201
+ blockBots = true
202
+ } = options;
203
+
204
+ // In-memory store for request tracking (would use Redis in production)
205
+ const requestCounts = new Map();
206
+
207
+ return async (ctx) => {
208
+ const ip = getIPFromRequest(ctx.req);
209
+ const now = Date.now();
210
+ const minuteKey = `${ip}:${Math.floor(now / 60000)}`;
211
+
212
+ // Track requests per minute
213
+ if (!requestCounts.has(minuteKey)) {
214
+ requestCounts.set(minuteKey, 0);
215
+ }
216
+ requestCounts.set(minuteKey, requestCounts.get(minuteKey) + 1);
217
+
218
+ const requestCount = requestCounts.get(minuteKey);
219
+
220
+ // Check for excessive requests
221
+ if (requestCount > maxRequestsPerMinute) {
222
+ frameworkLog('warn', `[Fraud Detection] Potential DoS from IP: ${ip}, requests: ${requestCount}`);
223
+ return {
224
+ response: new Response('Too many requests', { status: 429 })
225
+ };
226
+ }
227
+
228
+ // Check for bot traffic if configured
229
+ if (blockBots && isBotUserAgent(ctx.req.headers?.get('user-agent'))) {
230
+ frameworkLog('info', `[Bot Traffic] Blocked bot: ${ctx.req.headers?.get('user-agent')} from ${ip}`);
231
+ return {
232
+ response: new Response('Bot traffic not allowed', { status: 403 })
233
+ };
234
+ }
235
+
236
+ // Add identity info to context
237
+ ctx.identity = ctx.identity || {};
238
+ Object.assign(ctx.identity, {
239
+ ip,
240
+ isBot: isBotUserAgent(ctx.req.headers?.get('user-agent')),
241
+ requestCount
242
+ });
243
+
244
+ return {};
245
+ };
246
+ }
247
+
248
+ export default {
249
+ requestIdentityMiddleware,
250
+ fraudDetectionMiddleware,
251
+ generateFingerprint,
252
+ getIPFromRequest,
253
+ isBotUserAgent
254
254
  };