Improve type annotations for Record types and Decoder

Convert RecordList and RecordDict from class-based type definitions to
explicit TypeAlias declarations. These types are only used for type
annotations and were never instantiated as actual classes, so using
TypeAlias makes their purpose more explicit and follows modern Python
typing conventions.

Add explicit type annotation to Decoder._type_decoder ClassVar. This
provides better type checking for the decoder function map by fully
specifying the callable signature.

These are internal changes with no user-visible effects.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: oschwald

maxminddb/decoder.py

@@ -3,14 +3,14 @@
 from __future__ import annotations
 
 import struct
+from collections.abc import Callable
 from typing import TYPE_CHECKING, ClassVar, cast
 
 try:
     import mmap
 except ImportError:
     mmap = None  # type: ignore[assignment]
 
-
 from maxminddb.errors import InvalidDatabaseError
 
 if TYPE_CHECKING:
@@ -118,7 +118,7 @@ def _decode_utf8_string(self, size: int, offset: int) -> tuple[str, int]:
         new_offset = offset + size
         return self._buffer[offset:new_offset].decode("utf-8"), new_offset
 
-    _type_decoder: ClassVar = {
+    _type_decoder: ClassVar[dict[int, Callable[[Decoder, int, int], tuple[Record, int]]]] = {
         1: _decode_pointer,
         2: _decode_utf8_string,
         3: _decode_double,

maxminddb/types.py

@@ -6,13 +6,10 @@
 
 Primitive: TypeAlias = AnyStr | bool | float | int
 
+RecordList: TypeAlias = list["Record"]
+"""RecordList is a type for lists in a database record."""
 
-class RecordList(list["Record"]):
-    """RecordList is a type for lists in a database record."""
-
-
-class RecordDict(dict[str, "Record"]):
-    """RecordDict is a type for dicts in a database record."""
-
+RecordDict: TypeAlias = dict[str, "Record"]
+"""RecordDict is a type for dicts in a database record."""
 
 Record: TypeAlias = Primitive | RecordList | RecordDict