@brightsideoy/kama 0.1.0-alpha.16 → 0.1.0-alpha.161

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-BNkCx-o-.js")).compileDefinitions;
+	} catch (e) {
+		console.error("❌ Could not resolve Kama Schema Engine:", e), process.exit(1);
+	}
+	l || (console.error("❌ compileDefinitions function missing from resolved module"), process.exit(1));
+	let m = l(), h = Object.keys(m?.nodes || {}).length, g = Object.keys(m?.blocks || {}).length, _ = `// AUTO-GENERATED BUNDLE - DO NOT EDIT
+const defs = ${JSON.stringify(m, null, 2)};
+export const BUNDLED_DEFINITIONS = defs;
+export default defs;
+`;
+	a(c, _, "utf-8"), console.log(`✅ Schema securely compiled using engine.ts to ${c} (${h} nodes, ${g} blocks)`);
+}
+f().catch((e) => {
+	console.error("❌ Schema Compiler Runtime Error:", 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.16",
+  "version": "0.1.0-alpha.161",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,21 +11,23 @@
     }
   },
   "bin": {
-    "kama": "./bin/cli.js",
-    "create-kama": "./bin/cli.js"
+    "kama": "bin/cli.js",
+    "create-kama": "bin/cli.js"
   },
-  "files": [
-    "dist",
-    "bin"
-  ],
   "scripts": {
-    "dev": "concurrently \"vite\" \"tsx watch server/index.ts\"",
-    "build": "vite build",
-    "build:cms": "vite build",
-    "build:seed-sql": "tsx src/db/generate-sql.ts",
-    "db:seed": "npm run build:seed-sql && tsx -e \"import Database from 'better-sqlite3'; import fs from 'node:fs'; const db = new Database('data/cms.db'); db.exec(fs.readFileSync('seed.sql', 'utf8')); console.log('✅ Database seeded successfully!');\"",
-    "d1:seed:remote": "npm run build:seed-sql && npx wrangler d1 execute YOUR_D1_NAME --remote --file=./seed.sql",
-    "serve": "tsx server/index.ts"
+    "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",
+    "build:server": "vite build",
+    "build:ui": "vite build --config vite.config.ui.ts",
+    "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",
+    "serve": "wrangler dev server/index.ts"
   },
   "publishConfig": {
     "access": "public"
@@ -43,7 +45,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",
@@ -58,7 +59,7 @@
   "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",
@@ -69,6 +70,7 @@
     "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

@@ -0,0 +1,206 @@
+-- Kama Core System Schema 
+-- Auto-generated from server/db/schema.ts
+
+CREATE TABLE IF NOT EXISTS "content_schemas" (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    type TEXT UNIQUE NOT NULL,
+    schemaJson TEXT NOT NULL,
+    isSystem INTEGER DEFAULT 1,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP
+  );
+
+CREATE TABLE IF NOT EXISTS "users" (
+    id TEXT PRIMARY KEY,
+    email TEXT UNIQUE NOT NULL,
+    name TEXT NOT NULL,
+    globalRole TEXT DEFAULT 'editor',
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP
+  );
+
+CREATE TABLE IF NOT EXISTS "user_accounts" (
+    id TEXT PRIMARY KEY,
+    userId TEXT NOT NULL,
+    provider TEXT NOT NULL,
+    providerAccountId TEXT NOT NULL,
+    passwordHash TEXT NOT NULL,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (userId) REFERENCES users(id) ON DELETE CASCADE,
+    UNIQUE(provider, providerAccountId)
+  );
+
+CREATE TABLE IF NOT EXISTS "sessions" (
+    id TEXT PRIMARY KEY,
+    userId TEXT NOT NULL,
+    expiresAt TEXT NOT NULL,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (userId) REFERENCES users(id) ON DELETE CASCADE
+  );
+
+CREATE TABLE IF NOT EXISTS "channels" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    key TEXT UNIQUE NOT NULL,
+    label TEXT NOT NULL,
+    channelType TEXT,
+    domain TEXT,
+    baseUrl TEXT,
+    defaultLanguage TEXT,
+    isHidden INTEGER NOT NULL DEFAULT 0,
+    dataJson TEXT,
+    createdById TEXT,
+    updatedById TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (createdById) REFERENCES users(id) ON DELETE SET NULL,
+    FOREIGN KEY (updatedById) REFERENCES users(id) ON DELETE SET NULL
+  );
+
+CREATE TABLE IF NOT EXISTS "trees" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    key TEXT UNIQUE NOT NULL,
+    label TEXT NOT NULL,
+    treeType TEXT,
+    channelId INTEGER,
+    isHidden INTEGER NOT NULL DEFAULT 0,
+    dataJson TEXT,
+    createdById TEXT,
+    updatedById TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (channelId) REFERENCES channels(id) ON DELETE SET NULL,
+    FOREIGN KEY (createdById) REFERENCES users(id) ON DELETE SET NULL,
+    FOREIGN KEY (updatedById) REFERENCES users(id) ON DELETE SET NULL
+  );
+
+CREATE TABLE IF NOT EXISTS "channel_trees" (
+    channelId INTEGER NOT NULL,
+    treeId INTEGER NOT NULL,
+    key TEXT NOT NULL DEFAULT 'main',
+    metaJson TEXT,
+    PRIMARY KEY (channelId, treeId, key),
+    FOREIGN KEY (channelId) REFERENCES channels(id) ON DELETE CASCADE,
+    FOREIGN KEY (treeId) REFERENCES trees(id) ON DELETE CASCADE
+  );
+
+CREATE TABLE IF NOT EXISTS "content_nodes" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    contentType TEXT NOT NULL,
+    title TEXT NOT NULL,
+    slug TEXT,
+    language TEXT,
+    isHidden INTEGER NOT NULL DEFAULT 0,
+    status TEXT DEFAULT 'draft',
+    hasUnpublishedChanges INTEGER DEFAULT 0,
+    disabledRegionsJson TEXT DEFAULT '{}',
+    dataJson TEXT,
+    draftDataJson TEXT,
+    publishedDataJson TEXT,
+    publishedAt TEXT,
+    createdById TEXT,
+    updatedById TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    deletedAt TEXT,
+    FOREIGN KEY (createdById) REFERENCES users(id) ON DELETE SET NULL,
+    FOREIGN KEY (updatedById) REFERENCES users(id) ON DELETE SET NULL
+  );
+
+CREATE TABLE IF NOT EXISTS "node_channels" (
+    nodeId INTEGER NOT NULL,
+    channelId INTEGER NOT NULL,
+    PRIMARY KEY (nodeId, channelId),
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (channelId) REFERENCES channels(id) ON DELETE CASCADE
+  );
+
+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,
+    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
+  );
+
+CREATE TABLE IF NOT EXISTS "content_blocks" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    contentId INTEGER NOT NULL,
+    region TEXT DEFAULT 'main',
+    elementType TEXT NOT NULL,
+    dataJson TEXT,
+    sortOrder INTEGER DEFAULT 0,
+    isDraft INTEGER NOT NULL DEFAULT 1,
+    FOREIGN KEY (contentId) REFERENCES content_nodes(id) ON DELETE CASCADE
+  );
+
+CREATE TABLE IF NOT EXISTS "node_revisions" (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    nodeId INTEGER NOT NULL,
+    version INTEGER NOT NULL DEFAULT 1,
+    snapshotJson TEXT NOT NULL,
+    createdById TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (createdById) REFERENCES users(id) ON DELETE SET NULL
+  );
+
+CREATE TABLE IF NOT EXISTS "assets" (
+    id TEXT PRIMARY KEY,
+    filename TEXT NOT NULL,
+    mimeType TEXT NOT NULL,
+    sizeBytes INTEGER NOT NULL,
+    storageKeyPrivate TEXT,
+    cdnUrl TEXT,
+    parentAssetId TEXT,
+    cropCoordinatesJson TEXT,
+    isSystemVariant INTEGER DEFAULT 0,
+    dataJson TEXT DEFAULT '{}',
+    createdById TEXT,
+    createdAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    updatedAt TEXT DEFAULT CURRENT_TIMESTAMP,
+    deletedAt TEXT,
+    FOREIGN KEY (parentAssetId) REFERENCES assets(id) ON DELETE SET NULL,
+    FOREIGN KEY (createdById) REFERENCES users(id) ON DELETE SET NULL
+  );
+
+CREATE TABLE IF NOT EXISTS "node_assets" (
+    nodeId INTEGER NOT NULL,
+    assetId TEXT NOT NULL,
+    fieldKey TEXT NOT NULL,
+    sortOrder INTEGER DEFAULT 0,
+    PRIMARY KEY (nodeId, assetId, fieldKey),
+    FOREIGN KEY (nodeId) REFERENCES content_nodes(id) ON DELETE CASCADE,
+    FOREIGN KEY (assetId) REFERENCES assets(id) ON DELETE CASCADE
+  );
+
+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);
+CREATE INDEX IF NOT EXISTS idx_content_blocks_node ON content_blocks(contentId, isDraft);
+CREATE INDEX IF NOT EXISTS idx_node_assets_nodeId ON node_assets(nodeId);
+CREATE INDEX IF NOT EXISTS idx_node_assets_assetId ON node_assets(assetId);
+CREATE INDEX IF NOT EXISTS idx_content_schemas_type ON content_schemas(type);
+CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(userId);
+CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expiresAt);
+CREATE INDEX IF NOT EXISTS idx_channels_visibility ON channels(isHidden);
+CREATE INDEX IF NOT EXISTS idx_trees_visibility ON trees(isHidden);
+CREATE INDEX IF NOT EXISTS idx_content_nodes_visibility ON content_nodes(isHidden, status);
+CREATE INDEX IF NOT EXISTS idx_content_nodes_slug ON content_nodes(slug);
+CREATE INDEX IF NOT EXISTS idx_content_nodes_type ON content_nodes(contentType);
+CREATE INDEX IF NOT EXISTS idx_content_nodes_deleted_updated ON content_nodes(deletedAt, updatedAt DESC);
+CREATE INDEX IF NOT EXISTS idx_tree_nodes_hierarchy ON tree_nodes(treeId, parentId, sortOrder);
+CREATE INDEX IF NOT EXISTS idx_tree_nodes_content ON tree_nodes(contentId, treeId);
+CREATE INDEX IF NOT EXISTS idx_content_blocks_content ON content_blocks(contentId, isDraft, region, sortOrder);
+CREATE INDEX IF NOT EXISTS idx_node_channels_channel ON node_channels(channelId, nodeId);
+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 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);

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

@@ -0,0 +1,24 @@
+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({
+    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