#
# Copyright (c) 2024-2026, Daily
#
# SPDX-License-Identifier: BSD 2-Clause License
#

from typing import Any, Dict

# Track which modules we've already warned about
_warned_modules = set()


def _warn_deprecated_access(globals: Dict[str, Any], attr, old: str, new: str):
    # Only warn once per old->new module pair
    module_key = (old, new)
    if module_key not in _warned_modules:
        import warnings

        with warnings.catch_warnings():
            warnings.simplefilter("always")
            warnings.warn(
                f"Module `pipecat.services.{old}` is deprecated, use `pipecat.services.{new}` instead.",
                DeprecationWarning,
                stacklevel=3,
            )
        _warned_modules.add(module_key)

    return globals[attr]


class DeprecatedModuleProxy:
    def __init__(self, globals: Dict[str, Any], old: str, new: str):
        self._globals = globals
        self._old = old
        self._new = new

    def __getattr__(self, attr):
        if attr in self._globals:
            return _warn_deprecated_access(self._globals, attr, self._old, self._new)
        raise AttributeError(f"module 'pipecat.services.{self._old}' has no attribute '{attr}'")