meta {
  name: List Members
  type: http
  seq: 3
}

get {
  url: {{appview_url}}/api/admin/members
}

params:query {
  limit: 100
  offset: 0
}

assert {
  res.status: eq 200
  res.body.members: isArray
  res.body.total: isDefined
}

docs {
  List all forum members with their assigned roles.

  **Requires:** `space.atbb.permission.manageMembers` permission

  Query params:
  - limit: Max results per page (default: 100, max: 250)
  - offset: Number of records to skip for pagination (default: 0)

  Returns:
  {
    "members": [
      {
        "did": "did:plc:user123",
        "handle": "alice.bsky.social",
        "role": "Moderator",
        "roleUri": "at://FORUM_DID/space.atbb.forum.role/RKEY",
        "joinedAt": "2026-02-15T00:00:00.000Z"
      },
      ...
    ],
    "total": 42,
    "limit": 100,
    "offset": 0
  }

  Members are sorted by join date (newest first).

  Error codes:
  - 401: Not authenticated
  - 403: Insufficient permissions
  - 500: Database error

  Notes:
  - Members without assigned role will have role: null, roleUri: null
  - Pagination uses offset-based approach (offset + limit)
}