Kind constants for the different MMDB data kinds.

markedString and friends below are named primitive types implementing UnmarshalMaxMindDB with a transform whose output is distinguishable from the raw

ContextualError provides detailed error context with offset and path information. This is only allocated when an error actually occurs, ensuring zero

CustomCity represents a simplified city record with custom unmarshaling. This demonstrates the Unmarshaler interface for custom decoding.

DataDecoder is a decoder for the MMDB data section. This is exported so mmdbdata package can use it, but still internal.

Decoder allows decoding of a single value stored at a specific offset in the database.

DecoderOption configures a Decoder. nolint:revive // name follows existing library pattern (ReaderOption, NetworksOption)

ErrorContextTracker is an optional interface that can be used to track path context for better error messages. Only used when explicitly enabled and o

InvalidDatabaseError is returned when the database contains invalid data and cannot be parsed.

Metadata holds the metadata decoded from the MaxMind DB file. Key fields include: - DatabaseType: indicates the structure of data records (e.g., "Geo

NetworksOption are options for Networks and NetworksWithin.

PathBuilder helps build JSON-pointer-like paths efficiently. Only used when an error occurs, so allocations are acceptable here.

Reader holds the data corresponding to the MaxMind DB file. Its only public field is Metadata, which contains the metadata from the MaxMind DB file.

ReaderOption are options for [Open] and [OpenBytes]. This was added to allow for future options, e.g., for caching, without causing a breaking API ch

ReflectionDecoder is a decoder for the MMDB data section.

Result holds the result of the database lookup.

TestCity represents a simplified city data structure for testing custom unmarshaling.

Test struct that exercises field access patterns

UnmarshalTypeError is returned when the value in the database cannot be assigned to the specified data type.

Unmarshaler is implemented by types that can unmarshal MaxMind DB data. This is used internally for reflection-based decoding.

Unmarshaler is implemented by types that can unmarshal MaxMind DB data. This follows the same pattern as json.Unmarshaler and other Go standard librar

addressableValue wraps a reflect.Value to optimize field access and embedded pointer handling. Based on encoding/json/v2 patterns.

fieldDispatch encodes the decode strategy for a struct field, computed once at struct-cache build time. Encoding the three-way choice as a single enum

mmapCleanup holds the data needed to safely cleanup memory-mapped files.

Internal structure used to keep track of nodes we still need to visit.

stringCache holds two parallel 4096-slot arrays indexed by offset%4096. entries holds admitted strings; recentMisses records the last missing offset s

Inner type with UnmarshalMaxMindDB.

testInnerPointer with UnmarshalMaxMindDB for pointer test.

testItem with UnmarshalMaxMindDB for slice test.

testMapIterator uses ReadMap() iterator to simulate mmdbtype.Map behavior.

testValue with UnmarshalMaxMindDB for map test.