@aruvili/core 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,61 @@
+export type FieldType = 'Select' | 'Text' | 'Small Text' | 'Long Text' | 'Int' | 'Float' | 'Check' | 'Date' | 'Datetime' | 'Link' | 'Currency' | 'Table' | 'Table MultiSelect';
+export interface DocField {
+    fieldname: string;
+    label: string;
+    fieldtype: FieldType;
+    required?: boolean;
+    unique?: boolean;
+    options?: string;
+    default?: any;
+    searchable?: boolean;
+    read_only?: boolean;
+    hidden?: boolean;
+    max_length?: number;
+    min_value?: number;
+    max_value?: number;
+}
+export interface PermissionRule {
+    role: string;
+    create: boolean;
+    read: boolean;
+    update: boolean;
+    delete: boolean;
+    submit?: boolean;
+    cancel?: boolean;
+}
+export type NamingRule = 'Autoincrement' | 'UUID' | 'Expression' | 'NamingSeries';
+export interface WorkflowTransition {
+    state: string;
+    action: string;
+    next_state: string;
+    allowed_roles: string[];
+}
+export interface DocTypeWorkflow {
+    fieldname: string;
+    initial_state: string;
+    transitions: WorkflowTransition[];
+}
+export interface DocTypeDefinition {
+    name: string;
+    istable?: boolean;
+    is_submittable?: boolean;
+    naming_rule?: NamingRule;
+    naming_series?: string;
+    title_field?: string;
+    track_changes?: boolean;
+    max_attachments?: number;
+    fields: DocField[];
+    permissions: PermissionRule[];
+    workflow?: DocTypeWorkflow;
+}
+export interface DatabaseColumnMeta {
+    columnName: string;
+    dataType: string;
+    isNullable: boolean;
+    characterMaximumLength: number | null;
+}
+/**
+ * Reserved SQL keywords that cannot be used as table or column identifiers.
+ */
+export declare const SQL_RESERVED_WORDS: Set<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,WAAW,GACX,KAAK,GACL,OAAO,GACP,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,OAAO,GACP,mBAAmB,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,MAAM,GAAG,YAAY,GAAG,cAAc,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAW7B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQL_RESERVED_WORDS = void 0;
+/**
+ * Reserved SQL keywords that cannot be used as table or column identifiers.
+ */
+exports.SQL_RESERVED_WORDS = new Set([
+    'select', 'insert', 'update', 'delete', 'drop', 'alter', 'create',
+    'table', 'index', 'from', 'where', 'join', 'order', 'group', 'having',
+    'limit', 'offset', 'union', 'all', 'and', 'or', 'not', 'null', 'true',
+    'false', 'primary', 'key', 'foreign', 'references', 'constraint',
+    'default', 'check', 'unique', 'cascade', 'set', 'into', 'values',
+    'returning', 'exists', 'between', 'like', 'in', 'is', 'as', 'on',
+    'begin', 'commit', 'rollback', 'grant', 'revoke', 'user', 'role',
+    'schema', 'database', 'trigger', 'function', 'procedure', 'view',
+    'sequence', 'serial', 'bigserial', 'text', 'integer', 'boolean',
+    'varchar', 'timestamp', 'date', 'numeric', 'uuid'
+]);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA6EA;;GAEG;AACU,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;IACjE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ;IACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACrE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY;IAChE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ;IAChE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAChE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IAChE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM;IAChE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAC/D,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAClD,CAAC,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,10 @@
+import { DocTypeDefinition } from './types/index.js';
+/**
+ * Validates a DocTypeDefinition schema structure for database safety and logical compliance.
+ * Enterprise-grade: checks SQL injection vectors, PostgreSQL limits, and structural integrity.
+ */
+export declare function validateDocType(definition: DocTypeDefinition): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,kBAAkB,CAAC;AAsBzE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA+InG"}

package/dist/validation.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDocType = validateDocType;
+const index_js_1 = require("./types/index.js");
+const RESERVED_FIELD_NAMES = new Set([
+    'name',
+    'uuid',
+    'created_at',
+    'updated_at',
+    'created_by',
+    'modified_by',
+    'docstatus',
+    'parent',
+    'parenttype',
+    'parentfield',
+    'idx'
+]);
+const VALID_FIELDNAME_REGEX = /^[a-z][a-z0-9_]*$/;
+const VALID_DOCTYPE_NAME_REGEX = /^[A-Za-z][A-Za-z0-9 _-]*$/;
+const MAX_DOCTYPE_NAME_LENGTH = 100;
+const MAX_FIELD_COUNT = 200;
+const MAX_FIELDNAME_LENGTH = 63; // PostgreSQL identifier limit
+/**
+ * Validates a DocTypeDefinition schema structure for database safety and logical compliance.
+ * Enterprise-grade: checks SQL injection vectors, PostgreSQL limits, and structural integrity.
+ */
+function validateDocType(definition) {
+    const errors = [];
+    // === DocType Name Validations ===
+    if (!definition.name || definition.name.trim() === '') {
+        errors.push('DocType name is required.');
+    }
+    else {
+        if (definition.name.length > MAX_DOCTYPE_NAME_LENGTH) {
+            errors.push(`DocType name '${definition.name}' exceeds maximum length of ${MAX_DOCTYPE_NAME_LENGTH} characters.`);
+        }
+        if (!VALID_DOCTYPE_NAME_REGEX.test(definition.name)) {
+            errors.push(`DocType name '${definition.name}' contains invalid characters. Allowed: letters, digits, spaces, hyphens, underscores.`);
+        }
+        // Block SQL reserved words as DocType names (prevents injection via table names)
+        if (index_js_1.SQL_RESERVED_WORDS.has(definition.name.toLowerCase().trim())) {
+            errors.push(`DocType name '${definition.name}' is a reserved SQL keyword and cannot be used.`);
+        }
+    }
+    // === Fields Array ===
+    if (!definition.fields || !Array.isArray(definition.fields)) {
+        errors.push('DocType must contain an array of fields.');
+        return { valid: false, errors };
+    }
+    if (definition.fields.length > MAX_FIELD_COUNT) {
+        errors.push(`DocType '${definition.name}' exceeds maximum of ${MAX_FIELD_COUNT} fields.`);
+    }
+    const seenFields = new Set();
+    for (const field of definition.fields) {
+        const { fieldname, fieldtype } = field;
+        // --- Fieldname presence ---
+        if (!fieldname || fieldname.trim() === '') {
+            errors.push(`Fieldname is missing for a field in ${definition.name}.`);
+            continue;
+        }
+        // --- Fieldname format ---
+        if (!VALID_FIELDNAME_REGEX.test(fieldname)) {
+            errors.push(`Fieldname '${fieldname}' in ${definition.name} is invalid. It must be snake_case, start with a lowercase letter, and contain only lowercase letters, digits, and underscores.`);
+        }
+        // --- Fieldname length (PostgreSQL limit) ---
+        if (fieldname.length > MAX_FIELDNAME_LENGTH) {
+            errors.push(`Fieldname '${fieldname}' exceeds PostgreSQL identifier limit of ${MAX_FIELDNAME_LENGTH} characters.`);
+        }
+        // --- Reserved names ---
+        if (RESERVED_FIELD_NAMES.has(fieldname)) {
+            errors.push(`Fieldname '${fieldname}' in ${definition.name} is reserved by the framework database architecture.`);
+        }
+        // --- SQL reserved words as column names ---
+        if (index_js_1.SQL_RESERVED_WORDS.has(fieldname.toLowerCase())) {
+            errors.push(`Fieldname '${fieldname}' in ${definition.name} is a reserved SQL keyword and cannot be used as a column name.`);
+        }
+        // --- Duplicates ---
+        if (seenFields.has(fieldname)) {
+            errors.push(`Duplicate fieldname '${fieldname}' declared in ${definition.name}.`);
+        }
+        seenFields.add(fieldname);
+        // --- Fieldtype presence ---
+        if (!fieldtype) {
+            errors.push(`Field '${fieldname}' is missing fieldtype in ${definition.name}.`);
+        }
+        // === Specific field validations ===
+        if (fieldtype === 'Select') {
+            if (!field.options || field.options.trim() === '') {
+                errors.push(`Select field '${fieldname}' in ${definition.name} requires options (comma-separated list).`);
+            }
+        }
+        if (fieldtype === 'Link' || fieldtype === 'Table') {
+            if (!field.options || field.options.trim() === '') {
+                errors.push(`Relationship field '${fieldname}' of type '${fieldtype}' in ${definition.name} requires target option.`);
+            }
+        }
+        // --- Numeric constraints validation ---
+        if (field.min_value !== undefined && field.max_value !== undefined) {
+            if (field.min_value > field.max_value) {
+                errors.push(`Field '${fieldname}' in ${definition.name}: min_value (${field.min_value}) cannot exceed max_value (${field.max_value}).`);
+            }
+        }
+        // --- max_length validation ---
+        if (field.max_length !== undefined) {
+            if (field.max_length <= 0 || field.max_length > 10485760) {
+                errors.push(`Field '${fieldname}' in ${definition.name}: max_length must be between 1 and 10485760.`);
+            }
+        }
+    }
+    // === Validate naming configuration ===
+    if (!definition.istable) {
+        const rule = definition.naming_rule || 'UUID';
+        if (rule === 'NamingSeries' && (!definition.naming_series || definition.naming_series.trim() === '')) {
+            errors.push(`DocType '${definition.name}' requires naming_series configuration if NamingSeries rule is selected.`);
+        }
+    }
+    // === Validate permissions structure ===
+    if (!definition.istable && (!definition.permissions || definition.permissions.length === 0)) {
+        errors.push(`DocType '${definition.name}' must define at least one permission rule (non-child tables require explicit access control).`);
+    }
+    if (definition.permissions) {
+        for (const perm of definition.permissions) {
+            if (!perm.role || perm.role.trim() === '') {
+                errors.push(`A permission rule in ${definition.name} is missing a role name.`);
+            }
+        }
+    }
+    // Validate submittable config
+    if (definition.is_submittable && definition.istable) {
+        errors.push(`DocType '${definition.name}' cannot be both a child table (istable) and submittable.`);
+    }
+    // Validate title_field references an existing field
+    if (definition.title_field) {
+        const fieldExists = definition.fields.some(f => f.fieldname === definition.title_field);
+        if (!fieldExists) {
+            errors.push(`title_field '${definition.title_field}' in ${definition.name} does not reference an existing field.`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@aruvili/core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic DocType and DDL core engine",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "aruvili-meta": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "~6.0.2"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import { validateDocType } from './validation.js';
+import { generateCreateTableDDL } from './ddl.js';
+
+const [, , command, ...args] = process.argv;
+
+if (!command || command === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+switch (command) {
+  case 'init':
+    handleInit(args[0]);
+    break;
+  case 'validate':
+    handleValidate(args[0]);
+    break;
+  case 'ddl':
+    handleDdl(args[0]);
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exit(1);
+}
+
+function printHelp() {
+  console.log(`
+Aruvili Meta-Framework CLI
+Usage: aruvili-meta <command> [args]
+
+Commands:
+  init <name>      Scaffold a new DocType definition template
+  validate <path>  Validate a DocType JSON schema file
+  ddl <path>       Generate PostgreSQL CREATE TABLE DDL from JSON schema
+  help             Print this usage information
+`);
+}
+
+function handleInit(name: string) {
+  if (!name) {
+    console.error('Error: DocType name is required.');
+    process.exit(1);
+  }
+  const filename = `${name.toLowerCase().replace(/[^a-z0-9_]/g, '_')}.json`;
+  const template = {
+    name,
+    is_submittable: false,
+    istable: false,
+    fields: [
+      { fieldname: 'title', label: 'Title', fieldtype: 'Text', required: true }
+    ],
+    permissions: [
+      { role: 'System Manager', read: true, write: true, create: true, delete: true }
+    ]
+  };
+
+  fs.writeFileSync(path.resolve(process.cwd(), filename), JSON.stringify(template, null, 2));
+  console.log(`Scaffolded template DocType schema: ${filename}`);
+}
+
+function handleValidate(filePath: string) {
+  if (!filePath) {
+    console.error('Error: Path to DocType JSON file is required.');
+    process.exit(1);
+  }
+  try {
+    const data = JSON.parse(fs.readFileSync(path.resolve(process.cwd(), filePath), 'utf-8'));
+    const result = validateDocType(data);
+    if (result.valid) {
+      console.log(`✅ DocType '${data.name}' is valid.`);
+    } else {
+      console.error(`❌ Validation errors found in ${filePath}:`);
+      result.errors.forEach(err => console.error(`  - ${err}`));
+      process.exit(1);
+    }
+  } catch (err: any) {
+    console.error(`Error: Failed to validate. ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function handleDdl(filePath: string) {
+  if (!filePath) {
+    console.error('Error: Path to DocType JSON file is required.');
+    process.exit(1);
+  }
+  try {
+    const data = JSON.parse(fs.readFileSync(path.resolve(process.cwd(), filePath), 'utf-8'));
+    const result = validateDocType(data);
+    if (!result.valid) {
+      console.error(`❌ Cannot generate DDL. DocType schema has validation errors:`);
+      result.errors.forEach(err => console.error(`  - ${err}`));
+      process.exit(1);
+    }
+    const ddl = generateCreateTableDDL(data);
+    console.log(ddl.join('\n'));
+  } catch (err: any) {
+    console.error(`Error: Failed to generate DDL. ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/core.test.ts

@@ -0,0 +1,236 @@
+import { describe, expect, it } from 'bun:test';
+import { DocTypeDefinition } from './types/index.js';
+import { validateDocType } from './validation.js';
+import { generateCreateTableDDL, generateAlterTableDDL, getTableName } from './ddl.js';
+
+describe('DocType validation', () => {
+  it('should validate a correct DocType definition', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [
+        { fieldname: 'title', label: 'Title', fieldtype: 'Text', required: true },
+        { fieldname: 'status', label: 'Status', fieldtype: 'Select', options: 'Open,Closed', default: 'Open' }
+      ],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(true);
+    expect(result.errors.length).toBe(0);
+  });
+
+  it('should block reserved field names', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'docstatus', label: 'Doc Status', fieldtype: 'Int' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('reserved');
+  });
+
+  it('should block uuid as a field name', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'uuid', label: 'UUID', fieldtype: 'Text' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('reserved');
+  });
+
+  it('should validate fieldname naming conventions', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'Title Field', label: 'Title', fieldtype: 'Text' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('is invalid');
+  });
+
+  it('should block Select type fields without options', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'status', label: 'Status', fieldtype: 'Select' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('requires options');
+  });
+
+  it('should block SQL reserved words as DocType names', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Select',
+      fields: [{ fieldname: 'title', label: 'Title', fieldtype: 'Text' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('reserved SQL keyword');
+  });
+
+  it('should block SQL reserved words as field names', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'select', label: 'Select', fieldtype: 'Text' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+  });
+
+  it('should require permissions on non-child DocTypes', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [{ fieldname: 'title', label: 'Title', fieldtype: 'Text' }],
+      permissions: []
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('at least one permission');
+  });
+
+  it('should allow child tables without permissions', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task Item',
+      istable: true,
+      fields: [{ fieldname: 'item_name', label: 'Item', fieldtype: 'Text' }],
+      permissions: []
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(true);
+  });
+
+  it('should block submittable child tables', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Bad Child',
+      istable: true,
+      is_submittable: true,
+      fields: [{ fieldname: 'item_name', label: 'Item', fieldtype: 'Text' }],
+      permissions: []
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('cannot be both');
+  });
+
+  it('should validate title_field references existing field', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      title_field: 'nonexistent',
+      fields: [{ fieldname: 'title', label: 'Title', fieldtype: 'Text' }],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const result = validateDocType(doc);
+    expect(result.valid).toBe(false);
+    expect(result.errors.join('')).toContain('does not reference');
+  });
+});
+
+describe('SQL DDL Code Generation', () => {
+  it('should generate a valid CREATE TABLE with uuid column', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [
+        { fieldname: 'title', label: 'Title', fieldtype: 'Text', required: true },
+        { fieldname: 'description', label: 'Description', fieldtype: 'Long Text' },
+        { fieldname: 'project', label: 'Project', fieldtype: 'Link', options: 'Project' }
+      ],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    const statements = generateCreateTableDDL(doc);
+    const sql = statements.join('\n');
+    
+    expect(getTableName(doc.name)).toBe('dt_task');
+    expect(sql).toContain('CREATE TABLE dt_task');
+    expect(sql).toContain('name VARCHAR(255) PRIMARY KEY');
+    expect(sql).toContain('uuid UUID DEFAULT gen_random_uuid() UNIQUE NOT NULL');
+    expect(sql).toContain('title VARCHAR(255) NOT NULL');
+    expect(sql).toContain('description TEXT');
+    expect(sql).toContain('project VARCHAR(255)');
+    // Verify automatic indexes
+    expect(sql).toContain('idx_dt_task_docstatus');
+    expect(sql).toContain('idx_dt_task_created_at');
+    expect(sql).toContain('idx_dt_task_project');
+  });
+
+  it('should generate child table columns', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Invoice Item',
+      istable: true,
+      fields: [{ fieldname: 'item_code', label: 'Item Code', fieldtype: 'Text', required: true }],
+      permissions: []
+    };
+    const statements = generateCreateTableDDL(doc);
+    const sql = statements.join('\n');
+
+    expect(sql).toContain('uuid UUID DEFAULT gen_random_uuid() UNIQUE NOT NULL');
+    expect(sql).toContain('parent VARCHAR(255) NOT NULL');
+    expect(sql).toContain('parenttype VARCHAR(255) NOT NULL');
+    expect(sql).toContain('parentfield VARCHAR(255) NOT NULL');
+    expect(sql).toContain('idx INTEGER NOT NULL');
+    expect(sql).toContain('idx_dt_invoice_item_parent');
+  });
+
+  it('should calculate additive migrations with uuid backfill', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [
+        { fieldname: 'title', label: 'Title', fieldtype: 'Text' },
+        { fieldname: 'priority', label: 'Priority', fieldtype: 'Select', options: 'Low,Medium,High', default: 'Medium', searchable: true }
+      ],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }]
+    };
+    
+    // uuid missing from existing DB
+    const existing = [
+      { columnName: 'name', dataType: 'varchar', isNullable: false, characterMaximumLength: 255 },
+      { columnName: 'title', dataType: 'varchar', isNullable: true, characterMaximumLength: 255 }
+    ];
+
+    const statements = generateAlterTableDDL(doc, existing);
+    expect(statements.length).toBe(3); // uuid + priority column + priority index
+    expect(statements[0]).toContain('ADD COLUMN uuid UUID');
+
+    // uuid already exists
+    const existingWithUuid = [
+      { columnName: 'uuid', dataType: 'uuid', isNullable: false, characterMaximumLength: null },
+      { columnName: 'name', dataType: 'varchar', isNullable: false, characterMaximumLength: 255 },
+      { columnName: 'title', dataType: 'varchar', isNullable: true, characterMaximumLength: 255 }
+    ];
+
+    const statements2 = generateAlterTableDDL(doc, existingWithUuid);
+    expect(statements2.length).toBe(2);
+    expect(statements2[0]).toContain('ADD COLUMN priority');
+  });
+
+  it('should generate workflow column and index DDL when workflow is configured', () => {
+    const doc: DocTypeDefinition = {
+      name: 'Task',
+      fields: [
+        { fieldname: 'title', label: 'Title', fieldtype: 'Text', required: true }
+      ],
+      permissions: [{ role: 'System Manager', create: true, read: true, update: true, delete: true }],
+      workflow: {
+        fieldname: 'workflow_state',
+        initial_state: 'Draft',
+        transitions: [
+          { state: 'Draft', action: 'Submit', next_state: 'Approved', allowed_roles: ['System Manager'] }
+        ]
+      }
+    };
+
+    const ddl = generateCreateTableDDL(doc);
+    const tableStmt = ddl.find(s => s.startsWith('CREATE TABLE'));
+    expect(tableStmt).toBeDefined();
+    expect(tableStmt).toContain('workflow_state VARCHAR(255) DEFAULT \'Draft\'');
+
+    const indexStmt = ddl.find(s => s.includes('idx_dt_task_workflow_state'));
+    expect(indexStmt).toBeDefined();
+  });
+});
+