from __future__ import annotations

from abc import ABC, abstractmethod
from typing import Iterable, Mapping, Any

from .models import ExtractionContext, ProviderRecord


class SourceActivityProvider(ABC):
    """
    كل Adapter فعلي يجب أن يعتمد حصراً على HAR مثبت.

    لا يجوز للـAdapter تخمين Endpoint أو ترتيب أعمدة أو تحويل حالة غير مثبت.
    """

    @abstractmethod
    def iter_records(self, context: ExtractionContext) -> Iterable[ProviderRecord]:
        """Yield records for the exact half-open period [from, to)."""
        raise NotImplementedError

    def result_metadata(self) -> Mapping[str, Any]:
        return {}
