"""
Remote Filesystem Strategy implementation.

Filesystem operations are restricted in REMOTE mode for security.
"""

import logging
from typing import Any, Dict, List

from ...core.context import DSSContext
from ..base import FilesystemStrategy

# Configure module logger
logger = logging.getLogger(__name__)


class RemoteFilesystemStrategy(FilesystemStrategy):
    """
    Implements filesystem operations via remote API calls.

    Note: Direct filesystem access is restricted in REMOTE mode for security.
    Most operations will raise NotImplementedError or return empty results.
    Users should use LOCAL mode for filesystem operations.
    """

    def __init__(self, context: DSSContext):
        """Initialize with context."""
        self.context = context

    async def read_file(self, path: str) -> str:
        """
        Read file contents.

        NOT AVAILABLE in REMOTE mode for security reasons.

        Raises:
            NotImplementedError: Always, as direct file access is restricted.
        """
        logger.error("Filesystem read operations are not available in REMOTE mode.")
        raise NotImplementedError(
            "Direct filesystem access is restricted in REMOTE mode. "
            "Please use LOCAL mode for file operations, or use API-based file uploads."
        )

    async def list_directory(self, path: str) -> List[str]:
        """
        List directory contents.

        NOT AVAILABLE in REMOTE mode for security reasons.

        Raises:
            NotImplementedError: Always, as directory listing is restricted.
        """
        logger.error("Filesystem list operations are not available in REMOTE mode.")
        raise NotImplementedError(
            "Directory listing is restricted in REMOTE mode. "
            "Please use LOCAL mode for filesystem operations."
        )

    async def search_files(self, pattern: str, path: str = ".") -> List[str]:
        """
        Search for files matching a pattern.

        NOT AVAILABLE in REMOTE mode for security reasons.

        Raises:
            NotImplementedError: Always, as file search is restricted.
        """
        logger.error("Filesystem search operations are not available in REMOTE mode.")
        raise NotImplementedError(
            "File search is restricted in REMOTE mode. "
            "Please use LOCAL mode for filesystem operations."
        )

    async def get_file_info(self, path: str) -> Dict[str, Any]:
        """
        Get file metadata.

        NOT AVAILABLE in REMOTE mode for security reasons.

        Raises:
            NotImplementedError: Always, as file info access is restricted.
        """
        logger.error("Filesystem info operations are not available in REMOTE mode.")
        raise NotImplementedError(
            "File metadata access is restricted in REMOTE mode. "
            "Please use LOCAL mode for filesystem operations."
        )