database

type Engine struct {
	// Dialect is the canonical name reported by pw.DBDriver, and the one that
	// selects savepoint, EXPLAIN, and migration behavior. Every scheme of an
	// engine reports the same dialect, so an alias cannot produce a second one.
	Dialect string
	// Schemes are the DSN prefixes that select this engine.
	Schemes []string
	// Open opens the pool for the resolved data source.
	Open OpenFunc
	// OpenNative, when set, opens the pool the request-time query path uses
	// instead of database/sql. Open stays required beside it, because
	// migration and seeding tooling runs on database/sql regardless.
	OpenNative OpenNativeFunc
	// KeepScheme hands Open the whole configured DSN instead of the part after
	// the scheme, for an engine whose DSN is already a URL.
	KeepScheme bool
}

type NativeDB interface {
	NativeExecutor
	BeginTx(ctx context.Context, options NativeTxOptions) (NativeTx, error)
	Ping(ctx context.Context) error
	Close() error
}

type NativeExecutor interface {
	sqlbind.SQLExecutor
	sqlbind.RowsQuerier
}

type NativeTx interface {
	NativeExecutor
	Commit(ctx context.Context) error
	Rollback(ctx context.Context) error
}

type NativeTxOptions struct {
	ReadOnly bool
}

type OpenFunc func(dataSource string) (*sql.DB, error)

type OpenNativeFunc func(ctx context.Context, dataSource string, bounds PoolBounds) (NativeDB, error)

type PoolBounds struct {
	MaxOpenConns int
	// MaxIdleConns exists for symmetry with the sql.DB setter but has no
	// equivalent on a native pool, which prunes idle connections by
	// ConnMaxIdleTime instead. An engine that cannot express it ignores it.
	MaxIdleConns    int
	ConnMaxLifetime time.Duration
	ConnMaxIdleTime time.Duration
}

type Target struct {
	// Dialect is the canonical engine name.
	Dialect string
	// DataSource is the part of the DSN the engine expects.
	DataSource string
	// contains filtered or unexported fields
}