sqlspec 0.47.0__cp314-cp314-win_amd64.whl

sqlspec/adapters/aiosqlite/config.py

@@ -0,0 +1,315 @@
+"""Aiosqlite database configuration."""
+
+import uuid
+from typing import TYPE_CHECKING, Any, ClassVar, TypedDict, cast
+
+from mypy_extensions import mypyc_attr
+from typing_extensions import NotRequired
+
+from sqlspec.adapters.aiosqlite._typing import AiosqliteConnection, AiosqliteCursor, AiosqliteSessionContext
+from sqlspec.adapters.aiosqlite.core import apply_driver_features, build_connection_config, default_statement_config
+from sqlspec.adapters.aiosqlite.driver import AiosqliteDriver, AiosqliteExceptionHandler
+from sqlspec.adapters.aiosqlite.pool import (
+    AiosqliteConnectionPool,
+    AiosqlitePoolConnection,
+    AiosqlitePoolConnectionContext,
+)
+from sqlspec.adapters.sqlite.type_converter import register_type_handlers
+from sqlspec.config import AsyncDatabaseConfig, ExtensionConfigs
+from sqlspec.driver._async import AsyncPoolConnectionContext, AsyncPoolSessionFactory
+from sqlspec.utils.config_tools import normalize_connection_config
+from sqlspec.utils.logging import get_logger
+
+if TYPE_CHECKING:
+    from collections.abc import Awaitable, Callable
+    from types import TracebackType
+
+    from sqlspec.core import StatementConfig
+    from sqlspec.observability import ObservabilityConfig
+
+__all__ = ("AiosqliteConfig", "AiosqliteConnectionParams", "AiosqliteDriverFeatures", "AiosqlitePoolParams")
+
+logger = get_logger("sqlspec.adapters.aiosqlite")
+
+
+class AiosqliteConnectionParams(TypedDict):
+    """TypedDict for aiosqlite connection parameters."""
+
+    database: NotRequired[str]
+    timeout: NotRequired[float]
+    detect_types: NotRequired[int]
+    isolation_level: NotRequired[str | None]
+    check_same_thread: NotRequired[bool]
+    cached_statements: NotRequired[int]
+    uri: NotRequired[bool]
+
+
+class AiosqlitePoolParams(AiosqliteConnectionParams):
+    """TypedDict for aiosqlite pool parameters, inheriting connection parameters."""
+
+    pool_size: NotRequired[int]
+    connect_timeout: NotRequired[float]
+    idle_timeout: NotRequired[float]
+    operation_timeout: NotRequired[float]
+    extra: NotRequired["dict[str, Any]"]
+
+
+class AiosqliteDriverFeatures(TypedDict):
+    """Aiosqlite driver feature configuration.
+
+    Controls optional type handling and serialization features for SQLite connections.
+
+    enable_custom_adapters: Enable custom type adapters for JSON/UUID/datetime conversion.
+        Defaults to True for enhanced Python type support.
+        Set to False only if you need pure SQLite behavior without type conversions.
+    json_serializer: Custom JSON serializer function.
+        Defaults to sqlspec.utils.serializers.to_json.
+    json_deserializer: Custom JSON deserializer function.
+        Defaults to sqlspec.utils.serializers.from_json.
+    on_connection_create: Async callback executed when a connection is created.
+        Receives the raw aiosqlite connection for low-level driver configuration.
+        Runs after internal setup (PRAGMA optimizations).
+    enable_events: Enable database event channel support.
+        Defaults to True when extension_config["events"] is configured.
+        Provides pub/sub capabilities via table-backed queue (SQLite has no native pub/sub).
+        Requires extension_config["events"] for migration setup.
+    events_backend: Event channel backend selection.
+        Only option: "table_queue" (durable table-backed queue with retries and exactly-once delivery).
+        SQLite does not have native pub/sub, so table_queue is the only backend.
+        Defaults to "table_queue".
+    """
+
+    enable_custom_adapters: NotRequired[bool]
+    json_serializer: "NotRequired[Callable[[Any], str]]"
+    json_deserializer: "NotRequired[Callable[[str], Any]]"
+    on_connection_create: "NotRequired[Callable[[AiosqliteConnection], Awaitable[None]]]"
+    enable_events: NotRequired[bool]
+    events_backend: NotRequired[str]
+
+
+class _AiosqliteSessionFactory(AsyncPoolSessionFactory):
+    __slots__ = ("_pool_conn",)
+
+    def __init__(self, config: "AiosqliteConfig") -> None:
+        super().__init__(config)
+        self._pool_conn: AiosqlitePoolConnection | None = None
+
+    async def acquire_connection(self) -> "AiosqliteConnection":
+        pool = self._config.connection_instance
+        if pool is None:
+            pool = await self._config.create_pool()
+            self._config.connection_instance = pool
+        pool_conn = await pool.acquire()
+        self._pool_conn = pool_conn
+        return cast("AiosqliteConnection", pool_conn.connection)
+
+    async def release_connection(self, _conn: "AiosqliteConnection", **kwargs: Any) -> None:
+        if self._pool_conn is not None and self._config.connection_instance is not None:
+            await self._config.connection_instance.release(self._pool_conn)
+            self._pool_conn = None
+
+
+class AiosqliteConnectionContext(AsyncPoolConnectionContext):
+    """Async context manager for AioSQLite connections."""
+
+    __slots__ = ("_ctx",)
+
+    def __init__(self, config: "AiosqliteConfig") -> None:
+        super().__init__(config)
+        self._ctx: AiosqlitePoolConnectionContext | None = None
+
+    async def __aenter__(self) -> AiosqliteConnection:
+        pool = self._config.connection_instance
+        if pool is None:
+            pool = await self._config.create_pool()
+            self._config.connection_instance = pool
+        self._ctx = pool.get_connection()
+        assert self._ctx is not None
+        return cast("AiosqliteConnection", await self._ctx.__aenter__())
+
+    async def __aexit__(
+        self, exc_type: "type[BaseException] | None", exc_val: "BaseException | None", exc_tb: "TracebackType | None"
+    ) -> bool | None:
+        if self._ctx:
+            return await self._ctx.__aexit__(exc_type, exc_val, exc_tb)
+        return None
+
+
+@mypyc_attr(native_class=False)
+class AiosqliteConfig(AsyncDatabaseConfig["AiosqliteConnection", AiosqliteConnectionPool, AiosqliteDriver]):
+    """Database configuration for AioSQLite engine.
+
+    Example::
+
+        config = AiosqliteConfig(
+            connection_config=AiosqlitePoolParams(database="app.db")
+        )
+    """
+
+    driver_type: "ClassVar[type[AiosqliteDriver]]" = AiosqliteDriver
+    connection_type: "ClassVar[type[AiosqliteConnection]]" = AiosqliteConnection
+    supports_transactional_ddl: "ClassVar[bool]" = True
+    supports_native_arrow_export: "ClassVar[bool]" = True
+    supports_native_arrow_import: "ClassVar[bool]" = True
+    supports_native_parquet_export: "ClassVar[bool]" = True
+    supports_native_parquet_import: "ClassVar[bool]" = True
+    _connection_context_class: "ClassVar[type[AiosqliteConnectionContext]]" = AiosqliteConnectionContext
+    _session_factory_class: "ClassVar[type[_AiosqliteSessionFactory]]" = _AiosqliteSessionFactory
+    _session_context_class: "ClassVar[type[AiosqliteSessionContext]]" = AiosqliteSessionContext
+    _default_statement_config = default_statement_config
+
+    def __init__(
+        self,
+        *,
+        connection_config: "AiosqlitePoolParams | dict[str, Any] | None" = None,
+        connection_instance: "AiosqliteConnectionPool | None" = None,
+        migration_config: "dict[str, Any] | None" = None,
+        statement_config: "StatementConfig | None" = None,
+        driver_features: "AiosqliteDriverFeatures | dict[str, Any] | None" = None,
+        bind_key: "str | None" = None,
+        extension_config: "ExtensionConfigs | None" = None,
+        observability_config: "ObservabilityConfig | None" = None,
+        **kwargs: Any,
+    ) -> None:
+        """Initialize AioSQLite configuration.
+
+        Args:
+            connection_config: Connection and pool configuration parameters (TypedDict or dict)
+            connection_instance: Optional pre-configured connection pool instance.
+            migration_config: Optional migration configuration.
+            statement_config: Optional statement configuration.
+            driver_features: Optional driver feature configuration.
+            bind_key: Optional unique identifier for this configuration.
+            extension_config: Extension-specific configuration (e.g., Litestar plugin settings)
+            observability_config: Adapter-level observability overrides for lifecycle hooks and observers
+            **kwargs: Additional keyword arguments passed to the base configuration.
+
+        """
+        config_dict: dict[str, Any] = dict(connection_config) if connection_config else {}
+
+        if "database" not in config_dict or config_dict["database"] == ":memory:":
+            config_dict["database"] = f"file:memory_{uuid.uuid4().hex}?mode=memory&cache=shared"
+            config_dict["uri"] = True
+        elif "database" in config_dict:
+            database_path = str(config_dict["database"])
+            if database_path.startswith("file:") and not config_dict.get("uri"):
+                logger.debug(
+                    "Database URI detected (%s) but uri=True not set. "
+                    "Auto-enabling URI mode to prevent physical file creation.",
+                    database_path,
+                )
+                config_dict["uri"] = True
+
+        config_dict = normalize_connection_config(config_dict)
+
+        statement_config = statement_config or default_statement_config
+        statement_config, driver_features = apply_driver_features(statement_config, driver_features)
+
+        # Extract user connection hook before storing driver_features
+        features_dict = dict(driver_features) if driver_features else {}
+        self._user_connection_hook: Callable[[AiosqliteConnection], Awaitable[None]] | None = features_dict.pop(
+            "on_connection_create", None
+        )
+
+        super().__init__(
+            connection_config=config_dict,
+            connection_instance=connection_instance,
+            migration_config=migration_config,
+            statement_config=statement_config,
+            driver_features=features_dict,
+            bind_key=bind_key,
+            extension_config=extension_config,
+            observability_config=observability_config,
+            **kwargs,
+        )
+
+    async def _create_pool(self) -> AiosqliteConnectionPool:
+        """Create the connection pool instance.
+
+        Returns:
+            AiosqliteConnectionPool: The connection pool instance.
+
+        """
+        config = {k: v for k, v in self.connection_config.items() if v is not None}
+        pool_size = config.pop("pool_size", 5)
+        connect_timeout = config.pop("connect_timeout", 30.0)
+        idle_timeout = config.pop("idle_timeout", 24 * 60 * 60)
+        operation_timeout = config.pop("operation_timeout", 10.0)
+
+        pool = AiosqliteConnectionPool(
+            connection_parameters=build_connection_config(self.connection_config),
+            pool_size=pool_size,
+            connect_timeout=connect_timeout,
+            idle_timeout=idle_timeout,
+            operation_timeout=operation_timeout,
+            on_connection_create=self._user_connection_hook,
+        )
+
+        if self.driver_features.get("enable_custom_adapters", False):
+            self._register_type_adapters()
+
+        return pool
+
+    def _register_type_adapters(self) -> None:
+        """Register custom type adapters and converters for SQLite.
+
+        Called once during pool creation if enable_custom_adapters is True.
+        Registers JSON serialization handlers if configured.
+        """
+        if self.driver_features.get("enable_custom_adapters", False):
+            register_type_handlers(
+                json_serializer=self.driver_features.get("json_serializer"),
+                json_deserializer=self.driver_features.get("json_deserializer"),
+            )
+
+    def get_signature_namespace(self) -> "dict[str, Any]":
+        """Get the signature namespace for AiosqliteConfig types.
+
+        Returns:
+            Dictionary mapping type names to types.
+        """
+        namespace = super().get_signature_namespace()
+        namespace.update({
+            "AiosqliteConnectionContext": AiosqliteConnectionContext,
+            "AiosqliteConnection": AiosqliteConnection,
+            "AiosqliteConnectionParams": AiosqliteConnectionParams,
+            "AiosqliteConnectionPool": AiosqliteConnectionPool,
+            "AiosqliteCursor": AiosqliteCursor,
+            "AiosqliteDriver": AiosqliteDriver,
+            "AiosqliteDriverFeatures": AiosqliteDriverFeatures,
+            "AiosqliteExceptionHandler": AiosqliteExceptionHandler,
+            "AiosqlitePoolParams": AiosqlitePoolParams,
+            "AiosqliteSessionContext": AiosqliteSessionContext,
+        })
+        return namespace
+
+    async def create_connection(self) -> "AiosqliteConnection":
+        """Create a single async connection from the pool.
+
+        Returns:
+            An aiosqlite connection instance.
+
+        """
+        pool = self.connection_instance
+        if pool is None:
+            pool = await self.create_pool()
+            self.connection_instance = pool
+        pool_connection = await pool.acquire()
+        return pool_connection.connection
+
+    async def provide_pool(self) -> AiosqliteConnectionPool:
+        """Provide async pool instance.
+
+        Returns:
+            The async connection pool.
+
+        """
+        if not self.connection_instance:
+            self.connection_instance = await self.create_pool()
+        return self.connection_instance
+
+    async def _close_pool(self) -> None:
+        """Close the connection pool."""
+        if self.connection_instance and not self.connection_instance.is_closed:
+            await self.connection_instance.close()
+            self.connection_instance = None

sqlspec/adapters/aiosqlite/core.py

@@ -0,0 +1,315 @@
+"""AIOSQLite adapter compiled helpers."""
+
+from datetime import date, datetime
+from decimal import Decimal
+from typing import TYPE_CHECKING, Any, cast
+
+from sqlspec.core import DriverParameterProfile, ParameterStyle, StatementConfig, build_statement_config_from_profile
+from sqlspec.exceptions import (
+    CheckViolationError,
+    DatabaseConnectionError,
+    DataError,
+    ForeignKeyViolationError,
+    IntegrityError,
+    NotNullViolationError,
+    OperationalError,
+    SQLParsingError,
+    SQLSpecError,
+    UniqueViolationError,
+)
+from sqlspec.utils.serializers import from_json, to_json
+from sqlspec.utils.type_converters import build_decimal_converter, build_time_iso_converter, build_uuid_coercions
+from sqlspec.utils.type_guards import has_rowcount, has_sqlite_error
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Iterable, Mapping, Sequence
+
+__all__ = (
+    "apply_driver_features",
+    "build_connection_config",
+    "build_insert_statement",
+    "build_profile",
+    "build_statement_config",
+    "collect_rows",
+    "create_mapped_exception",
+    "default_statement_config",
+    "driver_profile",
+    "format_identifier",
+    "normalize_execute_many_parameters",
+    "normalize_execute_parameters",
+    "resolve_rowcount",
+)
+
+
+_TIME_TO_ISO = build_time_iso_converter()
+_DECIMAL_TO_STRING = build_decimal_converter(mode="string")
+
+SQLITE_CONSTRAINT_UNIQUE_CODE = 2067
+SQLITE_CONSTRAINT_FOREIGNKEY_CODE = 787
+SQLITE_CONSTRAINT_NOTNULL_CODE = 1811
+SQLITE_CONSTRAINT_CHECK_CODE = 531
+SQLITE_CONSTRAINT_CODE = 19
+SQLITE_CANTOPEN_CODE = 14
+SQLITE_IOERR_CODE = 10
+SQLITE_MISMATCH_CODE = 20
+
+
+def _bool_to_int(value: bool) -> int:
+    return int(value)
+
+
+def _quote_sqlite_identifier(identifier: str) -> str:
+    normalized = identifier.replace('"', '""')
+    return f'"{normalized}"'
+
+
+def format_identifier(identifier: str) -> str:
+    cleaned = identifier.strip()
+    if not cleaned:
+        msg = "Table name must not be empty"
+        raise SQLSpecError(msg)
+    parts = [part for part in cleaned.split(".") if part]
+    formatted = ".".join(_quote_sqlite_identifier(part) for part in parts)
+    return formatted or _quote_sqlite_identifier(cleaned)
+
+
+def build_insert_statement(table: str, columns: "list[str]") -> str:
+    column_clause = ", ".join(_quote_sqlite_identifier(column) for column in columns)
+    placeholders = ", ".join("?" for _ in columns)
+    return f"INSERT INTO {format_identifier(table)} ({column_clause}) VALUES ({placeholders})"
+
+
+def collect_rows(
+    fetched_data: "Iterable[Any]", description: "Sequence[Any] | None"
+) -> "tuple[list[Any], list[str], int]":
+    """Collect aiosqlite result rows as raw tuples.
+
+    Returns raw driver-native rows without dict conversion for lazy materialization.
+
+    Args:
+        fetched_data: Raw rows from cursor.fetchall()
+        description: Cursor description (tuple of tuples)
+
+    Returns:
+        Tuple of (data, column_names, row_count)
+    """
+    if not description:
+        return [], [], 0
+
+    column_names = [col[0] for col in description]
+    data = list(fetched_data)
+    return data, column_names, len(data)
+
+
+def resolve_rowcount(cursor: Any) -> int:
+    """Resolve rowcount from an aiosqlite cursor.
+
+    Args:
+        cursor: Aiosqlite cursor with optional rowcount metadata.
+
+    Returns:
+        Positive rowcount value or 0 when unknown.
+    """
+    if not has_rowcount(cursor):
+        return 0
+    rowcount = cursor.rowcount
+    if isinstance(rowcount, int) and rowcount > 0:
+        return rowcount
+    return 0
+
+
+def normalize_execute_parameters(parameters: Any) -> Any:
+    """Normalize parameters for SQLite execute calls.
+
+    Args:
+        parameters: Prepared parameters payload.
+
+    Returns:
+        Normalized parameters payload.
+    """
+    return parameters or ()
+
+
+def normalize_execute_many_parameters(parameters: Any) -> Any:
+    """Normalize parameters for SQLite executemany calls.
+
+    Args:
+        parameters: Prepared parameters payload.
+
+    Returns:
+        Normalized parameters payload.
+
+    Raises:
+        ValueError: When parameters are missing for executemany.
+    """
+    if not parameters:
+        msg = "execute_many requires parameters"
+        raise ValueError(msg)
+    return parameters
+
+
+def build_connection_config(connection_config: "Mapping[str, Any]") -> "dict[str, Any]":
+    """Build connection configuration for pool creation.
+
+    Args:
+        connection_config: Raw connection configuration mapping.
+
+    Returns:
+        Dictionary with connection parameters.
+    """
+    excluded_keys = {
+        "pool_size",
+        "connect_timeout",
+        "idle_timeout",
+        "operation_timeout",
+        "extra",
+        "pool_min_size",
+        "pool_max_size",
+        "pool_timeout",
+        "pool_recycle_seconds",
+    }
+    return {key: value for key, value in connection_config.items() if key not in excluded_keys}
+
+
+def _create_aiosqlite_error(
+    error: Any, code: "int | None", error_class: type[SQLSpecError], description: str
+) -> SQLSpecError:
+    """Create a SQLSpec exception from an aiosqlite error.
+
+    Args:
+        error: The original aiosqlite exception
+        code: SQLite extended error code
+        error_class: The SQLSpec exception class to instantiate
+        description: Human-readable description of the error type
+
+    Returns:
+        A new SQLSpec exception instance with the original as its cause
+    """
+    code_str = f"[code {code}]" if code else ""
+    msg = f"AIOSQLite {description} {code_str}: {error}" if code_str else f"AIOSQLite {description}: {error}"
+    exc = error_class(msg)
+    exc.__cause__ = cast("BaseException", error)
+    return exc
+
+
+def create_mapped_exception(error: BaseException) -> SQLSpecError:
+    """Map aiosqlite exceptions to SQLSpec exceptions.
+
+    This is a factory function that returns an exception instance rather than
+    raising. This pattern is more robust for use in __aexit__ handlers and
+    avoids issues with exception control flow in different Python versions.
+
+    Args:
+        error: The aiosqlite exception to map
+
+    Returns:
+        A SQLSpec exception that wraps the original error
+    """
+    if has_sqlite_error(error):
+        error_code = error.sqlite_errorcode
+        error_name = error.sqlite_errorname
+    else:
+        error_code = None
+        error_name = None
+    error_msg = str(error).lower()
+
+    if "locked" in error_msg:
+        msg = f"AIOSQLite database locked: {error}. Consider enabling WAL mode or reducing concurrency."
+        exc = SQLSpecError(msg)
+        exc.__cause__ = error  # pyright: ignore[reportAttributeAccessIssue]
+        return exc
+
+    if not error_code:
+        if "unique constraint" in error_msg:
+            return _create_aiosqlite_error(error, 0, UniqueViolationError, "unique constraint violation")
+        if "foreign key constraint" in error_msg:
+            return _create_aiosqlite_error(error, 0, ForeignKeyViolationError, "foreign key constraint violation")
+        if "not null constraint" in error_msg:
+            return _create_aiosqlite_error(error, 0, NotNullViolationError, "not-null constraint violation")
+        if "check constraint" in error_msg:
+            return _create_aiosqlite_error(error, 0, CheckViolationError, "check constraint violation")
+        if "syntax" in error_msg:
+            return _create_aiosqlite_error(error, None, SQLParsingError, "SQL syntax error")
+        return _create_aiosqlite_error(error, None, SQLSpecError, "database error")
+
+    if error_code == SQLITE_CONSTRAINT_UNIQUE_CODE or error_name == "SQLITE_CONSTRAINT_UNIQUE":
+        return _create_aiosqlite_error(error, error_code, UniqueViolationError, "unique constraint violation")
+    if error_code == SQLITE_CONSTRAINT_FOREIGNKEY_CODE or error_name == "SQLITE_CONSTRAINT_FOREIGNKEY":
+        return _create_aiosqlite_error(error, error_code, ForeignKeyViolationError, "foreign key constraint violation")
+    if error_code == SQLITE_CONSTRAINT_NOTNULL_CODE or error_name == "SQLITE_CONSTRAINT_NOTNULL":
+        return _create_aiosqlite_error(error, error_code, NotNullViolationError, "not-null constraint violation")
+    if error_code == SQLITE_CONSTRAINT_CHECK_CODE or error_name == "SQLITE_CONSTRAINT_CHECK":
+        return _create_aiosqlite_error(error, error_code, CheckViolationError, "check constraint violation")
+    if error_code == SQLITE_CONSTRAINT_CODE or error_name == "SQLITE_CONSTRAINT":
+        return _create_aiosqlite_error(error, error_code, IntegrityError, "integrity constraint violation")
+    if error_code == SQLITE_CANTOPEN_CODE or error_name == "SQLITE_CANTOPEN":
+        return _create_aiosqlite_error(error, error_code, DatabaseConnectionError, "connection error")
+    if error_code == SQLITE_IOERR_CODE or error_name == "SQLITE_IOERR":
+        return _create_aiosqlite_error(error, error_code, OperationalError, "operational error")
+    if error_code == SQLITE_MISMATCH_CODE or error_name == "SQLITE_MISMATCH":
+        return _create_aiosqlite_error(error, error_code, DataError, "data error")
+    if error_code == 1 or "syntax" in error_msg:
+        return _create_aiosqlite_error(error, error_code, SQLParsingError, "SQL syntax error")
+    return _create_aiosqlite_error(error, error_code, SQLSpecError, "database error")
+
+
+def build_profile() -> "DriverParameterProfile":
+    """Create the AIOSQLite driver parameter profile."""
+
+    return DriverParameterProfile(
+        name="AIOSQLite",
+        default_style=ParameterStyle.QMARK,
+        supported_styles={ParameterStyle.QMARK},
+        default_execution_style=ParameterStyle.QMARK,
+        supported_execution_styles={ParameterStyle.QMARK},
+        has_native_list_expansion=False,
+        preserve_parameter_format=True,
+        needs_static_script_compilation=False,
+        allow_mixed_parameter_styles=False,
+        preserve_original_params_for_many=False,
+        json_serializer_strategy="helper",
+        custom_type_coercions={
+            bool: _bool_to_int,
+            datetime: _TIME_TO_ISO,
+            date: _TIME_TO_ISO,
+            Decimal: _DECIMAL_TO_STRING,
+            **build_uuid_coercions(),
+        },
+        default_dialect="sqlite",
+    )
+
+
+driver_profile = build_profile()
+
+
+def build_statement_config(
+    *, json_serializer: "Callable[[Any], str] | None" = None, json_deserializer: "Callable[[str], Any] | None" = None
+) -> "StatementConfig":
+    """Construct the AIOSQLite statement configuration with optional JSON codecs."""
+    serializer = json_serializer or to_json
+    deserializer = json_deserializer or from_json
+    profile = driver_profile
+    return build_statement_config_from_profile(
+        profile, statement_overrides={"dialect": "sqlite"}, json_serializer=serializer, json_deserializer=deserializer
+    )
+
+
+default_statement_config = build_statement_config()
+
+
+def apply_driver_features(
+    statement_config: "StatementConfig", driver_features: "Mapping[str, Any] | None"
+) -> "tuple[StatementConfig, dict[str, Any]]":
+    """Apply AIOSQLite driver feature defaults to statement config."""
+    features: dict[str, Any] = dict(driver_features) if driver_features else {}
+    features.setdefault("enable_custom_adapters", True)
+    json_serializer = features.setdefault("json_serializer", to_json)
+    json_deserializer = features.setdefault("json_deserializer", from_json)
+
+    if json_serializer is not None:
+        parameter_config = statement_config.parameter_config.with_json_serializers(
+            json_serializer, deserializer=json_deserializer
+        )
+        statement_config = statement_config.replace(parameter_config=parameter_config)
+
+    return statement_config, features