Add FEP-7aa9 vocabulary support

CHANGES.md

@@ -16,9 +16,23 @@ To be released.
     serialization emits canonical `ap+ef61:` values with decoded DID
     authorities.  [[#826], [#850]]
 
+ -  Added vocabulary support for [FEP-7aa9], including
+    `FeaturedCollection`, `FeaturedItem`, `FeatureRequest`, and
+    `FeatureAuthorization`, plus actor `featuredCollections` and
+    `InteractionPolicy.canFeature` properties.  [[#810], [#914]]
+
 [FEP-ef61]: https://w3id.org/fep/ef61
+[FEP-7aa9]: https://w3id.org/fep/7aa9
+[#810]: https://github.com/fedify-dev/fedify/issues/810
 [#826]: https://github.com/fedify-dev/fedify/issues/826
 [#850]: https://github.com/fedify-dev/fedify/pull/850
+[#914]: https://github.com/fedify-dev/fedify/pull/914
+
+### @fedify/vocab-runtime
+
+ -  Added the [FEP-7aa9] JSON-LD context to the preloaded context registry so
+    FEP-7aa9 documents can be compacted and expanded without fetching the
+    context remotely.  [[#810], [#914]]
 
 
 Version 2.3.1

FEDERATION.md

@@ -37,6 +37,7 @@ Supported FEPs
  -  [FEP-e232][]: Object Links
  -  [FEP-5711][]: Inverse Properties for Collections
  -  [FEP-044f][]: Consent-respecting quote posts
+ -  [FEP-7aa9][]: Featuring recommendations using a dedicated collection
  -  [FEP-0837][]: Federated Marketplace
  -  [FEP-ae0c][]: Fediverse Relay Protocols: Mastodon and LitePub
 
@@ -53,6 +54,7 @@ Supported FEPs
 [FEP-e232]: https://w3id.org/fep/e232
 [FEP-5711]: https://w3id.org/fep/5711
 [FEP-044f]: https://w3id.org/fep/044f
+[FEP-7aa9]: https://w3id.org/fep/7aa9
 [FEP-0837]: https://w3id.org/fep/0837
 [FEP-ae0c]: https://w3id.org/fep/ae0c
 
@@ -78,6 +80,7 @@ fediverse.
  -  [`Delete`]
  -  [`Dislike`]
  -  [`EmojiReact`]
+ -  [`FeatureRequest`] ([FEP-7aa9])
  -  [`Flag`]
  -  [`Follow`]
  -  [`Ignore`]
@@ -113,6 +116,7 @@ fediverse.
 [`Delete`]: https://jsr.io/@fedify/vocab/doc/~/Delete
 [`Dislike`]: https://jsr.io/@fedify/vocab/doc/~/Dislike
 [`EmojiReact`]: https://jsr.io/@fedify/vocab/doc/~/EmojiReact
+[`FeatureRequest`]: https://jsr.io/@fedify/vocab/doc/~/FeatureRequest
 [`Flag`]: https://jsr.io/@fedify/vocab/doc/~/Flag
 [`Follow`]: https://jsr.io/@fedify/vocab/doc/~/Follow
 [`Ignore`]: https://jsr.io/@fedify/vocab/doc/~/Ignore
@@ -158,6 +162,8 @@ fediverse.
  -  [`Audio`]
  -  [`Document`]
  -  [`Event`]
+ -  [`FeatureAuthorization`] ([FEP-7aa9])
+ -  [`FeaturedItem`] ([FEP-7aa9])
  -  [`Image`]
  -  [`LikeAuthorization`] (GoToSocial extension)
  -  [`Note`]
@@ -175,6 +181,8 @@ fediverse.
 [`Audio`]: https://jsr.io/@fedify/vocab/doc/~/Audio
 [`Document`]: https://jsr.io/@fedify/vocab/doc/~/Document
 [`Event`]: https://jsr.io/@fedify/vocab/doc/~/Event
+[`FeatureAuthorization`]: https://jsr.io/@fedify/vocab/doc/~/FeatureAuthorization
+[`FeaturedItem`]: https://jsr.io/@fedify/vocab/doc/~/FeaturedItem
 [`Image`]: https://jsr.io/@fedify/vocab/doc/~/Image
 [`LikeAuthorization`]: https://jsr.io/@fedify/vocab/doc/~/LikeAuthorization
 [`Note`]: https://jsr.io/@fedify/vocab/doc/~/Note
@@ -191,11 +199,13 @@ fediverse.
 
  -  [`Collection`]
  -  [`CollectionPage`]
+ -  [`FeaturedCollection`] ([FEP-7aa9])
  -  [`OrderedCollection`]
  -  [`OrderedCollectionPage`]
 
 [`Collection`]: https://jsr.io/@fedify/vocab/doc/~/Collection
 [`CollectionPage`]: https://jsr.io/@fedify/vocab/doc/~/CollectionPage
+[`FeaturedCollection`]: https://jsr.io/@fedify/vocab/doc/~/FeaturedCollection
 [`OrderedCollection`]: https://jsr.io/@fedify/vocab/doc/~/OrderedCollection
 [`OrderedCollectionPage`]: https://jsr.io/@fedify/vocab/doc/~/OrderedCollectionPage
 

packages/fedify/src/federation/handler.test.ts

@@ -175,11 +175,16 @@ test("handleActor()", async () => {
       "https://www.w3.org/ns/did/v1",
       "https://w3id.org/security/multikey/v1",
       "https://gotosocial.org/ns",
+      "https://w3id.org/fep/7aa9",
       {
         alsoKnownAs: {
           "@id": "as:alsoKnownAs",
           "@type": "@id",
         },
+        featuredCollections: {
+          "@id": "https://w3id.org/fep/7aa9#featuredCollections",
+          "@type": "@id",
+        },
         manuallyApprovesFollowers: "as:manuallyApprovesFollowers",
         movedTo: {
           "@id": "as:movedTo",
@@ -278,11 +283,16 @@ test("handleActor()", async () => {
       "https://www.w3.org/ns/did/v1",
       "https://w3id.org/security/multikey/v1",
       "https://gotosocial.org/ns",
+      "https://w3id.org/fep/7aa9",
       {
         alsoKnownAs: {
           "@id": "as:alsoKnownAs",
           "@type": "@id",
         },
+        featuredCollections: {
+          "@id": "https://w3id.org/fep/7aa9#featuredCollections",
+          "@type": "@id",
+        },
         manuallyApprovesFollowers: "as:manuallyApprovesFollowers",
         movedTo: {
           "@id": "as:movedTo",

packages/fixture/src/fixtures/w3id.org/fep/7aa9.json

@@ -0,0 +1,24 @@
+{
+  "@context": {
+    "FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+    "FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+    "FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+    "FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+    "topic": {
+      "@id": "https://w3id.org/fep/7aa9#topic",
+      "@type": "@id"
+    },
+    "featuredObject": {
+      "@id": "https://w3id.org/fep/7aa9#featuredObject",
+      "@type": "@id"
+    },
+    "canFeature": {
+      "@id": "https://w3id.org/fep/7aa9#canFeature",
+      "@type": "@id"
+    },
+    "featureAuthorization": {
+      "@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+      "@type": "@id"
+    }
+  }
+}

packages/vocab-runtime/src/contexts.ts

@@ -6,6 +6,7 @@ import activitystreams from "./contexts/activitystreams.json" with {
   type: "json",
 };
 import didV1 from "./contexts/did-v1.json" with { type: "json" };
+import fep7aa9 from "./contexts/fep-7aa9.json" with { type: "json" };
 import fep5711 from "./contexts/fep-5711.json" with { type: "json" };
 import gotosocial from "./contexts/gotosocial.json" with { type: "json" };
 import identityV1 from "./contexts/identity-v1.json" with { type: "json" };
@@ -35,6 +36,7 @@ const preloadedContexts: Record<string, unknown> = {
   "http://schema.org/": schemaorg,
   "https://gotosocial.org/ns": gotosocial,
   "https://w3id.org/fep/5711": fep5711,
+  "https://w3id.org/fep/7aa9": fep7aa9,
 
   // Lemmy's context document is served as application/json without the JSON-LD
   // context Link header.  The default document loader treats that as a regular

packages/vocab-runtime/src/contexts/fep-7aa9.json

@@ -0,0 +1,24 @@
+{
+  "@context": {
+    "FeaturedCollection": "https://w3id.org/fep/7aa9#FeaturedCollection",
+    "FeaturedItem": "https://w3id.org/fep/7aa9#FeaturedItem",
+    "FeatureRequest": "https://w3id.org/fep/7aa9#FeatureRequest",
+    "FeatureAuthorization": "https://w3id.org/fep/7aa9#FeatureAuthorization",
+    "topic": {
+      "@id": "https://w3id.org/fep/7aa9#topic",
+      "@type": "@id"
+    },
+    "featuredObject": {
+      "@id": "https://w3id.org/fep/7aa9#featuredObject",
+      "@type": "@id"
+    },
+    "canFeature": {
+      "@id": "https://w3id.org/fep/7aa9#canFeature",
+      "@type": "@id"
+    },
+    "featureAuthorization": {
+      "@id": "https://w3id.org/fep/7aa9#featureAuthorization",
+      "@type": "@id"
+    }
+  }
+}