@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,343 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * AfriCode CLI
4
- *
5
- * Commands:
6
- * africode dev - Start development server
7
- * africode build - Production build
8
- * africode add - Add component to project
9
- *
10
- * @module bin/africode
11
- */
12
-
13
- // --- SSR DOM SHIM (Must be first) ---
14
- if (typeof globalThis.HTMLElement === 'undefined') {
15
- globalThis.HTMLElement = class HTMLElement { };
16
- globalThis.customElements = { define: () => { }, get: () => { } };
17
- globalThis.document = {
18
- createElement: () => ({
19
- classList: { add: () => { } },
20
- setAttribute: () => { },
21
- style: {}
22
- }),
23
- head: { appendChild: () => { } },
24
- body: { appendChild: () => { } }
25
- };
26
- globalThis.window = globalThis;
27
- globalThis.CSSStyleSheet = class CSSStyleSheet { replaceSync() { } };
28
- }
29
- // ------------------------------------
30
-
31
- const args = process.argv.slice(2);
32
- const command = args[0];
33
- // Allows Web Components to be imported in Node/Bun environment
34
- if (typeof global !== 'undefined') {
35
- global.HTMLElement = class HTMLElement { };
36
- global.customElements = {
37
- define: () => { },
38
- get: () => { }
39
- };
40
- global.document = {
41
- createElement: () => ({ classList: { add: () => { } }, setAttribute: () => { } }),
42
- head: { appendChild: () => { } }
43
- };
44
- global.window = global;
45
- }
46
- // --------------------
47
-
48
- const colors = {
49
- green: '\x1b[32m',
50
- gold: '\x1b[33m',
51
- blue: '\x1b[34m',
52
- red: '\x1b[31m',
53
- reset: '\x1b[0m',
54
- bold: '\x1b[1m'
55
- };
56
-
57
- function logo() {
58
- console.log(`
59
- ${colors.gold}╔═══════════════════════════════════════╗
60
- ║ ║
61
- ║ ${colors.green}█████╗ ███████╗██████╗ ██╗${colors.gold} ║
62
- ║ ${colors.green}██╔══██╗██╔════╝██╔══██╗██║${colors.gold} ║
63
- ║ ${colors.green}███████║█████╗ ██████╔╝██║${colors.gold} ║
64
- ║ ${colors.green}██╔══██║██╔══╝ ██╔══██╗██║${colors.gold} ║
65
- ║ ${colors.green}██║ ██║██║ ██║ ██║██║${colors.gold} ║
66
- ║ ${colors.green}╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝╚═╝${colors.gold} ║
67
- ║ ║
68
- ║ ${colors.reset}The Rhythmic Web Framework${colors.gold} ║
69
- ╚═══════════════════════════════════════╝${colors.reset}
70
- `);
71
- }
72
-
73
- function help() {
74
- logo();
75
- console.log(`
76
- ${colors.bold}Usage:${colors.reset}
77
- africode <command> [options]
78
-
79
- ${colors.bold}Commands:${colors.reset}
80
- ${colors.green}dev${colors.reset} Start development server
81
- ${colors.green}build${colors.reset} Create production build
82
- ${colors.green}add${colors.reset} Add a component (e.g., africode add sidebar)
83
- ${colors.green}new${colors.reset} Create a new project (options: --template 3d)
84
- ${colors.green}migrate${colors.reset} Run database migrations
85
- ${colors.green}help${colors.reset} Show this help message
86
-
87
- ${colors.bold}Examples:${colors.reset}
88
- africode dev
89
- africode new my-app --template 3d
90
- africode add toast
91
-
92
- ${colors.gold}Powered by the rhythm of the continent.${colors.reset}
93
- `);
94
- }
95
-
96
- async function dev() {
97
- logo();
98
- console.log(`${colors.green}▶ Starting development server...${colors.reset}\n`);
99
-
100
- const server = Bun.serve({
101
- port: 3000,
102
- async fetch(req) {
103
- const url = new URL(req.url);
104
- let path = url.pathname;
105
-
106
- // 1. API Route Delegation
107
- if (path.startsWith('/api/')) {
108
- const { handleApiRequest } = await import('../core/server/router.js');
109
- const apiRes = await handleApiRequest(req);
110
- if (apiRes) return apiRes;
111
- }
112
-
113
- // 2. Root Redirect
114
- if (path === '/') path = '/index';
115
-
116
- // 3. JS-First Page Rendering (Next.js Style)
117
- // Route /about -> looks for pages/about.js
118
- const pageName = path.replace(/^\//, '').replace(/\.html$/, '');
119
- const jsPagePath = `./pages/${pageName}.js`;
120
-
121
- if (await Bun.file(jsPagePath).exists()) {
122
- try {
123
- // Dynamic Import with Cache Busting (for Hot Reloading in Dev)
124
- const pageModule = await import(`${process.cwd()}/pages/${pageName}.js?t=${Date.now()}`);
125
-
126
- // execute loader if present
127
- let loaderData = {};
128
- if (typeof pageModule.loader === 'function') {
129
- try {
130
- loaderData = await pageModule.loader({ request: req, params: {} });
131
- } catch (loadErr) {
132
- console.error(`Loader failed for ${pageName}:`, loadErr);
133
- return new Response(`Loader Error: ${loadErr.message}`, { status: 500 });
134
- }
135
- }
136
-
137
- // Render Default Export
138
- if (typeof pageModule.default === 'function') {
139
- // Pass loader data to the component
140
- const htmlContent = pageModule.default({ data: loaderData });
141
- return new Response(htmlContent, {
142
- headers: { 'Content-Type': 'text/html' }
143
- });
144
- }
145
- } catch (err) {
146
- console.error(`Error rendering page ${pageName}:`, err);
147
- return new Response(`Error rendering page: ${err.message}`, { status: 500 });
148
- }
149
- }
150
-
151
- // 4. Fallback to Static HTML (Legacy Support)
152
- // If .js doesn't exist, looking for .html
153
- if (await Bun.file(`./pages${path}.html`).exists()) {
154
- const { renderPage } = await import('../core/server/render.js');
155
- return await renderPage(`./pages${path}.html`);
156
- }
157
-
158
- // 5. Static Assets (CSS, Images, etc)
159
- const file = Bun.file('.' + url.pathname); // Use original path for assets
160
-
161
- if (await file.exists()) {
162
-
163
- // SSR Hook for HTML
164
- if (path.endsWith('.html')) {
165
- const { renderPage } = await import('../core/server/render.js');
166
- return await renderPage('.' + path);
167
- }
168
-
169
- const ext = path.split('.').pop();
170
- const types = {
171
- html: 'text/html', css: 'text/css', js: 'application/javascript',
172
- json: 'application/json', svg: 'image/svg+xml', png: 'image/png', jpg: 'image/jpeg'
173
- };
174
- return new Response(file, {
175
- headers: { 'Content-Type': types[ext] || 'application/octet-stream' }
176
- });
177
- }
178
-
179
- return new Response('404 Not Found', { status: 404 });
180
- }
181
- });
182
-
183
- console.log(`${colors.green}✓ Server running at ${colors.blue}http://localhost:${server.port}${colors.reset}`);
184
- console.log(`${colors.gold} Press Ctrl+C to stop${colors.reset}\n`);
185
- }
186
-
187
- async function build() {
188
- logo();
189
- console.log(`${colors.green}▶ Building for production (SSG + Islands)...${colors.reset}\n`);
190
-
191
- const { rm, cp, mkdir, readdir, writeFile } = await import('fs/promises');
192
- const path = await import('path');
193
- const distDir = './dist';
194
- const pagesDir = './pages';
195
-
196
- try {
197
- // Clean
198
- await rm(distDir, { recursive: true, force: true });
199
- await mkdir(distDir);
200
-
201
- // 1. Bundle Core SDK & Components (Islands)
202
- console.log(' Bundling JavaScript Islands...');
203
- const buildResult = await Bun.build({
204
- entrypoints: ['./core/sdk.js', './components/index.js'],
205
- outdir: './dist/assets',
206
- minify: true,
207
- splitting: true,
208
- target: 'browser',
209
- naming: '[name]-[hash].[ext]' // Cache busting
210
- });
211
-
212
- if (!buildResult.success) {
213
- throw new Error(buildResult.logs.join('\n'));
214
- }
215
-
216
- // 2. Static Site Generation (Pre-rendering)
217
- console.log(' Pre-rendering Pages (SSG)...');
218
- const pageFiles = await readdir(pagesDir);
219
- const routes = [];
220
-
221
- // Need the renderPage logic but adapted for Module imports
222
- // We can't easily reuse the dev server logic verbatim, so we implement the SSG loop here.
223
-
224
- for (const file of pageFiles) {
225
- if (!file.endsWith('.js')) continue;
226
-
227
- const name = file.replace('.js', '');
228
- const route = name === 'index' ? '/' : `/${name}`;
229
- routes.push(route);
230
-
231
- console.log(` • Rendering ${route}...`);
232
-
233
- // Dynamic Import of the Page Component
234
- // CAUTION: In a real CLI, we might need to transpile or ignore CSS imports if they exist in JS.
235
- // But since we use vanilla JS + tagged templates, it should work in Bun.
236
- const pagePath = path.resolve(process.cwd(), pagesDir, file);
237
- const pageModule = await import(pagePath);
238
-
239
- // Execute Loader (Server-Side Data Fetching)
240
- let loaderData = {};
241
- if (typeof pageModule.loader === 'function') {
242
- loaderData = await pageModule.loader({ request: new Request(`http://localhost${route}`), params: {} });
243
- }
244
-
245
- // Render HTML
246
- if (typeof pageModule.default === 'function') {
247
- const htmlContent = pageModule.default({ data: loaderData });
248
-
249
- // We need to inject the hashed SDK script paths into the HTML
250
- // For simplicity, we'll assume the standard names or use a manifest interaction if we were more advanced.
251
- // For now, let's keep the SDK imports standard in Layout (or replace them here).
252
- // NOTE: The Layout component currently hardcodes /core/sdk.js.
253
- // To support hashing, we'd need to update Layout or use a transform here.
254
- // We will stick to standard paths for the "Islands" bundles for now to keep it simple.
255
- // Or better: write a small logic to replace the script src.
256
-
257
- const outputPath = path.join(distDir, `${name}.html`);
258
- await writeFile(outputPath, htmlContent);
259
- }
260
- }
261
-
262
- // 3. Generate Sitemap
263
- console.log(' Generating Sitemap...');
264
- const { generateSitemap } = await import('../core/seo.js');
265
- const sitemapXml = generateSitemap('https://your-domain.com', routes);
266
- await writeFile(path.join(distDir, 'sitemap.xml'), sitemapXml);
267
-
268
- // 4. Copy Static Assets
269
- console.log(' Copying Assets...');
270
- if (await Bun.file('./styles').exists()) await cp('./styles', `${distDir}/styles`, { recursive: true });
271
- // Copy public assets if any (assuming root level assets or create a public folder later)
272
-
273
- // 5. Create Server Entry (Optional, for dynamic hosting)
274
- const serverBuild = await Bun.build({
275
- entrypoints: ['./server.js'],
276
- outdir: './dist',
277
- target: 'bun'
278
- });
279
-
280
- console.log(`${colors.green}✓ Build complete!${colors.reset}`);
281
- console.log(` Output: ${colors.blue}./dist${colors.reset} (Ready to deploy)`);
282
- console.log(` Pages: ${colors.bold}${routes.length}${colors.reset} pre-rendered`);
283
- console.log(` Sitemap: ${colors.blue}./dist/sitemap.xml${colors.reset}\n`);
284
-
285
- } catch (err) {
286
- console.error(`${colors.red}✗ Build failed:${colors.reset}`, err.message || err);
287
- }
288
- }
289
-
290
- async function addComponent(name) {
291
- if (!name) {
292
- console.log(`${colors.red}✗ Please specify a component name${colors.reset}`);
293
- console.log(` Example: africode add sidebar\n`);
294
- return;
295
- }
296
-
297
- const components = {
298
- sidebar: 'af-sidebar',
299
- tooltip: 'af-tooltip',
300
- toast: 'af-toast',
301
- skeleton: 'af-skeleton',
302
- dropdown: 'af-dropdown'
303
- };
304
-
305
- if (!components[name]) {
306
- console.log(`${colors.red}✗ Unknown component: ${name}${colors.reset}`);
307
- console.log(` Available: ${Object.keys(components).join(', ')}\n`);
308
- return;
309
- }
310
-
311
- console.log(`${colors.green}✓ Component ${colors.gold}${components[name]}${colors.green} is available in AfriCode!${colors.reset}`);
312
- console.log(` Import with: import './components/${name}.js';\n`);
313
- }
314
-
315
- // Command router
316
- switch (command) {
317
- case 'dev':
318
- dev();
319
- break;
320
- case 'build':
321
- build();
322
- break;
323
- case 'add':
324
- addComponent(args[1]);
325
- break;
326
- case 'migrate':
327
- const { runMigrations } = await import('../core/cli/migrator.js');
328
- await runMigrations();
329
- break;
330
- case 'new':
331
- case 'create':
332
- case 'init':
333
- const { createProject } = await import('./create-africode.js');
334
- await createProject(args[1]);
335
- break;
336
- case 'help':
337
- case '--help':
338
- case '-h':
339
- help();
340
- break;
341
- default:
342
- help();
343
- }
package/core/heartbeat.js DELETED
@@ -1,64 +0,0 @@
1
- /**
2
- * AfriCode Heartbeat (Integrity System)
3
- *
4
- * "Unremovable" integrity check that logs usage and validates
5
- * the framework environment.
6
- *
7
- * @module core/heartbeat
8
- */
9
-
10
- const HEARTBEAT_KEY = 'af_integrity';
11
- const FRAMEWORK_VERSION = '1.0.0';
12
-
13
- export function initHeartbeat() {
14
- // 1. Console Stamp
15
- console.log(
16
- `%c AfriCode v${FRAMEWORK_VERSION} %c Powered by the Rhythm of the Continent `,
17
- 'background: #1EB53A; color: white; padding: 4px; border-radius: 4px 0 0 4px; font-weight: bold;',
18
- 'background: #121212; color: #FCD116; padding: 4px; border-radius: 0 4px 4px 0;'
19
- );
20
-
21
- // 2. DOM Injection (Watermark)
22
- // Ensures attribution exists in the DOM, invisible but present
23
- if (typeof document !== 'undefined') {
24
- const meta = document.createElement('meta');
25
- meta.name = 'generator';
26
- meta.content = `AfriCode ${FRAMEWORK_VERSION}`;
27
- document.head.appendChild(meta);
28
-
29
- // "Unremovable" attribute watcher
30
- // If someone tries to remove the attribute, it puts it back
31
- document.documentElement.setAttribute('data-africode', 'true');
32
-
33
- const observer = new MutationObserver((mutations) => {
34
- mutations.forEach((mutation) => {
35
- if (mutation.type === 'attributes' && mutation.attributeName === 'data-africode') {
36
- if (!document.documentElement.hasAttribute('data-africode')) {
37
- document.documentElement.setAttribute('data-africode', 'true');
38
- console.warn('AfriCode integrity check: Attribute restored.');
39
- }
40
- }
41
- });
42
- });
43
-
44
- observer.observe(document.documentElement, { attributes: true });
45
- }
46
-
47
- // 3. Usage Telemetry (Mock)
48
- // In a real scenario, this would POST to a server
49
- const usage = {
50
- url: typeof window !== 'undefined' ? window.location.href : 'server',
51
- timestamp: Date.now(),
52
- version: FRAMEWORK_VERSION
53
- };
54
-
55
- // Storing locally for now
56
- try {
57
- localStorage.setItem(HEARTBEAT_KEY, JSON.stringify(usage));
58
- } catch (e) {
59
- // Ignore in non-browser envs
60
- }
61
- }
62
-
63
- // Auto-init on import
64
- initHeartbeat();