contract

type CompOption[T any] func(*T)

type FSysFileReader interface {
	FSysReadFile(fsys fs.ReadFileFS, path string) ([]byte, error)
}

type Geocoder interface {
	TimezoneFromCoordinates(ctx context.Context, latitude, longitude float64) (string, error)
	CityFromCoordinates(ctx context.Context, latitude, longitude float64) (string, error)
	SwapTimezone(t time.Time, tz string, toUTC, toMidnight bool) (time.Time, error)
	IsUTC(t time.Time) bool
}

type GzipReader interface {
	Read(r io.Reader) (io.Reader, error)
}

type GzipUtil interface {
	WriteGzip(w *gzip.Writer, r io.Reader) error
	CloseGzipWriter(w *gzip.Writer) error
	ReadGzip(r io.Reader) ([]byte, error)
	NewGzipReader(r io.Reader) (*gzip.Reader, error)
	CopyToBuffer(r *gzip.Reader, buf *bytes.Buffer) error
	CloseGzipReader(r *gzip.Reader) error
}

type GzipWriter interface {
	Write(r io.Reader) (io.Reader, int64, error)
}

type HTTPDoer interface {
	Do(ctx context.Context, r *http.Request) (*http.Response, error)
}

type HTTPRequester interface {
	NewRequest(ctx context.Context, method, url string, opts RequestOptions) (*http.Request, error)
}

type HTTPWriter interface {
	Write(w http.ResponseWriter, b []byte) (int, error)
}

type JSONOption func(*JSONOptions)

type JSONOptions struct {
	Indent     string // Enables indentation if non-empty.
	EscapeHTML bool   // Determines if HTML characters should be escaped.
	UseNumber  bool   // If true, decodes numbers as `json.Number` instead of `float64`.
}

type Level = slog.Level

type Logger interface {
	Log(ctx context.Context, l Level, v any, prefix string, msg ...string)
	Wrap(ctx context.Context, fn func() (any, error)) error
}

type MapsAPI interface {
	Timezone(ctx context.Context, r *maps.TimezoneRequest) (*maps.TimezoneResult, error)
	Geocode(ctx context.Context, r *maps.GeocodingRequest) ([]maps.GeocodingResult, error)
}

type Marshaler interface {
	Marshal(v any, opts JSONOptions) ([]byte, error)
}

type MetaOption[T any] func(*T)

type Reader interface {
	Read(io.Reader) ([]byte, error)
}

type RequestOption func(*RequestOptions)

type RequestOptions struct {
	Header http.Header
	Body   io.Reader
}

type Tool[C any] struct {
	Client C
	Logger Logger
}

type ToolOption[C any] func(*ToolOptions[C])

type ToolOptions[C any] struct {
	Logger Logger
}

type Unmarshaler interface {
	Unmarshal(data io.Reader, v any, opts JSONOptions) error
}