@fedify/fedify 0.12.0-dev.284 → 0.12.0-dev.286

package/CHANGES.md

@@ -71,6 +71,15 @@ To be released.
      -  The type of `ActorKeyPairsDispatcher<TContextData>`'s first parameter
         became `Context` (was `TContextData`).
 
+ -  The built-in document loaders now recognize JSON-LD context provided in
+    an HTTP `Link` header. [[#6]]
+
+     -  The `fetchDocumentLoader()` function now recognizes the `Link` header
+        with the `http://www.w3.org/ns/json-ld#context` link relation.
+     -  The `getAuthenticatedDocumentLoader()` function now returns a document
+        loader that recognizes the `Link` header with
+        the `http://www.w3.org/ns/json-ld#context` link relation.
+
  -  Deprecated `Federation.sendActivity()` method.  Use `Context.sendActivity()`
     method instead.
 
@@ -108,6 +117,7 @@ To be released.
 
      -  `["fedify", "federation", "queue"]`
 
+[#6]: https://github.com/dahlia/fedify/issues/6
 [#50]: https://github.com/dahlia/fedify/issues/50
 [#53]: https://github.com/dahlia/fedify/issues/53
 [#66]: https://github.com/dahlia/fedify/issues/66

package/README.md

@@ -30,6 +30,7 @@ Currently, Fedify provides the following features out of the box:
  -  [NodeInfo] protocol
  -  Special touch for interoperability with Mastodon and few other popular
     fediverse software
+ -  Integration with various web frameworks
  -  CLI toolchain for testing and debugging
 
 If you want to know more about the project, please take a look at the following

package/esm/mod.js

@@ -19,6 +19,7 @@
  * - [NodeInfo] protocol
  * - Special touch for interoperability with Mastodon and few other popular
  *   fediverse software
+ * - Integration with various web frameworks
  * - CLI toolchain for testing and debugging
  *
  * If you want to know more about the project, please take a look at the

package/esm/runtime/docloader.js

@@ -1,4 +1,5 @@
 import * as dntShim from "../_dnt.shims.js";
+import { HTTPHeaderLink } from "@hugoalh/http-header-link";
 import { getLogger } from "@logtape/logtape";
 import { signRequest } from "../sig/http.js";
 import { validateCryptoKey } from "../sig/key.js";
@@ -50,13 +51,25 @@ async function getRemoteDocument(url, response) {
         });
         throw new FetchError(documentUrl, `HTTP ${response.status}: ${documentUrl}`);
     }
+    const linkHeader = response.headers.get("Link");
+    let contextUrl = null;
+    if (linkHeader != null) {
+        const link = new HTTPHeaderLink(linkHeader);
+        const entries = link.getByRel("http://www.w3.org/ns/json-ld#context");
+        for (const [uri, params] of entries) {
+            if ("type" in params && params.type === "application/ld+json") {
+                contextUrl = uri;
+                break;
+            }
+        }
+    }
     logger.debug("Fetched document: {status} {url} {headers}", {
         status: response.status,
         url: documentUrl,
         headers: Object.fromEntries(response.headers.entries()),
     });
     return {
-        contextUrl: null,
+        contextUrl,
         document: await response.json(),
         documentUrl,
     };

package/esm/x/astro.js

@@ -5,6 +5,7 @@
  * @example src/middleware.ts
  * ``` typescript
  * import { defineMiddleware } from "astro:middleware";
+ * import { createFetchOptions } from "@fedify/fedify/x/astro";
  * import { federation } from "./federation";  // Import the `Federation` object
  *
  * export const onRequest = defineMiddleware((context, next) => {
@@ -56,6 +57,7 @@ export function createFetchOptions(_context, next) {
  * @example src/middleware.ts
  * ``` typescript
  * import type { MiddlewareHandler } from "astro";
+ * import { createMiddleware } from "@fedify/fedify/x/astro";
  * import { federation } from "./federation";  // Import the `Federation` object
  *
  * export const onRequest: MiddlewareHandler = createMiddleware(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "0.12.0-dev.284+5b347b26",
+  "version": "0.12.0-dev.286+6a3479e5",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",
@@ -82,6 +82,7 @@
     "test": "node test_runner.js"
   },
   "dependencies": {
+    "@hugoalh/http-header-link": "^1.0.2",
     "@logtape/logtape": "^0.4.0",
     "@phensley/language-tag": "^1.8.1",
     "asn1js": "^3.0.5",

package/types/mod.d.ts

@@ -19,6 +19,7 @@
  * - [NodeInfo] protocol
  * - Special touch for interoperability with Mastodon and few other popular
  *   fediverse software
+ * - Integration with various web frameworks
  * - CLI toolchain for testing and debugging
  *
  * If you want to know more about the project, please take a look at the

package/types/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/types/runtime/docloader.d.ts

@@ -6,8 +6,17 @@ import type { KvKey, KvStore } from "../federation/kv.js";
  * a {@link DocumentLoader}.
  */
 export interface RemoteDocument {
+    /**
+     * The URL of the context document.
+     */
     contextUrl: string | null;
+    /**
+     * The fetched JSON-LD document.
+     */
     document: unknown;
+    /**
+     * The URL of the fetched document.
+     */
     documentUrl: string;
 }
 /**

package/types/runtime/docloader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docloader.d.ts","sourceRoot":"","sources":["../../src/runtime/docloader.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQ1D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG,CAC/C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,KACpD,cAAc,CAAC;AAEpB;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;IAET;;;;;OAKG;gBACS,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKhD;AAwDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,GACtD,cAAc,CAuBhB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,iBAAiB,GAC/C,cAAc,CA2ChB"}
+{"version":3,"file":"docloader.d.ts","sourceRoot":"","sources":["../../src/runtime/docloader.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAG5C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQ1D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG,CAC/C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,KACpD,cAAc,CAAC;AAEpB;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;IAET;;;;;OAKG;gBACS,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKhD;AAoED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,GACtD,cAAc,CAuBhB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IAEf;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,iBAAiB,GAC/C,cAAc,CA2ChB"}

package/types/x/astro.d.ts

@@ -7,7 +7,12 @@
  * This module contains some utilities for integrating Fedify with
  * the [Astro] framework.
  *
+ * > [!NOTE]
+ * >
+ * > Astro integration requires [on-demand server rendering][1].
+ *
  * [Astro]: https://astro.build/
+ * [1]: https://docs.astro.build/en/guides/server-side-rendering/
  *
  * @module
  * @since 0.12.0
@@ -26,6 +31,7 @@ type MiddlewareHandler<TAstroContext extends AstroContext> = (context: TAstroCon
  * @example src/middleware.ts
  * ``` typescript
  * import { defineMiddleware } from "astro:middleware";
+ * import { createFetchOptions } from "@fedify/fedify/x/astro";
  * import { federation } from "./federation";  // Import the `Federation` object
  *
  * export const onRequest = defineMiddleware((context, next) => {
@@ -61,6 +67,7 @@ export type ContextDataFactory<TContextData, TAstroContext extends AstroContext>
  * @example src/middleware.ts
  * ``` typescript
  * import type { MiddlewareHandler } from "astro";
+ * import { createMiddleware } from "@fedify/fedify/x/astro";
  * import { federation } from "./federation";  // Import the `Federation` object
  *
  * export const onRequest: MiddlewareHandler = createMiddleware(

package/types/x/astro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../src/x/astro.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAErC,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AACD,KAAK,cAAc,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;AAC7C,KAAK,cAAc,GAAG,CACpB,cAAc,CAAC,EAAE,cAAc,KAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvB,KAAK,iBAAiB,CAAC,aAAa,SAAS,YAAY,IAAI,CAC3D,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,cAAc,KACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,SAAS,YAAY,EACnE,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,cAAc,GACnB,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CA2BnD;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAC5B,YAAY,EACZ,aAAa,SAAS,YAAY,IAChC,CACF,OAAO,EAAE,aAAa,KACnB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EACZ,aAAa,SAAS,YAAY,EAElC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,EACpC,kBAAkB,EAAE,kBAAkB,CAAC,YAAY,EAAE,aAAa,CAAC,GAClE,iBAAiB,CAAC,aAAa,CAAC,CAQlC"}
+{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../src/x/astro.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAErC,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AACD,KAAK,cAAc,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;AAC7C,KAAK,cAAc,GAAG,CACpB,cAAc,CAAC,EAAE,cAAc,KAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvB,KAAK,iBAAiB,CAAC,aAAa,SAAS,YAAY,IAAI,CAC3D,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,cAAc,KACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,SAAS,YAAY,EACnE,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,cAAc,GACnB,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CA2BnD;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAC5B,YAAY,EACZ,aAAa,SAAS,YAAY,IAChC,CACF,OAAO,EAAE,aAAa,KACnB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EACZ,aAAa,SAAS,YAAY,EAElC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,EACpC,kBAAkB,EAAE,kBAAkB,CAAC,YAAY,EAAE,aAAa,CAAC,GAClE,iBAAiB,CAAC,aAAa,CAAC,CAQlC"}