Refactor models according to refined API spec

Fixes #3

Refactor models to align with the refined API spec.

* **Project Model Changes:**
  - Remove `HeroImage`, `CreatedAt`, and `Icon` properties.
  - Add `ExtendedDescription` property.
  - Remove constructor.
  - Provide default values for `Images`, `Features`, `Dependencies`, `Collaborators`, `Links`, and `Connections`.
  - Mark `Publisher`, `Name`, `Description`, `Category`, and `CreatedAt` as `required`.
  - Replace `Cid` with `DagCid`.
  - Change `Collaborators` to a `Dictionary<DagCid, Role>` type.
  - Use an empty collection expression `[]` instead of `Array.Empty<T>`.
  - Remove all JSON-related attributes.

* **Publisher Model Changes:**
  - Remove `Owner`, `ContactEmail`, and `Icon` properties.
  - Add `Users + Roles`, `Connections`, `Links`, `ExtendedDescription`, and `ForgetMe` properties.
  - Remove constructor.
  - Provide default values for `Links`, `Projects`, `Users`, `ParentPublishers`, and `ChildPublishers`.
  - Mark `Name`, `Description`, and `Owner` as `required`.
  - Replace `Cid` with `DagCid`.
  - Use an empty collection expression `[]` instead of `Array.Empty<T>`.
  - Remove all JSON-related attributes.

* **User Model Changes:**
  - Remove `MarkdownAboutMe` and `Icon` properties.
  - Add `Projects + Roles`, `Publisher + Roles`, and `ExtendedDescription` properties.
  - Rename `MarkdownAboutMe` to `ExtendedDescription`.
  - Provide default values for `Connections`, `Links`, `Projects`, and `Publishers`.
  - Mark `Name` and `ExtendedDescription` as `required`.
  - Replace `Cid` with `DagCid`.
  - Use an empty collection expression `[]` instead of `Array.Empty<T>`.
  - Remove all JSON-related attributes.

* **Update Events Changes:**
  - Update any mention of `IsPrivate` to `IsUnlisted` in `ProjectUpdateEvent` and `PublisherUpdateEvent`.
  - Remove lines 31 and 33 in `ProjectUpdateEvent`.

* **Link Model Changes:**
  - Replace `Cid` with `DagCid`.
  - Remove all JSON-related attributes.

* **Role Model Changes:**
  - Mark `Name` and `Description` as `required`.

* **IModifiableEntity Changes:**
  - Add `UpdateExtendedDescriptionAsync` method.
  - Add `ExtendedDescriptionUpdated` event.

* **IReadOnlyEntity Changes:**
  - Add `ExtendedDescription` property.
  - Add `ExtendedDescriptionUpdated` event.

---

For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/WindowsAppCommunity/WinAppCommunity.Sdk/issues/3?shareId=XXXX-XXXX-XXXX-XXXX).

Author: Arlodotexe

src/IModifiableEntity.cs

@@ -16,7 +16,7 @@ public interface IModifiableEntity : IReadOnlyEntity, IModifiableConnectionsColl
     public Task UpdateDescriptionAsync(string description, CancellationToken cancellationToken);
 
     /// <summary>
-    /// Updates the description of this entity.
+    /// Updates the extended description of this entity.
     /// </summary>
     public Task UpdateExtendedDescriptionAsync(string extendedDescription, CancellationToken cancellationToken);
 

src/IReadOnlyEntity.cs

@@ -41,7 +41,7 @@ public interface IReadOnlyEntity : IReadOnlyConnectionsCollection, IReadOnlyLink
     event EventHandler<string>? DescriptionUpdated;
 
     /// <summary>
-    /// Raised when <see cref="Description"/> is updated.
+    /// Raised when <see cref="ExtendedDescription"/> is updated.
     /// </summary>
     event EventHandler<string>? ExtendedDescriptionUpdated;
 

src/Models/Collaborator.cs

@@ -1,35 +1,22 @@
-using Newtonsoft.Json;
-
 namespace WinAppCommunity.Sdk.Models;
 
 /// <summary>
 /// Represents the data for a link.
 /// </summary>
 public record Link
 {
-    /// <summary>
-    /// Creates a new instance of <see cref="Link"/>.
-    /// </summary>
-    [JsonConstructor]
-    public Link(string url, string name, string description)
-    {
-        Url = url;
-        Name = name;
-        Description = description;
-    }
-
     /// <summary>
     /// The external url this link points to.
     /// </summary>
-    public string Url { get; set; }
+    public required string Url { get; set; }
 
     /// <summary>
     /// A display name for this url.
     /// </summary>
-    public string Name { get; set; }
+    public required string Name { get; set; }
 
     /// <summary>
     /// A description of this url (for accessibility or display).
     /// </summary>
-    public string Description { get; set; }
+    public required string Description { get; set; }
 }

src/Models/Link.cs

@@ -1,6 +1,4 @@
 using Ipfs;
-using Newtonsoft.Json;
-using System;
 using System.Collections.Generic;
 
 namespace WinAppCommunity.Sdk.Models;
@@ -10,70 +8,35 @@ namespace WinAppCommunity.Sdk.Models;
 /// </summary>
 public record Project : IName
 {
-    /// <summary>
-    /// Creates a new instance of <see cref="Project"/>.
-    /// </summary>
-    [JsonConstructor]
-    public Project(Cid publisher, string name, string description, Cid icon, Cid heroImage, Cid[] images, string[] features, string? accentColor, string category, DateTime createdAt, Cid[] dependencies, bool? forgetMe, bool isUnlisted)
-    {
-        Publisher = publisher;
-        Name = name;
-        Description = description;
-        Icon = icon;
-        HeroImage = heroImage;
-        Images = images;
-        Features = features;
-        AccentColor = accentColor;
-        Category = category;
-        CreatedAt = createdAt;
-        Dependencies = dependencies;
-        ForgetMe = forgetMe;
-        IsUnlisted = isUnlisted;
-    }
-
-    /// <summary>
-    /// Creates a new instance of <see cref="Project"/>.
-    /// </summary>
-    public Project()
-        : this(string.Empty, string.Empty, string.Empty, string.Empty, string.Empty, [], [], null, string.Empty,
-            DateTime.MinValue, [], null, false)
-    {
-    }
-
     /// <summary>
     /// The publisher for this project.
     /// </summary>
-    public Cid Publisher { get; set; }
+    public required DagCid Publisher { get; set; }
 
     /// <summary>
     /// The name of this project.
     /// </summary>
-    public string Name { get; set; }
+    public required string Name { get; set; }
 
     /// <summary>
     /// A description of this project.
     /// </summary>
-    public string Description { get; set; }
+    public required string Description { get; set; }
 
     /// <summary>
-    /// A <see cref="Cid"/> pointing to a small icon for this project.
+    /// An extended description of this project.
     /// </summary>
-    public Cid? Icon { get; set; }
+    public string ExtendedDescription { get; set; }
 
     /// <summary>
-    /// A <see cref="Cid"/> pointing to a banner or hero image for this project.
+    /// A list of <see cref="DagCid"/>s that point to images demonstrating this project.
     /// </summary>
-    public Cid? HeroImage { get; set; }
-
-    /// <summary>
-    /// A list of <see cref="Cid"/>s that point to images demonstrating this project.
-    /// </summary>
-    public Cid[] Images { get; set; }
+    public DagCid[] Images { get; set; } = [];
 
     /// <summary>
     /// A list of features provided by this project.
     /// </summary>
-    public string[] Features { get; set; }
+    public string[] Features { get; set; } = [];
 
     /// <summary>
     /// A hex-encoded accent color for this publisher.
@@ -83,22 +46,17 @@ public Project()
     /// <summary>
     /// The category defining this project, as found in an app store.
     /// </summary>
-    public string Category { get; set; }
-
-    /// <summary>
-    /// The time this project was created.
-    /// </summary>
-    public DateTime CreatedAt { get; set; }
+    public required string Category { get; set; }
 
     /// <summary>
     /// Other projects which this project may depend on.
     /// </summary>
-    public Cid[] Dependencies { get; set; } = [];
+    public DagCid[] Dependencies { get; set; } = [];
 
     /// <summary>
     /// The <see cref="User"/>s who collaborate on this project, and their corresponding roles.
     /// </summary>
-    public Collaborator[] Collaborators { get; set; } = [];
+    public Dictionary<DagCid, Role> Collaborators { get; set; } = new();
 
     /// <summary>
     /// Represents links to external profiles or resources added by the user.
@@ -108,7 +66,7 @@ public Project()
     /// <summary>
     /// Holds information about project assets that have been published for consumption by an end user, such as a Microsoft Store app, a package on nuget.org, a git repo, etc.
     /// </summary>
-    public Dictionary<string, DagCid> Connections { get; set; } = [];
+    public Dictionary<string, DagCid> Connections { get; set; } = new();
 
     /// <summary>
     /// A flag that indicates whether the profile has requested to be forgotten.
@@ -119,4 +77,4 @@ public Project()
     /// A flag indicating whether this is a non-public project.
     /// </summary>
     public bool IsUnlisted { get; set; }
-}
+}

src/Models/Project.cs

@@ -1,5 +1,5 @@
 using Ipfs;
-using Newtonsoft.Json;
+using System.Collections.Generic;
 
 namespace WinAppCommunity.Sdk.Models;
 
@@ -8,46 +8,20 @@ namespace WinAppCommunity.Sdk.Models;
 /// </summary>
 public record Publisher : IName
 {
-    /// <summary>
-    /// Creates a new instance of <see cref="Publisher"/>.
-    /// </summary>
-    [JsonConstructor]
-    public Publisher(string name, string description, Cid owner, Cid? icon, string? accentColor)
-    {
-        Name = name;
-        Description = description;
-        Icon = icon;
-        Owner = owner;
-        AccentColor = accentColor;
-    }
-
-    /// <summary>
-    /// Creates a new instance of <see cref="Publisher"/>.
-    /// </summary>
-    public Publisher()
-    : this(string.Empty, string.Empty, string.Empty, default, default)
-    {
-    }
-
-    /// <summary>
-    /// The Cid of the <see cref="User"/> who owns this publisher.
-    /// </summary>
-    public Cid Owner { get; set; }
-
     /// <summary>
     /// The name of the publisher.
     /// </summary>
-    public string Name { get; set; }
+    public required string Name { get; set; }
 
     /// <summary>
     /// A description of the publisher.
     /// </summary>
-    public string Description { get; set; }
+    public required string Description { get; set; }
 
     /// <summary>
-    /// An icon to represent this publisher.
+    /// An extended description of the publisher.
     /// </summary>
-    public Cid? Icon { get; set; }
+    public string ExtendedDescription { get; set; }
 
     /// <summary>
     /// A hex-encoded accent color for this publisher.
@@ -60,27 +34,32 @@ public Publisher()
     public Link[] Links { get; set; } = [];
 
     /// <summary>
-    /// A list of the projects registered with this publisher.
+    /// Users who are registered to participate in this publisher, along with their roles.
     /// </summary>
-    public Cid[] Projects { get; set; } = [];
+    public Dictionary<DagCid, Role> Users { get; set; } = new();
 
     /// <summary>
-    /// Users who are registered to participate in this publisher.
+    /// A list of other publishers who are managed under this publisher.
     /// </summary>
-    public Cid[] Users { get; set; } = [];
+    public DagCid[] ParentPublishers { get; set; } = [];
 
     /// <summary>
     /// A list of other publishers who are managed under this publisher.
     /// </summary>
-    public Cid[] ParentPublishers { get; set; } = [];
+    public DagCid[] ChildPublishers { get; set; } = [];
 
     /// <summary>
-    /// A list of other publishers who are managed under this publisher.
+    /// Holds information about publisher assets that have been published for consumption by an end user, such as a Microsoft Store app, a package on nuget.org, a git repo, etc.
+    /// </summary>
+    public Dictionary<string, DagCid> Connections { get; set; } = new();
+
+    /// <summary>
+    /// A flag that indicates whether the profile has requested to be forgotten.
     /// </summary>
-    public Cid[] ChildPublishers { get; set; } = [];
+    public bool? ForgetMe { get; set; }
 
     /// <summary>
     /// A flag indicating whether this is a non-public project.
     /// </summary>
     public bool IsUnlisted { get; set; }
-}
+}

src/Models/Publisher.cs

@@ -7,25 +7,15 @@ namespace WinAppCommunity.Sdk.Models;
 /// </summary>
 public record Role : IName
 {
-    /// <summary>
-    /// Creates a new instance of <see cref="Role"/>.
-    /// </summary>
-    [JsonConstructor]
-    public Role(string name, string description)
-    {
-        Name = name;
-        Description = description;
-    }
-
     /// <summary>
     /// The name of the role.
     /// </summary>
-    public string Name { get; }
+    public required string Name { get; init; }
 
     /// <summary>
     /// A description for the role.
     /// </summary>
-    public string Description { get; }
+    public required string Description { get; init; }
 
     /// <inheritdoc />
     public virtual bool Equals(Role? other)

src/Models/Role.cs

@@ -38,4 +38,4 @@ public record ProjectLinkRemoveEvent(string Id, Link Link) : ProjectUpdateEvent(
 
 public record ProjectForgetMeUpdateEvent(string Id, bool? ForgetMe) : ProjectUpdateEvent(Id, nameof(ProjectForgetMeUpdateEvent));
 
-public record ProjectPrivacyUpdateEvent(string Id, bool IsPrivate) : ProjectUpdateEvent(Id, nameof(ProjectPrivacyUpdateEvent));
+public record ProjectPrivacyUpdateEvent(string Id, bool IsUnlisted) : ProjectUpdateEvent(Id, nameof(ProjectPrivacyUpdateEvent));

src/Models/UpdateEvents/ProjectUpdateEvent.cs

@@ -34,4 +34,4 @@ public record PublisherParentPublisherAddEvent(string Id, Cid ParentPublisher) :
 
 public record PublisherParentPublisherRemoveEvent(string Id, Cid ParentPublisher) : PublisherUpdateEvent(Id, nameof(PublisherParentPublisherRemoveEvent));
 
-public record PublisherPrivateFlagUpdateEvent(string Id, bool IsPrivate) : PublisherUpdateEvent(Id, nameof(PublisherPrivateFlagUpdateEvent));
+public record PublisherPrivateFlagUpdateEvent(string Id, bool IsUnlisted) : PublisherUpdateEvent(Id, nameof(PublisherPrivateFlagUpdateEvent));