public apis for groups

src/Core/Models/Api/Public/GroupBaseModel.cs

@@ -0,0 +1,27 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public abstract class GroupBaseModel
+    {
+        /// <summary>
+        /// The name of the group.
+        /// </summary>
+        /// <example>Development Team</example>
+        [Required]
+        [StringLength(100)]
+        public string Name { get; set; }
+        /// <summary>
+        /// Determines if this group can access all collections within the organization, or only the associated
+        /// collections. If set to <c>true</c>, this option overrides any collection assignments.
+        /// </summary>
+        [Required]
+        public bool? AccessAll { get; set; }
+        /// <summary>
+        /// External identifier linking this group to another system, such as a user directory.
+        /// </summary>
+        /// <example>external_id_123456</example>
+        [StringLength(300)]
+        public string ExternalId { get; set; }
+    }
+}

src/Core/Models/Api/Public/Request/AssociationWithPermissionsRequestModel.cs

@@ -0,0 +1,31 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using Newtonsoft.Json;
+using Bit.Core.Models.Data;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class AssociationWithPermissionsRequestModel
+    {
+        /// <summary>
+        /// The associated object's unique identifier.
+        /// </summary>
+        /// <example>bfbc8338-e329-4dc0-b0c9-317c2ebf1a09</example>
+        [Required]
+        public Guid? Id { get; set; }
+        /// <summary>
+        /// When true, the read only permission will not allow the user or group to make changes to items.
+        /// </summary>
+        [Required]
+        public bool? ReadOnly { get; set; }
+
+        public SelectionReadOnly ToSelectionReadOnly()
+        {
+            return new SelectionReadOnly
+            {
+                Id = Id.Value,
+                ReadOnly = ReadOnly.Value
+            };
+        }
+    }
+}

src/Core/Models/Api/Public/Request/GroupCreateUpdateRequestModel.cs

@@ -0,0 +1,30 @@
+using System;
+using System.Collections.Generic;
+using Bit.Core.Models.Table;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class GroupCreateUpdateRequestModel : GroupBaseModel
+    {
+        /// <summary>
+        /// The associated collections that this group can access.
+        /// </summary>
+        public IEnumerable<AssociationWithPermissionsRequestModel> Collections { get; set; }
+
+        public Group ToGroup(Guid orgId)
+        {
+            return ToGroup(new Group
+            {
+                OrganizationId = orgId
+            });
+        }
+
+        public Group ToGroup(Group existingGroup)
+        {
+            existingGroup.Name = Name;
+            existingGroup.AccessAll = AccessAll.Value;
+            existingGroup.ExternalId = ExternalId;
+            return existingGroup;
+        }
+    }
+}

src/Core/Models/Api/Public/Response/GroupResponseModel.cs

@@ -1,12 +1,15 @@
 using System;
+using System.ComponentModel.DataAnnotations;
 using Bit.Core.Models.Table;
 
 namespace Bit.Core.Models.Api.Public
 {
-    public class GroupResponseModel : ResponseModel
+    /// <summary>
+    /// A user group.
+    /// </summary>
+    public class GroupResponseModel : GroupBaseModel, IResponseModel
     {
-        public GroupResponseModel(Group group, string obj = "group")
-            : base(obj)
+        public GroupResponseModel(Group group)
         {
             if(group == null)
             {
@@ -14,16 +17,22 @@ namespace Bit.Core.Models.Api.Public
             }
 
             Id = group.Id;
-            OrganizationId = group.OrganizationId;
             Name = group.Name;
             AccessAll = group.AccessAll;
             ExternalId = group.ExternalId;
         }
 
+        /// <summary>
+        /// String representing the object's type. Objects of the same type share the same properties.
+        /// </summary>
+        /// <example>group</example>
+        [Required]
+        public string Object => "group";
+        /// <summary>
+        /// The group's unique identifier.
+        /// </summary>
+        /// <example>539a36c5-e0d2-4cf9-979e-51ecf5cf6593</example>
+        [Required]
         public Guid Id { get; set; }
-        public Guid OrganizationId { get; set; }
-        public string Name { get; set; }
-        public bool AccessAll { get; set; }
-        public string ExternalId { get; set; }
     }
 }

src/Core/Models/Api/Public/Response/IResponseModel.cs

@@ -0,0 +1,7 @@
+namespace Bit.Core.Models.Api.Public
+{
+    public interface IResponseModel
+    {
+        string Object { get; }
+    }
+}

src/Core/Models/Api/Public/Response/ListResponseModel.cs

@@ -0,0 +1,30 @@
+using System.Collections.Generic;
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Core.Models.Api.Public
+{
+    public class ListResponseModel<T> : IResponseModel where T : IResponseModel
+    {
+        public ListResponseModel(IEnumerable<T> data, string continuationToken = null)
+        {
+            Data = data;
+            ContinuationToken = continuationToken;
+        }
+
+        /// <summary>
+        /// String representing the object's type. Objects of the same type share the same properties.
+        /// </summary>
+        /// <example>list</example>
+        [Required]
+        public string Object => "list";
+        /// <summary>
+        /// An array containing the actual response elements, paginated by any request parameters.
+        /// </summary>
+        [Required]
+        public IEnumerable<T> Data { get; set; }
+        /// <summary>
+        /// A cursor for use in pagination.
+        /// </summary>
+        public string ContinuationToken { get; set; }
+    }
+}