"""Data mapping functions.

Replaces mappings.js — transforms raw DB rows into API response shapes.

Mappers:
  NONE, CONTRACT, CONTRACTLIST, DEBIT, DEBITLIST, CONTRIBUTIONS,
  MEMBER, MEMO, MEMBERLIST, MEMBERLIST_TO_LDAPCSV,
  WITHDRAWAL, WITHDRAWALLIST
"""

from . import memberdata

# Placeholder — full implementation in Phase 5

MAPPERS = {}


def none_mapper(ctx):
    """Identity mapper — returns context unchanged."""
    return ctx


def contract_mapper(ctx):
    """Map a single contract record."""
    # TODO Phase 5
    raise NotImplementedError


def contractlist_mapper(ctx):
    """Map a list of contract records into paginated format."""
    # TODO Phase 5
    raise NotImplementedError


def debit_mapper(ctx):
    """Map a single debit record."""
    # TODO Phase 5
    raise NotImplementedError


def debitlist_mapper(ctx):
    """Map a list of debit records into paginated format."""
    # TODO Phase 5
    raise NotImplementedError


def contributions_mapper(ctx):
    """Aggregate contributions (billed/paid/unpaid) across contracts and years."""
    # TODO Phase 5
    raise NotImplementedError


def member_mapper(ctx):
    """Map a single member record with all fields."""
    # TODO Phase 5
    raise NotImplementedError


def memo_mapper(ctx):
    """Parse RTF memo and extract embedded JSON data."""
    # TODO Phase 5
    raise NotImplementedError


def memberlist_mapper(ctx):
    """Map a list of members into paginated format."""
    # TODO Phase 5
    raise NotImplementedError


def memberlist_to_ldapcsv_mapper(ctx):
    """Map member list to LDAP CSV export format."""
    # TODO Phase 5
    raise NotImplementedError


def withdrawal_mapper(ctx):
    """Map a single withdrawal record."""
    # TODO Phase 5
    raise NotImplementedError


def withdrawallist_mapper(ctx):
    """Map a list of withdrawal records into paginated format."""
    # TODO Phase 5
    raise NotImplementedError