@docusaurus/plugin-content-blog 2.0.0-beta.17 → 2.0.0-beta.18

package/lib/authors.d.ts

@@ -6,7 +6,9 @@
  */
 import type { BlogContentPaths } from './types';
 import type { Author, BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
-export declare type AuthorsMap = Record<string, Author>;
+export declare type AuthorsMap = {
+    [authorKey: string]: Author;
+};
 export declare function validateAuthorsMap(content: unknown): AuthorsMap;
 export declare function getAuthorsMap(params: {
     authorsMapPath: string;

package/lib/authors.js

@@ -9,7 +9,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBlogPostAuthors = exports.getAuthorsMap = exports.validateAuthorsMap = void 0;
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
-const AuthorsMapSchema = utils_validation_1.Joi.object().pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
+const AuthorsMapSchema = utils_validation_1.Joi.object()
+    .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
     name: utils_validation_1.Joi.string(),
     url: utils_validation_1.URISchema,
     imageURL: utils_validation_1.URISchema,
@@ -19,7 +20,14 @@ const AuthorsMapSchema = utils_validation_1.Joi.object().pattern(utils_validatio
     .rename('image_url', 'imageURL')
     .or('name', 'imageURL')
     .unknown()
-    .required());
+    .required()
+    .messages({
+    'object.base': '{#label} should be an author object containing properties like name, title, and imageURL.',
+    'any.required': '{#label} cannot be undefined. It should be an author object containing properties like name, title, and imageURL.',
+}))
+    .messages({
+    'object.base': "The authors map file should contain an object where each entry contains an author key and the corresponding author's data.",
+});
 function validateAuthorsMap(content) {
     return utils_validation_1.Joi.attempt(content, AuthorsMapSchema);
 }

package/lib/blogUtils.d.ts

@@ -8,7 +8,9 @@ import type { BlogPost, BlogContentPaths, BlogMarkdownLoaderOptions, BlogTags, B
 import type { LoadContext } from '@docusaurus/types';
 import type { PluginOptions } from '@docusaurus/plugin-content-blog';
 export declare function truncate(fileString: string, truncateMarker: RegExp): string;
-export declare function getSourceToPermalink(blogPosts: BlogPost[]): Record<string, string>;
+export declare function getSourceToPermalink(blogPosts: BlogPost[]): {
+    [aliasedPath: string]: string;
+};
 export declare function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription, postsPerPageOption, }: {
     blogPosts: BlogPost[];
     basePageUrl: string;

package/lib/blogUtils.js

@@ -13,7 +13,7 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const reading_time_1 = tslib_1.__importDefault(require("reading-time"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
-const blogFrontMatter_1 = require("./blogFrontMatter");
+const frontMatter_1 = require("./frontMatter");
 const authors_1 = require("./authors");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 function truncate(fileString, truncateMarker) {
@@ -30,7 +30,9 @@ function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription,
     const numberOfPages = Math.ceil(totalCount / postsPerPage);
     const pages = [];
     function permalink(page) {
-        return page > 0 ? `${basePageUrl}/page/${page + 1}` : basePageUrl;
+        return page > 0
+            ? (0, utils_1.normalizeUrl)([basePageUrl, `page/${page + 1}`])
+            : basePageUrl;
     }
     for (let page = 0; page < numberOfPages; page += 1) {
         pages.push({
@@ -43,8 +45,8 @@ function paginateBlogPosts({ blogPosts, basePageUrl, blogTitle, blogDescription,
                 postsPerPage,
                 totalPages: numberOfPages,
                 totalCount,
-                previousPage: page !== 0 ? permalink(page - 1) : null,
-                nextPage: page < numberOfPages - 1 ? permalink(page + 1) : null,
+                previousPage: page !== 0 ? permalink(page - 1) : undefined,
+                nextPage: page < numberOfPages - 1 ? permalink(page + 1) : undefined,
                 blogDescription,
                 blogTitle,
             },
@@ -76,7 +78,7 @@ function parseBlogFileName(blogSourceRelative) {
         const date = new Date(`${dateString}Z`);
         const slugDate = dateString.replace(/-/g, '/');
         const slug = `/${slugDate}/${folder}${text}`;
-        return { date, text, slug };
+        return { date, text: text, slug };
     }
     const text = blogSourceRelative.replace(/(?:\/index)?\.mdx?$/, '');
     const slug = `/${text}`;
@@ -105,7 +107,7 @@ async function parseBlogPostMarkdownFile(blogSourceAbsolute) {
         });
         return {
             ...result,
-            frontMatter: (0, blogFrontMatter_1.validateBlogPostFrontMatter)(result.frontMatter),
+            frontMatter: (0, frontMatter_1.validateBlogPostFrontMatter)(result.frontMatter),
         };
     }
     catch (err) {
@@ -150,7 +152,7 @@ async function processBlogSourceFile(blogSourceRelative, contentPaths, context,
             return result.date;
         }
         catch (err) {
-            logger_1.default.error(err);
+            logger_1.default.warn(err);
             return (await fs_extra_1.default.stat(blogSourceAbsolute)).birthtime;
         }
     }

package/lib/feed.d.ts

@@ -7,9 +7,10 @@
 import type { BlogPost } from './types';
 import type { DocusaurusConfig } from '@docusaurus/types';
 import type { PluginOptions } from '@docusaurus/plugin-content-blog';
-export declare function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, }: {
+export declare function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, locale, }: {
     blogPosts: BlogPost[];
     options: PluginOptions;
     siteConfig: DocusaurusConfig;
     outDir: string;
+    locale: string;
 }): Promise<void>;

package/lib/feed.js

@@ -10,25 +10,25 @@ exports.createBlogFeedFiles = void 0;
 const tslib_1 = require("tslib");
 const feed_1 = require("feed");
 const utils_1 = require("@docusaurus/utils");
-const cheerio_1 = tslib_1.__importDefault(require("cheerio"));
+const cheerio_1 = require("cheerio");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const utils_common_1 = require("@docusaurus/utils-common");
-async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, }) {
+async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, locale, }) {
     if (!blogPosts.length) {
         return null;
     }
     const { feedOptions, routeBasePath } = options;
     const { url: siteUrl, baseUrl, title, favicon } = siteConfig;
     const blogBaseUrl = (0, utils_1.normalizeUrl)([siteUrl, baseUrl, routeBasePath]);
-    const updated = blogPosts[0] && blogPosts[0].metadata.date;
+    const updated = blogPosts[0]?.metadata.date;
     const feed = new feed_1.Feed({
         id: blogBaseUrl,
-        title: feedOptions.title || `${title} Blog`,
+        title: feedOptions.title ?? `${title} Blog`,
         updated,
-        language: feedOptions.language,
+        language: feedOptions.language ?? locale,
         link: blogBaseUrl,
-        description: feedOptions.description || `${siteConfig.title} Blog`,
+        description: feedOptions.description ?? `${siteConfig.title} Blog`,
         favicon: favicon ? (0, utils_1.normalizeUrl)([siteUrl, baseUrl, favicon]) : undefined,
         copyright: feedOptions.copyright,
     });
@@ -38,7 +38,7 @@ async function generateBlogFeed({ blogPosts, options, siteConfig, outDir, }) {
     await (0, utils_1.mapAsyncSequential)(blogPosts, async (post) => {
         const { id, metadata: { title: metadataTitle, permalink, date, description, authors, tags, }, } = post;
         const content = await (0, utils_1.readOutputHTMLFile)(permalink.replace(siteConfig.baseUrl, ''), outDir, siteConfig.trailingSlash);
-        const $ = cheerio_1.default.load(content);
+        const $ = (0, cheerio_1.load)(content);
         const feedItem = {
             title: metadataTitle,
             id,
@@ -79,12 +79,13 @@ async function createBlogFeedFile({ feed, feedType, generatePath, }) {
         throw new Error(`Generating ${feedType} feed failed: ${err}.`);
     }
 }
-async function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, }) {
+async function createBlogFeedFiles({ blogPosts, options, siteConfig, outDir, locale, }) {
     const feed = await generateBlogFeed({
         blogPosts,
         options,
         siteConfig,
         outDir,
+        locale,
     });
     const feedTypes = options.feedOptions.type;
     if (!feed || !feedTypes) {

package/lib/{blogFrontMatter.d.ts → frontMatter.d.ts}

@@ -5,4 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BlogPostFrontMatter } from '@docusaurus/plugin-content-blog';
-export declare function validateBlogPostFrontMatter(frontMatter: Record<string, unknown>): BlogPostFrontMatter;
+export declare function validateBlogPostFrontMatter(frontMatter: {
+    [key: string]: unknown;
+}): BlogPostFrontMatter;

package/lib/index.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BlogContent } from './types';
-import type { LoadContext, Plugin, OptionValidationContext, ValidationResult } from '@docusaurus/types';
+import type { LoadContext, Plugin } from '@docusaurus/types';
 import type { PluginOptions } from '@docusaurus/plugin-content-blog';
 export default function pluginContentBlog(context: LoadContext, options: PluginOptions): Promise<Plugin<BlogContent>>;
-export declare function validateOptions({ validate, options, }: OptionValidationContext<PluginOptions>): ValidationResult<PluginOptions>;
+export { validateOptions } from './options';

package/lib/index.js

@@ -12,7 +12,6 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const remark_admonitions_1 = tslib_1.__importDefault(require("remark-admonitions"));
 const utils_1 = require("@docusaurus/utils");
 const translations_1 = require("./translations");
-const pluginOptionSchema_1 = require("./pluginOptionSchema");
 const blogUtils_1 = require("./blogUtils");
 const feed_1 = require("./feed");
 async function pluginContentBlog(context, options) {
@@ -116,7 +115,7 @@ async function pluginContentBlog(context, options) {
             const sidebarBlogPosts = options.blogSidebarCount === 'ALL'
                 ? blogPosts
                 : blogPosts.slice(0, options.blogSidebarCount);
-            if (archiveBasePath) {
+            if (archiveBasePath && blogPosts.length) {
                 const archiveUrl = (0, utils_1.normalizeUrl)([
                     baseUrl,
                     routeBasePath,
@@ -193,10 +192,9 @@ async function pluginContentBlog(context, options) {
             if (blogTagsListPath === null) {
                 return;
             }
-            const tagsModule = Object.fromEntries(Object.entries(blogTags).map(([tagKey, tag]) => {
+            const tagsModule = Object.fromEntries(Object.entries(blogTags).map(([, tag]) => {
                 const tagModule = {
                     allTagsPath: blogTagsListPath,
-                    slug: tagKey,
                     name: tag.name,
                     count: tag.items.length,
                     permalink: tag.permalink,
@@ -330,6 +328,7 @@ async function pluginContentBlog(context, options) {
                 options,
                 outDir,
                 siteConfig,
+                locale: currentLocale,
             });
         },
         injectHtmlTags({ content }) {
@@ -360,11 +359,7 @@ async function pluginContentBlog(context, options) {
             };
             const headTags = [];
             feedTypes.forEach((feedType) => {
-                const feedConfig = feedsConfig[feedType] || {};
-                if (!feedsConfig) {
-                    return;
-                }
-                const { type, path: feedConfigPath, title: feedConfigTitle } = feedConfig;
+                const { type, path: feedConfigPath, title: feedConfigTitle, } = feedsConfig[feedType];
                 headTags.push({
                     tagName: 'link',
                     attributes: {
@@ -386,8 +381,5 @@ async function pluginContentBlog(context, options) {
     };
 }
 exports.default = pluginContentBlog;
-function validateOptions({ validate, options, }) {
-    const validatedOptions = validate(pluginOptionSchema_1.PluginOptionSchema, options);
-    return validatedOptions;
-}
-exports.validateOptions = validateOptions;
+var options_1 = require("./options");
+Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/markdownLoader.js

@@ -25,6 +25,6 @@ function markdownLoader(source) {
     if (truncated) {
         finalContent = (0, blogUtils_1.truncate)(finalContent, markdownLoaderOptions.truncateMarker);
     }
-    return callback && callback(null, finalContent);
+    return callback?.(null, finalContent);
 }
 exports.default = markdownLoader;

package/lib/options.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { PluginOptions, Options } from '@docusaurus/plugin-content-blog';
+import type { OptionValidationContext } from '@docusaurus/types';
+export declare const DEFAULT_OPTIONS: PluginOptions;
+export declare function validateOptions({ validate, options, }: OptionValidationContext<Options, PluginOptions>): PluginOptions;

package/lib/{pluginOptionSchema.js → options.js}

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PluginOptionSchema = exports.DEFAULT_OPTIONS = void 0;
+exports.validateOptions = exports.DEFAULT_OPTIONS = void 0;
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const utils_1 = require("@docusaurus/utils");
 exports.DEFAULT_OPTIONS = {
@@ -39,7 +39,7 @@ exports.DEFAULT_OPTIONS = {
     readingTime: ({ content, defaultReadingTime }) => defaultReadingTime({ content }),
     sortPosts: 'descending',
 };
-exports.PluginOptionSchema = utils_validation_1.Joi.object({
+const PluginOptionSchema = utils_validation_1.Joi.object({
     path: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.path),
     archiveBasePath: utils_validation_1.Joi.string()
         .default(exports.DEFAULT_OPTIONS.archiveBasePath)
@@ -100,4 +100,9 @@ exports.PluginOptionSchema = utils_validation_1.Joi.object({
     sortPosts: utils_validation_1.Joi.string()
         .valid('descending', 'ascending')
         .default(exports.DEFAULT_OPTIONS.sortPosts),
-});
+}).default(exports.DEFAULT_OPTIONS);
+function validateOptions({ validate, options, }) {
+    const validatedOptions = validate(PluginOptionSchema, options);
+    return validatedOptions;
+}
+exports.validateOptions = validateOptions;

package/lib/translations.js

@@ -14,8 +14,8 @@ function translateListPage(blogListPaginated, translations) {
             items,
             metadata: {
                 ...metadata,
-                blogTitle: translations.title.message,
-                blogDescription: translations.description.message,
+                blogTitle: translations.title?.message ?? page.metadata.blogTitle,
+                blogDescription: translations.description?.message ?? page.metadata.blogDescription,
             },
         };
     });
@@ -43,10 +43,10 @@ function getTranslationFiles(options) {
 }
 exports.getTranslationFiles = getTranslationFiles;
 function translateContent(content, translationFiles) {
-    const [{ content: optionsTranslations }] = translationFiles;
+    const { content: optionsTranslations } = translationFiles[0];
     return {
         ...content,
-        blogSidebarTitle: optionsTranslations['sidebar.title'].message,
+        blogSidebarTitle: optionsTranslations['sidebar.title']?.message ?? content.blogSidebarTitle,
         blogListPaginated: translateListPage(content.blogListPaginated, optionsTranslations),
     };
 }

package/lib/types.d.ts

@@ -4,9 +4,9 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { Tag } from '@docusaurus/utils';
-import type { BrokenMarkdownLink, ContentPaths } from '@docusaurus/utils/lib/markdownLinks';
-import type { BlogPostFrontMatter, Author } from '@docusaurus/plugin-content-blog';
+import type { BrokenMarkdownLink, ContentPaths } from '@docusaurus/utils';
+import type { BlogPostMetadata } from '@docusaurus/plugin-content-blog';
+import type { Metadata as BlogPaginatedMetadata } from '@theme/BlogListPage';
 export declare type BlogContentPaths = ContentPaths;
 export interface BlogContent {
     blogSidebarTitle: string;
@@ -26,62 +26,20 @@ export interface BlogTag {
 }
 export interface BlogPost {
     id: string;
-    metadata: MetaData;
+    metadata: BlogPostMetadata;
     content: string;
 }
-export interface BlogPaginatedMetadata {
-    permalink: string;
-    page: number;
-    postsPerPage: number;
-    totalPages: number;
-    totalCount: number;
-    previousPage: string | null;
-    nextPage: string | null;
-    blogTitle: string;
-    blogDescription: string;
-}
 export interface BlogPaginated {
     metadata: BlogPaginatedMetadata;
     items: string[];
 }
-export interface MetaData {
-    permalink: string;
-    source: string;
-    description: string;
-    date: Date;
-    formattedDate: string;
-    tags: Tag[];
-    title: string;
-    readingTime?: number;
-    prevItem?: Paginator;
-    nextItem?: Paginator;
-    truncated: boolean;
-    editUrl?: string;
-    authors: Author[];
-    frontMatter: BlogPostFrontMatter & Record<string, unknown>;
-}
-export interface Paginator {
-    title: string;
-    permalink: string;
-}
-export interface BlogItemsToMetadata {
-    [key: string]: MetaData;
-}
-export interface TagsModule {
-    [key: string]: TagModule;
-}
-export interface TagModule {
-    allTagsPath: string;
-    slug: string;
-    name: string;
-    count: number;
-    permalink: string;
-}
 export declare type BlogBrokenMarkdownLink = BrokenMarkdownLink<BlogContentPaths>;
 export declare type BlogMarkdownLoaderOptions = {
     siteDir: string;
     contentPaths: BlogContentPaths;
     truncateMarker: RegExp;
-    sourceToPermalink: Record<string, string>;
+    sourceToPermalink: {
+        [aliasedPath: string]: string;
+    };
     onBrokenMarkdownLink: (brokenMarkdownLink: BlogBrokenMarkdownLink) => void;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-blog",
-  "version": "2.0.0-beta.17",
+  "version": "2.0.0-beta.18",
   "description": "Blog plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-blog.d.ts",
@@ -18,12 +18,12 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.0.0-beta.17",
-    "@docusaurus/logger": "2.0.0-beta.17",
-    "@docusaurus/mdx-loader": "2.0.0-beta.17",
-    "@docusaurus/utils": "2.0.0-beta.17",
-    "@docusaurus/utils-common": "2.0.0-beta.17",
-    "@docusaurus/utils-validation": "2.0.0-beta.17",
+    "@docusaurus/core": "2.0.0-beta.18",
+    "@docusaurus/logger": "2.0.0-beta.18",
+    "@docusaurus/mdx-loader": "2.0.0-beta.18",
+    "@docusaurus/utils": "2.0.0-beta.18",
+    "@docusaurus/utils-common": "2.0.0-beta.18",
+    "@docusaurus/utils-validation": "2.0.0-beta.18",
     "cheerio": "^1.0.0-rc.10",
     "feed": "^4.2.2",
     "fs-extra": "^10.0.1",
@@ -32,10 +32,10 @@
     "remark-admonitions": "^1.2.1",
     "tslib": "^2.3.1",
     "utility-types": "^3.10.0",
-    "webpack": "^5.69.1"
+    "webpack": "^5.70.0"
   },
   "devDependencies": {
-    "@docusaurus/types": "2.0.0-beta.17",
+    "@docusaurus/types": "2.0.0-beta.18",
     "escape-string-regexp": "^4.0.0"
   },
   "peerDependencies": {
@@ -45,5 +45,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "0032c0b0480083227af2e1b4da2d3ee6ce992403"
+  "gitHead": "1a945d06993d53376e61bed2c942799fe07dc336"
 }

package/src/authors.ts

@@ -15,22 +15,33 @@ import type {
   BlogPostFrontMatterAuthors,
 } from '@docusaurus/plugin-content-blog';
 
-export type AuthorsMap = Record<string, Author>;
-
-const AuthorsMapSchema = Joi.object<AuthorsMap>().pattern(
-  Joi.string(),
-  Joi.object({
-    name: Joi.string(),
-    url: URISchema,
-    imageURL: URISchema,
-    title: Joi.string(),
-    email: Joi.string(),
-  })
-    .rename('image_url', 'imageURL')
-    .or('name', 'imageURL')
-    .unknown()
-    .required(),
-);
+export type AuthorsMap = {[authorKey: string]: Author};
+
+const AuthorsMapSchema = Joi.object<AuthorsMap>()
+  .pattern(
+    Joi.string(),
+    Joi.object({
+      name: Joi.string(),
+      url: URISchema,
+      imageURL: URISchema,
+      title: Joi.string(),
+      email: Joi.string(),
+    })
+      .rename('image_url', 'imageURL')
+      .or('name', 'imageURL')
+      .unknown()
+      .required()
+      .messages({
+        'object.base':
+          '{#label} should be an author object containing properties like name, title, and imageURL.',
+        'any.required':
+          '{#label} cannot be undefined. It should be an author object containing properties like name, title, and imageURL.',
+      }),
+  )
+  .messages({
+    'object.base':
+      "The authors map file should contain an object where each entry contains an author key and the corresponding author's data.",
+  });
 
 export function validateAuthorsMap(content: unknown): AuthorsMap {
   return Joi.attempt(content, AuthorsMapSchema);
@@ -59,7 +70,7 @@ type AuthorsParam = {
 // We may want to deprecate those in favor of using only frontMatter.authors
 function getFrontMatterAuthorLegacy(
   frontMatter: BlogPostFrontMatter,
-): BlogPostFrontMatterAuthor | undefined {
+): Author | undefined {
   const name = frontMatter.author;
   const title = frontMatter.author_title ?? frontMatter.authorTitle;
   const url = frontMatter.author_url ?? frontMatter.authorURL;
@@ -81,7 +92,7 @@ function normalizeFrontMatterAuthors(
   frontMatterAuthors: BlogPostFrontMatterAuthors = [],
 ): BlogPostFrontMatterAuthor[] {
   function normalizeAuthor(
-    authorInput: string | BlogPostFrontMatterAuthor,
+    authorInput: string | Author,
   ): BlogPostFrontMatterAuthor {
     if (typeof authorInput === 'string') {
       // Technically, we could allow users to provide an author's name here, but

package/src/blogUtils.ts

@@ -31,7 +31,7 @@ import {
   getContentPathList,
 } from '@docusaurus/utils';
 import type {LoadContext} from '@docusaurus/types';
-import {validateBlogPostFrontMatter} from './blogFrontMatter';
+import {validateBlogPostFrontMatter} from './frontMatter';
 import {type AuthorsMap, getAuthorsMap, getBlogPostAuthors} from './authors';
 import logger from '@docusaurus/logger';
 import type {
@@ -43,9 +43,9 @@ export function truncate(fileString: string, truncateMarker: RegExp): string {
   return fileString.split(truncateMarker, 1).shift()!;
 }
 
-export function getSourceToPermalink(
-  blogPosts: BlogPost[],
-): Record<string, string> {
+export function getSourceToPermalink(blogPosts: BlogPost[]): {
+  [aliasedPath: string]: string;
+} {
   return Object.fromEntries(
     blogPosts.map(({metadata: {source, permalink}}) => [source, permalink]),
   );
@@ -72,7 +72,9 @@ export function paginateBlogPosts({
   const pages: BlogPaginated[] = [];
 
   function permalink(page: number) {
-    return page > 0 ? `${basePageUrl}/page/${page + 1}` : basePageUrl;
+    return page > 0
+      ? normalizeUrl([basePageUrl, `page/${page + 1}`])
+      : basePageUrl;
   }
 
   for (let page = 0; page < numberOfPages; page += 1) {
@@ -86,8 +88,8 @@ export function paginateBlogPosts({
         postsPerPage,
         totalPages: numberOfPages,
         totalCount,
-        previousPage: page !== 0 ? permalink(page - 1) : null,
-        nextPage: page < numberOfPages - 1 ? permalink(page + 1) : null,
+        previousPage: page !== 0 ? permalink(page - 1) : undefined,
+        nextPage: page < numberOfPages - 1 ? permalink(page + 1) : undefined,
         blogDescription,
         blogTitle,
       },
@@ -139,10 +141,10 @@ export function parseBlogFileName(
   if (dateFilenameMatch) {
     const {folder, text, date: dateString} = dateFilenameMatch.groups!;
     // Always treat dates as UTC by adding the `Z`
-    const date = new Date(`${dateString}Z`);
-    const slugDate = dateString.replace(/-/g, '/');
-    const slug = `/${slugDate}/${folder}${text}`;
-    return {date, text, slug};
+    const date = new Date(`${dateString!}Z`);
+    const slugDate = dateString!.replace(/-/g, '/');
+    const slug = `/${slugDate}/${folder!}${text!}`;
+    return {date, text: text!, slug};
   }
   const text = blogSourceRelative.replace(/(?:\/index)?\.mdx?$/, '');
   const slug = `/${text}`;
@@ -245,7 +247,7 @@ async function processBlogSourceFile(
       });
       return result.date;
     } catch (err) {
-      logger.error(err);
+      logger.warn(err);
       return (await fs.stat(blogSourceAbsolute)).birthtime;
     }
   }

package/src/deps.d.ts

@@ -6,7 +6,7 @@
  */
 
 declare module 'remark-admonitions' {
-  type Options = Record<string, unknown>;
+  type Options = {[key: string]: unknown};
 
   const plugin: (options?: Options) => void;
   export = plugin;