Add People API resource (Phase 2 - v0.2.0)

[ebrett]

Summary

Implements Phase 2 of the gem roadmap by adding the People API resource wrapper using V2 API endpoints with JSON:API format. This provides a clean, resource-based interface for working with NationBuilder people data instead of requiring raw HTTP calls.

New Methods:

• client.people.show(id, include_taggings: false) - Fetch person details (V2 API)
• client.people.taggings(id) - Get person's tags/subscriptions (V2 API with sideloading)
• client.people.rsvps(id, include_event: true) - Get event RSVPs (V2 API, JSON:API format)
• client.people.activities(id) - Get recent activities (V1 API - V2 not yet available)

V2 API Migration

Updated to use V2 endpoints per NationBuilder documentation stating that V1 People API is deprecated:

Method	Old (V1)	New (V2)	Format
show()	/api/v1/people/:id	/api/v2/people/:id	JSON:API
taggings()	/api/v1/people/:id/taggings	/api/v2/people/:id?include=taggings	JSON:API sideloading
rsvps()	N/A	/api/v2/event_rsvps	JSON:API (already V2)
activities()	/api/v1/people/:id/activities	Same (V2 not available yet)	V1 format

Response Format

V2 JSON:API Format:

{
  data: {
    type: "person",
    id: "123",
    attributes: { first_name: "John", ... }
  },
  included: [
    { type: "tagging", id: "1", attributes: { tag: "volunteer" } }
  ]
}

Implementation Details

• ✅ Created Resources::Base class for HTTP method delegation
• ✅ Implemented Resources::People with V2 endpoints
• ✅ Added client.people accessor method
• ✅ Support for sideloading taggings via include_taggings parameter
• ✅ Comprehensive test coverage (18 specs for People, 177 total, 100% pass rate)
• ✅ Updated README with V2 usage examples and JSON:API format
• ✅ Bumped version from 0.1.0 → 0.2.0
• ✅ All existing tests continue to pass (92.32% coverage)
• ✅ Fixed StandardRB linting issue (safe navigation operator)

Test Plan

• All People resource specs pass (18/18)
• Full test suite passes (177 examples, 0 failures)
• Code coverage above 90% threshold (92.32%)
• Linter passing (StandardRB)
• README updated with V2 examples
• Version bumped to 0.2.0
• All CI checks passing

Breaking Changes

Response format changed from V1 to V2 (JSON:API):

• show(): Returns { data: { type: "person", id: "123", attributes: {...} } } instead of { person: {...} }
• taggings(): Returns JSON:API format with included array instead of { results: [...] }
• Consuming apps will need to update parsing logic to handle JSON:API format

Related Issues

• Closes citizen-agv
• Unblocks citizen-0b0 (Refactor NationBuilderApiService to use gem)
• Unblocks citizen-fey (Update WebMock stubs)
• Unblocks citizen-5 (Profile viewing feature)

Documentation

• NationBuilder v2 API Core Concepts
• Unleashing New Possibilities with the NationBuilder API v2
• People API Documentation

🤖 Generated with Claude Code