database

type Dialect interface {
	// Name is the migration subdir and registry key ("sqlite", ...).
	Name() string
	// Placeholder renders the bind placeholder for the 0-based parameter
	// index ("?" on SQLite/MySQL, "$N" with N=index+1 on PostgreSQL).
	Placeholder(index int) string
	// SupportsReturning reports whether INSERT/UPDATE ... RETURNING works.
	SupportsReturning() bool
	// Upsert renders an insert-or-update statement for the given table,
	// conflict key columns, and value columns. Empty keyColumns fails with
	// ErrEmptyUpsertKeys — every dialect needs a conflict target.
	Upsert(table string, keyColumns, valueColumns []string) (string, error)
	// IsDuplicateError reports whether err is a unique-constraint violation
	// (duplicate key entry) on this driver. Stores map it to domain
	// duplicate sentinels instead of generic persistence errors.
	IsDuplicateError(err error) bool
}

type Driver interface {
	// Name matches DB_DRIVER values ("sqlite", "postgres", "mysql").
	Name() string
	Open(dsn string, opts OpenOptions) (*sql.DB, error)
	Dialect() Dialect
	// MigrationDir is the subdir inside every module's migration FS
	// holding this driver's files.
	MigrationDir() string
}

type DriverRegistry struct {
	// contains filtered or unexported fields
}

type OpenOptions struct {
	MaxOpenConns int
}

type UnknownDriverError struct {
	Name      string
	Installed []string
}