from __future__ import annotations

from abc import ABC, abstractmethod

from dataclasses import dataclass, field

from app.services.normalize import RawRead

@dataclass

class ParseResult:

    headers: list[str]

    rows: list[RawRead] = field(default_factory=list)

    errors: list[str] = field(default_factory=list)

class BaseParser(ABC):

    """Every parser turns raw bytes into a ParseResult of RawRead rows + discovered headers.

    Normalization happens downstream so parsers stay format-specific and dumb."""

    name: str = "base"

    @abstractmethod

    def parse(self, data: bytes) -> ParseResult:

        ...