@brightsideoy/kama 0.1.0-alpha.99 → 1.0.0-alpha.11

package/dist/schema-compiler.js

@@ -0,0 +1,48 @@
+import { fileURLToPath as e, pathToFileURL as t } from "node:url";
+import { existsSync as n, mkdirSync as r, readFileSync as i, writeFileSync as a } from "node:fs";
+import { dirname as o, join as s, resolve as c } from "node:path";
+//#region scripts/schema-compiler.ts
+var l = e(import.meta.url), u = o(l);
+function d(e = process.cwd()) {
+	let t = e;
+	for (; t !== c(t, "..");) {
+		if (n(s(t, "content", "definitions"))) return t;
+		t = c(t, "..");
+	}
+	return process.cwd();
+}
+async function f() {
+	let e = d();
+	process.chdir(e);
+	let o = !1;
+	try {
+		JSON.parse(i(s(e, "package.json"), "utf-8")).name === "@brightsideoy/kama" && (o = !0);
+	} catch {}
+	let c;
+	if (o) {
+		let t = s(e, "server", "db");
+		n(t) || r(t, { recursive: !0 }), c = s(t, "bundled-definitions.js");
+	} else {
+		let t = s(e, "kama-worker");
+		n(t) || r(t, { recursive: !0 }), c = s(t, "bundled-definitions.js");
+	}
+	let l, f = s(u, "../server/schema/engine.ts"), p = s(u, "../dist/index.js");
+	if (n(f)) l = (await import(t(f).href)).compileDefinitions;
+	else if (n(p)) l = (await import(t(p).href)).compileDefinitions;
+	else try {
+		l = (await import("./dist-kIJlDMvm.js")).compileDefinitions;
+	} catch (e) {
+		console.error("\x1B[31m  ✖\x1B[0m \x1B[31mCould not resolve Kama Schema Engine:\x1B[0m", e), process.exit(1);
+	}
+	l || (console.error("\x1B[31m  ✖\x1B[0m \x1B[31mcompileDefinitions function missing from resolved module\x1B[0m"), process.exit(1));
+	let m = l(), h = Object.keys(m?.nodes || {}).length, g = Object.keys(m?.blocks || {}).length, _ = Object.keys(m?.taxonomies || {}).length, v = `// AUTO-GENERATED BUNDLE - DO NOT EDIT
+const defs = ${JSON.stringify(m, null, 2)};
+export const BUNDLED_DEFINITIONS = defs;
+export default defs;
+`;
+	a(c, v, "utf-8"), console.log(`\x1b[32m  ✓\x1b[0m \x1b[2mSchemas bundled (${h} nodes, ${g} blocks, ${_} taxonomies)\x1b[0m`);
+}
+f().catch((e) => {
+	console.error("\x1B[31m  ✖\x1B[0m \x1B[31mSchema Compiler Runtime Error:\x1B[0m", e), process.exit(1);
+});
+//#endregion

package/documentation/SCHEMAS.md

@@ -0,0 +1,182 @@
+# Kama CMS Schema Documentation
+
+Kama CMS uses a highly dynamic, YAML-driven schema system. Instead of hardcoding database tables and React/Vue forms, you define your content models, layouts, and components using simple YAML files. The Kama build pipeline automatically generates the admin UI, database indexes, and API endpoints based on these definitions.
+
+Here is the complete guide to understanding, overriding, and creating custom schemas in your Kama project.
+
+## 1. Directory Structure: What Goes Where?
+
+Your project’s schemas live in the `content/definitions/` (or `schemas/`) directory. The folder structure dictates how the CMS interprets the YAML file:
+
+| Directory         | Purpose                                                           | Example Use Case                                             |
+| :---------------- | :---------------------------------------------------------------- | :----------------------------------------------------------- |
+| `/nodes/`         | Standalone content entities (Pages, Articles, Products, Persons). | A blog post, a product page, or an office location.          |
+| `/blocks/`        | Reusable content components placed on a page canvas.              | A hero banner, a text block, a call-to-action button.        |
+| `/node-layouts/`  | Page-level CSS Grid templates that define regions (drop zones).   | A standard landing page, a 3-column layout with a sidebar.   |
+| `/block-layouts/` | Component-level layout wrappers for grouping blocks.              | A 50/50 split column block.                                  |
+| `/channels/`      | Top-level endpoints (websites, apps, stores).                     | A primary marketing website or a secondary e-commerce store. |
+| `/trees/`         | Hierarchical structures for navigation and routing.               | Main menu, footer links, social links.                       |
+| `/field-sets/`    | Reusable groupings of fields to keep your YAML DRY.               | Standard SEO fields, Access/Visibility settings.             |
+
+## 2. Overriding and Adding Custom Schemas
+
+The Kama schema pipeline merges core package defaults with your local project files.
+
+### How to Override a Core Schema
+
+To modify a default Kama schema (e.g., `page.yaml` or `address.yaml`), create a file with the **exact same name** in your local workspace:
+`your-project/content/definitions/nodes/page.yaml`
+
+During the build process (`npm run bundle:schemas`), the local file completely overwrites the core package file.
+
+### How to Add a Custom Schema
+
+To create a completely new content type (e.g., a Job Posting), simply add a new file:
+`your-project/content/definitions/nodes/job-posting.yaml`
+
+Run `npm run deploy:cms` to deploy the worker. The CMS will automatically register the new schema, create database indexes, and generate the UI.
+
+## 3. Schema Anatomy (Top-Level Parameters)
+
+Every YAML file represents a Schema object. Below are the top-level parameters you can define at the root of your YAML file.
+
+### Base Parameters
+
+- `id` _(string)_: Unique identifier. Should match the filename (e.g., `image_card`).
+- `label` _(string)_: Human-readable name displayed in the CMS Admin UI.
+- `description` _(string)_: Optional subtext shown in block pickers or menus.
+
+### Node/Content Behaviors
+
+- `inTree` _(boolean)_: If `true`, this node can be created in the "Site Tree" (usually for pages/routes).
+- `inVault` _(boolean)_: If `true`, this node appears in the "Vault" (usually for structured data like Products, Addresses, Persons).
+- `hasCanvas` _(boolean)_: If `true`, enables the visual drag-and-drop page builder for this node.
+- `directLinking` _(boolean)_: If `true`, the node is resolvable to a frontend URL/slug (e.g., an Article or Page).
+
+### Layout & Canvas Restrictions
+
+- `defaultLayout` _(string)_: The fallback layout ID if none is selected (e.g., `"single-column"`).
+- `allowedLayouts` _(array)_: List of layout IDs this node is permitted to use.
+- `allowedBlocks` _(array)_: Restricts which blocks can be dropped onto this node's canvas (e.g., `[header, hero, text, image_card]`).
+
+### Grid & Regions (For Layouts)
+
+Used primarily in `/node-layouts/` and `/block-layouts/`.
+
+- `layout`: Defines the CSS Grid structure.
+  - `columns` _(string)_: CSS grid-template-columns (e.g., `"10fr 4fr"`).
+  - `areas` _(array of arrays)_: Maps regions to the grid layout.
+- `regions`: Configuration for the specific drop zones defined in the `areas`.
+  - `label` _(string)_: UI label for the drop zone.
+  - `showLabel` _(boolean)_: Shows/hides the header in the editor.
+  - `inherit` _(string)_: Can inherit content from `"parent"`.
+
+## 4. Tabs & Fields Architecture
+
+Content input in Kama is organized into **Tabs**, which contain **Fields**.
+
+```yaml
+tabs:
+  settings: # Tab ID
+    label: "Settings" # Tab UI Name
+    fields:
+      # Key-Value map of fields
+      title:
+        label: "Title"
+        type: "text"
+        required: true
+```
+
+## 5. Field Types (`type`)
+
+The `type` parameter determines the UI component used in the CMS and how data is handled.
+
+- `text`: Standard single-line text input.
+- `textarea`: Multi-line text input.
+- `richtext`: WYSIWYG editor. (Use `editor: "minimal"`, `"default"`, or `"button"` to configure toolbars).
+- `number`: Numeric input.
+- `boolean`: Toggle switch.
+- `date` / `datetime`: Date/Time picker.
+- `slug`: URL-friendly string generator. Often paired with `linkedTo: "title"`.
+- `select`: Dropdown menu. (Requires an `options` array).
+- `layout-select`: Specialized dropdown that queries available layout schemas.
+- `language-select`: Specialized dropdown for locales.
+- `link`: A unified link picker (internal nodes, trees, URLs, files, emails, tel).
+- `icon`: Icon picker. (Configure with `packages: ["heroicons", "lucide"]`).
+- `asset` / `image`: Cloudflare R2 media uploader.
+- `hidden`: Hidden from the UI, used for programmatic data.
+
+## 6. Field Configuration Parameters
+
+Inside a specific field, you can define how it looks, validates, and behaves in the database.
+
+### UI & Display
+
+- `label` _(string)_: Field label.
+- `description` _(string)_: Helper text below the input.
+- `default` _(any)_: Default value when a new entry is created.
+- `position` _(string)_: Set to `"sidebar"` to move the field out of the main content column.
+- `showAsEditorTitle` _(boolean)_: Uses this field's value as the display title in Vault/Tree lists.
+- `public` _(boolean)_: **CRITICAL.** If `true`, this field is exposed in the public frontend API. If omitted or `false`, the data remains private to the admin backend.
+
+### Database & Indexing
+
+- `dbType` _(string)_: The SQLite data type (e.g., `text`, `integer`, `json`). Most custom fields live inside a JSON blob, but native columns require this.
+- `index` _(boolean)_: Instructs the build pipeline to generate a SQLite index for this field for fast querying.
+- `primaryKey` _(boolean)_: Defines the ID column.
+
+### Validation (`rules`)
+
+- `required` _(boolean)_: Makes the field mandatory. (Can also be set outside of `rules`).
+- `unique` / `uniqueSibling` _(boolean)_: Enforces uniqueness across the DB or tree branch.
+- `pattern` _(string)_: Regex validation (e.g., `"^[a-z0-9_-]+$"`).
+- `customMessage` _(string)_: Error message when validation fails.
+
+### Linking & Inheritance
+
+- `linkedTo` _(string)_: Automatically populates this field based on another (e.g., auto-generating a slug from the title).
+- `inherits` / `inheritsFromParent` _(string/boolean)_: Pulls a fallback value from a parent node if left blank.
+
+## 7. Media & Asset Specifics (`asset` / `image`)
+
+Kama features a powerful R2-backed media engine with automated image cropping.
+
+```yaml
+featuredImage:
+  label: Main Image
+  type: asset
+  multiple: false
+  maxSizeMB: 15
+  maxPreviewWidth: 300px
+  allowedTypes: ["image/jpeg", "image/png", "image/webp"]
+  crops:
+    list_thumb:
+      label: "List View (4:3)"
+      aspectRatio: 1.333
+    catalog_card:
+      label: "Portrait Card (3:4)"
+      aspectRatio: 0.75
+```
+
+- `multiple` _(boolean)_: Enables multi-file upload (Gallery).
+- `allowedTypes` _(array)_: MIME type restrictions.
+- `crops`: A map of required crop aspect ratios. The CMS will prompt the editor to crop the image to these exact ratios upon upload. The frontend API returns optimized URLs for each crop key.
+
+## 8. Field Sets (Inclusions)
+
+To keep your schemas DRY, Kama allows you to group common fields in `/field-sets/` and import them into other schemas.
+
+For example, `content/definitions/field-sets/page-meta.yaml` defines SEO fields.
+
+**How to include a Field Set in a Schema:**
+Use the `fieldSet` keyword inside your fields list.
+
+```yaml
+tabs:
+  settings:
+    fields:
+      title:
+        label: "Title"
+      # Imports the entire page-base YAML here
+      fieldSet: page-base
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightsideoy/kama",
-  "version": "0.1.0-alpha.99",
+  "version": "1.0.0-alpha.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,41 +8,39 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./schema.sql": "./schema.sql",
+    "./package.json": "./package.json"
   },
   "bin": {
     "kama": "bin/cli.js",
     "create-kama": "bin/cli.js"
   },
-  "files": [
-    "dist",
-    "defaults",
-    "definitions",
-    "bin",
-    "scripts",
-    "schema.sql"
-  ],
   "scripts": {
-    "predev": "npm run build:schema && npm run bundle:definitions",
-    "dev": "concurrently \"vite\" \"tsx watch server/dev.ts\"",
-    "bundle:definitions": "node scripts/bundle-definitions.js",
-    "build:schema": "tsx src/db/generate-schema.ts",
-    "build:server": "npm run bundle:definitions && vite build",
+    "predev": "npm run bundle:definitions && npm run build:schema",
+    "dev": "npm run dev:local",
+    "dev:local": "concurrently \"vite\" \"KAMA_RUNTIME=node tsx server/dev.ts\"",
+    "dev:cf": "concurrently \"vite\" \"wrangler dev server/index.ts\"",
+    "bundle:definitions": "node bin/cli.js bundle",
+    "build:schema": "tsx scripts/build-schema.ts",
+    "build:seed": "tsx scripts/build-seed.ts",
+    "seed": "tsx scripts/build-seed.ts && sqlite3 kama.db < seed.sql",
+    "build:server": "vite build",
     "build:ui": "vite build --config vite.config.ui.ts",
-    "build": "npm run build:schema && npm run build:server && npm run build:ui",
+    "build": "npm run bundle:definitions && npm run build:schema && npm run build:server && npm run build:ui",
     "build:cms": "npm run build",
     "prepublishOnly": "npm run build",
-    "db:seed": "npm run build:schema && tsx -e \"import Database from 'better-sqlite3'; import fs from 'node:fs'; const db = new Database('data/cms.db'); db.exec(fs.readFileSync('schema.sql', 'utf8')); console.log('✅ Database schema applied successfully!');\"",
-    "d1:schema:remote": "npm run build:schema && npx wrangler d1 execute YOUR_D1_NAME --remote --file=./schema.sql",
-    "serve": "tsx server/dev.ts"
+    "serve": "wrangler dev server/index.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@brightsideoy/kama": "^0.1.0-alpha.47",
+    "@clack/prompts": "^1.8.1",
     "@heroicons/vue": "^2.2.0",
     "@hono/node-server": "^2.1.1",
+    "@hono/swagger-ui": "^0.6.1",
+    "@hono/zod-openapi": "^1.6.3",
     "@tiptap/core": "^3.30.0",
     "@tiptap/extension-subscript": "^3.30.1",
     "@tiptap/extension-superscript": "^3.30.1",
@@ -53,7 +51,6 @@
     "@tiptap/pm": "^3.30.0",
     "@tiptap/starter-kit": "^3.30.0",
     "@tiptap/vue-3": "^3.30.0",
-    "better-sqlite3": "^13.0.3",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.13.2",
     "locale-codes": "^1.3.1",
@@ -63,22 +60,24 @@
     "vue": "^3.5.41",
     "vue-advanced-cropper": "^2.8.9",
     "vuedraggable": "^4.1.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@iconify-json/heroicons": "^1.2.3",
     "@iconify-json/lucide": "^1.2.123",
-    "@types/better-sqlite3": "^9.6.0",
+    "@libsql/client": "^0.14.0",
     "@types/node": "^26.2.0",
     "@types/sharp": "^0.31.1",
     "@types/yaml": "^1.9.6",
     "@vitejs/plugin-vue": "^6.0.8",
     "concurrently": "^10.0.4",
-    "drizzle-kit": "^0.18.1",
+    "drizzle-kit": "^0.31.11",
     "tsx": "^4.23.12",
     "typescript": "~5.7.2",
     "unplugin-icons": "^23.0.1",
     "vite": "^8.2.1",
-    "vue-tsc": "^2.2.0"
+    "vue-tsc": "^2.2.0",
+    "wrangler": "^4.134.0"
   }
 }

package/schema.sql

@@ -1,5 +1,5 @@
 -- Kama Core System Schema 
--- Auto-generated from server/db/dynamic-sync.ts
+-- Auto-generated from server/db/schema.ts
 
 CREATE TABLE IF NOT EXISTS "content_schemas" (
     id TEXT PRIMARY KEY,
@@ -13,7 +13,7 @@ CREATE TABLE IF NOT EXISTS "content_schemas" (
 
 CREATE TABLE IF NOT EXISTS "users" (
     id TEXT PRIMARY KEY,
-    email TEXT UNIQUE NOT NULL,
+    email UNIQUE NOT NULL,
     name TEXT NOT NULL,
     globalRole TEXT DEFAULT 'editor',
     createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
@@ -46,7 +46,7 @@ CREATE TABLE IF NOT EXISTS "channels" (
     channelType TEXT,
     domain TEXT,
     baseUrl TEXT,
-    defaultLanguage TEXT DEFAULT 'en',
+    defaultLanguage TEXT,
     isHidden INTEGER NOT NULL DEFAULT 0,
     dataJson TEXT,
     createdById TEXT,
@@ -89,9 +89,10 @@ CREATE TABLE IF NOT EXISTS "content_nodes" (
     contentType TEXT NOT NULL,
     title TEXT NOT NULL,
     slug TEXT,
-    language TEXT DEFAULT 'en',
+    language TEXT,
     isHidden INTEGER NOT NULL DEFAULT 0,
     status TEXT DEFAULT 'draft',
+    hasUnpublishedChanges INTEGER DEFAULT 0,
     disabledRegionsJson TEXT DEFAULT '{}',
     dataJson TEXT,
     draftDataJson TEXT,
@@ -115,14 +116,14 @@ CREATE TABLE IF NOT EXISTS "node_channels" (
   );
 
 CREATE TABLE IF NOT EXISTS "tree_nodes" (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
     treeId INTEGER NOT NULL,
     contentId INTEGER NOT NULL,
     parentId INTEGER,
     sortOrder INTEGER DEFAULT 0,
+    PRIMARY KEY (treeId, contentId),
     FOREIGN KEY (treeId) REFERENCES trees(id) ON DELETE CASCADE,
     FOREIGN KEY (contentId) REFERENCES content_nodes(id) ON DELETE CASCADE,
-    FOREIGN KEY (parentId) REFERENCES tree_nodes(id) ON DELETE CASCADE
+    FOREIGN KEY (parentId) REFERENCES content_nodes(id) ON DELETE CASCADE
   );
 
 CREATE TABLE IF NOT EXISTS "content_blocks" (
@@ -176,6 +177,56 @@ CREATE TABLE IF NOT EXISTS "node_assets" (
     FOREIGN KEY (assetId) REFERENCES assets(id) ON DELETE CASCADE
   );
 
+CREATE TABLE IF NOT EXISTS "taxonomy_terms" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    taxonomy TEXT NOT NULL,
+    key TEXT NOT NULL,
+    label TEXT NOT NULL,
+    parentId INTEGER,
+    sortOrder INTEGER DEFAULT 0,
+    dataJson TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (parentId) REFERENCES taxonomy_terms(id) ON DELETE CASCADE,
+    UNIQUE(taxonomy, key)
+  );
+
+CREATE TABLE IF NOT EXISTS "node_terms" (
+    nodeId INTEGER NOT NULL,
+    termId INTEGER NOT NULL,
+    fieldKey TEXT NOT NULL,
+    sortOrder INTEGER DEFAULT 0,
+    PRIMARY KEY (nodeId, termId, fieldKey),
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (termId) REFERENCES taxonomy_terms(id) ON DELETE CASCADE
+  );
+
+CREATE TABLE IF NOT EXISTS "node_relations" (
+    sourceNodeId INTEGER NOT NULL,
+    targetNodeId INTEGER NOT NULL,
+    fieldKey TEXT NOT NULL,
+    sortOrder INTEGER DEFAULT 0,
+    PRIMARY KEY (sourceNodeId, targetNodeId, fieldKey),
+    FOREIGN KEY (sourceNodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (targetNodeId) REFERENCES content_nodes(id) ON DELETE CASCADE
+  );
+
+CREATE TABLE IF NOT EXISTS "node_routes" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    path TEXT NOT NULL,
+    channelId INTEGER NOT NULL,
+    nodeId INTEGER,
+    treeId INTEGER,
+    isCanonical INTEGER DEFAULT 1,
+    redirectUrl TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (channelId) REFERENCES channels(id) ON DELETE CASCADE,
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (treeId) REFERENCES trees(id) ON DELETE CASCADE,
+    UNIQUE(path, channelId)
+  );
+
 CREATE INDEX IF NOT EXISTS idx_tree_nodes_tree_parent ON tree_nodes(treeId, parentId);
 CREATE INDEX IF NOT EXISTS idx_tree_nodes_contentId ON tree_nodes(contentId);
 CREATE INDEX IF NOT EXISTS idx_content_nodes_slug_status ON content_nodes(slug, status);
@@ -198,24 +249,17 @@ CREATE INDEX IF NOT EXISTS idx_node_channels_channel ON node_channels(channelId,
 CREATE INDEX IF NOT EXISTS idx_node_channels_node ON node_channels(nodeId, channelId);
 CREATE INDEX IF NOT EXISTS idx_node_assets_node_asset ON node_assets(nodeId, assetId);
 CREATE INDEX IF NOT EXISTS idx_node_assets_asset_node ON node_assets(assetId, nodeId);
-CREATE INDEX IF NOT EXISTS idx_node_revisions_node ON node_revisions(nodeId, version);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_node_revisions_version ON node_revisions(nodeId, version);
 CREATE INDEX IF NOT EXISTS idx_assets_system_created ON assets(isSystemVariant, createdAt DESC);
 CREATE INDEX IF NOT EXISTS idx_assets_system_mime ON assets(isSystemVariant, mimeType);
 CREATE INDEX IF NOT EXISTS idx_assets_deleted ON assets(deletedAt);
 CREATE INDEX IF NOT EXISTS idx_assets_parent ON assets(parentAssetId);
-
--- System Defaults
-INSERT OR IGNORE INTO channels (id, key, label, channelType, defaultLanguage, isHidden, dataJson) VALUES (1, 'default-channel', 'Default Channel', 'website', 'en', 0, '{}');
-INSERT OR IGNORE INTO trees (id, key, label, treeType, channelId, isHidden, dataJson) VALUES (1, 'default-tree', 'Default Navigation', 'navigation', 1, 0, '{}');
-INSERT OR IGNORE INTO channel_trees (channelId, treeId, key) VALUES (1, 1, 'main');
-
-
--- Native Columns
-CREATE INDEX IF NOT EXISTS idx_content_nodes_slug ON content_nodes (slug);
-CREATE INDEX IF NOT EXISTS idx_content_nodes_contentType ON content_nodes (contentType);
-CREATE INDEX IF NOT EXISTS idx_content_nodes_updatedAt ON content_nodes (updatedAt);
-
--- JSON Custom Fields
-CREATE INDEX IF NOT EXISTS idx_content_nodes_articleDate ON content_nodes (json_extract(dataJson, '$.articleDate'));
-CREATE INDEX IF NOT EXISTS idx_content_nodes_startTime ON content_nodes (json_extract(dataJson, '$.startTime'));
-CREATE INDEX IF NOT EXISTS idx_content_nodes_endTime ON content_nodes (json_extract(dataJson, '$.endTime'));
+CREATE INDEX IF NOT EXISTS idx_taxonomy_terms_tax ON taxonomy_terms(taxonomy);
+CREATE INDEX IF NOT EXISTS idx_node_terms_node ON node_terms(nodeId);
+CREATE INDEX IF NOT EXISTS idx_node_terms_term ON node_terms(termId);
+CREATE INDEX IF NOT EXISTS idx_node_terms_node_term ON node_terms(nodeId, termId);
+CREATE INDEX IF NOT EXISTS idx_node_terms_term_node ON node_terms(termId, nodeId);
+CREATE INDEX IF NOT EXISTS idx_node_relations_source ON node_relations(sourceNodeId);
+CREATE INDEX IF NOT EXISTS idx_node_relations_target ON node_relations(targetNodeId);
+CREATE INDEX IF NOT EXISTS idx_node_routes_lookup ON node_routes(path, channelId);
+CREATE INDEX IF NOT EXISTS idx_node_routes_node ON node_routes(nodeId);

package/templates/astro-starter/astro.config.mjs

@@ -0,0 +1,27 @@
+import { defineConfig } from 'astro/config';
+import node from '@astrojs/node';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default defineConfig({
+    devToolbar: {
+        enabled: false
+    },
+    output: 'server',
+    trailingSlash: 'ignore',
+    image: { service: { entrypoint: './src/lib/media/kama-image-service.ts' } },
+    adapter: node({ mode: "standalone" }),
+    vite: {
+        resolve: { alias: { '@': path.resolve(__dirname, './src') } },
+        ssr: {
+            external: ['cloudflare:workers', 'tinyexec', 'node:child_process', 'node:fs', 'node:url', 'node:path', 'node:stream', 'node:readline', 'node:stream/promises']
+        },
+        environments: {
+            ssr: {
+                external: ['cloudflare:workers', 'tinyexec', 'node:child_process', 'node:fs', 'node:url', 'node:path', 'node:stream', 'node:readline', 'node:stream/promises']
+            }
+        }
+    }
+});

package/templates/astro-starter/package.json.template

@@ -0,0 +1,20 @@
+{
+  "name": "{{SITE_NAME}}",
+  "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": "{{KAMA_VERSION}}",
+    "astro": "^7.2.0",
+    "wrangler": "^4.0.0"
+  }
+}

package/templates/astro-starter/public/robots.txt

@@ -0,0 +1,23 @@
+# Allow standard search engine crawlers
+User-agent: *
+Allow: /
+
+# Block sensitive or irrelevant paths
+Disallow: /api/
+Disallow: /*?*search=
+
+# Explicitly block AI scrapers / Training Bots (Optional)
+# User-agent: GPTBot
+# Disallow: /
+
+# User-agent: CCBot
+# Disallow: /
+
+# User-agent: Anthropic-ai
+# Disallow: /
+
+# User-agent: Google-Extended
+# Disallow: /
+
+# XML Sitemap location
+# Sitemap: https://yourdomain.com/sitemap-index.xml