refactor(v2): blog/docs: add more context in error messages (#4989)

* refactor(v2): blog/docs: add more context in error messages

* more error handling

packages/docusaurus-plugin-content-blog/src/blogUtils.ts

@@ -55,6 +55,19 @@ function toUrl({date, link}: DateLink) {
     .replace(/-/g, '/')}/${link}`;
 }
 
+function formatBlogPostDate(locale: string, date: Date): string {
+  try {
+    return new Intl.DateTimeFormat(locale, {
+      day: 'numeric',
+      month: 'long',
+      year: 'numeric',
+      timeZone: 'UTC',
+    }).format(date);
+  } catch (e) {
+    throw new Error(`Can't format blog post date "${date}"`);
+  }
+}
+
 export async function generateBlogFeed(
   contentPaths: BlogContentPaths,
   context: LoadContext,
@@ -131,8 +144,7 @@ export async function generateBlogPosts(
 
   const blogPosts: BlogPost[] = [];
 
-  await Promise.all(
-    blogSourceFiles.map(async (blogSourceFile: string) => {
+  async function processBlogSourceFile(blogSourceFile: string) {
     // Lookup in localized folder in priority
     const blogDirPath = await getFolderContainingFile(
       getContentPathList(contentPaths),
@@ -184,12 +196,7 @@ export async function generateBlogPosts(
 
     // Use file create time for blog.
     date = date ?? (await fs.stat(source)).birthtime;
-      const formattedDate = new Intl.DateTimeFormat(i18n.currentLocale, {
-        day: 'numeric',
-        month: 'long',
-        year: 'numeric',
-        timeZone: 'UTC',
-      }).format(date);
+    const formattedDate = formatBlogPostDate(i18n.currentLocale, date);
 
     const title = frontMatter.title ?? contentTitle ?? linkName;
     const description = frontMatter.description ?? excerpt ?? '';
@@ -201,10 +208,7 @@ export async function generateBlogPosts(
     const permalink = normalizeUrl([baseUrl, routeBasePath, slug]);
 
     function getBlogEditUrl() {
-        const blogPathRelative = path.relative(
-          blogDirPath,
-          path.resolve(source),
-        );
+      const blogPathRelative = path.relative(blogDirPath, path.resolve(source));
 
       if (typeof editUrl === 'function') {
         return editUrl({
@@ -242,12 +246,24 @@ export async function generateBlogPosts(
         date,
         formattedDate,
         tags: frontMatter.tags ?? [],
-          readingTime: showReadingTime
-            ? readingTime(content).minutes
-            : undefined,
+        readingTime: showReadingTime ? readingTime(content).minutes : undefined,
         truncated: truncateMarker?.test(content) || false,
       },
     });
+  }
+
+  await Promise.all(
+    blogSourceFiles.map(async (blogSourceFile: string) => {
+      try {
+        return await processBlogSourceFile(blogSourceFile);
+      } catch (e) {
+        console.error(
+          chalk.red(
+            `Processing of blog source file failed for path "${blogSourceFile}"`,
+          ),
+        );
+        throw e;
+      }
     }),
   );
 

packages/docusaurus-plugin-content-docs/src/docs.ts

@@ -32,6 +32,7 @@ import globby from 'globby';
 import {getDocsDirPaths} from './versions';
 import {stripPathNumberPrefixes} from './numberPrefix';
 import {validateDocFrontMatter} from './docFrontMatter';
+import chalk from 'chalk';
 
 type LastUpdateOptions = Pick<
   PluginOptions,
@@ -102,7 +103,7 @@ export async function readVersionDocs(
   );
 }
 
-export function processDocMetadata({
+function doProcessDocMetadata({
   docFile,
   versionMetadata,
   context,
@@ -262,3 +263,21 @@ export function processDocMetadata({
     frontMatter,
   };
 }
+
+export function processDocMetadata(args: {
+  docFile: DocFile;
+  versionMetadata: VersionMetadata;
+  context: LoadContext;
+  options: MetadataOptions;
+}): DocMetadataBase {
+  try {
+    return doProcessDocMetadata(args);
+  } catch (e) {
+    console.error(
+      chalk.red(
+        `Can't process doc metadatas for doc at path "${args.docFile.filePath}" in version "${args.versionMetadata.versionName}"`,
+      ),
+    );
+    throw e;
+  }
+}

packages/docusaurus-plugin-content-docs/src/index.ts

@@ -49,6 +49,7 @@ import {
   getLoadedContentTranslationFiles,
 } from './translations';
 import {CategoryMetadataFilenamePattern} from './sidebarItemsGenerator';
+import chalk from 'chalk';
 
 export default function pluginContentDocs(
   context: LoadContext,
@@ -163,7 +164,7 @@ export default function pluginContentDocs(
         return Promise.all(docFiles.map(processVersionDoc));
       }
 
-      async function loadVersion(
+      async function doLoadVersion(
         versionMetadata: VersionMetadata,
       ): Promise<LoadedVersion> {
         const unprocessedSidebars = loadSidebars(
@@ -267,6 +268,19 @@ export default function pluginContentDocs(
         };
       }
 
+      async function loadVersion(versionMetadata: VersionMetadata) {
+        try {
+          return await doLoadVersion(versionMetadata);
+        } catch (e) {
+          console.error(
+            chalk.red(
+              `Loading of version failed for version "${versionMetadata.versionName}"`,
+            ),
+          );
+          throw e;
+        }
+      }
+
       return {
         loadedVersions: await Promise.all(versionsMetadata.map(loadVersion)),
       };
@@ -307,7 +321,7 @@ export default function pluginContentDocs(
         return routes.sort((a, b) => a.path.localeCompare(b.path));
       };
 
-      async function handleVersion(loadedVersion: LoadedVersion) {
+      async function doCreateVersionRoutes(loadedVersion: LoadedVersion) {
         const versionMetadataPropPath = await createData(
           `${docuHash(
             `version-${loadedVersion.versionName}-metadata-prop`,
@@ -334,7 +348,20 @@ export default function pluginContentDocs(
         });
       }
 
-      await Promise.all(loadedVersions.map(handleVersion));
+      async function createVersionRoutes(loadedVersion: LoadedVersion) {
+        try {
+          return await doCreateVersionRoutes(loadedVersion);
+        } catch (e) {
+          console.error(
+            chalk.red(
+              `Can't create version routes for version "${loadedVersion.versionName}"`,
+            ),
+          );
+          throw e;
+        }
+      }
+
+      await Promise.all(loadedVersions.map(createVersionRoutes));
 
       setGlobalData<GlobalPluginData>({
         path: normalizeUrl([baseUrl, options.routeBasePath]),