@brightsideoy/kama 1.0.0-alpha.2 → 1.0.0-alpha.20

package/templates/astro-starter/src/pages/api/partials/node-cards.astro

@@ -0,0 +1,101 @@
+---
+// src/pages/api/partials/node-cards.astro
+export const partial = true; // Tells Astro not to inject DOCTYPE or <head> tags
+
+import KamaImage from "@/components/ui/KamaImage.astro";
+
+const { request, locals } = Astro;
+const url = new URL(request.url);
+const searchParams = url.searchParams;
+
+// 1. Get Environment Variables securely via middleware
+const cfEnv = (locals as any).safeEnv || {};
+const cmsWorker = cfEnv.CMS_WORKER;
+const apiUrl =
+  cfEnv.PUBLIC_API_URL ||
+  import.meta.env.PUBLIC_API_URL ||
+  "http://localhost:8787";
+const secret = cfEnv.FRONTEND_API_SECRET || import.meta.env.FRONTEND_API_SECRET;
+
+// 2. Construct the actual backend URL
+const cleanApiUrl = apiUrl.replace(/\/$/, "");
+const backendUrl = `${cleanApiUrl}/api/v1/nodes?${searchParams.toString()}`;
+
+// 3. Prepare the secure headers
+const reqHeaders: Record<string, string> = { Accept: "application/json" };
+if (secret) reqHeaders["Authorization"] = `Bearer ${secret}`;
+
+const backendReq = new Request(backendUrl, {
+  method: "GET",
+  headers: reqHeaders,
+});
+
+// 4. Fetch securely using Service Binding
+let response;
+if (cmsWorker && typeof cmsWorker.fetch === "function") {
+  response = await cmsWorker.fetch(backendReq);
+} else {
+  response = await fetch(backendReq);
+}
+
+let itemsArray: any[] = [];
+let limit = 12;
+let consumedRows = 0;
+
+if (response.ok) {
+  const data = await response.json();
+  itemsArray = Array.isArray(data)
+    ? data
+    : data.items || data.nodes || data.data || [];
+  limit = data.limit || 12;
+  consumedRows =
+    data.rawCount !== undefined ? data.rawCount : itemsArray.length;
+}
+
+// 5. Send pagination data back to the frontend script via custom HTTP Headers
+Astro.response.headers.set("X-Consumed-Rows", consumedRows.toString());
+Astro.response.headers.set("X-Limit", limit.toString());
+Astro.response.headers.set(
+  "Cache-Control",
+  "public, max-age=0, s-maxage=60, stale-while-revalidate=120",
+);
+---
+
+{
+  itemsArray.map((item: any) => {
+    const dateStr = item.createdAt
+      ? new Date(item.createdAt).toLocaleDateString("en-GB", {
+          day: "numeric",
+          month: "short",
+          year: "numeric",
+        })
+      : "";
+
+    return (
+      <article class="node-card">
+        <a href={`/${item.slug}`} class="node-card-link">
+          {item.image ? (
+            <KamaImage
+              image={item.image}
+              sizes="(max-width: 639px) 100vw, (max-width: 1023px) 50vw, 33vw"
+              desktopWidths={[320, 640, 768, 1024]}
+              idealWidth={429}
+              loading="lazy"
+            />
+          ) : (
+            <div class="image-placeholder" />
+          )}
+          <div class="node-card-content">
+            <h3 class="node-card-title">{item.title}</h3>
+            {dateStr && (
+              <time datetime={item.createdAt} class="node-card-date">
+                {dateStr}
+              </time>
+            )}
+            {item.excerpt && <p class="node-card-excerpt">{item.excerpt}</p>}
+          </div>
+        </a>
+      </article>
+    );
+  })
+}

package/templates/kama-worker/index.js

@@ -1,19 +1,42 @@
+// templates/kama-worker/index.js
+import { Hono } from 'hono';
 import kamaWorker from '@brightsideoy/kama';
 import * as localBundle from './bundled-definitions.js';
+import { activeExtensions } from './extension-registry.js';
 
-export default {
-  async fetch(request, env, ctx) {
-    const schemas = localBundle.BUNDLED_DEFINITIONS || localBundle.default || localBundle;
-    const customEnv = { ...env, BUNDLED_DEFINITIONS: schemas, KAMA_RUNTIME: 'cloudflare' };
-
-    if (kamaWorker && typeof kamaWorker.fetch === 'function') {
-      return kamaWorker.fetch(request, customEnv, ctx);
-    }
-    
-    if (kamaWorker && kamaWorker.app && typeof kamaWorker.app.fetch === 'function') {
-      return kamaWorker.app.fetch(request, customEnv, ctx);
-    }
-    
-    return new Response('Kama Engine Worker Ready', { status: 200 });
+const app = new Hono();
+
+// 1. 🎯 Mount Extension Routes Natively
+for (const ext of activeExtensions) {
+  if (ext.routes?.public) {
+    app.route(`/api/v1/ext/${ext.id}`, ext.routes.public);
+  }
+  if (ext.routes?.admin) {
+    app.route(`/api/admin/ext/${ext.id}`, ext.routes.admin);
+  }
+}
+
+// 2. 🎯 Mount Precompiled Core CMS (Fallback catch-all)
+app.all('*', async (c) => {
+  const schemas = localBundle.BUNDLED_DEFINITIONS || localBundle.default || localBundle;
+
+  // Inject the extensions array so the UI and core can read it (e.g. for dynamic menus)
+  const customEnv = {
+    ...c.env,
+    BUNDLED_DEFINITIONS: schemas,
+    KAMA_EXTENSIONS: activeExtensions,
+    KAMA_RUNTIME: 'cloudflare'
+  };
+
+  if (kamaWorker && typeof kamaWorker.fetch === 'function') {
+    return kamaWorker.fetch(c.req.raw, customEnv, c.executionCtx);
+  }
+
+  if (kamaWorker && kamaWorker.app && typeof kamaWorker.app.fetch === 'function') {
+    return kamaWorker.app.fetch(c.req.raw, customEnv, c.executionCtx);
   }
-};
+
+  return new Response('KAMA • ENGINE Ready', { status: 200 });
+});
+
+export default app;

package/templates/kama-worker/server.js

@@ -3,6 +3,7 @@ import { serveStatic } from '@hono/node-server/serve-static';
 import { Hono } from 'hono';
 import kamaApp from '@brightsideoy/kama';
 import * as localBundle from './bundled-definitions.js';
+import { activeExtensions } from './extension-registry.js'; // 🎯 1. Import the auto-generated registry
 import dotenv from 'dotenv';
 import { readFileSync, existsSync, statSync } from 'node:fs';
 import { join } from 'node:path';
@@ -18,7 +19,7 @@ const possiblePaths = [
 const distPath = possiblePaths.find(p => existsSync(p));
 
 if (!distPath) {
-    console.warn('⚠️ Could not locate @brightsideoy/kama/dist folder. Admin UI will not load.');
+    console.warn('\x1b[33m  ⚠\x1b[0m \x1b[2mCould not locate @brightsideoy/kama/dist folder. Admin UI will not load.\x1b[0m');
 }
 
 const app = new Hono();
@@ -32,7 +33,9 @@ async function getCustomEnv(c) {
         if (existsSync(bundlePath)) {
             const mtime = statSync(bundlePath).mtimeMs;
             if (mtime > lastModified) {
-                if (lastModified !== 0) console.log('🔄 Hot-reloading fresh schema definitions!');
+                if (lastModified !== 0) {
+                    console.log('\x1b[36m  ⟳\x1b[0m \x1b[2mHot-reloading schema definitions\x1b[0m');
+                }
                 const mod = await import(`${pathToFileURL(bundlePath).href}?t=${mtime}`);
                 cachedSchemas = mod.BUNDLED_DEFINITIONS || mod.default || mod;
                 lastModified = mtime;
@@ -44,6 +47,7 @@ async function getCustomEnv(c) {
         ...process.env,
         ...(c.env || {}),
         BUNDLED_DEFINITIONS: cachedSchemas,
+        KAMA_EXTENSIONS: activeExtensions, // 🎯 2. Pass extensions dynamically into the Core
         KAMA_RUNTIME: (c.env && c.env.DB) ? 'cloudflare' : 'node'
     };
 }
@@ -91,8 +95,12 @@ export default app;
 if (typeof process !== 'undefined' && process.argv && process.argv[1] && process.argv[1].endsWith('server.js')) {
     const port = process.env.PORT ? parseInt(process.env.PORT, 10) : 8787;
     serve({ fetch: app.fetch, port }, (info) => {
-        console.log(`\n🔥 KAMA CMS Node Server is running!`);
-        console.log(`┃ Local    http://localhost:${info.port}/`);
-        if (distPath) console.log(`┃ Admin UI Serving from: ${distPath}\n`);
+        console.log(`\n  \x1b[36m\x1b[1mKAMA • ENGINE\x1b[0m`);
+        console.log(`  \x1b[2m│\x1b[0m`);
+        console.log(`  \x1b[2m│\x1b[0m Local      \x1b[32mhttp://localhost:${info.port}/\x1b[0m`);
+        if (distPath) {
+            console.log(`  \x1b[2m│\x1b[0m Admin UI   \x1b[2mServing from local dist\x1b[0m`);
+        }
+        console.log(`  \x1b[2m│\x1b[0m\n`);
     });
 }

package/templates/kama-worker/setup-local-db.mjs

@@ -0,0 +1,17 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createClient } from '@libsql/client';
+
+const mode = process.argv[2] || 'schema';
+const databasePath = process.env.DB_PATH || './kama.db';
+const client = createClient({ url: `file:${databasePath}` });
+
+try {
+    const files = mode === 'seed'
+        ? (await readdir('.')).filter(file => /^seed.*\.sql$/.test(file)).sort()
+        : ['../node_modules/@brightsideoy/kama/schema.sql'];
+    if (files.length === 0) throw new Error('No generated seed SQL files found.');
+    for (const file of files) await client.executeMultiple(await readFile(join(process.cwd(), file), 'utf8'));
+} finally {
+    await client.close();
+}