feat: adds an extremely simply AppCapabilities model to support perce…

…ntage-based rollouts

packages/shorebird_code_push_protocol/lib/src/messages/get_app_capabilities/get_app_capabilities.dart

@@ -0,0 +1 @@
+export 'get_app_capabilities_response.dart';

packages/shorebird_code_push_protocol/lib/src/messages/get_app_capabilities/get_app_capabilities_response.dart

@@ -0,0 +1,27 @@
+import 'package:json_annotation/json_annotation.dart';
+import 'package:shorebird_code_push_protocol/shorebird_code_push_protocol.dart';
+
+part 'get_app_capabilities_response.g.dart';
+
+/// {@template get_app_capabilities_response}
+/// The capabilities of the requesting user for the specified app.
+/// {@endtemplate}
+@JsonSerializable()
+class GetAppCapabilitiesResponse {
+  /// {@macro get_app_capabilities_response}
+  GetAppCapabilitiesResponse({required this.capabilities});
+
+  /// Deserializes the [GetAppCapabilitiesResponse] from a JSON map.
+  factory GetAppCapabilitiesResponse.fromJson(Map<String, dynamic> json) =>
+      _$GetAppCapabilitiesResponseFromJson(json);
+
+  /// Converts this [GetAppCapabilitiesResponse] to a JSON map.
+  Map<String, dynamic> toJson() => _$GetAppCapabilitiesResponseToJson(this);
+
+  /// The list of capabilities the user has for the app. There are the things
+  /// that the requesting user can do to or in relation to the app. These are
+  /// determined by the user's role in the organization that owns the app, the
+  /// user's app collaborator status, and the plan associated with the app's
+  /// organization.
+  final List<AppCapability> capabilities;
+}

packages/shorebird_code_push_protocol/lib/src/messages/messages.dart

@@ -6,6 +6,7 @@ export 'create_patch_artifact/create_patch_artifact.dart';
 export 'create_release/create_release.dart';
 export 'create_release_artifact/create_release_artifact.dart';
 export 'create_user/create_user.dart';
+export 'get_app_capabilities/get_app_capabilities.dart';
 export 'get_apps/get_apps.dart';
 export 'get_organization_apps/get_organization_apps.dart';
 export 'get_organization_users/get_organization_users.dart';

packages/shorebird_code_push_protocol/lib/src/models/app_capability.dart

@@ -0,0 +1,7 @@
+/// Operations that a user may or may not be able to perform to or in relation
+/// to an app.
+enum AppCapability {
+  /// Allows the user to create patches for an app at a non-100 rollout
+  /// percentage.
+  phasedPatchRollout,
+}

packages/shorebird_code_push_protocol/lib/src/models/models.dart

@@ -1,4 +1,5 @@
 export 'app.dart';
+export 'app_capability.dart';
 export 'app_collaborator_role.dart';
 export 'app_metadata.dart';
 export 'auth_provider.dart';

packages/shorebird_code_push_protocol/test/src/messages/get_app_capabilities/get_app_capabilities_response_test.dart

@@ -0,0 +1,16 @@
+import 'package:shorebird_code_push_protocol/shorebird_code_push_protocol.dart';
+import 'package:test/test.dart';
+
+void main() {
+  group(GetAppCapabilitiesResponse, () {
+    test('can be (de)serialized', () {
+      final response = GetAppCapabilitiesResponse(capabilities: [
+        AppCapability.phasedPatchRollout,
+      ]);
+      expect(
+        GetAppCapabilitiesResponse.fromJson(response.toJson()).toJson(),
+        equals(response.toJson()),
+      );
+    });
+  });
+}