chore: add jsdoc type checking

jsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "checkJs": true,
+    "module": "NodeNext",
+    "target": "es2021",
+  }
+}

lib/fetch-mf2.js

@@ -4,7 +4,7 @@ import { fetch } from "./fetch.js";
 /**
  * Fetch Microformats2 from a given URL
  * @param {string} url URL
- * @returns {object} Microformats2
+ * @returns {Promise<object>} Microformats2
  */
 export const fetchMf2 = async (url) => {
   const response = await fetch(url);

lib/fetch-references.js

@@ -27,7 +27,7 @@ const referenceableUrls = (jf2) => {
 /**
  * Fetch JF2 properties for each referenced URL
  * @param {object} jf2 JF2
- * @returns {object} JF2 with references
+ * @returns {Promise<object>} JF2 with references
  */
 export const fetchReferences = async (jf2) => {
   const urls = referenceableUrls(jf2);

lib/fetch.js

@@ -1,12 +1,14 @@
 /**
  * Fetch ponyfill.
  * @type {globalThis.fetch}
+ * @returns {Promise<Response>} Fetch response
  */
 export async function fetch(...args) {
   if ("fetch" in globalThis) {
     return globalThis.fetch(...args);
   }
 
   const { fetch } = await import("undici");
+
   return fetch(...args);
 }

lib/flatten-items.js

@@ -36,7 +36,7 @@ const getHtml = (item) => ({
  * Create object with `children` value
  * @see {@link https://jf2.spec.indieweb.org/#collections}
  * @param {Array} items MF2
- * @returns {Array} JF2
+ * @returns {object} JF2
  */
 const getChildren = (items) => ({
   children: items.map((item) => flattenItems(item)),