added LinkType.Top enum, so we can specify only top level links

Saule/LinkType.cs

@@ -23,6 +23,11 @@ public enum LinkType
         /// </summary>
         Related = 2,
 
+        /// <summary>
+        /// Only self links in the top section
+        /// </summary>
+        TopSelf = 4,
+
         /// <summary>
         /// Generate all possible links
         /// </summary>

Saule/Serialization/ResourceSerializer.cs

@@ -130,7 +130,8 @@ private JToken CreateTopLevelLinks(int count)
         {
             var result = new JObject();
 
-            if (_resource.LinkType.HasFlag(LinkType.Self))
+            // to preserve back compatibility if Self is enabled, then we also render it. Or if TopSelf is enabled
+            if (_resource.LinkType.HasFlag(LinkType.TopSelf) || _resource.LinkType.HasFlag(LinkType.Self))
             {
                 result.Add("self", _baseUrl);
             }

Tests/Models/PersonOnlyTopLinksResource.cs

@@ -0,0 +1,23 @@
+using Saule;
+
+namespace Tests.Models
+{
+    public class PersonOnlyTopLinksResource : ApiResource
+    {
+        public PersonOnlyTopLinksResource()
+        {
+            WithId(nameof(Person.Identifier));
+            WithLinks(LinkType.TopSelf);
+
+            Attribute(nameof(Person.FirstName));
+            Attribute(nameof(Person.LastName));
+            Attribute(nameof(Person.Age));
+            Attribute(nameof(Person.Address));
+
+            BelongsTo<CompanyResource>(nameof(Person.Job), "/employer");
+            BelongsTo<CarResource>(nameof(Person.Car));
+            HasMany<PersonResource>(nameof(Person.Friends));
+            HasMany<PersonResource>( nameof( Person.FamilyMembers));
+        }
+    }
+}

Tests/Serialization/UrlConstructionTests.cs

@@ -85,6 +85,21 @@ public void SelfLink()
             Assert.Equal("/api/people/123", selfLink);
         }
 
+        [Fact(DisplayName = "Adds top level self link if only LinkType.TopSelf is specified")]
+        public void TopLinkOnlyLink()
+        {
+            var target = new ResourceSerializer(Get.People(1), new PersonOnlyTopLinksResource(),
+                GetUri("123"), DefaultPathBuilder, null, null, null);
+            var result = target.Serialize();
+            _output.WriteLine(result.ToString());
+
+            var selfLink = result["links"].Value<Uri>("self").AbsolutePath;
+
+            Assert.Equal("/api/people/123", selfLink);
+
+            Assert.Null(result["data"][0]["links"]);
+        }
+
         [Fact(DisplayName = "Omits top level links if so requested")]
         public void NoTopLevelLinks()
         {

Tests/Tests.csproj

@@ -140,6 +140,7 @@
     <Compile Include="Models\PersonJobOnlyRelatedLinksResource.cs" />
     <Compile Include="Models\PersonJobOnlySelfLinksResource.cs" />
     <Compile Include="Models\PersonNoJobLinksResource.cs" />
+    <Compile Include="Models\PersonOnlyTopLinksResource.cs" />
     <Compile Include="Models\PersonNoLinksResource.cs" />
     <Compile Include="Models\PersonWithCompanyWithCustomersResource.cs" />
     <Compile Include="Models\PersonWithGuidAsRelationsResource.cs" />