database

type Config struct {
	MaxOpen     int
	MaxIdle     int
	MaxLifetime time.Duration
	MaxIdleTime time.Duration
	Log         *slog.Logger
}

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

type Dialect interface {
	// Name is "sqlite", "postgres" or "mysql".
	Name() string
	// Placeholder returns the n-th (1-based) bind placeholder.
	Placeholder(n int) string
	// Quote quotes an identifier (already validated by callers).
	Quote(ident string) string
}

type Driver struct {
	// SQLName is the database/sql driver name ("pgx").
	SQLName string
	// Dialect is the SQL dialect.
	Dialect Dialect
	// Schemes are the URL schemes the driver accepts ("postgres").
	Schemes []string
	// DSN, when set, turns the URL into the database/sql driver's data
	// source name (MySQL's driver does not take URLs). Its errors must not
	// echo the URL, which may hold a password.
	DSN func(rawURL string) (string, error)
}

type Encrypter interface {
	Seal(plaintext, ad []byte) string
	Open(token string, ad []byte) ([]byte, error)
}

type Executor interface {
	ExecContext(ctx context.Context, query string, args ...any) (sql.Result, error)
	QueryContext(ctx context.Context, query string, args ...any) (*sql.Rows, error)
	QueryRowContext(ctx context.Context, query string, args ...any) *sql.Row
	Dialect() Dialect
}

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

type Option func(*openOptions)

type Query struct {
	// SQL is the statement text as passed by the caller.
	SQL string
	// Args are the bound values; observers must not log or display them
	// (they hold user data and secrets).
	Args []any
	// Duration is the time until the driver returned (for queries: until
	// the rows were ready, not until they were read).
	Duration time.Duration
	// Err is the statement error, if any.
	Err error
}

type QueryObserver interface {
	ObserveQuery(ctx context.Context, q Query)
}

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