Merge pull request #15923 from newrelic/tabatha/rss-feed-dates

feat: add release date to security RSS feed

plugins/gatsby-plugin-security-bulletins-rss/gatsby-node.js

@@ -32,6 +32,7 @@ const securityBulletinsQuery = async (graphql) => {
           frontmatter {
             title
             metaDescription
+            releaseDate
           }
           slug
           mdxAST
@@ -59,7 +60,7 @@ const securityBulletinsQuery = async (graphql) => {
 
 const getFeedItem = (node, siteMetadata, imageHashMap) => {
   const { frontmatter, slug, mdxAST } = node;
-  const { title, metaDescription } = frontmatter;
+  const { title, metaDescription, releaseDate } = frontmatter;
 
   const transformedAST = htmlGenerator.runSync(mdxAST);
   const html = htmlGenerator.stringify(
@@ -72,7 +73,7 @@ const getFeedItem = (node, siteMetadata, imageHashMap) => {
   );
 
   // time is necessary for RSS validity
-  const date = new Date();
+  const date = new Date(releaseDate);
   const pubDate = `${format(date, 'EE, dd LLL yyyy')} 00:00:00 +0000`;
   const link = new URL(slug, siteMetadata.siteUrl).href;
   const id = Buffer.from(`${title}`).toString('base64');

scripts/README.md

@@ -28,6 +28,7 @@ Otherwise, it will read all files under `/src/content/` and `src/i18n/content`.
 - markdown and JSX syntax
 - valid yaml frontmatter
   - We also check for the required field `freshnessValidatedDate` which must be a date (`YYYY-MM-DD`) or `never`
+  - `release-notes`, `security-bulletins` and `whats-new` posts will also be scanned for a required `releaseDate` field in the frontmatter.
 - `<img />` sources and imports which utilizes the [image-import-utils script](#image-import-utils.js)
   - this util has its own progress bar and error output section in the terminal
 

scripts/utils/__tests__/frontmatter.js

@@ -1,4 +1,8 @@
-const { frontmatter, validateFreshnessDate } = require('../frontmatter');
+const {
+  frontmatter,
+  validateFreshnessDate,
+  validateReleaseDate,
+} = require('../frontmatter');
 
 const mdxString = `---
 howdy: cowboy 🤠
@@ -130,3 +134,75 @@ describe('freshness frontmatter field', () => {
     expect(error.message).toEqual(expectedError);
   });
 });
+
+const happyReleaseDateMdxString = `---
+howdy: cowboy 🤠
+list:
+  - item 1
+  - item 2
+releaseDate: '2021-12-02'
+---
+some content!
+`;
+
+const invalidReleaseDateMdxString = `---
+howdy: cowboy 🤠
+list:
+  - item 1
+  - item 2
+releaseDate: '23-12-02'
+---
+some content!
+`;
+const badFormatReleaseDateMdxString = `---
+howdy: cowboy 🤠
+list:
+  - item 1
+  - item 2
+releaseDate: 2023
+---
+some content!
+`;
+
+const missingReleaseDateMdxString = `---
+howdy: cowboy 🤠
+list:
+  - item 1
+  - item 2
+---
+some content!
+`;
+
+describe('releaseDate frontmatter field', () => {
+  it('should pass the check with valid "never" value', () => {
+    const error = validateReleaseDate(happyReleaseDateMdxString);
+
+    expect(error).toBeFalsy;
+  });
+
+  it('should throw error for invalid date value', () => {
+    const error = validateReleaseDate(invalidReleaseDateMdxString);
+
+    const expectedError =
+      "releaseDate is not a valid value. Must be date string formatted like 'YYYY-MM-DD' wrapped in single quotes";
+
+    expect(error.message).toEqual(expectedError);
+  });
+
+  it('should throw error for valid date but wrong format', () => {
+    const error = validateReleaseDate(badFormatReleaseDateMdxString);
+
+    const expectedError =
+      "releaseDate is not a valid value. Must be date string formatted like 'YYYY-MM-DD' wrapped in single quotes";
+
+    expect(error.message).toEqual(expectedError);
+  });
+
+  it('should throw error missing releaseDate field', () => {
+    const error = validateReleaseDate(missingReleaseDateMdxString);
+
+    const expectedError = 'releaseDate field missing from frontmatter';
+
+    expect(error.message).toEqual(expectedError);
+  });
+});

scripts/utils/frontmatter.js

@@ -142,7 +142,71 @@ const validateFreshnessDate = (mdString) => {
   return error;
 };
 
+/**
+ * Parse the frontmatter and check for required releaseDate field on whats-new, security-bulletins, and release-notes. 
+ * Valid format is `YYYY-MM-DD`
+ *
+ * @example
+ * ```yaml
+ * ---
+ * title: This is a security bulletin
+ * releaseDate: '2021-03-15'
+ * ---
+ * ```
+ * 
+ *```js
+ * // error.message = undefined
+ * ``` 
+ * 
+ * ```yaml
+ * ---
+ * title: This is a security bulletin with an invalid date
+ * releaseDate: 21-03-15
+ * ---
+ * ```
+ * 
+ *```js
+ * // error.message = releaseDate is not a valid value. Must be date string formatted like 'YYYY-MM-DD' wrapped in single quotes
+ * ```
+
+ *
+ *
+ *
+ * @param {string} mdString - Full content of the MD(X) file to parse.
+ * @returns error | undefined
+ */
+
+const validateReleaseDate = (mdString) => {
+  let error;
+
+  const { data } = grayMatter(mdString, {
+    engines: {
+      yaml: {
+        parse: (string) => yaml.safeLoad(string, { schema: yaml.JSON_SCHEMA }),
+      },
+    },
+  });
+
+  const isValidDate = (date) => {
+    const regex = /\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])/;
+    return regex.test(date);
+  };
+  // releaseDate is a required field and must be a date wrapped in single quotes
+  if (data.releaseDate) {
+    if (!isValidDate(data.releaseDate)) {
+      error = new Error(
+        "releaseDate is not a valid value. Must be date string formatted like 'YYYY-MM-DD' wrapped in single quotes"
+      );
+    }
+  } else {
+    error = new Error('releaseDate field missing from frontmatter');
+  }
+
+  return error;
+};
+
 module.exports = {
   frontmatter,
   validateFreshnessDate,
+  validateReleaseDate,
 };

scripts/verify_mdx.js

@@ -1,5 +1,9 @@
 /* eslint-disable no-console */
-const { frontmatter, validateFreshnessDate } = require('./utils/frontmatter');
+const {
+  frontmatter,
+  validateFreshnessDate,
+  validateReleaseDate,
+} = require('./utils/frontmatter');
 const { verifyImageImports } = require('./utils/image-import-utils.js');
 const mdx = require('@mdx-js/mdx');
 const fs = require('fs');
@@ -92,6 +96,10 @@ const readFile = async (filePath) => {
     (excludedPath) => filePath.includes(excludedPath)
   );
 
+  const includeInReleaseDateRegex = /src\/(?!i18n).*(\/security-bulletins\/|\/release-notes\/|\/whats-new\/).*(?<!index)(.mdx|.md)/;
+
+  const shouldValidateReleaseDate = includeInReleaseDateRegex.test(filePath);
+
   const { error } = frontmatter(mdxText);
 
   if (error != null) {
@@ -106,6 +114,13 @@ const readFile = async (filePath) => {
         \x1b[31m${error.message}\x1b[0m`);
       failed = true;
     }
+  } else if (shouldValidateReleaseDate) {
+    const error = validateReleaseDate(mdxText);
+    if (error) {
+      mdxErrors.push(`\x1b[35m Frontmatter field error:\x1b[0m ${filePath} \n
+        \x1b[31m${error.message}\x1b[0m`);
+      failed = true;
+    }
   }
 
   return failed ? filePath : null;

src/content/docs/security/new-relic-security/security-bulletins/covid-19.mdx

@@ -8,6 +8,7 @@ metaDescription: Information from New Relic's Crisis Management Team about COVID
 redirects:
   - /docs/security/new-relic-security/security-bulletins/covid-19-bulletin
   - /docs/security/security-privacy/security-bulletins/covid-19
+releaseDate: '2021-01-14'
 ---
 
 This document describes New Relic’s current operating plan and our commitment to keeping our products and services running for our customers.

src/content/docs/security/new-relic-security/security-bulletins/notification-apolloio-security-incident.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: A summary of the 2018 security breach of the systems of Apollo.io and New Relic's response.
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/notification-apolloio-security-incident
+releaseDate: '2020-12-10'
 ---
 
 **October 9, 2018**

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-01.mdx

@@ -11,6 +11,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-01
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr17-01
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-01
+releaseDate: '2020-12-09'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-02.mdx

@@ -11,6 +11,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-02
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr17-02
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-02
+releaseDate: '2020-12-09'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-03.mdx

@@ -9,6 +9,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-03
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr17-03
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-03
+releaseDate: '2020-12-09'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-04.mdx

@@ -9,6 +9,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-04
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr17-04
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-04
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-05.mdx

@@ -9,6 +9,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/nr17-05
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-05
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-05
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr17-06.mdx

@@ -8,6 +8,7 @@ metaDescription: Security vulnerability update for New Relic .NET agent.
 redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr17-06
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr17-06
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-01.mdx

@@ -9,6 +9,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr18-01
   - /docs/accounts-partnerships/welcome-new-relic/security-bulletins/security-bulletin-nr18-01
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-01
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-02.mdx

@@ -9,6 +9,7 @@ redirects:
   - /docs/accounts-partnerships/accounts/security-bulletins/security-bulletin-nr18-02
   - /docs/accounts-partnerships/welcome-new-relic/security-bulletins/security-bulletin-nr18-02
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-02
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-03.mdx

@@ -10,6 +10,7 @@ redirects:
   - /docs/accounts-partnerships/welcome-new-relic/security-bulletins/security-bulletin-nr18-03
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr18-03
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-03
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-04.mdx

@@ -8,6 +8,7 @@ metaDescription: Security vulnerability update for New Relic .NET agent.
 redirects:
   - /docs/accounts-partnerships/welcome-new-relic/security-bulletins/security-bulletin-nr18-04
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-04
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-05.mdx

@@ -8,6 +8,7 @@ metaDescription: Security vulnerability update for New Relic Infrastructure agen
 redirects:
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr18-05
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-05
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-06.mdx

@@ -7,6 +7,7 @@ tags:
 redirects:
   - /docs/accounts-partnerships/new-relic-security/security-bulletins/security-bulletin-nr18-06
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-06
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-07.mdx

@@ -8,6 +8,7 @@ metaDescription: 'Security vulnerability update for New Relic Java, Python, and
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-08
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-07
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-08.mdx

@@ -4,6 +4,7 @@ tags:
   - Security
   - Security and Privacy
   - Security bulletins
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-09.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: 'Security vulnerability update for New Relic Java, Python, and .NET agents.'
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-09
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-10.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: 'Security vulnerability update for New Relic Java, Python, and .NET agents.'
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-10
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-11.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: 'Security vulnerability update for New Relic Java, Python, and .NET agents.'
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-11
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr18-12.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: Security vulnerability update for New Relic Infrastructure agent for Windows
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr18-12
+releaseDate: '2020-12-10'
 ---
 
 ## Summary

src/content/docs/security/new-relic-security/security-bulletins/security-bulletin-nr19-01.mdx

@@ -7,6 +7,7 @@ tags:
 metaDescription: Security vulnerability update for New Relic .NET agent.
 redirects:
   - /docs/using-new-relic/new-relic-security/security-bulletins/security-bulletin-nr19-01
+releaseDate: '2020-12-10'
 ---
 
 ## Summary