@famgia/omnify-cli 0.0.1

package/dist/index.js

@@ -0,0 +1,701 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { OmnifyError as OmnifyError5 } from "@famgia/omnify-core";
+
+// src/commands/init.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve } from "path";
+
+// src/output/logger.ts
+import pc from "picocolors";
+import { formatError, getExitCode } from "@famgia/omnify-core";
+var Logger = class {
+  _verbose;
+  _quiet;
+  _startTime;
+  constructor(options = {}) {
+    this._verbose = options.verbose ?? false;
+    this._quiet = options.quiet ?? false;
+    this._startTime = Date.now();
+  }
+  /**
+   * Enable or disable verbose mode.
+   */
+  setVerbose(verbose) {
+    this._verbose = verbose;
+  }
+  /**
+   * Enable or disable quiet mode.
+   */
+  setQuiet(quiet) {
+    this._quiet = quiet;
+  }
+  /**
+   * Log an info message.
+   */
+  info(message) {
+    if (!this._quiet) {
+      console.log(message);
+    }
+  }
+  /**
+   * Log a success message.
+   */
+  success(message) {
+    if (!this._quiet) {
+      console.log(pc.green("\u2713") + " " + message);
+    }
+  }
+  /**
+   * Log a warning message.
+   */
+  warn(message) {
+    if (!this._quiet) {
+      console.log(pc.yellow("\u26A0") + " " + pc.yellow(message));
+    }
+  }
+  /**
+   * Log an error message.
+   */
+  error(message) {
+    console.error(pc.red("\u2717") + " " + pc.red(message));
+  }
+  /**
+   * Log a debug message (only in verbose mode).
+   */
+  debug(message) {
+    if (this._verbose && !this._quiet) {
+      console.log(pc.dim("  " + message));
+    }
+  }
+  /**
+   * Log a step message.
+   */
+  step(message) {
+    if (!this._quiet) {
+      console.log(pc.cyan("\u2192") + " " + message);
+    }
+  }
+  /**
+   * Log a header.
+   */
+  header(message) {
+    if (!this._quiet) {
+      console.log();
+      console.log(pc.bold(message));
+      console.log();
+    }
+  }
+  /**
+   * Log a list item.
+   */
+  list(items) {
+    if (!this._quiet) {
+      for (const item of items) {
+        console.log("  \u2022 " + item);
+      }
+    }
+  }
+  /**
+   * Log a timing message.
+   */
+  timing(message) {
+    if (this._verbose && !this._quiet) {
+      const elapsed = Date.now() - this._startTime;
+      console.log(pc.dim(`  [${elapsed}ms] ${message}`));
+    }
+  }
+  /**
+   * Log an empty line.
+   */
+  newline() {
+    if (!this._quiet) {
+      console.log();
+    }
+  }
+  /**
+   * Format and log an OmnifyError.
+   */
+  formatError(error) {
+    const formatted = formatError(error, { color: true });
+    console.error(formatted);
+  }
+  /**
+   * Get exit code for an error.
+   */
+  getExitCode(error) {
+    return getExitCode(error);
+  }
+};
+var logger = new Logger();
+
+// src/commands/init.ts
+var EXAMPLE_SCHEMA = `# Example User schema
+# See https://omnify.dev/docs/schemas for documentation
+
+name: User
+displayName: User Account
+kind: object
+
+properties:
+  email:
+    type: Email
+    unique: true
+    displayName: Email Address
+
+  name:
+    type: String
+    displayName: Full Name
+
+  bio:
+    type: Text
+    nullable: true
+    displayName: Biography
+
+options:
+  timestamps: true
+  softDelete: true
+`;
+var EXAMPLE_CONFIG = `import { defineConfig } from '@famgia/omnify-cli';
+
+export default defineConfig({
+  // Schema files location
+  schemasDir: './schemas',
+
+  // Database configuration
+  database: {
+    driver: 'mysql',
+    // Development database URL for Atlas diff operations
+    // devUrl: 'mysql://root@localhost:3306/omnify_dev',
+  },
+
+  // Output configuration
+  output: {
+    laravel: {
+      migrationsPath: 'database/migrations',
+    },
+    typescript: {
+      path: 'types',
+      singleFile: true,
+    },
+  },
+
+  // Plugins for custom types
+  plugins: [
+    // '@famgia/omnify-japan',
+  ],
+});
+`;
+async function runInit(options) {
+  const cwd = process.cwd();
+  logger.header("Initializing Omnify Project");
+  const configPath = resolve(cwd, "omnify.config.ts");
+  if (existsSync(configPath) && !options.force) {
+    logger.warn("omnify.config.ts already exists. Use --force to overwrite.");
+    return;
+  }
+  const schemasDir = resolve(cwd, "schemas");
+  if (!existsSync(schemasDir)) {
+    mkdirSync(schemasDir, { recursive: true });
+    logger.step("Created schemas/ directory");
+  } else {
+    logger.debug("schemas/ directory already exists");
+  }
+  const examplePath = resolve(schemasDir, "User.yaml");
+  if (!existsSync(examplePath) || options.force) {
+    writeFileSync(examplePath, EXAMPLE_SCHEMA);
+    logger.step("Created example schema: schemas/User.yaml");
+  } else {
+    logger.debug("Example schema already exists");
+  }
+  writeFileSync(configPath, EXAMPLE_CONFIG);
+  logger.step("Created omnify.config.ts");
+  logger.newline();
+  logger.success("Project initialized successfully!");
+  logger.newline();
+  logger.info("Next steps:");
+  logger.list([
+    "Edit omnify.config.ts to configure your database",
+    "Add your schema files to the schemas/ directory",
+    'Run "omnify validate" to check your schemas',
+    'Run "omnify diff" to preview changes',
+    'Run "omnify generate" to create migrations and types'
+  ]);
+}
+function registerInitCommand(program2) {
+  program2.command("init").description("Initialize a new omnify project").option("-f, --force", "Overwrite existing files").action(async (options) => {
+    try {
+      await runInit(options);
+    } catch (error) {
+      if (error instanceof Error) {
+        logger.error(error.message);
+      }
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/validate.ts
+import { resolve as resolve3, dirname as dirname2 } from "path";
+import { loadSchemas, validateSchemas, OmnifyError as OmnifyError2 } from "@famgia/omnify-core";
+
+// src/config/loader.ts
+import { existsSync as existsSync2 } from "fs";
+import { resolve as resolve2, dirname } from "path";
+import { createJiti } from "jiti";
+import { configError, configNotFoundError } from "@famgia/omnify-core";
+var CONFIG_FILES = [
+  "omnify.config.ts",
+  "omnify.config.js",
+  "omnify.config.mjs",
+  "omnify.config.cjs"
+];
+function findConfigFile(startDir) {
+  const cwd = resolve2(startDir);
+  for (const filename of CONFIG_FILES) {
+    const configPath = resolve2(cwd, filename);
+    if (existsSync2(configPath)) {
+      return configPath;
+    }
+  }
+  return null;
+}
+async function loadConfigFile(configPath) {
+  const jiti = createJiti(configPath, {
+    interopDefault: true,
+    moduleCache: false
+  });
+  try {
+    const module = await jiti.import(configPath);
+    const config = module;
+    if ("default" in config) {
+      return config.default;
+    }
+    return config;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw configError(
+      `Failed to load config file: ${message}. Check your omnify.config.ts for syntax errors.`,
+      "E002"
+    );
+  }
+}
+async function resolvePlugins(plugins, configPath) {
+  if (!plugins || plugins.length === 0) {
+    return [];
+  }
+  const resolved = [];
+  const configDir = configPath ? dirname(configPath) : process.cwd();
+  for (const plugin of plugins) {
+    if (typeof plugin === "string") {
+      const jiti = createJiti(configDir, {
+        interopDefault: true,
+        moduleCache: false
+      });
+      try {
+        const module = await jiti.import(plugin);
+        const loadedPlugin = module.default ?? module;
+        resolved.push(loadedPlugin);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw configError(
+          `Failed to load plugin '${plugin}': ${message}. Ensure the plugin is installed: npm install ${plugin}`,
+          "E301"
+        );
+      }
+    } else {
+      resolved.push(plugin);
+    }
+  }
+  return resolved;
+}
+async function resolveConfig(userConfig, configPath) {
+  const plugins = await resolvePlugins(userConfig.plugins, configPath);
+  const databaseConfig = {
+    driver: userConfig.database.driver,
+    enableFieldComments: userConfig.database.enableFieldComments ?? false
+  };
+  const database = userConfig.database.devUrl !== void 0 ? { ...databaseConfig, devUrl: userConfig.database.devUrl } : databaseConfig;
+  const laravelConfig = {
+    migrationsPath: userConfig.output?.laravel?.migrationsPath ?? "database/migrations"
+  };
+  const laravel = buildLaravelConfig(laravelConfig, userConfig.output?.laravel);
+  const typescript = {
+    path: userConfig.output?.typescript?.path ?? "types",
+    singleFile: userConfig.output?.typescript?.singleFile ?? true,
+    generateEnums: userConfig.output?.typescript?.generateEnums ?? true,
+    generateRelationships: userConfig.output?.typescript?.generateRelationships ?? true
+  };
+  const result = {
+    schemasDir: userConfig.schemasDir ?? "./schemas",
+    database,
+    output: {
+      laravel,
+      typescript
+    },
+    plugins,
+    verbose: userConfig.verbose ?? false,
+    lockFilePath: userConfig.lockFilePath ?? ".omnify.lock"
+  };
+  return result;
+}
+function buildLaravelConfig(base, userLaravel) {
+  const config = { ...base };
+  if (userLaravel?.modelsPath !== void 0) {
+    config.modelsPath = userLaravel.modelsPath;
+  }
+  if (userLaravel?.modelsNamespace !== void 0) {
+    config.modelsNamespace = userLaravel.modelsNamespace;
+  }
+  if (userLaravel?.factoriesPath !== void 0) {
+    config.factoriesPath = userLaravel.factoriesPath;
+  }
+  if (userLaravel?.enumsPath !== void 0) {
+    config.enumsPath = userLaravel.enumsPath;
+  }
+  if (userLaravel?.enumsNamespace !== void 0) {
+    config.enumsNamespace = userLaravel.enumsNamespace;
+  }
+  return config;
+}
+function validateConfig(config, rootDir) {
+  const schemaPath = resolve2(rootDir, config.schemasDir);
+  if (!existsSync2(schemaPath)) {
+    throw configError(
+      `Schema directory not found: ${schemaPath}. Create the '${config.schemasDir}' directory or update schemasDir in config.`,
+      "E002"
+    );
+  }
+}
+function requireDevUrl(config) {
+  if (!config.database.devUrl) {
+    throw configError(
+      `database.devUrl is required for diff and generate operations. Add devUrl to your database config, e.g., "mysql://root@localhost:3306/omnify_dev"`,
+      "E003"
+    );
+  }
+}
+async function loadConfig(startDir = process.cwd()) {
+  const cwd = resolve2(startDir);
+  const configPath = findConfigFile(cwd);
+  if (configPath) {
+    const userConfig = await loadConfigFile(configPath);
+    const config = await resolveConfig(userConfig, configPath);
+    return {
+      config,
+      configPath
+    };
+  }
+  throw configNotFoundError(resolve2(cwd, "omnify.config.ts"));
+}
+function defineConfig(config) {
+  return config;
+}
+
+// src/commands/validate.ts
+async function runValidate(options) {
+  logger.setVerbose(options.verbose ?? false);
+  logger.header("Validating Schemas");
+  logger.debug("Loading configuration...");
+  logger.timing("Config load start");
+  const { config, configPath } = await loadConfig();
+  logger.timing("Config loaded");
+  const rootDir = configPath ? dirname2(configPath) : process.cwd();
+  validateConfig(config, rootDir);
+  const schemaPath = resolve3(rootDir, config.schemasDir);
+  logger.step(`Loading schemas from ${schemaPath}`);
+  logger.timing("Schema load start");
+  const schemas = await loadSchemas(schemaPath);
+  const schemaCount = Object.keys(schemas).length;
+  logger.timing("Schemas loaded");
+  if (schemaCount === 0) {
+    logger.warn("No schema files found");
+    return;
+  }
+  logger.debug(`Found ${schemaCount} schema(s)`);
+  logger.step("Validating schemas...");
+  logger.timing("Validation start");
+  const result = validateSchemas(schemas);
+  logger.timing("Validation complete");
+  if (result.valid) {
+    logger.success(`All ${schemaCount} schema(s) are valid`);
+  } else {
+    logger.error(`Found ${result.errors.length} validation error(s)`);
+    logger.newline();
+    for (const error of result.errors) {
+      const omnifyError = OmnifyError2.fromInfo(error);
+      logger.formatError(omnifyError);
+      logger.newline();
+    }
+    process.exit(2);
+  }
+}
+function registerValidateCommand(program2) {
+  program2.command("validate").description("Validate schema files").option("-v, --verbose", "Show detailed output").action(async (options) => {
+    try {
+      await runValidate(options);
+    } catch (error) {
+      if (error instanceof OmnifyError2) {
+        logger.formatError(error);
+        process.exit(logger.getExitCode(error));
+      } else if (error instanceof Error) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/diff.ts
+import { resolve as resolve4, dirname as dirname3 } from "path";
+import { loadSchemas as loadSchemas2, validateSchemas as validateSchemas2, OmnifyError as OmnifyError3 } from "@famgia/omnify-core";
+
+// src/operations/diff.ts
+import {
+  generatePreview,
+  formatPreview
+} from "@famgia/omnify-atlas";
+async function runDiffOperation(options) {
+  const { schemas, devUrl, driver, workDir } = options;
+  const preview = await generatePreview(schemas, {
+    driver,
+    devUrl,
+    workDir
+  }, {
+    warnDestructive: true,
+    showSql: true
+  });
+  const formattedPreview = formatPreview(preview, "text");
+  return {
+    hasChanges: preview.hasChanges,
+    hasDestructiveChanges: preview.hasDestructiveChanges,
+    preview,
+    formattedPreview,
+    sql: preview.sql
+  };
+}
+
+// src/commands/diff.ts
+import pc2 from "picocolors";
+async function runDiff(options) {
+  logger.setVerbose(options.verbose ?? false);
+  logger.header("Checking for Schema Changes");
+  logger.debug("Loading configuration...");
+  const { config, configPath } = await loadConfig();
+  const rootDir = configPath ? dirname3(configPath) : process.cwd();
+  validateConfig(config, rootDir);
+  requireDevUrl(config);
+  const schemaPath = resolve4(rootDir, config.schemasDir);
+  logger.step(`Loading schemas from ${schemaPath}`);
+  const schemas = await loadSchemas2(schemaPath);
+  const schemaCount = Object.keys(schemas).length;
+  if (schemaCount === 0) {
+    logger.warn("No schema files found");
+    return;
+  }
+  logger.debug(`Found ${schemaCount} schema(s)`);
+  logger.step("Validating schemas...");
+  const validationResult = validateSchemas2(schemas);
+  if (!validationResult.valid) {
+    logger.error("Schema validation failed. Fix errors before running diff.");
+    for (const error of validationResult.errors) {
+      const omnifyError = OmnifyError3.fromInfo(error);
+      logger.formatError(omnifyError);
+    }
+    process.exit(2);
+  }
+  logger.step("Running Atlas diff...");
+  const lockPath = resolve4(rootDir, config.lockFilePath);
+  const diffResult = await runDiffOperation({
+    schemas,
+    devUrl: config.database.devUrl,
+    lockFilePath: lockPath,
+    driver: config.database.driver,
+    workDir: rootDir
+  });
+  if (!diffResult.hasChanges) {
+    logger.success("No changes detected");
+    return;
+  }
+  logger.newline();
+  console.log(pc2.bold("Changes detected:"));
+  console.log();
+  console.log(diffResult.formattedPreview);
+  if (diffResult.hasDestructiveChanges) {
+    logger.newline();
+    logger.warn("This preview contains destructive changes. Review carefully.");
+  }
+  if (options.check) {
+    logger.newline();
+    logger.info("Changes detected (--check mode)");
+    process.exit(1);
+  }
+  logger.newline();
+  logger.info('Run "omnify generate" to create migrations');
+}
+function registerDiffCommand(program2) {
+  program2.command("diff").description("Show pending schema changes").option("-v, --verbose", "Show detailed output").option("--check", "Exit with code 1 if changes exist (for CI)").action(async (options) => {
+    try {
+      await runDiff(options);
+    } catch (error) {
+      if (error instanceof OmnifyError3) {
+        logger.formatError(error);
+        process.exit(logger.getExitCode(error));
+      } else if (error instanceof Error) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/generate.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve5, dirname as dirname4 } from "path";
+import { loadSchemas as loadSchemas3, validateSchemas as validateSchemas3, OmnifyError as OmnifyError4 } from "@famgia/omnify-core";
+import { updateLockFile } from "@famgia/omnify-atlas";
+import { generateMigrations, generateTypeScript } from "@famgia/omnify-laravel";
+async function runGenerate(options) {
+  logger.setVerbose(options.verbose ?? false);
+  logger.header("Generating Outputs");
+  logger.debug("Loading configuration...");
+  const { config, configPath } = await loadConfig();
+  const rootDir = configPath ? dirname4(configPath) : process.cwd();
+  validateConfig(config, rootDir);
+  requireDevUrl(config);
+  const schemaPath = resolve5(rootDir, config.schemasDir);
+  logger.step(`Loading schemas from ${schemaPath}`);
+  const schemas = await loadSchemas3(schemaPath);
+  const schemaCount = Object.keys(schemas).length;
+  if (schemaCount === 0) {
+    logger.warn("No schema files found");
+    return;
+  }
+  logger.debug(`Found ${schemaCount} schema(s)`);
+  logger.step("Validating schemas...");
+  const validationResult = validateSchemas3(schemas);
+  if (!validationResult.valid) {
+    logger.error("Schema validation failed. Fix errors before generating.");
+    for (const error of validationResult.errors) {
+      const omnifyError = OmnifyError4.fromInfo(error);
+      logger.formatError(omnifyError);
+    }
+    process.exit(2);
+  }
+  logger.step("Checking for changes...");
+  const lockPath = resolve5(rootDir, config.lockFilePath);
+  const diffResult = await runDiffOperation({
+    schemas,
+    devUrl: config.database.devUrl,
+    lockFilePath: lockPath,
+    driver: config.database.driver,
+    workDir: rootDir
+  });
+  if (!diffResult.hasChanges && !options.force) {
+    logger.success("No changes to generate");
+    return;
+  }
+  let migrationsGenerated = 0;
+  let typesGenerated = 0;
+  if (!options.typesOnly) {
+    logger.step("Generating Laravel migrations...");
+    const migrationsDir = resolve5(rootDir, config.output.laravel.migrationsPath);
+    if (!existsSync3(migrationsDir)) {
+      mkdirSync2(migrationsDir, { recursive: true });
+      logger.debug(`Created directory: ${migrationsDir}`);
+    }
+    const migrations = generateMigrations(schemas);
+    for (const migration of migrations) {
+      const filePath = resolve5(migrationsDir, migration.fileName);
+      writeFileSync2(filePath, migration.content);
+      logger.debug(`Created: ${migration.fileName}`);
+      migrationsGenerated++;
+    }
+    logger.success(`Generated ${migrationsGenerated} migration(s)`);
+  }
+  if (!options.migrationsOnly) {
+    logger.step("Generating TypeScript types...");
+    const typesDir = resolve5(rootDir, config.output.typescript.path);
+    if (!existsSync3(typesDir)) {
+      mkdirSync2(typesDir, { recursive: true });
+      logger.debug(`Created directory: ${typesDir}`);
+    }
+    const typeFiles = generateTypeScript(schemas, {
+      singleFile: config.output.typescript.singleFile
+    });
+    for (const file of typeFiles) {
+      const filePath = resolve5(typesDir, file.fileName);
+      writeFileSync2(filePath, file.content);
+      logger.debug(`Created: ${file.fileName}`);
+      typesGenerated++;
+    }
+    logger.success(`Generated ${typesGenerated} TypeScript file(s)`);
+  }
+  logger.step("Updating lock file...");
+  await updateLockFile(lockPath, schemas);
+  logger.debug(`Updated: ${config.lockFilePath}`);
+  logger.newline();
+  logger.success("Generation complete!");
+  if (migrationsGenerated > 0) {
+    logger.info(`  Migrations: ${config.output.laravel.migrationsPath}/`);
+  }
+  if (typesGenerated > 0) {
+    logger.info(`  Types: ${config.output.typescript.path}/`);
+  }
+}
+function registerGenerateCommand(program2) {
+  program2.command("generate").description("Generate Laravel migrations and TypeScript types").option("-v, --verbose", "Show detailed output").option("--migrations-only", "Only generate migrations").option("--types-only", "Only generate TypeScript types").option("-f, --force", "Generate even if no changes detected").action(async (options) => {
+    try {
+      await runGenerate(options);
+    } catch (error) {
+      if (error instanceof OmnifyError4) {
+        logger.formatError(error);
+        process.exit(logger.getExitCode(error));
+      } else if (error instanceof Error) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      process.exit(1);
+    }
+  });
+}
+
+// src/index.ts
+var VERSION = "0.0.1";
+var program = new Command();
+program.name("omnify").description("Schema-first database migrations for Laravel and TypeScript").version(VERSION);
+registerInitCommand(program);
+registerValidateCommand(program);
+registerDiffCommand(program);
+registerGenerateCommand(program);
+process.on("uncaughtException", (error) => {
+  if (error instanceof OmnifyError5) {
+    logger.formatError(error);
+    process.exit(logger.getExitCode(error));
+  } else {
+    logger.error(error.message);
+    process.exit(1);
+  }
+});
+process.on("unhandledRejection", (reason) => {
+  if (reason instanceof OmnifyError5) {
+    logger.formatError(reason);
+    process.exit(logger.getExitCode(reason));
+  } else if (reason instanceof Error) {
+    logger.error(reason.message);
+  } else {
+    logger.error(String(reason));
+  }
+  process.exit(1);
+});
+program.parse();
+export {
+  defineConfig,
+  loadConfig
+};
+//# sourceMappingURL=index.js.map