Módulos compartidos
Importa o reexporta estáticamente .js, .ts y .mjs. Los archivos auxiliares no son migraciones independientes.
Importaciones relativas
project/
migrations/V2__normalize.ts
shared/names.tsimport { normalize } from "../shared/names.ts";
export function up(db) {
db.exec("UPDATE users SET name=? WHERE id=?", [normalize(" Alice "), "1"]);
}La ruta parte del archivo importador. Define normalize en shared/names.ts y crea users antes. Consulta el ejemplo completo.
Paquetes npm
Instala desde el lockfile antes de ejecutar migrate. Se admiten exports, subrutas, dependencias anidadas y CommonJS estático, con condiciones neutral, luego module y main. No se admiten API Node, extensiones nativas ni import/require dinámico. migrate no instala paquetes.
Archivos embebidos
FSSource resuelve dentro de fs.FS, incluido embed.FS, con búsqueda de extensión e index. No busca package.json ni node_modules virtuales. Para paquetes, indica un directorio real:
source := migrate.WithModules{
Source: migrate.FSSource{
FS: embeddedFiles,
Root: "migrations",
},
DependencyDir: projectDirectory,
}Los archivos relativos siguen en el sistema virtual. Sin DependencyDir, no se busca en el host. StringSource acepta WithModules con FS/Root o Directory. Las fuentes propias pueden implementar MigrationEntriesSource. Consulta Go.
Reproducibilidad
Solo se verifica el archivo de entrada. Cambiar auxiliares, paquetes o lockfile no causa divergencia ni reejecuta versiones aplicadas. Fija dependencias y preserva el comportamiento histórico. Todas las dependencias del rango se compilan antes de escribir; un error posterior bloquea los primeros pasos.