fn_registry/functions/infra/migration_validate.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
migration_validate	function	go	infra	1.0.0	pure	func MigrationValidate(migrations []Migration) []string	Verifica que una secuencia de migraciones sea valida: versiones secuenciales sin huecos comenzando en 1, sin duplicados, con up_sql y nombre no vacios. Retorna lista de errores (vacia si todo OK).	migration database sql schema sqlite validate		migration_go_infra		false		fmt sort	name desc migrations slice de Migration a validar, puede estar desordenado	slice de strings con mensajes de error; slice vacio si todas las migraciones son validas	true	secuencia valida retorna sin errores secuencia vacia retorna sin errores version duplicada reporta error hueco en versiones reporta version faltante up_sql vacio reporta error nombre vacio reporta error versiones que no empiezan en 1 reportan error multiple errores se reportan todos	functions/infra/migration_validate_test.go	functions/infra/migration_validate.go

Ejemplo

migrations := []Migration{
    {Version: 1, Name: "create_users", UpSQL: "CREATE TABLE users (...);", DownSQL: "DROP TABLE users;"},
    {Version: 3, Name: "add_roles",    UpSQL: "CREATE TABLE roles (...);", DownSQL: "DROP TABLE roles;"},
}
errs := MigrationValidate(migrations)
// errs = ["gap in versions: missing 2 (have 1 then 3)"]

valid := []Migration{
    {Version: 1, Name: "create_users", UpSQL: "CREATE TABLE users (id TEXT PRIMARY KEY);"},
    {Version: 2, Name: "add_email",    UpSQL: "ALTER TABLE users ADD COLUMN email TEXT;"},
}
errs = MigrationValidate(valid)
// errs = []  (empty — no errors)

Notas

Funcion pura — no hace I/O, no modifica el slice de entrada. Ordena internamente una copia para detectar huecos. Todos los errores encontrados se acumulan y retornan juntos (no falla al primer error). Util antes de llamar a MigrationUp para detectar problemas de forma anticipada.