@brightsideoy/kama 0.1.0-alpha.1 → 0.1.0-alpha.100

package/bin/cli.js

@@ -0,0 +1,343 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import * as readline from 'node:readline/promises';
+
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+});
+
+async function main() {
+    console.log('\n🔥 --- KAMA SITE GENERATOR --- 🔥\n');
+
+    console.log('Select mode:');
+    console.log('  1) Kickstart new Kama Monorepo (CMS + Initial Site)');
+    console.log('  2) Add a new Astro Site to current workspace (sites/)');
+
+    const choice = await rl.question('\nChoice [1/2]: ');
+
+    if (choice.trim() === '2') {
+        await createNewSiteOnly();
+    } else {
+        await createFullWorkspace();
+    }
+
+    rl.close();
+}
+
+/**
+ * MODE 1: Kickstart full Monorepo Workspace
+ */
+async function createFullWorkspace() {
+    const projName = (await rl.question('Project folder name [kama-workspace]: ')) || 'kama-workspace';
+    const cmsDomain = (await rl.question('CMS Admin Domain (e.g., admin.t3cloud.eu): ')) || 'admin.t3cloud.eu';
+    const siteDomain = (await rl.question('First Website Domain (e.g., kama.t3cloud.eu): ')) || 'kama.t3cloud.eu';
+
+    const rootDir = join(process.cwd(), projName);
+
+    // 🎯 Derive dynamic worker, database, and bucket names from project folder name
+    const workerName = `${projName}-worker`.toLowerCase().replace(/[^a-z0-9_-]/g, '-');
+    let dbName = `${projName}-db`.replace(/[^a-zA-Z0-9_-]/g, '_');
+    const bucketName = `${projName}-media-prod`.toLowerCase().replace(/[^a-z0-9_-]/g, '-');
+
+    console.log(`\n📁 Creating workspace folder at ./${projName}...`);
+    mkdirSync(rootDir, { recursive: true });
+
+    // 🎯 Scaffold schemas directory for project-level custom YAML definitions
+    mkdirSync(join(rootDir, 'schemas', 'nodes'), { recursive: true });
+    mkdirSync(join(rootDir, 'schemas', 'blocks'), { recursive: true });
+
+    // --- AUTO D1 CREATION MAGIC ---
+    let d1DatabaseId = 'REPLACE_WITH_YOUR_D1_ID';
+    let isAuthenticated = false;
+
+    console.log(`\n🔑 Checking Cloudflare authentication...`);
+    try {
+        execSync('npx wrangler whoami', { stdio: 'pipe' });
+        isAuthenticated = true;
+        console.log(`✅ Logged in to Cloudflare.`);
+    } catch (error) {
+        console.log(`⚠️ You are not logged in to Cloudflare.`);
+        console.log(`🌐 Launching browser for Cloudflare login...`);
+        try {
+            execSync('npx wrangler login', { stdio: 'inherit' });
+            isAuthenticated = true;
+            console.log(`✅ Successfully logged in!`);
+        } catch (loginError) {
+            console.log(`❌ Login failed or was cancelled.`);
+        }
+    }
+
+    if (isAuthenticated) {
+        try {
+            console.log(`\n🗄️ Checking existing Cloudflare D1 databases...`);
+            const listOutput = execSync(`npx wrangler d1 list --json`, { encoding: 'utf-8', stdio: 'pipe' });
+
+            const jsonStart = listOutput.indexOf('[');
+            const jsonEnd = listOutput.lastIndexOf(']') + 1;
+            let databases = [];
+
+            if (jsonStart !== -1 && jsonEnd !== -1) {
+                databases = JSON.parse(listOutput.substring(jsonStart, jsonEnd));
+            }
+
+            const existingDb = databases.find(db => db.name === dbName);
+
+            if (existingDb) {
+                console.log(`⚠️ Database '${dbName}' already exists on your account.`);
+                const useExisting = await rl.question(`Do you want to link this existing database? (y/n) [y]: `);
+
+                if (useExisting.toLowerCase() !== 'n') {
+                    d1DatabaseId = existingDb.uuid;
+                    console.log(`✅ Linked existing database ID: ${d1DatabaseId}`);
+                } else {
+                    dbName = (await rl.question(`Enter a new database name: `)).trim();
+                    console.log(`\n🗄️ Creating new database '${dbName}'...`);
+                    const d1Output = execSync(`npx wrangler d1 create ${dbName}`, { encoding: 'utf-8', stdio: 'pipe' });
+                    const match = d1Output.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);
+                    if (match) {
+                        d1DatabaseId = match[0];
+                        console.log(`✅ Success! Database ID bound: ${d1DatabaseId}`);
+                    }
+                }
+            } else {
+                console.log(`\n🗄️ Attempting to auto-create Cloudflare D1 Database '${dbName}'...`);
+                const d1Output = execSync(`npx wrangler d1 create ${dbName}`, { encoding: 'utf-8', stdio: 'pipe' });
+                const match = d1Output.match(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/);
+                if (match) {
+                    d1DatabaseId = match[0];
+                    console.log(`✅ Success! Database ID bound: ${d1DatabaseId}`);
+                }
+            }
+        } catch (error) {
+            console.log(`⚠️ Database operation failed. We'll leave a placeholder.`);
+        }
+    } else {
+        console.log(`⚠️ Skipping database creation. We'll leave a placeholder in wrangler.json.`);
+    }
+    // ------------------------------
+
+    // 🎯 1. Root package.json
+    writeFileSync(
+        join(rootDir, 'package.json'),
+        JSON.stringify({
+            name: projName,
+            private: true,
+            type: 'module',
+            workspaces: ['cms-worker', 'sites/*'],
+            scripts: {
+                'bundle:schemas': 'node node_modules/@brightsideoy/kama/scripts/bundle-definitions.js',
+                'dev:cms': 'npm run bundle:schemas && npm run dev -w cms-worker',
+                'deploy:cms': 'npm run bundle:schemas && npm run deploy -w cms-worker',
+            },
+            dependencies: {
+                '@brightsideoy/kama': 'alpha',
+            }
+        }, null, 2)
+    );
+
+    // 🎯 2. Setup CMS Worker with Dynamic Names
+    console.log(`\n☁️ Configuring CMS Worker '${workerName}' (${cmsDomain})...`);
+    const cmsDir = join(rootDir, 'cms-worker');
+    mkdirSync(cmsDir, { recursive: true });
+
+    writeFileSync(
+        join(cmsDir, 'index.js'),
+        `export { default } from '@brightsideoy/kama';\n`
+    );
+
+    writeFileSync(
+        join(cmsDir, 'package.json'),
+        JSON.stringify({
+            name: workerName,
+            type: 'module',
+            version: '1.0.0',
+            scripts: {
+                "bundle:schemas": "node ../node_modules/@brightsideoy/kama/scripts/bundle-definitions.js",
+                "schema:local": `npm run bundle:schemas && wrangler d1 execute ${dbName} --local --file=../node_modules/@brightsideoy/kama/schema.sql`,
+                "schema:remote": `npm run bundle:schemas && wrangler d1 execute ${dbName} --remote --file=../node_modules/@brightsideoy/kama/schema.sql`,
+                "dev": "npm run schema:local && wrangler dev",
+                "deploy": "npm run schema:remote && wrangler deploy"
+            },
+            dependencies: {
+                '@brightsideoy/kama': 'alpha',
+            },
+            devDependencies: {
+                wrangler: '^4.127.1',
+                tsx: '^4.19.2',
+            },
+        }, null, 2)
+    );
+
+    // 🎯 Fixed CMS wrangler.json (Added PUBLIC_FRONTEND_URL & CLOUDFLARE_ZONE_ID to public vars)
+    writeFileSync(
+        join(cmsDir, 'wrangler.json'),
+        JSON.stringify({
+            $schema: '../node_modules/wrangler/config-schema.json',
+            name: workerName,
+            main: 'index.js',
+            compatibility_date: '2026-08-01',
+            compatibility_flags: ['nodejs_compat'],
+            assets: {
+                directory: '../node_modules/@brightsideoy/kama/dist',
+                binding: 'ASSETS'
+            },
+            images: {
+                binding: 'IMAGES'
+            },
+            routes: [{ pattern: cmsDomain, custom_domain: true }],
+            vars: {
+                CDN_DOMAIN: cmsDomain,
+                PUBLIC_FRONTEND_URL: `https://${siteDomain}`,
+                CLOUDFLARE_ZONE_ID: "REPLACE_WITH_YOUR_32_CHAR_ZONE_ID"
+            },
+            d1_databases: [{
+                binding: 'DB',
+                database_name: dbName,
+                database_id: d1DatabaseId,
+            }],
+            r2_buckets: [{
+                binding: 'MEDIA_BUCKET',
+                bucket_name: bucketName,
+            }],
+        }, null, 2)
+    );
+
+    // 🎯 Fixed .dev.vars (Only contains API token for local dev, not public Zone ID)
+    writeFileSync(
+        join(cmsDir, '.dev.vars'),
+        `# Cloudflare Edge Cache Purging Secrets\nCLOUDFLARE_API_TOKEN=cfut_YOUR_CUSTOM_PURGE_TOKEN\n`
+    );
+
+    // 🎯 3. Setup First Astro Site tied to target workerName
+    const siteFolderName = siteDomain.split('.')[0];
+    await generateAstroSite(rootDir, siteFolderName, siteDomain, cmsDomain, workerName);
+
+    console.log(`\n✨ Workspace ready! Next steps:`);
+    console.log(`  1. cd ${projName}`);
+    console.log(`  2. npm install`);
+    if (d1DatabaseId === 'REPLACE_WITH_YOUR_D1_ID') {
+        console.log(`  3. Run 'npx wrangler login' and create a D1 database.`);
+    }
+    console.log(`  4. Update CLOUDFLARE_ZONE_ID in cms-worker/wrangler.json with your actual Zone ID`);
+    console.log(`  5. Securely store your purge token: cd cms-worker && npx wrangler secret put CLOUDFLARE_API_TOKEN`);
+    console.log(`  6. Run 'npm run dev:cms' from the workspace root to start the backend.`);
+}
+
+/**
+ * MODE 2: Add Site to existing workspace
+ */
+async function createNewSiteOnly() {
+    const rootDir = process.cwd();
+
+    if (!existsSync(join(rootDir, 'package.json'))) {
+        console.error('❌ Error: Must run this command inside the root of your workspace.');
+        return;
+    }
+
+    let targetWorkerName = 'kama-worker';
+    const cmsWranglerPath = join(rootDir, 'cms-worker', 'wrangler.json');
+    if (existsSync(cmsWranglerPath)) {
+        try {
+            const cmsWrangler = JSON.parse(readFileSync(cmsWranglerPath, 'utf-8'));
+            if (cmsWrangler.name) targetWorkerName = cmsWrangler.name;
+        } catch (e) { }
+    }
+
+    const siteFolder = await rl.question('Site folder name (e.g., my-new-site): ');
+    const siteDomain = await rl.question('Website Domain (e.g., brand.com): ');
+    const cmsDomain = (await rl.question('CMS API Domain (e.g., admin.t3cloud.eu): ')) || 'admin.t3cloud.eu';
+
+    await generateAstroSite(rootDir, siteFolder, siteDomain, cmsDomain.replace(/^https?:\/\//, ''), targetWorkerName);
+
+    console.log(`\n✨ Site created in sites/${siteFolder}! Run 'npm install' at workspace root.`);
+}
+
+/**
+ * Helper: Scaffolds the Astro site with middleware, wrangler.json, & slug page
+ */
+async function generateAstroSite(rootDir, siteFolder, siteDomain, cmsDomain, workerName = 'kama-worker') {
+    console.log(`\n🚀 Scaffolding Astro site (${siteFolder}) mapped to ${siteDomain} (Service: ${workerName})...`);
+
+    const siteDir = join(rootDir, 'sites', siteFolder);
+    mkdirSync(join(siteDir, 'src/pages'), { recursive: true });
+    mkdirSync(join(siteDir, 'src/layouts'), { recursive: true });
+    mkdirSync(join(siteDir, 'src/components/blocks'), { recursive: true });
+    mkdirSync(join(siteDir, 'src/lib'), { recursive: true });
+
+    writeFileSync(
+        join(siteDir, 'package.json'),
+        JSON.stringify({
+            name: siteFolder,
+            type: 'module',
+            version: '0.0.1',
+            engines: { node: '>=22.12.0' },
+            scripts: {
+                dev: 'astro dev',
+                build: 'astro build',
+                preview: 'astro preview',
+                deploy: 'astro build && wrangler deploy',
+            },
+            dependencies: {
+                '@astrojs/cloudflare': '^14.2.5',
+                '@brightsideoy/kama': 'alpha',
+                astro: '^7.2.2',
+                wrangler: '^4.127.1',
+            },
+        }, null, 2)
+    );
+
+    // 🎯 Fixed Astro wrangler.json: Added `run_worker_first: true` to prevent media routing 404s on Edge
+    writeFileSync(
+        join(siteDir, 'wrangler.json'),
+        JSON.stringify({
+            $schema: 'node_modules/wrangler/config-schema.json',
+            name: siteFolder,
+            compatibility_date: '2026-08-01',
+            compatibility_flags: ['nodejs_compat'],
+            assets: {
+                directory: './dist/client',
+                binding: 'ASSETS',
+                html_handling: 'drop-trailing-slash',
+                not_found_handling: '404-page',
+                run_worker_first: true
+            },
+            services: [{ binding: 'CMS_WORKER', service: workerName }],
+            routes: [{ pattern: siteDomain, custom_domain: true }],
+            vars: {
+                PUBLIC_CMS_URL: `https://${cmsDomain}`,
+                PUBLIC_API_URL: `https://${cmsDomain}`,
+            },
+        }, null, 2)
+    );
+
+    const astroConfig = `import { defineConfig } from 'astro/config';
+import cloudflare from '@astrojs/cloudflare';
+
+export default defineConfig({
+  output: 'server',
+  trailingSlash: 'ignore',
+  image: {
+    remotePatterns: [
+      { protocol: 'http', hostname: 'localhost', port: '3000' },
+      { protocol: 'https', hostname: '${cmsDomain}' }
+    ]
+  },
+  build: {
+    inlineStylesheets: 'always',
+  },
+  adapter: cloudflare({
+    imageService: 'cloudflare',
+  })
+});`;
+    writeFileSync(join(siteDir, 'astro.config.mjs'), astroConfig);
+
+    writeFileSync(
+        join(siteDir, '.env'),
+        `PUBLIC_CMS_URL="https://${cmsDomain}"\nPUBLIC_API_URL="https://${cmsDomain}"\n`
+    );
+}
+
+main().catch(console.error);

package/defaults/definitions/block-layouts/three-column.yaml

@@ -0,0 +1,20 @@
+id: three-column
+label: Three Columns (33/33/33)
+showLabel: false
+group: Sub-Layouts
+
+layout:
+  columns: "1fr 1fr 1fr"
+  areas:
+    - ["left", "middle", "right"]
+
+regions:
+  left:
+    label: Left Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  middle:
+    label: Middle Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  right:
+    label: Right Column
+    showLabel: false # 👈 Keeps "RIGHT COLUMN" visible

package/defaults/definitions/block-layouts/two-column.yaml

@@ -0,0 +1,29 @@
+id: two-column
+label: Two Columns (50/50)
+showLabel: false # 👈 Hides the main "Two Columns" badge on the canvas
+group: Sub-Layouts
+
+layout:
+  columns: "1fr 1fr"
+  areas:
+    - ["left", "right"]
+
+regions:
+  left:
+    label: Left Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  right:
+    label: Right Column
+    showLabel: false # 👈 Keeps "RIGHT COLUMN" visible
+
+# Optional: We can give the layout block its own settings!
+fields:
+  gap:
+    label: Column Gap
+    type: select
+    default: "2rem"
+    options:
+      - { label: "None", value: "0" }
+      - { label: "Small", value: "1rem" }
+      - { label: "Medium", value: "2rem" }
+      - { label: "Large", value: "4rem" }

package/defaults/definitions/blocks/button.yaml

@@ -0,0 +1,15 @@
+id: button
+label: Button
+group: Content
+description: Button text
+
+fields:
+  - text:
+      label: Text
+      type: richtext
+      editor: button
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/header.yaml

@@ -0,0 +1,15 @@
+id: header
+label: Header
+group: Content
+
+fields:
+  - headline:
+      type: richtext
+      editor: header
+      label: Headline
+      public: true
+      default: "Header here..."
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/header_image.yaml

@@ -0,0 +1,22 @@
+id: header_image
+label: Header Image
+group: Media
+description: Image for page header.
+
+fields:
+  - image:
+      label: Image
+      type: asset
+      required: true
+      multiple: false
+      maxSizeMB: 15
+      allowedTypes: ["image/*"]
+      crops:
+        standard:
+          label: "Page header (21:9)"
+          aspectRatio: 2.333
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/hero.yaml

@@ -0,0 +1,27 @@
+id: hero
+label: Hero
+group: Content
+
+fields:
+  - heroBadge:
+      type: text
+      label: Badge
+      public: true
+  - heroTitle:
+      type: text
+      label: Title
+      public: true
+  - heroSubTitle:
+      type: text
+      label: Sub-Title
+      public: true
+  - headline:
+      type: richtext
+      editor: header
+      label: Headline
+      public: true
+      default: "Header here..."
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/image_card.yaml

@@ -0,0 +1,57 @@
+id: image_card
+label: Image Card
+Group: Content
+description: A versatile card with an image, text, and a CTA button.
+
+fields:
+  - image:
+      label: Card Image
+      showLabel: false
+      type: asset
+      required: true
+      multiple: false
+      maxSizeMB: 15
+      maxPreviewWidth: 300px
+      allowedTypes: ["image/*"]
+      crops:
+        standard:
+          label: "Card Header (16:9)"
+          aspectRatio: 3.0
+      public: true
+
+  - headline:
+      label: Headline
+      type: text
+      required: true
+      public: true
+      default: "Headline..."
+
+  - summary:
+      label: Text
+      description: Keep it brief, 2-3 sentences max.
+      type: richtext
+      editor: minimal
+      public: true
+      default: "Card text content..."
+
+  - link:
+      label: Link
+      type: link
+      allowedLinkTypes:
+        - tree
+        - node
+        - url
+        - file
+        - email
+        - telephone
+
+  - linkText:
+      label: Button Text
+      type: text
+      description: "e.g., 'Read More' or 'Buy Now'"
+      default: "Read More"
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/single_image.yaml

@@ -0,0 +1,28 @@
+id: single_image
+label: Single Image
+group: Media
+description: Just a single image block.
+
+fields:
+  - image:
+      label: Image
+      type: asset
+      required: true
+      multiple: false
+      maxSizeMB: 15
+      allowedTypes: ["image/*"]
+      public: true
+
+  - link:
+      label: Link
+      type: link
+      position: sidebar
+      allowedLinkTypes:
+        - tree
+        - node
+        - url
+        - file
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/text.yaml

@@ -0,0 +1,16 @@
+id: text
+label: Text
+group: Content
+description: Paragraph body
+
+fields:
+  - body:
+      label: Text
+      type: richtext
+      editor: default
+      default: "Write content here..."
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/channels/ecommerce.yaml

@@ -0,0 +1,24 @@
+id: ecommerce
+label: "E-Commerce"
+
+tabs:
+  settings:
+    label: "Channel"
+    fields:
+      - fieldSet: channel-base
+
+      - currency:
+          label: Default Currency
+          type: select
+          default: "EUR"
+          options:
+            - "EUR"
+            - "USD"
+            - "GBP"
+
+      - checkoutUrl:
+          label: Checkout Endpoint URL
+          type: text
+          public: true
+
+      - fieldSet: access

package/defaults/definitions/channels/website.yaml

@@ -0,0 +1,32 @@
+id: website
+label: "Website"
+
+tabs:
+  settings:
+    label: "Channel"
+    fields:
+      - fieldSet: channel-base
+
+      - domain:
+          label: Hostname
+          type: text
+          dbType: text
+          index: true
+          public: true
+
+      - baseUrl:
+          label: Base URL
+          type: text
+          dbType: text
+          public: true
+
+      - defaultLanguage:
+          label: Channel Language / Locale
+          type: language-select
+          dbType: text
+          public: true
+
+  access:
+    label: "Access"
+    fields:
+      - fieldSet: access

package/defaults/definitions/field-sets/access.yaml

@@ -0,0 +1,29 @@
+tab:
+  id: access
+  label: "Access"
+
+fields:
+  isHidden: # 🎯 Renamed from 'hidden' to match the DB column
+    type: boolean
+    label: Hidden
+    default: false
+    public: false
+    variant: danger
+    dbType: integer
+    index: true
+    position: sidebar
+    liveSync: true
+
+  startShowingAt:
+    type: datetime
+    label: Start Showing At
+    position: sidebar
+    public: false
+    index: true
+
+  stopShowingAt:
+    type: datetime
+    label: Stop Showing At
+    position: sidebar
+    public: false
+    index: true