def get_members(
    top: Optional[int] = None,
    skip: Optional[int] = None,
    filter_query: Optional[str] = None,
    select: Optional[List[str]] = None,
    orderby: Optional[str] = None,
    count: bool = False
) -> Dict[str, Any]

from wfrmls import WFRMLSClient

client = WFRMLSClient()

# Get first 10 members
response = client.member.get_members(top=10)
members = response["value"]

# Get active members only
active_response = client.member.get_active_members(top=20)

# Search by name
smith_agents = client.member.get_members(
    filter_query="contains(MemberLastName, 'Smith')",
    select=["MemberKey", "MemberFullName", "MemberStatus", "OfficeName"],
    orderby="MemberLastName asc"
)

# Get members with count
result_with_count = client.member.get_members(
    filter_query="MemberStatus eq 'Active'",
    count=True,
    top=1
)
total_active = result_with_count.get("@odata.count", 0)

def get_member(member_key: str) -> Optional[Dict[str, Any]]

# Get specific member
member = client.member.get_member("40")

if member:
    print(f"Agent: {member['MemberFullName']}")
    print(f"Office: {member['OfficeName']}")
    print(f"Phone: {member['MemberPreferredPhone']}")

def get_member_by_mls_id(mls_id: str) -> Dict[str, Any]

# Get agent details by MLS ID
agent = client.member.get_member_by_mls_id("4020986")

print(f"Agent: {agent['MemberFullName']}")
print(f"Email: {agent['MemberEmail']}")
print(f"Office: {agent['OfficeName']}")

# Active members only
active_members = client.member.get_active_members(top=50)

# Inactive members
inactive = client.member.get_members(
    filter_query="MemberStatus eq 'Inactive'",
    select=["MemberKey", "MemberFullName", "MemberStatus"]
)

# Search by last name
smiths = client.member.search_members_by_name(last_name="Smith")

# Search by first name
johns = client.member.get_members(
    filter_query="startswith(MemberFirstName, 'John')"
)

# Full name contains
client.member.get_members(
    filter_query="contains(MemberFullName, 'Williams')"
)

# Members from specific office
office_members = client.member.get_members(
    filter_query="OfficeKey eq '69433'",
    select=["MemberFullName", "MemberType", "MemberStatus"]
)

# Members by office name
coldwell_agents = client.member.get_members(
    filter_query="contains(OfficeName, 'Coldwell')"
)

# Brokers only
brokers = client.member.get_members(
    filter_query="MemberType eq 'MLS Only Broker'"
)

# Members with specific designations
abr_agents = client.member.get_members(
    filter_query="contains(MemberDesignation, 'ABR')"
)

# Members by AOR
salt_lake_members = client.member.get_members(
    filter_query="MemberAOR eq 'Salt Lake Board'"
)

# Members with mobile phones
with_mobile = client.member.get_members(
    filter_query="MemberMobilePhone ne null",
    select=["MemberFullName", "MemberMobilePhone"]
)

# Members in specific city
salt_lake_agents = client.member.get_members(
    filter_query="MemberCity eq 'Salt Lake City'"
)

def get_all_active_members():
    """Retrieve all active members using pagination."""
    all_members = []
    skip = 0
    page_size = 200  # Maximum allowed

    while True:
        response = client.member.get_members(
            filter_query="MemberStatus eq 'Active'",
            top=page_size,
            skip=skip,
            orderby="MemberKey asc"
        )

        members = response.get("value", [])
        if not members:
            break

        all_members.extend(members)

        # Check for next page
        if "@odata.nextLink" not in response:
            break

        skip += page_size

    return all_members

def create_member_directory(letter: str):
    """Create alphabetical directory for members."""

    members = client.member.get_members(
        filter_query=f"startswith(MemberLastName, '{letter}')",
        select=[
            "MemberKey", "MemberFullName", "MemberPreferredPhone",
            "OfficeName", "MemberStatus"
        ],
        orderby="MemberLastName asc, MemberFirstName asc"
    )

    return members["value"]

# Get all members with last names starting with 'A'
a_members = create_member_directory('A')

# ❌ Inefficient - retrieves all fields
all_fields = client.member.get_members(top=100)

# ✅ Efficient - only needed fields
contact_list = client.member.get_members(
    select=["MemberKey", "MemberFullName", "MemberPreferredPhone"],
    top=100
)

# Combine filters to reduce result set
active_brokers_in_salt_lake = client.member.get_members(
    filter_query=(
        "MemberStatus eq 'Active' and "
        "MemberType eq 'MLS Only Broker' and "
        "MemberCity eq 'Salt Lake City'"
    ),
    select=["MemberKey", "MemberFullName", "OfficeName"]
)