Rosetta

"""
Rosetta: Webhook Encoding Resolver & Charset Transcoder
Neutralizes legacy Windows-1252 / ISO-8859 mojibake into pure UTF-8.
"""
from typing import Tuple
from pydantic import BaseModel

class TranscodeStatus(BaseModel):
    detected_encoding: str
    byte_length: int
    utf8_payload: str

class RosettaEncodingResolver:
    @staticmethod
    def resolve_stream(raw_bytes: bytes) -> TranscodeStatus:
        # Check UTF-8 BOM
        if raw_bytes.startswith(b'\xef\xbb\xbf'):
            return TranscodeStatus(
                detected_encoding="UTF-8-SIG",
                byte_length=len(raw_bytes),
                utf8_payload=raw_bytes[3:].decode('utf-8')
            )

        encodings = ["utf-8", "windows-1252", "iso-8859-1", "ascii"]
        for enc in encodings:
            try:
                decoded = raw_bytes.decode(enc)
                return TranscodeStatus(
                    detected_encoding=enc,
                    byte_length=len(raw_bytes),
                    utf8_payload=decoded
                )
            except UnicodeDecodeError:
                continue

        # Lossy fallback if unrecoverable
        return TranscodeStatus(
            detected_encoding="binary_fallback",
            byte_length=len(raw_bytes),
            utf8_payload=raw_bytes.decode('utf-8', errors='replace')
        )