@dbcube/schema-builder 1.0.16 → 1.0.18

package/dist/index.cjs

@@ -30,15 +30,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CubeValidator: () => CubeValidator,
+  DependencyResolver: () => DependencyResolver,
   Schema: () => Schema,
+  UIUtils: () => UIUtils,
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/lib/Schema.ts
-var import_fs2 = __toESM(require("fs"));
+var import_fs4 = __toESM(require("fs"));
 var import_core = require("@dbcube/core");
-var import_path = __toESM(require("path"));
+var import_path3 = __toESM(require("path"));
 
 // src/lib/FileUtils.ts
 var fs = __toESM(require("fs"));
@@ -285,6 +288,550 @@ ${import_chalk.default.red("\u{1F6AB}")} ${import_chalk.default.bold.red("ERRORS
   }
 };
 
+// src/lib/CubeValidator.ts
+var import_fs2 = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var CubeValidator = class {
+  validTypes = ["varchar", "int", "string", "text", "boolean", "date", "datetime", "timestamp", "decimal", "float", "double", "enum", "json"];
+  validOptions = ["not null", "primary", "autoincrement", "unique", "zerofill", "index", "required", "unsigned"];
+  validProperties = ["type", "length", "options", "value", "defaultValue", "foreign", "enumValues", "description"];
+  knownAnnotations = ["database", "table", "meta", "columns", "fields", "dataset", "beforeAdd", "afterAdd", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "compute", "column"];
+  /**
+   * Validates a cube file comprehensively
+   */
+  validateCubeFile(filePath) {
+    const errors = [];
+    try {
+      const content = import_fs2.default.readFileSync(filePath, "utf8");
+      const lines = content.split("\n");
+      const fileName = import_path.default.basename(filePath, import_path.default.extname(filePath));
+      for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        if (line.trim() === "" || line.trim().startsWith("//")) {
+          continue;
+        }
+        this.validateAnnotations(line, lineIndex + 1, filePath, fileName, errors);
+        this.validateDataTypes(line, lineIndex + 1, filePath, fileName, errors, content);
+        this.validateColumnOptions(line, lineIndex + 1, filePath, fileName, errors, lines);
+        this.validateColumnProperties(line, lineIndex + 1, filePath, fileName, errors, content);
+        this.validateRequiredColumnProperties(lines, lineIndex + 1, filePath, fileName, errors);
+        this.validateGeneralSyntax(line, lineIndex + 1, filePath, fileName, errors);
+      }
+      this.validateOverallStructure(content, filePath, fileName, errors);
+    } catch (error) {
+      errors.push({
+        itemName: import_path.default.basename(filePath, import_path.default.extname(filePath)),
+        error: `Failed to read cube file: ${error.message}`,
+        filePath,
+        lineNumber: 1
+      });
+    }
+    return {
+      isValid: errors.length === 0,
+      errors
+    };
+  }
+  validateAnnotations(line, lineNumber, filePath, fileName, errors) {
+    const annotationRegex = /@(\w+)/g;
+    let match;
+    while ((match = annotationRegex.exec(line)) !== null) {
+      const annotation = match[1];
+      if (!this.knownAnnotations.includes(annotation)) {
+        errors.push({
+          itemName: fileName,
+          error: `Unknown annotation '@${annotation}'. Valid annotations: ${this.knownAnnotations.join(", ")}`,
+          filePath,
+          lineNumber
+        });
+      }
+    }
+  }
+  validateDataTypes(line, lineNumber, filePath, fileName, errors, content) {
+    const typeRegex = /type:\s*["'](\w+)["']/g;
+    let match;
+    while ((match = typeRegex.exec(line)) !== null) {
+      const type = match[1];
+      if (!this.validTypes.includes(type)) {
+        errors.push({
+          itemName: fileName,
+          error: `Invalid data type '${type}'. Valid types: ${this.validTypes.join(", ")}`,
+          filePath,
+          lineNumber
+        });
+      }
+    }
+    if (line.includes('type: "varchar"')) {
+      const lines = content.split("\n");
+      const hasLengthNearby = lines.slice(Math.max(0, lineNumber - 1), Math.min(lineNumber + 4, lines.length)).some((nextLine) => nextLine.includes("length:"));
+      if (!hasLengthNearby) {
+        errors.push({
+          itemName: fileName,
+          error: "VARCHAR type requires a length specification",
+          filePath,
+          lineNumber
+        });
+      }
+    }
+  }
+  validateColumnOptions(line, lineNumber, filePath, fileName, errors, lines) {
+    const optionsMatch = line.match(/^\s*options\s*:\s*\[(.*)\]\s*;?\s*$/);
+    if (!optionsMatch) return;
+    const optionsContent = optionsMatch[1].trim();
+    const invalidSyntaxMatch = optionsContent.match(/[^",\s]+(?![^"]*")/);
+    if (invalidSyntaxMatch) {
+      errors.push({
+        itemName: fileName,
+        error: `Invalid syntax '${invalidSyntaxMatch[0]}' in options array. All values must be quoted strings`,
+        filePath,
+        lineNumber
+      });
+      return;
+    }
+    const optionMatches = optionsContent.match(/"([^"]*)"/g);
+    if (optionMatches) {
+      const columnType = this.getColumnTypeForOptions(lines, lineNumber - 1);
+      optionMatches.forEach((optionMatch) => {
+        const option = optionMatch.replace(/"/g, "");
+        if (option.trim() === "") {
+          errors.push({
+            itemName: fileName,
+            error: "Empty option found in options array. All options must have a value",
+            filePath,
+            lineNumber
+          });
+        } else if (!this.validOptions.includes(option)) {
+          errors.push({
+            itemName: fileName,
+            error: `Invalid option '${option}'. Valid options: ${this.validOptions.join(", ")}`,
+            filePath,
+            lineNumber
+          });
+        } else if (columnType !== "unknown" && !this.isOptionCompatibleWithType(option, columnType)) {
+          errors.push({
+            itemName: fileName,
+            error: `Option '${option}' is not compatible with type '${columnType}'`,
+            filePath,
+            lineNumber
+          });
+        }
+      });
+    }
+  }
+  validateColumnProperties(line, lineNumber, filePath, fileName, errors, content) {
+    const propertyKeyRegex = /^\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:/;
+    const propMatch = propertyKeyRegex.exec(line);
+    if (!propMatch) return;
+    const propertyName = propMatch[1];
+    if (/^\s*[a-zA-Z_][a-zA-Z0-9_]*\s*:\s*\{/.test(line)) {
+      return;
+    }
+    if (this.isInsideForeignKeyObject(content, lineNumber - 1)) {
+      const validForeignKeyProperties = ["table", "column"];
+      if (!validForeignKeyProperties.includes(propertyName)) {
+        errors.push({
+          itemName: fileName,
+          error: `Invalid foreign key property '${propertyName}'. Valid foreign key properties: ${validForeignKeyProperties.join(", ")}`,
+          filePath,
+          lineNumber
+        });
+      }
+      return;
+    }
+    if (this.isInsideColumnsBlock(content, lineNumber - 1)) {
+      if (!this.validProperties.includes(propertyName)) {
+        errors.push({
+          itemName: fileName,
+          error: `Invalid property '${propertyName}'. Valid properties: ${this.validProperties.join(", ")}`,
+          filePath,
+          lineNumber
+        });
+      }
+    }
+    if (/^\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*$/.test(line)) {
+      errors.push({
+        itemName: fileName,
+        error: `Property '${propertyName}' is missing a value`,
+        filePath,
+        lineNumber
+      });
+    }
+  }
+  validateRequiredColumnProperties(lines, lineNumber, filePath, fileName, errors) {
+    const line = lines[lineNumber - 1];
+    if (!/^\s*\}\s*;?\s*$/.test(line)) {
+      return;
+    }
+    let columnStartLine = -1;
+    let columnName = "";
+    for (let i = lineNumber - 2; i >= 0; i--) {
+      const currentLine = lines[i];
+      const columnDefMatch = currentLine.match(/^\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*\{/);
+      if (columnDefMatch) {
+        let openBraces = 0;
+        let closeBraces = 0;
+        for (let j = i; j < lineNumber; j++) {
+          openBraces += (lines[j].match(/\{/g) || []).length;
+          closeBraces += (lines[j].match(/\}/g) || []).length;
+        }
+        if (openBraces === closeBraces) {
+          columnStartLine = i;
+          columnName = columnDefMatch[1];
+          break;
+        }
+      }
+    }
+    if (columnStartLine === -1 || !columnName) return;
+    let hasType = false;
+    for (let i = columnStartLine + 1; i < lineNumber - 1; i++) {
+      if (lines[i].match(/^\s*type\s*:/)) {
+        hasType = true;
+        break;
+      }
+    }
+    if (!hasType && columnName !== "foreign" && columnName !== "defaultValue") {
+      errors.push({
+        itemName: fileName,
+        error: `Column '${columnName}' is missing required 'type' property`,
+        filePath,
+        lineNumber: columnStartLine + 1
+      });
+    }
+  }
+  validateGeneralSyntax(line, lineNumber, filePath, fileName, errors) {
+    const quotes = line.match(/["']/g);
+    if (quotes && quotes.length % 2 !== 0) {
+      errors.push({
+        itemName: fileName,
+        error: "Mismatched quotes detected",
+        filePath,
+        lineNumber
+      });
+    }
+    if (line.includes("@database") || line.includes("@table")) {
+      const stringAnnotationRegex = /@(database|table)\s*\(\s*"([^"]*)"\s*\)/;
+      if (!stringAnnotationRegex.test(line)) {
+        errors.push({
+          itemName: fileName,
+          error: 'Invalid annotation syntax. Expected format: @annotation("value")',
+          filePath,
+          lineNumber
+        });
+      }
+    }
+    if (line.includes("@meta")) {
+      const metaObjectRegex = /@meta\s*\(\s*\{/;
+      if (!metaObjectRegex.test(line)) {
+        errors.push({
+          itemName: fileName,
+          error: "Invalid @meta syntax. Expected format: @meta({ ... })",
+          filePath,
+          lineNumber
+        });
+      }
+    }
+  }
+  validateOverallStructure(content, filePath, fileName, errors) {
+    const lines = content.split("\n");
+    const hasDatabase = lines.some((line) => line.includes("@database"));
+    if (!hasDatabase) {
+      errors.push({
+        itemName: fileName,
+        error: "Missing required @database annotation",
+        filePath,
+        lineNumber: 1
+      });
+    }
+    if (filePath.includes(".table.cube")) {
+      const hasColumns = lines.some((line) => line.includes("@columns"));
+      if (!hasColumns) {
+        errors.push({
+          itemName: fileName,
+          error: "Table cube files require @columns annotation",
+          filePath,
+          lineNumber: 1
+        });
+      }
+    }
+  }
+  getColumnTypeForOptions(lines, optionsLineIndex) {
+    for (let i = optionsLineIndex - 1; i >= 0; i--) {
+      const line = lines[i];
+      const typeMatch = line.match(/^\s*type\s*:\s*"([^"]+)"/);
+      if (typeMatch) {
+        return typeMatch[1];
+      }
+      if (/^\s*[a-zA-Z_][a-zA-Z0-9_]*\s*:\s*\{/.test(line)) {
+        break;
+      }
+    }
+    return "unknown";
+  }
+  isOptionCompatibleWithType(option, type) {
+    const compatibilityRules = {
+      "zerofill": ["int", "decimal", "float", "double"],
+      "unsigned": ["int", "decimal", "float", "double"],
+      "autoincrement": ["int"],
+      "primary": ["int", "varchar", "string"],
+      "not null": ["int", "varchar", "string", "text", "boolean", "date", "datetime", "timestamp", "decimal", "float", "double"],
+      "unique": ["int", "varchar", "string", "text"],
+      "index": ["int", "varchar", "string", "text", "date", "datetime", "timestamp"],
+      "required": ["int", "varchar", "string", "text", "boolean", "date", "datetime", "timestamp", "decimal", "float", "double"]
+    };
+    const compatibleTypes = compatibilityRules[option];
+    if (!compatibleTypes) {
+      return true;
+    }
+    return compatibleTypes.includes(type);
+  }
+  isInsideColumnsBlock(content, lineIndex) {
+    const lines = content.split("\n");
+    let columnsStartLine = -1;
+    let columnsEndLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].includes("@columns")) {
+        columnsStartLine = i;
+        let braceCount = 0;
+        for (let j = i; j < lines.length; j++) {
+          const currentLine = lines[j];
+          braceCount += (currentLine.match(/\{/g) || []).length;
+          braceCount -= (currentLine.match(/\}/g) || []).length;
+          if (braceCount === 0 && j > i) {
+            columnsEndLine = j;
+            break;
+          }
+        }
+        break;
+      }
+    }
+    return columnsStartLine !== -1 && columnsEndLine !== -1 && lineIndex > columnsStartLine && lineIndex < columnsEndLine;
+  }
+  isInsideForeignKeyObject(content, lineIndex) {
+    const lines = content.split("\n");
+    for (let i = lineIndex; i >= 0; i--) {
+      const line = lines[i];
+      if (/foreign\s*:\s*\{/.test(line)) {
+        let braceCount = 0;
+        for (let j = i; j <= lineIndex; j++) {
+          const currentLine = lines[j];
+          const openBraces = (currentLine.match(/\{/g) || []).length;
+          const closeBraces = (currentLine.match(/\}/g) || []).length;
+          braceCount += openBraces - closeBraces;
+          if (braceCount === 0 && j > i) {
+            return false;
+          }
+        }
+        return braceCount > 0;
+      }
+      if (line.trim() === "}" || line.includes("};")) {
+        break;
+      }
+    }
+    return false;
+  }
+};
+
+// src/lib/DependencyResolver.ts
+var import_fs3 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+var DependencyResolver = class {
+  /**
+   * Resolves table dependencies and creates execution order
+   */
+  static resolveDependencies(cubeFiles, cubeType = "table") {
+    const tableDependencies = this.extractDependencies(cubeFiles, cubeType);
+    const orderedTables = this.topologicalSort(tableDependencies);
+    const executionOrder = {
+      tables: cubeType === "table" ? orderedTables : [],
+      seeders: cubeType === "seeder" ? orderedTables : [],
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.saveExecutionOrder(executionOrder);
+    return executionOrder;
+  }
+  /**
+   * Extracts dependencies from cube files
+   */
+  static extractDependencies(cubeFiles, cubeType) {
+    const dependencies = [];
+    for (const file of cubeFiles) {
+      let filePath;
+      if (import_path2.default.isAbsolute(file)) {
+        filePath = file;
+      } else if (import_fs3.default.existsSync(file)) {
+        filePath = import_path2.default.resolve(file);
+      } else {
+        filePath = import_path2.default.join(process.cwd(), "dbcube", "cubes", file);
+      }
+      try {
+        const tableNameResult = FileUtils_default.extracTableNameFromCube(filePath);
+        const tableName = tableNameResult.status === 200 ? tableNameResult.message : import_path2.default.basename(file, `.${cubeType}.cube`);
+        const deps = this.extractForeignKeyReferences(filePath);
+        dependencies.push({
+          tableName,
+          filePath,
+          dependencies: deps
+        });
+      } catch (error) {
+        console.error(`Error processing ${filePath}:`, error);
+      }
+    }
+    return dependencies;
+  }
+  /**
+   * Extracts foreign key references from a cube file
+   */
+  static extractForeignKeyReferences(filePath) {
+    const dependencies = [];
+    try {
+      const content = import_fs3.default.readFileSync(filePath, "utf8");
+      const lines = content.split("\n");
+      let insideForeignKey = false;
+      let braceCount = 0;
+      for (const line of lines) {
+        if (/foreign\s*:\s*\{/.test(line)) {
+          insideForeignKey = true;
+          braceCount = 1;
+          const sameLineMatch = line.match(/table\s*:\s*["']([^"']+)["']/);
+          if (sameLineMatch) {
+            dependencies.push(sameLineMatch[1]);
+            insideForeignKey = false;
+            braceCount = 0;
+          }
+          continue;
+        }
+        if (insideForeignKey) {
+          braceCount += (line.match(/\{/g) || []).length;
+          braceCount -= (line.match(/\}/g) || []).length;
+          const tableMatch = line.match(/table\s*:\s*["']([^"']+)["']/);
+          if (tableMatch) {
+            dependencies.push(tableMatch[1]);
+          }
+          if (braceCount === 0) {
+            insideForeignKey = false;
+          }
+        }
+      }
+    } catch (error) {
+      console.error(`Error reading file ${filePath}:`, error);
+    }
+    return dependencies;
+  }
+  /**
+   * Performs topological sort to determine execution order
+   */
+  static topologicalSort(dependencies) {
+    const graph = /* @__PURE__ */ new Map();
+    const inDegree = /* @__PURE__ */ new Map();
+    const tableMap = /* @__PURE__ */ new Map();
+    for (const dep of dependencies) {
+      graph.set(dep.tableName, dep.dependencies);
+      inDegree.set(dep.tableName, 0);
+      tableMap.set(dep.tableName, dep);
+    }
+    for (const dep of dependencies) {
+      for (const dependency of dep.dependencies) {
+        if (inDegree.has(dependency)) {
+          inDegree.set(dep.tableName, (inDegree.get(dep.tableName) || 0) + 1);
+        }
+      }
+    }
+    const queue = [];
+    const result = [];
+    for (const [table, degree] of inDegree) {
+      if (degree === 0) {
+        queue.push(table);
+      }
+    }
+    while (queue.length > 0) {
+      const current = queue.shift();
+      result.push(current);
+      const currentDeps = graph.get(current) || [];
+      for (const neighbor of currentDeps) {
+        if (inDegree.has(neighbor)) {
+          const newDegree = (inDegree.get(neighbor) || 0) - 1;
+          inDegree.set(neighbor, newDegree);
+          if (newDegree === 0) {
+            queue.push(neighbor);
+          }
+        }
+      }
+    }
+    if (result.length !== dependencies.length) {
+      console.warn("\u26A0\uFE0F  Circular dependencies detected in tables. Some tables may not execute in optimal order.");
+      for (const dep of dependencies) {
+        if (!result.includes(dep.tableName)) {
+          result.push(dep.tableName);
+        }
+      }
+    }
+    return result;
+  }
+  /**
+   * Saves the execution order to .dbcube/orderexecute.json
+   */
+  static saveExecutionOrder(order) {
+    try {
+      const projectRoot = process.cwd();
+      const dbcubeDir = import_path2.default.join(projectRoot, ".dbcube");
+      const orderFile = import_path2.default.join(dbcubeDir, "orderexecute.json");
+      if (!import_fs3.default.existsSync(dbcubeDir)) {
+        import_fs3.default.mkdirSync(dbcubeDir, { recursive: true });
+      }
+      import_fs3.default.writeFileSync(orderFile, JSON.stringify(order, null, 2), "utf8");
+      console.log(`\u{1F4C4} Execution order saved to: ${import_path2.default.relative(projectRoot, orderFile)}`);
+    } catch (error) {
+      console.error("\u274C Failed to save execution order:", error);
+    }
+  }
+  /**
+   * Loads the execution order from .dbcube/orderexecute.json
+   */
+  static loadExecutionOrder() {
+    try {
+      const projectRoot = process.cwd();
+      const orderFile = import_path2.default.join(projectRoot, ".dbcube", "orderexecute.json");
+      if (!import_fs3.default.existsSync(orderFile)) {
+        return null;
+      }
+      const content = import_fs3.default.readFileSync(orderFile, "utf8");
+      return JSON.parse(content);
+    } catch (error) {
+      console.error("\u274C Failed to load execution order:", error);
+      return null;
+    }
+  }
+  /**
+   * Orders cube files based on saved execution order
+   */
+  static orderCubeFiles(cubeFiles, cubeType) {
+    const executionOrder = this.loadExecutionOrder();
+    if (!executionOrder) {
+      console.log("\u{1F4C4} No execution order found, processing files in current order");
+      return cubeFiles;
+    }
+    const orderList = cubeType === "table" ? executionOrder.tables : executionOrder.seeders;
+    const orderedFiles = [];
+    const fileMap = /* @__PURE__ */ new Map();
+    for (const file of cubeFiles) {
+      const filePath = import_path2.default.isAbsolute(file) ? file : import_path2.default.join(process.cwd(), "dbcube", "cubes", file);
+      const tableNameResult = FileUtils_default.extracTableNameFromCube(filePath);
+      const tableName = tableNameResult.status === 200 ? tableNameResult.message : import_path2.default.basename(file, `.${cubeType}.cube`);
+      fileMap.set(tableName, file);
+    }
+    for (const tableName of orderList) {
+      if (fileMap.has(tableName)) {
+        orderedFiles.push(fileMap.get(tableName));
+        fileMap.delete(tableName);
+      }
+    }
+    for (const [, file] of fileMap) {
+      orderedFiles.push(file);
+    }
+    console.log(`\u{1F4CB} Using dependency order: ${orderList.join(" \u2192 ")}`);
+    return orderedFiles;
+  }
+};
+
 // src/lib/Schema.ts
 var Schema = class {
   name;
@@ -294,18 +841,27 @@ var Schema = class {
     this.engine = new import_core.Engine(name);
   }
   /**
-   * Validates that the database specified in cube file exists in configuration
+   * Validates cube file comprehensively including syntax, database configuration, and structure
    * @param filePath - Path to the cube file
-   * @returns true if valid, throws error if invalid
+   * @returns validation result with any errors found
    */
   validateDatabaseConfiguration(filePath) {
     try {
+      const cubeValidator = new CubeValidator();
+      const cubeValidation = cubeValidator.validateCubeFile(filePath);
+      if (!cubeValidation.isValid && cubeValidation.errors.length > 0) {
+        return {
+          isValid: false,
+          error: cubeValidation.errors[0]
+          // Return the first error found
+        };
+      }
       const dbResult = FileUtils_default.extractDatabaseNameFromCube(filePath);
       if (dbResult.status !== 200) {
         return {
           isValid: false,
           error: {
-            itemName: import_path.default.basename(filePath, import_path.default.extname(filePath)),
+            itemName: import_path3.default.basename(filePath, import_path3.default.extname(filePath)),
             error: `Error reading database directive: ${dbResult.message}`,
             filePath,
             lineNumber: this.findDatabaseLineNumber(filePath)
@@ -314,7 +870,7 @@ var Schema = class {
       }
       const cubeDbName = dbResult.message;
       const configInstance = new import_core.Config();
-      const configFilePath = import_path.default.resolve(process.cwd(), "dbcube.config.js");
+      const configFilePath = import_path3.default.resolve(process.cwd(), "dbcube.config.js");
       const configFn = require(configFilePath);
       if (typeof configFn === "function") {
         configFn(configInstance);
@@ -341,7 +897,7 @@ var Schema = class {
         return {
           isValid: false,
           error: {
-            itemName: import_path.default.basename(filePath, import_path.default.extname(filePath)),
+            itemName: import_path3.default.basename(filePath, import_path3.default.extname(filePath)),
             error: `Database configuration '${cubeDbName}' not found in dbcube.config.js. Available: ${availableText}`,
             filePath,
             lineNumber: this.findDatabaseLineNumber(filePath)
@@ -353,7 +909,7 @@ var Schema = class {
       return {
         isValid: false,
         error: {
-          itemName: import_path.default.basename(filePath, import_path.default.extname(filePath)),
+          itemName: import_path3.default.basename(filePath, import_path3.default.extname(filePath)),
           error: `Database configuration validation failed: ${error.message}`,
           filePath,
           lineNumber: this.findDatabaseLineNumber(filePath)
@@ -366,7 +922,7 @@ var Schema = class {
    */
   findDatabaseLineNumber(filePath) {
     try {
-      const content = import_fs2.default.readFileSync(filePath, "utf8");
+      const content = import_fs4.default.readFileSync(filePath, "utf8");
       const lines = content.split("\n");
       for (let i = 0; i < lines.length; i++) {
         if (lines[i].includes("@database")) {
@@ -380,7 +936,7 @@ var Schema = class {
   }
   async createDatabase() {
     const startTime = Date.now();
-    const rootPath = import_path.default.resolve(process.cwd());
+    const rootPath = import_path3.default.resolve(process.cwd());
     UIUtils.showOperationHeader(" CREATING DATABASE", this.name, "\u{1F5C4}\uFE0F");
     await UIUtils.showItemProgress("Preparando e instalando base de datos", 1, 1);
     try {
@@ -424,28 +980,31 @@ var Schema = class {
   }
   async refreshTables() {
     const startTime = Date.now();
-    const cubesDir = import_path.default.join(process.cwd(), "dbcube", "cubes");
-    if (!import_fs2.default.existsSync(cubesDir)) {
+    const cubesDir = import_path3.default.join(process.cwd(), "dbcube", "cubes");
+    if (!import_fs4.default.existsSync(cubesDir)) {
       throw new Error("\u274C The cubes folder does not exist");
     }
     const cubeFiles = FileUtils_default.getCubeFilesRecursively("dbcube", "table.cube");
     if (cubeFiles.length === 0) {
       throw new Error("\u274C There are no cubes to execute");
     }
+    console.log("\u{1F504} Resolving table dependencies...");
+    DependencyResolver.resolveDependencies(cubeFiles, "table");
+    const orderedCubeFiles = DependencyResolver.orderCubeFiles(cubeFiles, "table");
     UIUtils.showOperationHeader("EXECUTING REFRESH TABLES", this.name, "\u{1F504}");
     let totalTablesProcessed = 0;
     let successCount = 0;
     let errorCount = 0;
     const processedTables = [];
     const errors = [];
-    for (let index = 0; index < cubeFiles.length; index++) {
-      const file = cubeFiles[index];
-      const filePath = import_path.default.isAbsolute(file) ? file : import_path.default.join(cubesDir, file);
-      const stats = import_fs2.default.statSync(filePath);
+    for (let index = 0; index < orderedCubeFiles.length; index++) {
+      const file = orderedCubeFiles[index];
+      const filePath = import_path3.default.isAbsolute(file) ? file : import_path3.default.join(cubesDir, file);
+      const stats = import_fs4.default.statSync(filePath);
       if (stats.isFile()) {
         const getTableName = FileUtils_default.extracTableNameFromCube(filePath);
-        const tableName = getTableName.status === 200 ? getTableName.message : import_path.default.basename(file, ".table.cube");
-        await UIUtils.showItemProgress(tableName, index + 1, cubeFiles.length);
+        const tableName = getTableName.status === 200 ? getTableName.message : import_path3.default.basename(file, ".table.cube");
+        await UIUtils.showItemProgress(tableName, index + 1, orderedCubeFiles.length);
         try {
           const validation = this.validateDatabaseConfiguration(filePath);
           if (!validation.isValid && validation.error) {
@@ -526,28 +1085,31 @@ var Schema = class {
   }
   async freshTables() {
     const startTime = Date.now();
-    const cubesDir = import_path.default.join(process.cwd(), "dbcube", "cubes");
-    if (!import_fs2.default.existsSync(cubesDir)) {
+    const cubesDir = import_path3.default.join(process.cwd(), "dbcube", "cubes");
+    if (!import_fs4.default.existsSync(cubesDir)) {
       throw new Error("\u274C The cubes folder does not exist");
     }
     const cubeFiles = FileUtils_default.getCubeFilesRecursively("dbcube", "table.cube");
     if (cubeFiles.length === 0) {
       throw new Error("\u274C There are no cubes to execute");
     }
+    console.log("\u{1F504} Resolving table dependencies...");
+    DependencyResolver.resolveDependencies(cubeFiles, "table");
+    const orderedCubeFiles = DependencyResolver.orderCubeFiles(cubeFiles, "table");
     UIUtils.showOperationHeader("EXECUTING FRESH TABLES", this.name);
     let totalTablesProcessed = 0;
     let successCount = 0;
     let errorCount = 0;
     const processedTables = [];
     const errors = [];
-    for (let index = 0; index < cubeFiles.length; index++) {
-      const file = cubeFiles[index];
-      const filePath = import_path.default.isAbsolute(file) ? file : import_path.default.join(cubesDir, file);
-      const stats = import_fs2.default.statSync(filePath);
+    for (let index = 0; index < orderedCubeFiles.length; index++) {
+      const file = orderedCubeFiles[index];
+      const filePath = import_path3.default.isAbsolute(file) ? file : import_path3.default.join(cubesDir, file);
+      const stats = import_fs4.default.statSync(filePath);
       if (stats.isFile()) {
         const getTableName = FileUtils_default.extracTableNameFromCube(filePath);
-        const tableName = getTableName.status === 200 ? getTableName.message : import_path.default.basename(file, ".table.cube");
-        await UIUtils.showItemProgress(tableName, index + 1, cubeFiles.length);
+        const tableName = getTableName.status === 200 ? getTableName.message : import_path3.default.basename(file, ".table.cube");
+        await UIUtils.showItemProgress(tableName, index + 1, orderedCubeFiles.length);
         try {
           const validation = this.validateDatabaseConfiguration(filePath);
           if (!validation.isValid && validation.error) {
@@ -626,28 +1188,29 @@ var Schema = class {
   }
   async executeSeeders() {
     const startTime = Date.now();
-    const cubesDir = import_path.default.join(process.cwd(), "dbcube", "cubes");
-    if (!import_fs2.default.existsSync(cubesDir)) {
+    const cubesDir = import_path3.default.join(process.cwd(), "dbcube", "cubes");
+    if (!import_fs4.default.existsSync(cubesDir)) {
       throw new Error("\u274C The cubes folder does not exist");
     }
     const cubeFiles = FileUtils_default.getCubeFilesRecursively("dbcube", "seeder.cube");
     if (cubeFiles.length === 0) {
       throw new Error("\u274C There are no cubes to execute");
     }
+    const orderedCubeFiles = DependencyResolver.orderCubeFiles(cubeFiles, "seeder");
     UIUtils.showOperationHeader("EXECUTING SEEDERS", this.name, "\u{1F331}");
     let totalSeedersProcessed = 0;
     let successCount = 0;
     let errorCount = 0;
     const processedSeeders = [];
     const errors = [];
-    for (let index = 0; index < cubeFiles.length; index++) {
-      const file = cubeFiles[index];
-      const filePath = import_path.default.isAbsolute(file) ? file : import_path.default.join(cubesDir, file);
-      const stats = import_fs2.default.statSync(filePath);
+    for (let index = 0; index < orderedCubeFiles.length; index++) {
+      const file = orderedCubeFiles[index];
+      const filePath = import_path3.default.isAbsolute(file) ? file : import_path3.default.join(cubesDir, file);
+      const stats = import_fs4.default.statSync(filePath);
       if (stats.isFile()) {
         const getSeederName = FileUtils_default.extracTableNameFromCube(filePath);
-        const seederName = getSeederName.status === 200 ? getSeederName.message : import_path.default.basename(file, ".seeder.cube");
-        await UIUtils.showItemProgress(seederName, index + 1, cubeFiles.length);
+        const seederName = getSeederName.status === 200 ? getSeederName.message : import_path3.default.basename(file, ".seeder.cube");
+        await UIUtils.showItemProgress(seederName, index + 1, orderedCubeFiles.length);
         try {
           const validation = this.validateDatabaseConfiguration(filePath);
           if (!validation.isValid && validation.error) {
@@ -697,9 +1260,9 @@ var Schema = class {
   }
   async executeTriggers() {
     const startTime = Date.now();
-    const cubesDir = import_path.default.join(process.cwd(), "dbcube", "cubes");
-    const triggersDirExit = import_path.default.join(process.cwd(), "dbcube", "triggers");
-    if (!import_fs2.default.existsSync(cubesDir)) {
+    const cubesDir = import_path3.default.join(process.cwd(), "dbcube", "cubes");
+    const triggersDirExit = import_path3.default.join(process.cwd(), "dbcube", "triggers");
+    if (!import_fs4.default.existsSync(cubesDir)) {
       throw new Error("\u274C The cubes folder does not exist");
     }
     const cubeFiles = FileUtils_default.getCubeFilesRecursively("dbcube", "trigger.cube");
@@ -714,11 +1277,11 @@ var Schema = class {
     const errors = [];
     for (let index = 0; index < cubeFiles.length; index++) {
       const file = cubeFiles[index];
-      const filePath = import_path.default.isAbsolute(file) ? file : import_path.default.join(cubesDir, file);
-      const stats = import_fs2.default.statSync(filePath);
+      const filePath = import_path3.default.isAbsolute(file) ? file : import_path3.default.join(cubesDir, file);
+      const stats = import_fs4.default.statSync(filePath);
       if (stats.isFile()) {
         const getTriggerName = FileUtils_default.extracTableNameFromCube(filePath);
-        const triggerName = getTriggerName.status === 200 ? getTriggerName.message : import_path.default.basename(file, ".trigger.cube");
+        const triggerName = getTriggerName.status === 200 ? getTriggerName.message : import_path3.default.basename(file, ".trigger.cube");
         await UIUtils.showItemProgress(triggerName, index + 1, cubeFiles.length);
         try {
           const validation = this.validateDatabaseConfiguration(filePath);
@@ -789,7 +1352,7 @@ ${import_chalk2.default.red("\u{1F6AB}")} ${import_chalk2.default.bold.red("ERRO
       const errorLocation = `${filePath}:${lineStr}:${columnStr}`;
       console.log(`${import_chalk2.default.cyan("[code]")} ${import_chalk2.default.yellow(errorLocation)}`);
       try {
-        const codeLines = import_fs2.default.readFileSync(filePath, "utf-8").split("\n");
+        const codeLines = import_fs4.default.readFileSync(filePath, "utf-8").split("\n");
         const start = Math.max(0, lineNum - 3);
         const end = Math.min(codeLines.length, lineNum + 2);
         for (let i = start; i < end; i++) {
@@ -803,6 +1366,7 @@ ${import_chalk2.default.red("\u{1F6AB}")} ${import_chalk2.default.bold.red("ERRO
       }
     }
   }
+  console.log("");
   process.exit(1);
 }
 
@@ -810,6 +1374,9 @@ ${import_chalk2.default.red("\u{1F6AB}")} ${import_chalk2.default.bold.red("ERRO
 var index_default = Schema;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Schema
+  CubeValidator,
+  DependencyResolver,
+  Schema,
+  UIUtils
 });
 //# sourceMappingURL=index.cjs.map