"""
This file contains general utility functions and helpers specifically for API v3.
Refactored 2026-01-07 to move Auth logic to dependencies_v3.py to fix circular dependencies.
"""

import logging
from typing import (
    Any,
    Dict,
    List,
    Optional,
    Union,
)

from fastapi import (
    APIRouter,
    Depends,
    Header,
    HTTPException,
    Query,
    Request,
    Response,
    status,
)
from pydantic import (
    BaseModel,
    Field,
)

# Re-import from the new central auth models
from app.models.auth_models import AccountContext
# Import the dependency functions for backward compatibility in existing v3 routes
from app.routers.dependencies_v3 import (
    get_account_context,
    get_account_context_optional,
    PaginationParams,
    StatusFilterParams,
    SerializationParams,
    DelayParams
)

from app.config import settings
from app.log import get_logger

logger = get_logger(__name__)

# Note: Dependency function implementations have moved to app/routers/dependencies_v3.py