Async Core API: Activities (GET Operations)

[btoron]

User Story

As a developer using pyOFSC in async applications
I want async versions of activity GET (read-only) methods
So that I can fetch activity data without blocking in async/await contexts

Description

Implement async versions of all activity GET operations in AsyncOFSCore.

Methods to Implement (13 total)

Core Activity Operations

• get_activities(params) - GET /rest/ofscCore/v1/activities
• get_activity(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}

File Operations

• get_file_property(activity_id, label) - GET /rest/ofscCore/v1/activities/{activityId}/custom-properties/{label}/content

Multiday Operations

• get_multiday_segments(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/multiday-segments

Form Operations

• get_submitted_forms(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/forms

Resource Preference Operations

• get_resource_preferences(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/resourcePreferences

Inventory Operations

• get_required_inventories(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/inventories/required
• get_customer_inventories(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/inventories/customer
• get_installed_inventories(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/inventories/installed
• get_deinstalled_inventories(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/inventories/deinstalled

Linked Activities

• get_linked_activities(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/links
• get_activity_link(activity_id, link_id) - GET /rest/ofscCore/v1/activities/{activityId}/links/{linkId}

Capacity Operations

• get_capacity_categories(activity_id) - GET /rest/ofscCore/v1/activities/{activityId}/capacityCategories

Acceptance Criteria

• All methods use Pydantic models only (no raw dict responses)
• Models exist/created in ofsc/models.py for all responses
• Saved responses captured in tests/saved_responses/activities/
• Live tests with @pytest.mark.uses_real_data marker
• Model validation tests against saved responses
• Methods follow async pattern (httpx, error handling)
• All tests passing

Technical Design

File: ofsc/async_client/core.py
Pattern: Follow async metadata implementation pattern

Related Files

• ofsc/async_client/core.py - Implement async methods
• ofsc/models.py - Activity models
• tests/async/test_async_activities.py - Test file
• tests/saved_responses/activities/ - API response files

[btoron]

Acceptance Criteria Validation - PARTIAL PASS ⚠️

Status: 92.3% Complete - 5 of 7 criteria PASS, 2 PARTIAL

Passed Criteria:

• All implemented methods use Pydantic models only
• Models exist in ofsc/models.py for all responses
• Methods follow async pattern (httpx, error handling)
• Model validation tests pass (10 tests)
• All tests passing (21 passed, 2 skipped)

Partial/Incomplete:

• CRITICAL: get_multiday_segments method NOT implemented (12/13 methods done)
• Missing live tests for get_file_property and get_activity_link
• Saved response for get_activity_link contains 404 error (should be 200 success)

Gaps to Address:

1. Implement get_multiday_segments method
2. Add live tests for get_file_property
3. Add live tests for get_activity_link
4. Capture proper 200 success response for get_activity_link

Validation performed for PR #129.