@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
package/core/errors.js CHANGED
@@ -1,222 +1,222 @@
1
- /**
2
- * AfriCode Error System
3
- *
4
- * Standardized error hierarchy for the entire framework.
5
- * Every error has: code, message, field (optional), context (optional).
6
- *
7
- * Design:
8
- * - All framework errors extend AfriCodeError
9
- * - Errors carry structured metadata for programmatic handling
10
- * - toJSON() produces a consistent API response format
11
- * - Error codes are namespaced: VALIDATION_*, SECURITY_*, DB_*, etc.
12
- *
13
- * @module core/errors
14
- */
15
-
16
- /**
17
- * Base error class for all AfriCode framework errors.
18
- *
19
- * @example
20
- * throw new AfriCodeError('Something failed', 'GENERIC_ERROR', { detail: '...' });
21
- *
22
- * @example
23
- * // In an API handler:
24
- * try { ... } catch (err) {
25
- * if (err instanceof AfriCodeError) {
26
- * return new Response(JSON.stringify(err.toJSON()), { status: err.statusCode });
27
- * }
28
- * }
29
- */
30
- export class AfriCodeError extends Error {
31
- /**
32
- * @param {string} message - Human-readable error message
33
- * @param {string} code - Machine-readable error code (e.g. 'VALIDATION_FAILED')
34
- * @param {Object} [context={}] - Additional context for debugging
35
- * @param {number} [statusCode=500] - HTTP status code
36
- */
37
- constructor(message, code = 'INTERNAL_ERROR', context = {}, statusCode = 500) {
38
- super(message);
39
- this.name = 'AfriCodeError';
40
- this.code = code;
41
- this.context = context;
42
- this.statusCode = statusCode;
43
- this.timestamp = new Date().toISOString();
44
- }
45
-
46
- /**
47
- * Produce a consistent JSON structure for API responses.
48
- * @returns {Object}
49
- */
50
- toJSON() {
51
- return {
52
- error: {
53
- code: this.code,
54
- message: this.message,
55
- ...(this.context.field ? { field: this.context.field } : {}),
56
- ...(Object.keys(this.context).length > 0 ? { context: this.context } : {})
57
- }
58
- };
59
- }
60
-
61
- /**
62
- * Create an HTTP Response from this error.
63
- * @returns {Response}
64
- */
65
- toResponse() {
66
- return new Response(JSON.stringify(this.toJSON()), {
67
- status: this.statusCode,
68
- headers: { 'Content-Type': 'application/json' }
69
- });
70
- }
71
- }
72
-
73
- /**
74
- * Validation error — thrown when input fails schema validation.
75
- *
76
- * @example
77
- * throw new ValidationError("Field 'avatar_url' must be a valid URL or null", 'avatar_url');
78
- */
79
- export class ValidationError extends AfriCodeError {
80
- /**
81
- * @param {string} message
82
- * @param {string} [field] - The field that failed validation
83
- * @param {Object} [context={}]
84
- */
85
- constructor(message, field = null, context = {}) {
86
- super(message, 'VALIDATION_FAILED', { field, ...context }, 422);
87
- this.name = 'ValidationError';
88
- }
89
-
90
- /**
91
- * Create a ValidationError from a Zod error.
92
- * @param {import('zod').ZodError} zodError
93
- * @returns {ValidationError}
94
- */
95
- static fromZodError(zodError) {
96
- const firstIssue = zodError.issues[0];
97
- const field = firstIssue?.path?.join('.') || null;
98
- const message = firstIssue?.message || 'Validation failed';
99
-
100
- return new ValidationError(message, field, {
101
- issues: zodError.issues.map(issue => ({
102
- field: issue.path.join('.'),
103
- message: issue.message,
104
- code: issue.code
105
- }))
106
- });
107
- }
108
- }
109
-
110
- /**
111
- * Invalid URL error — specific subtype of validation error for URL fields.
112
- *
113
- * @example
114
- * throw new InvalidUrlError('avatar_url', '');
115
- * // → { error: { code: "INVALID_URL", message: "Field 'avatar_url' ...", field: "avatar_url" } }
116
- */
117
- export class InvalidUrlError extends AfriCodeError {
118
- /**
119
- * @param {string} field - The URL field name
120
- * @param {*} value - The invalid value that was provided
121
- */
122
- constructor(field, value) {
123
- const valueDesc = value === '' ? 'an empty string' : `"${value}"`;
124
- super(
125
- `Field '${field}' must be a valid URL or null. Got ${valueDesc}.`,
126
- 'INVALID_URL',
127
- { field, received: value },
128
- 422
129
- );
130
- this.name = 'InvalidUrlError';
131
- }
132
- }
133
-
134
- /**
135
- * Security error — thrown for CSRF violations, rate limiting, etc.
136
- */
137
- export class SecurityError extends AfriCodeError {
138
- /**
139
- * @param {string} message
140
- * @param {string} [code='SECURITY_VIOLATION']
141
- * @param {Object} [context={}]
142
- * @param {number} [statusCode=403]
143
- */
144
- constructor(message, code = 'SECURITY_VIOLATION', context = {}, statusCode = 403) {
145
- super(message, code, context, statusCode);
146
- this.name = 'SecurityError';
147
- }
148
- }
149
-
150
- /**
151
- * CSRF error — thrown when CSRF token is missing or mismatched.
152
- */
153
- export class CsrfError extends SecurityError {
154
- constructor(reason = 'missing') {
155
- const messages = {
156
- missing: 'CSRF token missing. Include the token in both the cookie and the X-CSRF-Token header.',
157
- mismatch: 'CSRF token mismatch. The header token does not match the cookie token.'
158
- };
159
- super(messages[reason] || messages.missing, 'CSRF_FAILURE', { reason });
160
- this.name = 'CsrfError';
161
- }
162
- }
163
-
164
- /**
165
- * Rate limit error — thrown when request limit is exceeded.
166
- */
167
- export class RateLimitError extends SecurityError {
168
- /**
169
- * @param {number} retryAfter - Seconds until the client can retry
170
- * @param {string} [message]
171
- */
172
- constructor(retryAfter, message = 'Too many requests. Please try again later.') {
173
- super(message, 'RATE_LIMIT_EXCEEDED', { retryAfter }, 429);
174
- this.name = 'RateLimitError';
175
- }
176
- }
177
-
178
- /**
179
- * Database error — thrown for DB operation failures.
180
- */
181
- export class DatabaseError extends AfriCodeError {
182
- /**
183
- * @param {string} message
184
- * @param {string} [operation] - The operation that failed (e.g. 'INSERT', 'UPDATE')
185
- * @param {Object} [context={}]
186
- */
187
- constructor(message, operation = null, context = {}) {
188
- super(message, 'DATABASE_ERROR', { operation, ...context }, 500);
189
- this.name = 'DatabaseError';
190
- }
191
- }
192
-
193
- /**
194
- * Component error — thrown for Web Component failures.
195
- */
196
- export class ComponentError extends AfriCodeError {
197
- /**
198
- * @param {string} message
199
- * @param {string} componentName - The component tag name (e.g. 'af-button')
200
- * @param {Object} [context={}]
201
- */
202
- constructor(message, componentName, context = {}) {
203
- super(
204
- `Component Error in <${componentName}>: ${message}`,
205
- 'COMPONENT_ERROR',
206
- { componentName, ...context },
207
- 500
208
- );
209
- this.name = 'ComponentError';
210
- }
211
- }
212
-
213
- export default {
214
- AfriCodeError,
215
- ValidationError,
216
- InvalidUrlError,
217
- SecurityError,
218
- CsrfError,
219
- RateLimitError,
220
- DatabaseError,
221
- ComponentError
222
- };
1
+ /**
2
+ * AfriCode Error System
3
+ *
4
+ * Standardized error hierarchy for the entire framework.
5
+ * Every error has: code, message, field (optional), context (optional).
6
+ *
7
+ * Design:
8
+ * - All framework errors extend AfriCodeError
9
+ * - Errors carry structured metadata for programmatic handling
10
+ * - toJSON() produces a consistent API response format
11
+ * - Error codes are namespaced: VALIDATION_*, SECURITY_*, DB_*, etc.
12
+ *
13
+ * @module core/errors
14
+ */
15
+
16
+ /**
17
+ * Base error class for all AfriCode framework errors.
18
+ *
19
+ * @example
20
+ * throw new AfriCodeError('Something failed', 'GENERIC_ERROR', { detail: '...' });
21
+ *
22
+ * @example
23
+ * // In an API handler:
24
+ * try { ... } catch (err) {
25
+ * if (err instanceof AfriCodeError) {
26
+ * return new Response(JSON.stringify(err.toJSON()), { status: err.statusCode });
27
+ * }
28
+ * }
29
+ */
30
+ export class AfriCodeError extends Error {
31
+ /**
32
+ * @param {string} message - Human-readable error message
33
+ * @param {string} code - Machine-readable error code (e.g. 'VALIDATION_FAILED')
34
+ * @param {Object} [context={}] - Additional context for debugging
35
+ * @param {number} [statusCode=500] - HTTP status code
36
+ */
37
+ constructor(message, code = 'INTERNAL_ERROR', context = {}, statusCode = 500) {
38
+ super(message);
39
+ this.name = 'AfriCodeError';
40
+ this.code = code;
41
+ this.context = context;
42
+ this.statusCode = statusCode;
43
+ this.timestamp = new Date().toISOString();
44
+ }
45
+
46
+ /**
47
+ * Produce a consistent JSON structure for API responses.
48
+ * @returns {Object}
49
+ */
50
+ toJSON() {
51
+ return {
52
+ error: {
53
+ code: this.code,
54
+ message: this.message,
55
+ ...(this.context.field ? { field: this.context.field } : {}),
56
+ ...(Object.keys(this.context).length > 0 ? { context: this.context } : {})
57
+ }
58
+ };
59
+ }
60
+
61
+ /**
62
+ * Create an HTTP Response from this error.
63
+ * @returns {Response}
64
+ */
65
+ toResponse() {
66
+ return new Response(JSON.stringify(this.toJSON()), {
67
+ status: this.statusCode,
68
+ headers: { 'Content-Type': 'application/json' }
69
+ });
70
+ }
71
+ }
72
+
73
+ /**
74
+ * Validation error — thrown when input fails schema validation.
75
+ *
76
+ * @example
77
+ * throw new ValidationError("Field 'avatar_url' must be a valid URL or null", 'avatar_url');
78
+ */
79
+ export class ValidationError extends AfriCodeError {
80
+ /**
81
+ * @param {string} message
82
+ * @param {string} [field] - The field that failed validation
83
+ * @param {Object} [context={}]
84
+ */
85
+ constructor(message, field = null, context = {}) {
86
+ super(message, 'VALIDATION_FAILED', { field, ...context }, 422);
87
+ this.name = 'ValidationError';
88
+ }
89
+
90
+ /**
91
+ * Create a ValidationError from a Zod error.
92
+ * @param {import('zod').ZodError} zodError
93
+ * @returns {ValidationError}
94
+ */
95
+ static fromZodError(zodError) {
96
+ const firstIssue = zodError.issues[0];
97
+ const field = firstIssue?.path?.join('.') || null;
98
+ const message = firstIssue?.message || 'Validation failed';
99
+
100
+ return new ValidationError(message, field, {
101
+ issues: zodError.issues.map(issue => ({
102
+ field: issue.path.join('.'),
103
+ message: issue.message,
104
+ code: issue.code
105
+ }))
106
+ });
107
+ }
108
+ }
109
+
110
+ /**
111
+ * Invalid URL error — specific subtype of validation error for URL fields.
112
+ *
113
+ * @example
114
+ * throw new InvalidUrlError('avatar_url', '');
115
+ * // → { error: { code: "INVALID_URL", message: "Field 'avatar_url' ...", field: "avatar_url" } }
116
+ */
117
+ export class InvalidUrlError extends AfriCodeError {
118
+ /**
119
+ * @param {string} field - The URL field name
120
+ * @param {*} value - The invalid value that was provided
121
+ */
122
+ constructor(field, value) {
123
+ const valueDesc = value === '' ? 'an empty string' : `"${value}"`;
124
+ super(
125
+ `Field '${field}' must be a valid URL or null. Got ${valueDesc}.`,
126
+ 'INVALID_URL',
127
+ { field, received: value },
128
+ 422
129
+ );
130
+ this.name = 'InvalidUrlError';
131
+ }
132
+ }
133
+
134
+ /**
135
+ * Security error — thrown for CSRF violations, rate limiting, etc.
136
+ */
137
+ export class SecurityError extends AfriCodeError {
138
+ /**
139
+ * @param {string} message
140
+ * @param {string} [code='SECURITY_VIOLATION']
141
+ * @param {Object} [context={}]
142
+ * @param {number} [statusCode=403]
143
+ */
144
+ constructor(message, code = 'SECURITY_VIOLATION', context = {}, statusCode = 403) {
145
+ super(message, code, context, statusCode);
146
+ this.name = 'SecurityError';
147
+ }
148
+ }
149
+
150
+ /**
151
+ * CSRF error — thrown when CSRF token is missing or mismatched.
152
+ */
153
+ export class CsrfError extends SecurityError {
154
+ constructor(reason = 'missing') {
155
+ const messages = {
156
+ missing: 'CSRF token missing. Include the token in both the cookie and the X-CSRF-Token header.',
157
+ mismatch: 'CSRF token mismatch. The header token does not match the cookie token.'
158
+ };
159
+ super(messages[reason] || messages.missing, 'CSRF_FAILURE', { reason });
160
+ this.name = 'CsrfError';
161
+ }
162
+ }
163
+
164
+ /**
165
+ * Rate limit error — thrown when request limit is exceeded.
166
+ */
167
+ export class RateLimitError extends SecurityError {
168
+ /**
169
+ * @param {number} retryAfter - Seconds until the client can retry
170
+ * @param {string} [message]
171
+ */
172
+ constructor(retryAfter, message = 'Too many requests. Please try again later.') {
173
+ super(message, 'RATE_LIMIT_EXCEEDED', { retryAfter }, 429);
174
+ this.name = 'RateLimitError';
175
+ }
176
+ }
177
+
178
+ /**
179
+ * Database error — thrown for DB operation failures.
180
+ */
181
+ export class DatabaseError extends AfriCodeError {
182
+ /**
183
+ * @param {string} message
184
+ * @param {string} [operation] - The operation that failed (e.g. 'INSERT', 'UPDATE')
185
+ * @param {Object} [context={}]
186
+ */
187
+ constructor(message, operation = null, context = {}) {
188
+ super(message, 'DATABASE_ERROR', { operation, ...context }, 500);
189
+ this.name = 'DatabaseError';
190
+ }
191
+ }
192
+
193
+ /**
194
+ * Component error — thrown for Web Component failures.
195
+ */
196
+ export class ComponentError extends AfriCodeError {
197
+ /**
198
+ * @param {string} message
199
+ * @param {string} componentName - The component tag name (e.g. 'af-button')
200
+ * @param {Object} [context={}]
201
+ */
202
+ constructor(message, componentName, context = {}) {
203
+ super(
204
+ `Component Error in <${componentName}>: ${message}`,
205
+ 'COMPONENT_ERROR',
206
+ { componentName, ...context },
207
+ 500
208
+ );
209
+ this.name = 'ComponentError';
210
+ }
211
+ }
212
+
213
+ export default {
214
+ AfriCodeError,
215
+ ValidationError,
216
+ InvalidUrlError,
217
+ SecurityError,
218
+ CsrfError,
219
+ RateLimitError,
220
+ DatabaseError,
221
+ ComponentError
222
+ };
@@ -1,50 +1,52 @@
1
- /**
2
- * Compatibility router for legacy runtime entry points.
3
- * The canonical route scanner lives in core/router.js.
4
- */
5
-
6
- import { FileSystemRouter } from './router.js';
7
- import { join } from 'path';
8
-
9
- export class FileBasedRouter {
10
- constructor(options = {}) {
11
- this.router = new FileSystemRouter(join(process.cwd(), options.pagesDir || 'pages'));
12
- }
13
-
14
- matchRoute(pathname) {
15
- const resolved = this.router.resolve(pathname);
16
- if (!resolved) return null;
17
-
18
- return {
19
- type: resolved.isApi ? "api" : "page",
20
- route: pathname,
21
- filePath: resolved.filePath,
22
- params: resolved.params || {},
23
- isDynamic: Boolean(resolved.isDynamic),
24
- isApi: Boolean(resolved.isApi),
25
- handler: null,
26
- component: null
27
- };
28
- }
29
-
30
- async loadRoute(routeMatch) {
31
- const module = await import(routeMatch.filePath);
32
- if (routeMatch.type === "api") {
33
- routeMatch.handler = module.default || module;
34
- return routeMatch.handler;
35
- }
36
-
37
- routeMatch.component = module.default || module;
38
- return routeMatch.component;
39
- }
40
-
41
- getRoutes() {
42
- return this.router.getRoutes();
43
- }
44
-
45
- clearCache() {
46
- return;
47
- }
48
- }
49
-
50
- export default FileBasedRouter;
1
+ /**
2
+ * Compatibility router for legacy runtime entry points.
3
+ * The canonical route scanner lives in core/router.js.
4
+ */
5
+
6
+ import { FileSystemRouter } from './router.js';
7
+ import { join } from 'path';
8
+ import { pathToFileURL } from 'node:url';
9
+
10
+ export class FileBasedRouter {
11
+ constructor(options = {}) {
12
+ this.router = new FileSystemRouter(join(process.cwd(), options.pagesDir || 'pages'));
13
+ }
14
+
15
+ matchRoute(pathname) {
16
+ const resolved = this.router.resolve(pathname);
17
+ if (!resolved) {return null;}
18
+
19
+ return {
20
+ type: resolved.isApi ? "api" : "page",
21
+ route: pathname,
22
+ filePath: resolved.filePath,
23
+ params: resolved.params || {},
24
+ isDynamic: Boolean(resolved.isDynamic),
25
+ isApi: Boolean(resolved.isApi),
26
+ handler: null,
27
+ component: null
28
+ };
29
+ }
30
+
31
+ async loadRoute(routeMatch) {
32
+ const moduleUrl = pathToFileURL(routeMatch.filePath).href;
33
+ const module = await import(moduleUrl);
34
+ if (routeMatch.type === "api") {
35
+ routeMatch.handler = module.default || module;
36
+ return routeMatch.handler;
37
+ }
38
+
39
+ routeMatch.component = module.default || module;
40
+ return routeMatch.component;
41
+ }
42
+
43
+ getRoutes() {
44
+ return this.router.getRoutes();
45
+ }
46
+
47
+ clearCache() {
48
+ return;
49
+ }
50
+ }
51
+
52
+ export default FileBasedRouter;