migrator

type ChecksumMismatchError struct {
	Version int64
	Name    string
	Have    string
	Want    string
}

type Migration struct {
	Version  int64
	Name     string
	Dir      string // "up" or "down"
	File     string
	SQL      string
	Checksum string
}

type Options struct {
	// MigrationsDir is kept for backward compatibility. If non-empty,
	// it will be appended to MigrationsDirs.
	MigrationsDir string
	// MigrationsDirs allows loading migrations from multiple directories.
	// Directories are processed in order and duplicate version+direction
	// pairs are rejected when loading.
	MigrationsDirs []string
	// EmbeddedFSs allows loading migrations from multiple embedded
	// filesystems. Each is expected to contain a "migrations" directory.
	// Embedded filesystems are appended after explicit directories.
	EmbeddedFSs []fs.FS
	TableName   string
	LockKey     int64
	// LockTimeout bounds advisory lock acquisition. Zero keeps the default
	// 10 minute timeout used by earlier versions.
	LockTimeout time.Duration
	// AllowDangerousDown enables Down(); keep disabled in API binaries.
	AllowDangerousDown bool
	// Logger outputs formatted status messages.
	Logger func(format string, args ...any)
	// UnlockFailureHandler observes advisory unlock failures without changing
	// the primary migration result.
	UnlockFailureHandler func(error)
}

type Runner struct {
	DB   *sql.DB
	Opts Options
	// contains filtered or unexported fields
}

type UncertainMigrationError struct {
	Version   int64
	Name      string
	TableName string
	Err       error
}

type UnresolvedMigrationStateError struct {
	Version   int64
	Name      string
	State     string
	TableName string
}