sql

type DB interface {
	// Begin starts a transaction. The default isolation level is dependent on
	// the driver.
	//
	// Begin uses [context.Background] internally; to specify the context, use
	// [DB.BeginTx].
	Begin() (*sql.Tx, error)
	// BeginTx starts a transaction.
	//
	// The provided context is used until the transaction is committed or rolled back.
	// If the context is canceled, the sql package will roll back
	// the transaction. [sql.Tx.Commit] will return an error if the context provided to
	// BeginTx is canceled.
	//
	// The provided [sql.TxOptions] is optional and may be nil if defaults should be used.
	// If a non-default isolation level is used that the driver doesn't support,
	// an error will be returned.
	BeginTx(ctx context.Context, opts *sql.TxOptions) (*sql.Tx, error)
	// QueryContext executes a query that returns rows, typically a SELECT.
	// The args are for any placeholder parameters in the query.
	QueryContext(ctx context.Context, query string, args ...interface{}) (*sql.Rows, error)
	// QueryRowContext executes a query that is expected to return at most one row.
	// QueryRowContext always returns a non-nil value. Errors are deferred until
	// [sql.Row]'s Scan method is called.
	// If the query selects no rows, the [*sql.Row.Scan] will return [sql.ErrNoRows].
	// Otherwise, [*sql.Row.Scan] scans the first selected row and discards
	// the rest.
	QueryRowContext(ctx context.Context, query string, args ...interface{}) *sql.Row
	// ExecContext executes a query without returning any rows.
	// The args are for any placeholder parameters in the query.
	ExecContext(ctx context.Context, query string, args ...interface{}) (sql.Result, error)
	// PrepareContext creates a prepared statement for later queries or executions.
	// Multiple queries or executions may be run concurrently from the
	// returned statement.
	// The caller must call the statement's [*sql.Stmt.Close] method
	// when the statement is no longer needed.
	//
	// The provided context is used for the preparation of the statement, not for the
	// execution of the statement.
	PrepareContext(ctx context.Context, query string) (*sql.Stmt, error)
}

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

type DBLoggerOption func(*dbLoggerOptions)

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

type Transaction struct {
	Parent *sql.Tx
}

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