@fedify/fedify 0.8.0-dev.142 → 0.8.0-dev.148

package/CHANGES.md

@@ -8,6 +8,9 @@ Version 0.8.0
 
 To be released.
 
+ -  The CLI toolchain is now available on JSR: [@fedify/cli].  You can install
+    it with `deno install -A -n fedify jsr:@fedify/cli`.
+
  -  Implemented [followers collection synchronization mechanism][FEP-8fcf].
 
      -  Added `RequestContext.sendActivity()` overload that takes `"followers"`
@@ -21,7 +24,7 @@ To be released.
      -  Added the second type parameter to `CollectionCursor` type.
      -  Added the third parameter to `CollectionCursor` type.
 
- -  Relaxed the required type for activity recipients. 
+ -  Relaxed the required type for activity recipients.
 
      -  Added `Recipient` interface.
      -  The type of the second parameter of `Context.sendActivity()` method
@@ -40,6 +43,13 @@ To be released.
     requires `--unstable-temporal` flag.  On other runtime, it still depends
     on *@js-temporal/polyfill*.
 
+ -  Added more log messages using the [LogTape] library.  Currently the below
+    logger categories are used:
+
+     -  `["fedify", "federation", "collection"]`
+     -  `["fedify", "runtime", "docloader"]`
+
+[@fedify/cli]: https://jsr.io/@fedify/cli
 [FEP-8fcf]: https://codeberg.org/fediverse/fep/src/branch/main/fep/8fcf/fep-8fcf.md
 
 

package/README.md

@@ -105,15 +105,20 @@ via the following command:
 deno add @fedify/fedify
 ~~~~
 
-~~~~ typescript
-import { Federation } from "@fedify/fedify";
+Since Fedify requires [`Temporal`] API, which is an unstable feature in Deno as
+of April 2024, you need to add the `"temporal"` to the `"unstable"` field of
+the *deno.json* file:
+
+~~~~ json
+{
+  "imports": {
+    "@fedify/fedify": "jsr:@fedify/fedify"
+  },
+  "unstable": ["temporal"]
+}
 ~~~~
 
-Or you can directly import it in your code using `jsr:` specifier:
-
-~~~~ typescript
-import { Federation } from "jsr:@fedify/fedify";
-~~~~
+[`Temporal`]: https://tc39.es/proposal-temporal/docs/
 
 ### Node.js
 
@@ -125,10 +130,6 @@ the following command:
 npm add @fedify/fedify
 ~~~~
 
-~~~~ typescript
-import { Federation } from "@fedify/fedify";
-~~~~
-
 ### Bun
 
 Fedify can also be used in Bun.  You can install it via the following
@@ -137,7 +138,3 @@ command:
 ~~~~ sh
 bun add @fedify/fedify
 ~~~~
-
-~~~~ typescript
-import { Federation } from "@fedify/fedify";
-~~~~

package/esm/runtime/docloader.js

@@ -1,6 +1,8 @@
 import * as dntShim from "../_dnt.shims.js";
+import { getLogger } from "@logtape/logtape";
 import { validateCryptoKey } from "../httpsig/key.js";
 import { sign } from "../httpsig/mod.js";
+const logger = getLogger(["fedify", "runtime", "docloader"]);
 /**
  * Error thrown when fetching a JSON-LD document failed.
  */
@@ -29,11 +31,28 @@ function createRequest(url) {
         redirect: "follow",
     });
 }
+function logRequest(request) {
+    logger.debug("Fetching document: {method} {url} {headers}", {
+        method: request.method,
+        url: request.url,
+        headers: Object.fromEntries(request.headers.entries()),
+    });
+}
 async function getRemoteDocument(url, response) {
     const documentUrl = response.url === "" ? url : response.url;
     if (!response.ok) {
+        logger.error("Failed to fetch document: {status} {url} {headers}", {
+            status: response.status,
+            url: documentUrl,
+            headers: Object.fromEntries(response.headers.entries()),
+        });
         throw new FetchError(documentUrl, `HTTP ${response.status}: ${documentUrl}`);
     }
+    logger.error("Fetched document: {status} {url} {headers}", {
+        status: response.status,
+        url: documentUrl,
+        headers: Object.fromEntries(response.headers.entries()),
+    });
     return {
         contextUrl: null,
         document: await response.json(),
@@ -46,7 +65,9 @@ async function getRemoteDocument(url, response) {
  * @returns The remote document.
  */
 export async function fetchDocumentLoader(url) {
-    const response = await fetch(createRequest(url));
+    const request = createRequest(url);
+    logRequest(request);
+    const response = await fetch(request);
     return getRemoteDocument(url, response);
 }
 /**
@@ -64,6 +85,7 @@ export function getAuthenticatedDocumentLoader(identity) {
     return async (url) => {
         let request = createRequest(url);
         request = await sign(request, identity.privateKey, identity.keyId);
+        logRequest(request);
         const response = await fetch(request);
         return getRemoteDocument(url, response);
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "0.8.0-dev.142+46e7ae0a",
+  "version": "0.8.0-dev.148+31108ea9",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",

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;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;;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;AA6BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,GACtD,cAAc,CAQhB;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;;;;;;;;;;;OAWG;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,CAgDhB"}
+{"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;AAM1D;;;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;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAA;CAAE,GACtD,cAAc,CAShB;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;;;;;;;;;;;OAWG;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,CAgDhB"}