koguma 0.6.6 → 2.0.0

package/src/db/migrate.ts

@@ -1,182 +0,0 @@
-/**
- * Schema migration — detects drift between site.config.ts and the D1 database,
- * then generates safe ALTER TABLE SQL to bring the DB in sync.
- *
- * Design:
- * - Only ADD COLUMN is safe in SQLite — removals/renames are warned, never applied.
- * - Type changes are warned but not applied (SQLite doesn't support ALTER COLUMN).
- * - System columns (id, created_at, updated_at, status, publishAt) are ignored.
- */
-import type { ContentTypeConfig } from '../config/define.ts';
-import type { FieldMeta } from '../config/field.ts';
-
-// ── Types ───────────────────────────────────────────────────────────
-
-export interface ColumnInfo {
-  name: string;
-  type: string;
-}
-
-export interface DriftResult {
-  table: string;
-  added: { name: string; sqlType: string; meta: FieldMeta }[];
-  removed: string[];
-  typeChanged: { name: string; expected: string; actual: string }[];
-}
-
-export interface MigrationResult {
-  drift: DriftResult[];
-  sql: string[];
-  warnings: string[];
-}
-
-// ── System columns (skip during drift detection) ────────────────────
-
-const SYSTEM_COLUMNS = new Set([
-  'id',
-  'created_at',
-  'updated_at',
-  'status',
-  'publishAt'
-]);
-
-// ── SQL type mapping (same as schema.ts) ────────────────────────────
-
-function sqlType(fieldType: string): string {
-  switch (fieldType) {
-    case 'text':
-    case 'longText':
-    case 'richText':
-    case 'url':
-    case 'email':
-    case 'phone':
-    case 'color':
-    case 'youtube':
-    case 'instagram':
-    case 'image':
-    case 'images':
-    case 'reference':
-    case 'date':
-    case 'select':
-      return 'TEXT';
-    case 'number':
-      return 'REAL';
-    case 'boolean':
-      return 'INTEGER';
-    case 'references':
-      return '__JOIN__';
-    default:
-      return 'TEXT';
-  }
-}
-
-// ── Drift detection ─────────────────────────────────────────────────
-
-export function detectDrift(
-  contentTypes: ContentTypeConfig[],
-  existingColumns: Record<string, ColumnInfo[]>
-): MigrationResult {
-  const drift: DriftResult[] = [];
-  const sql: string[] = [];
-  const warnings: string[] = [];
-
-  for (const ct of contentTypes) {
-    const tableCols = existingColumns[ct.id];
-    if (!tableCols || tableCols.length === 0) {
-      // Table doesn't exist — generate CREATE TABLE
-      const columns: string[] = [
-        'id TEXT PRIMARY KEY',
-        "created_at TEXT DEFAULT (datetime('now'))",
-        "updated_at TEXT DEFAULT (datetime('now'))",
-        "status TEXT NOT NULL DEFAULT 'published'",
-        'publishAt TEXT'
-      ];
-
-      for (const [fieldId, meta] of Object.entries(ct.fieldMeta)) {
-        const st = sqlType(meta.fieldType);
-        if (st === '__JOIN__') {
-          // Create join table for `references` fields
-          const joinTable = `${ct.id}__${fieldId}`;
-          sql.push(
-            `CREATE TABLE IF NOT EXISTS ${joinTable} (\n` +
-              `  source_id TEXT NOT NULL,\n` +
-              `  target_id TEXT NOT NULL,\n` +
-              `  sort_order INTEGER NOT NULL DEFAULT 0,\n` +
-              `  PRIMARY KEY (source_id, target_id)\n` +
-              `);`
-          );
-          sql.push(
-            `CREATE INDEX IF NOT EXISTS idx_${joinTable}_source ON ${joinTable} (source_id);`
-          );
-          continue;
-        }
-        const notNull = meta.required ? ' NOT NULL' : '';
-        columns.push(`${fieldId} ${st}${notNull}`);
-      }
-
-      sql.push(
-        `CREATE TABLE IF NOT EXISTS ${ct.id} (\n  ${columns.join(',\n  ')}\n);`
-      );
-      continue;
-    }
-
-    const existing = new Map(
-      tableCols.map(c => [c.name, c.type.toUpperCase()])
-    );
-    const result: DriftResult = {
-      table: ct.id,
-      added: [],
-      removed: [],
-      typeChanged: []
-    };
-
-    // Check for new fields in config not in DB
-    for (const [fieldId, meta] of Object.entries(ct.fieldMeta)) {
-      const st = sqlType(meta.fieldType);
-      if (st === '__JOIN__') continue; // join tables handled separately
-
-      if (!existing.has(fieldId)) {
-        result.added.push({ name: fieldId, sqlType: st, meta });
-        const notNull = meta.required ? " NOT NULL DEFAULT ''" : '';
-        sql.push(`ALTER TABLE ${ct.id} ADD COLUMN ${fieldId} ${st}${notNull};`);
-      } else {
-        // Check type match
-        const actualType = existing.get(fieldId)!;
-        if (actualType !== st) {
-          result.typeChanged.push({
-            name: fieldId,
-            expected: st,
-            actual: actualType
-          });
-          warnings.push(
-            `Column '${ct.id}.${fieldId}' type mismatch: config says ${st}, DB has ${actualType}. ` +
-              `SQLite does not support ALTER COLUMN — manual migration needed.`
-          );
-        }
-      }
-    }
-
-    // Check for DB columns not in config (removed fields)
-    for (const [colName] of existing) {
-      if (SYSTEM_COLUMNS.has(colName)) continue;
-      const configHasField = colName in ct.fieldMeta;
-      if (!configHasField) {
-        result.removed.push(colName);
-        warnings.push(
-          `Column '${ct.id}.${colName}' exists in DB but not in config. ` +
-            `Koguma will NOT drop this column (data safety). Remove it manually if needed.`
-        );
-      }
-    }
-
-    if (
-      result.added.length ||
-      result.removed.length ||
-      result.typeChanged.length
-    ) {
-      drift.push(result);
-    }
-  }
-
-  return { drift, sql, warnings };
-}

package/src/db/schema.ts

@@ -1,122 +0,0 @@
-/**
- * Schema generator — reads a Koguma config and produces SQL DDL for D1.
- *
- * Design:
- * - Each content type → one table
- * - Scalar fields → columns on that table
- * - `field.ref()`  → TEXT column (foreign key to the target table's id)
- * - `field.refs()` → join table: `{source}_{field}` with (source_id, target_id, sort_order)
- * - `field.richText()` → TEXT column storing JSON
- * - `field.image()` → TEXT column (FK to assets table id)
- * - Every table gets `id TEXT PRIMARY KEY`, `created_at`, `updated_at`
- */
-import type { ContentTypeConfig } from '../config/define.ts';
-import type { FieldMeta, FieldType } from '../config/field.ts';
-
-// ── SQL type mapping ────────────────────────────────────────────────
-
-function sqlType(fieldType: FieldType): string {
-  switch (fieldType) {
-    case 'text':
-    case 'longText':
-    case 'richText':
-    case 'url':
-    case 'email':
-    case 'phone':
-    case 'color':
-    case 'youtube':
-    case 'instagram':
-    case 'image':
-    case 'reference':
-    case 'date':
-    case 'select':
-      return 'TEXT';
-    case 'number':
-      return 'REAL';
-    case 'boolean':
-      return 'INTEGER'; // 0/1
-    case 'references':
-      return '__JOIN__';
-    case 'images':
-      return 'TEXT'; // JSON array
-  }
-}
-
-// ── Collect all fields from a content type (flat or grouped) ────────
-
-function collectFields(ct: ContentTypeConfig): Record<string, FieldMeta> {
-  return ct.fieldMeta;
-}
-
-// ── Generate SQL ─────────────────────────────────────────────────────
-
-export interface GeneratedSchema {
-  /** CREATE TABLE statements */
-  tables: string[];
-  /** CREATE INDEX statements */
-  indexes: string[];
-  /** All SQL as a single string */
-  sql: string;
-}
-
-export function generateSchema(
-  contentTypes: ContentTypeConfig[]
-): GeneratedSchema {
-  const tables: string[] = [];
-  const indexes: string[] = [];
-
-  // ── Assets table (always present) ────────────────────────────────
-  tables.push(`CREATE TABLE IF NOT EXISTS _assets (
-  id TEXT PRIMARY KEY,
-  title TEXT NOT NULL DEFAULT '',
-  description TEXT DEFAULT '',
-  url TEXT NOT NULL,
-  content_type TEXT DEFAULT '',
-  width INTEGER,
-  height INTEGER,
-  file_size INTEGER,
-  created_at TEXT DEFAULT (datetime('now')),
-  updated_at TEXT DEFAULT (datetime('now'))
-);`);
-
-  // ── Content type tables ──────────────────────────────────────────
-  for (const ct of contentTypes) {
-    const fields = collectFields(ct);
-    const columns: string[] = [
-      'id TEXT PRIMARY KEY',
-      "created_at TEXT DEFAULT (datetime('now'))",
-      "updated_at TEXT DEFAULT (datetime('now'))",
-      "status TEXT NOT NULL DEFAULT 'published'",
-      'publishAt TEXT'
-    ];
-
-    for (const [fieldId, meta] of Object.entries(fields)) {
-      const st = sqlType(meta.fieldType);
-
-      if (st === '__JOIN__') {
-        // Create a join table for `references` fields
-        const joinTable = `${ct.id}__${fieldId}`;
-        tables.push(`CREATE TABLE IF NOT EXISTS ${joinTable} (
-  source_id TEXT NOT NULL,
-  target_id TEXT NOT NULL,
-  sort_order INTEGER NOT NULL DEFAULT 0,
-  PRIMARY KEY (source_id, target_id)
-);`);
-        indexes.push(
-          `CREATE INDEX IF NOT EXISTS idx_${joinTable}_source ON ${joinTable} (source_id);`
-        );
-        continue;
-      }
-
-      const notNull = meta.required ? ' NOT NULL' : '';
-      columns.push(`${fieldId} ${st}${notNull}`);
-    }
-
-    tables.push(
-      `CREATE TABLE IF NOT EXISTS ${ct.id} (\n  ${columns.join(',\n  ')}\n);`
-    );
-  }
-
-  const sql = [...tables, '', ...indexes].join('\n\n');
-  return { tables, indexes, sql };
-}