@plyaz/db 0.3.1 → 0.4.0

package/dist/cli/index.js

@@ -8272,6 +8272,74 @@ var JSON_INDENT_SPACES = 2;
 var VERSION_PAD_LENGTH = 3;
 var DECIMAL_RADIX = 10;
 var SEPARATOR_WIDTH = 50;
+var VALID_MIGRATION_TYPES = ["sql", "ts"];
+var VALID_SEED_TYPES = ["ts", "sql", "csv"];
+var MIN_ROLLBACK_STEPS = 1;
+function validateName(name, type) {
+  if (!name || name.trim() === "") {
+    console.error(`❌ ${type} name cannot be empty`);
+    process.exit(1);
+  }
+  if (!/[a-zA-Z]/.test(name)) {
+    console.error(`❌ ${type} name must contain at least one letter`);
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+    console.error(
+      `❌ ${type} name can only contain letters, numbers, underscores, and hyphens`
+    );
+    process.exit(1);
+  }
+}
+__name(validateName, "validateName");
+function validateMigrationType(type) {
+  if (!VALID_MIGRATION_TYPES.includes(type)) {
+    console.warn(
+      `⚠ Invalid type "${type}". Valid options: ${VALID_MIGRATION_TYPES.join(", ")}. Using default: sql`
+    );
+    return "sql";
+  }
+  return type;
+}
+__name(validateMigrationType, "validateMigrationType");
+function validateSeedType(type) {
+  if (!VALID_SEED_TYPES.includes(type)) {
+    console.warn(
+      `⚠ Invalid type "${type}". Valid options: ${VALID_SEED_TYPES.join(", ")}. Using default: ts`
+    );
+    return "ts";
+  }
+  return type;
+}
+__name(validateSeedType, "validateSeedType");
+function validateSteps(stepsStr) {
+  const steps = Number.parseInt(stepsStr, DECIMAL_RADIX);
+  if (Number.isNaN(steps)) {
+    console.error(`❌ Steps must be a number, got: "${stepsStr}"`);
+    process.exit(1);
+  }
+  if (steps < MIN_ROLLBACK_STEPS) {
+    console.error(
+      `❌ Steps must be at least ${MIN_ROLLBACK_STEPS}, got: ${steps}`
+    );
+    process.exit(1);
+  }
+  return steps;
+}
+__name(validateSteps, "validateSteps");
+function validateSchemaName(schema) {
+  if (!schema || schema.trim() === "") {
+    console.error("❌ Schema name cannot be empty");
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schema)) {
+    console.error(
+      "❌ Invalid schema name. Must start with letter or underscore, contain only alphanumeric and underscores"
+    );
+    process.exit(1);
+  }
+}
+__name(validateSchemaName, "validateSchemaName");
 async function getUserSchemas(adapter) {
   const result = await adapter.query?.(`
     SELECT schema_name FROM information_schema.schemata
@@ -8494,16 +8562,15 @@ migrateCommand.command("up").description("Run pending migrations").option("-t, -
 });
 migrateCommand.command("down").description("Rollback migrations").option("-s, --steps <number>", "Number of migrations to rollback", "1").action(async (options) => {
   try {
+    const steps = validateSteps(options.steps);
     const { adapter, config } = await initDatabase(void 0, true);
     const migrationManager = new MigrationManager({
       adapter,
       migrationsPath: config.migrationsPath ?? "./migrations",
       tableName: config.migrationsTable ?? "schema_migrations"
     });
-    console.log(`🔄 Rolling back ${options.steps} migration(s)...`);
-    const result = await migrationManager.down(
-      Number.parseInt(options.steps, 10)
-    );
+    console.log(`🔄 Rolling back ${steps} migration(s)...`);
+    const result = await migrationManager.down(steps);
     if (result.success) {
       console.log(`✅ Rolled back ${result.value} migration(s)`);
       process.exit(0);
@@ -9283,9 +9350,11 @@ async function runInteractiveMigration(config) {
     console.error("❌ Migration name is required");
     process.exit(1);
   }
+  validateName(name, "migration");
   const snakeName = toSnakeCase(name);
   const tableName = await promptInput("Table name", snakeName);
   const schema = await promptInput("Database schema", "public");
+  validateSchemaName(schema);
   const typeChoice = await promptSelect("File type:", [
     "SQL (.sql)",
     "TypeScript (.ts)"
@@ -9309,10 +9378,20 @@ async function runInteractiveMigration(config) {
   const migrationsPath = config.migrationsPath ?? "./migrations";
   if (!fs4.existsSync(migrationsPath)) {
     fs4.mkdirSync(migrationsPath, { recursive: true });
+    console.log(`📁 Created directory: ${migrationsPath}`);
   }
   const version = getNextMigrationVersion(migrationsPath);
   const filename = `${version}_${snakeName}.${type}`;
   const filepath = path4.join(migrationsPath, filename);
+  if (fs4.existsSync(filepath)) {
+    const overwrite = await promptConfirm(
+      `File exists. Overwrite ${filename}?`
+    );
+    if (!overwrite) {
+      console.log("Cancelled.");
+      process.exit(0);
+    }
+  }
   const content = getMigrationTemplate({
     name,
     version,
@@ -9322,7 +9401,21 @@ async function runInteractiveMigration(config) {
     type
   });
   fs4.writeFileSync(filepath, content, "utf-8");
-  console.log(`✅ Created: ${filepath}`);
+  console.log();
+  console.log(`✅ Created migration: ${filename}`);
+  console.log(`   Path: ${filepath}`);
+  console.log(`   Type: ${type.toUpperCase()}`);
+  console.log(`   Table: ${schema}.${tableName}`);
+  if (author) {
+    console.log(`   Author: ${author}`);
+  }
+  console.log("");
+  console.log("📝 Next steps:");
+  console.log(`   1. Edit the migration file to add your schema changes`);
+  console.log(`   2. Run 'plyaz-db migrate up' to apply the migration`);
+  console.log(
+    `   3. Test rollback with 'plyaz-db migrate down' before deploying`
+  );
 }
 __name(runInteractiveMigration, "runInteractiveMigration");
 async function runInteractiveSeed(config) {
@@ -9335,9 +9428,11 @@ async function runInteractiveSeed(config) {
     console.error("❌ Seed name is required");
     process.exit(1);
   }
+  validateName(name, "seed");
   const snakeName = toSnakeCase(name);
   const tableName = await promptInput("Table name", snakeName);
   const schema = await promptInput("Database schema", "public");
+  validateSchemaName(schema);
   const typeChoice = await promptSelect("File type:", [
     "TypeScript (.ts)",
     "SQL (.sql)",
@@ -9370,10 +9465,20 @@ async function runInteractiveSeed(config) {
   const seedsPath = config.seedsPath ?? "./seeds";
   if (!fs4.existsSync(seedsPath)) {
     fs4.mkdirSync(seedsPath, { recursive: true });
+    console.log(`📁 Created directory: ${seedsPath}`);
   }
   const order = getNextSeedOrder(seedsPath);
   const filename = `${order}_${snakeName}.${type}`;
   const filepath = path4.join(seedsPath, filename);
+  if (fs4.existsSync(filepath)) {
+    const overwrite = await promptConfirm(
+      `File exists. Overwrite ${filename}?`
+    );
+    if (!overwrite) {
+      console.log("Cancelled.");
+      process.exit(0);
+    }
+  }
   let content;
   if (type === "csv") {
     content = getCsvSeedTemplate({ name, tableName, schema });
@@ -9388,7 +9493,19 @@ async function runInteractiveSeed(config) {
     });
   }
   fs4.writeFileSync(filepath, content, "utf-8");
-  console.log(`✅ Created: ${filepath}`);
+  console.log();
+  console.log(`✅ Created seed: ${filename}`);
+  console.log(`   Path: ${filepath}`);
+  console.log(`   Type: ${type.toUpperCase()}`);
+  console.log(`   Table: ${schema}.${tableName}`);
+  if (author && type !== "csv") {
+    console.log(`   Author: ${author}`);
+  }
+  console.log("");
+  console.log("📝 Next steps:");
+  console.log(`   1. Edit the seed file to add your data`);
+  console.log(`   2. Run 'plyaz-db seed run' to execute seeds`);
+  console.log(`   3. Use 'plyaz-db seed status' to check seed status`);
 }
 __name(runInteractiveSeed, "runInteractiveSeed");
 function getNextMigrationVersion(migrationsPath) {
@@ -9513,14 +9630,17 @@ ${randomUUID()},Example 2,${(/* @__PURE__ */ new Date()).toISOString()}
 }
 __name(getCsvSeedTemplate, "getCsvSeedTemplate");
 var createCommand = program.command("create").description("Create new migration or seed files");
-createCommand.command("migration").description("Create a new migration file (interactive if no name provided)").argument("[name]", "Migration name (e.g., add_users_table)").option("-t, --type <type>", "File type: sql or ts (default: sql)", "sql").option(
+createCommand.command("migration").description("Create a new migration file (interactive if no name provided)").argument("[name]", "Migration name (e.g., add_users_table)").option("-t, --type <type>", "File type: {sql, ts} (default: sql)", "sql").option(
   "-T, --table <table>",
   "Table name (default: derived from migration name)"
 ).option(
   "-s, --schema <schema>",
   "Database schema (default: public)",
   "public"
-).option("--no-author", "Skip adding git username as author").option("-i, --interactive", "Force interactive mode").action(
+).option("--no-author", "Skip adding git username as author").option("-i, --interactive", "Force interactive mode").option(
+  "-d, --dry-run",
+  "Preview what would be created without writing files"
+).option("-f, --force", "Overwrite existing file if it exists").action(
   async (name, options) => {
     try {
       const config = await loadConfig();
@@ -9528,8 +9648,11 @@ createCommand.command("migration").description("Create a new migration file (int
         await runInteractiveMigration(config);
         process.exit(0);
       }
+      validateName(name, "migration");
+      validateSchemaName(options.schema);
+      const fileType = validateMigrationType(options.type);
       const migrationsPath = config.migrationsPath ?? "./migrations";
-      if (!fs4.existsSync(migrationsPath)) {
+      if (!options.dryRun && !fs4.existsSync(migrationsPath)) {
         fs4.mkdirSync(migrationsPath, { recursive: true });
         console.log(`📁 Created directory: ${migrationsPath}`);
       }
@@ -9538,11 +9661,11 @@ createCommand.command("migration").description("Create a new migration file (int
       const tableName = options.table ?? snakeName;
       const schema = options.schema;
       const author = options.author ? getGitUsername() : "";
-      const extension = options.type === "ts" ? "ts" : "sql";
-      const filename = `${version}_${snakeName}.${extension}`;
+      const filename = `${version}_${snakeName}.${fileType}`;
       const filepath = path4.join(migrationsPath, filename);
-      if (fs4.existsSync(filepath)) {
+      if (fs4.existsSync(filepath) && !options.force) {
         console.error(`❌ File already exists: ${filepath}`);
+        console.error("   Use --force to overwrite");
         process.exit(1);
       }
       const content = getMigrationTemplate({
@@ -9551,12 +9674,27 @@ createCommand.command("migration").description("Create a new migration file (int
         tableName,
         schema,
         author,
-        type: options.type === "ts" ? "ts" : "sql"
+        type: fileType
       });
+      if (options.dryRun) {
+        console.log("🔍 Dry-run mode - no files will be created\n");
+        console.log(`Would create: ${filename}`);
+        console.log(`   Path: ${filepath}`);
+        console.log(`   Type: ${fileType.toUpperCase()}`);
+        console.log(`   Table: ${schema}.${tableName}`);
+        if (author) {
+          console.log(`   Author: ${author}`);
+        }
+        console.log("\n📄 File content preview:");
+        console.log("─".repeat(SEPARATOR_WIDTH));
+        console.log(content);
+        console.log("─".repeat(SEPARATOR_WIDTH));
+        process.exit(0);
+      }
       fs4.writeFileSync(filepath, content, "utf-8");
       console.log(`✅ Created migration: ${filename}`);
       console.log(`   Path: ${filepath}`);
-      console.log(`   Type: ${options.type.toUpperCase()}`);
+      console.log(`   Type: ${fileType.toUpperCase()}`);
       console.log(`   Table: ${schema}.${tableName}`);
       if (author) {
         console.log(`   Author: ${author}`);
@@ -9575,11 +9713,14 @@ createCommand.command("migration").description("Create a new migration file (int
     }
   }
 );
-createCommand.command("seed").description("Create a new seed file (interactive if no name provided)").argument("[name]", "Seed name (e.g., admin_users)").option("-t, --type <type>", "File type: ts, sql, or csv (default: ts)", "ts").option("-T, --table <table>", "Table name (default: derived from seed name)").option(
+createCommand.command("seed").description("Create a new seed file (interactive if no name provided)").argument("[name]", "Seed name (e.g., admin_users)").option("-t, --type <type>", "File type: {ts, sql, csv} (default: ts)", "ts").option("-T, --table <table>", "Table name (default: derived from seed name)").option(
   "-s, --schema <schema>",
   "Database schema (default: public)",
   "public"
-).option("--no-author", "Skip adding git username as author").option("-i, --interactive", "Force interactive mode").action(
+).option("--no-author", "Skip adding git username as author").option("-i, --interactive", "Force interactive mode").option(
+  "-d, --dry-run",
+  "Preview what would be created without writing files"
+).option("-f, --force", "Overwrite existing file if it exists").action(
   async (name, options) => {
     try {
       const config = await loadConfig();
@@ -9587,8 +9728,11 @@ createCommand.command("seed").description("Create a new seed file (interactive i
         await runInteractiveSeed(config);
         process.exit(0);
       }
+      validateName(name, "seed");
+      validateSchemaName(options.schema);
+      const fileType = validateSeedType(options.type);
       const seedsPath = config.seedsPath ?? "./seeds";
-      if (!fs4.existsSync(seedsPath)) {
+      if (!options.dryRun && !fs4.existsSync(seedsPath)) {
         fs4.mkdirSync(seedsPath, { recursive: true });
         console.log(`📁 Created directory: ${seedsPath}`);
       }
@@ -9597,16 +9741,11 @@ createCommand.command("seed").description("Create a new seed file (interactive i
       const tableName = options.table ?? snakeName;
       const schema = options.schema;
       const author = options.author ? getGitUsername() : "";
-      const typeMap = {
-        ts: "ts",
-        sql: "sql",
-        csv: "csv"
-      };
-      const fileType = typeMap[options.type] ?? "ts";
       const filename = `${order}_${snakeName}.${fileType}`;
       const filepath = path4.join(seedsPath, filename);
-      if (fs4.existsSync(filepath)) {
+      if (fs4.existsSync(filepath) && !options.force) {
         console.error(`❌ File already exists: ${filepath}`);
+        console.error("   Use --force to overwrite");
         process.exit(1);
       }
       let content;
@@ -9622,6 +9761,21 @@ createCommand.command("seed").description("Create a new seed file (interactive i
           type: fileType
         });
       }
+      if (options.dryRun) {
+        console.log("🔍 Dry-run mode - no files will be created\n");
+        console.log(`Would create: ${filename}`);
+        console.log(`   Path: ${filepath}`);
+        console.log(`   Type: ${fileType.toUpperCase()}`);
+        console.log(`   Table: ${schema}.${tableName}`);
+        if (author && fileType !== "csv") {
+          console.log(`   Author: ${author}`);
+        }
+        console.log("\n📄 File content preview:");
+        console.log("─".repeat(SEPARATOR_WIDTH));
+        console.log(content);
+        console.log("─".repeat(SEPARATOR_WIDTH));
+        process.exit(0);
+      }
       fs4.writeFileSync(filepath, content, "utf-8");
       console.log(`✅ Created seed: ${filename}`);
       console.log(`   Path: ${filepath}`);