@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,206 +1,200 @@
1
- /**
2
- * AfriCode CSRF Protection Middleware
3
- *
4
- * Double-submit cookie pattern for CSRF protection.
5
- * Framework-level middleware — secure by default.
6
- *
7
- * How it works:
8
- * 1. Server generates a random CSRF token and sets it as a cookie
9
- * 2. Client reads the cookie and sends the token in a header (X-CSRF-Token)
10
- * 3. Server compares cookie token with header token
11
- * 4. If they match → request is from the legitimate client
12
- * 5. If they don't match → request is cross-site (blocked)
13
- *
14
- * Why double-submit cookie:
15
- * - No server-side session storage needed for the token
16
- * - Works with stateless APIs
17
- * - Compatible with single-page apps and server-rendered pages
18
- *
19
- * @module core/server/csrf
20
- */
21
-
22
- import { CsrfError } from '../errors.js';
23
- import { emitSecurityViolation } from '../config.js';
24
-
25
- /**
26
- * Generate a cryptographically secure CSRF token
27
- * @returns {string} 32-byte hex token
28
- */
29
- export function generateCsrfToken() {
30
- const bytes = new Uint8Array(32);
31
- crypto.getRandomValues(bytes);
32
- return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
33
- }
34
-
35
- /**
36
- * Create the CSRF cookie header string
37
- * @param {string} token - The CSRF token
38
- * @param {Object} [opts] - Options
39
- * @param {boolean} [opts.secure=false] - Set Secure flag (HTTPS only)
40
- * @param {string} [opts.sameSite='Strict'] - SameSite policy
41
- * @param {number} [opts.maxAge=86400] - Cookie max age in seconds (default: 24h)
42
- * @returns {string} Set-Cookie header value
43
- */
44
- export function createCsrfCookie(token, opts = {}) {
45
- const { secure = false, sameSite = 'Strict', maxAge = 86400 } = opts;
46
- return `csrf_token=${token}; Path=/; Max-Age=${maxAge}; SameSite=${sameSite}${secure ? '; Secure' : ''}`;
47
- }
48
-
49
- /**
50
- * Extract the CSRF token from the request cookie
51
- * @param {Request} request
52
- * @returns {string|null}
53
- */
54
- function getCsrfFromCookie(request) {
55
- const cookieHeader = request.headers.get('Cookie');
56
- if (!cookieHeader) {return null;}
57
-
58
- const match = cookieHeader.match(/csrf_token=([^;]+)/);
59
- return match ? match[1] : null;
60
- }
61
-
62
- /**
63
- * Extract the CSRF token from the request header
64
- * @param {Request} request
65
- * @returns {string|null}
66
- */
67
- function getCsrfFromHeader(request) {
68
- return request.headers.get('X-CSRF-Token') || null;
69
- }
70
-
71
- /**
72
- * CSRF Protection Middleware
73
- *
74
- * Validates that the CSRF token in the cookie matches the one in the header.
75
- * Only applies to state-changing methods (POST, PUT, PATCH, DELETE).
76
- * GET, HEAD, OPTIONS are safe methods and are not checked.
77
- *
78
- * @param {Object} [config] - Configuration
79
- * @param {string[]} [config.safeMethods=['GET', 'HEAD', 'OPTIONS']] - Methods that skip CSRF check
80
- * @param {string[]} [config.excludePaths=[]] - Paths that skip CSRF check (e.g. public APIs)
81
- * @param {string} [config.headerName='X-CSRF-Token'] - Header name for the token
82
- * @param {string} [config.cookieName='csrf_token'] - Cookie name for the token
83
- * @param {Function} [config.onFailure] - Custom failure handler (receives request, returns Response)
84
- *
85
- * @returns {Function} Middleware function: (request) => Response | null
86
- *
87
- * @example
88
- * // In your server setup:
89
- * const csrf = createCsrfMiddleware();
90
- *
91
- * // In your request handler:
92
- * const csrfError = csrf(request);
93
- * if (csrfError) return csrfError;
94
- *
95
- * @example
96
- * // With configuration:
97
- * const csrf = createCsrfMiddleware({
98
- * excludePaths: ['/api/webhooks'],
99
- * onFailure: (req) => new Response('Custom CSRF error', { status: 403 })
100
- * });
101
- */
102
- export function createCsrfMiddleware(config = {}) {
103
- const {
104
- safeMethods = ['GET', 'HEAD', 'OPTIONS'],
105
- excludePaths = [],
106
- headerName = 'X-CSRF-Token',
107
- cookieName = 'csrf_token',
108
- onFailure = null
109
- } = config;
110
-
111
- /**
112
- * @param {Request} request
113
- * @returns {Response|null} Returns Response if CSRF fails, null if passes
114
- */
115
- return function csrfMiddleware(request) {
116
- const method = request.method.toUpperCase();
117
-
118
- // Safe methods don't need CSRF protection
119
- if (safeMethods.includes(method)) {
120
- return null;
121
- }
122
-
123
- // Check excluded paths
124
- const url = new URL(request.url);
125
- if (excludePaths.some(path => url.pathname.startsWith(path))) {
126
- return null;
127
- }
128
-
129
- // Get tokens
130
- const cookieToken = getCsrfFromCookie(request);
131
- const headerToken = request.headers.get(headerName);
132
-
133
- // Both must exist
134
- if (!cookieToken || !headerToken) {
135
- const error = new CsrfError('missing');
136
- emitSecurityViolation(error);
137
- if (onFailure) {return onFailure(request);}
138
- return error.toResponse();
139
- }
140
-
141
- // Constant-time comparison to prevent timing attacks
142
- if (!timingSafeEqual(cookieToken, headerToken)) {
143
- const error = new CsrfError('mismatch');
144
- emitSecurityViolation(error);
145
- if (onFailure) {return onFailure(request);}
146
- return error.toResponse();
147
- }
148
-
149
- // CSRF check passed
150
- return null;
151
- };
152
- }
153
-
154
- /**
155
- * Constant-time string comparison to prevent timing attacks.
156
- * Both strings must be the same length for timing safety.
157
- *
158
- * @param {string} a
159
- * @param {string} b
160
- * @returns {boolean}
161
- */
162
- function timingSafeEqual(a, b) {
163
- if (a.length !== b.length) {return false;}
164
-
165
- const encoder = new TextEncoder();
166
- const bufA = encoder.encode(a);
167
- const bufB = encoder.encode(b);
168
-
169
- // Use constant-time XOR comparison
170
- let result = 0;
171
- for (let i = 0; i < bufA.length; i++) {
172
- result |= bufA[i] ^ bufB[i];
173
- }
174
-
175
- return result === 0;
176
- }
177
-
178
- /**
179
- * Helper to inject CSRF token into a page response.
180
- * Sets the cookie and adds a meta tag for client-side access.
181
- *
182
- * @param {string} html - The HTML response body
183
- * @param {string} token - The CSRF token
184
- * @returns {{ html: string, cookie: string }} Modified HTML and cookie header
185
- *
186
- * @example
187
- * const token = generateCsrfToken();
188
- * const { html, cookie } = injectCsrfToken(pageHtml, token);
189
- * return new Response(html, {
190
- * headers: {
191
- * 'Content-Type': 'text/html',
192
- * 'Set-Cookie': cookie
193
- * }
194
- * });
195
- */
196
- export function injectCsrfToken(html, token) {
197
- const metaTag = `<meta name="csrf-token" content="${token}">`;
198
- const modifiedHtml = html.replace('</head>', ` ${metaTag}\n</head>`);
199
-
200
- return {
201
- html: modifiedHtml,
202
- cookie: createCsrfCookie(token)
203
- };
204
- }
205
-
206
- export default { generateCsrfToken, createCsrfCookie, createCsrfMiddleware, injectCsrfToken };
1
+ /**
2
+ * AfriCode CSRF Protection Middleware
3
+ *
4
+ * Double-submit cookie pattern for CSRF protection.
5
+ * Framework-level middleware — secure by default.
6
+ *
7
+ * How it works:
8
+ * 1. Server generates a random CSRF token and sets it as a cookie
9
+ * 2. Client reads the cookie and sends the token in a header (X-CSRF-Token)
10
+ * 3. Server compares cookie token with header token
11
+ * 4. If they match → request is from the legitimate client
12
+ * 5. If they don't match → request is cross-site (blocked)
13
+ *
14
+ * Why double-submit cookie:
15
+ * - No server-side session storage needed for the token
16
+ * - Works with stateless APIs
17
+ * - Compatible with single-page apps and server-rendered pages
18
+ *
19
+ * @module core/server/csrf
20
+ */
21
+
22
+ import { CsrfError } from '../errors.js';
23
+ import { emitSecurityViolation } from '../config.js';
24
+
25
+ /**
26
+ * Generate a cryptographically secure CSRF token
27
+ * @returns {string} 32-byte hex token
28
+ */
29
+ export function generateCsrfToken() {
30
+ const bytes = new Uint8Array(32);
31
+ crypto.getRandomValues(bytes);
32
+ return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
33
+ }
34
+
35
+ /**
36
+ * Create the CSRF cookie header string
37
+ * @param {string} token - The CSRF token
38
+ * @param {Object} [opts] - Options
39
+ * @param {boolean} [opts.secure=false] - Set Secure flag (HTTPS only)
40
+ * @param {string} [opts.sameSite='Strict'] - SameSite policy
41
+ * @param {number} [opts.maxAge=86400] - Cookie max age in seconds (default: 24h)
42
+ * @param {string} [opts.cookieName='csrf_token'] - Cookie name for the token
43
+ * @returns {string} Set-Cookie header value
44
+ */
45
+ export function createCsrfCookie(token, opts = {}) {
46
+ const { secure = false, sameSite = 'Strict', maxAge = 86400, cookieName = 'csrf_token' } = opts;
47
+ return `${cookieName}=${token}; Path=/; Max-Age=${maxAge}; SameSite=${sameSite}${secure ? '; Secure' : ''}`;
48
+ }
49
+
50
+ /**
51
+ * Extract the CSRF token from the request cookie
52
+ * @param {Request} request
53
+ * @param {string} [cookieName='csrf_token'] - Cookie name holding the token
54
+ * @returns {string|null}
55
+ */
56
+ function getCsrfFromCookie(request, cookieName = 'csrf_token') {
57
+ const cookieHeader = request.headers.get('Cookie');
58
+ if (!cookieHeader) {return null;}
59
+
60
+ const escaped = cookieName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
61
+ const match = cookieHeader.match(new RegExp(`(?:^|;\\s*)${escaped}=([^;]+)`));
62
+ return match ? match[1] : null;
63
+ }
64
+
65
+ /**
66
+ * CSRF Protection Middleware
67
+ *
68
+ * Validates that the CSRF token in the cookie matches the one in the header.
69
+ * Only applies to state-changing methods (POST, PUT, PATCH, DELETE).
70
+ * GET, HEAD, OPTIONS are safe methods and are not checked.
71
+ *
72
+ * @param {Object} [config] - Configuration
73
+ * @param {string[]} [config.safeMethods=['GET', 'HEAD', 'OPTIONS']] - Methods that skip CSRF check
74
+ * @param {string[]} [config.excludePaths=[]] - Paths that skip CSRF check (e.g. public APIs)
75
+ * @param {string} [config.headerName='X-CSRF-Token'] - Header name for the token
76
+ * @param {string} [config.cookieName='csrf_token'] - Cookie name for the token
77
+ * @param {Function} [config.onFailure] - Custom failure handler (receives request, returns Response)
78
+ *
79
+ * @returns {Function} Middleware function: (request) => Response | null
80
+ *
81
+ * @example
82
+ * // In your server setup:
83
+ * const csrf = createCsrfMiddleware();
84
+ *
85
+ * // In your request handler:
86
+ * const csrfError = csrf(request);
87
+ * if (csrfError) return csrfError;
88
+ *
89
+ * @example
90
+ * // With configuration:
91
+ * const csrf = createCsrfMiddleware({
92
+ * excludePaths: ['/api/webhooks'],
93
+ * onFailure: (req) => new Response('Custom CSRF error', { status: 403 })
94
+ * });
95
+ */
96
+ export function createCsrfMiddleware(config = {}) {
97
+ const {
98
+ safeMethods = ['GET', 'HEAD', 'OPTIONS'],
99
+ excludePaths = [],
100
+ headerName = 'X-CSRF-Token',
101
+ cookieName = 'csrf_token',
102
+ onFailure = null
103
+ } = config;
104
+
105
+ /**
106
+ * @param {Request} request
107
+ * @returns {Response|null} Returns Response if CSRF fails, null if passes
108
+ */
109
+ return function csrfMiddleware(request) {
110
+ const method = request.method.toUpperCase();
111
+
112
+ // Safe methods don't need CSRF protection
113
+ if (safeMethods.includes(method)) {
114
+ return null;
115
+ }
116
+
117
+ // Check excluded paths
118
+ const url = new URL(request.url);
119
+ if (excludePaths.some(path => url.pathname.startsWith(path))) {
120
+ return null;
121
+ }
122
+
123
+ // Get tokens
124
+ const cookieToken = getCsrfFromCookie(request, cookieName);
125
+ const headerToken = request.headers.get(headerName);
126
+
127
+ // Both must exist
128
+ if (!cookieToken || !headerToken) {
129
+ const error = new CsrfError('missing');
130
+ emitSecurityViolation(error);
131
+ if (onFailure) {return onFailure(request);}
132
+ return error.toResponse();
133
+ }
134
+
135
+ // Constant-time comparison to prevent timing attacks
136
+ if (!timingSafeEqual(cookieToken, headerToken)) {
137
+ const error = new CsrfError('mismatch');
138
+ emitSecurityViolation(error);
139
+ if (onFailure) {return onFailure(request);}
140
+ return error.toResponse();
141
+ }
142
+
143
+ // CSRF check passed
144
+ return null;
145
+ };
146
+ }
147
+
148
+ /**
149
+ * Constant-time string comparison to prevent timing attacks.
150
+ * Both strings must be the same length for timing safety.
151
+ *
152
+ * @param {string} a
153
+ * @param {string} b
154
+ * @returns {boolean}
155
+ */
156
+ function timingSafeEqual(a, b) {
157
+ if (a.length !== b.length) {return false;}
158
+
159
+ const encoder = new TextEncoder();
160
+ const bufA = encoder.encode(a);
161
+ const bufB = encoder.encode(b);
162
+
163
+ // Use constant-time XOR comparison
164
+ let result = 0;
165
+ for (let i = 0; i < bufA.length; i++) {
166
+ result |= bufA[i] ^ bufB[i];
167
+ }
168
+
169
+ return result === 0;
170
+ }
171
+
172
+ /**
173
+ * Helper to inject CSRF token into a page response.
174
+ * Sets the cookie and adds a meta tag for client-side access.
175
+ *
176
+ * @param {string} html - The HTML response body
177
+ * @param {string} token - The CSRF token
178
+ * @returns {{ html: string, cookie: string }} Modified HTML and cookie header
179
+ *
180
+ * @example
181
+ * const token = generateCsrfToken();
182
+ * const { html, cookie } = injectCsrfToken(pageHtml, token);
183
+ * return new Response(html, {
184
+ * headers: {
185
+ * 'Content-Type': 'text/html',
186
+ * 'Set-Cookie': cookie
187
+ * }
188
+ * });
189
+ */
190
+ export function injectCsrfToken(html, token) {
191
+ const metaTag = `<meta name="csrf-token" content="${token}">`;
192
+ const modifiedHtml = html.replace('</head>', ` ${metaTag}\n</head>`);
193
+
194
+ return {
195
+ html: modifiedHtml,
196
+ cookie: createCsrfCookie(token)
197
+ };
198
+ }
199
+
200
+ export default { generateCsrfToken, createCsrfCookie, createCsrfMiddleware, injectCsrfToken };
package/core/server/db.js CHANGED
@@ -1,39 +1,39 @@
1
- /**
2
- * AfriCode Database Layer
3
- * Zero-config SQLite integration powered by Bun
4
- */
5
-
6
- import { Database } from "bun:sqlite";
7
-
8
- // Auto-create db file
9
- const db = new Database("africode.sqlite", { create: true });
10
-
11
- // Initialize Schema
12
- db.run(`
13
- CREATE TABLE IF NOT EXISTS users (
14
- id INTEGER PRIMARY KEY AUTOINCREMENT,
15
- email TEXT UNIQUE,
16
- password_hash TEXT,
17
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP
18
- );
19
- `);
20
-
21
- db.run(`
22
- CREATE TABLE IF NOT EXISTS sessions (
23
- id TEXT PRIMARY KEY,
24
- user_id INTEGER,
25
- expires_at DATETIME,
26
- FOREIGN KEY(user_id) REFERENCES users(id)
27
- );
28
- `);
29
-
30
- export default db;
31
-
32
- // Helper query function
33
- export const query = {
34
- getUserByEmail: (email) => db.query("SELECT * FROM users WHERE email = ?").get(email),
35
- createUser: (email, hash) => db.run("INSERT INTO users (email, password_hash) VALUES (?, ?)", [email, hash]),
36
- createSession: (sid, uid, exp) => db.run("INSERT INTO sessions (id, user_id, expires_at) VALUES (?, ?, ?)", [sid, uid, exp]),
37
- getSession: (sid) => db.query("SELECT * FROM sessions WHERE id = ?").get(sid),
38
- deleteSession: (sid) => db.run("DELETE FROM sessions WHERE id = ?", [sid])
39
- };
1
+ /**
2
+ * AfriCode Database Layer
3
+ * Zero-config SQLite integration powered by Bun
4
+ */
5
+
6
+ import { Database } from "bun:sqlite";
7
+
8
+ // Auto-create db file
9
+ const db = new Database("africode.sqlite", { create: true });
10
+
11
+ // Initialize Schema
12
+ db.run(`
13
+ CREATE TABLE IF NOT EXISTS users (
14
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
15
+ email TEXT UNIQUE,
16
+ password_hash TEXT,
17
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP
18
+ );
19
+ `);
20
+
21
+ db.run(`
22
+ CREATE TABLE IF NOT EXISTS sessions (
23
+ id TEXT PRIMARY KEY,
24
+ user_id INTEGER,
25
+ expires_at DATETIME,
26
+ FOREIGN KEY(user_id) REFERENCES users(id)
27
+ );
28
+ `);
29
+
30
+ export default db;
31
+
32
+ // Helper query function
33
+ export const query = {
34
+ getUserByEmail: (email) => db.query("SELECT * FROM users WHERE email = ?").get(email),
35
+ createUser: (email, hash) => db.run("INSERT INTO users (email, password_hash) VALUES (?, ?)", [email, hash]),
36
+ createSession: (sid, uid, exp) => db.run("INSERT INTO sessions (id, user_id, expires_at) VALUES (?, ?, ?)", [sid, uid, exp]),
37
+ getSession: (sid) => db.query("SELECT * FROM sessions WHERE id = ?").get(sid),
38
+ deleteSession: (sid) => db.run("DELETE FROM sessions WHERE id = ?", [sid])
39
+ };