@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/db.js CHANGED
@@ -1,284 +1,282 @@
1
- /**
2
- * AfriCode Database Engine
3
- * Type-safe SQLite ORM with migrations and schema management
4
- *
5
- * URL fields (avatar_url, repository_url, demo_url) are validated strictly:
6
- * - Valid URL → accepted
7
- * - null → accepted (nullable columns)
8
- * - "" (empty string) → rejected with error
9
- */
10
- import { Database } from "bun:sqlite";
11
- import { Validation, schemas } from './validation.js';
12
- import { InvalidUrlError } from './errors.js';
13
- import { emitDatabaseError } from './config.js';
14
-
15
- // Automatically creates/opens 'afriCode.db' in the project root
16
- const dbUrl = new URL('../afriCode.db', import.meta.url);
17
- const isWindows = typeof process !== 'undefined' && process.platform === 'win32';
18
- const dbPath = decodeURIComponent(isWindows ? dbUrl.pathname.replace(/^\//, '') : dbUrl.pathname);
19
- const db = new Database(dbPath, { create: true });
20
-
21
- // Enable WAL mode for better concurrency
22
- db.query("PRAGMA journal_mode = WAL;").run();
23
-
24
- // Initialize schema
25
- initSchema();
26
-
27
- function initSchema() {
28
- // Users table
29
- db.query(`
30
- CREATE TABLE IF NOT EXISTS users (
31
- id INTEGER PRIMARY KEY AUTOINCREMENT,
32
- email TEXT UNIQUE NOT NULL,
33
- username TEXT UNIQUE NOT NULL,
34
- password_hash TEXT NOT NULL,
35
- full_name TEXT,
36
- avatar_url TEXT,
37
- bio TEXT,
38
- theme TEXT DEFAULT 'africanity',
39
- language TEXT DEFAULT 'en',
40
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
41
- updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
42
- )
43
- `).run();
44
-
45
- // Projects table
46
- db.query(`
47
- CREATE TABLE IF NOT EXISTS projects (
48
- id INTEGER PRIMARY KEY AUTOINCREMENT,
49
- name TEXT NOT NULL,
50
- description TEXT,
51
- owner_id INTEGER NOT NULL,
52
- is_public BOOLEAN DEFAULT 0,
53
- repository_url TEXT,
54
- demo_url TEXT,
55
- tags TEXT, -- JSON array
56
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
57
- updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
58
- FOREIGN KEY (owner_id) REFERENCES users(id)
59
- )
60
- `).run();
61
-
62
- // Components table for storing custom components
63
- db.query(`
64
- CREATE TABLE IF NOT EXISTS components (
65
- id INTEGER PRIMARY KEY AUTOINCREMENT,
66
- name TEXT UNIQUE NOT NULL,
67
- code TEXT NOT NULL,
68
- author_id INTEGER NOT NULL,
69
- category TEXT,
70
- tags TEXT, -- JSON array
71
- is_public BOOLEAN DEFAULT 0,
72
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
73
- updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
74
- FOREIGN KEY (author_id) REFERENCES users(id)
75
- )
76
- `).run();
77
-
78
- // Sessions table for auth
79
- db.query(`
80
- CREATE TABLE IF NOT EXISTS sessions (
81
- id TEXT PRIMARY KEY,
82
- user_id INTEGER NOT NULL,
83
- expires_at DATETIME NOT NULL,
84
- created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
85
- FOREIGN KEY (user_id) REFERENCES users(id)
86
- )
87
- `).run();
88
- }
89
-
90
- /**
91
- * Validate URL fields strictly.
92
- * Rejects empty strings, accepts valid URLs and null.
93
- * Uses standardized InvalidUrlError for consistent error format.
94
- *
95
- * @param {Object} data - The data object to validate
96
- * @param {string[]} urlFields - Field names that should be validated as URLs
97
- * @throws {InvalidUrlError} If any URL field contains an empty string or invalid URL
98
- */
99
- function validateUrlFields(data, urlFields) {
100
- for (const field of urlFields) {
101
- if (!(field in data)) {continue;}
102
-
103
- const value = data[field];
104
-
105
- // null is allowed (nullable columns)
106
- if (value === null || value === undefined) {continue;}
107
-
108
- // Empty string is strictly rejected
109
- if (value === '') {
110
- throw new InvalidUrlError(field, value);
111
- }
112
-
113
- // Must be a valid URL
114
- try {
115
- new URL(value);
116
- } catch {
117
- throw new InvalidUrlError(field, value);
118
- }
119
- }
120
- }
121
-
122
- /**
123
- * User Model Operations
124
- */
125
- export const User = {
126
- create: (userData) => {
127
- const { email, username, password_hash, full_name } = userData;
128
- const result = run(`
129
- INSERT INTO users (email, username, password_hash, full_name)
130
- VALUES (?, ?, ?, ?)
131
- `, [email, username, password_hash, full_name]);
132
- return result.lastInsertRowid;
133
- },
134
-
135
- findById: (id) => get('SELECT * FROM users WHERE id = ?', [id]),
136
-
137
- findByEmail: (email) => get('SELECT * FROM users WHERE email = ?', [email]),
138
-
139
- findByUsername: (username) => get('SELECT * FROM users WHERE username = ?', [username]),
140
-
141
- update: (id, updates) => {
142
- // Validate URL fields strictly: no empty strings, only valid URLs or null
143
- validateUrlFields(updates, ['avatar_url']);
144
-
145
- const fields = Object.keys(updates);
146
- const values = Object.values(updates);
147
- const setClause = fields.map(field => `${field} = ?`).join(', ');
148
- const sql = `UPDATE users SET ${setClause}, updated_at = CURRENT_TIMESTAMP WHERE id = ?`;
149
- try {
150
- console.log('DB User.update:', { sql, params: [...values, id] });
151
- return run(sql, [...values, id]);
152
- } catch (err) {
153
- console.error('DB User.update error:', err, { sql, params: [...values, id] });
154
- throw err;
155
- }
156
- }
157
- };
158
-
159
- /**
160
- * Project Model Operations
161
- */
162
- export const Project = {
163
- create: (projectData) => {
164
- // Validate URL fields strictly: no empty strings, only valid URLs or null
165
- validateUrlFields(projectData, ['repository_url', 'demo_url']);
166
-
167
- const { name, description, owner_id, repository_url, demo_url, tags } = projectData;
168
- const result = run(`
169
- INSERT INTO projects (name, description, owner_id, repository_url, demo_url, tags)
170
- VALUES (?, ?, ?, ?, ?, ?)
171
- `, [name, description, owner_id, repository_url || null, demo_url || null, JSON.stringify(tags || [])]);
172
- return result.lastInsertRowid;
173
- },
174
-
175
- findByUser: (userId, limit = 50) => query(`
176
- SELECT p.*, u.username as owner_username
177
- FROM projects p
178
- JOIN users u ON p.owner_id = u.id
179
- WHERE p.owner_id = ? OR p.is_public = 1
180
- ORDER BY p.created_at DESC
181
- LIMIT ?
182
- `, [userId, limit]),
183
-
184
- findById: (id) => get(`
185
- SELECT p.*, u.username as owner_username
186
- FROM projects p
187
- JOIN users u ON p.owner_id = u.id
188
- WHERE p.id = ?
189
- `, [id])
190
- };
191
-
192
- /**
193
- * Component Model Operations
194
- */
195
- export const Component = {
196
- create: (componentData) => {
197
- const { name, code, author_id, category, tags } = componentData;
198
- const result = run(`
199
- INSERT INTO components (name, code, author_id, category, tags)
200
- VALUES (?, ?, ?, ?, ?)
201
- `, [name, code, author_id, category, JSON.stringify(tags || [])]);
202
- return result.lastInsertRowid;
203
- },
204
-
205
- findPublic: (limit = 100) => query(`
206
- SELECT c.*, u.username as author_username
207
- FROM components c
208
- JOIN users u ON c.author_id = u.id
209
- WHERE c.is_public = 1
210
- ORDER BY c.created_at DESC
211
- LIMIT ?
212
- `, [limit]),
213
-
214
- findById: (id) => get(`
215
- SELECT c.*, u.username as author_username
216
- FROM components c
217
- JOIN users u ON c.author_id = u.id
218
- WHERE c.id = ?
219
- `, [id])
220
- };
221
-
222
- /**
223
- * Session Model Operations
224
- */
225
- export const Session = {
226
- create: (sessionData) => {
227
- const { id, user_id, expires_at } = sessionData;
228
- return run(`
229
- INSERT INTO sessions (id, user_id, expires_at)
230
- VALUES (?, ?, ?)
231
- `, [id, user_id, expires_at]);
232
- },
233
-
234
- findById: (id) => get(`
235
- SELECT s.*, u.username, u.email
236
- FROM sessions s
237
- JOIN users u ON s.user_id = u.id
238
- WHERE s.id = ? AND s.expires_at > CURRENT_TIMESTAMP
239
- `, [id]),
240
-
241
- update: (id, updates) => {
242
- const fields = Object.keys(updates);
243
- const values = Object.values(updates);
244
- const setClause = fields.map(field => `${field} = ?`).join(', ');
245
- const sql = `UPDATE sessions SET ${setClause} WHERE id = ?`;
246
- return run(sql, [...values, id]);
247
- },
248
-
249
- delete: (id) => run('DELETE FROM sessions WHERE id = ?', [id]),
250
-
251
- cleanup: () => run('DELETE FROM sessions WHERE expires_at <= CURRENT_TIMESTAMP')
252
- };
253
-
254
- /**
255
- * Execute a query and return all results
256
- * @param {string} sql - SQL query
257
- * @param {Array} params - Binding parameters
258
- * @returns {Array} Array of row objects
259
- */
260
- export function query(sql, params = []) {
261
- return db.query(sql).all(...params);
262
- }
263
-
264
- /**
265
- * Execute a query and return a single result
266
- * @param {string} sql - SQL query
267
- * @param {Array} params - Binding parameters
268
- * @returns {Object} Single row object
269
- */
270
- export function get(sql, params = []) {
271
- return db.query(sql).get(...params);
272
- }
273
-
274
- /**
275
- * Run a command (INSERT, UPDATE, DELETE)
276
- * @param {string} sql - SQL command
277
- * @param {Array} params - Binding parameters
278
- * @returns {Object} Result info (changes, lastInsertRowid)
279
- */
280
- export function run(sql, params = []) {
281
- return db.query(sql).run(...params);
282
- }
283
-
284
- export default { query, get, run, native: db, User, Project, Component, Session };
1
+ /**
2
+ * AfriCode Database Engine
3
+ * Type-safe SQLite ORM with migrations and schema management
4
+ *
5
+ * URL fields (avatar_url, repository_url, demo_url) are validated strictly:
6
+ * - Valid URL → accepted
7
+ * - null → accepted (nullable columns)
8
+ * - "" (empty string) → rejected with error
9
+ */
10
+ import { Database } from "bun:sqlite";
11
+ import { InvalidUrlError } from './errors.js';
12
+
13
+ // Automatically creates/opens 'afriCode.db' in the project root
14
+ const dbUrl = new URL('../afriCode.db', import.meta.url);
15
+ const isWindows = typeof process !== 'undefined' && process.platform === 'win32';
16
+ const dbPath = decodeURIComponent(isWindows ? dbUrl.pathname.replace(/^\//, '') : dbUrl.pathname);
17
+ const db = new Database(dbPath, { create: true });
18
+
19
+ // Enable WAL mode for better concurrency
20
+ db.query("PRAGMA journal_mode = WAL;").run();
21
+
22
+ // Initialize schema
23
+ initSchema();
24
+
25
+ function initSchema() {
26
+ // Users table
27
+ db.query(`
28
+ CREATE TABLE IF NOT EXISTS users (
29
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
30
+ email TEXT UNIQUE NOT NULL,
31
+ username TEXT UNIQUE NOT NULL,
32
+ password_hash TEXT NOT NULL,
33
+ full_name TEXT,
34
+ avatar_url TEXT,
35
+ bio TEXT,
36
+ theme TEXT DEFAULT 'africanity',
37
+ language TEXT DEFAULT 'en',
38
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
39
+ updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
40
+ )
41
+ `).run();
42
+
43
+ // Projects table
44
+ db.query(`
45
+ CREATE TABLE IF NOT EXISTS projects (
46
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
47
+ name TEXT NOT NULL,
48
+ description TEXT,
49
+ owner_id INTEGER NOT NULL,
50
+ is_public BOOLEAN DEFAULT 0,
51
+ repository_url TEXT,
52
+ demo_url TEXT,
53
+ tags TEXT, -- JSON array
54
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
55
+ updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
56
+ FOREIGN KEY (owner_id) REFERENCES users(id)
57
+ )
58
+ `).run();
59
+
60
+ // Components table for storing custom components
61
+ db.query(`
62
+ CREATE TABLE IF NOT EXISTS components (
63
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
64
+ name TEXT UNIQUE NOT NULL,
65
+ code TEXT NOT NULL,
66
+ author_id INTEGER NOT NULL,
67
+ category TEXT,
68
+ tags TEXT, -- JSON array
69
+ is_public BOOLEAN DEFAULT 0,
70
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
71
+ updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
72
+ FOREIGN KEY (author_id) REFERENCES users(id)
73
+ )
74
+ `).run();
75
+
76
+ // Sessions table for auth
77
+ db.query(`
78
+ CREATE TABLE IF NOT EXISTS sessions (
79
+ id TEXT PRIMARY KEY,
80
+ user_id INTEGER NOT NULL,
81
+ expires_at DATETIME NOT NULL,
82
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
83
+ FOREIGN KEY (user_id) REFERENCES users(id)
84
+ )
85
+ `).run();
86
+ }
87
+
88
+ /**
89
+ * Validate URL fields strictly.
90
+ * Rejects empty strings, accepts valid URLs and null.
91
+ * Uses standardized InvalidUrlError for consistent error format.
92
+ *
93
+ * @param {Object} data - The data object to validate
94
+ * @param {string[]} urlFields - Field names that should be validated as URLs
95
+ * @throws {InvalidUrlError} If any URL field contains an empty string or invalid URL
96
+ */
97
+ function validateUrlFields(data, urlFields) {
98
+ for (const field of urlFields) {
99
+ if (!(field in data)) {continue;}
100
+
101
+ const value = data[field];
102
+
103
+ // null is allowed (nullable columns)
104
+ if (value === null || value === undefined) {continue;}
105
+
106
+ // Empty string is strictly rejected
107
+ if (value === '') {
108
+ throw new InvalidUrlError(field, value);
109
+ }
110
+
111
+ // Must be a valid URL
112
+ try {
113
+ new URL(value);
114
+ } catch {
115
+ throw new InvalidUrlError(field, value);
116
+ }
117
+ }
118
+ }
119
+
120
+ /**
121
+ * User Model Operations
122
+ */
123
+ export const User = {
124
+ create: (userData) => {
125
+ const { email, username, password_hash, full_name } = userData;
126
+ const result = run(`
127
+ INSERT INTO users (email, username, password_hash, full_name)
128
+ VALUES (?, ?, ?, ?)
129
+ `, [email, username, password_hash, full_name]);
130
+ return result.lastInsertRowid;
131
+ },
132
+
133
+ findById: (id) => get('SELECT * FROM users WHERE id = ?', [id]),
134
+
135
+ findByEmail: (email) => get('SELECT * FROM users WHERE email = ?', [email]),
136
+
137
+ findByUsername: (username) => get('SELECT * FROM users WHERE username = ?', [username]),
138
+
139
+ update: (id, updates) => {
140
+ // Validate URL fields strictly: no empty strings, only valid URLs or null
141
+ validateUrlFields(updates, ['avatar_url']);
142
+
143
+ const fields = Object.keys(updates);
144
+ const values = Object.values(updates);
145
+ const setClause = fields.map(field => `${field} = ?`).join(', ');
146
+ const sql = `UPDATE users SET ${setClause}, updated_at = CURRENT_TIMESTAMP WHERE id = ?`;
147
+ try {
148
+ console.log('DB User.update:', { sql, params: [...values, id] });
149
+ return run(sql, [...values, id]);
150
+ } catch (err) {
151
+ console.error('DB User.update error:', err, { sql, params: [...values, id] });
152
+ throw err;
153
+ }
154
+ }
155
+ };
156
+
157
+ /**
158
+ * Project Model Operations
159
+ */
160
+ export const Project = {
161
+ create: (projectData) => {
162
+ // Validate URL fields strictly: no empty strings, only valid URLs or null
163
+ validateUrlFields(projectData, ['repository_url', 'demo_url']);
164
+
165
+ const { name, description, owner_id, repository_url, demo_url, tags } = projectData;
166
+ const result = run(`
167
+ INSERT INTO projects (name, description, owner_id, repository_url, demo_url, tags)
168
+ VALUES (?, ?, ?, ?, ?, ?)
169
+ `, [name, description, owner_id, repository_url || null, demo_url || null, JSON.stringify(tags || [])]);
170
+ return result.lastInsertRowid;
171
+ },
172
+
173
+ findByUser: (userId, limit = 50) => query(`
174
+ SELECT p.*, u.username as owner_username
175
+ FROM projects p
176
+ JOIN users u ON p.owner_id = u.id
177
+ WHERE p.owner_id = ? OR p.is_public = 1
178
+ ORDER BY p.created_at DESC
179
+ LIMIT ?
180
+ `, [userId, limit]),
181
+
182
+ findById: (id) => get(`
183
+ SELECT p.*, u.username as owner_username
184
+ FROM projects p
185
+ JOIN users u ON p.owner_id = u.id
186
+ WHERE p.id = ?
187
+ `, [id])
188
+ };
189
+
190
+ /**
191
+ * Component Model Operations
192
+ */
193
+ export const Component = {
194
+ create: (componentData) => {
195
+ const { name, code, author_id, category, tags } = componentData;
196
+ const result = run(`
197
+ INSERT INTO components (name, code, author_id, category, tags)
198
+ VALUES (?, ?, ?, ?, ?)
199
+ `, [name, code, author_id, category, JSON.stringify(tags || [])]);
200
+ return result.lastInsertRowid;
201
+ },
202
+
203
+ findPublic: (limit = 100) => query(`
204
+ SELECT c.*, u.username as author_username
205
+ FROM components c
206
+ JOIN users u ON c.author_id = u.id
207
+ WHERE c.is_public = 1
208
+ ORDER BY c.created_at DESC
209
+ LIMIT ?
210
+ `, [limit]),
211
+
212
+ findById: (id) => get(`
213
+ SELECT c.*, u.username as author_username
214
+ FROM components c
215
+ JOIN users u ON c.author_id = u.id
216
+ WHERE c.id = ?
217
+ `, [id])
218
+ };
219
+
220
+ /**
221
+ * Session Model Operations
222
+ */
223
+ export const Session = {
224
+ create: (sessionData) => {
225
+ const { id, user_id, expires_at } = sessionData;
226
+ return run(`
227
+ INSERT INTO sessions (id, user_id, expires_at)
228
+ VALUES (?, ?, ?)
229
+ `, [id, user_id, expires_at]);
230
+ },
231
+
232
+ findById: (id) => get(`
233
+ SELECT s.*, u.username, u.email
234
+ FROM sessions s
235
+ JOIN users u ON s.user_id = u.id
236
+ WHERE s.id = ? AND s.expires_at > CURRENT_TIMESTAMP
237
+ `, [id]),
238
+
239
+ update: (id, updates) => {
240
+ const fields = Object.keys(updates);
241
+ const values = Object.values(updates);
242
+ const setClause = fields.map(field => `${field} = ?`).join(', ');
243
+ const sql = `UPDATE sessions SET ${setClause} WHERE id = ?`;
244
+ return run(sql, [...values, id]);
245
+ },
246
+
247
+ delete: (id) => run('DELETE FROM sessions WHERE id = ?', [id]),
248
+
249
+ cleanup: () => run('DELETE FROM sessions WHERE expires_at <= CURRENT_TIMESTAMP')
250
+ };
251
+
252
+ /**
253
+ * Execute a query and return all results
254
+ * @param {string} sql - SQL query
255
+ * @param {Array} params - Binding parameters
256
+ * @returns {Array} Array of row objects
257
+ */
258
+ export function query(sql, params = []) {
259
+ return db.query(sql).all(...params);
260
+ }
261
+
262
+ /**
263
+ * Execute a query and return a single result
264
+ * @param {string} sql - SQL query
265
+ * @param {Array} params - Binding parameters
266
+ * @returns {Object} Single row object
267
+ */
268
+ export function get(sql, params = []) {
269
+ return db.query(sql).get(...params);
270
+ }
271
+
272
+ /**
273
+ * Run a command (INSERT, UPDATE, DELETE)
274
+ * @param {string} sql - SQL command
275
+ * @param {Array} params - Binding parameters
276
+ * @returns {Object} Result info (changes, lastInsertRowid)
277
+ */
278
+ export function run(sql, params = []) {
279
+ return db.query(sql).run(...params);
280
+ }
281
+
282
+ export default { query, get, run, native: db, User, Project, Component, Session };