encodings

type Builder interface {
	Bool() TypeCodec
	Int8() TypeCodec
	Int16() TypeCodec
	Int32() TypeCodec
	Int64() TypeCodec
	Uint8() TypeCodec
	Uint16() TypeCodec
	Uint32() TypeCodec
	Uint64() TypeCodec
	String(maxLen uint) (TypeCodec, error)
	Float32() TypeCodec
	Float64() TypeCodec
	OracleID() TypeCodec
	Int(bytes uint) (TypeCodec, error)
	Uint(bytes uint) (TypeCodec, error)
	BigInt(bytes uint, signed bool) (TypeCodec, error)
}

type CodecFromTypeCodec map[string]TypeCodec

type Empty struct{}

type LenientCodecFromTypeCodec map[string]TypeCodec

type NamedTypeCodec struct {
	Name  string
	Codec TypeCodec
}

type NotNilPointer struct {
	Elm TypeCodec
}

type StructTypeCodec interface {
	TypeCodec
	FieldCodec(string) (TypeCodec, error)
}

type TopLevelCodec interface {
	TypeCodec
	SizeAtTopLevel(numItems int) (int, error)
}

type TypeCodec interface {
	Encode(value any, into []byte) ([]byte, error)
	Decode(encoded []byte) (any, []byte, error)
	GetType() reflect.Type

	// Size returns the size of the encoded value in bytes if there are N reports.
	// As such, any nested elements should be called with FixedSize to determine their size, unless it's implicit how
	// how many nested items there will be.
	// As an example, a struct { A: []int } should return the size of numItems ints, but a struct { A: [][]int }
	// should return an error, as each report could have a different number of elements in their slice.
	Size(numItems int) (int, error)

	// FixedSize returns the size of the encoded value, without providing a count of elements.
	// If a count of elements is required to know the size, an error must be returned.
	FixedSize() (int, error)
}