Final documentation improvements and version bump to 0.5.0

Co-authored-by: orestesgaolin <16854239+orestesgaolin@users.noreply.github.com>

Author: Copilot

codemagic_manager/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.5.0] - Complete API endpoints implementation
+
+- **NEW**: Added support for all missing Codemagic API endpoints
+- **NEW**: Applications API - `getApplications()` to list all applications
+- **NEW**: Builds API - `getBuild(id)` and `getBuildsForApplication(appId)` for detailed build queries
+- **NEW**: Artifacts API - `getArtifacts(buildId)` and `getArtifact(id)` for build artifact management
+- **NEW**: Caches API - `getCaches()`, `getCache(id)`, and `deleteCache(id)` for cache management
+- **NEW**: Teams API - `getTeams()`, `getTeam(id)`, and `getTeamMembers(teamId)` for team management
+- **NEW**: Enhanced example application with tabbed interface showcasing all new functionality
+- **NEW**: Comprehensive test coverage for all new endpoints
+- **IMPROVED**: Enhanced documentation for existing methods (`getBuilds`, `getApplication`, `startBuild`)
+- **NEW**: Added proper model classes: `Applications`, `Artifacts`, `Cache`, `Team`, `TeamMember`, etc.
+- **NEW**: All models use json_serializable for consistent serialization
+
 ## [0.4.0] - Dart SDK 3.0.0 and null safety
 
 - Updated dependencies

codemagic_manager/lib/src/codemagic_client.dart

@@ -23,6 +23,13 @@ class CodemagicClient {
   }) : _client = HttpClient();
 
   /// Retrieves [Builds] object containing list of [Application]s and [Build]s
+  /// 
+  /// This endpoint returns a paginated list of recent builds along with their
+  /// associated applications. The response includes build status, timing information,
+  /// and artifact details.
+  /// 
+  /// Returns [ApiResponse] containing [Builds] data on success, or error information
+  /// on failure (e.g., 401 for invalid authentication).
   Future<ApiResponse<Builds>> getBuilds() async {
     try {
       final request = await _client.getUrl(Uri.parse("$apiUrl/builds"));
@@ -73,6 +80,15 @@ class CodemagicClient {
   }
 
   /// Retrieves information about specific [Application] by its [id]
+  /// 
+  /// Fetches detailed information about a single application including its
+  /// configuration, workflow definitions, repository settings, and metadata.
+  /// 
+  /// Parameters:
+  /// - [id]: The unique identifier of the application
+  /// 
+  /// Returns [ApiResponse] containing [Application] data on success, or error
+  /// information on failure (e.g., 404 if application not found).
   Future<ApiResponse<Application>> getApplication(String id) async {
     try {
       final request = await _client.getUrl(Uri.parse("$apiUrl/apps/$id"));
@@ -138,8 +154,18 @@ class CodemagicClient {
     }
   }
 
-  /// Starts new build for [Application] by its [appId], [workflowId]
-  /// and [branch]
+  /// Starts new build for [Application] by its [appId], [workflowId] and [branch]
+  /// 
+  /// Triggers a new build for the specified application using the given workflow
+  /// and source branch. The build will be queued and executed asynchronously.
+  /// 
+  /// Parameters:
+  /// - [appId]: The unique identifier of the application
+  /// - [workflowId]: The workflow identifier to use for the build
+  /// - [branch]: The source branch name to build from
+  /// 
+  /// Returns [ApiResponse] containing [BuildResponse] with the new build ID on
+  /// success, or error information on failure (e.g., 400 for invalid parameters).
   Future<ApiResponse<BuildResponse>> startBuild(
     String appId,
     String workflowId,

codemagic_manager/pubspec.yaml

@@ -1,7 +1,7 @@
 name: codemagic_manager
 description: Package allowing to query Codemagic builds and applications from
   the recently exposed API
-version: 0.4.0
+version: 0.5.0
 homepage: https://roszkowski.dev
 issue_tracker: https://github.com/orestesgaolin/codemagic_manager/issues
 repository: https://github.com/orestesgaolin/codemagic_manager